Online Facilities

This chapter contains the following topics:

• Overview

• IOA Features

  • General IOA Features

  • IOA Entry Panel

  • IOA Primary Option Menu

  • Multi-Screen Control

  • Fast Exit From the IOA Online Facility

  • Screen Layout

  • Commands and PFKeys

  • Online Help

  • AutoRefresh Mode

  • IOA Under ISPF

  • IOA Editor

  • IOA SET Command Panel

• Rule Definition Facility

  • Accessing the Rule Definition Facility

  • Creating Tables

  • Creating Rule Definitions

  • Performing Operations on Tables and Rules

  • Entry Panel

  • Table List Screen

  • Rule List Screen

  • Copying Rules to Another Table

  • Rule Definition Screen

  • Commands of the Rule Definition Screen

  • Specifying Comments

  • Commenting Out Rule Statements

  • Editing Rule Definitions in the Edit Environment

  • Exiting the Rule List Screen

  • Ordering Rule Tables

  • Copying Rules to Another Table

• Message Statistics Screen

  • Fields of the Message Statistics Screen

  • Commands of the Message Statistics Screen

  • Show Option Window

  • Options of the Message Statistics Screen

• Rule Status Screen

  • Changing Display Types

  • Display Type D (Default)

  • Display Type A (All Fields)

  • Commands of the Rule Status Screen

  • Show Option Window

  • Options of the Rule Status Screen

  • Why Screen

• Automation Log Screen

  • Changing Display Types

  • Display Type D (Default)

  • Display Type V (Zebra)

  • Display Type O (Operator Display)

  • Display Type A (All Fields)

  • Display Type B (Debug)

  • Commands of the Automation Log Screen

  • Filtering the Automation Log Screen Display

  • Swap Option Window

  • Search Limit Window

  • MVS Operlog Display

• Automation Options Facility

  • The COMMAND Option

  • The CONSOLE Option

  • The ENQINFO Option — Enqueue Information

  • The GLOBALS Option

  • The OPERATOR Option

  • The SAMPLES Option

  • The SERVERS Option

  • The SUBSYS Option

• KOA Recording

• IOA Variables Database Facility

• Condition and Resource Handling Facility

• IOA Log Facility

• IOA Calendar Facility

• Utilities Under ISPF

Overview

The Online facility is the basic means of communication between the user and Control-O.

Online rule definition gives you the ability to define and modify rule definitions in the Control-O environment.

The Message Statistics screen displays statistics for messages and commands intercepted by Control-O.

The Rule Status screen selectively displays the statuses of rules that have been loaded into memory by Control-O. The Rule Status screen can also be used to hold, delete or free rules.

Automation Options that display, modify, or act upon IOA components or system components can be selected. Customized Automation Options can be designed and added to the Automation Options provided by Control-O.

The Automation Log screen displays the stream of messages and commands captured by Control-O together with additional information relevant to the automation process.

The IOA Variable Database Definition facility enables definition and modification of databases containing Global AutoEdit variables. Variable databases are used extensively by Control-O/COSMOS. For more information, see the Control-O/COSMOS User Guide.

The Control-O/COSMOS Status screen displays resources controlled by Control-O/COSMOS. For more information, see the Control-O/COSMOS User Guide.

The KOA Recorder facility captures manually entered keystrokes and generates a KOA script.

The following pages describe the main features of the Online facility.

IOA Features

This section discusses the IOA features common to all INCONTROL products.

General IOA Features

General IOA features include:

• Customization

• Environment Support

• Terminal Support

• Special Character Usage on Terminals

• Color Support

• Prefixing

• Character Masking

Customization

IOA screens, constants, messages, colors, commands and PFKey definitions can be site-modified to adapt them to local needs. For further details see the INCONTROL for z/OS Installation Guide.

INCONTROL products can be customized globally, that is, for the whole site, using the INCONTROL Installation and Customization Engine (ICE), according to profile variables defined during installation.

In addition, INCONTROL products can be customized to respond differently to individual users if these profile variables are specified in User profile members.

For example, depending on the setting of a variable in a particular User profile member, upon exit from a screen in which changes have been requested, this INCONTROL product may either perform the requested changes automatically, or display a confirmation window before performing the changes.

Customization issues are discussed in the IOA administration chapter of the INCONTROL for z/OS Administrator Guide.

Environment Support

The Online facility can be activated under the following environments:

• TSO (native)

• TSO/ISPF

• ROSCOE/ETSO

• CICS

• VTAM

• IMS/DC

• IDMS/DC

• COM-PLETE

Cross memory interfaces to the Online monitor are optional under native TSO, TSO/ISPF and ROSCOE/ETSO. They are always used under the other environments.

There are slight differences in the operation of the online facility under the different environments. Special notes are provided in this guide where applicable.

Terminal Support

IOA supports the following models of IBM 3270 terminals:

• Model 2 — 24 lines, 80 columns

• Model 4 — 43 lines, 80 columns

• Model 3 — 32 lines, 80 columns

• Model 5 — 27 lines, 132 columns

IOA adjusts to the screen size to use the maximum available data area on the screen.

Special Character Usage on Terminals

In certain cases, special keyboard characters, such as $, #, and @, are assigned special meanings. The characters specified appear on standard American terminals but may not be available on other keyboards. In addition, some special characters on your keyboard may be assigned different hexadecimal values than the ones recognized by IOA. Special keyboard mapping requirements, and a complete discussion of the conventions used in this guide, are shown in Conventions Used in This Guide.

Color Support

Table 11 Special Characters and Hexadecimal Assignments

When INCONTROL products are activated from a screen with extended 7-color support, IOA makes extensive use of the color attributes of the screen.

Like all screen attributes, the color attribute for each field is defined externally to the program and can be locally modified by the site.

At this time, IOA does not support extended color attributes under COM-PLETE.

Due to ISPF characteristics, color changes cannot occur in adjacent columns but must be separated by an attribute byte without color, that is, black. Therefore, some IOA screens have a different appearance under ISPF than under other online environments, such as native TSO and CICS.

Prefixing

For fields that automatically support prefixing, selection strings are always treated as prefixes. Selection is made if a segment of the text beginning with the first letter (that is, any prefix) matches the selection criteria.

Character Masking

For fields that support masking, mask characters function as follows:

• * represents any number of characters (including no characters).

• ? represents any one character.

For fields that do not automatically support prefixing, a prefix value can be specified by ending the selection string with an asterisk.

IOA Entry Panel

Enter the IOA online facility according to the instructions of your INCONTROL administrator. Upon entering the IOA online facility, the IOA Entry Panel may be displayed.

Figure 1 IOA Entry Panel

    ---------------------------  IOA ENTRY PANEL  -----------------------------   
   
   
   
   
            +-----------------------------------------------------------+
            |                                                           |
            |          USER ID      ===>                                |
            |                                                           |
            |          PASSWORD     ===>                                |
            |                                                           |
            |          NEW PASSWORD ===>           ===>                 |
            |                                                           |
            +-----------------------------------------------------------+
   
   
                                                      
                                            
   
   
   
   
        PLEASE FILL IN USER ID AND PASSWORD AND PRESS ENTER            18.30.18

Type your user ID and password and press Enter. If you enter a correct user ID and password, the IOA Primary Option menu is displayed.

The IOA online facility allows three attempts to enter a valid user ID and password combination. After the third unsuccessful attempt, the program is terminated.

To change a password, type the new password twice, once in the NEW PASSWORD field, and once in the confirmation field to the right of the NEW PASSWORD field.

IOA Primary Option Menu

The IOA Primary Option menu is the primary interface to functions available under the various INCONTROL products. The options displayed in the menu depend on the INCONTROL products installed at the site, and the functions and facilities that have been authorized to you.

If only Control-O is installed at your site, and you are authorized to access all functions and facilities, the screen shown in Figure 2 is displayed:

Figure 2 IOA Primary Option Menu when only Control-O is Installed

 --------------------       IOA PRIMARY OPTION MENU       ------------------(1)
 OPTION ===>                                               USER        N22A    
                                                           DATE        19.08.01
                                                                               
                                                                               
                                                                               
   4   COND-RES          IOA Conditions/Resources Display                      
   5   LOG               IOA Log Display                                       
   6   TSO               Enter TSO Command                                     
   7   MANUAL COND       IOA Manual Conditions Display                         
   8   CALENDAR DEF      IOA Calendar Definition                               
  IV   VARIABLE DATABASE IOA Variable Database Definition Facility             
   C   CMEM DEFINITION   CTM Event Manager Rule Definition                     
  OR   RULE DEFINITION   CTO Rule Definition                                   
  OM   MSG STATISTICS    CTO Message Statistics Display                        
  OS   RULE STATUS       CTO Rule Status Display                               
  OL   AUTOMATION LOG    CTO Automation Log Display                            
  OA   AUTOMATION OPTS   CTO Automation Options Menu                           
  OC   COSMOS STATUS     CTO COSMOS Status Screens                             
  OK   KOA RECORDER      CTO Record VTAM Scripts                               
                                                                               
                                                                               
                                                                               
 COMMANDS:  X - EXIT, HELP, INFO  OR CHOOSE A MENU OPTION              18.11.23

To select an option, type the option number or letter in the OPTION field and press Enter. Alternatively, for a number option, press the PFKey with the same number. For example, to select the LOG option, press PF05/PF17.

Option OK (KOA Recorder facility) is available only under IOATSO, and not under IOAISPF or IOAMON.

Certain IOA functions and facilities (options) are shared by all INCONTROL products. These shared IOA commands, functions and facilities are described later in this chapter, and outlined in Table 14.

Table 14 INCONTROL Shared IOA Functions and Facilities

The functions and facilities (options) shown in Table 15 are applicable to Control-O.

Table 15 Control-O Functions and Facilities

The IOA Primary Option menu shown in Figure 3 is displayed at sites supporting all currently available INCONTROL mainframe products.

When the IOA online facility is activated as an ISPF application, Option 6 is displayed as "6  UTILITIES Online Utilities." In this case, Option 6 activates the Online utilities under ISPF. When the online facility is not activated under TSO or TSO/ISPF, Option 6 is inactive.

Figure 3 IOA Primary Option Menu when all INCONTROL Products are Installed

---------------------       IOA PRIMARY OPTION MENU       ------------------(1)
OPTION ===>                                               USER        N06  
                                                                              
IOA                        CONTROL-D/V                CONTROL-O            
                                                                              
  4  COND-RES                A  MISSION STATUS         OR  RULE DEFINITION 
  5  LOG                     M  MISSION DEF            OM  MSG STATISTICS  
  6  TSO                     R  REPORT DEF             OS  RULE STATUS     
  7  MANUAL COND             T  RECIPIENT TREE         OL  AUTOMATION LOG  
  8  CALENDAR DEF            U  USER REPORTS           OA  AUTOMATION OPTS 
 IV  VARIABLE DATABASE       F  PC PACKET STATUS       OC  COSMOS STATUS   
                            DO  OBJECTS                OK  KOA RECORDER    
                                                                              
                                                                              
CONTROL-M & CTM/Restart    CONTROL-M/Analyzer         CONTROL-M/Tape       
                                                                              
  2  JOB SCHEDULE DEF       BB  BALANCING STATUS       TR  RULE DEFINITION 
  3  ACTIVE ENV.            BM  MISSION DEF            TP  POOL DEFINITION 
  C  CMEM DEFINITION        BV  DB VARIABLE DEF        TV  VAULT DEFINITION
  W  WORKLOAD MANAGEMENT    BR  RULE DEFINITION        TI  INQ/UPD MEDIA DB
                            BA  RULE ACTIVITY          TC  CHECK IN EXT VOL
                                                                              
                                                                              
COMMANDS:  X - EXIT, HELP, INFO  OR CHOOSE A MENU OPTION               16.20.21

For a description of the options for other INCONTROL products, see the user guides of the respective products.

Additional options available on the IOA Primary Option Menu when operating Control-O with other INCONTROL products, are listed in Table 16.

Table 16 IOA Primary Option Menu Options

IOA Version Information

Enter INFO (or I) in the OPTION field of the IOA Primary Option menu to display the IOA Version Information window, as illustrated in Figure 4. This window lists the version and level of each INCONTROL product installed at the site, plus the CPU ID and current system date. The IOA Version Information window also identifies the unique IOA QNAME assigned to the site. For further information about the IOA QNAME, see the IOA operational parameters step, the IOAPLEX parameters step, and the adding IOA structures to the CFRM step, all in the INCONTROL for z/OS Installation Guide. Press Enter or END (PF03/PF15) to exit the window and return to the IOA Primary Option menu.

Figure 4 IOA Version Information

---------------------       IOA PRIMARY OPTION MENU       ------------------(1)
OPTION ===>                                               USER        N06     
                                                                              
IOA                        CONTROL-D/V                CONTROL-O               
                +----------------------------------------------+              
  4  COND-RES   |           IOA VERSION INFORMATION            | EFINITION    
  5  LOG        |                                              | ATISTICS     
  6  TSO        |   IOA                  Version 6.1.00        | TATUS        
  7  MANUAL CON |   IOAGATE              Version 6.1.00        | TION LOG     
  8  CALENDAR D |   CONTROL-M            Version 6.1.00        | TION OPTS    
 IV  VARIABLE D |   CONTROL-M/RESTART    Version 6.1.00        |  STATUS      
                |   CONTROL-M/ANALYZER   Version 6.1.00        | CORDER       
                |   CONTROL-M/TAPE       Version 6.1.00        |              
                |   CONTROL-D            Version 6.1.00        |              
CONTROL-M & CTM |   CONTROL-V            Version 6.1.00        | ape          
                |   CONTROL-O            Version 6.1.00        |              
  2  JOB SCHEDU |                                              | EFINITION    
  3  ACTIVE ENV |                                              | EFINITION    
  C  CMEM DEFIN |   DATE  19.08.01  CPUID  02078D 7060         | DEFINITION   
                |   IOA QNAME  IOAR610                         | D MEDIA DB   
                |                                              | IN EXT VOL   
                +----------------------------------------------+              
                                                                              
COMMANDS:  X - EXIT, HELP, INFO  OR CHOOSE A MENU OPTION               17.00.29

Multi-Screen Control

It is not necessary to return to the IOA Primary Option menu to move from one online facility to another.

To speed up transfer of control between screens of different facilities and to enable you to manage several online facilities at the same time, transfer control commands can be specified. Transfer commands take you directly from your current screen to the requested screen. Transfer commands can be used to reach any screen that can be accessed through the IOA Primary Option menu at your site.

Each transfer control command consists of an equals sign immediately followed by one of the options of the IOA Primary Option menu, which represents the target screen of the transfer. For example, from any screen, enter:

Table 17 IOA Transfer Control Commands

If you use a transfer command to reach another screen, the state of the current screen remains unchanged when you return to it using another transfer command.

The INCONTROL administrator can globally deactivate any or all of the transfer commands.

Fast Exit From the IOA Online Facility

To exit immediately from the IOA Online facility, type =X on the command line and press Enter.

In most cases, the =X command has the same effect as pressing END (PF03/PF15) in all open screens and then entering X (Exit) in the IOA Primary Option menu. Any window, such as the Exit Option window, that would be displayed when exiting an open screen is displayed when the =X command is entered.

However, when the =X command is entered while definition screens such as the Calendar Definition screen are open, changes to the open definition screens are cancelled. Changes currently in definition facility list screens, for example, changes to previously closed definition screens, are not cancelled. Those screens and all other open screens are treated as if END (PF03/PF15) has been entered.

Screen Layout

Most IOA screens are divided into four basic areas, as described in Table 18. The example shown in Figure 5 is the IOA Log screen.

Table 18 Basic IOA Screen Areas

Figure 5 IOA Log Screen

FILTER:            ---------------- IOA LOG  -------------------------------(5)
COMMAND ===>                                                    SCROLL===> CRSR
SHOW LIMIT ON ==>                                          DATE 291201 - 010102
DATE   TIME   ODATE  USERID   CODE    ------ M E S S A G E --------------------
311201 184915 311201 K48      SUB13AI JOB K48RUN1 / OID=005W9 SUBMITTER STARTED
                                       PROCESSING JOB ON SYSTEM: OS35         
311201 184915 311201 K48      SUB133I JOB K48RUN1 K48RUN /27255 OID=005W9     
                                      SUBMITTED FROM LIBRARY (P) K48.LIB.JOB  
311201 184918 311201 K48      SPY28GI JOB K48RUN1 K48RUN /27255 OID=005W9 TAPE
                                      DRIVE UNITS USED=00 00                  
311201 184918 311201 K48      SPY281I JOB K48RUN1 K48RUN /27255 OID=005W9 START
                                       01365.1849 STOP 01365.1849 CPU 0MIN    
                                      00.05SEC SRB 0MIN 00.00SEC 0.00 4AOS35  
311201 184918 311201 K48      SPY254I JOB K48RUN1 K48RUN /27255 OID=005W9     
                                      SCANNED                                 
311201 184918 311201 K48      SEL216W JOB K48RUN1 K48RUN /27255 OID=005W9     
                                      UNEXPLAINED COND CODE 0015 STEP EXEC /  
311201 184918 311201 K48      SEL214I JOB K48RUN1 K48RUN /27255 OID=005W9 RERUN
                                       NEEDED                                 
311201 184918 311201 K48      SEL205I JOB K48RUN1 K48RUN /27255 OID=005W9 RERUN
                                       IN PROCESS USING MEM K48RUN1           
311201 184918 311201 K48      SEL286I JOB K48RUN1 K48RUN /27255 OID=005W9     
                                      WAITING FOR CONFIRMATION                
CMDS: SHOW, GROUP, CATEGORY, SHPF                                      08.57.11

Commands and PFKeys

Commands are entered by typing a command in the COMMAND field and then pressing Enter, or by pressing a predefined PFKey, or a combination of both.

It is not necessary to enter the full command name; the shortest unique abbreviation of the command is sufficient. If the abbreviation is ambiguous, an appropriate message is displayed in the message area.

IOA commands are flexible; you can change command syntax or provide aliases (synonyms) to suit your site. If you want to add or change a command syntax, consult BMC Customer Support. The examples provided in this chapter exhibit the original command syntax supplied with this INCONTROL product.

PFKey command assignments can be site-customized. It is possible to assign PFKeys differently for each screen. To change PFKey command assignments, see your INCONTROL administrator.

Supplied PFKey definitions are consistent throughout most of the screens. For example, PF08/PF20 is used to scroll down (forward) on all INCONTROL screens where scrolling is possible.

Table 19 Common PFKey Definitions

To see the PFKey assignment of the screen with which you are working, type the SHPF reserved command in the command line and press Enter. The window show in Figure 6, describing the current PFKey assignment, is displayed. Press Enter again to close the window.

Figure 6 PFKey Assignment Window

FILTER:            ---------------- IOA LOG  -------------------------------(5)
COMMAND ===>                                                    SCROLL===> CRSR
SHOW LIMIT ON ==>                                          DATE 291201 - 010102
DATE   TIME   ODATE  USERID   CODE    ------ M E S S A G E --------------------
311201 184915 311201 K48      SUB13AI JOB K48RUN1 / OID=005W9 SUBMITTER STARTED
                                       PROCESSING JOB ON SYSTEM: OS35         
311201 184915 311201 K48      SUB133I JOB K48RUN1 K48RUN /27255 OID=005W9     
                                      SUBMITTED FROM LIBRARY (P) K48.LIB.JOB  
311201 184918 311201 K48      SPY28GI JOB K48RUN1 K48RUN /27255 OID=005W9 TAPE
                                      DRIVE UNITS USED=00 00                  
311201 184918 311201 K48      SPY281I JOB K48RUN1 K48RUN /27255 OID=005W9 START
+----------------------------------------------------------------------------+
|                                                                            |
|     ENTER ENTER                     PF13  HELP                             |
|     PF01  HELP                      PF14  SHOW                             |
|     PF02  SHOW                      PF15  END                              |
|     PF03  END                       PF16  RESET                            |
|     PF04  RESET                     PF17  FIND                             |
|     PF05  FIND                      PF18  =6                               |
|     PF06  =6                        PF19  UP                               |
|     PF07  UP                        PF20  DOWN                             |
|     PF08  DOWN                      PF24  SHPF                             |
|     PF12  RETRIEVE                                                         |
+----------------------------------------------------------------------------+

