Filter
Top Products
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:
v A specific XES event indicating that the structure has become available, or
v A 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={NO|YES}
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.
72 CICS TS for z/OS 4.1: Recovery and Restart Guide