Online Facilities

This chapter includes the following topics:

• Overview of Online Facility

• IOA Features

• Scheduling Definition Facility

• Tracking and Control Facility

• CMEM Rule Definition Facility

• IOA Variables Database Facility

• Condition and Resource Handling Facility

• IOA Log Facility

• IOA Calendar Facility

• Defining a Regular/Periodic Calendar

• Defining Rule-Based Calendars

• Exiting the IOA Calendar Facility

• Utilities Under ISPF

• Workload Management Facility

Overview of Online Facility

The following pages describe the main features available under 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)

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: Installing.

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 INCONTROL for z/OS Installation Guide: Customizing.

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 in order 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

When INCONTROL products are activated from a screen with extended seven-color support, they make extensive use of the color attributes of the screen. The concept of management by color is emphasized in INCONTROL screens.

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.

If a field supports prefixing, this fact is indicated in its description.

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.

If a field supports masking, this fact is indicated in its description.

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 2 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-M is installed at your site, and you are authorized to access all functions and facilities, the following screen is displayed:

Figure 3 IOA Primary Option Menu Where Only Control-M Is Installed

---------------------       IOA PRIMARY OPTION MENU       ------------------(1)
OPTION ===>                                               USER        N22A     
                                                          DATE        19.08.18 
                                                                               
                                                                               
                                                                               
                                                                               
  2   JOB SCHEDULE DEF      CTM Job Scheduling Definition                      
  3   ACTIVE ENV.           CTM Active Environment Display                     
  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                  
  W   WORKLOAD MANAGEMENT   CTM Workload Management                            
                                                                               
                                                                               
                                                                               
COMMANDS:  X - EXIT, HELP, INFO, SET  OR CHOOSE A MENU OPTION          17.59.32

To select an option, type the option number or letters 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.

Certain IOA commands, 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 18.

Table 18 INCONTROL Shared IOA Functions and Facilities

The following commands, functions, and facilities (options) are applicable to Control-M:

Table 19 Control-M Functions and Facilities

The following IOA Primary Option menu is displayed at sites supporting all currently available INCONTROL mainframe products.

Figure 4 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        
& Control-M/JCL Verify                                                      
  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 
 JD  JCL VERIFY DEFAULTS    BA  RULE ACTIVITY          TC  CHECK IN EXT VOL 
 JV  JCL VERIFICATION                                                       
 JR  JCL VERIFY RULES                                                       
                                                                            
                                                                            
COMMANDS:  X - EXIT, HELP, INFO, SET  OR CHOOSE A MENU OPTION          16.20.21

Additional options that are available on the IOA Primary Option Menu only when additional INCONTROL products are installed are listed in the following series of tables. For a description of the options for other INCONTROL products, see the user guides of the respective products.

Table 20 Control-M/JCL Verify Functions and Facilities

Table 20a Control-D and Control-V Functions and Facilities

Table 20b Control-M/Analyzer Functions and Facilities

Table 20c Control-O Functions and Facilities

Table 20d Control-M/Tape Functions and Facilities

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 5.

The Information window provides the following basic information about the installed INCONTROL products:

• Name of each product or component

• Compatibility mode version of the product, as set during installation or upgrade

• Security status, whether Active or Inactive

In addition, the following basic system information is displayed:

• The unique IOA QNAME of the current environment

• IOA TRAN-ID

• Security Product name

• Logged-on USER-ID

• User-selected language

• OS type and version

• System SMF-ID, name, and date

• CPU ID

To exit the Information window and return to the IOA Primary Option menu, press Enter or END (PF03/PF15).

Figure 5 IOA Version Information

 ---------------------       IOA PRIMARY OPTION MENU       ------------------(1)
 OPTION ===>                                               USER        U05      
       +------------------------------------------------------------------+     
 IOA   |          IOA Version  9.0.18.100  Information and Status         |     
       |                                                                  |     
   4  C|                           Running Mode Security                  |     
   5  L|    IOA                       9.0.18    Active                    |     
   6  U|    CDAM                      9.0                                 |     
   7  M|    IOAGATE                   9.0.18                              |     
   8  C|    CONTROL-M                 9.0.18    Active                    |     
  IV  V|    CONTROL-M/Restart         9.0                                 |     
       |    CONTROL-M/JCL Verify      9.0                                 |     
       |    CONTROL-M/Analyzer        9.0       Active                    |     
       |    CONTROL-M/Tape            9.0       Active                    |     
 Contro|    CONTROL-D                 9.0.18    Active                    |     
 & Cont|    CONTROL-V                 9.0                                 |     
   2  J|    CONTROL-O                 9.0       Active                    |     
   3  A|                                                                  |     
   C  C|    IOA QNAME  IOAR900   TRAN-ID            Sec.Prod. RACF        |N    
   W  W|    USER-ID    U05       LANGUAGE ENG       OS  z/OS    02.01.00  |B    
  JD  J|    SMF-ID     MVS8      SYSTEM NAME  MVS8                        |L    
  JV  J|    DATE       14.06.18  CPUID 02CE07 2965                        |     
  JR  J|                                                                  |     
       +------------------------------------------------------------------+     
                                                                                
                                                                                
                                                                                
                                                                                
 COMMANDS: X - EXIT, HELP, INFO, SET OR CHOOSE A MENU OPTION            13.53.32

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 by the IOA Primary Option menu at your site.

Each transfer control command consists of an equal 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 21 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 by 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. The example used in this section is the IOA Log screen.

Table 22 Basic IOA Screen Areas

Figure 6 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, table, 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 23 Common PFKey Definitions

To see the PFKey assignment of the screen with which you are working, type reserved command SHPF in the command line and press Enter. A window describing the current PFKey assignment appears on the screen. Press Enter again to close the window.

Figure 7 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.

Two additional key definitions are:

Table 24 Additional Key Assignments

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

Scrolling Commands

Scrolling conventions are very similar to the ISPF conventions of IBM. Two basic commands are used for scrolling:

Table 25 Scrolling Commands

The 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:

Table 26 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.

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

where 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]

where:

• 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 A The Control-M Application Program Interface. 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 8 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

where 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. Two ISPF commands must be defined to PFKeys:

Table 27 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.

Under ISPF, IOA Option 6 activates the Online Utilities panel, which is described in IOA Online Utilities Menu. 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 9.

Figure 9 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|                                                              |          
& Con+--------------------------------------------------------------+          
  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    
 JD  JCL VERIFY DEFAULTS    BA  RULE ACTIVITY          TC  CHECK IN EXT VOL    
 JV  JCL VERIFICATION                                                          
 JR  JCL VERIFY RULES                                                          
                                                                               
                                                                               
COMMANDS:  X - EXIT, HELP, INFO, SET  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 10.

Figure 10 IOA Editor

----------------------------  I O A   E D I T O R   ------------------- (EDMEM) 
COMMAND ===>                                                    SCROLL===> CRSR
ROW     PROD.V900.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 28:

Table 28 PFKey Functions Within the IOA Editor Screen

Commands of the IOA Editor Screen

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

Table 29 IOA Editor Command Line Commands

Table 30 describes editing commands that can be executed by entering the command in the left-most position of the applicable row.

Table 30 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 set the representation for certain special characters ($ and \) that will be used in online screens for profile variables. Enter SET in the command line of any screen to display the SET Command Panel window, as shown in Figure 11.

Figure 11 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')           |
|                        BACKSLASH   Current representation is "\"(X'E0')           |
|                                                                                   |
| FILL IN PARAMETERS AND PRESS ENTER TO CONTINUE OR PF3 TO EXIT                     |
+-----------------------------------------------------------------------------------+    

More detailed instructions appear in the following topics:

• Using the SET Command Panel to set and end TRACE Levels

• Using the SET Command Panel to set Language preferences

• Using the SET Command Panel to set the representation of special characters

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:

   Copy

   CTMA2AI TRACE LEVEL nnn WAS SET xxx

   where

   • 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 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:

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

Using the SET Command Panel to set the representation of special characters

Setting the representation of the dollar sign and backslash sign influences how profile variables are shown in online screens.

The following steps explain how to set the representation of these special characters:

1. Type a $ character in the Dollar field using your keyboard, and then press Enter.

2. Type a \ character in the BACKSLASH field using your keyboard, and then press Enter.

After each time that you press enter, the following message is displayed at the top of the screen:

CTMA2DI THE NEW {DOLLAR | BACKSLASH} REPRESENTATION IS "c"(X'yy')

where

• c is the character that you set, either $ or \

• yy is the EBCDIC hexadecimal code for the character
  Note that there are differences in the EBCDIC hexadecimal code for these special characters on keyboards that have been adapted to show local or national symbols.
  The default values (based on standard English keyboards) are 5B for the dollar sign and E0 for the backslash sign.

IOA TSO Command Processor Screen

The IOA TSO Command Processor screen can be entered only when the IOA Online facility is activated as a TSO application. It cannot be entered when the IOA Online facility is activated as an ISPF application or activated under a non-TSO environment.

The TSO screen enables activation of any TSO command without exiting the IOA Online facility. For example, a typical program activated under the TSO screen is ISPF. Therefore all ISPF/PDF facilities and functions, such as editing a member or scanning job output, can be activated while you are working under the IOA Online facility.

To activate a TSO command, type the command in the COMMAND field and press Enter.

Figure 12 IOA TSO Command Processor Screen

--------------- IOA TSO COMMAND PROCESSOR ----------------------(6)
COMMAND ===> ISPF                                                  




















PLEASE ENTER TSO COMMAND                                    15.32.52

TSO commands can also be activated directly from any IOA online screen by typing TSO in the COMMAND field.

Transfer of Control Between the TSO Application and the IOA Online Facility

You can return to the IOA Online facility from the TSO application by simply exiting the TSO application in a normal manner. However, this method can be time consuming and inconvenient if an ISPF application or a similar TSO application is activated.

If the TSO application can issue a TSO command, it is possible to transfer control to the IOA Online facility, and vice versa, without exiting the TSO application.

While working under the TSO application, for example, under ISPF, issue the command:

TSO CTMTTRA {n | =n}

where n is the online screen number.

The requested screen is displayed as it was when you transferred from it.

To return to the TSO application, use the =6 command (PF06/PF18). The application remains in the same state as when you transferred from it.

It is recommended that you simplify transfer between screens by permanently assigning one of your PFKeys under ISPF (or SDSF, and so on) to the command TSO CTMTTRA. Once this key assignment is made, you no longer need to type the full transfer command. Instead, you merely type the IOA option number or code in the COMMAND field and press the assigned PFKey. You are transferred to the desired screen.

Scheduling Definition Facility

The Control-M Scheduling Definition facility enables you to create, view, or modify scheduling definitions for the jobs in your environment. A scheduling definition consists of parameters that correspond to the decisions and actions of the operator when handling the scheduling, submission, and post-processing of a job or set of jobs.

The job scheduling definition for a job needs to be defined only once. After the job definition is defined, the definition is saved and used as necessary for managing job processing. Job scheduling definitions can be modified or deleted as required.

Job scheduling definitions are stored in members called tables. Any number of tables can be defined, and each table can contain any number of job scheduling definitions.

In many production environments, related applications are scheduled together as a unit. In these cases, it is common to store job scheduling definitions of all related applications in members called SMART Tables, and to define scheduling parameters for the set of jobs. This is accomplished by defining the scheduling parameters in the SMART Table Entity.

Tables (members) are stored in scheduling libraries. You can define any number of scheduling libraries. The number of tables in a library, the number of scheduling definitions in a table, and the size of each scheduling definition, are all calculated dynamically.

Accessing the Scheduling Definition Facility

The Scheduling Definition facility contains the following screens:

Table 31 Scheduling Definition Facility Screens

To enter the Scheduling Definition facility, select option 2 on the IOA Primary Option menu. The Scheduling Definition Facility entry panel is displayed.

Handling of Tables

A set of jobs whose processing (for example, scheduling, submission, and post processing) is handled as a unit, is defined in a SMART Table. This table must be created as a SMART Table by selecting Y in the Scheduling Definition facility entry panel.

At the time of creation of a SMART Table, a scheduling definition for the set of jobs, called the SMART Table Entity, is created. The SMART Table Entity is used to define processing criteria for the set of jobs in the SMART Table. These include:

Table 32 Scheduling Criteria

The SMART Table Entity also contains a field (ADJUST CONDITIONS) that enables job dependencies based on prerequisite conditions to apply only if predecessor jobs in the SMART Table are scheduled.

Control-M internally tracks each SMART Table and the jobs in the SMART Table. Each order of each SMART Table is identified as a unit.

The status of each SMART Table that has been ordered can be viewed using option T (Table) of the Job Status screen (Active Environment screen).

By default, if jobs in a SMART Table have already begun execution and an IN condition for the SMART Table is deleted from the IOA Conditions file, this change does not affect the processing of the jobs in the SMART Table; the jobs continue execution as if all the IN conditions were still satisfied. This default is overridden if the TBLRECHK parameter in the CTMPARM member in the IOA PARM library is set to Yes, in which case IN conditions SMART Table Parameters are checked before each job is selected.

Creating Tables

Tables can be created in either of the following ways:

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

  The name of a new job scheduling definition for the new table can also be entered.

• by using the SELECT command to choose the new table name in the Table List screen and pressing Enter

  The name of a new job scheduling definition for the new table can also be entered.

  The SELECT command is described in Commands of the Table List Screen.

When you create a table (press Enter) using either of the above methods, a skeletal job scheduling definition is displayed in the Job Scheduling Definition screen. Fill in and save this job scheduling definition. The table is created and the job scheduling definition is the first and only job scheduling definition in the Job list of the table. As additional job scheduling definitions are created in the table (described below), they are added to the Job list.

When you create a SMART Table (press Y) using either of the above methods, a skeletal scheduling definition, SMART Table Entity, is displayed in the Scheduling Definition panel. Fill in and save this scheduling definition. As you add job scheduling definitions to the table (described below), they are added to the Job list.

Valid values are:

• Y (Yes) – empty SMART Tables may be created

• N (No) – empty SMART Tables may not be created. All SMART Tables must be created with at least one job scheduling definition. Default.

When PTBLEMPT=Y, the SMART Table is created and only the SMART Table Entity is in the Job List of the SMART Table. Adding a job scheduling definition to this SMART Table is described in Creating Job Scheduling Definitions.

When PTBLEMPT=N, a skeletal job scheduling definition is displayed in the Job Scheduling Definition screen. Fill in and save this job scheduling definition. The SMART Table is created and the SMART Table Entity and the job scheduling definition are in the Job list of the SMART Table. As additional job scheduling definitions are created in the SMART Table (described below), they are added to the Job list.

Under ISPF, tables can also be created using the M5 online utility. This method is described in M5: Quick Schedule Definition, and is not included in this discussion.

Creating Job Scheduling Definitions

Job scheduling definitions can be created using two basic methods:

• A skeletal job scheduling definition can be created by typing the name of a new job scheduling definition in the entry panel. The table specified in the entry panel can be either a new table if PTBLEMPT=N or an existing table if PTBLEMPT=Y. In this case, virtually all fields of the job scheduling definition are empty.

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

Performing Operations on Tables and Jobs

Many operations can be performed on tables and on the job scheduling definitions in them. These operations are performed through commands and options in the various screens of the Scheduling Definition facility.

Some of the major operations possible within the facility are described in the following pages. Options and commands that have not yet been explained are explained in detail following the summary.

Accessing (Editing or Browsing) a Table and Its Jobs

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

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

Browsing, however, has advantages:

• Access and exit are quicker than in editing.

• Job lists and job scheduling definitions that are in use by another user can be viewed.

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

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

Entering 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, either access is granted in Browse mode or access is not granted.

Accessing the JCL of a Job

When IOA is activated under ISPF, the member containing the JCL of a job can be accessed by the JCL command in the Job List screen. Whether the member can be modified and updated depends on whether the Job List screen was accessed in Browse or Edit mode.

Copying a Job to Another Table

Jobs can be copied from one table to another by the COPY option in the Job List screen. For more information, see Options of the Job List Screen.

Deleting a Table or a Job

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

Displaying Jobflow in Graphic Format

The job flow of jobs in a table can be displayed in graphic format by the GRAPHIC FLOW option in the Table List screen. For more information, see Displaying Graphic Jobflow.

Displaying Job Statistics

The statistics for a job can be displayed by performing any of the following:

• Typing S (STAT) next to the job name in the Active Environment screen.

• Typing T (JOBSTAT) next to the job name in the Job List screen.

• Typing the primary command JOBSTAT in the Job Scheduling Definition screen (or the Active Environment screen).

Manually Scheduling Jobs

Manually ordering a job results in the job being scheduled only if its basic scheduling criteria are satisfied. Manually forcing a job results in its being scheduled even if its basic scheduling criteria are not satisfied.

• To manually order all the jobs in a table, type O (ORDER) for the table in the Table List screen. Multiple tables can be ordered.

