INGRELS

Purpose

The INGRELS command shows the relationships that are defined for the given resource.

Syntax

Read syntax diagramSkip visual syntax diagramINGRELSresourceTARGET=system_namedomain_idsaplex_nameOUTDSN= dsnameOUTMODE=LINEAUTONETLOGWAIT= nnnSHOW=EXPANDEDSHOW=COLLAPSED

Parameters

resource
Specifies the name of the resource to be displayed. The format is name/type[/system].
TARGET
For information on the TARGET parameter, see TARGET Parameter.
OUTDSN
For information on the OUTDSN parameter, see OUTDSN Parameter.
OUTMODE
For information on the OUTMODE parameter, see OUTMODE Parameter.
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.

SHOW
Specifies whether or not to show just the relationships or also the relationship conditions. It can be:
EXPANDED
This shows relationships and their conditions. This is the default.
COLLAPSED
This shows just the relationships.

Restrictions and Limitations

None.

Usage

The INGRELS command operates sysplexwide. For an overview see Overview of Commands that Operate Sysplexwide.

Examples

If you enter ingrels and the name of a resource, a panel similar to that in Figure 1 is displayed.
Figure 1. INGRELS Command Dialog Panel
 INGKYRL0                  SA z/OS - Command Dialogs       Line  1    of 115    
 Domain ID   = IPUN8     ---------- INGRELS  ----------    Date = 01/02/03      
 Operator ID = NETOP1          Sysplex = AOC8PLEX          Time = 13:15:00      
                                                                                
  Resource    =>  NETVIEW/APL/AOC8                                              
  Target      =>                 System name, domain id or sysplex name         
                                                                                
 Cmd:  - Collapse   + Expand   E INGVOTE   F INGINFO   J INGGROUP   S Focus     
                                                                                
 Cmd Name        Type System   Dir Relationship                                 
 --- ----------- ---- -------- --- ---------------------------------------------
     ALWAYSUP    APL  AOC8      B  HasParent  - Strong                          
                                   Cond: stopDependency - UNSATISFIED           
                                   Cond: reallyDown - UNSATISFIED               
                                   Cond: allExpectedDown                        
     AOC8        SYG  AOC8      B  HasMember                                    
                                   Cond: startDependency                        
                                   Cond: stopDependency                         
                                   Cond: extStart - UNSATISFIED                 
                                   Cond: extStop - UNSATISFIED                  
                                   Cond: extStopDelayed                         
                                   Cond: prestartDependency                     
                                   Cond: prestopDependency                      
                                   Cond: groupTriggerStartupInhibited - YES     
                                   Cond: groupTriggerShutdownInhibited - YES    
                                   Cond: groupAutomationDisabled - UNSATISFIED  
     BZOENEW     APL  AOC8      B  HasParent  - Strong                          
                                   Cond: stopDependency - UNSATISFIED           
                                                                                
 Command ===>                                                                   
   PF1=Help     PF2=End        PF3=Return      PF5=Collapse all    PF6=Roll     
                PF8=Forward    PF9=Refresh    PF11=Expand all     PF12=Retrieve 
  • The Cmd field lets you specify command codes. To use one of the command codes shown, type the appropriate letter next to the resource name and press Enter. The following command codes are available:
    +
    Shows the condition details that exist for the selected relationship. This is only applicable if the relationship conditions are collapsed.
    -
    Collapses the condition details so that only the relationship is shown.
    E
    Shows the requests and votes of the resource (it displays the INGVOTE panel for the resource).
    F
    Shows detailed information about the resource (it displays the INGINFO panel for the resource).
    J
    Displays the INGGROUP panel for the resource.
    S
    Focuses on the selected resource. This is equivalent to specifying the selected resource name in the Resource field at the top of the panel.
  • The Name field shows the name of the resource that the specified resource has a relationship with. This is referred to as the relationship partner and is also called the supporting resource.
  • The Type field shows the type of the resource.
  • The Target field shows the name of the system where the resource resides.
  • The Dir field shows the direction of the relationships as seen from the specified resource.
    F
    Forward. The relationship exists from the specified resource to the partner resource.
    B
    Backward. The relationship exists from the partner resource to the specified resource.
  • The Relationship field shows the name of the relationship that exists between the two resources. This defines the dependency that exists between the two resources. The status of all descendants will be considered for a relationship with strong chaining. For weak chaining only the direct descendants are checked. Weak is the default. Strong chaining causes SA z/OS to check all relationships of the involved resources along the dependency graph.

    If the relationship name contains 'active', this means that an attempt is made to bring the supporting resource in the required state to satisfy the dependency. Active is the default.

The following PF keys are supported:
  • Use the PF5 key to collapse the visible relationship conditions for all relationships.
  • Use the PF11 key to see the relationship condition details for all relationships.
If you collapse all condition details, the INGRELS panel looks like Figure 2.
Figure 2. INGRELS Command Dialog Panel with All Details Collapsed
 INGKYRL0                 SA z/OS  - Command Dialogs      Line  1    of 27      
 Domain ID   = IPUN8     ---------- INGRELS  ----------    Date = 01/02/03      
 Operator ID = NETOP1          Sysplex = AOC8PLEX          Time = 13:15:41      
                                                                                
  Resource    =>  NETVIEW/APL/AOC8                                              
  Target      =>                 System name, domain id or sysplex name         
                                                                                
 Cmd:  - Collapse   + Expand   E INGVOTE   F INGINFO   J INGGROUP   S Focus     
                                                                                
 Cmd Name        Type System   Dir Relationship                                 
 --- ----------- ---- -------- --- ---------------------------------------------
  _  ALWAYSUP    APL  AOC8      B  HasParent  - Strong                          
  _  AOC8        SYG  AOC8      B  HasMember                                    
  _  BZOENEW     APL  AOC8      B  HasParent  - Strong                          
  _  ECICAOR     APL  AOC8      B  HasParent  - Strong                          
  _  ECICSTOR    APL  AOC8      B  HasParent  - Strong                          
  _  EDB2IRLM    APL  AOC8      B  HasParent  - Strong                          
  _  EDM2MSTR    APL  AOC8      B  HasParent  - Strong                          
  _  EIMSCTL1    APL  AOC8      B  HasParent  - Strong                          
  _  EIMSDBRC    APL  AOC8      B  HasParent  - Strong                          
  _  EOPCCNTL    APL  AOC8      B  HasParent  - Strong                          
  _  EOPCTRK     APL  AOC8      B  HasParent  - Strong                          
  _  HASPASPR    APL  AOC8      B  HasParent  - Strong                          
  _  MOVSYS1     APL  AOC8      B  HasParent  - Strong                          
  _  MOVSYS2     APL  AOC8      B  HasParent  - Strong                          
  _  MOVSYS3     APL  AOC8      B  HasParent  - Strong                          
  _  MULTIEVT    APL  AOC8      B  HasParent  - Strong                          
  _  MULTISTR    APL  AOC8      B  HasParent  - Strong                          
                                                                                
 Command ===>                                                                   
   PF1=Help     PF2=End        PF3=Return      PF5=Collapse all    PF6=Roll     
                PF8=Forward    PF9=Refresh    PF11=Expand all     PF12=Retrieve