Shared TS queue server commands

Commands can be issued to control a queue server using the MVS™ MODIFY (F) command specifying the job or started task name of the server region. The general form of a queue server command is as follows:

       F server,cmd parameter,parameter...   comments

The MVS STOP command is equivalent to issuing the server command STOP using the MVS MODIFY command.

The queue server supports the following commands:

SET keyword=value
changes one or more server parameter values. This applies to all parameters other than those indicated as being for initialization only. The command can be abbreviated to T, as for the MVS SET command.
DISPLAY keyword
displays one or more parameter values, or statistics summary information, on the console. The valid parameter keywords for DISPLAY and PRINT are described later in this section. The command can be abbreviated to D, as for the MVS DISPLAY command.
PRINT keyword
produces the same output as DISPLAY but only on the print file.
STOP
terminates the server, waiting for any active connections to terminate first, and preventing any new connections.

The command can be abbreviated to P, as for the MVS STOP command.

CANCEL {RESTART={NO|YES}}
Terminate the server immediately. You can specify whether automatic restart should be requested.

For information about CANCEL RESTART see The CANCEL command options.

The server also responds to XES events such as an operator SETXCF command to alter the structure size. If the server can no longer access the coupling facility, it automatically issues a server CANCEL command to close itself down immediately.

DISPLAY and PRINT keywords

DISPLAY or PRINT can display the values of any initialization parameters plus the following additional information:

ARMREGISTERED
Shows whether ARM registration was successful (YES or NO).
CONNECTIONS
List of the jobnames and applids for the regions currently connected to this server. This keyword can also be coded as CONN.

Statistics summaries:

BUFSTATS
Queue index buffer pool statistics.

This keyword can also be coded as BUFST.

CFSTATS
Coupling facility interface I/O and response statistics.

This keyword can also be coded as CFST or STATSCF.

POOLSTATS
Usage statistics for the pool list structure as a whole.

This keyword can also be coded as POOLST.

STORAGESTATS
Main storage allocation statistics for the server address space.

This keyword can also be coded as STGST, STGSTATS, or STORAGEST.

Keywords representing combined lists of information

PARAMETERS
Main parameter values.

The keyword can also be coded PARM, PARMS, or PARAM.

ALLPARAMETERS
All parameter values.

This keyword can also be coded as ALLPARMS.

STATISTICS
All available statistics.

This keyword can also be coded as STAT or STATS.

INITIALIZED
Selected parameters and statistics whose values are usually displayed when initialization is complete.

This keyword can also be coded as INIT.

ARM
Display all ARM-related parameter values:

This keyword can be coded as ARMSTATUS.

The CANCEL command options

You can use the CANCEL command to request automatic restart by specifying the following parameter:

RESTART={NO|YES}
Terminate the server immediately, specifying whether or not automatic restart should be requested. The default is RESTART=NO.

If the server encounters an unrecoverable problem with the coupling facility connection, consisting either of lost connectivity or a structure failure, it cancels itself using the CANCEL RESTART=YES command. This terminates the existing connection and shuts down the server. A new instance of the server job is then started.

A server can also be restarted explicitly using either the server command CANCEL RESTART=YES or the MVS command CANCEL jobname,ARMRESTART.

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

[[ Contents Previous Page | Next Page Index ]]