Controlling region status servers

You can issue commands to control a region status 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 an MVS modify command, using the short form F, is as follows:
F job_name,command parameters... comments
You use the MODIFY command to pass information to a job or started task. In this task, you use the following commands to control the region status servers.

Procedure

  • To modify the server initialization parameters, use the MVS SET command:
    SET keyword=operand[,keyword=operand,…]
    The SET command can be abbreviated to T, as for the MVS SET command. See The SET command options for details.
  • To display the values of one or more parameter values or statistics summary information on the console, use the DISPLAY command:
    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.

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

  • To print the output that the DISPLAY command produces, use the MVS PRINT command:
    PRINT keyword[=operand][,keyword[=operand,]…]
    The PRINT command produces the same output as DISPLAY, supporting the same keywords, but on the print file only.
  • To delete a table, use the DELETE TABLE=name command.
    The table must not be in use for this command to succeed. You can abbreviate the command to DEL.
  • 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 Cross System Extended Services (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.