DISPEVTS

Purpose

DISPEVTS displays all events defined in a sysplex. From the fullscreen panel you can set or reset an event or display the related resources of an event.

Syntax

Read syntax diagramSkip visual syntax diagramDISPEVTSTARGET=system_namedomain_IDsaplex_nameOUTMODE=LINEAUTONETLOGWAIT= nnn

Parameters

TARGET
For information on the TARGET parameter, see TARGET Parameter. Note that if you specify a sysplex name as a target, this is translated to the next system that is available in the sysplex and the DISPEVTS command is processed there.
OUTMODE
For information on the OUTMODE parameter, see OUTMODE Parameter.
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.

Restrictions and Limitations

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

Examples

If you enter dispevts, a panel that shows all events defined in the sysplex is displayed, as shown in Figure 1.
Figure 1. DISPEVTS Command Dialog Panel
 AOFLE100                  SA z/OS  - Command Dialogs      Line  1    of 38     
 Domain ID   = IPUF9     ---------- DISPEVTS ----------    Date = 11/26/99      
 Operator ID = NETOP1          System  = AOC9              Time = 15:00:20      
                                                                                
 Cmd:  D show related resources     S set/reset event                           
                                                                                
 Cmd Event     Unset  Description                                               
 --- --------  -----  ----------------------------------------                  
     BATCHSTP  NONE   Batch jobs B000P100,P200,P300                             
     BATCHSTR  NONE   Batch jobs B000S100,S200,S300                             
     B000P100  DOWN   Stop cond 1 Trigger6 (batch job end)                      
     B000P200  DOWN   = P1                                                      
     B000P300  DOWN   Stop cond 2 Trigger6 (batch job 1 min)                    
     B000S100  UP     Start cond 1 Trigger6 batch job end                       
     B000S200  UP     = P1                                                      
     B000S300  UP     Start cond 2 Trigger 6 batch end (1 min)                  
     DRWEVT1   UP     unset UP                                                  
     DRWEVT13  NONE   unset none                                                
     DRWEVT14  NONE   unset none                                                
     DRWEVT15  NONE   unset none                                                
                                                                                
 Command ===>                                                                   
    PF1=Help     PF2=End        PF3=Return                      PF6=Roll        
                 PF8=Forward    PF9=Refresh                    PF12=Retrieve    
  • The Cmd field lets you specify the command codes shown on the panel. Type the appropriate letter next to the resource name and press Enter. The following command codes are available:
    D
    Shows the related resources.
    S
    Sets or resets the event.
  • The Event field shows the name of the event.
  • The Unset field shows the status that an application must have to reset an event. The following values can occur:
    START
    Unsets the event when the resource is being started.
    UP
    Unsets the event when the resource becomes available.
    DOWN
    Unsets the event when the resource becomes unavailable.
    If you do not specify anything the event will not be unset.
  • The Description field shows the description of the event.
Type S next to an event and press Enter. The panel shown in Figure 2 is displayed.
Figure 2. DISPEVTS Command Dialog Panel: Setting an Event
 AOFLE110                   SA z/OS  - Command Dialogs                          
 Domain ID   = IPSNO        -------- INGEVENT ---------    Date = 03/02/00      
 Operator ID = NETOP1          Sysplex = KEY1PLEX          Time = 12:35:26      
                                                                                
 Event . . . . . . . : EVTSTOP                                                  
 Description . . . . : Shutdown event                                           
 Unset condition . . : DOWN                                                     
                                                                                
 Specify/revise the following parameters and then press enter:                  
                                                                                
   Function   =>              SET or UNSET                                      
   Resource   =>                              Resource name                     
                                                                                
                                                                                
   Target     =>              System name, domain ID or sysplex name            
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
 F1=Help      F2=End       F3=Return                              F6=Roll       
                                                                 F12=Retrieve   
  • The Event field shows the name of the event.
  • The Description field shows the description of the event.
  • The Unset condition field shows the status that an application must have to reset an event.
  • The Function field shows the action to be performed. It can be overwritten.
  • The Resource field shows the name of the application that is the only affected application when the command is executed. It can be overwritten.
  • The Target field shows the name of the target system where the processing takes place. It can be overwritten. You only need to specify the name of the target system if you want to address a remote sysplex.