CA UNIX OS Frequently Asked Questions (FAQs)

• What do I need to run Client Access for Unix OS?
• Do I need to install anything additional on the AS/400? 
• What Locales (Languages) are supported by Client Access for UNIX OS? 
• What environment variables must be set in order to run Client Access for UNIX OS? 
• What is a Host Socket Server and why is it important to run Client Access for UNIX OS?
• Does Client Access for Unix support bi-directional file transfer?
• Why do I need ICONV support?
• Does Client Access for Unix support remote printing?
• What is the difference between ca5250 and xca5250?
• When do I need to run post_install?
• What do I do when I get a ‘retrying socket bind’ error?

Usage Problems and Error Message FAQs

• Why do I get 'Security Error' when I try to add a server or connect with Client Access for UNIX OS?
•  I get 'ld.so.1: nameofapplication: fatal: libXm.so.3: can't open file: errno=2?
• When trying to start the license manager, I get an error similar to "nohup…can't find ~starlm/bin/StarQuest …"
• I'm getting 'License Error' when trying to connect with an application
• When I try to connect or set a server in CASH, I get 'Error, Central Server Down' 
   

You must have TCP/IP connectivity between your UNIX workstation and one or more AS/400s in order to use Client Access for UNIX OS. 

Client Access for UNIX OS is available for the following OS environments: 

• AS/400 - v3r1 or above 
• UNIX - 
  
  
  • AIX 4.3.3 or above 
  • Solaris 7 or above 
  • HP 10.20 or above
  • Red Hat 7.3 or above

Return to the top

Do I need to install anything additional on the AS/400? 

No, the Client Access for UNIX OS package is installed on the UNIX client only. However, you must start the Host Socket Servers that are part of the AS/400 distribution OS for v3r1 or above. 

Return to the top

What Locales (Languages) are supported by Client Access for UNIX OS? 

Most Languages that have CCSID support on the AS/400 (except bi-directional languages) are also supported by Client Access for UNIX OS. 

The complete Language environment must be installed on the UNIX client. Client Access for UNIX OS installs the Language converters (iconv) on SUN/Solaris and HP. For AIX, the iconv converters are provided on the AIX System distribution CD and must be installed. 

In addition, Client Access for UNIX OS provides on-line Help HTML file and application message translations for the following Languages: 

Dutch Netherlands, German, Italian, Japanese, Korean, Norwegian, Spanish, Swedish, Simplified Chinese, and Traditional Chinese. 

Return to the top

What environment variables must be set in order to run Client Access for UNIX OS? 

Setting Environment Variables - You must make sure to set the environment variables correctly for your UNIX platform in order for CA/UNIX to run properly. 

See Setup/environment variables in the Client Access for UNIX OS Setup and Help documentation. 

Return to the top

What is a Host Socket Server and why is it important to run Client Access for UNIX OS? 

Client Access for UNIX OS functions communicate with programs that run on the AS/400. These programs are referred to as 'host socket server' programs. Host socket servers are part of the AS/400 distribution OS for v3r1 or above. 

These host servers MUST be available and running in order to run Client Access for UNIX OS. 

To start the host servers, on the AS/400 command line, enter: 

STRHOSTSVR *ALL 

The host servers and default port numbers are: 

• Central server - 8470 
• database - 8471 
• dtaq - 8472 
• file server - 8473 
• Net print server- 8474
• Rmtcmd - 8475 
• signon server - 8476 
• Server Mapper - 449

Note that these are the defaults and all but the Server Mapper can be changed. 

Use the Cash Access Shell (CASH) command 'pingserver' to verify that the eight necessary AS/400 servers are connected and available. 

example: pingserver 449 myhost.starquest.com

Return to the top

CA/UNIX does support bi-directional file transfers either using the caftp program or through APIs. The transfers MUST be initiated on the UNIX side. A data file transferred from UNIX to AS/400 will become a source physical file. If you want to convert the source physical file to a data file, you will need to write a program using the APIs.

For more details, see About Transferring Files.

