Controlling named counter server regions

You can issue commands to control a named counter server, using the MVS™ MODIFY (F) command to specify the job or started task name of the server region, followed by the server command. The general form of a named counter server command, using the short form F, is as follows:

F server_job_name,command
parameters...  comments

The commands supported by a named counter server are:

These commands and their options are as follows:

SET keyword=operand[,keyword=operand,...]
Change one or more server parameter values. The command can be abbreviated to T, as for the MVS SET command. See The SET command options for details.
DISPLAY keyword[=operand][,keyword[=operand,]...]
Display one or more parameter values, or statistics summary information, on the console. The valid keywords for DISPLAY are all the initialization parameters, plus an additional set described under DISPLAY and PRINT command options.

The command can be abbreviated to D, as for the MVS DISPLAY command.

PRINT keyword[=operand][,keyword[=operand,]...]
Produces the same output as DISPLAY, supporting the same keywords, but on the print file only.
STOP
Terminate the server normally. The server waits for any active connections to terminate first, and prevents any new connections while it is waiting. The command can be abbreviated to P.
Note:
You can also use the MVS STOPcommand, which is equivalent to issuing the server STOP command through the MVS MODIFY command. The syntax of the STOP command is:
STOP|P [jobname.]identifier[,A=asid] 
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 SET command options

You can use the SET command to modify the following groups of server initialization parameters:

See Named counter server parameters for details of these keywords.

Examples of the SET command: The following example changes the statistics options:

SET STATSOPT=BOTH,EOD=21:00,STATSINT=06:00

DISPLAY and PRINT command options

You can use the DISPLAY (and PRINT) commands to display the values of any initialization parameters plus some additional information.

The parameters supported by the DISPLAY and PRINT commands are as follows:

ARMREGISTERED
Shows whether ARM registration was successful (YES or NO).
CONNECTIONS
Display the jobnames and applids of the regions currently connected to the server to which the command is issued.

This keyword can be abbreviated to CONN.

COUNTERS
Display the names of all the named counters currently allocated in a pool.
COUNTERS={name|generic_name}
Display the details of a specific named counter, or set of named counters whose names match the generic name. Generic names are specified using the wildcard characters * (asterisk symbol) and % (per cent symbol).

If no named counter is specified, this is treated as equivalent to DISPLAY COUNTERS.

This keyword can be abbreviated to COUNTER.

DISPLAY and PRINT options for statistics summaries.

Use the following parameters to display or print statistics:

CFSTATS
Display statistics for coupling facility interface accesses and responses from the server.

This keyword can also be specified as CFST or STATSCF.

POOLSTATS
Display usage statistics for the pool list structure as a whole. This is based on information returned by coupling facility access requests, therefore it is only as current as the most recent request made through the server to which the command is issued.

This keyword can be abbreviated to POOLST.

STORAGESTATS
Display main storage allocation statistics for the server address space.

This keyword can be abbreviated to STORAGEST or STGST.

DISPLAY and PRINT options for combined lists of information

These keywords represent combined lists of information:

PARAMETERS
Display the main parameter values, which are:
POOLNAME
STATSOPT
ENDOFDAY
STATSINTERVAL
POOLSIZE

This keyword can be abbreviated to PARM or PARMS.

ALLPARAMETERS
Display all parameter values, which are those listed for PARAMETERS, above, plus:
CFTRACE
RQTRACE
ENTRYWARN
ENTRYWARNINC

This keyword can be abbreviated to ALLPARMS.

STATISTICS
Display all available statistics.

This keyword can be abbreviated to STAT or STATS.

INITIALIZED
Display the parameters and statistics that are usually displayed when initialization is complete, which are those listed for PARAMETERS above, plus:
POOLSTATS
STGSTATS

This keyword can be abbreviated to 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.

Server response to XES events

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.

[[ Contents Previous Page | Next Page Index ]]