• To manually force all the jobs in a table, type F (FORCE) for the table in the Table List screen. Multiple tables can be forced.

• To manually order specific jobs in a table, type O (ORDER) for the jobs in the Job List screen.

• To manually force specific jobs in a table, type F (FORCE) for the jobs in the Job List screen.

For more information, see Ordering.

Displaying the Schedule Plan of a Job

The schedule of a job for a specified period of time, based on the basic scheduling criteria of the job, can be displayed in calendar format by PLAN option in the Job List screen. For more information, see Displaying a Job Scheduling Plan.

Simulating the action of the Control-M submission mechanism for a job

A job's JCL member can be tested for proper auto-edit resolution by typing % (AutoEdit simulation) next to the job name in the Job List screen, or next to the job name in the Active Environment screen (after the job is ordered). For more information, see the % option in Table 35 and Table 58.

Saving Modifications

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

Entry Panel

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

Figure 13 Control-M Scheduling Definition Facility - Entry Panel

----------- CONTROL-M SCHEDULING DEFINITION FACILITY - ENTRY PANEL ---------(2)
 COMMAND ===>                                                                 
                                                                              
                                                                              
                                                                              
 SPECIFY LIBRARY, TABLE, JOB                                                  
                                                                              
    LIBRARY ===> CTM.PROD.SCHEDULE                                            
    TABLE   ===>                     (Blank for table selection list)         
    JOB     ===>                     (Blank for job selection list)           
                                                                              
    SMART TABLE (new tables only) ===>   (Y - for new SMART Table)            
                                                                              
                                                                              
                                                                              
                                                                              
 SHOW JOB DOCUMENTATION   ===> N     (Y/N)                                    
 AUTO-SAVE DOCUMENTATION  ===> N     (Y/N)                                    
                                                                              
                                                                              
                                                                              
USE THE COMMAND SHPF TO SEE PFK ASSIGNMENT                             23.00.04

To open the desired display, fill in Entry Panel fields LIBRARY, TABLE, and JOB as described below. To create a table do one of the following:

• Press Enter to create a table that will handle jobs individually

• Press Y to create a table which will apply scheduling definitions to the set of jobs in the table as a unit (SMART Table).

If you are not creating a new table, the SMART Table field is ignored and all tables are displayed.

Type Y (Yes) or N (No) in the SHOW JOB DOCUMENTATION field to determine whether job documentation lines appear when the Job Scheduling Definition screen is displayed. Type Y (Yes) or N (No) in the AUTO-SAVE DOCUMENTATION field to determine whether changes made to documentation are automatically saved when updating the job scheduling definition.

This procedure describes how to display the list of tables in a library.

Begin

1. Type the library name.

2. Either leave the table name blank, or type part of a table name together with mask characters (* and ?).

3. Press Enter.

This procedure describes how todisplay the list of jobs of a specific table.

Begin

1. Type the library name.

2. Type the table name.

3. Press Enter.

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

This procedure describes how to display the details of a specific job (Job Scheduling Definition screen).

Begin

1. Type the library name.

2. Type the table name.

3. Type the job name.

4. Press Enter.

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

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

This procedure describes how to display the Search Window (described below).

Begin

1. Type the library name.

2. Type the job name.

3. Either leave the table name blank, or type part of a table name together with mask characters (* and ?).

4. Press Enter.

This procedure describes how to create a new table.

Begin

1. Type a new table name.

2. Type the table type.

3. Press Enter.

   The Job Scheduling Definition screen, for defining the first job in the new table, is displayed.

Search Window

The Search window enables you to search for the specified job in tables in the specified library. Tables in which the job has been found are then displayed in the Table List screen.

Figure 14 Control-M Scheduling Definition Facility - Entry Panel Search Window

----------- CONTROL-M SCHEDULING DEFINITION FACILITY - ENTRY PANEL --------(2)
COMMAND ===>                                                                 
                                                                             
                                                                             
                                                                             
SPECIFY LIBRARY, TABLE, JOB                                                 
                                                                            
   LIBRARY ===> CTM.PROD.SCHEDULE                                           
   TABLE   ===>                     (Blank for table selection list)        
   JOB     ===> CTMCLRES            (Blank for job selection list)          
                               +------------------------------------------+ 
SMART TABLE          ===>      |                                          | 
                               |    PLEASE SELECT ONE OF THE FOLLOWING:   | 
                               |                                          | 
                               |    1  - STOP SEARCH IMMEDIATELY          | 
                               |    2  - ASK AGAIN AFTER 000010 TABLES    | 
SHOW JOB DOCUMENTATION   ===> N|    3  - UNCONDITIONAL SEARCH             | 
AUTO-SAVE DOCUMENTATION  ===> N|                                          | 
                               |    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 END (PF03/PF15).

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

3 – UNCONDITIONAL SEARCH

Searches all tables in the specified library.

The search continues uninterrupted unless and until you select Option 1 (Stop Search Immediately).

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. Default: 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. Lists the total number of tables in the specified library.

• Number of searched tables. Lists 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. Lists the cumulative number of tables selected that contain the job 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 displays a list of tables (members) in the specified library. This screen can be entered directly from the entry panel or upon exiting the Job 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 for each table name, as shown in the following screen example.

Figure 15 Control-M Scheduling Definition Facility Table List Screen

LIST OF TABLES IN CTM.PROD.SCHEDULE                            -------------(2)
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD  ID 
     ADABAS            01.00 01/02/14 01/06/12 00:50    70    70     0 O01 
     APPLNTN           01.00 01/02/14 01/06/12 00:50   180   180     0 O01 
     APPLPRDI          01.00 01/02/14 01/06/12 00:50    41    41     0 O01 
     ARCNIGHT          01.00 01/02/14 01/06/12 00:50     5     5     0 S07 
     ASMBTR1           01.00 01/02/14 01/06/12 00:50     9     9     0 S07 
     ASMBTR2           01.00 01/02/14 01/06/12 00:50    14    14     0 S07 
     BACKUP            01.00 01/02/14 01/06/12 00:50     5     5     0 S07 
     CICSJOBS          01.00 01/02/14 01/06/12 00:50    70    70     0 O01 
     CICSPROD          01.00 01/02/14 01/06/12 00:50   180   180     0 O01 
     CICSTEST          01.00 01/02/14 01/06/12 00:50    41    41     0 O01 
     CICSUPT           01.00 01/02/14 01/06/12 00:50     5     5     0 S07 
     CLIENTS           01.00 01/02/14 01/06/12 00:50     9     9     0 S07 
     DB2EXE            01.00 01/02/14 01/06/12 00:50    14    14     0 S07 
     DLOAD             01.00 01/02/14 01/06/12 00:50     5     5     0 S07 
     MAINDAY           01.00 01/02/14 01/06/12 00:50   180   180     0 O01 
     MAINT             01.00 01/02/14 01/06/12 00:50    41    41     0 O01 
     MAINTPL           01.00 01/02/14 01/06/12 00:50     5     5     0 S07 
     ONSPOOL           01.00 01/02/14 01/06/12 00:50     9     9     0 S07 
     ONSPOOLT          01.00 01/02/14 01/06/12 00:50    14    14     0 S07 
     OPERCLN           01.00 01/02/14 01/06/12 00:50     5     5     0 S07 
OPTIONS S SELECT  O ORDER  F FORCE  G GRAPHIC FLOW  B BROWSE  D DELETE 15.38.37

• 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 END (PF03/PF15).

Options of the Table List Screen

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

Table 33 Options of the Table List Screen

Commands of the Table List Screen

The following command can be entered in the COMMAND field of the Table List screen and pressing <ENTER>.

SELECT Command

The SELECT command can be used to create a new table in the library. The format of the command is:

SELECT tablename [SMART]

Type SELECT tablename SMART – For a table that will apply scheduling definitions to the set of jobs in the table as a unit.

If there are no jobs currently in the table, that is, the command is being used to create a new table, the Job List screen is not displayed. Instead, one of the following is displayed in the Jobs Scheduling Definition screen:

• A skeletal job scheduling definition.

• A skeletal table scheduling definition for the set of jobs in a SMART Table.

Job List Screen

The Job List screen displays the list of jobs in a table in a specified library. This screen can be entered directly from the entry panel or the Table List screen, or upon exiting from the Job Scheduling Definition screen.

If the S (Select) option was entered in the Table List screen for a table that is currently in use ("selected") by another user, either the Job List screen is not displayed and the Table List screen remains displayed (the default), or the Job List screen is displayed in Browse mode (if a user profile definition overrides the default). In either case, an appropriate message is displayed.

Figure 16 Control-M Scheduling Definition Facility Job List Screen

JOB LIST     LIB: CTM.PROD.SCHEDULE                             TABLE: BACKUP
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME ---  TYP --- DESCRIPTION -----  TABLE: TBLWK1 ----------------------
     STARTBKP   G  START OF DAILY BACKUP                                      
     BACKPL01   J  DAILY BACKUP OF DATA SETS FROM APPL-L                      
     BACKPL02   J  DAILY BACKUP OF SPECIAL FILES FROM APPL-L                  
     BACKPLW1   J  WEEKLY BACKUP OF FILES FROM APPL-L #1                      
     BACKPLW2   J  WEEKLY BACKUP OF FILES FROM APPL-L #2                      
     BACKPLW3   J  WEEKLY BACKUP OF FILES FROM APPL-L #3                      
     BACKPLW4   J  WEEKLY BACKUP OF FILES AFTER DAILY FROM APPL-L +           
     DASDRPT1   J  DASD REPORTS AFTER BACKUPS FOR APPL-L                      
     DASDRPT2   J  DASD STATISTICS REPORT AFTER BACKUP FOR APPL-L             
     ENDPLBKP   J  END OF BACKUP INDICATION FOR APPL-L                        
     BACKAC01   J  DAILY BACKUP OF DATA SETS FROM APPL-ACCOUNT                
     BACKAC02   J  DAILY BACKUP OF SPECIAL FILES FROM APPL-ACCOUNT            
     BACKACW1   J  WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #1                
     BACKACW2   J  WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #2                
     BACKACW3   J  WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #3                
     BACKACW4   J  WEEKLY BACKUP OF FILES AFTER DAILY FROM APPL-ACC +         
     DASDRPT3   J  DASD REPORTS AFTER BACKUPS FOR APPL-ACCOUNT                
     DASDRPT4   J  DASD REPORTS AFTER BACKUP FOR APPL-ACCOUNT                 
     ENDACBKP   J  END OF BACKUP INDICATION FOR APPL-ACCOUNT                  
     BACKDD01   J  DAILY BACKUP OF DATA SETS FROM APPL-DD                     
OPTIONS S SEL D DEL I INS O ORDER F FORCE J JCL C COPY P PLN T JOBSTAT 15.37.39

Format of the Job List Screen

Next to each job name in the Job list, certain information can be displayed. The type and format of this information depends on whether the screen is displayed in DESC format, in DATA format or in STAT format, and whether the list is displayed for a SMART Table, as follows:

• In DESC format, the description of the job, taken from the DESC field of the job scheduling definition, is displayed. Default.

• In DATA format, the application and table names of the job, taken from the APPL and TABLE fields of the job scheduling definition, are displayed.

• In STAT format, ISPF-like statistical information about the job is displayed.

• If the Job list is displayed for a SMART Table, the type of job scheduling definition is also displayed in the DESC, DATA, and STAT formats. Valid values are:

  • T: SMART Table Entity; this is always the first entry in the Job list of a SMART Table. (Type information is not displayed for tables defined to handle individual jobs.)

  • J: Job

By default, the job list is displayed in DESC format. To change formats, use the DESC, DATA or STAT commands, described below.

The order in which the jobs are displayed in the Job List screen can be sorted by the SORT command (described below).

Commands of the Job List Screen

The following commands can be entered in the COMMAND field of the Job List screen:

Table 34 Commands of the Job List Screen

Options of the Job List Screen

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

Table 35 Options of the Job List Screen

Job Scheduling Definition Screen – Defining Schedules

The Control-M Job Scheduling Definition screen is used to define, display and modify production parameters of a specific job. This screen can be entered directly from the entry panel or from the Job List screen. Update of parameters is not permitted in Browse mode.

Figure 17 Job Scheduling Definition Screen

JOB: BACKPL02 LIB CTM.PROD.SCHEDULE                             TABLE: BACKUP
COMMAND ===>                                                    SCROLL===> CRSR
+-----------------------------------------------------------------------------+
  MEMNAME BACKPL02     MEMLIB   CTM.PROD.JOBLIB
  OWNER   M44         TASKTYPE JOB    PREVENT-NCT2 Y DFLT  N
  APPL    APPL-L                      TBL BKP-PROD-L       RBC
  DESC    DAILY BACKUP OF SPECIAL FILES FROM APPL-L
  OVERLIB CTM.OVER.JOBLIB                                   STAT CAL
  SCHENV                         SYSTEM ID                  NJE NODE
  SET VAR
  CTB STEP AT         NAME            TYPE
  DOCMEM  BACKPL02    DOCLIB   CTM.PROD.DOC
  ===========================================================================
  SCHEDULE RBC
  RELATIONSHIP (AND/OR) O
  DAYS    ALL                                                   DCAL
                                                                     AND/OR
  WDAYS                                                         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       RETRO N MAXWAIT 00  D-CAT
  MINIMUM          PDS
  DEFINITION ACTIVE FROM          UNTIL
  ===========================================================================
  IN       START-DAILY-BACKUP   ODAT
  CONTROL
  RESOURCE INIT                 0001      CART                 0001
  PIPE     CTM.PROD.PIPE
  FROM TIME         +     DAYS    UNTIL TIME      +     DAYS
  DUE OUT TIME      +     DAYS    PRIORITY     SAC    CONFIRM
  TIME ZONE:
  ===========================================================================
  OUT      BAKCKPL02-ENDED-OK   ODAT +
  AUTO-ARCHIVE Y          SYSDB    Y      MAXDAYS      MAXRUNS
  RETENTION:  # OF DAYS TO KEEP      # OF GENERATIONS TO KEEP
  SYSOUT OP   (C,D,F,N,R)                                              FROM
  MAXRERUN      RERUNMEM                           INTERVAL         FROM
  STEP RANGE         FR (PGM.PROC)          .          TO          .
  ON PGMST          PROCST          CODES                               A/O
    DO
  ON SYSOUT                                          FROM 001 TO 132    A/O
    DO
  ON VAR
    DO
  SHOUT WHEN           TIME       +     DAYS     TO                  URGN
    MS
  ===========================================================================
  APPL TYPE                                  APPL VER
  APPL FORM                                  CM   VER
  INLINE JCL: N
======= >>>>>>>>>>>>>>>>>>> END OF SCHEDULING PARAMETERS <<<<<<<<<<<<<<<< =====
 COMMANDS: EDIT, DOC, PLAN, JOBSTAT                                    11.27.41

The job scheduling definition occupies more than one screen.

To delete a parameter on the screen, simply erase it with the EOF key or blank it out. If additional action is required, Control-M issues appropriate instructions.

Parameters of the Job Scheduling Definition Screen

The Job Scheduling Definition screen is divided into the following sections.

Table 36 Parameters of the Job Scheduling Definition Screen

These sections are divided by a delimiter line.

A brief description of all parameters in each section of the Job Scheduling Definition screen is provided on the following pages. A detailed explanation of these parameters is provided in Job Production Parameters.

General Job Parameters

Figure 18 General Job Parameters

 +-----------------------------------------------------------------+
 MEMNAME BACKPL02     MEMLIB   CTM.PROD.JOBLIB                      
 OWNER   M44          TASKTYPE JOB    PREVENT-NCT2 Y   DFLT  N      
 APPL    APPL-L                       GROUP BKP-PROD-L       RBC    
 DESC    DAILY BACKUP OF SPECIAL FILES FROM APPL-L                  
 OVERLIB CTM.OVER.JOBLIB                                  STAT CAL  
 SCHENV                           SYSTEM ID               NJE NODE  
 SET VAR                                                            
 CTB STEP AT           NAME            TYPE                         
 DOCMEM  BACKPL02      DOCLIB   CTM.PROD.DOC                        
 ===================================================================

Table 37 General Job Parameters

Basic Scheduling Parameters

Figure 19 Basic Scheduling Parameters - Job

 =============================================================================== 
SCHEDULE RBC                                                                 
RELATIONSHIP (AND/OR) O                                                      
DAYS                                                         DCAL            
                                                                   AND/OR    
WDAYS                                                        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       RETRO N MAXWAIT 04   D-CAT                      
MINIMUM          PDS                                                         
DEFINITION ACTIVE FROM          UNTIL                                        

Figure 20 Basic Scheduling Parameters - SMART Table Entity

 ===============================================================================
SCHEDULE RBC                                                  LEVEL TBL
DAYS                                                             DCAL        
                                                                     AND/OR  
