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:
- SET
- DISPLAY
- PRINT
- STOP
- CANCEL
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.
You can use the SET command to modify the following groups of server initialization
parameters:
- The statistics parameters
- The debug trace parameters
- The warning 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
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:
- ARMELEMENTNAME
- ARMELEMENTTYPE
- ARMREGISTERED
This keyword can be coded as ARMSTATUS.
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.
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 ]]