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:
- Initiation: during this phase, the Gateway daemon waits until
all work has finished, or until all Client applications are disconnected
from the Gateway daemon.
- 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.