All three types of CICS® data-sharing server--temporary storage, coupling facility data tables, and named counters--support automatic restart using the services of automatic restart manager. The servers also have the ability to wait during start-up, using an event notification facility (ENF) exit, for the coupling facility structure to become available if the initial connection attempt fails.
During initialization, a data-sharing server unconditionally registers with ARM, except when starting up for unload or reload. A server does not start if registration fails, with return code 8 or above.
If a server encounters an unrecoverable problem with the coupling facility connection, consisting either of lost connectivity or a structure failure, it cancels itself using the server command CANCEL RESTART=YES. This terminates the existing connection, closes the server and its old job, and starts a new instance of the server job.
You can also restart a server explicitly using either the server command CANCEL RESTART=YES, or the MVS™ command CANCEL jobname,ARMRESTART
By default, the server uses an ARM element type of SYSCICSS, and an ARM element identifier of the form DFHxxnn_poolname where xx is the server type (XQ, CF or NC) and nn is the one- or two-character &SYSCLONE identifier of the MVS image. You can use these parameters to identify the servers for the purpose of overriding automatic restart options in the ARM policy.
If a server is unable to connect to its coupling facility structure during server initialization because of an environmental error, such as no coupling facility being available, or loss of connectivity to the structure, the server uses an ENF event exit to wait for cross-system extended services (XES) to indicate that it is worth trying again. The event exit listens for either:
When a relevant event occurs, the server retries the original connection request, and continues to wait and retry until the connection succeeds. A server can be cancelled at this stage using an MVS CANCEL command if necessary.
The server startup parameters for ARM support are:
These parameters are the same for all the data sharing servers. For more details, see CICS System Definition Guide .
The following are the ARM options you can use on server commands:
You can also enter RESTART on its own for RESTART=YES, NORESTART for RESTART=NO.
These commands are the same for all the data sharing servers. For more details, see CICS System Definition Guide .
[[ Contents Previous Page | Next Page Index ]]