Creating a configuration file

Use the Configuration Tool to create a CICS® Transaction Gateway configuration file.

To start the Configuration Tool, enter the ctgcfg command at a command prompt. Alternatively, on Windows, click the shortcut on the Start menu. To use the Configuration Tool remotely on UNIX and Linux, export the display using the commands described in Using X Window System for GUI.

Configuration settings are stored by default in the ctg.ini file, in the <install_path>/bin directory on UNIX and Linux, and in the <product_data_path> directory on Windows. You can specify a different location and optionally change the name of the configuration file by setting the CICSCLI environment variable. For more information, see Specifying the configuration file. If this variable is set, the Configuration Tool loads the file referenced by CICSCLI, when it starts, otherwise it attempts to load ctg.ini from the default location. If the Configuration Tool fails to find a configuration file, it creates a new one. This file must be edited and saved before use.

The Configuration Tool allows parameter values to be entered in mixed-case and also writes the values as mixed-case to the configuration file. Some values are changed to uppercase at run time.

Running the Configuration Tool for a different operating system

Proceed as follows:
  1. Install the product on the workstation where you want to run the Configuration Tool.
  2. To edit the configuration, copy the configuration file (ctg.ini) to the <product_data_path> directory on the workstation, using FTP in ASCII mode.
  3. Issue the following command to display help about the Configuration Tool:
    ctgcfg -?
  4. Issue the following command:
    ctgcfg -PLAT OSCODE
    where OSCODE represents the operating system that the Configuration Tool should emulate, and is one of the values returned by the command that you issued at step 3.
  5. Make the required entries and click Save to create or update the ctg.ini file.
  6. Use FTP in ASCII mode to transfer the file to your system.

Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tg_latest/help/topic/com.ibm.cics.tg.doc//ctgunx/perties.html