STOP

Purpose

The STOP command causes the target system processor to perform the stop function. This function consists of placing the processor in the stopped state at the end of the current unit of operation.

Syntax

Read syntax diagramSkip visual syntax diagramISQCCMDtarget_system_ProcOps_nametarget_hardware_name.LPAR_namegroup_namesubgroup_nameSTOP

Requirements

Processor operations must be active for this command to complete successfully.

The addressed target system must be initialized for this command to complete successfully.

Parameters

For a definition of target_system_ProcOps_name, target_hardware_name.LPAR_name, group_name, and subgroup_name, see ISQCCMD.

Defaults

None.

Usage

Use the STOP command to temporarily halt normal operations. You can use this command to interrupt processing to perform various hardware maintenance functions (such as cleaning the heads of a tape drive) and then continue processing from the point at which it stopped.

Note: The STOP command triggers a hardware status change event from the SE or HMC which sets the target hardware status to ’TARGET HARDWARE PROBLEM’. If you execute the ISQXDST command to display the target status, the compound status is displayed in the main panel. For more details about the target hardware status, refer to ISQVARS variable ’thwstat’.

Restrictions and Limitations

This command is not supported for coupling facility target systems.

Return Codes

The ISQCCMD command (see ISQCCMD) generates the return codes for common command processing.