INGWHY

Purpose

The INGWHY command queries the automation manager and the various agents for the reasons why a resource is in the displayed status or why it cannot be brought into the desired status.

Syntax

Parameters

resource: Specifies the name of the resource to be analyzed. The format is name/type[/system]. Supported resource types are APL, APG, MTR, and REF.
TARGET: For information on the TARGET parameter, see TARGET Parameter.
OUTDSN: For information on the OUTDSN parameter, see OUTDSN Parameter. The record length must be at least 80 bytes.
TIMEOUT: Specifies the maximum number of seconds the INGWHY command waits for responses from the remote system that the command was sent to. The maximum value is 999 seconds. The default is 30 seconds.
WAIT: Specifies the number of seconds to wait before reporting that a timeout occurred if the automation manager does not provide the requested data. The maximum time interval is 999 seconds. If omitted, the time interval is 30 seconds.
OUTMODE: For information on the OUTMODE parameter, see OUTMODE Parameter.

Restrictions and Limitations

INGWHY is an analysis support function. There are situations where no reason can be found. If that situation appears, it is recommended to use the existing product commands to analyze manually.

Example cases when no reason is found:

Transient situations that change during the analysis process.
Status changes manually done by a user.

Examples

Figure 1. INGWHY Command Dialog Panel

  INGKYAN2                  SA z/OS  - Command Dialogs        Line  1    of 16     
  Domain Id   : IPXXG    ------------ INGWHY   ------------   Date     : 02/07/17      
  Operator Id : OPER1            Sysplex = PROD03_X           Time     : 19:05:50      
                                                                                
  Analyzed Resource:  IMS1DBRC/APL/SYSA                     Job Name: IMSCA1RC
  Status   Compound:  AWAITING      Desired: AVAILABLE      Observed: SOFTDOWN                                 
  -------------------------------------------------------------------------------                                                               
                                                                   More: F10/F11  
   SITUATION:
  IMS1DBRC/APL/SYSA is waiting to be started.
                          
   REASON 2 OF 2:
  IMS1DBRC/APL/SYSA has a dependency on IMSRS/APL/SYSA.  
  IMSRS/APL/SYSA got a SUSPEND request 
  The SUSPEND request was issued by OPERID=OPER1.
  Request Comment: IMSRS is being serviced till 2pm     
                   
   ACTION 2 OF 2:                                             INGWHYSA(A0100150) 
  Refer to your company's rules in order to take the appropriate 
  action. 
  Consider the following commands to investigate IMSRS/APL/SYSA: 
  - INGVOTE
  - INGSUSPD                               
                                                                                
  Command ===>___________________________________________________________________                                                                   
  F1=Help     F2=End      F3=Return                                  F6=Roll       
                          F9=Refresh    F10=Previous   F11=Next     F12=Retrieve

For each situation, there might be more than one reason with a corresponding action. If this is the case, you can press F10 or F11 to roll through the reasons and actions.