WDAYS                                                            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 WORKDAYS SHIFT        MAXWAIT 04                                     
SCHEDULE RBC ACTIVE FROM         UNTIL                                       

Table 38 Basic Scheduling Parameters

Runtime Scheduling Parameters

Figure 21 Runtime Scheduling Parameters

 ==================================================================
IN       START-DAILY-BACKUP   ODAT                                 
CONTROL                                                            
RESOURCE INIT                 0001    CART                         
PIPE                                                               
FROM TIME         +     DAYS    UNTIL TIME      +     DAYS
DUE OUT TIME      +     DAYS    PRIORITY     SAC    CONFIRM
TIME ZONE:                                                  
===================================================================

Table 39 Runtime Scheduling Parameters

Post-Processing Parameters

Figure 22 Post-Processing Parameters

 ===================================================================
 OUT      BAKCKPL02-ENDED-OK   ODAT +                               
 AUTO-ARCHIVE Y          SYSDB   Y      MAXDAYS       MAXRUNS       
 RETENTION:  # OF DAYS TO KEEP     # OF GENERATIONS TO KEEP         
 SYSOUT OP   (C,D,F,N,R)                                      FROM  
 MAXRERUN      RERUNMEM             END-TABLE
 CAPTURE BY   (W - WORD / C - CHAR)
 CYCLIC TYPE: C                                  INTERVAL     FROM
 INTERVAL SEQUENCE: +         +         +         +         +         
 SPECIFIC TIMES:                                             TOLERANCE
                     +           +           +           +     
 STEP RANGE         FR (PGM.PROC)          .         TO      .      
 ON PGMST ANYSTEP  PROCST         CODES C0008  U0048            A/O 
   DO                                                               
 ON SYSOUT                                   FROM 001 TO 132    A/O
   DO                                                               
 ON VAR                                                             
   DO                                                               
 SHOUT WHEN          TIME       +     DAYS      TO             URGN
   MS 

Table 40 Post-Processing Parameters

DO Actions

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

DO COND – Add or delete a prerequisite condition.

ON PGMST UPDATE   PROCST          CODES S***   U****           A/O
     DO COND          PL-BACKOUT-REQUIRED    ODAT +               
     DO                                                           

DO CTBRULE – Invoke the Control-M/Analyzer Runtime environment and execute the specified Control-M/Analyzer rule, which performs the balancing operations defined in the rule on SYSDATA. Arguments can be passed to Control-M/Analyzer. Available only at sites in which Control-M/Analyzer is active.

ON PGMST ANYSTEP    PROCST          CODES OK                     A/O
      DO CTBRULE   = BALKPL   ARG DOREPORT,UPDATEDB               
      DO                                                          

DO FORCEJOB – Force (schedule) a job under Control-M.

ON PGMST   UPDATE   PROCST            CODES S***   U****       A/O
   DO FORCEJOB   TABLE  PLPROD    JOB PLBCKOUT  UFLOW N    DATE ODAT
                LIBRARY GENERAL    
   DO

§Restart§DO IFRERUN – Perform a restart under Control-M/Restart when the job is manually or automatically rerun. This DO action is available if you have Control-M/Restart installed at your site.

ON PGMST ANYSTEP    PROCST          CODES S0C1                   A/O
DO IFRERUN FROM GLSTEP01.GLPROC02 TO GLSTEP05 . GLPROC03 CONFIRM N
    DO

DO MAIL – Send an e-mail message to the specified recipients.

ON PGMST   UPDATE   PROCST         CODES C0000                 A/O
    DO MAIL                                                          
    TO   ACCT-SMITH                                                  
    CC                                                               
  SUBJ VERIFICATION                                                
  TEXT CHECK OK                                                    
    DO                                                              

DO NOTOK – Define the termination status of the job as NOTOK.

ON PGMST   UPDATE   PROCST          CODES C0004                A/O
    DO NOTOK                                                      
    DO                                                            

DO OK – Define the event within the job as OK.

ON PGMST ANYSTEP  PROCST        CODES C0008  U0048             A/O
    DO OK                                                         
    DO                                                            

DO REMEDY – Open a Remedy Help Desk ticket.

    ON PGMST STEP1    PROCST             CODES C0012            A/O
    DO REMEDY                                      URGENCY U
SUMM JOB %%JOBNAME ON NODE %%$NODEID ENDED WITH RETURN CODE %%COMPSTAT
DESC CONTROL-M JOB %%JOBNAME RUN %%RN ENDED ON NODE %%$NODEID RETURN 
      CODE %%COMPSTAT: APPLICATION: %%APPL, TABLE: %%TABLE

DO REMFORCE – Force one or more jobs under a remote Control-M.

     DO REMFORCE    CONTROL-M   MPM900            UFLOW N DATE 251214
TABLE table_name
JOB    jobname
LIBRARY
VAR    %%Var1=Value1
VAR    %%Var2=Value2

DO RERUN – Indicate that a job must be rescheduled for a rerun.

ON PGMST ANYSTEP    PROCST       CODES S0C1                       A/O
    DO IFRERUN    FROM GLSTEP01 . GLPROC02 TO GLSTEP05 . GLPROC03    CONFIRM N
     DO RERUN                                                          
     DO

DO SET – Assign a value to a Control-M AutoEdit variable.

ON PGMST ANYSTEP    PROCST        CODES C0008    U0048              A/O
     DO SET       VAR= %%RUNTYPE=CHK                                 
     DO                                                              

DO SHOUT – Message to be sent to specified location.

ON PGMST     UPDATE     PROCST           CODES S***    U****           A/O
    DO SHOUT     TO    OPER2              URGENCY R                   
     = A BACKOUT OF FILE-XXXX IS GOING TO RUN SOON                  
    DO SHOUT     TO    USER-DBA           URGENCY R                   
     = ABEND OF THE UPDATE STEP, PLEASE CHECK IT                      
    DO                                                              

DO STOPCYCL – Stop recycling a cyclic task.

ON PGMST ANYSTEP    PROCST         CODES >C0008                      A/O
    DO STOPCYCL                                                     
    DO                                                              

DO SYSOUT – Action to perform with the job sysout.

ON PGMST     UPDATE     PROCST         CODES S***    U****            A/O
    DO SYSOUT    OPT C PRM P                                    FRM 
    DO                                                             

Scheduling Definition for SMART Table Entities

A SMART Table Entity must be defined for each SMART Table before the job scheduling definitions in the table can be defined.

A skeletal scheduling definition for a SMART Table Entity is automatically displayed when creating a SMART Table.

The scheduling definition for a SMART Table Entity can also be entered directly from the Entry Panel or from the Job List screen.

The job scheduling definition for SMART Table Entities varies somewhat from the job scheduling definition for jobs.

The parameters of the SMART Table Entity are used to define basic scheduling criteria, runtime scheduling criteria, and post-processing actions to be performed, for the jobs in the SMART Table.

During New Day processing, if at least one set of basic scheduling criteria in the SMART Table Entity is satisfied, a copy of the SMART Table Entity is placed in the Active Jobs file, and the jobs in the SMART Table become eligible for scheduling.

The final status of the SMART Table Entity job order is assigned after all scheduled jobs in the SMART Table have been terminated. This SMART Table Entity status is determined by the execution results of those jobs:

• If all the scheduled jobs in the SMART Table ended OK, the SMART Table Entity is assigned an end status of OK.

• If at least one scheduled job in the SMART Table did not end OK, the SMART Table Entity is assigned an end status of NOTOK.

The performance of post-processing actions defined in the SMART Table Entity is directly affected by the end status of the SMART Table Entity.

Figure 23 SMART Table Entity Scheduling Definition Screen

TBL ACCOUNTS_TABLE       CTM.PROD.SCHEDULE(TBL)
COMMAND ===>                                                   SCROLL===> CRSR
+------------------------------------------------------------------------------+
|  TABLE  ACCOUNTS                GROUP ACCOUNTS_TABLE                         |
| OWNER   N04B                   TASKTYPE TBL                                  |
| APPL                                                                         |
| DESC                                                                         |
| ADJUST CONDITIONS N            TBL MAXWAIT             STAT CAL              |
| KEEP JOBS UNTIL REMOVED Y      KEEP AT LEAST 05 DAYS AFTER ENDED NOT OK      |
| SET VAR                                                                      |
| DOCMEM  ACCOUNTS    DOCLIB  CTM.PROD.DOC                                     |
| ============================================================================ |
| SCHEDULE RBC EVERYDAY                                  LEVEL TBL             |
| DAYS                                                         DCAL            |
|                                                                  AND/OR      |
| WDAYS                                                        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        MAXWAIT 00                                     |
| SCHEDULE RBC ACTIVE FROM          UNTIL                                      |
| ============================================================================ |
| SCHEDULE RBC                                           LEVEL                 |
|============================================================================= |
| IN                                                                           |
| CONTROL                                                                      |
| FROM TIME         +     DAYS    UNTIL TIME      +     DAYS                   |
| DUE OUT TIME      +     DAYS    PRIORITY     SAC    CONFIRM                  |
| TIME ZONE:                                                                   |
| ============================================================================ |
| OUT                                                                          |
| MAXRERUN                                                                     |
| CYCLIC TYPE: C                                  INTERVAL        FROM         |
| INTERVAL SEQUENCE: +        +         +         +         +                  |
| SPECIFIC TIMES:                                            TOLERANCE         |
|                       +           +           +          +           +       |
| ON TABLE-END NOTOK                                                           |
|   DO COND          ACCTS-CHK-REQUIRED   ODAT +                               |
| ON VAR                                                                       |
|   DO                                                                         |
| SHOUT WHEN           TIME       +     DAYS     TO                  URGN      |
|   MS                                                                         |
======  >>>>>>>>>>>>>>>>>>>>> END OF TABLE PARAMETERS <<<<<<<<<<<<<<<<<<< ======

The SMART Table Entity scheduling definition supports the same commands and PFKey conventions as any job scheduling definition.

Parameters of the SMART Table Entity Scheduling Definition Screen

The parameters of the SMART Table Entity scheduling definition are almost identical in appearance and usage as those in a regular job scheduling definition, which are described briefly in Parameters of the Job Scheduling Definition Screen.

Differences in the parameters of the SMART Table Entity scheduling definitions are described below.

Table 41 Parameters of the SMART Table Entity Scheduling Definition Screen

Parameters that can include AutoEdit variables

The following Scheduling parameters can include AutoEdit variables that will be resolved at order time:

• OWNER

• APPL

• GROUP

• SCHENV

• SYSTEM ID

• DOCMEM

• DOCLIB

• DO FORCEJOB

• DO REMOTE FORCE

• RESOURCE NAMES

• CONDITION NAMES

Commands of the Job Scheduling Definition Screen

The following commands can be entered in the COMMAND field of the Job Scheduling Definition screen.

Table 42 Commands of the Job Scheduling Definition Screen

