DISPSTAT displays current information
about one or more subsystems.
Syntax
Destination
Dest_list
Parameters
subsystem
Specifies the particular subsystem whose status or automation
flags you want to check. You can specify any automated subsystem.
Wildcards are supported. An asterisk (*) matches a string of arbitrary
length and a percentage (%) matches a single character.
*ALLKIDS
Lists all children and children of children of the selected subsystem.
Wildcards are not available for the subsystem here.
*KIDS
Lists the direct children of the selected subsystem. Wildcards
are not available for the subsystem here.
*ALLPARENTS
Lists all parents and parents of parents of the subsystem. Wildcards
are not available for the subsystem here.
*PARENTS
Lists the direct parents of the selected subsystem. Wildcards
are not available for the subsystem here.
ALL
Displays the current information for all automated subsystems.
STATUS
Specifies the resource statuses that you want to display. If you
specify a list of statuses, separate them with a comma and enclose
them in brackets (brackets are not needed for a single status). If
‘¬’, or ‘\’ is used, all statuses except the ones that you specify
are displayed.
The following are predefined lists:
STATUS=*
Lists all resource statuses.
STATUS=1
Lists all resources that are currently UP or ENDED.
STATUS=2
Lists all resources that are in a ‘normal’ status (DOWN, STARTED,
UP, AUTOTERM, AUTODOWN, ACTIVE, ENDED, ENDING, RESTART, EXTSTART,
RUNNING).
STATUS=3
Lists all resources that are in a ‘down’ status (DOWN, INACTIVE,
RESTART, AUTODOWN, CTLDOWN, STOPPED, BROKEN, MOVED, FALLBACK).
STATUS=4
Lists all resources that are in a start transition status (RESTART,
STARTED, STARTED2, ACTIVE, RUNNING, EXTSTART).
STATUS=5
Lists all resources that are in a stop transition status (AUTOTERM,
ENDING, STOPPING, ABENDING, BREAKING)
ALL2CONS
Specifies whether or not a complete list of columns is displayed.
The parameter only applies to line mode. The following are valid values:
YES
Displays the complete list of columns. This is the default.
NO
Displays only 60 characters of display data for each
resource. This command is beneficial when DISPSTAT is entered on the
system console.
For information on the OUTDSN parameter, see OUTDSN Parameter. Note, however, that for the DISPSTAT
command the minimum record length of the output data set is 256 bytes.
If no parameters are specified, the filter settings will be used, or, if not set,
DISPSTAT will show all resources from the local system.
If a subsystem name is specified, but no other
parameters, for example, TARGET=, are specified, all subsystems of
this name found on any system will be displayed.
Restrictions and Limitations
The DISPSTAT
command can only be used when SA z/OS® is initialized.
Examples
If you enter dispstat,
you see information about all automated resources, as shown in Figure 1. Figure 1. Display of Status of All Automated Resources
(DISPSTAT)
INGKYDS0 SA z/OS - Command Dialogs Line 1 of 68
Domain ID = IPUFJ -------- DISPSTAT --------- Date = 12/13/11
Operator ID = OPER1 System = AOC4 Time = 12:17:16
A dispflgs B setstate C ingreq-stop D thresholds E explain F info G tree
H trigger I service J all children K children L all parents M parents
CMD Resource Status System Jobname A I S R T RS Type Activity
--- ----------- -------- -------- -------- - - - - - -- -------- ---------
AM UP AOC4 AMA4 - - - - - - MVS --none--
AM2 UP AOC4 AMS4 - - - - - - MVS --none--
APPC UP AOC4 APPC - - - - - - MVS --none--
ASCH UP AOC4 ASCH - - - - - - MVS --none--
BLSJPRMI ENDED AOC4 BLSJPRMI - - - - - - TRANS --none--
DLF UP AOC4 DLF - - - - - - MVS --none--
FFST UP AOC4 FFST - - - - - - MVS --none--
IRRDPTAB ENDED AOC4 IRRDPTAB - - - - - - TRANS --none--
JES2 UP AOC4 JES2 - - - - - - MVS --none--
LLA UP AOC4 LLA - - - - - - MVS --none--
PAPLMTRA UP AOC4 PAPLMTRA - - - - - - MVS --none--
PAPLMTRB UP AOC4 PAPLMTRB - - - - - - MVS --none--
PBSYSPL1 UP AOC4 PBSYSPL1 - - - - - - MVS --none--
Command ===>
PF1=Help PF2=End PF3=Return PF4=INGLIST PF5=Filters PF6=Roll
PF8=Forward PF9=Refresh PF10=Previous PF11=Next PF12=Retrieve
The amount of data displayed
depends on the screen size used. Press PF10 and PF11 to scroll
horizontally.
PF4 lets you toggle to the INGLIST command dialog
showing the same resources from the automation manager view.
The CMD field allows you to invoke other SA z/OS command dialogs,
or control the amount of information displayed. To use one of the
command dialogs, type the appropriate letter next to the resource
name, and press Enter. When you return to this panel the data within
the command scope is refreshed. The current filters are not reapplied
until you select Refresh (PF9).
For example, to invoke the INGTHRES
dialog in order to change thresholds for JES2, move the cursor in
front of JES2 and type d.
You can specify X to
exclude subsystems.
Note: The U command code is supported if
the AOFEXC04 exit is installed.
The Resource field shows the name of the resource
in its corresponding status color, for example, green when the system
is UP.
The Status field shows the current status of
the resource as supplied by the automation agent.
The System is the name of the system that this
instance of the resource is from.
The Jobname is the job name of the resource.
The automation flags are as follows:
A
If this flag is set to N (No), no automation is on, regardless
of how the other flags are set. If this is set to Y (Yes), SA z/OS checks each
of the other flags to see if they are set to Y or N.
I
If this is on, automation issues the correct MVS start command for each subsystem when SA z/OS is initialized
and assures that subsystems are started in the order specified in
the automation control file.
S
If this is on, automation manages and completes the startup process
of subsystems.
R
If this is on, automation takes the specified action for any MVS message that is not associated
with the initialization, startup, shutdown, or restart of a subsystem.
For example, if this flag is on, automation takes actions to restart
the subsystem in case of an abend.
T
If this is on, automation manages the shutdown process for subsystems
by issuing shutdown commands and responding to prompts for additional
information.
RS
If this is on, automation monitors subsystems to ensure that they
are running and, if one fails, attempts to restart it according to
the policy in the automation control file.
Each flag has a value of:
N
Off
E
User exit
Y
On
L
Log
?
Error
Note: DISPSTAT shows settings that have been
set by the INGAUTO command. It does not show the effective
setting for the specific flag. Use the DISPFLGS command to view the
effective settings for the flags.
The Type field shows the type of job, either MVS, NONMVS, TRANS(ient), or ONE-SHOT.
The Activity field shows whether the resource is in a starting
or stopping process.
The Last Changed field shows the date and time
that the status of the subsystem last changed.
The Last Monitored field shows the time that
the system was last monitored. If monitoring has been disabled this
field is set to dashes.
The Description field shows a description of
the subsystem, from the automation control file.
Press PF5 to display the DISPSFLT panel.
For a description of the DISPSFLT command see DISPSFLT.
