DISPSFLT

Purpose

The DISPSFLT command lets you set up view filters for DISPSTAT.

Syntax

Parameters

REQ

Specifies the type of the request. It can be one of the following:

SET: Specifies setting new filter settings.
GET: Specifies returning the current filter settings. This is the default.

RESOURCE

Specifies the name of the resource, or resources, to be displayed. The format is resource name. It can be a list of names. Wildcards are supported. If you specify only one resource you need not put it in parentheses.

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)

TARGET

Specifies the target systems that data will be retrieved from.

system_name: Specifies the name of the z/OS system.
domain_id: Specifies the NetView domain identifier.
saplex_name: Specifies the name of the sysplex.
*: Specifies that the command should be routed to all SA z/OS systems that are currently active in the local sysplex.

OUTMODE

For information on the OUTMODE parameter, see OUTMODE Parameter.

If no parameters are specified, the filter settings are used.

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.

Usage

The DISPSFLT command can also be used when SA z/OS® is not initialized.

The DISPSFLT command lets you set filter options at operator logon from within the operator's initial REXX script.

Examples

If the operator is responsible for all resources starting with xyz, DISPSFLT will be called with the parameter RESOURCE=xyz. If you enter dispsflt a panel similar to Figure 1 is displayed.

Figure 1. DISPSFLT Command Dialog Panel

 AOFKSTA3                 SA z/OS  - Command Dialogs                            
 Domain ID   = IPSNO     -------- DISPSFLT ----------     Date = 06/27/00       
 Operator ID = NETOP1                                     Time = 15:08:40       
                                                                                
   Resources      ( *, *esour*, resource or jobname )                           
      *                                                                         
                                                                                
   Statuses        ( *, status or choice, leading ¬ or \ negates)               
      RESTART STARTED STARTED2 ACTIVE RUNNING EXTSTART                          
                                                                                
     Precoded:  1 All resources that are currently UP or ENDED                  
                2 All resources that are in a normal status                     
                3 All resources that are in a down status                       
                4 All resources that are in a start transition state            
                5 All resources that are in a stop transition state             
                                                                                
   Targets  ( system name , domain ID , sysplex name or * )              
      KEY3                                                                      
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
  PF1=Help    PF2=End    PF3=Return    PF4=Clear    PF5=Reset      PF6=Roll     
                                       PF9=Save                    PF12=Retrieve

Filters are used to tailor the DISPSTAT display. To be displayed, a subsystem must pass all the filter criteria. If a filter is not explicitly set, it defaults to '*', which means that all subsystems pass it. Some filters allow you to specify a wildcard character, in the form of a trailing '*'.

The Resources field contains the name of the resources or their jobs.
The Statuses field shows the subsystem's current status. If ‘¬’, or ‘\’ is specified, all statuses not specified are used.
The Targets field shows the name of the target system.
If you press PF4 the filter settings are cleared.

Subsystems are evaluated to see if they meet the current filter criteria when:

DISPSTAT is invoked with filter parameters.
The filters are changed through the DISPSTAT Filters panel.
The Refresh key (PF9) is selected from the DISPSTAT panel.

Note: If you make changes on this panel, and then decide that you do not want these changes to take effect, you can select the Reset key (PF5), which reinstates the field values that were present when you entered the panel. If you press PF9 the filter settings are saved until the session is terminated.