5.2.3.2 A Client-Initiated Shutdown

The TMA TCP for IMS product can be configured to allow shutdown to be initiated by a remote client request or a response to a remote client request. This may be useful if it is necessary to shut down TMA TCP for IMS from a remote system, rather than by operator command from an z/OS console.

Shutdown is requested by embedding a modify command into the user request data of an IMS server request, or the user response data of an IMS server response in the following format.

Format the command as shown in the Listing 5‑3 of the topic Message Format. If the jobname specified is incorrect, TMA TCP for IMS simply ignores the command and processes the request or response in the usual way.

Note:

To use this feature, the configuration file must specify the CLIENTSHUTDOWN=YES option on the SYSTEM statement (the default is NO). Otherwise, TMA TCP for IMS ignores a remote client request to initiate shutdown processing.

Listing 5‑3 Syntax for Client-Initiated Shutdown

F jobname TERM=type

jobname

is the z/OS jobname assigned to TMA TCP for IMS.

TERM= type

is the method for shutting down the system. The values for type are as follows.

STOP

is a normal shutdown. If TERM=STOP is specified, TMA TCP for IMS initiates normal shutdown processing, as if an operator had entered the SHUTDOWN command from an z/OS console.

DUMP

is an abend with a dump. If TERM=DUMP is specified, TMA TCP for IMS issues a U3166 abend. If a SYSUDUMP DD statement is included in the JCL, a standard z/OS dump is produced.