Startup and shutdown

The preferred order in which to start CICS®, CICS Transaction Gateway and certain services, and optional considerations such as Resource Recovery Services (RRS).

Ways of starting CICS Transaction Gateway

You can start the Gateway daemon in either of the following ways:
Using CTGBATCH
If you are running in batch mode using CTGBATCH, you create these files:
  • ctg.ini (text file)
  • ctg.env (STDENV file)
Using the USS command line
If you are using the USS command line method, for example in a test environment, you create these files:
  • ctg.ini (text file)
  • ctgenvvar (text file)

You can create the files by editing copies of the sample configuration files.

Start command options are available to override some ctg.ini configuration file parameters. See Options on the ctgstart command for further details.

Startup sequence

Start items in the following order:

  1. RRS

    If transactional support is required, RRS must be running on the same z/OS image as the one that CICS Transaction Gateway will use. CICS Transaction Gateway does not support a restart of RRS.

  2. TCP/IP

    TCP/IP needs to be running before CICS Transaction Gateway is started. CICS Transaction Gateway supports a restart of TCP/IP, although no requests can be serviced until the stack is restarted.

  3. CICS

    Consider running CICS and CICS Transaction Gateway in the same z/OS image, to avoid EXCI pipes using slots in the XCF (cross-system coupling facility) group in the sysplex couple data set.

    If transactional support is required, and the EXCI protocol is used to communicate with CICS, CICS and CICS Transaction Gateway must be in the same z/OS image.

    CICS Transaction Gateway supports a restart of CICS, but requests fail with an ECI_ERR_NO_CICS error until CICS is available again.

  4. Gateway daemon

    If an automation tool requires the console to listen and write from the same address space as the invoking executable, set environment variable _BPX_SHAREAS to YES. This causes the Gateway daemon to run in the same address space as CTGBATCH.

Shutdown sequence

The system and its components must be shut down in this order:
  1. Shut down the Gateway daemon normally, allowing all transactions that are in-flight to complete.
  2. Shut down TCP/IP normally.
  3. Shut down CICS normally.
  4. Terminate CTGRRMS.
  5. Shut down CTGRRM normally.

Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tgzos_latest/help/topic/com.ibm.cics.tg.zos.doc//ctgzos/ctgrules.html