IBM SC34-7012-01 manual Waiting on events during initialization, Server commands for ARM support

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.

Waiting on events during initialization

If a server is unable to connect to its coupling facility structure during server initialization because of an environmental error, 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:

vA specific XES event indicating that the structure has become available, or

vA general XES event indicating that some change has occurred in the status of coupling facility resources (for example, when a new CFRM policy has been activated).

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 canceled at this stage using an MVS CANCEL command if necessary.

Server initialization parameters for ARM support

The server startup parameters for ARM support are:

ARMELEMENTNAME=elementname

specifies the automatic restart manager element name, up to 16 characters, to identify the server to ARM for automatic restart purposes.

ARMELEMENTTYPE=elementtype

specifies the automatic restart manager element type, up to 8 characters for use in ARM policies as a means of classifying similar elements.

These parameters are the same for all the data sharing servers. For more details, see the automatic restart manager (ARM) parameters in the CICS System Definition Guide .

Server commands for ARM support

The following are the ARM options you can use on server commands:

CANCEL RESTART={NOYES}

terminates the server immediately, specifying whether or not automatic restart should be requested. The default is RESTART=NO.

You can also enter RESTART on its own for RESTART=YES, NORESTART for

RESTART=NO.

ARMREGISTERED

shows whether ARM registration was successful (YES or NO).

ARM

This keyword, in the category of display keywords that represent combined options, can be used to display all ARM-related parameter values. It can also be coded as ARMSTATUS.

These commands are the same for all the data sharing servers.

72CICS TS for z/OS 4.1: Recovery and Restart Guide