INGLIST

Examples

If you enter inglist, you will see information about all automated resources, as shown in Figure 1.

 INGKYST0                  SA z/OS  - Command Dialogs     Line  1    of 12     
 Domain ID   = IPXF1      -------- INGLIST   ---------    Date = 02/07/17        
 Operator ID = NETOP1          Sysplex = KEYABC_X         Time = 17:27:19       
  A Update   B Start    C Stop     D INGRELS  E INGVOTE  F INGINFO  G Members   
  H DISPTRG  I INGSCHED J INGGROUP K INGCICS  L INGIMS   M DISPMTR  P INGPAC 
  R Resume   S Suspend  T INGTWS   U User     X INGWHY  / scroll                                                
 CMD Name        Type System   Sus Compound     Desired      Observed   Nature  
 --- ----------- ---- -------- --- ------------ -----------  ---------- --------
     RGT#PS1     APG               SATISFACTORY AVAILABLE    AVAILABLE  BASIC             
     RGT#PS1     APL  KEYA         SATISFACTORY AVAILABLE    AVAILABLE             
     RGT#PS1     APL  KEYB         SATISFACTORY AVAILABLE    AVAILABLE           
     RGT#PS1     APL  KEYC         SATISFACTORY AVAILABLE    AVAILABLE             
     RGT#PS2     APG               SATISFACTORY UNAVAILABLE  SOFTDOWN   BASIC        
     RGT#PS2     APL  KEYA         SATISFACTORY UNAVAILABLE  SOFTDOWN             
     RGT#PS2     APL  KEYB         SATISFACTORY UNAVAILABLE  SOFTDOWN            
     RGT#PS2     APL  KEYC         SATISFACTORY UNAVAILABLE  SOFTDOWN             
     RGT#PS3     APG               SATISFACTORY AVAILABLE    AVAILABLE  MOVE         
     RGT#PS3     APL  KEYA         SATISFACTORY UNAVAILABLE  SOFTDOWN             
     RGT#PS3     APL  KEYB         SATISFACTORY AVAILABLE    AVAILABLE           
     RGT#PS3     APL  KEYC         SATISFACTORY UNAVAILABLE  SOFTDOWN                         
                                                                                
 Command ===>                                                                   
  PF1=Help    PF2=End      PF3=Return   PF4=DISPSTAT  PF5=Filters   PF6=Roll    
              PF8=Forward  PF9=Refresh PF10=Previous PF11=Next     PF12=Retrieve

The amount of data depends on the screen size. Press PF10/11 to scroll horizontally.

Use the PF5 key to restrict the list of resources to be displayed. This causes the INGFILT panel to be displayed, where you specify the filter criteria to be used for the display.

You can use the PF4 key to toggle to the DISPSTAT panel to view the same resources, but now from the automation agent viewpoint. To return to the INGLIST panel press the PF3 key on the DISPSTAT panel. Note that pressing PF4 on the DISPSTAT panel displays the INGLIST panel for all resources shown in the DISPSTAT panel. However, this might not be the same as the original INGLIST display because the DISPSTAT display might be modified due to filtering or suppressing of resources that the automation agent does not handle, such as application groups.

This panel displays the following information:

• 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:

  A

  Resets the status of the resource or application group (observed status, automation status). Sets or resets attributes that are assigned to the resource. The automation agent status can also be updated if you enter this command code. See Setting the Status or Attribute of a Resource or Application Group.

  B

  Calls the INGREQ command dialog to make the resource available. See INGREQ for further information.

  C

  Calls the INGREQ command dialog to make the resource unavailable. See INGREQ for further information.

  D

  Displays dependency information and its evaluation for the resource.

  E

  Invokes the INGVOTE command, showing all requests currently present for the resource. Allows the operator to cancel a request.

  F

  Shows details about the resource by invoking the INGINFO command.

  G

  Shows all members for the selected application group or processor in a new window.

  H

  Invokes the DISPTRG command to show the trigger definitions for the selected resource.

  I

  Invokes the INGSCHED command to show the resource overrides for the selected resource.

  J

  Invokes the INGGROUP ACTION=MEMBERS command to show member details.

  K

  Invokes the INGCICS command using the selected resource.

  L

  Invokes the INGIMS command using selected resource.

  M

  Invokes the DISPMTR command to show the monitors that have been defined for the selected resource.

  P

  Invokes the INGPAC command using the selected resource.

  R

  Calls the INGSUSPD command dialog to resume automation for the resource. See INGSUSPD for further information.

  S

  Calls the INGSUSPD command dialog to suspend automation for the resource. See INGSUSPD for further information.

  T

  Invokes the INGTWS command using selected resource.

  U

  Invokes the AOFEXC04 user exit if it has been installed.

  X

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