If you type text in the COMMAND field and press a PFKey, the text in the COMMAND field is treated as a subparameter of the command assigned to the PFKey.

Additional key definitions are shown in Table 20.

Table 20 Additional Key Assignments

For information on changing IOA PFKey definitions, see the appendix in the INCONTROL for z/OS Administrator Guide that deals with modifying IOA Online Facility Commands.

Scrolling Commands

Scrolling conventions are very similar to the ISPF conventions of IBM. The basic commands used for scrolling are shown in Table 21.

Table 21 Scrolling Commands

These commands can be entered by typing the command in the COMMAND field or by pressing the predefined PFKey.

The scrolling amount is determined by the content of the SCROLL field in the right corner of the screen header. Valid scrolling amounts are shown in Table 22.

Table 22 Scrolling Amounts in the SCROLL Field

It is only necessary to type the first letter of the new amount in the SCROLL field in order to change the scrolling amount.

A scrolling amount other than that shown in the SCROLL field can be used by entering the amount directly after the scroll command itself, or by entering the scroll amount in the COMMAND field and pressing the appropriate scrolling PFKey. The scrolling amount in the SCROLL field remains unchanged.

Example

If PAGE is the value in the SCROLL field, to scroll to the bottom, type M (MAX) in the COMMAND field and press PF08 (DOWN).

LOCATE Command

The LOCATE command, and its abbreviation, L, can be used to search for items in the NAME field in all "directory type" screens that contain scrollable data, such as the Calendar List screen. The syntax of the command is

LOCATE string

In this command, string is the search string. Apostrophes (‘single quotes’) or quotation marks ("double quotes") are not required.

The search proceeds from the top of the list to the first item in the list that starts with the specified string. The cursor is positioned on the OPTION field at the beginning of the line containing the string, if found, or on the OPTION field of the alphabetically closest preceding value if the specified value is not found.

FIND Command

The FIND command, and its abbreviation, F, can be used in all screens that contain scrollable data to find and display the next occurrence of a character string. The syntax of the command is

FIND string [fromcol] [tocol] [PREV]

In this command

• string is the search string. Mandatory.

• fromcol is the first column in the search range. Optional.

• tocol is the last column in the search range. Optional.

• PREV is the indicator that the search must move backward, instead of forward, from the current cursor position. Optional.

General Rules

If the string contains blanks, enclose the string with apostrophes (‘single quotes’) or quotation marks ("double quotes"). For example:

FIND 'WAIT SCHEDULE'

The column range searched can be limited by entering fromcol or tocol values, or by entering both fromcol and tocol values.

The search for the string proceeds from the current cursor position forward, or backward if PREV is entered. If the string is found, the cursor is positioned at the start of the string.

To repeat the FIND to the next or previous occurrence of the string, press PF05/PF17.

Text String Searches

The FIND command can also be used to search for text strings, in which case the command will find all instances of the string, regardless of whether the characters within the string are lowercase, uppercase, or mixed case. To search for a text string, include the letter T immediately before a quoted string.

FIND T'WAIT SCHEDULE'

Text string searches are the default. If your system default is for text strings, You do not need to include the T if you perform a text string search. Your INCONTROL administrator can change the default to character string. In this case you do not need to include the C if you perform a character string search.

Character String Searches

The FIND command can be used to search for character strings, in which case the command will find all instances of the string, but only where the string contains characters that match the case specified. To search for a character string, include the letter C immediately before a quoted string.

FIND C'WAIT SCHEDULE'

CANCEL and RESET Commands

CANCEL and RESET commands are entered in the COMMAND field.

The CANCEL command cancels changes made in a definition screen, such as the IOA Calendar Definition screen, and exits the screen.

The RESET command (PF04/PF16) cancels Edit environment options specified in a definition screen. It does not cancel changes already made and it does not exit the screen or cancel Edit environment mode. For more information about the Edit environment, see Editing Rule Definitions in the IOA Edit Environment.

The RESET command (PF04/PF16) can also be used in most windows, for example, the Show Screen Filter window, to cancel changes and close the window.

Online Help

The following types of online help are available for INCONTROL screens:

Screen help

Provides information about the entire screen. This help is available on all INCONTROL screens and is accessed by pressing the HELP key (PF01/PF13) while the cursor is positioned on the COMMAND field in the screen.

Line-sensitive Help

Provides information about the fields on a particular line on a screen. This help is available on several INCONTROL screens. It is accessed by pressing the HELP key (PF01/PF13) while the cursor is positioned on the desired line of the screen.

If line-sensitive help is not supported in a screen, pressing the HELP key (PF01/PF13) from anywhere in the screen displays the beginning of the Help panel.

Figure 7 IOA Help Screen

------------------------------ IOA HELP SCREEN --------------------- (CTMHDT2 )
COMMAND ===>                                                    SCROLL===> CRSR
                                                                             
  Calendar List Screen                                                       
  ====================                                                       
                                                                             
  The Calendar List screen displays a list of calendars (members) in the     
  specified library. This screen can be entered directly from the entry      
  panel or upon exiting the Year List screen.                                
                                                                             
  By default, only calendar names are listed in the screen. However, if      
  the default has been modified at time of installation, statistical         
  information is displayed for each calendar name.                           
                                                                             
  Use the scrolling PFKeys to scroll forward (PF08/PF20) and backward        
  (PF07/PF19) on the Calendar List.                                          
                                                                             
  To return to the entry panel, press END (PF03/PF15).                       
                                                                             
                                                                             
  Options of the Calendar List Screen                                        
  -----------------------------------                                        
  To request one of the following options, specify the option in the OPT 
ENTER END OR PF03/PF15 TO EXIT THE HELP SCREEN                         08.55.40
Help can be scrolled using standard scrolling conventions.
To return to the original screen, use the END command (PF03/PF15).

The Help member name appears on the right in the Help screen header. Members containing the Help descriptions can be found in the IOA MSG library.

AutoRefresh Mode

Certain INCONTROL screens, as noted in this chapter where appropriate, support AutoRefresh mode. A screen display in AutoRefresh mode is automatically updated periodically with the most current data.

AutoRefresh mode can only be activated under native TSO or under ISPF. AutoRefresh mode is activated by the AUTO command. The format of the command is

AUTO n

In this command, n is any number of seconds from 1 through 99.

The screen is updated when the AUTO command is issued, and then periodically updated according to the interval (in seconds) specified in the AUTO command. A counter at the top of the screen displays the number of times the screen has been refreshed.

Cancelling AutoRefresh Mode

Under native TSO, the recommended method of cancelling AutoRefresh mode is as follows:

• For short interval values – Press Enter. Whenever Enter is pressed, or a command is issued, AutoRefresh mode is automatically cancelled at the end of the current interval.

• For long interval values – Press Attn (PA1) once.

Under ISPF, press Attn (PA1) or Esc once to cancel AutoRefresh mode.

IOA Under ISPF

The IOA Online facility can be activated as an ISPF application. As such, it can work in ISPF split screen mode like any other ISPF application.

WARNING: Multiple calls to the IOA ISPF interface can be performed in ISPF split screen mode as long as all invocations are for the same IOA environment. Otherwise, the results may be unpredictable.

The command line of the IOA Online facility is controlled by IOA. It is not possible to enter ISPF commands in an IOA screen. The ISPF commands shown in Table 23 must be defined to PFKeys.

Table 23 ISPF Commands that must be defined for PFKeys

The rest of the PFKeys are controlled by IOA PFKey definitions, which are in the IOA PARM library.

It is possible to assign TSO/ISPF commands such as PRINT to PFKeys, or to change PFKey definitions by performing the following steps:

1. Exit from IOA and ISPF to the READY prompt.

2. Type the following command and press Enter:

   Copy

   ISPSTART PANEL(ISR@PRIM) NEWAPPL(CTM)

   This command brings you to ISPF.

3. Type the KEYS command and press Enter. A set of key definitions is displayed.

4. Modify the key definitions as desired and exit from ISPF.

   ISPF KEY definitions for the following ISPF commands take precedence over IOA PFKey definitions: SPLIT, SWAP, KEYS, PRINT, PFSHOW. For example, if PF02 is defined as SPLIT in ISPF, an IOA definition for PF02 is ignored in online screens.

   For all other ISPF commands, such as UP or DOWN, the key definitions in ISPF are ignored and the PFKey is interpreted according to the definition in the IOA Online facility.

   Under ISPF, IOA Option6 activates the Online Utilities panel. For more information about these utilities, see the INCONTROL for z/OS Utilities Guide.

   For more information on changing IOA PFKey definitions, see the appendix in the INCONTROL for z/OS Administrator Guide that deals with modifying IOA Online Facility Commands.

IOA Editor

The IOA Editor enables you to edit members of a partitioned data set (PDS) using an editor similar to the ISPF editor. Enter EDMEM in the command line of any screen to display the Edit Entry Panel window, as shown in Figure 8.

Figure 8 IOA Editor Edit Entry Panel

---------------------       IOA PRIMARY OPTION MENU       ------------------(1)
OPTION ===>                                               USER        N06     
                                                                              
IOA                        CONTROL-D/V                CONTROL-O               
                                                                              
  4  COND/RES                A  MISSION STATUS         OR  RULE DEFINITION    
  5  +--------------------------------------------------------------+ICS      
  6  |                     EDIT ENTRY PANEL                         |         
  7  |                                                              |LOG      
  8  | LIBRARY ==>                                                  |OPTS     
 IV  |                                                              |US       
     | MEMBER  ==>                                                  |R        
     |                                                              |         
     | FILL IN PARAMETERS AND PRESS ENTER TO CONTINUE OR PF3 TO EXIT|         
CONTR|                                                              |         
     +--------------------------------------------------------------+         
  2  JOB SCHEDULE DEF       BB  BALANCING STATUS       TR  RULE DEFINITION    
  3  ACTIVE ENV.            BM  MISSION DEF            TP  POOL DEFINITION    
  C  CMEM DEFINITION        BV  DB VARIABLE DEF        TV  VAULT DEFINITION   
                            BR  RULE DEFINITION        TI  INQ/UPD MEDIA DB   
                            BA  RULE ACTIVITY          TC  CHECK IN EXT VOL   
                                                                              
                                                                              
COMMANDS:  X - EXIT, HELP, INFO  OR CHOOSE A MENU OPTION               19.12.05

To create a new member or edit an existing member, fill in the LIBRARY and MEMBER parameters and press Enter. The IOA Editor screen is opened for editing, as shown in Figure 9.

Figure 9 IOA Editor

----------------------------  I O A   E D I T O R   ------------------- (EDMEM)
COMMAND ===>                                                    SCROLL===> CRSR
ROW     PROD.V610.DEMO(TEST)                                        COL 001 072
                                                                              
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
......                                                                        
************************ B O T T O M  O F  D A T A ************************** 
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
OPTIONS:  I INSERT  D DELETE  R REPEAT  C COPY  M MOVE  UC/LC UPPER/LOWER CASE

IOA Editor PFKey Functions

While working within the IOA Editor, PFKeys perform the functions shown in Table 24.

Table 24 PFKey Functions Within the IOA Editor Screen

Commands of the IOA Editor Screen

Table 25 describes editing commands that can be executed by entering the command in the COMMAND line.

Table 25 IOA Editor Command Line Commands

Table 26 describes editing commands that can be executed by entering the command in the leftmost position of the applicable row.

Table 26 IOA Editor Row Commands

IOA SET Command Panel

The IOA SET Command Panel enables you to set and stop TRACE levels, choose the language that is used in online screens and to set a dollar sign representation that will be used in online screens for system variables of type %%$VAR. Enter SET in the command line of any screen to display the SET Command Panel window, as shown in Figure 10.

Figure 10 IOA SET Command Panel

+-----------------------------------------------------------------------------------+
|                        SET Command Panel                                          |
|                                                                                   |
|                                                                                   |
|  TRACE level     , ON  (Trace level 001-512, ON or OFF)                           |
|                                                                                   |
|                                                                                   |
|    LANGUAGE              ENG - English                                            |
|                          FRA - French                                             |
|                          GER - German                                             |
|                          JPN - Japanese                                           |
|                                                                                   |
|                                                                                   |
|    SPECIAL CHARACTERS: Dollar     Current representation is "$"(X'5B')            |
|                                                                                   |
|                                                                                   |
| FILL IN PARAMETERS AND PRESS ENTER TO CONTINUE OR PF3 TO EXIT                     |
|                                                                                   |
+-----------------------------------------------------------------------------------+   

The process of setting TRACE levels and turning off a particular TRACE, and the process of setting language preferences for online screens and messages, begins in the SET Command Panel.

Using the SET Command Panel to set and end TRACE levels

Setting the TRACE level can help you monitor certain IOA Online facility and INCONTROL functions, such as security checks.

The following steps explain how to set or turn off a TRACE level:

1. Type a TRACE level number, from 1 through 256, in the TRACE level field of the SETCommand Panel.

2. In the (Trace level 1-256, ON or OFF) field, type ON to set a TRACE level, or OFF to turn off a TRACE level.

3. Press Enter to confirm the setting, in which case the following message is displayed:

   CTMA2AI TRACE LEVEL nnn WAS SET xxx

   In this message

   • nnn is the TRACE level number.

   • xxx indicates whether the TRACE level was set ON or turned OFF.

Using the SET Command Panel to set a dollar sign representation

Setting the dollar sign representation influences how System variables are shown in online screens.

The following steps explain how to set the dollar sign representation:

1. Type a $ character in the Dollar field using your keyboard.

2. Press Enter to confirm the setting, in which case the following message is displayed:

   Copy

   CTMA2DI THE NEW DOLLAR REPRESENTATION IS "c"(X'yy')

   where

   • c is $ character you set

   • yy is the EBCDIC hexadecimal code for $

Using the SET Command Panel to set language preferences

Setting the LANGUAGE influences the online screens and messages in subsequent sessions.

The following steps explain how to set language preferences:

1. In the LANGUAGE field, type one of the following sets of characters to select a language preference:

   • ENG, to set English as the preferred language

   • FRA, to set French as the preferred language

   • GER, to set German as the preferred language

   • JPN, to set Japanese as the preferred language

2. Press Enter to confirm the setting, in which case the following message is displayed:

   Copy

   CTMA27I THE NEW LANGUAGE WILL BE USED FROM THE NEXT LOGON TO IOA

   Language preference settings do not take effect until your next logon to the system.

Rule Definition Facility

The Control-O Rule Definition facility is composed of a series of screens that enable you to view, create, and modify rule definitions and parameters.

Rule definitions under Control-O are stored in libraries (partitioned data sets). A library contains rule tables (members), and each table contains rules (criteria) for one or more console messages, commands, strings, or events. A table generally contains rules related to a specific topic, such as IPL. Although most sites designate a primary rule definition library, the number of rule definition libraries you can use is unlimited.

The number of rule tables in a library, the number of rules in a table, and the size of each rule definition, are all calculated dynamically and are not dependent on parameter specification.

Accessing the Rule Definition Facility

The Rule Definition facility contains the screens shown in Table 27.

Table 27 Rule Definition Facility Screens

To enter the Rule Definition facility, select Option OR on the IOA Primary Option menu and press Enter. The entry panel is displayed.

Creating Tables

Tables can be created in any of the following ways:

• by specifying the new table name in the entry panel and pressing Enter

• by using the SELECT command (described in Options of the Table List Screen) to specify the new table name in the Table List screen and pressing Enter

As a result of using either of the above methods, a skeletal rule definition (that is, one with most fields left blank) is displayed in the rule definition screen.

Fill in the blanks and save the screen entries. The table is created and the rule definition is the first and only definition in the Rule list of the table. As additional rule definitions are created in the table (described below), they are added to the list.

Creating Rule Definitions

Rule definitions can be created using two basic methods

• A skeletal rule definition can be created by specifying the name of a new rule definition in the entry panel. The table specified in the entry panel can be either a new or an existing table. In this case, virtually all fields of the rule definition are empty.