If a string contains embedded spaces, enclose the string in apostrophes (') or quotation marks (").

To repeat a CHANGE command, press PF09/PF21.

Editing Job Scheduling Definitions in the Edit Environment

Job scheduling 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-M Edit environment.

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

Figure 24 Editing Job Scheduling Definitions in the Edit Environment Screen

JOB: BACKP02  LIB  CTM.PROD.SCHEDULE                           TABLE: BACKUP
COMMAND ===>                                                  SCROLL===> CRSR
+---------------------------------------------------------------------------+
__ MEMNAME BACKP02      MEMLIB   CTM.PROD.JOBLIB                             
__ OWNER   M44          TASKTYPE JOB         PREVENT-NCT2 Y    DFLT  N       
__ APPL    APPL-L                            TBL BKP-PROD-L        RBC       
__ DESC    DAILY BACKUP OF SPECIAL FILES FROM APPL-L                         
__ OVERLIB CTM.OVER.JOBLIB                                        STAT CAL   
__ SCHENV                           SYSTEM ID                     NJE NODE   
__ SET VAR                                                                   
__ CTB STEP AT                       NAME                           TYPE     
__ DOCMEM  BACKP02          DOCLIB   CTM.PROD.DOC                            
__ ==========================================================================
SCHEDULE RBC                                                                 
RELATIONSHIP (AND/OR) O                                                      
DAYS                                                         DCAL            
                                                                   AND/OR    
WDAYS                                                        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       RETRO N MAXWAIT 04   D-CAT                      
MINIMUM PDS                                                                  
DEFINITION ACTIVE FROM UNTIL                                                 
__ ==========================================================================
__ IN       START-DAILY-BACKUP   ODAT                                        
__ CONTROL                                                                   
COMMANDS: EDIT, DOC, PLAN, JOBSTAT                                   11.17.00

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

Editing commands are typed directly onto these underscores.

Specified Line Editing commands are processed when Enter is pressed.

Details and examples of the editing of job scheduling definitions in the Edit environment are provided inC Editing Job Scheduling Definitions in the Edit Environment.

Job Documentation

Display and Non-Display of Documentation

Depending on the value of the Show Job Documentation field in the scheduling facility entry panel, job documentation, in the form of DOC lines, is either displayed or hidden when you first enter the Job Scheduling Definition screen:

• If the Show Job Documentation field is set to Y, job documentation is displayed upon entry to the Job Scheduling Definition screen.

• If the Show Job Documentation field is set to N, documentation is hidden upon entry to the Job Scheduling Definition screen.

DOC Command

Within a table, the DOC command toggles (alternately displays and hides) the table. Within a job the DOC command toggles the job documentation.

Below is an example of the Job Scheduling Definition screen with the documentation (DOC lines) displayed.

Figure 25 Job Scheduling Definition DOC Lines

JOB: BACKPL02 LIB CTM.PROD.SCHEDULE                             TABLE: BACKUP
COMMAND ===>                                                  SCROLL===> CRSR
+---------------------------------------------------------------------------+
  MEMNAME BACKPL02    MEMLIB   CTM.PROD.JOBLIB                               
  OWNER   M44         TASKTYPE JOB    PREVENT-NCT2 Y   DFLT  N               
  APPL    APPL-L                      TBL BKP-PROD-L          RBC            
  DESC    DAILY BACKUP OF SPECIAL FILES FROM APPL-L                          
  OVERLIB CTM.OVER.JOBLIB                                      STAT CAL      
  SCHENV                          SYSTEM ID                    NJE NODE      
  SET VAR                                                                    
  CTB STEP AT          NAME            TYPE                                  
  DOCMEM  BACKPL02     DOCLIB   CTM.PROD.DOC                                 
  ===========================================================================
  DOC THIS JOB BACKS UP SPECIAL "L" FILES. IT PERFORMS THE FOLLOWING STEPS:  
  DOC 1:   VERIFY SPACE REQUIREMENTS                                         
  DOC 2-5: BACKUP THE FILES                                                  
  DOC 6:   RECATALOG THE NEW FILES                                           
  DOC 7:   PRINT THE SHORT-VERSION LISTING REPORT                            
  DOC                                                                        
  ========================================================================== 
SCHEDULE RBC                                                                 
RELATIONSHIP (AND/OR) O                                                      
DAYS                                                         DCAL            
                                                                   AND/OR    
WDAYS                                                        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       RETRO N MAXWAIT 04   D-CAT                      
COMMANDS: EDIT, DOC, PLAN, JOBSTAT                                   11.17.00

Editing Documentation

Documentation can be edited when the DOC lines of the Job Scheduling Definition screen are displayed. Modify the DOC lines as desired. When you fill in the last DOC line and press Enter, a new DOC line is displayed.

When modifying DOC lines, text must be left in at least one DOC line in order to save the modifications. Changes resulting in an empty DOCMEM member are not saved.

Job documentation is written to the library and member specified in the DOCLIB and DOCMEM fields on the Job Scheduling Definition screen. Therefore, it is also possible to edit the documentation member directly through ISPF. This is recommended when documentation is lengthy or the editing required is very complex.

Edit/Browse Mode Considerations

In general, a documentation member is entered in edit mode unless any of the following is true, in which case the member will be entered in browse mode:

• The user has entered the table in browse mode (via optionB).

• The documentation library has a record length greater than 80.

• There are non-blank characters in a documentation line beyond column 71. In addition, the displayed line is truncated.

• The documentation library is a Panvalet or Librarian library.

• There are non-displayable characters in the documentation member.

• Another user is viewing or editing the same documentation member. If profile variable SSCHBRO is set, see the chapter about IOA Administration in the INCONTROL for z/OS Administrator Guide for details.

Security access authorization to the documentation library does not determine or limit the mode (edit/browse) in which the documentation member is entered (similar to ISPF member checking).

Auto-Save and Saving Documentation

Documentation changes can be saved upon exiting the Job Scheduling Definition screen. When there are documentation changes, a Save Documentation window may be displayed depending on the value of the AUTO-SAVE DOCUMENTATION field in the Scheduling Facility entry panel:

• If the AUTO-SAVE DOCUMENTATION field was set to Y, documentation changes are automatically saved and the Save Documentation window is not displayed.

• If the AUTO-SAVE DOCUMENTATION field was set to N, documentation changes are not automatically saved and the Save Documentation window is displayed. This window lets you save or cancel the documentation changes.

Figure 26 Save Documentation Window

JOB: PRUPDT02 LIB CTM.PROD.SCHEDULE                           TABLE: PRPROD 
COMMAN  +--------------------------------------------------------+ ===> CRSR
+-----  |                                                        | --------+
  MEMN  |     SAVE DOCUMENTATION ==>              (Y/N)          |          
  OWNE  |                                                        |          
  APPL  |     LIBRARY CTM.PROD.DOC                               |          
  DESC  |     MEMBER  PRUPDT02                                   |          
  OVER  |                                                        |          
  SCHE  +--------------------------------------------------------+          
  SET                                                                       
  CTB STEP AT      NAME                  TYPE                               
  DOCMEM           DOCLIB                                                   
  ========================================================================  
  DOC PROGRAMMER RESPONSIBLE - JOHN SMITH                                   
  DOC MODIFICATIONS:                                                        
  DOC 1. NEW DD CARD ADDED 'INP002' FOR NEW INPUT FILE - FEB. 2001          
  DOC 2. ADDITIONAL REPORT CREATED IN STEP 04 - MAR. 2001                   
  DOC                                                                       
  ========================================================================  
SCHEDULE RBC                                                                
RELATIONSHIP (AND/OR) O                                                     
DAYS                                                         DCAL           
                                                                   AND/OR   
WDAYS                                                        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       RETRO N MAXWAIT 04   D-CAT                     
MINIMUM PDS
DEFINITION ACTIVE FROM UNTIL
 COMMANDS: EDIT, DOC, PLAN, JOBSTAT                                 11.17.00

The following parameters can be specified in the Save Documentation window:

Table 43 Save Documentation Window Fields

Modify the LIBRARY and MEMBER values if desired, and type Y or N in the SAVE DOCUMENTATION field; then press Enter.

If there are no documentation changes, the Save Documentation window is not displayed.

Exiting the Scheduling Definition Facility

When exiting the Scheduling Definition facility, screens are exited in the following sequence:

• Job Scheduling Definition screen

• Job List screen

• Table List screen

Entry Panel

The commands and options available when exiting screens depend on the screen being exited and on whether changes have been made. If changes have been made, the selected exit options and commands determine whether the changes are saved. Exit options and commands are discussed below on a screen-by-screen basis.

Exiting the Job Scheduling Definition Screen

Use any of the following commands, or press the corresponding PFKey, to exit the Job Scheduling Definition screen:

Table 44 Commands for Exiting the Job Definition Screen

Exiting the Job List Screen

Press END (PF03/PF15) to exit the Job List screen. If changes made to at least one job scheduling definition have been kept in memory, as discussed in the preceding section, "Exiting the Job Scheduling Definition Screen", and/or if changes have been made to the Job List screen, the Exit Option window is displayed.

Figure 27 Job List Screen Exit Option Window

JOB LIST     LIB: CTMP.V610.SCHEDULE                            TABLE: BACKUP
COMMAN +-----------------------------------------------------------+  ===> CRSR
OPT  N |                 PLEASE SELECT EXIT OPTION                 | ---------
     S |                                                           |          
     B |     SAVE    CREATE                                        |          
     B |                                                           |          
     B |     LIBRARY CTMP.V610.SCHEDULE                            |          
     B |     TABLE   ZEMER1                                        |          
     B |                                                           | <<< =====
     B +-----------------------------------------------------------+          
     D                                                                        
     DASDRPT2   DASD STATISTICS REPORT AFTER BACKUP FOR APPL-L                
     ENDPLBKP   END OF BACKUP INDICATION FOR APPL-L                           
     BACKAC01   DAILY BACKUP OF DATA SETS FROM APPL-ACCOUNT                   
     BACKAC02   DAILY BACKUP OF SPECIAL FILES FROM APPL-ACCOUNT               
     BACKACW1   WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #1                   
     BACKACW2   WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #2                   
     BACKACW3   WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #3                   
     BACKACW4   WEEKLY BACKUP OF FILES AFTER DAILY FROM APPL-ACC +            
     DASDRPT3   DASD REPORTS AFTER BACKUPS FOR APPL-ACCOUNT                   
     DASDRPT4   DASD REPORTS AFTER BACKUP FOR APPL-ACCOUNT                    
     ENDACBKP   END OF BACKUP INDICATION FOR APPL-ACCOUNT                     
     BACKDD01   DAILY BACKUP OF DATA SETS FROM APPL-DD                        
OPTIONS S SEL D DEL I INS O ORDER F FORCE J JCL C COPY P PLN T JOBSTAT 08.07.23

The LIBRARY and TABLE fields indicate the library and table in which the job scheduling definitions will be saved. The specified values can be modified, for example, to save the job scheduling definitions in a new or different table.

Fill in the Exit Option window as follows:

• To save all changes currently in memory and exit the Job List screen, type Y (Yes) after the word SAVE or CREATE:

  • Type Y after SAVE if a table with the same name already exists in the specified library.

  • Type Y after CREATE if a table with the same name does not exist in the specified library.

  If you create a new table, the table name does not appear in the Table List screen upon exiting the Job List screen; it first appears when you reenter the Table List screen from the entry panel.

• To cancel changes currently in memory and exit the Job List screen, type N (No) after the word SAVE or CREATE.

• To close the Exit Option window and remain in the Job List screen, with the changes remaining in memory, press RESET (PF04/PF16).

Exiting the Table List Screen

Press the END key (PF03/PF15) to exit the Table List screen.

Exiting the Entry Panel

Press the END key (PF03/PF15) to exit the entry panel.

Ordering Scheduling Jobs

Although job scheduling in the production environment is generally handled by Control-M automatically (for more information, see Selected Implementation Issues), Control-M provides several mechanisms for scheduling jobs manually. Among these are options to manually request job scheduling from the Table List screen and the Job List screen.

• When manually requesting job scheduling from the Job List screen, specific jobs are selected. Multiple jobs can be specified.

• When manually requesting job scheduling from the Table List screen, tables are selected and each request applies to all the jobs in the selected tables. Multiple tables can be specified.

Either of two options, O (Order) and F (Force), can be used in either of these screens to manually request job scheduling. These options work as follows:

Table 45 Options for Manually Ordering Jobs

The exception is: Option O (Order) cannot be entered for individual jobs in SMART Tables.

When you use the O and F options, a confirmation window is displayed. The default confirmation window in the case where the O option has been entered for tables in the Table List screen is illustrated in Figure 28.

Figure 28 Order and Force Confirmation Window (Tables)

LIST OF TABLES IN CTM.PROD.SCHEDULE                             TABLE: BACKUP
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME ---------------------------------------------------------------------
      STARTBKP       +--------------------------------------------------------+
  O   BACKPL01  <----| CONFIRM   ODATE 090512 WAIT FOR ODATE N HOLD N UFLOW N |
      BACKPL02       +--------------------------------------------------------+
      BACKPLW1 
      BACKPLW2   WEEKLY BACKUP OF FILES FROM APPL-L #2                        
      BACKPLW3   WEEKLY BACKUP OF FILES FROM APPL-L #3                        
      BACKPLW4   WEEKLY BACKUP OF FILES AFTER DAILY FROM APPL-L +             
      DASDRPT1   DASD REPORTS AFTER BACKUPS FOR APPL-L                        
      DASDRPT2   DASD STATISTICS REPORT AFTER BACKUP FOR APPL-L               
      ENDPLBKP   END OF BACKUP INDICATION FOR APPL-L                          
      BACKAC01   DAILY BACKUP OF DATA SETS FrROM APPL-ACCOUNT                  
  O   BACKAC02   DAILY BACKUP OF SPECIAL FILES FROM APPL-ACCOUNT              
      BACKACW1   WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #1                  
      BACKACW2   WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #2                  
      BACKACW3   WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #3                  
      BACKACW4   WEEKLY BACKUP OF FILES AFTER DAILY FROM APPL-ACC +           
      DASDRPT3   DASD REPORTS AFTER BACKUPS FOR APPL-ACCOUNT                  
      DASDRPT4   DASD REPORTS AFTER BACKUP FOR APPL-ACCOUNT                   
  O   ENDACBKP   END OF BACKUP INDICATION FOR APPL-ACCOUNT                    
      BACKDD01   DAILY BACKUP OF DATA SETS FROM APPL-DD                       
OPTIONS S SELECT  O ORDER  F FORCE  G GRAPHIC FLOW  B BROWSE  D DELETE 10.23.58

If the O or the F option is entered for jobs in the Job List screen, a window similar to that in Figure 29 appears.

Figure 29 Order and Force Confirmation Window (Jobs)

JOB LIST     LIB: CTM.PROD.SCHEDULE                             TABLE: BACKUP
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME ---------------------- DESCRIPTION ----------------------------------
      STARTBKP        +-------------------------------------------------+     
      BACKPL01  <-----+  CONFIRM   ODATE 150818 WAIT FOR ODATE N HOLD N |     
  0   BACKPL02        |  SETVAR N                                       |     
      BACKPLW1        | ----------------------------------------------- |     
      BACKPLW2   WEEKL|  DYNAMIC SMART TABLE INSERT S DUPLICATE  Y      |     
      BACKPLW3   WEEKL|  (S - SELECT, R - RECENT, N - NEW, A - ALONE)   |     
      BACKPLW4   WEEKL+-------------------------------------------------+     
      DASDRPT1   DASD REPORTS AFTER BACKUPS FOR APPL-L                        
      DASDRPT2   DASD STATISTICS REPORT AFTER BACKUP FOR APPL-L               
      ENDPLBKP   END OF BACKUP INDICATION FOR APPL-L                          
      BACKAC01   DAILY BACKUP OF DATA SETS FROM APPL-ACCOUNT                  
  O   BACKAC02   DAILY BACKUP OF SPECIAL FILES FROM APPL-ACCOUNT              
      BACKACW1   WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #1                  
      BACKACW2   WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #2                  
      BACKACW3   WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #3                  
      BACKACW4   WEEKLY BACKUP OF FILES AFTER DAILY FROM APPL-ACC +           
      DASDRPT3   DASD REPORTS AFTER BACKUPS FOR APPL-ACCOUNT                  
      DASDRPT4   DASD REPORTS AFTER BACKUP FOR APPL-ACCOUNT                   
  O   ENDACBKP   END OF BACKUP INDICATION FOR APPL-ACCOUNT                    
      BACKDD01   DAILY BACKUP OF DATA SETS FROM APPL-DD                       
OPTIONS S SEL D DEL I INS O ORDER F FORCE J JCL C COPY P PLN T JOBSTAT 15.37.39

The default confirmation window contains the following fields:

Table 46 Order and Force Confirmation Window Fields

Fill in the confirmation window and press Enter. If at least one order or force request has been specified for a table or job, the original list screen disappears and a message screen is displayed. This screen displays messages that contain the following information about the jobs that were scheduled.

JOB name ODATE date ID=ordered PLACED ON ACTIVE JOBS FILE-descr

Each iteration of the message screen displays job information for one table only. Press END (PF03/PF15) to exit the message display for that table. If multiple tables, or jobs in multiple tables, have been scheduled, the messages for the next table are displayed. When messages for all tables have been displayed, pressing END displays the Table or Job list screen.

Reviewing and managing job variables

Entering Y in the SETVAR field opens the Job Variables List window (Figure 29a). Here you can review and manage the job's AutoEdit variables for the current order. Variables are listed in alphabetical order.

Figure 29a Job Variables List Window

 ------------------------------ JOB VARIABLES LIST -------------------(2.SETVAR)
 COMMAND ===>                                                    SCROLL===> CRSR
 OPT --------- -----------------------------------------------------------------
      VARNAME   %%LC                                                            
      VALUE     CR2                                                             
 -------------------------------------------------------------------------------
      VARNAME   %%VAR                                                           
      VALUE     DSKFJSDKL                                                       
 -------------------------------------------------------------------------------
  ====== >>>>>>>>>>>>>>>>>>>>>   END OF "VAR" LIST   <<<<<<<<<<<<<<<<<<<<< =====
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 OPTIONS:  I INSERT D DELETE                                                    

Through this window you can make the following changes in job variables for the current order:

• Edit variable values.

• Insert a new variable: Enter I in the OPT field of an existing variable, and then type a name and value for the new variable.

  The new, ad-hoc variable is used only during the current order. It is not saved in the job definitions.

For any new variable that you inserted since you entered the Job Variables List window, you can perform the following additional actions:

• Change the name of the variable.

• Remove the variable from the list using the D option.

To apply your changes:

1. Press PF3 to exit the Job Variables List window.

2. Select option 1 to use the modified list of variables for the current order.

   If you change your mind, you can select option 2 to continue with the order using the original variables, or you can select option 3 to cancel the order.

Selecting Dynamic Jobs

Entering the value S in the Dynamic SMART Table Insert field opens the Select SMART Table window (Figure 30).

Figure 30 Select SMART Table Window

Filter:                 ------ CONTROL-M  Dynamic Ins Job/Tbl ------ UP  <D> - (3)
COMMAND ===>                                                       SCROLL===> CRSR
O NAME     Owner ----Odate    Jobname    JobID    Typ ----------- Status ---------
========= >>>>>>>>>>>>>>          Top    of   Jobs   List         <<<<<<<<<<< ====
  MEM1     CONTROLM  301104                       TBL Held (Ordering) Table=OPHIR3
                                                      OrderID=000FY
  MEM1     CONTROLM  291104                       TBL Active Table=OPHIR3
                                                      OrderID=00007
  TBLADJUS K30       161204                       TBL Held (Ordering)
                                                      Table=TBL_WM3012 OrderID=000UN
  TBLADJUS K30       161204                       TBL Held (Ordering)
                                                      Table=TBL_WM3012 OrderID=000UQ




S - Select this table

To select the SMART Table Entity into which you force the job into the AJF, enter S on the relevant line.

The Double Confirmation Window

Any request to order or force a job can, if you prefer, only be processed if it has been confirmed twice. This option is selected by means of the SSCHTBO parameter.

The SSCHTBO parameter is one of the parameters set in the Presentation Modes minor step in the Profile Variables major step of the Customize option (Option 6) of the INCONTROL Installation and Customization Engine (ICE). The default setting is N (No), meaning that when a table is ordered or forced, a regular confirmation window is opened, and not a double confirmation window.

The SSCHTBO parameter can be modified at any time. If the setting of the SSCHTBO parameter is modified to Y (Yes), a window that requires double confirmation is opened in response to any order or force request. An example of this window is shown in Figure 31.

Figure 31 The Double Confirmation Window

LIST OF TABLES IN CTMP.BKUP.SCHEDULE                           -------------(2)
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME -------------VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID   
      BACKPER0         01.01 00/12/12 01/10/16 15:20   180    25     0   K33  
      BACKPER1         01.07 00/12/12 01/10/16 15:25   143    53     0   K33  
  O   BACKPER2         02.60 00/12/12 01/10/16 15:30    74    28     0   K33  
      +--------------------------------------------------------------+        
      |                                                              |        
      |   +------------------------------------------------------+   |        
      |   |   ALL OF THE JOBS IN TABLE BACKPL02                  |   |        
      |   |   WILL BE ORDERED.    PLEASE CONFIRM                 |   |        
      |   |   ------------------------------------------------   |   |        
      |   |   ORDER ALL JOBS IN TABLE BACKPL02                   |   |        
      |   |   ODATE 120601  CONFIRM AGAIN     WAIT FOR ODATE N   |   |        
      |   +------------------------------------------------------+   |        
      |                                                              |        
      +--------------------------------------------------------------+        
      BACKACC1         01.09 00/12/12 01/10/16 15:35    57    10     0   K33  
      BACKACC2         01.02 00/12/12 01/10/16 15:37    25    21     0   K33  
      BACKACC3         02.43 00/12/12 01/10/16 15:41   127    29     0   K33  
      BACKACC4         01.12 00/12/12 01/10/16 15:43    36    18     0   K33  
      BACKADM1         01.06 00/12/12 01/10/16 15:18    23    21     0   K33  
      BACKADM2         01.12 00/12/12 01/10/16 15:16    27    25     0   K33  
OPTIONS S SEL D DEL I INS O ORDER F FORCE J JCL C COPY P PLN T JOBSTAT 15.37.39

Copying Jobs to Another Table

To copy one or more jobs from the current table to another table, type C (Copy) in the OPT column of the Job List screen, next to the job names, and press Enter. The following window is displayed:

Figure 32 Window for Copying Jobs to Another Table

JOB LIST     LIB: CTM.PROD.SCHEDULE                             TABLE: BACKUP
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME -------- DESCRIPTION ------------------------------------------------
      STARTBKP      START OF DAILY BACKUP                                    
      BACKPL01      DAILY BACKUP OF DATA SETS FROM APPL-L                    
      BACKPL02      DAILY BACKUP OF SPECIAL FILES FROM APPL-L                
      BACKPLW1      WEEKLY BACKUP OF FILES FROM APPL-L #1                    
      BACKPLW2 +-----------------------------------------------------------+ 
      BACKPLW3 |                                                           | 
  C   BACKPLW4 |     SPECIFY DESTINATION LIBRARY,TABLE AND JOB NAME        | 
      DASDRPT1 |                                                           | 
      DASDRPT2 |  LIBRARY :  CTM.PROD.SCHEDULE                             | 
      ENDPLBKP |  TABLE   :                                                | 
      BACKAC01 |  JOB     :  BACKPLW4                                      | 
      BACKAC02 |                                                           | 
      BACKACW1 |  PRESS END/RESET TO CANCEL     ENTER TO PERFORM THE COPY  | 
      BACKACW2 +-----------------------------------------------------------+ 
      BACKACW3      WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #3              
      BACKACW4      WEEKLY BACKUP OF FILES AFTER DAILY FROM APPL-ACC +       
      DASDRPT3      DASD REPORTS AFTER BACKUPS FOR APPL-ACCOUNT              
      DASDRPT4      DASD REPORTS AFTER BACKUP FOR APPL-ACCOUNT               
      ENDACBKP      END OF BACKUP INDICATION FOR APPL-ACCOUNT                
      BACKDD01      DAILY BACKUP OF DATA SETS FROM APPL-DD                   
OPTIONS S SEL D DEL I INS O ORDER F FORCE J JCL C COPY P PLN T JOBSTAT 15.37.39

The window contains the fields shown in the following table. Some fields contain default values that can be modified.

Table 47 Fields in the Window for Copying Jobs to Another Table

To perform a request, press Enter.

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

SMART Table Entities cannot be copied. If a job in a SMART Table is copied to a table that handles jobs individually, it is copied as a regular job; rule-based calendars are dropped from the job scheduling definition. If a job in a SMART Table is copied to a nonexisting table, the table that is created will handle jobs individually.

Deleting Tables

Tables can be deleted from the Table List screen.

To delete tables, type D (Delete) by the table names in the Table List screen and press Enter.

The confirmation window illustrated below is displayed, in sequence, for each table selected for deletion.

Figure 33 Delete Table Confirmation Window

LIST OF TABLES IN CTM.PROD.SCHEDULE                            -------------(2)
COMMAND ===>                                                    SCROLL===> CRSR
 OPT  NAME ---               +--------------------------+ E  INIT   MOD   ID 
      ADABAS                 |   CONFIRM DELETE OPTION  | 0    70     0 O01 
  D   APPLNTN    <-----------|               (Y/N)      | 0   180     0 O01 
      APPLPRDI               +--------------------------+ 1    41     0 O01 
      ARCNIGHT          01.00 01/02/09 01/06/07 00:50     5     5     0 S07 
      ASMBTR1           01.00 01/02/09 01/06/07 00:50     9     9     0 S07 
  D   ASMBTR2           01.00 01/02/09 01/06/07 00:50    14    14     0 S07 
      BACKUP            01.00 01/02/09 01/06/07 00:50     5     5     0 S07 
      CICSJOBS          01.00 01/02/09 01/06/07 00:50    70    70     0 O01 
      CICSPROD          01.00 01/02/09 01/06/07 00:50   180   180     0 O01 
      CICSTEST          01.00 01/02/09 01/06/07 00:50    41    41     0 O01 
      CICSUPT           01.00 01/02/09 01/06/07 00:50     5     5     0 S07 
      CLIENTS           01.00 01/02/09 01/06/07 00:50     9     9     0 S07 
      DB2EXE            01.00 01/02/09 01/06/07 00:50    14    14     0 S07 
      DLOAD             01.00 01/02/09 01/06/07 00:50     5     5     0 S07 
      MAINDAY           01.00 01/02/09 01/06/07 00:50   180   180     0 O01 
      MAINT             01.00 01/02/09 01/06/07 00:50    41    41     0 O01 
      MAINTPL           01.00 01/02/09 01/06/07 00:50     5     5     0 S07 
      ONSPOOL           01.00 01/02/09 01/06/07 00:50     9     9     0 S07 
  D   ONSPOOLT          01.00 01/02/09 01/06/07 00:50    14    14     0 S07 
      OPERCLN           01.00 01/02/09 01/06/07 00:50     5     5     0 S07 
OPTIONS S SELECT  O ORDER  F FORCE  G GRAPHIC FLOW  B BROWSE  D DELETE 15.38.37

Type Y (Yes) in the window to confirm the delete request.

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

A message is written to the IOA Log file for each table deleted.

Condition Inheritance

When a job is deleted, there is an optional feature in Control-M that automatically adjusts the jobs in the table so that all the jobs that are waiting for a deleted job's OUT conditions will inherit its IN conditions.

When a job that is part of a table is deleted, and profile variable SSCHCDJ=Y, the following window is displayed:

Figure 34 Condition Inheritance Confirmation Window

JOB LIST     LIB: CTMP.V700.SCHEDULE                            TABLE: CICS
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME -------  DESCRIPTION  ------------------------------- ------ --------
     CICSPRD1     CICSPRD1                                                     
     CICSPRD2     CICSPRD2                                                     
     CICSTST1     CICSTST1                                                     
     CICSTST2     CICSTST2                                                     
     SYSTST1      SYSTST1                                                      
     SYSTST2          +------------------------------------------+             
 D   PROD1   <--------| CONFIRM DELETE OPTION              (Y/N) |             
     PROD2            |                                          |             
     PROD3            | AUTO INHERIT JOBS IN-CONDITIONS N  (Y/N) |             
     USER1            +------------------------------------------+             
     USER2        USER2                                                        
     USER3        USER3                                                        
     SYSPROD1     SYSPROD1                                                     
     SYSPROD2     SYSPROD2                                                     
     SYSPROD3     SYSPROD3                                                     
     LOG1         LOG1                                                         
     LOG2         LOG2                                                         
     LOG3         LOG3                                                         
     LOG4         LOG4                                                         
     LOG5         LOG5                                                         
OPTIONS S SEL D DEL I INS O ORDER F FORCE J JCL C COPY P PLN T JOBSTAT 08.34.31

The default value of the confirm delete option is blank.

The default value of the auto inherit job's in-conditions option is N.

When the confirm delete option is blank or N, the job is not deleted.

When the confirm delete option is Y and the auto inherit job's in-conditions option is N, the job is deleted as usual.

When the confirm delete option is Y and the auto inherit job's in-conditions option is Y, all the jobs that are waiting for the deleted job's OUT conditions will inherit its IN conditions.

A message is written to the IOA log file for each job deleted.

Limitations

Condition inheritance applies to one table only. Relationships between tables are ignored.

Unusual job definition 1

This enhancement does not handle "unusual" job definitions. For example, assume that three jobs are present in a table:

Under normal conditions, jobs B and C would never run. However, if job B is deleted using the condition inheritance feature, job C will incorrectly run every Sunday.

Unusual job definition 2

If job B deletes condition 1, job C will never run. However, if job B is deleted using the condition inheritance feature, job C will incorrectly run.

Unusual job definition 3

Assume that job B deletes output condition X. If job B is deleted using the condition inheritance feature, the deletion of output condition X will be lost.

Other feature limitations

• Parentheses are rearranged

  In order to use the condition inheritance feature, Control-M formats must be converted to standard Boolean format, manipulated, and then converted back to Control-M format. In this case, the parentheses are rearranged, although the functionality remains the same. For example:

  Control-M format: A (|B |C)

  becomes

  Control-M format after manipulations: |(A B) |(A C)

• Adjust condition is ignored

  The Adjust Condition feature for a SMART Table is ignored.

• DO COND is ignored

  Output conditions that are associated with a DO COND statement are ignored.

• Manual conditions

  Manual conditions are treated the same way as regular conditions. This may lead to incorrect results.

Displaying Graphic Jobflow

The Graphic Jobflow screen provides a graphic presentation of the job flow dependencies in a given table. It is displayed when option G (Graphic Flow) is specified for a table in the Table List screen.

Use the shifting PFKeys to shift the Graphic Jobflow right (PF11/PF23) and left (PF10/PF22).

The FIND command (PF05/PF17), described in FIND Command, is supported in the Graphic Jobflow screen.

To return to the Table list, press the END key (PF03/PF15).

Two formats for the Graphic Jobflow screen are available, one for color displays and one for non-color displays.

Graphic Jobflow for Color Terminals

Figure 35 Graphic Jobflow for Color Terminals

-------------- GRAPHIC JOBFLOW - TABLE PRODYH ---------------- (2.G)
COMMAND ===>                                         SCROLL===> CRSR
                                                                    
 PRODYJCL  --->  PRODYHTK  ----------------->  PRODYHST             
 PRODTHC2  --->  PRODYBCK  --->  PRODYIDK  --->      --->  PRODYBTL 
                                     --->  PRODYIZN  --->  PRODYEND 
                                                                    
 PROJYFOT  --->  PROJYMRG  --->  PROJYMTI                           
                                                                    
                          --->  PROJYHO1  --->  PROJYHO2            
                                                                    
             --->  PROJYDPY  --->  PROJYDTK  --->  PROYH11   ---
                                                                    
                                         --->  PROJYDLI  --->      
                                                                   
PRESS END TO RETURN.  LEFT AND RIGHT TO SEE MORE. COLUMNS: 001 - 080

On color terminals, the colors used to display the boxes and arrows can be changed by request. Available colors are sequenced in a loop. Each request changes to the next color in the sequence. Colors can be changed as follows:

Table 48 Color Change Options on Graphic Jobflow Window

Graphic Jobflow for Non-Color Terminals

Figure 36 Graphic Jobflow for Non-Color Terminals

-------------------- GRAPHIC JOBFLOW - TABLE PRODYH ------------------- (2.G)
COMMAND ===>                                                 SCROLL===> CRSR
 .----------.   .----------.                  .----------.                
 | PRODYJCL |-->| PRODYHTK |--->-->--->-->--->| PRODYHST |                
 `----------'   `----------'                  |          |                
 .----------.   .----------.    .--------.    |          |    .----------.
 | PRODTHC2 |-->| PRODYBCK |--->|PRODYIDK|--->|          |--->| PRODYBTL |
 `----------'   `----------'    |        |    `----------'    `----------'
                                |        |    .----------.    .----------.
                                |        |--->| PRODYIZN |--->| PRODYEND |
                                `--------'    `----------'    `----------'
 .----------.   .----------.    .--------.                                
 | PROJYFOT |-->| PROJYMRG |--->|PROJYMTI|                                
 `----------'   |          |    `--------'                                
                |          |    .--------.    .----------.                
                |          |--->|PROJYHO1|--->| PROJYHO2 |                
                |          |    `--------'    `----------'                
                |          |    .---------.   .----------.    .----------.
                |          |--->|PROJYDPY |-->| PROJYDTK |--->| PROYH11  |--
                `----------'    |         |   `----------'    |          |
                                |         |   .----------.    |          |
                                |         |-->| PROJYDLI |--->|          |
                                |         |   `----------'    `----------'
                                                                          
PRESS END TO RETURN.LEFT AND RIGHT TO SEE MORE.COLUMNS:001-08015.38.44

Displaying a Job Scheduling Plan

To display the scheduling plan of a job or SMART Table Entity in calendar format, either type P (Plan) by the job or SMART Table Entity name in the Job List screen and press Enter, or enter command PLAN in the Job Scheduling Definition screen. The following window is displayed:

Figure 37 Job Scheduling Plan Window

JOB LIST     LIB: CTM.PROD.SCHEDULE                             TABLE: BACKUP
COMMAND ===>                                                    SCROLL===> CRSR
OPT  NAME ----- DESCRIPTION ---------------------------------------------------
      STARTBKP   START OF DAILY BACKUP                                        
      BACKPL01   DAILY BACKUP OF DATA SETS FROM APPL-L                        
      BACKPL02   DAILY BACKUP OF SPECIAL FILES FROM APPL-L                    
      BACKPLW1   WEEKLY BACKUP OF FILES FROM APPL-L #1                        
      BACKPLW2   WEEKLY BACKUP OF FILES FROM APPL-L #2                        
      BACKPLW3   WEEKLY BACKUP OF FILES FROM APPL-L #3                        
      BACKPLW4   WEEKLY BACKUP OF FILES AFTER DAILY FROM APPL-L +             
      DASDRPT1   DASD REPORTS AFTER BACKUPS FOR APPL-L                        
      DASDRPT2   DASD STATISTICS REPORT AFTER BACKUP FOR APPL-L               
      ENDPLBKP               +---------------------+                          
      BACKAC01               |  FROM DATE  050101  |                          
  P   BACKAC02               |  TO DATE    053101  |                          
      BACKACW1               +---------------------+                          
      BACKACW2                                                                
      BACKACW3   WEEKLY BACKUP OF FILES FROM APPL-ACCOUNT #3                  
      BACKACW4   WEEKLY BACKUP OF FILES AFTER DAILY FROM APPL-ACC +           
      DASDRPT3   DASD REPORTS AFTER BACKUPS FOR APPL-ACCOUNT                  
      DASDRPT4   DASD REPORTS AFTER BACKUP FOR APPL-ACCOUNT                   
      ENDACBKP   END OF BACKUP INDICATION FOR APPL-ACCOUNT                    
      BACKDD01   DAILY BACKUP OF DATA SETS FROM APPL-DD                       
OPTIONS S SEL D DEL I INS O ORDER F FORCE J JCL C COPY P PLN T JOBSTAT 15.37.39

The window contains the following fields with default values that can be modified:

Table 49 Job Scheduling Plan Window Fields

To display the plan, modify the defaults if desired. Press Enter. The Job Scheduling Plan screen is displayed.

To close the window without displaying the plan, press END (PF03/PF15) or RESET (PF04/PF16).

Job Scheduling Plan Screen

For each month in the requested date range, beginning with the first month in the range, the Job Scheduling Plan screen displays a calendar that indicates the schedule of the job.

The dates within the date range on which the job is scheduled, according to its basic scheduling criteria, are marked with an asterisk.

Enter NEXT (PF08/PF11/PF20/PF23) or PREV (PF07/PF10/PF19/PF22) in the COMMAND field, or press the appropriate PFKey, to see the next or previous calendar month in the date range.

Press the END key (PF03/PF15) to exit the Job Scheduling Plan screen and return to the Job List screen.

Figure 38 Job Scheduling Plan Screen

JOB NAME: BACKPL02               JOB SCHEDULING         DATES : 010601 - 300601
COMMAND ===>                                                    SCROLL===>    
   06   2001        MON   TUE   WED   THU   FRI   SAT   SUN                   
                                             01    02    03                   
                                                                              
                                                                              
                     04    05    06    07    08    09    10                   
                      *     *     *     *     *                               
                                                                              
                     11    12    13    14    15    16    17                   
                      *     *     *     *     *                               
                                                                              
                     18    19    20    21    22    23    24                   
                      *     *     *     *     *                               
                                                                              
                     25    26    27    28    29    30                         
                      *     *     *     *     *                               
                                                                              
                                                                              
                                                                              
                                                                              
 CMDS: NEXT, PREV, END                                                 19.30.51

The screen indicates the following:

Table 50 Job Scheduling Plan Screen Fields

Tracking and Control Facility

The Tracking and Control facility provides relevant information about the status of each job and task in the Active environment and enables you to manually intervene in the processing of jobs.

The Active environment contains all the jobs in the Active Jobs file, that is, all jobs that have recently executed, are currently executing, or are scheduled for possible execution in the near future.

The main screen of the Tracking and Control facility is the Active Environment screen, which displays a list of all jobs and their statuses in the Active environment.

The Active Environment screen is accessed by requesting option 3 on the IOA Primary Option menu.

From the Active Environment screen you can request specific actions in relation to a job, or request the display of other screens that provide additional information and capabilities. Possible requests include

• Change the screen display type to display different information about the jobs in the Active environment.

• View only jobs belonging to a specific table name.

• View statistical information about all jobs in the Active environment.

• Display the reasons why a job has not executed.

• Place a job in Hold status.

• Delete a job from the Active environment.

• Delete a SMART Table Entity and all the jobs in the SMART Table from the Active environment.

• Undelete a job that has been deleted from the Active environment.

• Free a held job.

• Display the log messages of a job.

• Zoom in on the scheduling details of a job and modify certain parameters.

• Rerun a job.

• Confirm the restart and/or rerun of a job.

• View the list of all runs (job orders) of a particular job, and view the sysout of any or all of those job orders.

• Display the execution statistics of a job.

• Display and edit the JCL of a job.

• Display the list or network of predecessor and successor jobs of a specific job, and display critical path information.

• Force END OK termination of a job that has not been submitted or that ended NOTOK.

• Reactivate a job that has "disappeared" or that has failed with status "Reason Unknown".

• Display the list of archived jobs (in the History file) and restore desired archived jobs to the Active environment.

Active Environment Screen

To enter the Tracking and Control facility, select option 3 on the IOA Primary Option menu. The Active Environment screen is displayed.

Figure 39 Control-M Active Environment Screen

Filter:           ------- CONTROL-M  Active  Environment ------ UP    <D>   (3)
COMMAND ===>                                                    SCROLL ==> CRSR
O Name     Owner    Odate  Jobname  JobID   Typ ------------ Status -----------
  CICSPROD M22      060601 CICSPROD/04368   CST Executing (Run 1)             
  CICSTEST M22      060601 CICSTEST/04372   CST Executing (Run 2)             
  BRIVPCC  IVP      060601                  TBL Active                        
  BRCC0001 IVP      060601 BRCC0001/04382   JOB Held Wait Schedule            
  BRCC0002 IVP      060601 BRCC0002/04383   JOB Held Ended "OK" (Run3)        
                                                Prior Run: Ended "OK"         
  BRCCIND  IVP      060601 BRCCIND /04385   JOB Ended "OK"                    
  BRUPDT02 IVP      060601 BRUPDT02/04387   JOB Ended "OK"                    
  BRREP002 IVP      060601 BRREP002/04389   JOB Ended "OK"                    
  BRIVPCCE IVP      060601         /        JOB Wait Schedule                 
  CRCCEND  IVP      060601         /        JOB Wait Schedule                 
  INTR0001 M22      060601         /        JOB Ended- Not "OK" Due to CC -   
                                                Rerun Needed (Run 3)          
                                                Prior Run: Ended- Not "OK" Due
                                                to CC - Rerun was Needed      
  INTR0003 M22      060601         /        JOB Wait Schedule                 
  BRREP003 IVP      060601 BRREP003/04391   JOB Ended "OK"                    
  BRREP004 IVP      060601 BRREP004/04393   JOB Ended "OK"                    
  INTR0004 M22      060601 INTR0004/04397   JOB Ended- Not "OK" - Abended     
Commands: OPt DIsplay Show HIstory RBal REFresh Auto Jobstat SHPF Note Table  
          OPt command toggles between Commands and Options display     15.15.48

It is assumed that you want to see the most recently ordered jobs first. Therefore, by default, the bottom of the Job list is displayed upon entry to the Active Environment screen. This default can be altered by setting Profile variable SACTMOD to T, in which case jobs are displayed from the top of the Job list. Profile variable SACTMOD is described in the INCONTROL for z/OS Administrator Guide.

AutoRefresh mode is available in this screen.

To exit the Active Environment screen, press the END key (PF03/PF15).

For color terminals, jobs with different statuses are displayed in different colors. Each of the colors in the following table has been defined as the default for one of these statuses. These statuses are described more fully in Table 64 in Fields of the Show Screen Filter Window.

Table 51 Default Colors for Active Missions Screen

Display Types of the Active Environment Screen

The information in the Active Environment screen can be displayed in different formats or display types. A number of predefined display types are available.

While in the Active Environment screen, the display type can be changed by the DISPLAY command. The DISPLAY command is described in Commands of the Active Environment Screen.

Table 52 Predefined Display Types

The INCONTROL administrator can use display type support to tailor the display layout by adding lines, fields, changing colors, and so on. Additional information about display type support is provided in the section on customizing IOA display format members in the INCONTROL for z/OS Administrator Guide.

Upon reentering the screen, the last-used display type is displayed.

The Default and All Info predefined display types, and the fields they contain, are discussed in Format of the Active Environment Screen.

The Network display type, although available in this screen, is generally useful only in the Job Dependency Network screen, and is described in Job Dependency Network Screen.

Primary and Alternate Bottom Lines

The last two lines of the Active Environment screen are used to display the list of available commands and options.

Because there are too many commands and options to list at once, the list is divided into two parts, each part consisting of two lines, as follows:

• Upon entry to the screen, the set of available commands is displayed. Because this list is displayed upon entry to the screen, it is referred to as the Primary Bottom line.

  Copy

  Commands: OPt DIsplay Show HIstory RBal REFresh Auto Jobstat SHPF Note Table
  OPt command toggles between Commands and Options display     15.15.48

• Upon request (using command OPT), the set of available options is displayed (in place of the set of commands). The list of available options is referred to as the Alternate Bottom line.

  Copy

  Opt: ? Why L Log H Hold Z Zoom R Rerun A Activate O Force OK V View Sysout
   N Net D Del F Free S Stat T Table U Undelete J JCL Edit C Confirm 15.46.06

To toggle back and forth between the two sets of bottom lines, type OPT in the COMMAND field and press Enter.

Available commands are described in Commands of the Active Environment Screen. Available options are described in Options of the Active Environment Screen.

Format of the Active Environment Screen

Display Type D (Default)

Below is an example of the Default display type. It contains the most relevant information about the job.

Figure 40 Display Type D (Default)

Filter:  DEFAULT ------- CONTROL-M  Active  Environment ------ UP    <D>   (3)
COMMAND ===>                                                    SCROLL ==> CRSR
O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
  CICSPROD M22      060601 CICSPROD/04368   CST Executing (Run 1)             
  CICSTEST M22      060601 CICSTEST/04372   CST Executing (Run 2)             
  BRIVPCC  IVP      060601                  TBL Active                        
  BRCC0001 IVP      060601 BRCC0001/04382   JOB Held Wait Schedule            
  BRCC0002 IVP      060601 BRCC0002/04383   JOB Held Ended "OK" (Run3)        
                                                Prior Run: Ended "OK"         
  BRCCIND  IVP      060601 BRCCIND /04385   JOB Ended "OK"                    
  BRUPDT02 IVP      060601 BRUPDT02/04387   JOB Ended "OK"                    
  BRREP002 IVP      060601 BRREP002/04389   JOB Ended "OK"                    
  BRIVPCCE IVP      060601         /        JOB Wait Schedule                 
  CRCCEND  IVP      060601         /        JOB Wait Schedule                 
  INTR0001 M22      060601         /        JOB Ended- Not "OK" Due to CC -   
                                                Rerun Needed (Run 3)          
                                                Prior Run: Ended- Not "OK" Due
                                                to CC - Rerun was Needed      
  INTR0003 M22      060601         /        JOB Wait Schedule                 
  BRREP003 IVP      060601 BRREP003/04391   JOB Ended "OK"                    
  BRREP004 IVP      060601 BRREP004/04393   JOB Ended "OK"                    
  INTR0004 M22      060601 INTR0004/04397   JOB Ended- Not "OK" - Abended     
Commands: OPt DIsplay Show HIstory RBal REFresh Auto Jobstat SHPF Note Table  
          OPt command toggles between Commands and Options display     15.15.48

Fields of Display Type D (Default)

Table 53 Fields in the Default Display Type

The following is displayed for each job:

Table 54 Fields for Each Job Default

The information in the following table can be displayed by request, along with the STATUS information. For more information, see Commands of the Active Environment Screen.

Table 55 Other Information in the STATUS Field

O Name     Owner    Odate  Jobname  JobID   Typ ------- Status -----------
 TO5SP115 TO5      060601         /        JOB Wait Schedule Table=NRD-TBL
 CPU=A OrderID=0003E ===>BACKUP
 SCHED-LIB=CTM.PROD.BKP(SPBKP)
 *** Note ***

Display Type A (All Info)

The following is an example of the All Info display type. In addition to the Default information, it contains statistical information about the job run.

Figure 41 Display Type A (All Fields)

Filter:           ------- CONTROL-M  Active  Environment ------ DOWN  <A> - (3)
COMMAND ===>                                                    SCROLL ==> CRSR
O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
  DAILYPRD PRODMNGR 060601                  JOB Wait Schedule                 
   OrderID 001Q6  TBL CTM-CONTROL                                             
   MaxRC                          Res. Use: Y                                 
   Time Fr:       Time Un:       Priority: 00                                 
    Due-In: 0859  Due-Out: 0859  Late:                                        
   Avg Elaps: 0000               RBA:  000002                                 
  DAILYSYS SYSTEM   060601                  JOB Wait Schedule                 
   OrderID 001Q7  TBL CTM-CONTROL                                             
   MaxRC                          Res. Use: Y                                 
   Time Fr:       Time Un:       Priority: 00                                 
    Due-In: 0859  Due-Out: 0859  Late:                                        
   Avg Elaps: 0000               RBA:  000003                                 
  CTMLDNRS PRODMNGR 060601                  JOB Wait Schedule                 
   OrderID 001Q8  TBL CTM-CONTROL                                             
   MaxRC                          Res. Use: Y                                 
   Time Fr:       Time Un:       Priority: 00                                 
    Due-In: 0859  Due-Out: 0859  Late:                                        
   Avg Elaps: 0000               RBA:  000004                                 
  CTMCLRES PRODMNGR 060601                  JOB Wait Schedule                 
Opt: ? Why L Log H Hold Z Zoom R Rerun A Activate O Force OK V View Sysout    
     N Net D Del F Free S Stat T Table U Undelete J JCL Edit C Confirm 14.50.56

Fields of the Display Type A (All Info)

Below is a description of fields in the All Info display type that do not appear in the Default display type. The fields that appear in the Default display type are described in the preceding section.

Table 56 Fields in the All Fields Display Type

Commands of the Active Environment Screen

The commands in the following table can be requested by typing the command in the COMMAND field of the Active Environment screen and pressing Enter.

Table 57 Commands of the Active Environment Screen

Options of the Active Environment Screen

Select an option by typing it in the O (Option) field to the left of the job order and pressing Enter. The following table describes the available options:

Table 58 Options of the Active Environment Screen

Job Statuses

The following job statuses can appear in the Active Environment screen:

Table 59 Job Statuses for the Active Environment Screen

SMART Table Entity Statuses

The following statuses can appear for the SMART Table Entity in the Active Environment screen:

Table 60 SMART Table Entity Statuses for the Active Environment Screen

Filtering the Active Environment Screen Display

Screen filters may be used to filter the Active Environment screen display.

A filter consists of a set of record selection criteria (selection fields and their values). Only records that conform to selection criteria specified in the filter are displayed on the screen.

The INCONTROL administrator may predefine filters and place them in the General profile.

Each user can activate an existing filter in the Active Environment screen by typing the command SHOW in the COMMAND line of the Active Environment screen.

The filtering feature utilizes two different windows, the Show Screen Filter window and the Display Filters window:

• Each user can define and name multiple filters for the screen by using the Show Screen Filter window, which is described in Editing Filter Criteria. User-defined filters are stored in the user profile. Filters that are kept in the user profile can be activated only by the user who defined the filter.

• Users can display the list of all available filters by opening the Display Filters window.

A predefined default filter (DEFAULT) is supplied for the Active Environment screen. Site-defined defaults determine whether the last filter used or the DEFAULT filter is activated upon reentry to the Active Environment screen.

Activating a Known Filter in the Active Environment screen

The SHOW command may be used to activate an existing filter when you know the filter name. To activate an existing filter in the Active Environment screen, type the command SHOW in the COMMAND field, as follows:

SHOW name

where name is the name of the filter to be activated.

Displaying the List of Available Filters

If you do not know the name of a filter, you can display the list of available filters in the Display Filters window. The display includes Global filters that are available to all users, and user-defined filters that are only available to the individual user.

You can then select a filter from the Display Filters window for activation or editing.

To open the Display Filters window, type the command SHOW ? in the COMMAND field. The Display Filters window is opened.

Figure 42 Display Filters Window

Filter: DEFAULT   ------- CONTROL-M  Active  Environment ------ DOWN  <D> - (3)
COMMAND ===>                                                    SCROLL ==> CRSR
O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
  CICSPR   M96      270601                  JOB Held Wait Schedule (Pipe)     
  CICSPR   M96      270601                  JOB Held Wait Schedule (Pipe)     
  BRIVPC   M96      270601                  JOB Held Wait Schedule (Pipe)     
  KA +-----------------------------------+  JOB Held Wait Schedule (Pipe)     
  KA |          DISPLAY FILTERS          |  JOB Held Wait Schedule (Pipe)     
  DE | CMD ==>           SCROLL==> CRSR  |  TBL Held Active                   
  NO |  O NAME     DESCRIPTION           |  JOB Held Ended "OK" Forced OK     
  DA |    CONFIRM  WAIT CONFIRM. JOBS    |  JOB Held Ended-"OK"               
  DE |    DEL      ONLY DELETED JOBS     |  TBL Active                        
  IO |    END      ALL ENDED JOBS        |  JOB Held Ended "OK"               
  IE |    ENDNOTOK ENDED NOT-OK JOBS     |  JOB Held Wait Schedule            
  DA |    ENDOK    ENDED OK JOBS         |  JOB Wait Schedule                 
  DA |    EXEC     EXECUTING JOBS        |  JOB Wait Schedule                 
  CT |    LATE     LATE JOBS             |  JOB Wait Schedule                 
  CT |    WAIT     JOBS ON WAIT QUEUE    |  JOB Wait Schedule                 
  IE |    ECSALL   ALL JOBS IN AJF       |  JOB Ended "OK"                    
  NO | =========>>> BOTTOM <<<========== |  JOB Wait Schedule                 
  NO |                                   |  JOB Wait Schedule                 
  NO |  OPTIONS  S  SELECT  E  EDIT      |  JOB Wait Schedule                 
Comm +-----------------------------------+ resh Auto Jobstat SHPF Note Table  
          OPt command toggles between Commands and Options display     15.21.28

The Display Filters window displays the following information:

Table 61 Field of the Display Filters Window

To select a filter in the list for activation or editing, type the appropriate option in the O (Option) field to the left of the filter name, and press Enter.

Table 62 Options of the Display Filters Window

Editing Filter Criteria

The Show Screen Filter window enables you to create or modify a filter.

• To open an existing filter for editing, either:

  • Type SHOW name EDIT in the Active Environment screen, where name is the name of the filter.

  • Type E (Edit) next to the filter name in the Display Filters window and press Enter.

• To edit the currently active filter, it is unnecessary to type the name or Edit. Just type SHOW in the COMMAND field and press Enter, or press PF02/PF14.

• To create a new filter, open any existing filter and enter a new name and description in the FILTER and DESC fields, which are described in Table 63 in Fields of the Show Screen Filter Window.

  The Show Screen Filter window is displayed:

Figure 43 Show Screen Filter Window

--------------------------- Show Screen Filter -----------------------(3.SHOW)-
 Filter            Save   (Y/N) Desc:                                        
 Memname                                                                     
 Table                                                                       
 Sch Lib                                              Tbl                    
 ======== In Process Y ======= | Ended          Y | ======= State Y ======== 
 --------------------------------------------------------------------------- 
 Wait Sched   Y  Wait time   Y | Ended "OK"     Y | Free      Y  Forced OK Y 
 Wait Conf    Y  Wait Cond   Y | Not "OK"       Y | Held      Y  Tbl Held  Y 
 Wait SUB     Y  Wait quant  Y | Rerun          Y | On Req    Y  CMEM Forc Y 
 Submitted    Y  Wait contrl Y | Disappeared    Y | Deleted   N  Note      Y 
 Wait Exec    Y  Tbl Active  Y | Abended        Y | Late      N  Restarted Y 
 Executing    Y                | Unexpected CC  Y | Pseudo    N              
 On Out Queue Y                | JCL Error      Y |                          
 Task Type: Job Cyc Emr Stc Cst Est Ecj Ecs Wrn Tbl Tbc                      
             Y   Y   Y   Y   Y   Y   Y   Y   Y   Y   Y                       
 Res Name                                                                    
 Resource Type: In Y Out Y Conds Y Resource Y Control Y                      
 Owner                                                                       
 Odate:  From              To               Priority                         
 Job                       Appl                                              
 CPU Id           LPAR                           RBC                         
 Workload                                                                    
-----------------------------------------------------------------------------

Fields of the Show Screen Filter Window

The Show Screen Filter window contains the following fields:

Table 63 Fields of the Show Screen Filter Window

The fields listed in Table 64 define the selection criteria to be applied to the screen. Fill in these selection criteria as desired.

For compatibility with versions prior to version 6.2.xx, the SACTMSK profile variable can be used to specify how to treat character search criteria that do not use masking characters. The default setting (Y) results in Control-M treating all character search criteria as if a masking character was entered. For example, if AB was entered as a member name to be searched, by default this entry is treated as AB*.

Table 64 Show Screen Filter Window Selection Criteria

Characteristics of the Show Screen filter

The following rules govern the operation of the Show Screen Filter window:

• The Control-M monitor updates the status of jobs and tables displayed in the Active Jobs file (AJF). Therefore, if the Control-M monitor is down, the status displayed in the AJF may not be up-to-date.

  If a job was waiting for a prerequisite input condition when the Control-M monitor went down, the job will continue to be shown as waiting for the condition, even if the condition is present, until the Control-M monitor updates the AJF.

• If you set Wait Sched to Y, the values set for Wait time, Wait Cond, Wait quant, and Wait contrl are ignored. Control-M only looks at the values set for these fields if Wait Sched is set to N.

• Executing is only used for jobs (and not for tables).

• Tbl Active is only used for tables (and not for jobs).

• If a job is part of a table, and the table is waiting for some criteria such as a time requirement, a prerequisite condition, and so on, the job has the same status as the table.

  If the table is waiting for a prerequisite condition, and the filter criteria is Wait Cond, the job will be displayed as waiting for the condition even if the condition is not required by the job scheduling definition of the job itself.

• If the job scheduling definition of a job requires it to wait for more than one input criteria, these criteria are not all checked at once. They are checked in the following sequence:

  • Wait time

  • Wait Cond

  • Wait quant

  • Wait contrl

    If the job is so defined that it must wait for a specific time and for a prerequisite condition, the job will be displayed in the list of jobs waiting for time, but will not be displayed in the list of jobs waiting for prerequisite conditions. However, when the time requirement is satisfied, if the prerequisite condition is not available, the job will be displayed in the list of jobs waiting for prerequisite conditions.

Closing the Show Screen Filter Window

The filter you have edited can be activated with or without saving changes, depending on the value entered in the Save field, as follows:

• To activate and save the filter, type Y (Yes) in the Save field. Changes to the filter are permanently saved.

• To activate the filter without saving it, type N (No) in the Save field. Changes are kept in memory only, but not saved.

After typing a value in the Save field, press one of the following keys:

Table 65 Show Screen Filter Window - Closing Values

The window is closed and the filter is activated as defined or modified.

To cancel changes made in the Show Screen Filter window, use the RESET command (PF04/PF16). The changes are canceled regardless of the value entered 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 may be modified so that END works like RESET.

Global View Screen

The Global View screen is displayed by typing the command VIEW (abbreviated V) in the COMMAND field of the Active Environment screen and pressing Enter, or by pressing PF10/PF22 in the Active Environment screen.

This screen provides a statistical overview of the status of the jobs running under Control-M. Information is presented by TABLE name, by date (that is, separate statistics for the same table name on different dates).

Figure 44 Global View Screen

-------------------------- GLOBAL VIEW - BY TABLE --------------------(3.VIEW)
COMMAND ===>                                                   SCROLL===> CRSR
TOTAL  WAIT SCHEDULE   647   EXECUTING     19  END NOTOK      9  END OK   2014
STAT TABLE-------------- ODATE  #WSC #EXC #END  MEMNAME  -----JOB STATUS------
  WS CTM-CONTROL          060601    1         4  CTMCLRES WAIT SCHEDULE       
  ER PROD-ONSPOOL         060601             43  P0*      ENDED NOTOK   S0C4  
* EN DD-DAY-PROD          060601             42                               
  WS BR-IVP-CC            060601    8        28  BRIVPCCE WAIT SCHEDULE       
  WS SYSTEMS-JOBS         060601    4        22  SMFCLEAN WAIT SCHEDULE       
  WS PROD-KPL             060601   47            PRDKPL01 WAIT SCHEDULE       
  ER MT-PRODUCTION        060601   10        24  MTPRQV   ENDED NOTOK   S0C1  
                                                 MTRRU04  ENDED NOTOK   U0016 
  ER APPL-PROD-INTERNAL   060601    9    2    2  INTPRD02 ENDED NOTOK   C0008 
                                                 INTPRD01 EXECUTING           
                                                 INTPRD1A WAIT EXECUTION      
  RN PR-PRODUCTION        060601   10    6   24  PRDINP6A EXECUTING           
                                                 PRDRPT99 EXECUTING           
                                                 PRDDFN   EXECUTING           
                                                 PRDRPT10 EXECUTING           
                                                 PRDUPD12 EXECUTING           
                                                 PRDUPD14 WAIT EXECUTION      
  RN VIJ-JOBS             060601         4   42  VIJJBNX  ENDED NOTOK   NOMEM 
                                                 VIJRUN22 ENDED NOTOK   JNRUN 
COMMANDS:    REFRESH (VIEW DATA)        END (RETURN TO ACTIVE SCREEN)  15.35.49

AutoRefresh mode is available under this screen.

To update the screen, press the REFRESH key (PF10/PF22).

To return to the Active Environment screen, press the END key (PF03/PF15).

Fields of the Global View Screen

Table 66 Fields of the Global View Screen

View Graph Screen

The View Graph screen is displayed by typing the VIEW GRAPH command (abbreviated V G) in the COMMAND field of the Active Environment screen and pressing Enter.

This screen provides a statistical overview of the status of the jobs running under Control-M, in graph form. Information is presented by TABLE name.

AutoRefresh mode is available under this screen.

To update the screen, type the command REFRESH and press Enter, or press PF04/PF16.

To return to the Active Environment screen, press the END key (PF03/PF15).

Two formats for the View Graph screen are available, one for color displays and one for non-color displays. They are discussed on the following pages.

View Graph Screen Format for Color Terminals

Figure 45 View Graph Screen Format for Color Terminals

--------------------------- VIEW GRAPH - BY TABLE --------------------(3.GRAPH)
COMMAND ===>                                                    SCROLL===> CRSR
TOTAL  WAIT SCHEDULE    674   EXECUTING     28  END NOTOK     11  END OK   1549
TABLE NAME -------------SUM %---+---20----+---40----+---60----+---80----+--100%
EBD-PRODUCTION           27 B100BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
GPL-PRODUCTION           35 G100GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG
MT-PRODUCTION            40 B100BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
VEJ-JOBS                 39 G100GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG
PROD-KPL                 16 B100BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
INTER-PRODUCTION         42 RR50RRRRRRRRRRRRRRRRRRRRRGG50GGGGGGGGGGGGGGGGGGGGG
NTN-APPLICATION          35 B100BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
APPL-PROD-INTERNAL       37 B100BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
CLIENTS-STATEMENTS       38 R100RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
PR-PRODUCTION            40 B100BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
BR-IVP-CC                10 B100BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
SYSTEMS-JOBS             36 B100BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
CICS-BATCH-JOBS          28 G100GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG
DD-NIGHT-PROD            37 B100BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
BKP-PROD-L               10 BB20BBBBBBYY20YYYYYYRR40RRRRRRRRRRRRRRRRGG20GGGGGG
BKP-PROD-ACCOUNT          9 B100BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
BKP-PROD-DD              14 R100RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
FDS-JOBS                 39 R100RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR
JJL-NIGHT-PROD           33 B100BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
COMMANDS:    REFRESH (VIEW DATA)        END (RETURN TO ACTIVE SCREEN)  01.26.56

Fields of the View Graph Screen

Table 67 Fields of the View Graph Screen

Job Graph

In the job graph (D), job statuses are differentiated by color, as follows:

Table 68 Job Status Color

For each table in the graph, the number of columns of a particular color depends on the number of jobs having that status.

View Graph Screen Format for Non-Color Terminals

Figure 46 View Graph Screen Format for Non-Color Terminals

--------------------------- VIEW GRAPH - BY TABLE --------------------(3.GRAPH)
COMMAND ===>                                                    SCROLL===> CRSR
TOTAL  WAIT SCHEDULE    674   EXECUTING     28  END NOTOK     11  END OK   1549
TABLE NAME -------------SUM ----+---20----+---40----+---60----+---80----+--100%
EBD-PRODUCTION           27 $100$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
GPL-PRODUCTION           35 %100%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
MT-PRODUCTION            40 $100$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
VEJ-JOBS                 39 %100%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
PROD-KPL                 16 $100$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
INTER-PRODUCTION         42 **50*********************%%50%%%%%%%%%%%%%%%%%%%%%
NTN-APPLICATION          35 $100$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
APPL-PROD-INTERNAL       37 $100$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
CLIENTS-STATEMENTS       38 *100**********************************************
PR-PRODUCTION            40 $100$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
BR-IVP-CC                10 $100$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
SYSTEMS-JOBS             36 $100$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
CICS-BATCH-JOBS          28 %100%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
DD-NIGHT-PROD            37 $100$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
BKP-PROD-L               10 $$20$$$$$$++20++++++**40****************%%20%%%%%%
BKP-PROD-ACCOUNT          9 $100$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
BKP-PROD-DD              14 *100**********************************************
FDS-JOBS                 39 *100**********************************************
JJL-NIGHT-PROD           33 $100$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
COMMANDS:    REFRESH (VIEW DATA)        END (RETURN TO ACTIVE SCREEN)  01.26.56

Fields of the View Graph Screen

Table 69 Fields of the View Graph Screen

The data lines display the following information about each table:

Job Graph

In the job graph, job statuses are differentiated by symbols, as follows:

Table 70 Job Graph Status Symbols

For each table in the graph, the number of columns containing a particular symbol depends on the number of jobs having that status.

Why Screen

The Why screen (Screen 3.?) is displayed when the ? (Why) option is entered on the Active Environment screen. The Why screen shows the reasons why a job is in WAIT SCHEDULE status.

Figure 47 Active Environment Why Screen

------------------------ PRUPDT02 SCHEDULING ANALYSIS --------------------(3.?)
COMMAND ===>                                                    SCROLL===> CRSR
OPT DESCRIPTION                                                              
                                                                             
    TIME LIMIT       FROM   1730             UNTIL    0200                   
    RESOURCE         DB2-POWER               QUANTITY 0030                   
                               HELD BY   PRDKPL01 (U)  QUANTITY 0022         
                               HELD BY   GPLIR17A (U)  QUANTITY 0020         
                               HELD BY   INTR0002 (U)  QUANTITY 0015         
                               HELD BY   PRUPDOLV (U)  QUANTITY 0010         
                               HELD BY   MTPRQV   (U)  QUANTITY 0025         
    RESOURCE         CARTRIDGE               QUANTITY 0002                   
                               HELD BY   PRDKPL01 (U)  QUANTITY 0001         
                               HELD BY   GPLIR17A (U)  QUANTITY 0002         
    IN HOLD STATE                                                            
    CONDITION  PRUPDT01-ENDED-OK                        ODATE  0606          
    NOT-COND   PRPLD03-ENDED-NOTOK                      ODATE  0606          
    SCHEDULING ANALYSIS FOR SMART TABLE  ACCOUNT (ACCOUNT-GROUP)             
    SMART TABLE’S RUNTIME CRITERIA SATISFIED                                       
 ====== >>>>>>>>>>>>>>>>>>>>>   END OF "WHY" LIST   <<<<<<<<<<<<<<<<<<<<< =====
                                                                             
                                                                             
                                                                             
OPTION:  A ADD CONDITION  D DELETE NOT-COND                            10.32.27

To return to the Active Environment screen, press the END key (PF03/PF15).

Possible WHY reasons are:

• ALL RUNTIME CRITERIA SATISFIED. JOB WILL BE SUBMITTED SOON

• CONTROL-M MONITOR IS NOT ACTIVE

• IN HOLD STATE

• WAIT CONFIRMATION

• TIME LIMIT FROM hhmm UNTIL hhmm

• NEXT RUN FROM mmddyyhhmm

• CONDITION condition-name ODATE mmdd

  Prerequisite condition required by the job, along with its original scheduling date.

• RESOURCE resource-name [R] QUANTITY quantity BY priority memname

  Name and quantity of a Quantitative resource not currently available for the job. For critical path jobs, a job with a higher path priority than the current job is also identified.

• CONTROL OVER resource TYPE type BY priority memname [ownership type]

  Name and type of a Control resource currently being used by another job order, which is identified by name. For critical path jobs, path priority of the owner is also identified.

• CONTROL OVER resource TYPE type HELD BY priority ******** [ownership type] IOAID ioaid

  Name and type of a Control resource currently being used by another job order in a different instance of the Control-M monitor. The IOAID of the monitor holding this resource is also shown.

• [L|G]-WORKLOAD policy_name REACHED MAX JOBS POLICY LIMIT OF number

  Name of Workload Policy (either Local or Global) that did not allow the job to run, and the number of concurrent jobs set as the maximum limit in the JOB-type rule in the Workload Policy.

  If a description is defined in the Workload Policy rule, an additional line provides the description.

  If a Load-Index is defined in the Workload Policy rule (limiting the enforcement of the rule to a threshold load level), an additional line provides the name of the Load-Index and the current Load-Index level.

  Below is an example:

  Copy

  ------------------------ M17WAIT3 SCHEDULING ANALYSIS --------------------(3.?)
   COMMAND ===>                                                    SCROLL===> CRSR
   OPT DESCRIPTION                                                                
                                                                                  
       L-WORKLOAD SCHENV               REACHED MAX JOBS POLICY LIMIT OF 0001      
       DESCRIPTION: ONLY 1 SCHEDULE ENVIRONMENT SHOULD 1                          
       L-WORKLOAD GROUP SCHN           REACHED MAX JOBS POLICY LIMIT OF 0001      
       DESCRIPTION: ONLY SCH ENV                                                  
       DUE TO LOAD-INDEX LI123              AT LEVEL CRITICAL                   
    ====== >>>>>>>>>>>>>>>>>>>>>   END OF "WHY" LIST   <<<<<<<<<<<<<<<<<<<<< =====

• required_number RESOURCES resource_name NOT AVAILABLE FOR 
         [L|G]-WORKLOAD policy_name DUE TO MAX OF number

  Required number of a specific resource were not available for the job, due to a RESOURCE-type rule in the Workload Policy (either Local or Global). The rule set a maximum limit for the number of resources that the job is allowed to use.

  If a description is defined in the Workload Policy rule, an additional line provides the description.

  If a Load-Index is defined in the Workload Policy rule (limiting the enforcement of the rule to a threshold load level), an additional line provides the name of the Load-Index and the current Load-Index level.

• L-WORKLOAD policy_name  JOBS EXECUTION POSTPONED
  WHILE [L|G]-WORKLOAD blocking_policy_name JOBS ARE EXECUTING

  Name of Local Workload Policy that did not allow the job to run, due to a SEPARATE EXECUTION rule that blocks job execution at the same time as jobs from other Workload Policies (specifically listed in the rule). Each blocking Workload Policy that had running jobs is listed on a separate line.

  If a description is defined in the Workload Policy rule, an additional line provides the description.

  If a Load-Index is defined in the Workload Policy rule (limiting the enforcement of the rule to a threshold load level), an additional line provides the name of the Load-Index and the current Load-Index level.

• JOB WAIT FOR PIPES COLLECTION

  PIPE pipename

  The job was not run for one of the following reasons:

  • Control-M is waiting for the minimum number of participants in the indicated pipe.

  • At least one prerequisite (prerequisite condition, resource, confirmation, and so on) for a participant in the indicated pipe is not satisfied.

If the job belongs to a SMART Table, the Why screen displays messages related to both the selected job and the table to which the job belongs. In this case, the reasons indicated above may be applicable to the selected job and/or to the table.

To enable you to distinguish between "job" reasons and "table" reasons, the job reasons appear in the screen before the table reasons, and the two sets of reasons are separated by the following line:

TABLE SCHEDULING ANALYSIS FOR TABLE table-memname (tablename)

In addition to the above line, the following reasons can appear only for a job in a SMART Table:

• JOB’S RUNTIME CRITERIA SATISFIED

  This reason applies to the job.

• TABLE’S RUNTIME CRITERIA SATISFIED

  This reason applies to the table.

• WAIT WORKLOAD

  The job was not run for one of the following reasons:

  • WORKLOAD <workload_name> - REACHED MAX JOBS POLICY LIMIT OF xxxx

  • nnnn RESOURCES <resource_name> NOT AVAILABLE FOR WORKLOAD <workload_name> DUE TO MAX OF mmmm

  Where:

  • xxxx - maximum number of parallel executing jobs for WORKLOAD

  • nnnn - required number of resources for this job

  • mmmm - maximum number of resources defined for WORKLOAD

Condition Display Modes in the Why Screen

If a job is waiting for prerequisite conditions, the conditions can be displayed in the Why screen in two different modes:

• In the Missing Conditions display mode, only the conditions which the job is actually waiting for are displayed. Logical operators and parentheses are not displayed.

• In the All Conditions display mode, all the prerequisite conditions defined for the job are displayed, along with all the relevant logical operators and parentheses.

Conditions for which the job is not waiting because they already exist are displayed with the string 'SATISFIED' following their original scheduling date. Conditions for which the job is not waiting, even though they do not exist, are displayed with the string 'REDUNDANT' following their original scheduling date. To switch between the display modes, use the CNDSHOW command. Typing CNDSHOW MISSING switches to the Missing Conditions display mode, and typing CNDSHOW ALL switches to the All Conditions display mode.

The condition display mode upon entry to the screen is determined by the value of the SWHYCND variable in the user's profile: If the value of SWHYCND is M, then the Missing Conditions display mode is used (this is also the default, if the SWHYCND variable is not found the user's profile). If the value of SWHYCND is A, then the All Conditions display mode is used.