Return to the top

Why do I need ICONV support?

Client Access does not provide its own language support; it relies on the ICONV converters provided by the UNIX operating system. The ICONV converters support language conversions when downloading or uploading from an AS/400 to the UNIX system and vice versa. For example, if your AS/400 has a CCSID set to French, having the proper ICONV converters installed means that CAUNIX will be able to read the AS/400 files.

You can install the ICONV converters from the UNIX Operating System CD (i.e. AIX 4.3 installation CDs). For more information, see ICONV Converts.

Return to the top

Does Client Access for Unix support remote printing?

No, CAUNIX allows you to print through your AS/400 applications, but we rely on the tcp/ip programs supplied lpr/lpd. You cannot print from the UNIX system to an AS/400 printer.

Return to the top

What is the difference between ca5250 and xca5250?

Both programs perform the same function. ca5250 is cursors based and xca5250 is X Windows based. ca5250 is presented in black and white, while xca5250 resembles the AS/400 (black and green).

Return to the top

When do I need to run post_install?

After you have installed CAUNIX, please run post_install. If you receive a ‘security error’, and have gone through the technical document regarding the QUSER account, you will have to run post_install again.

Return to the top

What do I do when I get a ‘retrying socket bind’ error?

1. Be sure the socket is not being used by another application.
2. If is using that socket number, update the port number specified in the $CA400/etc/conf/license.dat file. In the license.dat file, please note the first line:

SERVER guava 3888532c 10941

In this example, 10941 is the socket number that needs to be changed.

If the error persist, please kill the lmgrd process and then kill the StarQuest process.

You must kill these two process in the specified order.

Return to the top

Why do I get 'Security Error' when I try to add a server or connect with Client Access for UNIX OS? 

Make sure that the hostservers on your AS/400 are started and available. 

On the AS/400 command line enter: STRHOSTSVR *ALL

Make sure that your userid and password for the AS/400 host are valid and enabled. 

Verify that the post-installation script ($CA400/etc/post_install) was run as described in the Setup documentation. 

Return to the top

I get 'ld.so.1: nameofapplication: fatal: libXm.so.3: can't open file: errno=2? 
 

This typically occurs on SUN/Solaris platforms and indicates that the LD_LIBRARY_PATH environment variable is not set or is set incorrectly. 

Make sure that it is set correctly and exported (if using Borne or Korn shell). 

example: LD_LIBRARY_PATH=${CA400}/lib:/usr/dt/lib:/usr/openwin/lib 

*Note: A similar error may occur on SUN/Solaris if the OS is not supported by Client Access for UNIX OS. SunOS must be 5.5x or above and Solaris must be 2.5x or above. 

Return to the top

When trying to start the license daemon, I get an error similar to "nohup…can't find ~starlm/bin/StarQuest …"  

The license file was created with an incorrect value for the env. variable STARLM. Correct this setting (absolute path to the installed 'starlm' package). 

Example: STARLM=/usr/lpp/starlm 

export STARLM

Next, you will need to run the lmadmin script (in $CA400/etc) again and insert the licensing information. 

Return to the top

I'm getting license errors when trying to connect with an application.  

1. Make sure that you have installed the 'starlm' license package. 

2. You should have requested then received a valid 20 digit license code from StarQuest. 

3. Run the lmadmin script in the $CA400/etc directory and enter this code, 

expiration date, and number of users. Say 'YES' to "Do you wish to start the license manager?" 

4. If you have done the above, grep for the license daemon to verify that it is up: 

ps -ef | grep lmgrd 

If there is no such process, run the lmadmin script again - but only say 'YES' to 

"Do you wish to start the license manager?"

5. Check the license.log file in $CA400/etc/conf  for status and more specific error messages relating to the problem. Call Customer Support with this information for additional Help. 

Return to the top

When I try to connect or set a server in CASH, I get 'Error, Central Server Down' 

The host servers on your AS/400 are not running. 

On the AS/400 command line enter: STRHOSTSVR *ALL