ISQXPSM

Purpose

The ISQXPSM command starts and stops the ProcOps Service Machine (PSM) or returns its VM CP status from the system where it is running. In addition, PSM commands can be forwarded to the PSM for execution with this command.

Syntax

Read syntax diagramSkip visual syntax diagramISQXPSMtarget_hardware_nameSTARTSTOPSTATUSCMD(PSM command)
PSM command
Read syntax diagramSkip visual syntax diagramISQACTMHISQCLEARMCISQQUERYQEISQSTATUSISQTRACEMSERVCSERVMHLOGGERCNSERVERTCPIPONOFF

Requirements

The requirements for this command to complete successfully are:

  • Processor operations must be active.
  • To issue a START, STOP, or STATUS command:
    1. The hosting VM system and the PSM name must be defined in ProcOps.
    2. The VM host system of the PSM, associated with the specified target_hardware_name, must have been initialized with the ProcOps ISQXIII command.
    3. A VM user, having the authority to issue XAUTOLOG, FORCE, and QUERY commands, must be logged on to the console via SE/HMC.
  • To issue a CMD command, the PSM must be active.

Parameters

target_hardware_name
The name of a processor of type PSM.
START
Starts the PSM virtual machine that is specified in target_hardware_name.
STOP
Stops the PSM virtual machine that is specified in target_hardware_name.
STATUS
Returns the VM CP status for the PSM virtual machine that is specified in target_hardware_name.
CMD
Forwards a PSM command to the ProcOps Service Machine of the specified target hardware for execution and returns the result.
PSM command
One of the PSM diagnosis and service commands that is listed in the syntax fragment, see PSM Commands - Special Requests for more details.

Defaults

None.

Usage

See PSM Commands - Special Requests for information about the PSM commands that are available.

Restrictions and Limitations

Only a subset of the available PSM commands can be used with the CMD option of ISQXPSM. To use the full set of commands, a VM user must be logged on as PSM and enter the commands at the PSM console.

The following commands can only be entered from the PSM console directly:

  • ISQMSG
  • ISQPSM
  • STOPALL

Return Codes

0
The ISQXPSM command completed successfully.
4
One of the following occurred:
  • No VM host system has been defined for this PSM.
  • The PSM's VM host target system has not initialized.
  • The PSM has not been defined for the specified target hardware.
  • The specified target hardware type is not PSM.
  • There is an error in the parameter list.
6
Authorization error. Either the user ID that was checked to access the specified target hardware has not been authorized, or the allowed access level is not sufficient.
8
One of the following occurred:
  • ISQSEND returned an error while processing a START, STOP, or STATUS request.
  • An error occurred while waiting for the response of a START, STOP, or STATUS request.
32
The ProcOps environment does not exist; the ISQXPSM command was not processed.