Normal and immediate shutdown

You can stop the IBM® CICS® Transaction Gateway service normally which allows all work to finish, or immediately, without waiting.

Normal shutdown

To shut down the CICS Transaction Gateway service, select the service in the Services dialog box, and click Stop. When you stop the service, both the Gateway daemon and the Client daemon are stopped at the same time.

You can also shut down the CICS Transaction Gateway, with the ctgadmin command, entered at a command prompt. For example:
ctgadmin -a shut

If the default port 2810 is not used you must use the -adminport option.

For more information on the options available with the ctgadmin command, see the ctgadmin command reference.

During a normal shutdown, new work is not allowed to start, and Client applications might not connect to the Gateway daemon. A normal shutdown has two phases:
  1. Initiation: during this phase, the Gateway daemon waits until all work has finished, or until all Client applications are disconnected from the Gateway daemon.
  2. Completion: during this phase, the Gateway daemon stops.
The following ECI requests are accepted during the initiation phase of a normal shutdown:
  • A Client application tries to flow an ECI request (SYNC or ASYNC) which continues a logical unit of work.
  • A Client application tries to flow an ECI Request (SYNC or ASYNC) which commits or backs out a logical unit of work.
  • A Client application tries to get a reply or wait for a reply.
The following EPI requests are accepted during the initiation phase of a normal shutdown:
  • A Client application tries to flow a reply to a conversational transaction.
  • A Client application tries to flow a request to disconnect or purge a terminal.
  • A Client application tries to flow a request to get event.
All other requests, or attempts to open a new connection are rejected, and an IOException is thrown.
The following EPI requests allow a normal shutdown:
  • ECI_GET_REPLY_WAIT
  • ECI_GET_SPECIFIC_REPLY_WAIT
  • EPI_GET_EVENT (the waitState is EPI_WAIT, for example an EPIRequest.getEvent call with the second parameter set to EPI_WAIT sets the request object to wait for events).
Other calls that are waiting to finish prevent the Gateway daemon from quiescing.

Immediate shutdown

You can force an immediate shut down by entering the following command at the command prompt:
ctgadmin -a shut -immediate
Note: The -immediate option can be abbreviated to -imm.

CICS Transaction Gateway shuts down immediately without waiting for work to complete.


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/shutdown.html