Adding Conditions in the Why Screen

If the Why screen indicates that a job is waiting for prerequisite conditions, the indicated conditions can be manually added using the Why screen by typing A (Add Condition) in the OPT (Option) field next to the condition.

Specify option A for every condition to be added, and press Enter.

When adding conditions, a confirmation window may be displayed depending on user profile customization. The confirmation window is described in The Why Screen Add Condition or Delete NOT-COND Confirmation Window.

Deleting Negative Conditions in the Why Screen

A negative or inverted condition is a condition that prevents a job from running.

Negative conditions can be seen in the Why screen. They can be identified by the description NOT-COND.

If the Why screen indicates that a job is waiting for a NOT-COND (negative condition) that is preventing the job from running, the NOT-COND can be deleted manually. This enables the job to run despite the fact that the NOT-COND is true.

To delete a NOT-COND manually, type D (Delete NOT-COND) in the OPT (Option) field next to the condition.

Type D for every NOT-COND to be deleted, and press Enter.

When deleting NOT-COND conditions, a confirmation window may be displayed depending on user profile customization. The confirmation window is described in the following paragraphs.

The Why Screen Add Condition or Delete NOT-COND Confirmation Window

When adding conditions or deleting NOT-COND conditions, a confirmation window may be displayed depending on user profile customization:

