Starting CTGRRMS services

Use the <install_path>/bin/ctgasi command to start CTGRRMS services that are used for XA support. ctgasi must be run in a UNIX System Services shell. It can be launched in batch mode using CTGBATCH.

About this task

If the CTGRRMS address space is not already running when a Gateway daemon with XA support is started, then ctgasi is automatically invoked silently to start CTGRRMS. You can also manually start CTGRRMS by using the ctgasi command if, for example, CICS® Transaction Gateway fails to start, or a new version of the CTGINIT module in SCTGLINK is distributed.

The user ID executing the Gateway daemon, or ctgasi, must have at least UPDATE level access to the CTG.RRMS.SERVICE in the facility class to start CTGRRMS.

Follow these steps after successfully installing CICS Transaction Gateway and before running any Gateway daemons:

Procedure

  1. Ensure that the user ID which runs ctgasi has UPDATE, CONTROL, or ALTER authority to the RACF® FACILITY CTG.RRMS.SERVICE and log on using this user ID.
  2. Shut down all existing Gateway daemon address spaces, if present, in the logical partition (LPAR).
  3. Add hlq.SCTGLINK to the MVS LNKLST. This load library must be APF-authorized.
  4. Issue the MVS command: 
    F LLA,REFRESH
    to refresh the LNKLST LOOKASIDE address space (LLA).
  5. Issue the following command: 
    ctgasi
  6. See the following messages which are issued to the system log when CTGRRMS services are started successfully: 
    CTG6241I Initializing CTGRRMS Services
    CTG6242I  CTGRRMS Services open for business
  7. Repeat these steps on every LPAR on which you install this version of CICS Transaction Gateway.