DISPFLGS

Purpose

The DISPFLGS command shows all resources that have explicit agent automation flags defined for them, what those flags are, and what the effective automation flags resulting from them are.

Syntax

Read syntax diagramSkip visual syntax diagramDISPFLGSfilterTARGET=DestinationDest_list*ALLOUTMODE=LINEAUTONETLOG
Destination
Read syntax diagramSkip visual syntax diagramsystem_namedomain_IDsaplex_name
Dest_list
Read syntax diagramSkip visual syntax diagram( Destination )

Parameters

filter
Is the filter to be applied for the output. Only resource names that match the filter criteria are displayed. Wildcard is supported. The filter consists of the major name and, optionally, of a minor name separated by a dot, for example, CICS*.TRANS* , or *.*CEMT. Specify * to view major resources. To view minor resources, specify xyz.*.
TARGET
For information on the TARGET parameter, see TARGET Parameter.
OUTMODE
For information on the OUTMODE parameter, see OUTMODE Parameter.

Restrictions and Limitations

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

Usage

Subsystems that are not shown have no explicit automation flags set and have effective flags defined in the SUBSYSTEM entry.

Examples

If you enter dispflgs within SA z/OS, you see a panel similar to Figure 1.
Figure 1. DISPFLGS Command Dialog Panel
 AOFKAAAU                  SA z/OS  - Command Dialogs      Line  1    of 17     
 Domain ID   = IPSFM     ---------- DISPFLGS ----------    Date = 07/28/06      
 Operator ID = NETOP1                                      Time = 11:48:14      
                                                                                
 Cmd:  A Add flags    C Change flags    R Reset flags    S Scheduled Overrides  
                                           Actual      Effective                
 Cmd  System    Resource                A I S R T RS  A I S R T RS              
 ---  --------  ----------------------  - - - - - -   - - - - - -               
      KEY1      ASSISTD                 Y - - - - -   Y Y Y Y Y Y               
      KEY1      DEFAULTS                - - - - - -   Y Y Y Y Y Y               
      KEY1      MINORRES                - - - - E -   Y Y Y Y E Y 
      KEY1      AAA011I                 S - - - - -   S S S S S S
      KEY1      AAA011I                 - - - - E -   Y Y Y Y E Y               
      KEY1      MVSESA                  Y - - Y - -   Y Y Y Y Y Y               
      KEY1      CS                      - - - Y - -   Y Y Y Y Y Y               
      KEY1      CF                      - - - Y - -   Y Y Y Y Y Y               
      KEY1      ENQ                     - - - N - -   Y Y Y N Y Y               
      KEY1      HUNGCMD                 - - - N - -   Y Y Y N Y Y               
      KEY1      LONGENQ                 - - - N - -   Y Y Y N Y Y               
      KEY1      SYSIEFSD                - - - N - -   Y Y Y N Y Y               
      KEY1      HEALTHCHK               - - - Y - -   Y Y Y Y Y Y               
                                                                                
 Command ===>                                                                   
    PF1=Help     PF2=End        PF3=Return                      PF6=Roll        
                 PF8=Forward    PF9=Refresh                    PF12=Retrieve    
The following command codes are available:
A
Defines automation flags for a resource by using the same flag settings as the selected resource. On the next panel that is displayed, you can specify the resource name and optionally overtype the flag settings.
C
Modifies the automation flags of the selected resource. The next panel shows the current flag settings. You can overtype the flag values.
R
Resets the automation flags to the values specified in the automation control file (ACF).
S
Shows the scheduled override settings of the automation flags for the selected resource.
  • The Resource field shows the name of the resource. Names shown indented one character to the right represent minor resources, for example, MVSESA.DUMP as shown below. If the minor resources MVSESA.DUMP.ONE, MVSESA.DUMP.TWO, and MVSESA.DUMP.TWO.THREE existed, the Resource column would look like the following example:
    MVSESA
     DUMP
      ONE
      TWO
       THREE
    Major resources correspond to subsystems and minor resources correspond to specific situations or resources within a major resource. By default, automation flags for minor resources are derived from their major resources.

    The entries are sorted alphabetically.

  • The Actual flag settings are the flags that have been set for the resource.
  • The Effective flag settings are the flags that are in effect for the resource.

    The columns are headed with an abbreviation of the name of the automation flag.

    A
    Automation flag - overrides the others
    I
    Initstart flag - controls initial startup.
    S
    Start flag - controls commands that are issued during startup.
    R
    Recovery flag - controls recovery while UP.
    T
    Terminate flag - controls shutdown and shutdown commands.
    RS
    Restart flag - controls restart.
    The value of each flag is:
    -
    There is no explicit setting.
    N
    The flag is turned off.
    E
    A user exit is invoked whenever SA z/OS checks the flag.
    Y
    The flag is turned on.
    L
    The resulting commands or replies of an automated action are written to the netlog only but not issued when the event occurs.
    S
    The resource is suspended by the INGSUSPD command. No further action on any of the automation flags is allowed. Use the INGSUSPD command to reset the global automation flag to its original value.
    ?
    There is an error.

For more information about automation flags and minor resources, see IBM Z System Automation Customizing and Programming.