• By default, when A or D is entered in the Why screen, a confirmation window is displayed only when the date reference of the condition is **** or $$$$. Addition or deletion of conditions without generic date references is performed without confirmation from the user.

• If, however, the user profile has been customized accordingly, the following confirmation window is always displayed when either A or D is entered.

Figure 48 Why Screen Add Condition or Delete NOT-COND Confirmation Window

------------------------ WRUPDT02 SCHEDULING ANALYSIS --------------------(3.?)
COMMAND ===>                                                    SCROLL===> CRSR
OPT DESCRIPTION                                     +-------------------------+
                                                    |  CONFIRM     MMDD 0606  |
 A  CONDITION  PROD-WRUPDT03-GO            <--------|  ASK FOR EACH ONE Y     |
 A  CONDITION  PROD-WRUPDT03-CHECK                  +-------------------------+
 D  NOT-COND   PRPLDT03-ENDED-NOTOK                          ODATE  0606       
====== >>>>>>>>>>>>>>>>>>>        END OF "WHY" LIST     <<<<<<<<<<<<<<<< ======
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
OPTION:  A ADD CONDITION  D DELETE NOT-COND                            18.15.36

Fill in or modify the fields of the confirmation window as follows and press Enter.

Table 71 Fields of the Add Condition or Delete NOT-COND Confirmation Window

