If you plan to run your applications from the same server where the CICSServer or IMSServer is installed, then, after you set the Java classpath, no other configuration is needed. If, however, you are going to run your applications on different computers, then you need to install the client support files for your environment on all the computers you will use.
Install the CICSClient or IMSClient from the install program, depending on your host program, on each of the computers where you have the runtime server installed.
|To edit your Java classpath|
|Add the following client support files to your Java classpath:
In the directory
In the directory
Client access to the runtime servers is handled through the
<host type>ClientConfig.xml file, which is created automatically the first time a client operation is run on a remote or client system.
<host type>ClientConfig.xml file is located in the
cfg directory, either in the location you specified as a “System” property (
Attachmate.home) or in the Java-provided location,
user.home. On a Windows system, this is
Documents and Settings\user_login\cfg.
|To specify a remote runtime server to serve applications from the processing runtime server|
Open the <host_type>ClientConfig.xml in a text editor and modify as follows:
<Property Name = “serverAddress” Value = “<DNS Name> or <IPAddress>”
|To specify a custom directory for the client configuration file:|
|Set the System property "Attachmate.home" on the command line that starts the Java Virtual Machine that is running your interface objects as follows:
How you pass command line arguments to the Java VM depends on your environment. The Java VM can be part of a Web server for Servlets and JSPs, in a browser for a Java Applet, or a stand-alone process if your interface objects are running as part of a Java application.
Set the System property programmatically from within your application as follows:
Your application must make the call before you run interface objects, and it must have the necessary permission to modify system properties.
As an optional feature, you can set up logging and tracing, both on the server and the client-side.
IMSConnCfg.xmlfile, depending on your host type, is the <globalParams> parameter. This is where logging and tracing options are set. See Provide Host Access to Client Operations for more information.
<host_type>client.propertiesfile, located in the start-up directory of your Java Virtual Machine.
|Setting Up the Runtime Environment|
|Provide Host Access to Client Operations|
|Capturing Host Data|