• The Name field shows the name of the resource.
• The Type field shows the type of the resource.
• The System field shows where the resource is defined.
• The Sus field shows whether the resource is suspended or not. No automation is done for the resource if it is suspended.
• The Compound field shows the compound status of the resource. This is a summary of all statuses of the resource and provides a single value to check the status of a resource.
• The Desired field shows the status that the automation manager is trying to move the resource to. It can either be available or unavailable.
• The Observed field shows the current status of the resource as observed by the automation agent.
• The Nature field applies to group resources only and defines the type of the group. It can have the following values:

  BASIC

  Indicates that the group contains a number of different resources, all of which perform different roles to constitute a complete application.

  MOVE

  Indicates that the group contains alternate instances of the same resource.

  SERVER

  Indicates that the group contains a number of readily interchangeable resources. The group has a target that tells the automation manager how many of them should be made available for the group to be available.

• The Automation field shows the status representing the automation agents' automation for the resource.
• The Startable field indicates whether or not it is possible to start the resource if the automation manager is asked to do so at this point in time.
• The Health field shows the health status of the resource.
• The Auto field shows the automation flag that is maintained by the automation manager. No automation is performed for the resource by the automation manager if the flag is off.
• The Hold field shows the hold flag that is maintained by the automation manager.
• The Description field shows descriptive information about the resource.
• The Starttype field shows the preset start type to be used the next time the resource is made available (started). This value is set by INGSET and will override any TYPE value specified (or defaulted) on the next INGREQ start request.
• The Stoptype field shows the preset stop type to be used the next time the resource is made unavailable (shutdown). This value is set by INGSET and will override any TYPE value specified (or defaulted) on the next INGREQ stop request. However, a stop type of FORCE, wherever specified, will always be honored.
• The Trigger field shows the trigger that is associated with the resource.
• The Schedule field shows the schedule (service period) that the resource is linked to.
• The Category field shows the IBM-defined or user-defined category of the resources. For IBM-defined categories, these might be CICS®, DB2®, or IMS.
• The Subcategory field shows the IBM-defined or user-defined subcategories of the resource. For IBM-defined the resource categories might be CICS, DB2, IMS, OPC, INFOSPHERE, LIFELINE, MQ and ITM.
• The Jobname field shows the job name assigned to the resource.
• The Qual field indicates how a resource qualifies for the current runmode. There are three indicators:

  G

  Resource qualifies because it is in one or more groups that qualify.

  R

  Resource qualifies because it was explicitly added via the INGRUN command.

  T

  Resource qualifies because of its runtokens.

• The Inform List field shows the list of specified targets (such as SDF) that receive application status changes.
• The DDS field shows the default desired status of the resource.
• Resources can be associated with a pacing gate during startup and shutdown phases to control how many resources can be started or stopped concurrently. For such resources the following information is available:

  Pacing Gate

  The name of the pacing gate that is associated with this resource.

  Pacing Status

  The pacing status of the resource. The following status values exist:

  blank

  The resource is not associated with a pacing gate.

  Inactive

  There is no activity in any of the pacing gates associated with the resource.

  Waiting

  The resource is waiting for transition through a pacing gate.

  Starting

  The resource is currently in transition through the pacing gate to become AVAILABLE.

  Stopping

  The resource is currently in transition through the pacing gate to become UNAVAILABLE.

• The Model field shows the model of an application group (APG) of nature MOVE or SERVER.

  1

  Means that the move behavior of the group and its members is defined through preference values.

  2

  Means that the move behavior of the group and its members is defined through move scenarios and by assigning roles to the group members.

• The Dyn field shows whether the resource was created dynamically.

  Yes

  The resource was created dynamically.

  blank

  The resource was not created dynamically.

Different colors are used to indicate when a particular status is regarded as abnormal:

• A desired status of UNAVAILABLE is shown in blue.
• A compound status of PROBLEM is shown in red, DENIED and INHIBITED are shown in pink, while a compound status of DEGRADED is shown in yellow.
• An observed status of HARDDOWN or PROBLEM is shown in red, while an observed status that is not in line with the desired status is shown in yellow.

Additionally you can use the following command codes:

• The slash character (/) to make the selected line the first line of the display.

The SORT, FIND, and RFIND subcommands are supported. See Varying the Format of the Command Output for information.