Deleting a Job

Control-M allows deletion of WAIT SCHEDULE jobs, jobs that are currently executing, or jobs that have finished executing. To be deleted, a job must be in HELD status. The deletion request is recorded in the IOA Log file. The job is logically deleted, that is, flagged as deleted, from the Active Jobs file immediately. It is physically deleted from the disk the next time cleanup (for example, New Day processing) is performed.

To delete a job, type D (Delete) in the Option field to the left of the job and press Enter.

If a Confirmation window appears, enter Y (yes). See Delete Confirmation Window.

When you delete an executing job, the resources that were held by the job remain held until the next CKP (CHECKPOINT) cleanup process (usually at New Day time).

Deleting Critical Path Jobs

Critical path jobs (even in HELD status) that hold a Control or Quantitative resource can only be deleted through the following steps:

1. Remove the critical path priority of the job using the Zoom screen (Screen3.Z).

2. Free the job.

3. When the job reverts to WAIT SCHEDULE status, hold the job.

4. Delete the job.

Deleting SMART Table Entities

When a SMART Table Entity is deleted, all the jobs belonging to the SMART Table are deleted. When a SMART Table is deleted, and a job within the SMART Table is undeleted, the SMART Table Entity itself is undeleted together with the job. To delete a SMART Table, its SMART Table Entity must first be in WAIT or END status. Place the SMART Table Entity in HELD status. After a SMART Table Entity is in HELD status, you can delete the SMART Table.