• A copy of an existing rule definition can be created using the INSERT option (described in Options of the Table List Screen in the Rule List screen. In this case, most fields of the new rule definition have the same values as the fields in the copied rule definition.

Performing Operations on Tables and Rules

Many operations can be performed on tables and on the rule definitions in them. These operations are performed using commands and options in the various screens of the Rule Definition facility.

Following is a brief summary of some of the major operations possible within the facility. Additional options and commands are explained following the summary.

Accessing (Editing or Browsing) a Table and its Rules

A table (that is, the rule definitions in the table) can be browsed or edited.

When browsed, the table cannot be modified or updated. When the table is edited, new rule definitions can be added and existing rule definitions can be modified or deleted.

Browsing, however, has the following advantages:

• Access and exit are quicker than in editing.

• Rule lists and definitions that are in use by another user can be viewed.

• Access for browsing might be granted, while though access for editing might be denied due to site security requirements.

To browse a table (and its rule list and rule definitions), use the BROWSE option in the Table List screen.

Specifying the table name in the entry panel or using the SELECT option in the Table List screen provides edit access.

Depending on user profile definitions, if the table requested for editing is in use, access is either granted in Browse mode, or access will not be granted.

Copying a Rule to Another Table

Rules can be copied from one table to another using the COPY option in the Rule List screen. For more information, see Copying Rules to Another Table

Deleting a Table or a Rule

Unneeded rules can be deleted using the DELETE option in the Rule List screen. For more information, see Options of the Table List Screen. Unneeded tables can be deleted using the DELETE option in the Table List screen. For more information, see Deleting Tables.

Ordering Multiple Tables

More than one table at a time can be ordered at one time. To select multiple tables, Tab down in the Tables List screen to each table that you want to select and enter the letter O next to the desired table. Press Enter. A popup confirmation window is displayed, prompting you to choose whether or not to view the confirmation window for each table.

If you choose not to view the confirmation screen before viewing each table (Confirm Y, Ask For Each One N), press Enter.

Saving Modifications

All changes made to a table and its rule scheduling definitions are kept in memory until the table is exited. Upon exiting the table, the user can choose to save or cancel the changes. For more information, see Exiting the Rule Definition Screen.

Entry Panel

Overview

The entry panel is displayed upon entering the Rule Definition facility (Option OR in the IOA Primary Option menu).

Figure 11 Rule Definition Facility Entry Panel

-------------------- CONTROL-O RULE DEFINITION ENTRY PANEL -----------------(OR)
COMMAND ===>
   
   
   
SPECIFY LIBRARY, TABLE NAME, RULE NAME
   
LIBRARY   ===> CTO.PROD.RULES
TABLE     ===>                      (Blank for table selection list)
RULE      ===>                      (Blank for rule selection list)
   
   
   
   
   
   
SHOW SCHEDULING CRITERIA ===> Y     (Y/N)
   
   
   
   
   
USE THE COMMAND "SHPF" TO SEE PFK ASSIGNMENT                            18.12.28

Fill in entry panel fields LIBRARY, TABLE, and RULE, as described below, to open the desired display. Type Y (Yes) or N (No) in the SHOW SCHEDULING CRITERIA field to determine whether scheduling parameters appear when the Rule Definition screen is displayed.

To display the list of tables in a library, do the following:

1. Type the library name.

2. Leave the table name blank or type the table name using mask characters (* and ?).

3. Press Enter.

   To display the list of rules for a specific table, do the following:

4. Type the library name.

5. Type the table name.

6. Press Enter.

   If the table does not exist, the screen for defining a new rule is displayed.

   To display the details of a specific rule (Rule Definition screen), do the following:

7. Type the library name.

8. Type the table name.

9. Type the rule name.

10. Press Enter.

    If the table does not exist, or the rule in the specified table does not exist, the screen for defining a new rule in the table is displayed.

    If you enter the screen for defining a new rule and want to leave the screen without defining a rule, use the CANCEL command.

    To display the Search Window (described below), do the following:

11. Type the library name.

12. Type the rule name.

13. Leave the table name blank or type the table name using mask characters (* or ?).

14. Press Enter.

    To create a new rule table, do the following:

15. Type library name.

16. Specify a new table name.

17. Press Enter.

    The Rule Definition screen, for defining the first rule in the new table, is displayed.

Search Window

The Search window, illustrated in Figure 12, allows the user to search for the specified rule in tables of the specified library. Tables in which the rule has been found are then displayed in the Table List screen.

Figure 12 Rule Definition Facility Entry Panel Search Window

-------------------- CONTROL-O RULE DEFINITION ENTRY PANEL -----------------(OR)
COMMAND ===>
SPECIFY LIBRARY, TABLE NAME, RULE NAME
LIBRARY   ===> CTO.PROD.RULES
TABLE     ===>                      (Blank for table selection list)
RULE      ===> CTOSAMPLE            (Blank for rule selection list)
                                      +-----------------------------------------+
                                      |                                         |
                                      |    PLEASE SELECT ONE OF THE FOLLOWING:  |
                                      |                                         |
                                      |    1  - STOP SEARCH IMMEDIATELY         |
                                      |    2  - ASK AGAIN AFTER 000010 TABLES   |
      SHOW SCHEDULING CRITERIA ===>   |    3  - UNCONDITIONAL SEARCH            |
                                      |                                         |
                                      |    NUMBER OF TABLES IN LIBRARY:  000015 |
                                      |    NUMBER OF SEARCHED TABLES:    000000 |
                                      |    NUMBER OF SELECTED TABLES:    000000 |
                                      |                                         |
                                     -------------------------------------------+
USE THE COMMAND SHPF TO SEE PFK ASSIGNMENT                             12.11.54

To close the Search Window without performing any action, press PF03/PF15 (END).

To perform a search, select one of the following choices and press Enter:

3 - UNCONDITIONAL SEARCH

performs an uninterrupted search of all tables in the specified library.

The search is stopped immediately when you select Option 1.

2 - ASK AGAIN AFTER number TABLES

searches the specified number of tables in the specified library, and then pauses. The search number can be modified. The default is 10.

• Continue the search by pressing Enter.

• Stop the search by selecting option 1 (Stop Search Immediately).

If any tables are found, the Table List is displayed listing those tables.

During the search, the following information is displayed at the bottom of the window:

• Number of tables in library – the total number of tables in the specified library

• Number of searched tables – the cumulative number of tables searched

  For example, if you perform three searches with a specified number of 10, the figure displayed is 30.

• Number of selected tables – the cumulative number of tables selected that contain the rule being searched

If any tables are selected during the search, the Table List is displayed listing those tables. If no tables are selected, the Search Window is closed and a message is displayed.

Table List Screen

The Table List screen, which is shown in Figure 13, displays a list of rule tables (members) in the specified library. You can enter this screen from the entry panel or when returning from the Rule List screen.

By default, only table names are listed in the screen. However, if the default has been modified at time of installation, statistical information is displayed with the table name (as shown in Figure 13).

Figure 13 Rule Definition Facility Table List Screen

TABLES OF LIBRARY CTO.PROD.RULES                               ------------(OR)
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
$HASP             01.00 00/07/06 00/07/06 00:51    38    38     0 IOAPROD
COMMANDS          01.00 00/07/06 00/07/06 00:51    24    24     0 IOAPROD
CTD               01.01 00/07/06 00/11/06 12:24     7     6     0 M19A
CTM               01.00 00/07/06 00/07/06 00:51     7     7     0 IOAPROD
CTO               01.00 00/07/06 00/07/06 00:51     6     6     0 IOAPROD
DEVICES           01.00 00/07/06 00/07/06 00:51    54    54     0 IOAPROD
EVENTS            01.00 00/07/06 00/07/06 00:51    20    20     0 IOAPROD
IEA               01.00 00/07/06 00/07/06 00:51    32    32     0 IOAPROD
IEC               01.00 00/07/06 00/07/06 00:51     6     6     0 IOAPROD
IEE               01.00 00/07/06 00/07/06 00:51    17    17     0 IOAPROD
IFB               01.00 00/07/06 00/07/06 00:51    32    32     0 IOAPROD
IKT               01.00 00/07/06 00/07/06 00:51    13    13     0 IOAPROD
IMS               01.00 00/07/06 00/07/06 00:51    26    26     0 IOAPROD
IOS               01.00 00/07/06 00/07/06 00:51    10    10     0 IOAPROD
IST               01.00 00/07/06 00/07/06 00:51     8     8     0 IOAPROD
SHORTCMD          01.01 00/07/06 00/11/02 12:24    21    20     0 M19A
SHUTSYS           01.00 00/07/06 00/07/06 00:51    19    19     0 IOAPROD
STARTSYS          01.00 00/07/06 00/07/06 00:51     7     7     0 IOAPROD
STATS             01.00 00/05/11 00/05/11 17:35    40    40     0 CTO514
OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE           12.24.50

To scroll down the Table list, press PF08/PF20. To scroll up the Table list, press PF07/PF19.

To return to the entry panel, press PF03/PF15 (END).

Options of the Table List Screen

To request one of the following options, specify the option in the OPT field before the table name, and press Enter.

Table 28 Options of the Table List Screen

When Ordering or Forcing a rule table, if the table is already active under the Control-O monitor, it is replaced by the new copy of the table. All the previous rules of the table are deactivated and replaced by the rules scheduled by the Order or Force.

When ordering a rule table, if no rule has scheduling criteria that are met, the existing table remains in memory, that is, it is not replaced.

To return to the entry panel, press PF03/PF15 (END).

Deleting Tables

To delete tables, type D by the table names and press Enter.

The confirmation window shown in Figure 14 is displayed, in sequence, for each table selected for deletion.

Figure 14 Rule Definition Facility Delete Table Confirmation Window

TABLES OF LIBRARY CTO.PROD.RULES                               ------------(OR)
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME ---          +--------------------------+ E  INIT   MOD   ID
$HASP                  |   CONFIRM DELETE OPTION  | 8    38     0 IOAPROD
D   COMMANDS   <-------|               (Y/N)      | 4    24     0 IOAPROD
CTD                    +--------------------------+ 7     6     0 M19A
CTM               01.00 00/07/06 00/07/06 00:51     7     7     0 IOAPROD
CTO               01.00 00/07/06 00/07/06 00:51     6     6     0 IOAPROD
DEVICES           01.00 00/07/06 00/07/06 00:51    54    54     0 IOAPROD
D   EVENTS            01.00 00/07/06 00/07/06 00:51    20    20     0 IOAPROD
IEA               01.00 00/07/06 00/07/06 00:51    32    32     0 IOAPROD
IEC               01.00 00/07/06 00/07/06 00:51     6     6     0 IOAPROD
IEE               01.00 00/07/06 00/07/06 00:51    17    17     0 IOAPROD
IEF               01.00 00/07/06 00/07/06 00:51    46    46     0 IOAPROD
IKT               01.00 00/07/06 00/07/06 00:51    13    13     0 IOAPROD
IMS               01.00 00/07/06 00/07/06 00:51    26    26     0 IOAPROD
IOS               01.00 00/07/06 00/07/06 00:51    10    10     0 IOAPROD
IST               01.00 00/07/06 00/07/06 00:51     8     8     0 IOAPROD
SHORTCMD          01.01 00/07/06 00/11/06 12:24    21    20     0 M19A
SHUTSYS           01.00 00/07/06 00/07/06 00:51    19    19     0 IOAPROD
STARTSYS          01.00 00/07/06 00/07/06 00:51     7     7     0 IOAPROD
STATS             01.00 00/05/11 00/05/11 17:35    40    40     0 CTO514
OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE           12.24.50

• Type Y (Yes) in the window to delete the table.

• Type N (No) in the window to cancel the deletion request.

For each table deleted, a message is written to the IOA Log.

Rule List Screen

The Rule List screen displays the list of rules in a rule table in a specified library. This screen can be entered directly from the entry panel or the Table List screen, or upon returning from the Rule Definition screen.

Figure 15 Rule Definition Rule List Screen

RULES OF LIBRARY: CTO.PROD.RULES                                TABLE: JOB       
COMMAND ===>                                                    SCROLL===> CRSR
OPT  RULE     TYP ----------------- DESCRIPTION -------------------------------
S   $HASP100  M  HANDLE ALL 'JOB ON RDR' MESSAGES
    $EJ       C  PROCESS JOB RECYCLING COMMANDS
    $HJ       C  PROCESS HOLD JOB COMMANDS
    $NBLC     S  HANDLE OUT OF BAL\ANCE APPLICATION
======= >>>>>>>>>>>>>>>>> NO MORE RULES IN THIS TABLE <<<<<<<<<<<<<<<<<<< ====
OPTIONS:  S SELECT   D DELETE   I INSERT  C COPY                         18.14.05

Format of the Rule List Screen

Next to each rule name in the Rule list, certain information can be displayed. The type and format of this information depends on whether the screen is displayed in DESC format or in STAT format:

• In DESC format, the description of the rule, taken from the DESCRIPTION field of the rule definition, is displayed. This is the default.

• In STAT format, the ISPF-like statistical information relating to the rule is displayed.

To change formats, use the DESC or STAT commands. To change the order in which the rules are displayed in the Rule List screen, use the SORT command. For more information about these commands, see Table 30 Commands of the Rule List Screen. Table 29 lists the Rule Types and their descriptions.

Table 29 Rule Definition Facility Rule Types

Commands of the Rule List Screen

The commands in Table 30 can be entered in the COMMAND field of the Rule List screen.

Table 30 Commands of the Rule List Screen

Options of the Rule List Screen

Use one of the rule options shown in Table 31 by specifying the option before the rule name and pressing Enter.

Table 31 Options of the Rule List Screen

Copying Rules to Another Table

To copy one or more rules from the current table to another table, type C (Copy) by the rules names in the Rule List screen and press Enter. The screen shown in Figure 16 is displayed.

Figure 16 Rule List Screen Copy Window

RULES OF LIBRARY: CTO.PROD.RULES                                TABLE: EXIT
COMMAND ===>                                                    SCROLL===> CRSR
OPT  RULE       TYP------------- DESCRIPTION -------------------------------
     EXIT        E EXIT    EXIT 000 
     EXITMSG1    E EXIT    EXIT 001
     EXITMSG2    E EXIT    EXIT 002
     EXITMSG3    E EXIT    EXIT 003
     EXITMSG4 +-----------------------------------------------------------+
     EXITMSG5 |                                                           |
 C   EXITMSG6 |     SPECIFY DESTINATION LIBRARY,TABLE AND RULE NAME       |
     EXITMSG7 |                                                           |
     EXITMSG8 |  LIBRARY :  CTO.PROD.RULES                                |
     EXITMSG9 |  TABLE   :                                                |
     EXITMSG0 |  RULE    :  EXITMSG0                                      |
     EXITMSGA |                                                           |
     EXITMSGB |  PRESS END/RESET TO CANCEL     ENTER TO PERFORM THE COPY  |
     EXITMSGC +-----------------------------------------------------------+
     EXITMSGD    E EXIT    EXIT 00D
     EXITMSGE    E EXIT    EXIT 00E
     EXITMSGF    E EXIT    EXIT 00F
     EXITMSGG    E EXIT    EXIT 00G
     EXITMSGH    E EXIT    EXIT 00H
     EXITMSGI    E EXIT    EXIT 00I
 OPTIONS S SELECT D DELETE I INSERT C COPY                               15.37.39

The window contains the fields in Table 32. Some fields contain default values which can be modified.

Table 32 Fields of the Rule List Screen Copy Window

• To perform a request, press Enter.

• To cancel a request, press PF03/PF15 (END) or PF04/PF16 (RESET).

Rule Definition Screen

This screen is used to define, display and modify various rule parameters (such as those for a message, string, command, or event). The rule parameters determine Control-O selection and action management. This screen can be entered directly from the entry panel or from the Rule List screen.

The rule parameters may take up more than one screen.

For a detailed explanation of each rule parameter, see Rule Parameters

To delete a parameter on the screen, erase it (press the EOF key, or blank it out). If additional operations are required, Control-O issues appropriate instructions.

The rule parameters are divided into the following basic groups:

• Message and Event Selection parameters (see the ON MESSAGE field in Figure 17 Rule Definition Screen)

• General parameters (see the OWNER, THRESHOLD and DESCRIPTION fields in Figure 17 Rule Definition Screen)

• Automated Console Action parameters (see from the DO DISPLAY field to the DAYS field in Figure 17 Rule Definition Screen)

• Basic Scheduling parameters (optional - see from the DAYS field to the IN field in Figure 17 Rule Definition Screen)

• Runtime Scheduling parameters (optional - see the IN and TIME fields in Figure 17 Rule Definition Screen)

Figure 17 Rule Definition Screen

RL: $HASP100   LIB CTO.PROD.RULES                               TABLE: JOB
COMMAND ===>                                                    SCROLL===> CRSR
    +-----------------------------------------------------------------------------+
  ON MESSAGE  = $HASP100                                                     
     JNAME PROD*    JTYPE J       SMFID        SYSTEM                        
ROUTE          DESC          CONSOLEID    CONSOLE                       
APPEARED     TIMES IN      MINUTES                          And/Or/Not
OWNER SYS3     GROUP                         MODE PROD    RUNTSEC
THRESHOLD
DESCRIPTION JES2 JOB ON RDR MESSAGE SUPPRESSION
DESCRIPTION
===========================================================================
/* SUPPRESS THE MESSAGE
DO DISPLAY  = SUPPRESS Y ROUTE     DESC    CONSOLEID    CONSOLE          
SYSTEM                                                                
DO
=========================================================================== 
                          D O   O P T I O N S                               
Askoper  - Ask operator             COMmand  - Issue operator command      
CONd     - Add/delete IOA condition CTD req  - O/F CONTROl-D mission       
CTOPcmsg - Message to CONTROL-O/PC  DISplay  - Message / Command control   
DOm      - Delete operator messag   FOrcejob - Force job under CONTROL-M   
Ksl      - Activate a KOA script    RESource - Change IOA resources        
RUle     - Call another RULE        SEt      - Set CONTROL-O/IOA variable  
SHEll    - Run a z/OS shell script  SHout    - Notification facility       
SMSClass - Set a new SMS class      SMSMsg   - Issue message by SMS ACS    
SNmp     - Send SNMP Trap message   STopjob  - Stop next job steps         
SYsreq   - System request           Tso      - Activate TSO command        
WAit     - Completion of events     >        - Open a new DO line          
/* -PF16 - Add comment line         />       - Comment/Uncomment "DO"      
If / ELse / ENDIf / ENDMsg / WHile / ENDWhile - Logical instructions       
EXit / RETurn / TERminat                      - End Process Instructions   
========================================================================== 
DAYS                                                          DCAL
                                                                         AND/OR
WDAYS   ALL                                                   WCAL
MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL          SHIFT
ENVIRONMENT SMFID      SYSTEM              
===========================================================================
IN
TIME FROM      UNTIL           INTERVAL      PRIORITY     CONTINUE SEARCH Y
======= >>>>>>>>>>>>>>> END OF RULE DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====
FILL IN RULE DEFINITION. CMDS: EDIT, SCHED, OPT, SHPF                  06.44.34

Display and Non-Display of Scheduling Criteria

When N (No) has been typed in the Show Scheduling Criteria field of the Rule Definition Entry Panel, the Basic and Runtime Scheduling parameters are hidden. In the screen illustrated in Figure 18, the Automated Console Action parameters (DO OPTIONS) are also hidden.

Figure 18 Non-Display of Scheduling Criteria

RL: $HASP100   LIB CTO.PROD.RULES                               TABLE: JOB
COMMAND ===>                                                    SCROLL===> CRSR
+-----------------------------------------------------------------------------+
ON MESSAGE  = $HASP100                                                     
JNAME PROD*    JTYPE J       SMFID        SYSTEM                        
ROUTE          DESC          CONSOLEID    CONSOLE                       
APPEARED     TIMES IN      MINUTES                          And/Or/Not
OWNER IOAADMIN GROUP                         MODE PROD    RUNTSEC       
THRESHOLD
DESCRIPTION JES2 JOB ON RDR MESSAGE SUPPRESSION
DESCRIPTION
==========================================================================
/* SUPPRESS THE MESSAGE
DO DISPLAY  = SUPPRESS Y ROUTE     DESC    CONSOLEID    CONSOLE          
SYSTEM                                                                
DO
===========================================================================
======= >>>>>>>>>>>>>>> END OF RULE DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====
FILL IN RULE DEFINITION. CMDS: EDIT, SCHED, OPT, SHPF                  06.44.34

Typing the SCHED command (abbreviated to SC) in the COMMAND field alternately displays or hides the rule scheduling parameters (independently of the Show Scheduling Criteria field in the Rule Definition Entry Panel).

If you are not using the scheduling options of Control-O, you should work with N (No) as the default.

Message/Event Selection Parameters

Message/Event Selection parameters specify selection conditions that must be fulfilled before Control-O will perform designated actions.

Figure 19 shows a typical screen with Message Event Selection parameters.

Figure 19 Message Event Selection Parameters

RL: $HASP100   LIB CTO.PROD.RULES                               TABLE: JOB
COMMAND ===>                                                    SCROLL===> CRSR
+-----------------------------------------------------------------------------+
ON MESSAGE  = $HASP100                                                     
JNAME          JTYPE         SMFID        SYSTEM                        
ROUTE          DESC          CONSOLEID    CONSOLE                       
APPEARED     TIMES IN      MINUTES                          And/Or/Not  
OWNER IOAADMIN GROUP                         MODE PROD    RUNTSEC       
THRESHOLD
DESCRIPTION JES2 'JOB ON RDR' MESSAGE SUPPRESSION                       
DESCRIPTION                                                                
===========================================================================
DO DISPLAY  = SUPPRESS Y ROUTE     DESC    CONSOLEID    CONSOLE          
SYSTEM                                                               

Table 33 shows the options available when setting the ON parameter.

Table 33 ON Parameter Options

Table 34 shows the And/Or/Not subparameter that is displayed for all types of ON statements except ON EVENT and ON RULE.

Table 34 ON Statement And/Or/Not Subparameter

ON MESSAGE, ON STRING, ON COMMAND and ON CTOPCMSG Subparameters

Figure 20 shows the unique subparameters that are displayed for the following types of ON statements:

• MESSAGE

• STRING

• COMMAND

• CTOPCMSG

These subparameters cannot contain AutoEdit symbols.

Figure 20 Unique Subparameters for ON MESSAGE, ON STRING, ON COMMAND, ON CTOPCMSG

RL: $HASP263   LIB CTO.PROD.RULES                               TABLE: JOB
COMMAND ===>                                                    SCROLL===> CRSR
+-----------------------------------------------------------------------------+
ON MESSAGE  = $HASP263                                                      
JNAME          JTYPE         SMFID        SYSTEM
ROUTE          DESC          CONSOLEID 01 CONSOLE
APPEARED 006   TIMES IN 0003 MINUTES                        And/Or/Not  
OWNER IOAADMIN GROUP                         MODE PROD    RUNTSEC       
THRESHOLD
DESCRIPTION JES CHECKPOINT CONTENTION PROBLEM HANDLING      
DESCRIPTION                                                                
===========================================================================
DO SHOUT    = TO OPER2             URGENCY R SYSTEM CTO282I
MESSAGE JES CHECKPOINT CONTENTION PROBLEM -- PLEASE CHECK

Table 35 shows these unique subparameters, together with descriptions of each of them.

Table 35 Unique Subparameters for ON MESSAGE, ON STRING, ON COMMAND, ON CTOPCMSG

ON DSNEVENT and ON STEP Subparameters

Figure 21 shows the screen displayed when ON DSNEVENT is entered in the ON statement field.

Figure 21 Unique Subparameters for ON DSNEVENT and ON STEP Statements

RL: PRDJ0003   LIB CTO.PROD.RULES                               TABLE: JOB
COMMAND ===>                                                    SCROLL===> CRSR
+-----------------------------------------------------------------------------+
ON DSNEVENT = PRDJ0003 JTYPE   SMFID    SYSTEM
DSN      PROD.*                                       DISP CATLG
PROCSTEP            PGMSTEP            STEPRC OK            And/Or/Not
OWNER IOAADMIN GROUP                         MODE PROD    RUNTSEC   
THRESHOLD
DESCRIPTION NEW DATASET CREATED - TRIGGER A BACKUP JOB
DESCRIPTION
===========================================================================

Table 36 shows the subparameters that are displayed for ON DSNEVENT or ON STEP statements. These subparameters cannot contain AutoEdit symbols.

Table 36 Unique Subparameters for ON DSNEVENT and ON STEP Statements

General Parameters

The parameters shown in Figure 22 are used to provide general information about the rule and to determine the mode in which the rule is processed.

Figure 22 General Parameters

ON EVENT    = CNDRIVEN
OWNER IOAADMIN GROUP                         MODE PROD    RUNTSEC
THRESHOLD
DESCRIPTION EVENT RULE TRIGGERED EACH TIME THE CONDITION IS ADDED
DESCRIPTION
       ===========================================================================

Table 37 General Parameters

Automated Console Action Parameters: DO Statement

Automated Console Action parameters (DO statements) specify actions to be performed by Control-O. These actions are performed only after conditions specified in the Message/Event Selection parameters have been fulfilled.

DESCRIPTION
======================================================================
DO

At least one DO statement must be specified in a rule. Note that the DO IF, DO ELSE and DO ENDIF statements provide Boolean "IF" logic capability, allowing for alternative actions to be performed. Repetition logic is provided using the DO WHILE and DO ENDWHILE statements.

To insert an "empty" DO between two existing DO lines, type the > character over the first letter in the DO field of the first line (for example, DO >OMMAND), and press Enter.

To delete a DO statement, place the cursor on the first letter in the DO field and press the EOF key on your keyboard or blank the field.

A list of allowable DO options is displayed under the Automated Console Action parameters section of the Rule Definition screen. The OPTLIST command can be used to alternately hide or display this list. For more information, see "OPTLIST" in Commands of the Rule Definition Screen.

DOM Options

The following are a description and example of each of the DO statement options.

DO ASKOPER – Issue a WTOR (Write to Operator with Reply) message.

DESCRIPTION
==========================================================================
DO ASKOPER  = HAVE YOU NOTIFIED SHIFT SUPERVISOR ? REPLY 'YES' OR 'NO'
ROUTE       CONSOLEID 01 CONSOLE                           TIMEOUT 0030
DO

DO COMMAND – Issue a specified MVS, VTAM or MVS subsystem operator command.

DESCRIPTION
===========================================================================
DO COMMAND  = D A,CICSPROD
   WAIT        CONSOLEID    CONSOLE          SYSTEM
   WAITMODE   Y             WAITRESP Y            TIMEOUT
   RESPMSG
DO

DO COND – Add or delete a prerequisite condition. Prerequisite conditions are used to trigger events in Control-O or other INCONTROL products.

DESCRIPTION SIGNAL CONTROL-M THAT DB2 IS ACTIVE (AND NOT DOWN)
DESCRIPTION
===========================================================================
DO COND     = DB2-IS-ACTIVE        STAT +   DB2-IS-DOWN           STAT -

DO CTD REQ – Order or Force Control-D mission request.

DESCRIPTION
===========================================================================
DO CTD REQ  = MISSION MIS1     CAT                      DATE ODAT   FORCE Y
                LIBRARY LIB1                                              

DO CTOPCMSG – Specify a message to be sent to Control-M/Links for Windows NT.

DESCRIPTION
===========================================================================
DO SHOUT    = TO OPER2             URGENCY  R          SYSTEM CTO282I82I
   MESSAGE NON-CORRECTABLE I/O ERR ON MVSRES (UNIT=230). PAGE TECH-SUPPORT
DO CTOPCMSG = PAGE SYSPROG DATA-CHECK ON MVSRES (UNIT=230)
DO

DO DISPLAY – Control the display of the message on the console, or control the execution of a command.

DESCRIPTION
=========================================================================== 
DO DISPLAY  = SUPPRESS Y ROUTE     DESC    CONSOLEID 01 CONSOLE
   SYSTEM                                                                  
   NEWTEXT
DO

DO DOM – Delete a highlighted, unrollable message from the display.

DO DISPLAY  = SUPPRESS N ROUTE     DESC    CONSOLEID    CONSOLE         
   SYSTEM                                                               
   NEWTEXT PLEASE MOUNT TAPE S89542 ON UNIT 480
DO SET      = %%NEWDOMID=%%$LDOMID                                 GLOBAL  N
DO WAIT     = REPLY                DOM Y             TIMEOUT 9999
   MESSAGE
DO DOM      = %%NEWDOMID
DO

DO ENDMSG – Delimit DO statements which are processed during message interception in command-response mode or for multi-line messages.

DESCRIPTION
===========================================================================
DO SET      = %%JSTAT = INACTIVE                                  GLOBAL  N
DO COMMAND  = D A,CICSPROD                                            
   WAIT        CONSOLEID    CONSOLE          SYSTEM                
   WAITMODE   Y             WAITRESP Y            TIMEOUT          
   RESPMSG                                                         
IF       %%$W2 %%$M* EQ CICSPROD
DO SET      = %%JSTAT = ACTIVE                                    GLOBAL  N
ENDIF
DO DISPLAY  = SUPPRESS A ROUTE     DESC    CONSOLEID    CONSOLE         
   SYSTEM                                                               
   NEWTEXT
ENDMSG
DO SHOUT    = TO OPER              URGENCY R SYSTEMCTO282I
   MESSAGE JOB CICSPROD IS %%JSTAT
DO

DO EXIT – Exit from a multi-line message block or a DO WHILE block.

===========================================================================
DO SET      = %%$MLLEND=NO                                        GLOBAL  N
DO COMMAND  = $DA                                              
   WAIT        CONSOLEID    CONSOLE          SYSTEM                       
   WAITMODE   Y             WAITRESP Y            TIMEOUT                 
   RESPMSG $HASP890     $HASP612                                          
IF       %%$MSGID EQ $HASP612                                             
DO SHOUT    = TO OPER              URGENCY R SYSTEM          CTO282I      
   MESSAGE SYSTEM IS IDLE                                                 
EXIT     MESSAGE                                                          
DO                                                                        
ENDIF                                                                     
ENDMSG                                                                    
DO                                                                        
===========================================================================

DO FORCEJOB – Force a job under Control-M.

=========================================================================== 
      DO FORCEJOB = TABLE   SMF      JOB CLEANSMF  UFLOW N    DATE ODAT
                    LIBRARY CTM.PROD.SCHEDULE                               
      DO

DO IF / DO ELSE / DO ENDIF – Provide Boolean "IF" logic capability allowing for alternative actions to be performed. Nesting levels can be displayed or hidden using the SHOWNEST command, described in SHOWNEST Command

===========================================================================
DO DISPLAY  = SUPPRESS Y ROUTE     DESC    CONSOLEID    CONSOLE   
   SYSTEM                                                         
DO SHOUT    = TO OPER              URGENCY R SYSTEMCTO282I
   MESSAGE TSO IS BEING SHUT DOWN. SHIFT SUPERVISOR MUST BE NOTIFIED.
DO SET      = %%RC = 4                                            GLOBAL  N
   WHILE    %%RC NE# 0
DO ASKOPER  = HAVE YOU NOTIFIED SHIFT SUPERVISOR?  REPLY 'YES' OR 'CANCEL'
   ROUTE       CONSOLEID    CONSOLE                          TIMEOUT 0030
IF       (%%$ASKRC EQ# 4) AND ((%%$RPLYTXT EQ YES) OR (%%$RPLYTXT EQ CANCEL))
DO SET      = %%RC = 0                                            GLOBAL  N
   ENDIF
   ENDWHILE
   IF       %%$RPLYTXT EQ YES
DO COMMAND  = P TSO                                         
   WAIT        CONSOLEID    CONSOLE          SYSTEM       
   WAITMODE   N
ELSE
DO SHOUT    = TO OPER              URGENCY R SYSTEMCTO282I
   MESSAGE ACTION CANCELED
ENDIF
DO

DO KSL – Execute a KeyStroke OpenAccess (KOA) script.

DESCRIPTION
===========================================================================
DO SET      = %%FILENAME = FILE01                                 GLOBAL  N
DO SET      = %%FILESTAT = UNKNOWN                                GLOBAL  N
DO KSL      = CICSINQ %%FILENAME
   WAITMODE   Y                                      TIMEOUT         STOP Y
   INITPROC   CICSP          SHARELOC Y              IMMEDIATE Y

DO RESOURCE – Change the quantity of a Quantitative resource.

DESCRIPTION                                                                 
=========================================================================== 
DO RESOURCE = TAPE                 0001 +                                   
DO                                                                          
===========================================================================  

DO RETURN – Exit from the rule and return to the caller.

=========================================================================== 
IF       %%$V2 EQ  ''AAUTCNMI''                                           
DO SET      = %%STATUS_NLDM = UP                                  GLOBAL  Y
RETURN                                                                    
ENDIF                                                                     
IF       %%$V2 EQ  ''BNJDSERV''                                           
DO SET      = %%STATUS_NPDA = UP                                  GLOBAL  Y
ENDIF                                                                     
DO                                                                        
=========================================================================== 

DO RULE – Invoke another rule from within the current rule.

DESCRIPTION
===========================================================================
DO RULE     = GENALERT %%$JOBNAME %%ABEND                    OWNER  IOAADMIN
   TABLE               LIBRARY
DO
===========================================================================

DO SET – Assign a value to an AutoEdit variable.

DESCRIPTION
=========================================================================== 
DO SET      = %%IMS1_REPLY_ID = %%$REPLY                           GLOBAL  Y 
DO                                                                          
=========================================================================== 

DO SHELL – Run a z/OS shell script

DESCRIPTION
=========================================================================== 
DO SHELL    = /u/m66/myscript.ch                                            
   WAITMODE   N                                      TIMEOUT         STOP Y
   SHARELOC   N                                      IMMEDIATE N            
DO SHOUT   = TO OPER                    URGENCY R SYSTEM          CTO282I 
   MESSAGE Z/OS SCRIPT myscript.ch ENDED WITH RC=%%$SHELLRC  
DO
===========================================================================

DO SHOUT – Issue a message to a console, TSO user, ROSCOE user, IOA Log or Info/Management using the notification facility.

DESCRIPTION
=========================================================================== 
DO SHOUT    = TO TSO-DBA           URGENCY U SYSTEM                       CTO282I
   MESSAGE DB2 MASTER ABENDED - PLEASE CHECK!                              
DO                                                                          
===========================================================================

DO SMSCLASS – Assign an SMS class name to a new data set.

=========================================================================== 
DO SMSCLASS = ID 01 CLASS SMS_CLASS_01                                      
DO                                                                          
=========================================================================== 

DO SMSMSG – Define a message to be displayed in the job log for a new data set.

=========================================================================== 
DO SMSMSG   = ID 1  MESSAGE SMS MESSAGE                                     
DO                                                                          
=========================================================================== 

DO STOPJOB – Stop the execution of the next steps of the job under which the rule is executing.

DESCRIPTION
=========================================================================== 
DO STOPJOB
DO
===========================================================================

DO SYSREQ – Execute system programmer requests.

DESCRIPTION
===============================================================================
DO SYSREQ   = ENQINFO    STATUS OWNER      SCOPE ALL       JOBNAME
   QNAME      SYSDSN     RNAME %%DSNAME
DO

DO TERMINAT – Terminate the process of the triggering rule, and all called rules (if any), and continue to the next rule.

ON EVENT    = TERMINAT                                                     
OWNER N18A     GROUP                         MODE LOG     RUNTSEC          
THRESHOLD                                                                  
DESCRIPTION                                                                
===========================================================================
DO SET      = %%A=BEFORE CALL                                     GLOBAL  N
DO RULE     = TERMINAT                                      OWNER          
   TABLE               LIBRARY                                             
   SYSTEM              SHARELOC       TIMEOUT                              
DO SET      = %%A=AFTER CALL                                      GLOBAL  N
DO    
ON RULE     = TERMINAT                                                     
OWNER N18A     GROUP                         MODE LOG     RUNTSEC          
THRESHOLD                                                                  
DESCRIPTION                                                                
===========================================================================
DO SET      = %%A=CALLED RULE                                     GLOBAL  N
TERMINAT                                                                   
DO SET      = %%A=AFTER TERMINAT                                  GLOBAL  N
DO

DO TSO – Perform a TSO command, CLIST, or REXX procedure.

DESCRIPTION
===========================================================================
DO TSO      = LISTALC
   WAITMODE   Y                                      TIMEOUT         STOP Y
   INITPROC                  SHARELOC                IMMEDIATE N
DO SHOUT    = TO OPER              URGENCY R SYSTEMCTO282I
   MESSAGE CLIST LISTALC ENDED WITH RC=%%$TSORC    DESCRIPTION
DO

DO WAIT – Delay subsequent action until any of the specified events is completed.

DESCRIPTION
===========================================================================
DO DISPLAY  = SUPPRESS N ROUTE     DESC    CONSOLEID    CONSOLE      
   SYSTEM                                                            
   NEWTEXT PLEASE MOUNT TAPE S89542 ON UNIT 480
DO SET      = %%NEWDOMID=%%$LDOMID                                GLOBAL  N
DO WAIT     = REPLY                DOM Y             TIMEOUT 9999
   MESSAGE
DO DOM      = %%NEWDOMID
DO

DO WHILE / DO ENDWHILE – Provide repetition (loop) logic capability so that other DO actions can be performed repeatedly.

Nesting levels can be displayed or hidden using command SHOWNEST described in SHOWNEST Command.

DESCRIPTION
===========================================================================
  DO DISPLAY  = SUPPRESS Y ROUTE     DESC    CONSOLEID    CONSOLE      
     SYSTEM                                                            
  DO SHOUT    = TO OPER              URGENCY R SYSTEMCTO282I
     MESSAGE TSO IS BEING SHUT DOWN. SHIFT SUPERVISOR MUST BE NOTIFIED.
  DO SET      = %%RC = 4                                            GLOBAL  N
 WHILE    %%RC NE# 0
  DO ASKOPER  = HAVE YOU NOTIFIED SHIFT SUPERVISOR?  REPLY 'YES' OR 'CANCEL'
     ROUTE       CONSOLEID    CONSOLE                          TIMEOUT 0030
 IF       (%%$ASKRC EQ# 4) AND ((%%$RPLYTXT EQ YES) OR (%%$RPLYTXT EQ CANCEL))
  DO SET      = %%RC = 0                                            GLOBAL  N
 ENDIF
 ENDWHILE
 IF       %%$RPLYTXT EQ YES
  DO COMMAND  = P TSO                                         
     WAIT        CONSOLEID    CONSOLE          SYSTEM       
     WAITMODE   N
 ELSE
  DO SHOUT    = TO OPER              URGENCY R SYSTEMCTO282I
     MESSAGE ACTION CANCELED
 ENDIF
  DO

Basic Scheduling Parameters

Control-O Basic Scheduling parameters specify on what dates the rule is a candidate for activation on a daily basis. The rule is "ordered" (that is, its basic scheduling criteria are checked; if fulfilled, the rule is ready to be activated — placed in the active Control-O monitor environment). However, it is not activated until Runtime Scheduling and Message/Event criteria have been fulfilled.

Use of the Basic Scheduling parameters is optional and is usually performed by advanced Control-O users. The "Show Scheduling Criteria" field of the entry panel manages the display of Basic and Runtime Scheduling parameters on the Rule Definition screen. It is also possible to control this feature from the Rule Definition screen. Type SCHED (or SC) in the command area and press Enter to alternate between display or non-display of the scheduling parameters.

Figure 23 shows the Basic Scheduling Parameters section of the Rule Definition screen.

Figure 23 Basic Scheduling Parameters

===========================================================================
DAYS                                                          DCAL         
                                                                    AND/OR  
WDAYS   ALL                                                   WCAL         
MONTHS  1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y     
DATES                                                                      
CONFCAL          SHIFT                                                     
ENVIRONMENT SMFID      SYSTEM                                              
===========================================================================

Table 38 shows the basic scheduling parameters, together with explanations of each of them.

Table 38 Basic Scheduling Parameters

Runtime Scheduling Parameters

Control-O Runtime Scheduling parameters specify runtime scheduling conditions under which actions are performed by Control-O. Control-O does not scan for messages and commands unless all runtime parameters are fulfilled. For example, special network status monitoring is activated only during heavy data transmission.

Figure 24 shows the Runtime Scheduling parameters section of the Rule Definition screen.

Figure 24 Runtime Scheduling Parameters

===========================================================================
IN        IMS-ABEND            0101
TIME FROM 2200 UNTIL 0600      INTERVAL      PRIORITY 99  CONTINUE SEARCH Y
====== >>>>>>>>>>>>>>> END OF RULE DEFINITION PARAMETERS <<<<<<<<<<<<<<< ====

Commands of the Rule Definition Screen

Table 39 shows the commands, other than the /> command, that can be specified in the COMMAND field of the Rule Definition screen.

Table 39 Commands of the Rule Definition Screen

Specifying Comments

Comments are free text descriptions of rule definition parameters that are stored in a rule definition member. BMC recommends that you insert comments within rule definitions for clarification and documentation purposes. Comments are not processed during rule execution.

To insert a comment, position the cursor at the line before which the comment should be inserted, and press CMNT (PF04/PF16). A comment line is opened beginning with the symbol /*. To insert additional lines, fill in the current line and press Enter.

The Rule Definition screen shown in Figure 25 illustrates comment usage.

Figure 25 Illustration of Rule Definition Comment Usage

RL: CANCEL *   LIB CTO.PROD.RULES                               TABLE: JOB
COMMAND ===>                                                    SCROLL===> CRSR
     +-----------------------------------------------------------------------------+
  ON COMMAND  = CANCEL *                                                     
     JNAME CONSOLE  JTYPE         SMFID        SYSTEM       USERID
     ROUTE          DESC          CONSOLEID 01 CONSOLE                     
   APPEARED     TIMES IN      MINUTES                          And/Or/Not  
  OWNER IOAADMIN GROUP                         MODE PROD    RUNTSEC       
  THRESHOLD
  DESCRIPTION ASK FOR OPERATOR'S CONFIRMATION OF SENSITIVE COMMANDS          
  DESCRIPTION                                                                
  ===========================================================================
  /* SUPPRESS ORIGINAL COMMAND                                               
  DO DISPLAY  = SUPPRESS Y ROUTE     DESC    CONSOLEID    CONSOLE    
     SYSTEM                                                          
  /* ASK OPERATOR FOR CONFIRMATION                                           
  WHILE    %%$RPLYTXT NE YES AND %%$RPLYTXT NE NOT                             
  DO ASKOPER  = ENTER "YES" OR "NOT" FOR CONFIRMATION                        
  ROUTE       CONSOLEID    CONSOLE                          TIMEOUT   
  ENDWHILE                                                                   
  /* UPON CONFIRMATION, RE-ISSUE THE ORIGINAL COMMAND                        
  IF       %%$RPLYTXT EQ YES                                                  
  DO COMMAND  = %%$CMD    
     WAIT        CONSOLEID    CONSOLE          SYSTEM                  
     WAITMODE   N                                                            
  ENDIF                                                                      
  DO                                                                         
FILL IN RULE DEFINITION. CMDS: EDIT, SCHED, OPT, SHPF                  14.51.58

An unlimited number of comment lines can be specified in a rule definition.

Control-O line editing commands, similar to ISPF line commands, can be performed on comment lines. For more information, see Editing Rule Definitions in the IOA Edit Environment.

Commenting Out Rule Statements

Existing DO statements in a Control-O rule definition can be commented out through the /> command. This command can be useful for testing how a rule functions without certain statements, or for temporarily disabling certain functions normally performed by the rule.

To comment out a statement, type /> over the first two characters in the DO field, and press Enter. The characters /> are displayed before all lines that have been commented out.

DO COMMAND  = D T
  WAIT        CONSOLEID    CONSOLE          SYSTEM
  WAITMODE   N

DO />MMAND  = D T
  WAIT        CONSOLEID    CONSOLE          SYSTEM
  WAITMODE   N

/> COMMAND  = D T
/> WAIT        CONSOLEID    CONSOLE          SYSTEM
/> WAITMODE   N

Removing the Comment Indicators

To remove the comment indicator from a statement that has been commented out, type /> over the first two characters in the statement name and press Enter.

/> />MMAND  = D T
/> WAIT        CONSOLEID    CONSOLE          SYSTEM
/> WAITMODE   N

Editing Rule Definitions in the Edit Environment

Rule Definition parameters can be edited, that is, moved, copied, deleted, or repeated, by performing IOA Line Editing commands, similar to standard ISPF line commands, from within the Control-O Edit environment.

The Edit Environment in a Rule Definition screen is accessed by typing EDIT in the COMMAND field and pressing Enter.

A 2-character Line Editing command field, marked by underscores, is displayed for each line in the Rule Definition screen.

Editing commands are typed directly onto these underscores.

Figure 26 Entering Editing Commands

RL: $HASP250   LIB CTOP.PRODSMP.RULES                           TABLE: $HASP
COMMAND ===>                                                    SCROLL===> CRSR
-------------------------------------------------------------------------------
__ ON MESSAGE  = $HASP250
__    JNAME          JTYPE         SMFID        SYSTEM                     
__    ROUTE          DESC          CONSOLEID    CONSOLE                    
__    APPEARED     TIMES IN      MINUTES                          And/Or/Not
__ OWNER IOAADMIN GROUP                         MODE PROD    RUNTSEC       
__ THRESHOLD
C_ DESCRIPTION **************************************
A_ DESCRIPTION * JES2 - SUPPRESS JOB PURGED MESSAGE *
__ DESCRIPTION
__ ===========================================================================
__ DO DISPLAY  = SUPPRESS   ROUTE     DESC    CONSOLEID    CONSOLE     
__    SYSTEM                                                           
__ DO
__ ===========================================================================
FILL IN RULE DEFINITION. CMDS: EDIT, SCHED, OPT, SHPF                  17.20.04

The line editing commands that you have typed are processed when Enter is pressed.

For more information and examples of editing rule definitions in the Edit environment, see Editing Rule Definitions in the IOA Edit Environment.

Exiting the Rule Definition Screen

The commands shown in Table 40 can be used to exit the Rule Definition screen.

Table 40 Commands for Exiting the Rule Definition Screen

Exiting the Rule List Screen

Press END (PF03/PF15) to exit the Rule List screen. If changes have been made, the Exit Option window shown in Figure 27 is opened.

Figure 27 Rule List Screen Exit Option Window

RULES OF LIBRARY: CTO.PROD.RULES                                TABLE: $DSPOOL
COMMAN +-----------------------------------------------------------+  ===> CRSR
OPT  R |                 PLEASE SELECT EXIT OPTION                 |  ---------
     $ |                                                           |
     $ |     SAVE    CREATE                                        |
     $ |                                                           |
     $ |     LIBRARY CTO.PROD.RULES                                |
 ===== |     TABLE   $DSPOOL                                       |  <<<< ====
       |                                                           |
       +-----------------------------------------------------------+
OPTIONS:  S SELECT   D DELETE   I INSERT                               17.05.45

You must type Y (Yes) or N (No) in one of the two exit options, SAVE or CREATE. It is possible to change the name of the library or the name of the table in the window. You will return either to the Table list or to the entry panel, depending on how you entered the Rule List screen.

If you have entered an Exit Option window, but do not want to exit the Rule List screen, press PF04/PF16 (RESET). The Rule List screen is then displayed, and the table is not saved.

Ordering Rule Tables

The Rule Definition screen is used to define and modify rules. Rule definitions are used by Control-O to intercept and manage console messages (or commands, strings, or events). A rule definition that resides in the library is not "active" until it has been ordered. Rule tables can be ordered automatically each day or manually. For more information on automatic ordering of rule tables, see the Control-O chapter of the INCONTROL for z/OS Administrator Guide.

When ordering or forcing a rule table, if the table is already active under the Control-O monitor, it is replaced by the new copy of the table. All previous rules of the table are deactivated and replaced by the rules scheduled by the Order or Force.

Two ways to manually order rule tables are by using the O and F options of the Table List screen. These are described in Table 41.

Table 41 Options for Manually Ordering Rule Tables

When you use the O and F options, the default confirmation window shown in Figure 28 is opened. If the default has been modified in a profile variable, a different confirmation window, requiring double confirmation, is opened.

Figure 28 Order and Force Confirmation Window

TABLES OF LIBRARY CTO.PROD.RULES                               ------------(OR)
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
    $HASP             01.00 00/07/06 00/07/06 00:51    38    38     0 IOAPROD
    COMMANDS          01.00 00/07/06 00/07/06 00:51    24    24     0 IOAPROD
    CTD                    +-------------------------------+  6     0 M19A 
    CTM                    |   CONFIRM     ODATE 060600    |               
O   CTO        <-----------|   ASK FOR EACH ONE  Y         |               
    DEVICES                +-------------------------------+  4     0 IOAPROD
    EVENTS            01.00 00/07/06 00/07/06 00:51    20    20     0 IOAPROD
    IEA               01.00 00/07/06 00/07/06 00:51    32    32     0 IOAPROD
O   IEC               01.00 00/07/06 00/07/06 00:51     6     6     0 IOAPROD
    IEE               01.00 00/07/06 00/07/06 00:51    17    17     0 IOAPROD
O   IEF               01.00 00/07/06 00/07/06 00:51    46    46     0 IOAPROD
    IFB               01.00 00/07/06 00/07/06 00:51    32    32     0 IOAPROD
    IKT               01.00 00/07/06 00/07/06 00:51    13    13     0 IOAPROD
    IMS               01.00 00/07/06 00/07/06 00:51    26    26     0 IOAPROD
    IOS               01.00 00/07/06 00/07/06 00:51    10    10     0 IOAPROD
    IST               01.00 00/07/06 00/07/06 00:51     8     8     0 IOAPROD
    SHORTCMD          01.01 00/07/06 00/11/02 12:24    21    20     0 M19A
    SHUTSYS           01.00 00/07/06 00/07/06 00:51    19    19     0 IOAPROD
    STARTSYS          01.00 00/07/06 00/07/06 00:51     7     7     0 IOAPROD
    STATS             01.00 00/07/11 00/07/11 17:35    40    40     0 CTOPROD
OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE           12.24.50

The specified date can be changed. To confirm your selection, enter Y (Yes) in the CONFIRM field. If you decide not to order or force the table, enter N (No). The original screen is displayed.

The ASK FOR EACH ONE line is displayed if more than one Order or Force is requested. If you are certain that you want to order or force all indicated tables, and do not want to change the ODATE for any of the individual tables, you can type Y (Yes) in the CONFIRM field to bypass individual confirmations and N (No) in the ASK FOR EACH ONE field, and then press Enter. All tables marked O (or F) are ordered.

Wish WO0943

As a result of the Order or Force request an MVS MODIFY command is sent to the Control-O monitor. Some installations may protect the MVS command. If the user is not authorized to issue an MVS MODIFY command the Order or Force fails.  

If you apply this wish, by specifying WO0943 APPLY=YES in the IOADFLTL member, the MODIFY command will be executed under the Control-O or CMEM monitor. Therefore, authority to issue an MVS MODIFY command is required only for the Control-O or CMEM monitor USERID.

Wish WO0943 also introduces

• the following AutoEdit system variables, each of which return Wish WO0943 with a status of Y or N

  • %%$WO0943

  • %%$MODIFY_O_F

• the following Control-O MODIFY command

  Copy

  F controlo,WISH=WO0943,xxxxx

  • In this command, xxxxx is either ENABLE or DISABLE

  • This command allows the user to enable or disable optional Wish WO0943 without stopping Control-O.

Copying Rules to Another Table

To copy one or more rules from the current table to another table, type C (Copy) by the rule names in the Rule List screen and press Enter. The window shown in Figure 29is displayed.

Figure 29 Window for Copying Rules to Another Table

RULES OF LIBRARY: CTO.PROD.RULES                                TABLE: EXIT
COMMAND ===>                                                    SCROLL===> CRSR
OPT  RULE       TYP------------- DESCRIPTION -------------------------------
     EXIT        E EXIT    EXIT 000 
     EXITMSG1    E EXIT    EXIT 001
     EXITMSG2    E EXIT    EXIT 002
     EXITMSG3    E EXIT    EXIT 003
     EXITMSG4 +-----------------------------------------------------------+
     EXITMSG5 |                                                           |
 C   EXITMSG6 |     SPECIFY DESTINATION LIBRARY,TABLE AND RULE NAME       |
     EXITMSG7 |                                                           |
     EXITMSG8 |  LIBRARY :  CTO.PROD.RULES                                |
     EXITMSG9 |  TABLE   :                                                |
     EXITMSG0 |  RULE    :  EXITMSG0                                      |
     EXITMSGA |                                                           |
     EXITMSGB |  PRESS END/RESET TO CANCEL     ENTER TO PERFORM THE COPY  |
     EXITMSGC +-----------------------------------------------------------+
     EXITMSGD    E EXIT    EXIT 00D
     EXITMSGE    E EXIT    EXIT 00E
     EXITMSGF    E EXIT    EXIT 00F
     EXITMSGG    E EXIT    EXIT 00G
     EXITMSGH    E EXIT    EXIT 00H
     EXITMSGI    E EXIT    EXIT 00I
OPTIONS S SELECT D DELETE I INSERT C COPY                               15.37.39

The fields in the window in Figure 29 are described in Table 42. Some fields contain default values which can be modified.

Table 42 Fields in the Window for Copying Rules to Another Table

• To perform a request, press Enter.

• To cancel a request, press PF03/PF15 (END) or PF04/PF16 (RESET).

Message Statistics Screen

The Message Statistics screen displays statistics for all messages and commands intercepted by Control-O. Selection criteria for statistics can be specified in the Show Option window, which is described in Show Option Window.

To enter the Message Statistics screen, select Option OM (Control-O Message Statistics) in the IOA Primary Option menu.

Figure 30 Message Statistics Screen

------------- CONTROL-O MESSAGE STATISTICS FROM 12/12/00 11:12:51 ---------(OM)
COMMAND ===>                                                    SCROLL===> CRSR
MSG  659,035  CMD    1,714  HANDLED  607,498  SUPPRESSED  606,885    SMFID FDSF
O ID        TYP    COUNT   HANDLED SUPPRESSED ------------ TEXT ---------------
  $HASP000 M   26,347 26,347 26,347  $HASP000 OK
     $HASP317   M    19,556    19,556    19,556  $HASP317 T17INS24 0005 DATA SETS
     $HASP250   M    17,091    17,091    16,993  $HASP317 T17INS24 IS PURGED
     ICH7001I   M    17,004    17,004    17,004  ICH7001I T72A     LAST ACCESS AT
     $HASP100   M    16,568    16,568    16,568  $HASP100 PRDKPL02 ON INTRDR
     $HASP373   M    12,995    12,995    10,307  $HAPS373 PRDKPL01 STARTED - INIT
     $HASP395   M    12,992    12,992    10,306  $HASP395 T44UPDTA ENDED
     IEF403I    M    12,991    12,991    12,991  IEF403I T44UPDTA - ENDED - TIME=
     IEF404I    M    12,990    12,990    12,990  IEF404I PRKDPL-1 - STARTED - TIM
     $HASP309   M    12,802    12,802    12,802  $HASP309    INIT 4 INACTIVE ****
     IEF125I    M     3,430     3,430     3,430  IEF125I T21 - LOGGED ON - TIME=1
     IEF667I    M     3,421     3,421     3,421  IEF667I WARNING MESSAGE(S) FOR J
     IEF126I    M     3,284     3,284     3,284  IEF126I T74 - LOGGED OFF - TIME=
     IEF234E    M     2,725     2,725         0  IEF234E K 481,994631,PVT,T15MALL
     IEF233A    M     2,499     2,499         0  IEF233A M 480,015537,,PRGPL27A,C
     $HASP688   M     1,683     1,683       906  $HASP688 T92PRNTS OUTGRP=1.1.1
     $HASP608   M     1,527         0         0  $HASP608 T02KPL91 EXECUTING A PR
     IEC705I    M     1,525     1,525         0  IEC705I TAPE ON 480,014901,SL,62
     IEE600I    M     1,504     1,504     1,009  IEE600I REPLY TO 72 IS; NOHOLD
OPTIONS:  S SHOW  X EXCLUDE  R RESET                                   14.29.51

Up and down scrolling conventions and right and left shifting conventions are supported in the Message Statistics screen.

To update the display with the last available values from the Control-O monitor, type REFRESH in the COMMAND field and press Enter, or press PF16.

To return to the IOA Primary Option menu, press PF03/PF15 (END).

Fields of the Message Statistics Screen

Table 43 Fields of the Message Statistics Screen

COUNT Field, HANDLED Field and SUPPRESSED Field Formats

The format for the COUNT, HANDLED, and SUPPRESSED fields, in both detail and summary lines, is as follows:

• Values up to 999,999 appear in standard numeric format nnn,nnn.

• Larger values are indicated by a K or M, as shown in Table44.

Table 44 Format of the COUNT, HANDLED and SUPPRESSED Fields

An asterisk following a COUNT value (for example, 2,984*) indicates that the statistics for that particular message or command have been locally reset using the RESET option (discussed in Options of the Message Statistics Screen). Asterisks following COUNT values disappear after global resets. (Global reset of the entire Message Statistics facility is performed by the operator, and is discussed in the Control-O chapter of the INCONTROL for z/OS Administrator Guide.

Commands of the Message Statistics Screen

The following commands can be specified in the COMMAND field of the Message Statistics screen:

Table 45 Commands of the Message Statistics Screen

Show Option Window

The Show Option window is shown in Figure 31. It enables you to specify criteria to determine which messages and commands are included in the statistics display. To open the window, type SHOW in the COMMAND field of the Message Statistics screen, or press PF02/PF14. Make the desired changes in the Show Option window, and press Enter.

Figure 31 Message and Statistics Screen Show Option Window

------------- CONTROL-O MESSAGE STATISTICS FROM 12/12/00 11:12:51 ---------(OM)
COMMAND ===>                     +--------------------------------------------+
MSG  659,035  CMD    1,714  HAN  |       PLEASE SELECT SHOW OPTION            |
O ID        TYP    COUNT   HAND  |                                            |
  $HASP000   M    26,347    26,  |  MSGID                                     |
  $HASP317   M    19,556    19,  |  TEXT                                      |
  $HASP250   M    17,091    17,  |                                            |
  ICH7001I   M    17,004    17,  |  COUNT FROM           TO                   |
  $HASP100   M    16,568    16,  |                                            |
  $HASP373   M    12,995    12,  |  COMMANDS        Y | MESSAGES           Y  |
  $HASP395   M    12,992    12,  |  SHOWN           N | EXCLUDED           Y  |
  IEF403I    M    12,991    12,  |    ------------------------------------    |
  IEF404I    M    12,990    12,  |  HANDLED         N | NOT HANDLED        N  |
  $HASP309   M    12,802    12,  |  SUPPRESSED      N | NOT SUPPRESSED     N  |
  IEF125I    M     3,430     3,  |                                            |
  IEF667I    M     3,421     3,  +--------------------------------------------+
  IEF126I    M     3,284     3,
  IEF234E    M     2,725     2,725         0  IEF234E K 481,994631,PVT,T15MALL
  IEF233A    M     2,499     2,499         0  IEF233A M 480,015537,,PRGPL27A,C
  $HASP688   M     1,683     1,683       906  $HASP688 T92PRNTS OUTGRP=1.1.1
  $HASP608   M     1,527         0         0  $HASP608 T02KPL91 EXECUTING A PR
  IEC705I    M     1,525     1,525         0  IEC705I TAPE ON 480,014901,SL,62
  IEE600I    M     1,504     1,504     1,009  IEE600I REPLY TO 72 IS; NOHOLD
OPTIONS:  S SHOW  X EXCLUDE  R RESET                                   14.29.51

The selection criteria that are available are shown in Table 46.

Table 46 Show Option Selection Criteria

Options of the Message Statistics Screen

The following options, listed at the bottom of the screen, can be applied to any statistics line.

Table 47 Options of the Message Statistics Screen

Rule Status Screen

The Rule Status screen displays the statuses of rules loaded into memory by Control-O. Selection criteria for rules can be specified in the Show Option window, which is discussed in Show Option Window. The Rule Status screen is also used to hold, delete, free, cancel or change the operation mode of rules.

To enter the Rule Status screen, select the OS option in the IOA Primary Option menu.

Up and down scrolling conventions are supported on the Rule Status screen.

To return to the IOA Primary Option menu, press PF03/PF15 (END).

Two predefined display types (described below) are available for the Rule Status screen.

Changing Display Types

While in the Rule Status screen, the display type can be changed using the DISPLAY command. The format of the command is

DISPLAY x

In this command, x is the identifying letter for the desired type. DISPLAY can be abbreviated to DI.

Your INCONTROL administrator can also define additional site-specific display types.

Display Type D (Default)

Figure 32 shows an example of the Default display type of the Rule Status screen.

Figure 32 Rule Status Screen Display Type D (Default)

---------------------------- CONTROL-O RULE STATUS ----------<D>-----------(OS)
COMMAND ===>                                                    SCROLL===> CRSR
RULES:   584   MSG   481   CMD    64   EVN    39   ACTIVATED   569   SMFID FDSF
O RULE       TYP ---- DESCRIPTION ---- ACTIVATED --------- STATUS -------- UP
  IRA200E     M  AUX. STORAGE SHORTAG         7  EXECUTING - KSL
  IEF126I     M  SUPPRESS TSO LOGOFF      4,639  ACTIVE
  IFB060E     M  LOGREC 90% FULL             29  ACTIVE
  IEE366I     M  NO SMF DATA SET AVAI       34   ACTIVE
  IEF450I     M  LOG ALL ABEND MSG        1,270  ACTIVE
  IEF238D     M  JOB WAITING FOR UNIT        35  ACTIVE
  IEF433D     M  REPLY HOLD OR NOHOLD        35  ACTIVE
  IEF863I     M  DS NOT BALANCED MSG         96  EXECUTING - TSO
  ICH7001I    M  SUPPRESS RACF MSG       12,615  ACTIVE
  $HASP375    M  TEST - EXCEEDED LINE         2  HELD
  NOT BAL     S  APPL NOT BALANCED MS         4  WAIT ACTIVATION
  SHUTSYS     C  FAST SHUT-SYSTEM CMD        78  ACTIVE
  $PJ*        C  CONTROL JES PURGE CM        17  ACTIVE
  CICS-UP     E  CICS PRODUCTION IS U       407  WAIT ACTIVATION
  NIGHT-S     E  NIGHT SHIFT EVENT          183  WAIT ACTIVATION
  DAY-S       E  DAY SHIFT EVENT            184  WAIT ACTIVATION
  R1?T*       R  CONTROL RJE JOBS         9,202  ACTIVE
  P*          D  HANDLE NOT-CATLGD 2         21  ACTIVE
  PRD*        D  TRIGGER ON DS CATALO        58  WAIT ACTIVATION
OPTIONS:  ? WHY  H HOLD  D DEL   F FREE  M MODE  C CANCEL  R RESUME  17.04.29

Table 48 describes the fields of the Default display type of the Rule Status screen.

Table 48 Fields of Display Type D (Default)

Display Type A (All Fields)

Figure 33 is an example of the All Fields display type for the Rule Status screen. In this display type, all possible status fields are displayed for each rule. This display type is requested by typing DISPLAY A (abbreviated DI A) in the COMMAND field of the screen.

Figure 33 Rule Status Screen Display Type A (All Fields)

---------------------------- CONTROL-O RULE STATUS ------------<A>---------(OS)
COMMAND ===>                                                    SCROLL===> CRSR
RULES:    450  MSG    378  CMD     17  EVN      3  ACTIVATED     22  SMFID OS35
O RULE       TYP --- DESCRIPTION ----  ACTIVATED ---------- STATUS ------  UP 
  $HASP493    M  JES2 - MARK THAT JES         0  ACTIVE                       
   LIBRARY:  CTOP.PROD.RULES                               TABLE:    STARTCTO 
   LAST ORDERED:   08/08/00 16:48:26   MODE:    PROD  PROD  PRIORITY:         
   LAST TRIGGERED: **/**/** **:**:**   RUNTSEC: :                             
   GROUP:                              OWNER:   M22        CONTINUE SEARCH: Y 
   CREATED BY: UNKNOWN  AT  **/**/** **:**:** VERSION:  **.**                 
   UPDATED BY: UNKNOWN  AT  **/**/** **:**:** RELEASE:  PRE V6.0.             
   THRESHOLD           CTO VALUE 000001000 CURRENT 000000000 MAX 000000000    
                                                                              
  $*          C  STATS FOR JES2 CMDS        247  ACTIVE                       
   LIBRARY:  CTOP.PROD.RULES                               TABLE:    STATS    
   LAST ORDERED:   08/08/00 16:48:26   MODE:    PROD  PROD  PRIORITY:         
   LAST TRIGGERED: 09/08/00 11:00:09   RUNTSEC: :                             
   GROUP:                              OWNER:   M24A       CONTINUE SEARCH: Y 
   CREATED BY: UNKNOWN  AT  **/**/** **:**:** VERSION:  **.**                 
   UPDATED BY: UNKNOWN  AT  **/**/** **:**:** RELEASE:  PRE V6.0.             
   THRESHOLD           CTO VALUE 000001000 CURRENT 000000000 MAX 000000004    
                                                                              
  $*          M  STATS FOR JES2 CMDS/     8,434  ACTIVE                       
OPTIONS:  ? WHY  H HOLD  D DEL   F FREE  M MODE  C CANCEL  R RESUME  17.04.29

Table 49 shows the fields of the All Fields display type for the Rule Status screen.

Table 49 Fields of Display Type A (All Fields)

Commands of the Rule Status Screen

The following commands can be specified in the COMMAND field of the Rule Status screen.

Table 50 Commands of the Rule Status Screen

Show Option Window

Figure 34 is an example of the Show Option window, which enables you to specify criteria to determine which active rules are included in the status display. To open the window, type SHOW in the COMMAND field of the Rule Status screen, or press PF02/PF14. Change criteria by making the desired changes and pressing Enter.

Figure 34 Rule Status Screen Show Option Window

---------------------------- CONTROL-O RULE STATUS ------------<D>---------(OS)
COMMAND ===>      +-----------------------------------------------------------+
RULES:    450  MSG|                PLEASE SELECT SHOW OPTION                  |
O RULE       TYP -|  RULE                                                     |
  CMEMJOBA    R  S|  GROUP                                                    |
  JOBEND      X  S|                                                           |
  CMEMJOB     D  S|  LIBRARY                                                  |
  $HASP493    M  J|  TABLE                                                    |
  CT0139I     M  C|         ====  STATUS   ====                               |
  CT0621I     M  C|  ACTIVE Y EXECUTING Y WAIT ACTIVE Y HELD Y SUSPEND  Y     |
  CTO623I     M  C|         ==== RULE TYPE ====                               |
  COSCLEAR    E  I|   MSG STR COM EVN DSN INT JOB RUL STP OMG PCM MVI SMS SYS |
  COSINI      C  C|    Y   Y   Y   Y   Y   Y   Y   Y   Y   Y   Y   Y   Y   Y  |
  COSCMD*     C  E|  PRIORITY  FROM    TO      CONTINUE SEARCH  YES Y NO Y    |
  COSTERM     C  T|                                                           |
  COSBOUNZ    C  B|  ACTIVATION#  FROM               TO                       |
  COSUP       C  S|                                                           |
  COSDOWN     C  S|  OWNER               MODE:  PROD Y   TEST Y   LOG Y       |
  COSOBJ *    C  S+-----------------------------------------------------------+
  COSCUP *    C  SYNTAX SUGARING FOR          0  ACTIVE                       
  COSCDOWN *  C  SYNTAX SUGARING FOR          0  ACTIVE                       
  OPTIONS:  ? WHY  H HOLD  D DEL  F FREE  M MODE  C CANCEL  R RESUME     11.17.01

Table 51 shows the criteria that can be specified in the Rule Status screen Show Options window.

Table 51 Rule Status Screen Show Option Window Criteria

Options of the Rule Status Screen

Table 52 shows the options that can be applied to the rule status line of any rule that is not currently active (that is, any rule that has EXECUTING status). These options are listed at the bottom of the Rule Status screen.

Table 52 Options of the Rule Status Screen

Why Screen

Figure 35 shows the Why screen, which is displayed when ? (WHY) is entered on the Rule Status screen. The Why screen shows reasons for the WAIT ACTIVATION status.

Figure 35 Why Screen

-------------------------- CICSP    IS WAITING FOR: ---------------------(OS.?)
COMMAND ===>                                                   SCROLL====> CRSR
   
        TIME LIMIT        FROM   0900            UNTIL
        CONDITION        DAILY-PROD              ODATE    0203
====== >>>>>>>>>>>>>>>>>>>      END OF "WHY" LIST     <<<<<<<<<<<<<<<<<< ======
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
PRESS END PFK TO RETURN TO STATUS SCREEN                               10.46.20

Scrolling conventions are supported if the displayed list is longer than one screen.

To return to the Rule Status screen, press PF03/PF15 (END).

Automation Log Screen

The Automation Log screen displays the stream of messages and commands captured by Control-O, as well as Control-O internal messages and traces of rules executing with MODE set to LOG.

In a Sysplex environment, this screen can also be used to view the MVS Operlog.

The messages are displayed together with all the additional information which is relevant to the automation process

Selection criteria for display can be specified either in the Show Option window, which is described in Show Option Window, or with special commands such as ALL or TRACE. Either the current Automation Log or a backup Automation Log can be displayed.

To request the Automation Log facility, select OL (Control-O Automation Log) in the IOA Primary Option menu.

Up and down scrolling conventions are supported on the Automation Log screen.

To return to the IOA Primary Option menu, press PF03/PF15 (END).

The predefined display types (described below) are available for the Automation Log screen. The operator can control the amount of information displayed, and the format of the display, by choosing one of the available display types. Customized display types can also be defined.

Changing Display Types

While in the Automation Log screen, the display type can be changed using the DISPLAY command. The format of the command is DISPLAY x. In this command, x is the identifying letter for the desired type. DISPLAY can be abbreviated to DI.

Table 53 shows the valid All Fields display types.

Table 53 Valid All Fields Display Types

Display Type D (Default)

Figure 36 shows an example of the Default display type (indicated by <D> in the top line of the screen) for the Automation Log screen.

Figure 36 Automation Log Screen Default Display Type (D)

  -------------< D >------------- AUTOMATION LOG  ---------------------------(OL)
  COMMAND ===>                                                    SCROLL===> CRSR
  SHOW LIMIT ON ==>                                          DATE 020200 - 020200
  DATE   TIME   JOBNAME  ------------------- M E S S A G E ----------------------
  020200 144714 CONSOLE   D T
  020200 144714 CONSOLE   D T
  020200 144714 CONSOLE   D T
  020200 144714 CONSOLE   IEE136I LOCAL: TIME=14.47.14 DATE=2000.157  GMT: TIME=
  020200 144721 RESOLVE   AMTRP1I FOLLOWING REPLYS OUTSTANDING FOR   5 MINUTES
  020200 144721 RESOLVE   AMTRP2I NETVIEW  *12 DSI802A CNM01    REPLY WITH VALID
  020200 144751 TSO       LOGON
  020200 144751 TSO       LOGON
  020200 144756           626 ICH408I USER(M06C    ) GROUP(        ) NAME(???
  020200 144756           626   LOGON/JOB INITIATION - USER AT TERMINAL
  020200 144759 M06C      627 ICH408I USER(M06C    ) GROUP(        ) NAME(???
  020200 144759 M06C      627   LOGON/JOB INITIATION - USER AT TERMINAL L3042
  020200 144759 JES2      $HASP100 M06C     ON TSOINRDR
  020200 144759 M06C      $HASP373 M06C     STARTED
  020200 144800 M06C      IEF125I M06C - LOGGED ON - TIME=14.48.00
  020200 144814 CONSOLE   D T
  020200 144814 CONSOLE   D T
  020200 144814 CONSOLE   D T
  020200 144814 CONSOLE   IEE136I LOCAL: TIME=14.48.14 DATE=2000.157  GMT: TIME=
  CMDS: SHOW, SHPF, ALL, LIMIT, LOCATE, TRACE, WRAP, SWAP                14.48.54

Table 54 shows the fields of the Default display type, with explanations of each field.

Table 54 Fields of Default Display Type (D)

Display Type V (Zebra)

The Zebra display type (indicated by <V> in the top line of the screen) is the same as the D display type, except that the displayed lines alternate between blue and white for easier reading. For more information, see Display Type D (Default).

Display Type O (Operator Display)

Figure 37 is an example of the Operator display type (indicated by <O> in the top line of the screen) for the Automation Log screen.

Figure 37 Automation Log Screen Operator Display Type (O)

  -------------< O >------------- AUTOMATION LOG  ---------------------------(OL)
  COMMAND ===>                                                    SCROLL===> CRSR
  SHOW LIMIT ON ==>                                          DATE 020200 - 020200
  TIME   JOBNAME  T-JOBID ------------------ M E S S A G E ----------------------
  144714 CONSOLE  S 00000  D T
  144714 CONSOLE  S 00000  D T
  144714 CONSOLE  S 00000  D T
  144714 CONSOLE  S 00000  IEE136I LOCAL: TIME=14.47.14 DATE=2000.157  GMT: TIME
  144721 RESOLVE  S 09268  AMTRP1I FOLLOWING REPLYS OUTSTANDING FOR   5 MINUTES
  144721 RESOLVE  S 09268  AMTRP2I NETVIEW  *12 DSI802A CNM01    REPLY WITH VALI
  144751 TSO      S 09295  LOGON
  144751 TSO      S 09295  LOGON
  144756          T 00000  626 ICH408I USER(M06C    ) GROUP(        ) NAME(???
  144756          T 00000  626   LOGON/JOB INITIATION - USER AT TERMINAL
  144759 M06C     T 00000  627 ICH408I USER(M06C    ) GROUP(        ) NAME(???
  144759 M06C     T 00000  627   LOGON/JOB INITIATION - USER AT TERMINAL L3042
  144759 JES2     T 14699  $HASP100 M06C     ON TSOINRDR
  144759 M06C     T 14699  $HASP373 M06C     STARTED
  144800 M06C     T 14699  IEF125I M06C - LOGGED ON - TIME=14.48.00
  144814 CONSOLE  S 00000  D T
  144814 CONSOLE  S 00000  D T
  144814 CONSOLE  S 00000  D T
  144814 CONSOLE  S 00000  IEE136I LOCAL: TIME=14.48.14 DATE=2000.157  GMT: TIME
  COMMANDS: ALL , LIMIT , LOCATE , SHOW , SHPF , SWAP , TRACE , WRAP     11.23.24

Table 55 Fields of Display Type Operator (O)

Display Type A (All Fields)

Figure 38 is an example of the All Fields display type (indicated by <A> in the top line of the screen) for the Automation Log screen.

Figure 38 Automation Log Screen All Fields Display Type (A)

  -------------< O >------------- AUTOMATION LOG  ---------------------------(OL)
  COMMAND ===>                                                    SCROLL===> CRSR
  SHOW LIMIT ON ==>                                          DATE 020200 - 020200
  TIME   JOBNAME  T-JOBID ------------------ M E S S A G E ----------------------
  144714 CONSOLE  S 00000  D T
  144714 CONSOLE  S 00000  D T
  144714 CONSOLE  S 00000  D T
  144714 CONSOLE  S 00000  IEE136I LOCAL: TIME=14.47.14 DATE=2000.157  GMT: TIME
  144721 RESOLVE  S 09268  AMTRP1I FOLLOWING REPLYS OUTSTANDING FOR   5 MINUTES
  144721 RESOLVE  S 09268  AMTRP2I NETVIEW  *12 DSI802A CNM01    REPLY WITH VALI
  144751 TSO      S 09295  LOGON
  144751 TSO      S 09295  LOGON
  144756          T 00000  626 ICH408I USER(M06C    ) GROUP(        ) NAME(???
  144756          T 00000  626   LOGON/JOB INITIATION - USER AT TERMINAL
  144759 M06C     T 00000  627 ICH408I USER(M06C    ) GROUP(        ) NAME(???
  144759 M06C     T 00000  627   LOGON/JOB INITIATION - USER AT TERMINAL L3042
  144759 JES2     T 14699  $HASP100 M06C     ON TSOINRDR
  144759 M06C     T 14699  $HASP373 M06C     STARTED
  144800 M06C     T 14699  IEF125I M06C - LOGGED ON - TIME=14.48.00
  144814 CONSOLE  S 00000  D T
  144814 CONSOLE  S 00000  D T
  144814 CONSOLE  S 00000  D T
  144814 CONSOLE  S 00000  IEE136I LOCAL: TIME=14.48.14 DATE=2000.157  GMT: TIME
  COMMANDS: ALL , LIMIT , LOCATE , SHOW , SHPF , SWAP , TRACE , WRAP     11.23.24

Table 56 shows the fields of the A Display type, with explanations of each.

Table 56 Fields of Display Type A (All Fields)

Display Type B (Debug)

Figure 39 is an example of the Debug display type (indicated by <B> in the top line of the screen) for the Automation Log screen.

Figure 39 Automation Log Screen Debug Display Type (B)

FuLTER:                      -> AUTOMATION LOG SMF=OS35 <--------< B >-----(OL)
COMMAND ===>                                                    SCROLL===> CRSR
 SHOW/SEARCH ON =>                                          DATE 110401 - 110401
 DATE   TIME   JOBNAME   ------------------ M E S S A G E ----------------------
 110401 090655 E4WGATE   CTWG91W OPEN ACB FAILED. APPLID=ECSLU01A ACBERFLG=58  
    JOBSTEP  GATEWAY    PROCSTEP E4WGATE  JOBID   14333    ASID    00071 JTYPE S
    ID       CTWG91W    TYPE     M        MULTILN R                            
    SYSTEM   OS35       SMFID    OS35     CONSOLE INTERNAL CONID   000         
    HANDLED  Y          SUPPRESS N        CTO     N        RULESEC NONE IOADMIN
    REC.TYPE S          J3FLG    F        SPEC             ENVIR.  000         
    REPLY    0000       HCID              DESC    0000     MCSF    C000        
    ROUTE    80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00                   
    WRAP IOA 0265       W.EXT 0265        RBA  00221E      EV.COUNT 144328     
                                                                               
 110401 090655 E4WGATE   CTWG74I PROBABLE CAUSE: ACB HAS ALREADY BEEN OPENED   
    JOBSTEP  GATEWAY    PROCSTEP E4WGATE  JOBID   14333    ASID    00071 JTYPE S
    ID       CTWG74I    TYPE     M        MULTILN R                            
    SYSTEM   OS35       SMFID    OS35     CONSOLE INTERNAL CONID   000         
    HANDLED  Y          SUPPRESS N        CTO     N        RULESEC NONE IOADMIN
    REC.TYPE S          J3FLG    F        SPEC             ENVIR.  000         
    REPLY    0000       HCID              DESC    0000     MCSF    C000        
    ROUTE    80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00                   
    WRAP IOA 0265       W.EXT 0265        RBA  00221F      EV.COUNT 144329     
 COMMANDS: ALL  LIMIT  LOCATE  SHOW  SHPF  SWAP  TRACE  WRAP  AUTO  '/' 09.08.28

The Debug display type is intended for use in solving problems that cannot be solved without contacting Customer Support. In this case, a list of the Automation Log using this display type should be sent to your BMC Customer Support.

Fields in the Debug (B) Display Type

The B display type displays most of the fields shown in the A display type, together with several additional fields with contents that can be of use to Customer Support. For more information, refer to "Fields of Display Type A (All Fields)" in Display Type A (All Fields).

The additional fields for use by Customer Support are

• WRAP.IOA

• W.EXT

• RBA

• EV.COUNT

Commands of the Automation Log Screen

In addition to the DISPLAY (DI) command explained in Changing Display Types, the following commands can be specified in the COMMAND field of the Automation Log screen.

Table 57 Commands of the Automation Log Screen

Figure 40 Automation Log Screen SWAP Option Window

FILTER:            ----------> AUTOMATION LOG SMF=OS35 <--------< D >------(OL)
COMMAND ===>                                                    SCROLL===> CRSR
SHOW LIMIT ON ==>                                          DATE 120900 - 120900
DATE   TIME   JOBNAME   ------------------ M E S S A G E ----------------------
120900 151928 A60AS     -A60AS    JOB SERVICE TOTALS        1589       03.63  
120900 151928 INIT      ICH70001I M26C     LAST ACCESS AT 14:38:27 ON TUESDAY,
120900 151928 A60AS     $HASP395 A60AS    ENDED                               
120900 151929 Esssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss+
120900 151929 ×                                                               |
120900 151929 ×   DSN or SMF s>                                               |
120900 151929 ×                                                               |
120900 151929 Dsssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss+
120900 151930 N86       -                                        CPU (TOTAL)  
120900 151930 N86       -JOBNAME  STEPNAME PROCSTEP    RC    I/O HH:MM:SS.TH  
120900 151931 N86       -N86      NONCAT2  CONTROLR    00    157       00.15  
120900 151931 N86       -N86      STEP1                00      0       00.02  
120900 151931 N86       IEF404I N86 - ENDED - TIME=15.19.31                   
120900 151931 N86       -                                                     
120900 151931 N86       -N86      JOB SERVICE TOTALS         157       00.17  
120900 151931 N86       $HASP395 N86      ENDED                               
120900 151931 A60GATEW  -                                        CPU (TOTAL)  
120900 151931 A60GATEW  -JOBNAME  STEPNAME PROCSTEP    RC    I/O HH:MM:SS.TH  
120900 151931 A60GATEW  -A60GATEW IOAGATE  GATEWAY     00   1866       02.97  
COMMANDS: ALL  LIMIT  LOCATE  SHOW  SHPF  SWAP  TRACE  WRAP  AUTO  '/' 15.21.08

Figure 41 Automation Log Screen MVS Command Window

FILTER:            ------------- AUTOMATION LOG  --------------< D >-------(OL)
COMMAND ===>                                                         L===> CRSR
SHOW LIMIT ON ==>                                          DATE 140800 - 140800
DATE   TIME   JOBNAME   ------------------ M E S S A G E ----------------------
140800 162223 M60TROLM  CTM262W 0009 UNSUCCESSFUL ATTEMPTS TO READ JOB DATA BY
140800 162224 V51GATE   ECAPUT: USER N16      ASSIGNED TO ASID 01. SIID 162439
140800 162224 D51AS     CTDS15I USER N16      LOGGED IN                       
140800 162228 D51   +---------------------------------------------------------+
140800 162229 K26   |                                                         |
140800 162231 D51   |  CMD -->                                                |
140800 162232 M52   |      -->                                                |
140800 162232 M52   |                                                         |
140800 162232 M52   +---------------------------------------------------------+
140800 162232 M60TROLM  CTM262W 0012 UNSUCCESSFUL ATTEMPTS TO READ JOB DATA BY
140800 162234 M52       IEA631I  OPERATOR M52      NOW INACTIVE, SYSTEM=OS35  
140800 162235 M60TROLM  CTMD50S READING JOB DATA BY IEFSSREQ FAILED 0013 TIMES
140800 162236 N03COMP   STEP LINKEDIT FOR  FRECMC   RC <= 0 .... OK      SYS=V
140800 162237 N03COMP   +EXT3MSG: CCID=BG0063   FUNCTION=GENERATE ELEMENT=FREC
140800 162237 N03COMP   +EXT3MSG:     ENVIRONMENT=IOA500   V504     IOA      L
140800 162238 D51AS     CTDS16I USER N16      LOGGED OUT. USED CPU TIME     0.
140800 162239 M52       IEA630I  OPERATOR M52      NOW ACTIVE,   SYSTEM=OS35  
140800 162239 M52                                                             
140800 162239 M52       IEE305I          COMMAND INVALID                      
COMMANDS: ALL  LIMIT  LOCATE  SHOW  SHPF  SMF  SWAP  TRACE  WRAP  AUTO 16.22.42

Figure 42 Operator Command Screen

---------< D >---------  CONTROL-O - Operator Command --------------------(OA)
COMMAND ===>                                                    SCROLL===> HALF
                          CONSOLE RESPONSE
---> D T
IEE136I LOCAL: TIME=08.48.25 DATE=2000.022  GMT: TIME=06.48.25 DATE=2000.022
====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
CMDS: SHPF, REFRESH(ENTER-KEY)                                        08.52.42

Filtering the Automation Log Screen Display

Screen filters can be used to filter the Automation Log screen display. A filter consists of a set of record selection criteria (selection fields and their values). Only records that conform to the selection criteria specified in the filter are displayed on the screen. The INCONTROL administrator can predefine filters and place them in the General profile.

There are two types of filters for the Automation Log screen: SHOW and SEARCH. You can use these filters together to display a specific set of records.

From the Automation Log screen, you can do any of the following:

• activate an existing filter using the SHOW or SEARCH command

• display the list of all available filters using the Display Filters window

• define multiple filters for the screen using the Automation Log Show Screen and Automation Log Search Screen windows

  User-defined filters belong to, are assigned names by, and can only be activated by, the user who defined them. They are stored in the User profile.

A predefined default SHOW filter, named DEFAULT, is provided for the Automation Log screen. Site-defined defaults determine whether the last filter used or the DEFAULT filter is activated when you reenter the Automation Log screen.

Activating an Existing Filter in the Automation Log screen

When you know the name of the filter, you can use either the SHOW or SEARCH command to activate an existing SHOW or SEARCH filter, respectively. To do this, specify the SHOW or SEARCH command in the COMMAND field as follows:

SHOW name

or

SEARCH name

In these commands, name is the name of the filter to be activated.

To activate the DEFAULT filter, specify DEFAULT as the name of the filter.

Display Filters Window

When you do not know the name of a filter, you can activate a filter from the list of available filters by opening the Display Filters window. This window displays the list of all available filters, which includes global filters that are available to all users, as well as user-defined filters that are only available to the individual user. You can activate a filter from the Display Filters window, or switch to the Automation Log Show Screen window or Automation Log Search Screen window, where you can edit or define a filter.

To enter the Display Filters window, type SHOW ? or SEARCH ? in the COMMAND field of the Automation Log screen and press Enter.

Figure 43 Automation Log Screen Display Filters Window

FILTER:            ------------- AUTOMATION LOG  --------------< D >-------(OL)
COMMAND ===>                                                    SCROLL===> CRSR
SHOW LIMIT ON ==>                                          DATE 290200 - 290200
DATE   TIME   JOBNAME   ------------------ M E S S A G E ----------------------
290200 141922 CONSOLE   141                                 THE DUMP          
290200 141922 CONSOLE   141         81 R 19.55.16 OS35     *81 DSI802A CNM01  
29020+-----------------------------------+                 NCCF SYSTEMOPERATO
29020|          DISPLAY FILTERS          |9.55.13 OS35     *80 ISTEXC200 -DYN
29020| CMD ==>           SCROLL==> CRSR  |                 ENTERED            
29020|  O NAME     DESCRIPTION           | IN BROADCAST DATA SET FOR MAIL     
29020|    CONSOLE  JNAME=CONSOLE         |                                    
29020|    NOSTC    NO STARTED TASKS      |                                    
29020|    CONSOL1                        |3 IS;U                              
29020|    CICS     CICS ONLY             |60,FD3286,SL,NOCOMP,FD3286,LOAD1,IOA
29020| =========>>> BOTTOM <<<========== |                       CPU (TOTAL)  
29020|                                   | PROCSTEP    RC    I/O HH:MM:SS.TH  
29020|                                   | C           04   2112       03.83  
29020|                                   | LINK1       04     54       00.10  
29020|                                   |RUN MODE CHANGED TO  N O R M A L DU
29020|                                   |             00    969       00.52  
29020|                                   | LINK2       08    884       00.42  
29020|  OPTIONS  S  SELECT  E  EDIT      | ENDED - TIME=14.19.43              
29020+-----------------------------------+                                    
COMMANDS: ALL  LIMIT  LOCATE  SHOW  SHPF  SWAP  TRACE  WRAP  AUTO      15.20.06

Fields of the Display Filters Window

The Display Filters window contains the following fields:

Table 58 Fields of the Display Filters Window

Options of the Display Filters Window

To request one of the following options, type the option in the OPT field to the left of the filter name and press Enter.

Table 59 Options of the Display Filters Window

Exiting the Automation Log Screen Filter Window

You can activate an edited filter with or without saving changes, depending on the value you specify in the SAVE field, as follows:

• To activate and save the filter, specify Y (Yes) in the SAVE field and press Enter. Changes to the filter are permanently saved, the filter is activated, and the window is closed.

• To activate the filter without saving it, specify N (No) in the SAVE field and press Enter. Changes are only kept in memory only, and the window is closed.

• To cancel changes made in the Automation Log Show Screen and the Automation Log Search Screen, use the RESET command (PF04/PF16). The changes are canceled regardless of the value specified in the Save field, the window is closed, and the filter that was previously in effect is restored.

By default, using the END command (PF03/PF15) in the window works like pressing Enter. However, the default can be modified so that END works like RESET.

Automation Log Show Screen and Automation Log Search Screen Windows

The Automation Log Show Screen and Automation Log Search Screen windows in the Automation Log screen enable you to create or modify a filter.

• To access the currently active filter for editing in either of these windows, open the appropriate window using the SHOW or SEARCH command in the COMMAND field, as follows:

  Copy

  SHOW (PF02/PF14)

  or

  Copy

  SEARCH

• To access any other filter for editing, open the appropriate window using the SHOW or SEARCH command in the COMMAND field, as follows:

  Copy

  SHOW name EDIT

  or

  Copy

  SEARCH name EDIT

  In these commands, name is the name of the filter to be displayed in the window.

• To create a new filter, specify the name of the new filter. To create a new filter from an existing filter, call up the existing filter in the Automation Log Show Screen window or Automation Log Search Screen window and edit it as desired, then enter a new name and description in the FILTER and DESC fields.

For more information about the Automation Log Show Screen window, see the following topic, "Automation Log Show Screen and Automation Log Search Screen Windows."

Automation Log Show Screen Window

Figure 44 Automation Log Show Screen Window

FILTER: +-----------------  AUTOMATION LOG SHOW SCREEN --------------------(OL)
COMMAND | FILTER CICS       SAVE Y (Y/N)  DESC: CICS ONLY                     |
SHOW LI | ID                                                                  |
DATE    | JNAME cics*                                                         |
290200  | JOBID                                                               |
290200  | SYSTEM                                                              |
290200  | USERID                                                              |
290200  | CONSOLE                                                             |
290200  | CONID                                                               |
290200  | MCSF                                                                |
290200  | DESC                                                                |
290200  | ROUTE                                                ROUTE FFFF Y   |
290200  | TSO STC JOB MVS CICS IMS MSG CMD LOG TRACE SHOUT SMS SYSOUT OMG     |
290200  |  Y   Y   Y   Y   Y    Y   Y   Y   Y   Y     Y     Y   Y      Y      |
290200  | ENVIRONMENT                                                         |
290200  | SUPPRESSED     Y   |   NOT SUPPRESSED   Y                           |
290200  | HANDLED        Y   |   NOT HANDLED      Y                           |
290200  | REISSUED       Y   |   NOT REISSUED     Y                           |
290200  | REPLY  CONTROLO  MULTILINE                                          |
290200  | ONLY     ONLY      ONLY                                             |
290200  |   N        N         N                                              |
290200  +---------------------------------------------------------------------+
290200 143323 CONSOLE   798                                      PGN=005  DMN=
COMMANDS: ALL  LIMIT  LOCATE  SHOW  SHPF  SWAP  TRACE  WRAP  AUTO      15.19.19   

The Automation Log Show Screen window contains the fields shown in Table 60.

Table 60 Fields of the Automation Log Show Screen Window

The fields in Table 61 define the selection criteria to be applied to the screen. Specify the appropriate selection criteria.

Table 61 Selection Criteria of the Automation Log Show Screen Window

Automation Log Search Screen Window

Figure 45 shows the Automation Log Search Screen Window.

Figure 45 Automation Log Search Screen Window

FILTER:                      -> AUTOMATION LOG SMF=OS35 <--------< D >-----(OL)
COMMAND ===>                                                    SCROLL===> CRSR
SHOW/SEARCH ON => SEARCH                                   DATE 080701 - 080701
DATE   TIME   JOBNAME   ------------------ M E S S A G E ----------------------
080701 122933 I03       V 075,CONSOLE                                         
080701 +------------  AUTOMATION LOG SEARCH SCREEN --------------(OL)+        
080701 | FILTER CICS       SAVE   (Y/N)  DESC: CICS ONLY             |        
080701 |                                                             |ECIFICAT
080701 |  Logical   Character Range  Character             Boolean   |        
080701 |  Operator                   String                Operator  |        
080701 |            From      To                                     |        
080701 |  --------  -----     -----  --------------------  --------  |ECIFICAT
080701 |  EQ        001       128    CONSOLE               OR        | ARE NON
080701 |  EQ        001       003    CTO                             |OLE CTOP
080701 |                                                             | ARE NON
080701 |                                                             |        
080701 |                                                             |OLE CTOP
080701 |                                                             |TROL-O S
080701 +------------------------------------------------------------ +TROL-O S
080701 123025 CONSOLE   CTO282I TEST NUMERO 3 DE MESSAGES POUR     CONTROL-O S
080701 123025 CONSOLE   CTO282I TEST NUMERO 4 DE MESSAGES POUR     CONTROL-O S
080701 123025 CONSOLE   CTO282I TEST NUMERO 5 DE MESSAGES POUR     CONTROL-O S
080701 123025 CONSOLE   CTO282I TEST NUMERO 21 DE MESSAGES POUR     CONTROL-O 
080701 123025 CONSOLE   CTO282I TEST NUMERO 22 DE MESSAGES POUR     CONTROL-O 
080701 123025 CONSOLE   CTO282I TEST NUMERO 23 DE MESSAGES POUR     CONTROL-O 
080701 123026 CONSOLE   CTO282I TEST NUMERO 24 DE MESSAGES POUR     CONTROL-O 
080701 123026 CONSOLE   CTO282I TEST NUMERO 25 DE MESSAGES POUR     CONTROL-O 
COMMANDS: ALL  LIMIT  LOCATE  SHOW  SHPF  SWAP  TRACE  WRAP  AUTO  '/' 18.47.07

The Automation Log Search Screen window contains the fields shown in Table 62.

Table 62 Fields of the Automation Log Search Screen Window

The following fields define the logical (Boolean) relations to be applied to the screen. Up to five logical relations can be specified. Only records that match all relations are displayed.

Table 63 Logical relations of the Automation Log Search Screen Window

Character Range Interpretation

The character range values defined by the From and To fields vary depending on the logical operator they are used with, as follows.

• For logical operators LT, GT, LE, and GE, the From and To values specify the exact first and last positions of the substring that is the first member of a logical relation.

  For example, to display only messages from the $HASP200 and $HASP400 interval, use the following logical relations:

  Copy

  Logical   Character Range  Character            Boolean
  Operator                   String               Operator
  
            From      To
  
  --------  -----     -----  --------------------  --------
  
  LT        001       008    $HASP400              AND
  
  GT        001       008    $HASP200

• For logical operators EQ and NE, the From and To values limit the search to a substring within a string.

  For example, to display all strings that contain the substring "$HASP," use the following logical relation:

  Copy

  EQ        001       128    $HASP

Swap Option Window

The SWAP Option window is used to swap between different versions of the Automation Log (that is, between the currently displayed log and a previous log that was backed up using the CTOALOCP utility).

Entering SWAP in the COMMAND field of the Automation Log screen opens the Swap Option window, which is shown in Figure 46.

Figure 46 Swap Option Window

-------------< D >------------- AUTOMATION LOG  ---------------------------(OL)
COMMAND ===>                                                    SCROLL===> CRSR
SHOW LIMIT ON ==>                                          DATE 020200 - 020200
DATE   TIME   JOBNAME  ------------------- M E S S A G E ----------------------
020200 144714 CONSOLE   D T
020200 144714 CONSOLE   D T
020200 144714 CONSOLE   D T
020200 144714 CON   +---------------------------------------------------------+
020200 144721 RES   |                                                         |
020200 144721 RES   |  DSN -->                                                |
020200 144751 TSO   |                                                         |
020200 144751 TSO   +---------------------------------------------------------+
020200 144756           626 ICH408I USER(M06C    ) GROUP(        ) NAME(???
020200 144756           626   LOGON/JOB INITIATION - USER AT TERMINAL
020200 144759 M06C      627 ICH408I USER(M06C    ) GROUP(        ) NAME(???
020200 144759 M06C      627   LOGON/JOB INITIATION - USER AT TERMINAL L3042
020200 144759 JES2      $HASP100 M06C     ON TSOINRDR
020200 144759 M06C      $HASP373 M06C     STARTED
020200 144800 M06C      IEF125I M06C - LOGGED ON - TIME=14.48.00
020200 144814 CONSOLE   D T
020200 144814 CONSOLE   D T
020200 144814 CONSOLE   D T
020200 144814 CONSOLE   IEE136I LOCAL: TIME=14.48.14 DATE=2000.157  GMT: TIME=
CMDS: SHOW, SHPF, ALL, LIMIT, LOCATE, TRACE, WRAP, SWAP                15.46.16

Type the name of an Automation Log data set in the DSN field and press Enter to request the change and close the window. The specified data set is displayed.

If the DSN field is left blank, the default operational Automation Log is displayed.

Search Limit Window

The Search Limit Window is opened automatically when a specified maximum number of records have been searched, and the number of records that match the selection criteria does not fill the screen. This maximum number of records can be specified with the LIMIT command. If a LIMIT is not specified, the default value is 1000 records.

Figure 47 Search Limit Window

-------------< D >------------- AUTOMATION LOG  ---------------------------(OL)
COMMAND ===>                                                    SCROLL===> CRSR
SHOW LIMIT ON ==>                                          DATE 020200 - 020200
DATE   TIME   JOBNAME  ------------------- M E S S A G E ----------------------
020200 122727 M81A      +CTD160I CONTROL-D RECIPIENT TREE LOADED -    127 RECI
020200 122735 TSO       LOGON
020200 122735 TSO       LOGON
020200 122737           771 ICH408I USER(M35A    ) GROUP(        ) NAME(???
020200 122737           771   LOGON/JOB INITIATION - USER AT TERMINAL
020200 122738 M35A      772 ICH408I USER(M35A    ) GROUP(        ) NAME(???
020200 122738 M35A      772   LOGON/JOB INITIATION - USER AT TERMINAL LX034
020200 122739 JES2      $HASP1 +----------------------------------------------+
020200 122739 M70A      D U,,, |                                              |
020200 122739 M70A      D U,,, |   NUMBER OF SEARCHED RECORDS:   001000       |
020200 122739 *MASTER*  775 IE |   NUMBER OF SELECTED RECORDS:   000010       |
020200 122739 *MASTER*  775 UN |                                              |
020200 122739 *MASTER*  775 46 |   PLEASE SELECT ONE OF THE FOLLOWING:        |
020200 122740 M35A      $HASP3 |                                              |
020200 122740 TSO       LOGON  |   1 - STOP SEARCH IMMEDIATELY                |
020200 122740 TSO       LOGON  |   2 - ASK AGAIN AFTER 000002 RECORDS         |
020200 122740 M35A      IEF125 |   3 - UNCONDITIONAL SEARCH                   |
020200 122741           779 IC |                                              |
020200 122741           779    +----------------------------------------------+
CMDS: SHOW, SHPF, ALL, LIMIT, LOCATE, TRACE, WRAP, SWAP                12.28.12

The window displays the number of records searched and the number of records that match the selection criteria for display.

To perform a search, select one of the following choices and press Enter:

3 - UNCONDITIONAL SEARCH

performs an uninterrupted search of all records.

The search is stopped immediately when you select Option 1.

2 - ASK AGAIN AFTER number RECORDS

searches the specified number of records, and then pauses.

• Continue the search by pressing Enter.

• Stop the search by selecting Option 1 (Stop Search Immediately).

If any records are found, the records are displayed.

When you first choose Option 2, you can change the search limit by changing the value in the Number of Records field.

During the search, the following information is displayed at the bottom of the window:

• the number of searched records
  Lists the cumulative number of records searched. For example, if you perform three searches with a specified number of 10, the figure displayed is30.

• the number of selected records
  Lists the cumulative number of records selected that match the search criteria for display.

MVS Operlog Display

The MVS Operlog is a log that contains the system logs of all computers in a Sysplex environment. The Operlog is an optional feature in a Sysplex environment.

When operating with the Operlog active in a Sysplex environment, the OS/39O Operlog can be viewed by issuing the OPER command from the Automation Log screen.

The screen shown in Figure 48 is displayed when the OPER command is issued from the Default display of the Automation Log screen.

Figure 48 MVS Operlog Display

------------------------------      OPERLOG     --------------< D >--------(OL)
COMMAND ===>                                                    SCROLL===> CRSR
SHOW LIMIT ON ==>                                          DATE 060600 - 060600
DATE   TIME   JOBNAME   ------------------ M E S S A G E  ---------------------
060600 103317 JES2      $HASP250 M80A PURGED -- (JOB KEY WAS AF9E8C1E)
060600 103317 JES2      $HASP250 M80 PURGED -- (JOB KEY WAS AF9F0955)
060600 103317 M80       $CT3879,OUTGRP=1.1.1
060600 103317 JES2      $HASP608 M80A     AWAITING PURGE            PRIO  1 AN
060600 103317 JES2      $HASP250 M80A PURGED -- (JOB KEY WAS AF9FC7E6)
060600 103317 M80       $CT3878,OUTGRP=2.1.1
060600 103317 JES2      $HASP608 M80      AWAITING PURGE            PRIO  1 AN
060600 103317 JES2      $HASP250 M80 PURGED -- (JOB KEY WAS AF9FC7E5)
060600 103744 RESOLVE   AMTSM2I SMF DATA SETS FULL-SMF NOT RECORDING, RUN SMF
060600 103744 RESOLVE   AMTSQ3I TOTAL ECSA 9680K, CURRENTLY USED 8312K ( 86%)
060600 103811 M80A      IEA995I SYMPTOM DUMP OUTPUT
060600 103811 M80A      SYSTEM COMPLETION CODE=0C4  REASON CODE=00000011
060600 103811 M80A       TIME=10.38.11  SEQ=00185  CPU=0000  ASID=003D
060600 103811 M80A       PSW AT TIME OF ERROR  078D2000   85AD87AE  ILC 4  INT
060600 103811 M80A         ACTIVE LOAD MODULE           ADDRESS=05AD6188  OFFS
060600 103811 M80A         NAME=IOATDRV
060600 103811 M80A         DATA AT PSW  05AD87A8 - 60004780  A0D2BFFF  6040478
060600 103811 M80A         GPR  0-3  000010A8  05B52CE8  05B68339  05B68778
060600 103811 M80A         GPR  4-7  05B68FFC  00000000  000C44C8  00000000
COMMANDS: ALL , LIMIT , LOCATE , SHOW , SHPF , SWAP , TRACE , WRAP     12.13.57

The Operlog screen contains many of the same fields as the Automation Log screen.

Most commands and display types that are available in the Automation Log screen are also available in the Operlog screen. However, the Debug display type and the TRACE, TRACE ONLY, SEARCH, and SWAP commands are not relevant for the Operlog screen.

For a description of the field commands and display types of this screen, see the description of the Automation Log screen above.

To exit the Operlog screen and return to the Automation Log screen, press PF03/PF15 (END).

Automation Options Facility

The Control-O Automation Options facility provides a set of operator productivity tools that facilitate operation of the system and access to automation data. The facility allows selection of functions that display, modify or act upon IOA components or system components.

To display the Automation Options menu, which is shown in Figure 49, type OA on the IOA Primary Option menu and press Enter.

Figure 49 Automation Options Menu

-----------------------  CONTROL-O AUTOMATION OPTIONS  -------< D >--------(OA)
COMMAND ===>                                                    SCROLL===> CRSR
O OPTION                         DESCRIPTION
  COMMAND   Enter Console Command
  CONSOLE   Display Contents of MVS Consoles
  ENQINFO   Display Enqueue Information
  GLOBALS   Display CONTROL-O Global AutoEdit Variables
  OPERATOR  Operator Commands and Responses
  SAMPLES   Examples of Automation Options Implementation
  SERVERS   CONTROL-O Servers Status Screen
  SUBSYS    List MVS Subsystems
====== >>>>>>>>>>>>>>>    NO MORE ENTRIES IN THE LIST    <<<<<<<<<<<<<<< ======
   
   
   
   
   
   
   
   
   
   
   
SELECT AN OPTION AND PRESS ENTER                                       15.36.53

A list of automation options is displayed. Select an option by specifying S (Select) to the left of the desired option and pressing Enter.

Options supplied with the product are described in the following pages. Additional options can be added by the customer, and the hierarchy of screens can be customized. For a full description on how to add and modify options, see the INCONTROL for z/OS Administrator Guide.

To return to the IOA Primary Option menu, press PF03/PF15 (END).

The COMMAND Option

The COMMAND option enables the operator to issue MVS operator commands, or VM commands if MVS is operating under VM, from non-console terminals.

To issue such a command from any terminal under which Control-O is active, specify S (Select) to the left of the COMMAND option in the Automation Options menu and press Enter. The window shown in Figure 50 is opened.

Figure 50 Automation Options OPTION Command Window

--------< D >--------  CONTROL-O - AUTOMATION OPTIONS  -------------------(OA)
COMMAND ===>                                                    SCROLL===> CRSR
O OPTION                     DESCRIPTION
S COMMAND    Enter Console Command
  CONSOLE    Display Contents of MVS Console
  ENQ +--------------------------------------------------------------------+
  GLO |                                                                    |
  OPE |                      Please Enter Parameters                       |
  SAM |                                                                    |
  SER |   Command       ===>                                               |
  SUB |                 ===>                                               |
===== |                                                                    |===
      +--------------------------------------------------------------------+
   
   
   
   
   
   
   
   
   
   
Select an OPTION and press ENTER                                       17.07.45

Specify the desired MVS or VM command in the COMMAND field of the window. Beginning with the first COMMAND field line, you can specify up to 44 characters in each of the two lines, as necessary.

Press Enter. The command is executed, and the Operator Command screen, containing the results, is displayed.

Operator Command Screen

The Operator Command screen is displayed after specifying an MVS or VM command using the COMMAND option in the Automation Options facility. The screen displays the results of the specified MVS or VM command.

Figure 51 Operator Command Screen

---------< D >---------  CONTROL-O - Operator Command --------------------(OA)
COMMAND ===>                                                    SCROLL===> HALF
                          CONSOLE RESPONSE
   ---> D T
IEE136I LOCAL: TIME=08.48.25 DATE=2000.022  GMT: TIME=06.48.25 DATE=2000.022
====== >>>>>>>>>>>>>>>   NO MORE ENTRIES IN THE LIST     <<<<<<<<<<<<<<< ======
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
CMDS: SHPF, REFRESH(ENTER-KEY)                                        08.52.42

The following information is displayed on the screen:

• The command, as entered, is displayed on the first one or two lines.

• The console response, as it would appear had the operator specified the command from the console, is displayed on subsequent lines.

The CONSOLE Option

The CONSOLE option displays an image of an MVS console on the screen. The console be selected by console ID or by console name (in MVS/SP4).

To display a console image on the screen, type S (Select) to the left of the CONSOLE option in the Automation Options menu and press Enter. The window shown in Figure 52 is opened.

Figure 52 Automation Options CONSOLE Option Window

--------< D >--------  CONTROL-O - AUTOMATION OPTIONS  -------------------(OA)
COMMAND ===>                                                    SCROLL===> CRSR
O OPTION                     DESCRIPTION
  COMMAND    Enter Console Command
S CONSOLE    Display Contents of MVS Console
  ENQ +--------------------------------------------------------------------+
  GLO |                                                                    |
  OPE |                      Please Enter Parameters                       |
  SAM |                                                                    |
  SER |   Console ID   ===>  01                                            |
  SUB |   Console Name ===>                                                |
===== |                                                                    |===
      +--------------------------------------------------------------------+
   
   
   
   
   
   
   
   
   
   
Select an OPTION and press ENTER                                      06.55.37

Specify the console with the image that should be displayed by typing either a console ID or a console name (but not both) in the window and pressing Enter. The default is Console ID=01. The Console Display screen is displayed.

Console Display Screen

The Console Display screen displays the image of the console selected through the CONSOLE option in the Automation Options facility. Since the screen displays the same image as the console, only one display type is defined, namely the D (Default) display type.

The Console Display screen is shown in Figure 53.

Figure 53 Console Display Screen

--------< D >--------  CONTROL-O CONSOLE Display       -------------------(OA)
COMMAND ===>                                                    SCROLL===> HALF
                                   Console Lines
         @STC20411 *38 DSI802A CNM01    REPLY WITH VALID NCCF SYSTEM OPERATOR
         @ COMMAND
         @JOB20501 *45 IEC301A S JOB N01ANSKL,STEP SORT    ,DDNAME SORTOUT
         @JOB20528 *IEF233A M 460,FD1466,,FD1466,COPY,CTT.INSTCTT
        - JOB20538  IEF404I M56FREP - ENDED - TIME=12.21.41
        - JOB20545  $HASP373 M56FREP  STARTED - INIT  2 - CLASS A - SYS ESA1
          JOB20161  $HASP608 M23ASREP AWAITING PURGE            PRIO  1 ANY
          TSU19909  $HASP608 M23A     AWAITING PURGE            PRIO  1 ANY
          JOB20213  $HASP608 M23ASREP AWAITING PURGE            PRIO  1 ANY
          JOB20214  $HASP608 M23ASREP AWAITING PURGE            PRIO  1 ANY
          JOB20282  $HASP608 M23TSCBT AWAITING PURGE            PRIO  1 ANY
          JOB20318  $HASP608 M23COPYX AWAITING PURGE            PRIO  1 ANY
          JOB20321  $HASP608 M23AEX   AWAITING PURGE            PRIO  1 ANY
          JOB20413  $HASP608 M23XCTB  AWAITING HARDCOPY         PRIO  1 ANY
          JOB20413  $HASP608 M23XCTB  AWAITING HARDCOPY         PRIO  1 ANY
          JOB20405  $HASP608 M23COPYX AWAITING PURGE            PRIO  1 ANY
                    IKJ574I   NO SPACE IN BROADCAST DATA SET FOR MAIL
      00  JOB20524  MIM1038 M78ASMNR CONTENTION WITH M78B OWNS SHR  ON ESA
          JOB20524  MIM1039 M78ASMNR NEEDS EXCL SYSDSN   CTMW.WORKD.SIMOAJF
         @JOB20524 *MIM1040 M78ASMNR WAITING FOR RESOURCES FOR 6 MINUTES
CMDS: SHPF, REFRESH, AUTO                                             12.22.12

The ENQINFO Option — Enqueue Information

The ENQINFO option is used to display ENQ (Enqueue) information, that is, information on who is holding a resource and who is waiting for a resource. You can specify selection criteria to limit the type and amount of ENQ information displayed.

Type S (Select) to the left of the ENQINFO option on the Automation Options menu and press Enter. The window shown in Figure 54 is opened. It contains selection criteria.

Figure 54 Automation Options ENQINFO Option Window

--------< D >--------  CONTROL-O - AUTOMATION OPTIONS  -------------------(OA)
COMMAND ===>                                                    SCROLL===> CRSR
 O OPTION                     DESCRIPTION
   COMMAND    Enter Console Command
   CONSOLE    Display Contents of MVS Console
 S ENQ +--------------------------------------------------------------------+
   GLO |                                                                    |
   OPE |                      Please Enter Parameters                       |
   SAM |                                                                    |
   SER |   Request        ==> CONFLICT                                      |
   SUB |   Scope          ==> ALL                                           |
 ===== |   Qname (Major)  ==>                                               |===
       |   Rname (Minor)  ==>                                               |
       |   Rname cont.    ==>                                               |
       |   Jobname        ==>                                               |
       |   Timing (Y/N)   ==> N                                             |
       |                                                                    |
       +--------------------------------------------------------------------+
   
   
   
   
   
Select an OPTION and press ENTER                                      07.27.14

Initial values are specified for the fields that are mandatory. The selection criteria can be changed by specifying new values and pressing Enter.

Available selection criteria are shown in Table 64.

Table 64 Selection Criteria of the ENQINFO Option Window

Change parameters, if desired, and press Enter to close the window. The ENQ Information screen is displayed.

ENQ Information Screen

The ENQ Information screen displays the selected enqueue information.

Up and down scrolling conventions are supported.

Two predefined display types (described in the following paragraphs) are available for the ENQ Information screen.

Changing Display Types

While in the ENQ Information screen, the display type can be changed using the DISPLAY command. The format of the command is DISPLAY x. In this command, x is the identifying letter for the desired type. DISPLAY can be abbreviated to DI.

Display Type D (Default)

Figure 55 ENQINFO Option Display Type D (Default)

------< D >-------  CONTROL-O - ENQ Information - Option=S ---------------(OA)
COMMAND ===>                                                    SCROLL===> CRSR
    O JOBNAME STA TYP SCOPE   QNAME    RNAME
      M56FCMP  O   E  SYSTEM  SYSDSN   CTW.TEST.FD1211.SRC
      M56FCMP  O   E  SYSTEM  SYSDSN   CTDW.WORKD.PRMUSR
      SMS      O   S  SYSTEM  SYSDSN   SYS1.DFSMS.ACDS
      W3PGATE  O   S  SYSTEM  SYSDSN   IOAP.TEST.NSN
      I4ZSMON  O   E  SYSTEMS IOAZ410  DEVICE.460
      M06C     O   S  SYSTEM  SYSDSN   CTDW.WORKD.ATF
      M56FCMP  O   E  SYSTEM  SYSDSN   M31.UNDEL100.ASM
      M4WTROLM O   S  SYSTEM  SYSDSN   CTMW.WORKD.CKP
      M06C     O   S  SYSTEM  SYSDSN   CTMW.WORKD.CKP
      M56FCMP  O   E  SYSTEM  SYSDSN   CTT.TLMSAG.EARL
      EDDTROLD O   S  SYSTEM  SYSDSN   EDD.TEST.COM
      EDDPRINT O   S  SYSTEM  SYSDSN   EDD.TEST.COM
      LLA      O   S  SYSTEM  SYSDSN   SYS2.LINKLIB
      M06C     O   S  SYSTEM  SYSDSN   IOAW.WORKI.MSG
      M56FCMP  O   E  SYSTEM  SYSDSN   M54.VSAM.FILE1
      M56FCMP  O   E  SYSTEM  SYSDSN   CTOW.WORKO.GLB.CPUESA1
      M00      O   S  SYSTEM  SYSDSN   SYS2.EXEC
      M42B     O   S  SYSTEM  SYSDSN   SYS2.EXEC
      M80      O   S  SYSTEM  SYSDSN   SYS2.EXEC
      N38      O   S  SYSTEM  SYSDSN   SYS2.EXEC
CMDS: SHPF, REFRESH                                                   15.52.05

Fields in the Default (D) Display Type

The information shown in Table 65 is displayed.

Table 65 Fields of the ENQ Information Screen Display Type D (Default)

Display Type A (All Fields)

Figure 56 shows an example of the All Fields display type for the ENQ Information screen. This display type is requested by typing the DISPLAY A command (abbreviated DI A) in the COMMAND field of the screen.

Figure 56 Example of the ENQ Information All Fields Display Type (A)

------< A >-------  CONTROL-O - ENQ Information - Option=S ---------------(OA)
COMMAND ===>                                                    SCROLL===> CRSR
     O JOBNAME  QNAME    RNAME
       M19A     SPFEDIT  M19A.ISPF.ISPPROF                           ISREDRT
           STATUS   O  ASID  0194 TYPE     E             SCOPE     SYSTEMS
           RANGE    L             SYSNAME  ESA1          WAIT TIME 00000000
           HELD BY
   
       M19A     SPFEDIT  M19A.ISPF.ISPPROF                           ISREDIT
           STATUS   O  ASID  0194 TYPE     E             SCOPE     SYSTEMS
           RANGE    L             SYSNAME  ESA1          WAIT TIME 00000000
           HELD BY
   
       M19      SPFEDIT  CTO.WORK.SRC                                CTOTAOP
           STATUS   O  ASID  0072 TYPE     E             SCOPE     SYSTEMS
           RANGE    L             SYSNAME  ESA1          WAIT TIME 00000000
           HELD BY
   
       M19      SPFEDIT  CTO.WORK.SRC                                CTOTCSE
           STATUS   O  ASID  0072 TYPE     E             SCOPE     SYSTEMS
           RANGE    L             SYSNAME  ESA1          WAIT TIME 00000000
           HELD BY
   
CMDS: SHPF, REFRESH                                                   15.55.58

Fields in the All Fields (A) Display Type

The information shown in Table 66 is displayed.

Table 66 Fields of the ENQ Information Screen Display Type A (All Fields)

Commands of the ENQ Information Screen

Table 67 Commands of the ENQ Information Screen

The GLOBALS Option

The GLOBALS option displays the values of Control-O Global AutoEdit variables. Variables can be selected for display by either their individual name or mask, or by pool name or mask.

To select variables for display, type S (Select) to the left of the GLOBALS option in the Automation Options menu and press Enter. The window shown in Figure 57 is opened.

Figure 57 Automation Options GLOBALS Option Window

--------< D >--------  CONTROL-O - AUTOMATION OPTIONS  -------------------(OA)
COMMAND ===>                                                    SCROLL===> CRSR
O OPTION                     DESCRIPTION
  COMMAND    Enter Console Command
  CONSOLE    Display Contents of MVS Console
  ENQ +--------------------------------------------------------------------+
S GLO |                                                                    |
  OPE |                      Please Enter Parameters                       |
  SAM |                                                                    |
  SER |   VARIABLE MASK ===> *                                             |
  SUB |   POOLID        ===> $GLOBAL                                       |
===== |   SYSTEM NAME   ===> CURRENT                                       |===
      +--------------------------------------------------------------------+
   
   
   
   
   
   
   
   
Select an OPTION and press ENTER                                      08.20.50

The window contains the required fields shown in Table 68. Default values are displayed.

Table 68 Fields of the GLOBALS Option Window

For more information about the XAE facility, see Using an XAE AutoEdit Variable Database.

Change the default values, if desired, and press Enter. The Globals Display screen is displayed.

Globals Display Screen

The Globals Display screen displays the values of Control-O Global AutoEdit variables selected through the GLOBALS option in the Automation Options facility. Two predefined display types (described in the following sections) are available for the Globals Display screen.

Changing Display Types

While in the Globals Display screen, the display type can be changed using the DISPLAY command. The format of the command is

DISPLAY x

In this command, x is the identifying letter for the desired type. DISPLAY can be abbreviated to DI.

Display Type D (Default)

Figure 58 is an example of the Default display type for the Globals Display screen.

Figure 58 Example of the GLOBALS Option Default Display Type (D)

-----------< D >-------  CONTROL-O - Global Variables  -------------------(OA)
COMMAND ===>                                                    SCROLL===> HALF
      NAME                           VALUE
      USER_RULER                     ----+----1
      STATUS_CICS                    ACTIVE   123418 000406
      INIT_NUM                       20
      STATUS_IDMS                    ACTIVE
      SMFID_IDMS                     SYS2
      CTO_RELOAD_DONE                000406
      ABEND_COUNT                    2
      CICS_NAME                      CICSTEST
      USER_RULER2                    ----+----1----+----2----+----3----+----4----+-
      DTAPE_TIME                     141723 000410
      DEVNAME_3400                   TAPE
      DEVNAME_3490                   CART
      DEVNAME_348S                   CART
      RESNAME_TAPE                   TAPE
      RESNAME_CART                   CART
      DEV_1                          TAPE
      DEV_2                          CART
      DEV_O_TAPE                     0
      DEV_T_TAPE                     0
      DEV_O_CART                     0
CMDS: SHPF, REFRESH                                                   10.08.08

Fields in the Default (D) Display Type

The fields in the GLOBALS option Default display type (D) are shown in Table 69.

Table 69 Fields of the GLOBALS Option Display Type D (Default)

Display Type A (All Fields)

Figure 59 shows an example of the All Fields display type for the Globals Display screen. This display type is requested by typing the DISPLAY A command (abbreviated DI A) in the COMMAND field of the screen.

Figure 59 Example of the GLOBALS Option Display Type A (All Fields)

   -----------< A >-------  CONTROL-O - Global Variables  -------------------(OA)
  COMMAND ===>                                                    SCROLL===> HALF
    NAME                           POOLID   VALUE
    USER_RULER1                    $GLOBAL  ----+----1
    STATUS_CICS                    $GLOBAL  ACTIVE   123418 000606
    INIT_NUM                       $GLOBAL  20
    STATUS_IDMS                    $GLOBAL  ACTIVE
    SMFID_IDMS                     $GLOBAL  SYS2
    CTO_RELOAD_DONE                $GLOBAL  000606
    ABEND_COUNT                    $GLOBAL  2
    CICS_NAME                      $GLOBAL  CICSTEST
    USER_RULER2                    $GLOBAL  ----+----1----+----2----+----3----+----4----+-  
    DTAPE_TIME                     DEVICES  141723 000606
    DEVNAME_3400                   DEVICES  TAPE
    DEVNAME_3490                   DEVICES  CART
    DEVNAME_348S                   DEVICES  CART
    RESNAME_TAPE                   DEVICES  TAPE
    RESNAME_CART                   DEVICES  CART
    DEV_1                          DEVICES  TAPE
    DEV_2                          DEVICES  CART
    DEV_O_TAPE                     DEVICES  0
    DEV_T_TAPE                     DEVICES  0
  CMDS: SHPF, REFRESH                                                   10.28.57

Fields in the All Fields (A) Display Type

The fields of the Globals display screen are shown in Table 70.

Table 70 Fields of the GLOBALS Option Display Type A (All Fields)

Commands of the Globals Display Screen

The commands of the Globals display screen are shown in Table 71.

Table 71 Commands of the GLOBALS Option Display Screen

The OPERATOR Option

The OPERATOR option displays a submenu of preset operator commands. Upon selection of a preset command, the Operator Command screen is displayed with the results of the preset command. For more information on the Operator Command screen, see The COMMAND Option.

The SAMPLES Option

The SAMPLES option contains a series of sample automation options that demonstrate how customized automation options can be used to activate other facilities.

The SERVERS Option

The SERVERS option displays the statuses of all or selected Control-O servers. Control-O servers are started tasks that facilitate DO TSO, DO KSL, and DO SHELL requests issued by Control-O rules. For more information about Control-O servers, see Control-O Servers.

To display the status of servers, type S (Select) to the left of the SERVERS option in the Automation Options menu and press Enter. The window illustrated in Figure 60 is opened.

Figure 60 Automation Options SERVERS Option Window

--------< D >--------  CONTROL-O - AUTOMATION OPTIONS  -------------------(OA)
COMMAND ===>                                                    SCROLL===> CRSR
O OPTION                     DESCRIPTION
  COMMAND    Enter Console Command
  CONSOLE    Display Contents of MVS Console
  ENQ +--------------------------------------------------------------------+
  GLO |                                                                    |
  OPE |                      Please Enter Parameters                       |
  SAM |                                                                    |
S SER |   SERVER ID     ===> ALL                                           |
  SUB |   SERVER TYPE   ===>                                               |
 =====|                                                                       |==
      +--------------------------------------------------------------------+
   
   
   
   
   
   
   
   
   
SELECT AN OPTION AND PRESS ENTER                                      11.17.06