INGINFO

Purpose

INGINFO displays details about a particular group or resource from the automation manager point of view.

Syntax

Parameters

resource

Specifies the name of the resource to be displayed. The format is name/type[/system].

NOHIST

Specifies that no history information should be included in the display.

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.

RSTAT

Specifies whether or not to display the statuses of backward and forward related resources.

NO: Only related resource names and relationships are displayed. This is the default.
YES: Besides related resource names and relationships, the related resources' statuses are also displayed, including observed status, desired status, automation status, startability, and compound status.

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.

Restrictions and Limitations

None.

Usage

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

Examples

If you enter, for example, inginfo TPXA/APL/KEY3, a panel similar to Figure 1 is displayed.

Figure 1. INGINFO Command Dialog Panel

 INGKYIN0                   SA z/OS  - Command Dialogs      Line 1     of 910    
 Domain ID   = IPSNO   ------------ INGINFO  ------------   Date . . : 04/02/19
 Operator ID = NETOP1          Sysplex = KEY1PLEX           Time . . : 04:25:06

  Resource   ==>  TPXA/APL/KEY3                      format: name/type/system
  Target     ==>              System name, domain ID or sysplex name

  Resource      : TPXA/APL/KEY3
  Description   : Simulated subsystem
  Owner         : Elizabeth Merrill  Brandon Lee  Debbie Counts Park Chao
                  Paula Kropf  Marcel Bürger 
  Info link     : 
  https://www.ibm.com/support/knowledgecenter/SSWRCJ/kc_sazos_welcome.html  
          
  Status...    
     Observed Status   : AVAILABLE  
     Desired  Status   : AVAILABLE 
     Automation Status : IDLE         
     Startable Status  : YES  
     Compound Status   : SATISFACTORY     Last changed : 2019-03-24 06:19:24
     Health Status     : N/A    
                                 
  Dependencies...     
     PreStart          : Satisfied 
     Start             : Satisfied   
                                                                                
 Command ===>        
  PF1=Help     PF2=End      PF3=Return    PF4=DISPINFO            PF6=Roll      
               PF8=Forward  PF9=Refresh                          PF12=Retrieve

This panel shows detailed information about the specified resource that includes:

Resource statuses and dependencies
Resource settings
Relationships that have been defined for the resource
Requests that have been issued against resource
Votes that are pending for the resource
History data that has been collected for the resource

There are two input fields, Resource and Target, where you can specify the name of the resource and the system that is to be queried. You can specify a wildcard for the resource name. Specify the system name only when obtaining details about a resource that is not part of the local sysplex.

If the specified resource name is not unique, a selection panel will be displayed where you can select the resource concerned. You can either enter a resource name to get details about the resource, or press the PF9 key to refresh the information about the current resource.

The Info Link field displays a URL where additional information about the resource can be found. If the URL spans more than one line, then this field cannot function as a link hotspot.

If the resource is of type APL (that is, application), you can use the PF4 key to invoke the DISPINFO command to obtain details about the resource from the automation agent point of view. PF4 invokes DISPMTR when the resource is a monitor resource, DISPAPG when the resource is an application group (that is, type APG), and it invokes DISPSYS when the resource is a system resource (that is, SYS).

If the resource is of type APL (that is, application) and is also associated with a pacing gate, you can use the PF5 key to invoke the INGPAC command to obtain information about this pacing gate. The PF5 key is not shown for applications that are not linked to a pacing gate and also not shown for any other resource type.

You can use the FIND(F) and RFIND(RF) subcommands to search the displayed data for a specific string. The line containing the string is then displayed as top line of the display. For example, to locate the line containing "abc" enter FIND abc. Optionally you may add the direction parameter, which is either P (previous) or N (next). The default is next. When you want to locate the next or previous occurrence of the string, enter RFIND or RF optionally followed by the direction.

Notes:

The history data is stored using GMT time stamps so it is necessary for INGINFO to convert these time stamps to local-time before displaying the data. The GMT-to-local-time conversion calculation will be one hour different after a daylight-saving-time change. Data written after a daylight-saving-time change will be retrieved as expected but data written before will be offset by one hour.
For groups, you may see Failed :Yes under the heading Group Details..... This Group Failed flag is set when any member of the group (Basic, Move or Server) enters a HardDown state (CTLDOWN, BROKEN, STOPPED). The flag will not be cleared automatically by a subsequent successful (re)start of the APG's members. It remains set until manually cleared. Its sole purpose is to support the MakeAvailable/passive/WhenGroupHasNotFailed relationship. The usage is for situations where the (re)start of a dependent resource must be prevented until a certain recovery-related action has been performed. There are two ways to clear the flag manually:
- via the INGSET command (INGSET SET resource GRPFAILED=NO)
- via the option 'A Update' from the INGLIST command. On panel INGKYST1, the group failed flag can be manipulated under the option '5. Set Group Failed Flag ___(Yes or No)'.