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.

About this task

The general form of a named counter server command, using the short form F, is as follows:
F server_job_name,command
parameters...  comments
SET keyword=operand[,keyword=operand,…]
Change one or more server parameter values.

Procedure

  • To change one or more server parameter values, use the SET command.
    You can abbreviate the command to T, as for the MVS SET command. See The SET command options for details.
  • To display one or more parameter values or statistics summary information on the console, use the DISPLAY command.
    The syntax is as follows:
    DISPLAY keyword[=operand][,keyword[=operand,]…]
    The valid keywords for DISPLAY are all the initialization parameters, plus an additional set described under DISPLAY and PRINT command options. You can abbreviate the command to D, as for the MVS DISPLAY command.
  • To print the parameter values, use the PRINT command.
    This command produces the same output as the DISPLAY command, supporting the same keywords, but on the print file only.
  • To stop the server normally, use the STOP command.
    The server waits for any active connections to end first, and prevents any new connections while it is waiting. You can abbreviate the command to P. You can also use the MVS STOP command, 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] 
  • To terminate the server immediately, use the CANCEL command.
    You can also specify whether the server automatically restarts with the RESTART option. 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.