RESTART MSGPROC

Read syntax diagramSkip visual syntax diagram RESTART MSGProc msgprocid

Authorization

Privilege Class: A, B, G

Purpose

The RESTART MSGPROC command allows a user ID to reload and start a message processor in a CF Service Machine.

If you have Class G privilege only, the message processor that you specify must be currently defined in your I/O configuration. A message processor may be defined in your I/O configuration by either the DEFINE MSGPROC command or the SPECIAL directory statement.

The RESTART MSGPROC command will cause the specified CF Service Machine to be loaded with the Coupling Facility Control Code (Licensed Internal Code) from the service element of the processor. Once the CF Service Machine is loaded, the message processor is restarted and all previous structures within the Coupling Facility will be lost.

Attention: This command affects all coupled guests connected to the message processor.

Operands

msgprocid
specifies the user ID of the CF Service Machine to be restarted.

Usage Notes

  1. The CF Service Machine's console may be viewed to verify that the restart completed successfully.
  2. To define a virtual message processor and associated virtual message devices, use the DEFINE MSGPROC command.
  3. To display information about virtual message processors in your I/O configuration, use the QUERY VIRTUAL MSGPROC command.
  4. To display information about the virtual message devices within your I/O configuration, use the QUERY VIRTUAL MSGDEVICES command.
  5. To remove all message facility capability from your virtual machine, use the SET MSGFACIL OFF command.
  6. To detach a virtual message processor and associated virtual message devices, use the DETACH MSGPROC command.
  7. If an IPL directory statement or the IPL operand on the XAUTOLOG command was initially used to load the CF Service Machine, then the same IPL statement will be used by the RESTART MSGPROC command when performing the restart. The CF Service Machine will not be loaded from the service element of the processor.

Responses

Response 1:

To restart message processor CFCC1 within user SHARE1's I/O configuration, enter the following:

restart msgp cfcc1
HCP2809I Restart of message processor CFCC1 by SHARE1 initiated.
Ready;

HCP2809I will be displayed on both the message processor and the issuer's console.

Messages

  • HCP002E Invalid operand – operand
  • HCP003E Invalid option – command contains extra option(s) starting with option
  • HCP020E Userid missing or invalid
  • HCP2805E Message processor msgprocid does not exist in your I/O configuration.
  • HCP2809I Restart of message processor msgprocid by userid initiated.