EXPLAIN

Purpose

The EXPLAIN facility gives you a description of the automation statuses that can occur for SA z/OS subsystems. It explains what the status means, why the subsystem may have got into the status, and how another status can be achieved.

Syntax

Read syntax diagramSkip visual syntax diagramEXPLAINstatussubsystemTARGET=system_namedomain_IDsaplex_name

Parameters

If you do not specify any parameters, a menu panel is displayed where you can specify either an automation manager status, automation agent status, or the name of a subsystem.

status
The status you want to see explained.
subsystem
The name of the subsystem you are investigating. Its status is queried and an explanation of the automation agent status is displayed.
TARGET
For information on the TARGET parameter, see TARGET Parameter.

Restrictions and Limitations

The EXPLAIN command can only be used when SA z/OS is initialized.

Usage

Use EXPLAIN when you want information about an automation status.

Examples

If you enter EXPLAIN, a panel similar to Figure 1 is displayed.
Figure 1. EXPLAIN Command Dialog Panel
 AOFKEXPL                  SA z/OS  - Command Dialogs                           
 Domain ID   = IPSFO     ---------- EXPLAIN  ----------    Date = 06/27/02      
 Operator ID = NETOP1                                      Time = 17:28:26      
                                                                                
  Specify one of the following for a description of the corresponding status:   
                                                                                
     1.  Agent status                              (? for list)                 
     2.  Automation manager status                        (? for list)          
     3.  Subsystem name                                                         
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
    PF1=Help     PF2=End      PF3=Return                        PF6=Roll        
                                                               PF12=Retrieve