If all the jobs within a SMART Table are deleted, you can delete the SMART Table Entity itself through the following steps:

1. Put the SMART Table on hold. If it is already held, free it, then put it on hold again.

2. Delete the SMART Table Entity.

The reason for freeing a held table and then putting it on hold again before attempting to delete it is that, for efficiency, when a table is held, Control-M does not check the status of the jobs in it.

Delete Confirmation Window

When requesting job deletions, a Delete Confirmation window may be displayed, depending on user profile customization:

• By default, when option D is entered in the Active Environment screen, deletion requests are performed without confirmation from the user.

• If, however, the user profile has been customized accordingly (with profile variable SACTDEL=Y), the following Delete Confirmation window is displayed, in sequence, for each deletion request.

• If the job that you are deleting is currently executing, the Confirmation message includes this information ("The job is executing. Are you sure you want to continue").

• If an executing job is holding resources, the Confirmation message includes this information, as well. In such a case, the Confirmation window appears regardless of user profile customization.

Figure 49 Active Environment Screen Delete Confirmation Window

Filter:           ------- CONTROL-M  Active  Environment ------ UP    <D> - (3)
COMMAND ===>                                                    SCROLL ==> CRSR
O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
  PRD1     PROD     060601                  JOB Wait Schedule (Pipe)          
  IEFBR14T TEST     060601 M70TEST0/24897   JOB Ended "OK"                    
  PRD1     PROD     060601                  JOB Wait Schedule (Pipe)          
  IEFBR14T           +------------------------+ Ended "OK"                    
D SELITBL   <--------|    Delete      (Y/N)   | Ended- Not "OK"               
  TBLJOB1            +------------------------+ Ended "OK"                    
  TBLJOB2  TEST     060601 M70TEST2/24929   JOB Ended "OK"                    
  TBLJOB3  TEST     060601 M70TEST3/24930   JOB Ended- Not "OK" - Abended     
========= >>>>>>>>>>>>>        Bottom of Jobs List       <<<<<<<<<<<<< ========
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
Opt: ? Why L Log H Hold Z Zoom R Rerun A Activate O Force OK V View Sysout  
     N Net D Del F Free S Stat T Table U Undelete J JCL Edit C Confirm 16.28.18

Fill in the window as follows and press Enter.

To confirm the delete request, type Y (Yes) in the window.

To cancel the delete request, type N (No) in the window.

Log Screen

To display the Log screen, type option L (Log) in the Active Environment screen. The Log screen displays all Log messages of the specified job.

Figure 50 Active Messages Log Screen

FILTER:            -- LOG MESSAGES FOR JOB(S) INTR0004 -----------------(3.LOG)
COMMAND ===>                                                    SCROLL===> CRSR
SHOW LIMIT ON ==>                                          DATE 060601 - 060601
DATE   TIME   ODATE  USERID   CODE    ------ M E S S A G E --------------------
060601 131143 060601 M22      JOB511I JOB INTR0004 ODATE 060601 ID=00019 PLACED
                                      ON ACTIVE JOBS FILE -                   
060601 131148 060601 M22      SEL203I JOB INTR0004 ELIGIBLE FOR RUN           
060601 131150 060601 M22      SUB133I JOB INTR0004 SUBMITTED                  
060601 131651 060601 M22      SPY281I JOB INTR0004 INTR0004/04371 START       
                                      98253.1316 STOP 98253.1316 CPU 0MIN     
                                      00.04SEC SRB 0MIN 00.00SEC 0.19 9QFDSF  
060601 131651 060601 M22      SPY254I JOB INTR0004 INTR0004/04371 SCANNED     
060601 131652 060601 M22      SEL206W JOB INTR0004 INTR0004/04371 ABENDED CC  
                                      SB37 STEP STEP01                        
060601 131652 060601 M22      SEL219I JOB INTR0004 INTR0004/04371 ENDED "NOT  
                                      OK"                                     
060601 132814 060601 M22      CTM659I RERUN OF TASK INTR0004 ODATE 060601     
                                      PERFORMED                               
060601 132817 060601 M22      SEL220I JOB INTR0004 WILL BE RERUN              
060601 132818 060601 M22      SEL203I JOB INTR0004 ELIGIBLE FOR RUN           
060601 132818 060601 M22      SUB133I JOB INTR0004 SUBMITTED                  
======== >>>>>>>>>>>>>>>>    NO MORE LOG MESSAGES    <<<<<<<<<<<<<<<<< ========
                                                                              
CMDS: SHOW, TABLE, CATEGORY, SHPF                                      13.24.01

Usage of the Log screen is explained in detail in IOA Log Screen. However, if you entered the Log screen by option L on the Active Environment screen instead of by option 5 on the IOA Primary Option menu, note the following differences in usage:

• The SHOW command cannot be used with any parameters or qualifiers.

• Only filter options related to Control-M (and CMEM) are displayed in the Show Screen Filter window.

• Only the default job filter can be displayed.

If you enter L (Log) in the O (Option) column for multiple jobs in the Active Environment screen, the log displays are stacked. Each time the END key (PF03/PF15) is pressed, the next log in the stack is displayed, until all logs have been displayed.

To return to the Active Environment screen, press END (PF03/PF15).

Zoom Screen

The Zoom screen "zooms in" on the details of a specific job order. To display the Zoom screen, type Z (Zoom) on the Active Environment screen.

Figure 51 Control-M Zoom Screen

------------------------- CONTROL-M ZOOM SCREEN --------------------------(3.Z)
COMMAND ===>                                                    SCROLL===> CRSR
+------------------------------------------------------------------------------+
  MEMNAME PRDKPL01    MEMLIB   CTM.PROD.JOBLIB                              
  OWNER   M44         TASKTYPE JOB              PREVENT-NCT2   DFLT  N      
  SCHDTAB MIKLE       SCHDLIB  CTMP.V524.SCHEDULE                           
  APPL    PROD           TBL KPL                  RBC 
  OVERLIB                                                   STAT CAL PERIOD  
  SCHENV                          SYSTEM ID                 NJE NODE        
  JOBNAME           JOBID           ODATE 060601 ORDERID 0005C     MAXWAIT 04
  RESTART DECISION-FROM          .           TO          .         CONFIRM N 
  DESC    DAILY PRODUCTION - START OF PRODUCTION TABLE KPL                  
  SET VAR                                                                   
  CTB STEP AT         NAME           TYPE                                   
  DOCMEM  PRDKPL01    DOCLIB   CTM.PROD.DOC                                 
  =============================================================================
  NOTE  
  =============================================================================
  DOC 
  =============================================================================
  IN       DAILY-PROD-KPL-GO    0606                                         
  CONTROL  DB2-MAIN-FILE        E                                            
  RESOURCE INIT                 0001      CART                 0001          
  PIPE     CTM.PROD.PIPE                                                     
  FROM TIME      +     DAYS  UNTIL TIME      +     DAYS     PRTY    CONFIRM  
  DUE IN         +     DAYS  ELAPSE                DUE OUT      +     DAYS   
  TIME ZONE:                    WAIT FOR ODATE:                              
  CPU-ID    NODE NAME           NJE      SEARCH COUNTER         LPAR OS35    
  =============================================================================
  OUT      PROD-PRDKPL01-OK    0606 +                                        
  AUTO-ARCHIVE Y           SYSDB    Y          MAXDAYS       MAXRUNS         
  RETENTION:  # OF DAYS TO KEEP     # OF GENERATIONS TO KEEP                 
  SYSOUT OP C (C,D,F,N,R) 2                                           FROM   
  MAXRERUN      MEMBER          INTRVL        FROM END   NXT RUN             
  STEP RANGE         FR (PGM.PROC)          .          TO          .         
  ON PGMST          PROCST         CODES                             A/O *   
    DO                                                                       
  ON SYSOUT                                      FROM 001 TO 132    A/O  *
    DO                                                                       
  ON VAR                                                                     
    DO                                                                       
  SHOUT WHEN NOTOK    TIME        +      DAYS     TO OPER2            URGN R 
    MS DAILY PRODUCTION JOB PRDKPL01 ENDED NOT OK. NOTIFY PRODUCTION MANAGER 
  SHOUT WHEN          TIME        +      DAYS     TO                  URGN   
    MS                                                                       
  =============================================================================
  APPL TYPE                                  APPL VER                        
  APPL FORM                                  CM   VER                        
  INLINE JCL: N                                                              
                                                                             
 ====== >>>>>>>>>>>>>>>>>>> END OF JOB PARAMETERS <<<<<<<<<<<<<<<<<<<<<<< ======
COMMANDS: CANCEL  DOC  NOTE                                               18.33.28

The Zoom screen is similar to the Job Scheduling Definition screen used for defining job production parameters, but it is different in several respects:

• The Zoom screen contains fields that do not appear in the Job Scheduling Definition screen (and vice versa).

• Some fields on the Zoom screen cannot be modified at all. Other fields can or cannot be modified depending on the status of the job.

• Changes to a field in the Zoom screen affect only the current job order, not the job scheduling definition.

For information about most fields in the Zoom screen, see Job Scheduling Definition Screen – Defining Schedules.

Fields of the Zoom screen that are not in the Job Scheduling Definition screen are described below:

Table 72 Fields of the Job Scheduling Definition Zoom Screen

Only specific dates (or ****, $$$$ or STAT) can be used as valid condition date references. Therefore, if symbolic date references (such as ODAT or PREV) are entered as condition date references (in the parameters IN, OUT, CODES, COND, and so on) in the job scheduling definition, the real date values are derived and displayed in the Zoom screen.

§Restart§ The restart decision parameters (FROM, TO, CONFIRM) contain a value other than blank only if

• the DO IFRERUN parameters have been specified in the Job Scheduling Definition screen (Screen 2)

  and

• the job was executed.§Restart§

When and if the job is restarted, these parameters are used. You can modify the value of these parameters.

The DOC command can be used to alternately display and hide the documentation (DOC lines). Documentation cannot be updated in the Zoom screen.

Zoom Screen for Table Entities

An example of the Zoom screen for Table Entities is shown below.

As noted earlier, a job must be placed in the Held state before entering the Zoom screen if changes are to be saved. When a SMART Table Entity is held, changes to jobs within the SMART Table can be saved without having to separately place a hold on each job.

All information applicable to the regular Zoom screen applies to the SMART Table Entity Zoom screen as well. All fields in the SMART Table Entity Zoom screen also appear in the Zoom screen for regular job scheduling definitions. For a description of the fields in the SMART Table Entity Zoom screen, refer to the descriptions of the regular Zoom screen, the Job Scheduling Definition screen, and the SMART Table Entity screen.

Figure 52 Zoom Screen for SMART Table Entities

----------------------------- CONTROL-M ZOOM SCREEN ----------------------(3.Z)
COMMAND ===>                                                    SCROLL===> CRSR
+-----------------------------------------------------------------------------+
  OWNER   N04A        TASKTYPE TBL                                            
  SCHDTAB SPDCRP      SCHDLIB  CTM.PROD.SCHED                                 
  APPL                      GRP ACCCOUNTING          RBC                      
  JOBNAME           JOBID          ODATE 060601 ORDERID 000IH  TBL MAXWAIT 00 
  DESC                                                                        
                                                                              
  KEEP JOBS UNTIL REMOVED N        KEEP AT LEAST 00 DAYS AFTER ENDED NOT OK   
  SET VAR                                                                     
  DOCMEM  ACCOUNT     DOCLIB   CTM.CMEM.DOC                                   
  =========================================================================== 
  IN                                                                          
                                                                              
  CONTROL                                                                     
  FROM TIME         +     DAYS    UNTIL TIME    +     DAYS   PRTY 11 CONFIRM N
  DUE IN            +     DAYS    ELAPSE              DUE OUT     +    DAYS   
  TIME ZONE:                         WAIT FOR ODATE: N                        
  =========================================================================== 
  OUT                                                                         
  MAXRERUN                                                                    
  CYCLIC TYPE: C                       INTRVL        FROM     NXT RUN         
  INTERVAL SEQUENCE: +         +         +         +         +                
  SPECIFIC TIMES:                                             TOLERANCE  000  
                                                                              
  ON TABLE-END OK                                                             
    DO COND     ACCOUNTING-OK        0909 +                                   
  ON VAR                                                                      
    DO                                                                        
  SHOUT WHEN           TIME       +     DAYS     TO                  URGN    
    MS                                                                        
 ====== >>>>>>>>>>>>>>>>>>> END OF JOB PARAMETERS <<<<<<<<<<<<<<<<<<<<<<< =====
                                                                              
                                                                              
                                                                              
COMMANDS:  SAVE  DOC  NOTE  JVER                                       11.41.46