Introduction to Control-M

This chapter includes the following topics:

Overview

Control-M is an automated production control and scheduling system that manages and automates the setup, scheduling and execution of jobs in the z/OS data center.

The Control-M for z/OS Getting Started Guide provides you with an introduction to the functionality of Control-M, and teaches you how to use Control-M, one step at a time, with each step building upon what was learned in the previous step. Of necessity, the explanations of topics in this book are not comprehensive. For comprehensive explanations of topics, you should refer to the relevant guide, such as the Control-M for z/OS User Guide, INCONTROL for z/OS Administrator Guide, and so on.

The first chapter of the Control-M for z/OS User Guide provides an introduction to Control-M. You might find it useful to read that chapter before using this guide; however, you can still easily use this guide without having read that chapter in the User Guide.

This guide begins with a discussion of the main components of Control-M:

  • Scheduling Definition facility

  • Tracking and Control facility: Active Environment screen

Before you are introduced to the main components of Control-M, you should prepare the jobs that you will need in order to perform the exercises in this chapter.

Preparations

Create the JCL for two trivial jobs, identified throughout this guide as IDJOB1 and IDJOB2. Define the jobs to execute IEFBR14. For purposes of this guide, identify the JCL library as CTM.TEST.JCL.

Main Components of Control-M

Control-M automates the setup, scheduling, and execution of jobs in the z/OS environment. This is essentially a two-step process:

  1. You must tell Control-M how you want job processing handled.

    • Job scheduling and processing instructions are provided through the Scheduling Definition facility, a main component of Control-M.

    • You specify these instructions in job scheduling definitions that you define in the Job Scheduling Definition screen. Each job scheduling definition must be defined only once; it can then be used as often as needed. Job scheduling definitions are stored in tables, or members, in a scheduling library.

  2. Using the instructions you provided in the job scheduling definitions, Control-M automatically tracks and controls the setup, scheduling, and execution of the job. Control-M provides you with constant feedback on job processing, and enables you to manually intervene in the processing of jobs, through a series of screens.

    • "Tracking and Control facility" is a general term that applies to the screens that provide feedback on job processing, and enable manual intervention. The main screen in this facility is the Active Environment screen, which provides status and other information for currently scheduled and recently completed jobs, and accepts your commands and instructions. The Active Environment screen also acts as a gateway to other screens in the Tracking and Control facility.

You will take a first look at these components by doing the following in your first set of exercises:

  • You will use the Scheduling Definition facility to create job scheduling definitions for the two trivial jobs you just defined.

    • You will make submission of the first job dependent on a manual intervention performed in the Active Environment screen.

    • You will make submission of the second job dependent on successful completion of the first job.

  • You will order the jobs.

  • You will observe the results in the Active Environments screen. Along the way, you will become familiar with several commands, options and windows in the Active Environment screen. You will also become familiar with the Control-M Log screen.

To do this, enter the IOA Online facility, take a look at the main components of Control-M, and perform the exercises.

Online Facility Primary Options

The primary options of the Online facility are displayed when you enter the IOA Primary Option menu. Several of these options relate to Control-M. Through most of this guide, you will concentrate on two options:

  • Option 2, which provides access to the Scheduling Definition facility

  • Option 3, which provides access to the Active Environment screen, the main screen of the Tracking and Control facility.

  1. Request Option 2 from the IOA Primary Option menu, to access the Scheduling Definition facility.

    The Scheduling Definition Facility entry panel is displayed.

    Figure 1 Control-M Scheduling Definition Facility - Entry Panel

    Copy 
    ----------- CONTROL-M SCHEDULING DEFINITION FACILITY - ENTRY PANEL ---------(2)
    COMMAND ===>                                                               
                                                                               
                                                                               
                                                                               
    SPECIFY LIBRARY, TABLE, JOB                                     
                                                                               
       LIBRARY ===> CTM.TEST.SCHEDULE                                          
       TABLE   ===>                     (Blank for table selection list)       
       JOB     ===>                     (Blank for job selection list)         
                                                                               
       SMART TABLE         ===>       (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

Introduction to the Scheduling Definition Facility

You are about to create a Control-M job scheduling definition for each of the jobs, IDJOB1 and IDJOB2, that you just defined. The JCL member name of the job should be used as the name of its corresponding job scheduling definition.

Job scheduling definitions are stored in tables (members) in a scheduling library. A default scheduling library name automatically appears in the entry panel. Ensure that you use a test library or your own work library. You should not use the JCL library.

For purposes of illustration in this guide, the scheduling library is identified as CTM.TEST.SCHEDULE. In this library, you will be creating a table called IDGS1. Use your unique identifier as the first characters of the table name.

You can now begin defining the job scheduling definition for IDJOB1.

  1. Fill in the LIBRARY, TABLE, and JOB name fields in the entry panel. The request appears similar to Figure 2.

    Figure 2 Control-M Scheduling Definition Facility - Entry Panel

    Copy 
    ----------- CONTROL-M SCHEDULING DEFINITION FACILITY - ENTRY PANEL ---------(2)
    COMMAND ===>                                                          
                                                                          
                                                                          
                                                                          
    SPECIFY LIBRARY, TABLE, JOB
                                                                          
       LIBRARY ===> CTM.TEST.SCHEDULE                                 
       TABLE   ===> IDGS1               (Blank for table selection list)
       JOB     ===> IDJOB1              (Blank for job selection list) 
                                                                          
       SMART TABLE         ===>      (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

    After entering the entry panel request, the Job Scheduling Definition screen is displayed. A full job scheduling definition, which contains more lines than your screen can display, is illustrated in Figure3.

    The first line in the screen, which is displayed above the COMMAND line, contains the same information about the job that you provided in the entry panel.

    Figure 3 Job Scheduling Definition Screen

    Copy 
    JOB: JOB1     LIB CTM.TEST.SCHEDULE                             TABLE: IDGS1
    COMMAND ===>                                                    SCROLL===> CRSR
    +-----------------------------------------------------------------------------+
      MEMNAME IDJOB1      MEMLIB                                                 
      OWNER   ID          TASKTYPE JOB    PREVENT-NCT2   DFLT  N                 
      APPL                                GROUP                                  
      DESC                                                                       
      OVERLIB                                                   STAT CAL         
      SCHENV                         SYSTEM ID                  NJE NODE         
      SET VAR                                                                    
      CTB STEP AT         NAME            TYPE                                   
      DOCMEM  IDJOB1      DOCLIB                                                 
      ===========================================================================
      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 00   D-CAT                    
      MINIMUM          PDS                                                       
      DEFINITION ACTIVE FROM          UNTIL                                      
      ===========================================================================
      IN                                                                         
      CONTROL                                                                    
      RESOURCE                                                                   
      PIPE                                                                       
      FROM TIME         +     DAYS    UNTIL TIME      +     DAYS  
      DUE OUT TIME      +     DAYS    PRIORITY     SAC    CONFIRM 
      TIME ZONE:                                                  
      ===========================================================================
      OUT                                                                        
      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                                                                       
      SHOUT WHEN           TIME       +     DAYS     TO                  URGN
        MS                                                                       
    ======= >>>>>>>>>>>>>>>>>>> END OF SCHEDULING PARAMETERS <<<<<<<<<<<<<<<< =====
     COMMANDS: EDIT, DOC, PLAN, JOBSTAT                                    11.17.00

    The Job Scheduling Definition screen is divided into sections, with each section separated from another by a line of equal signs (= =). Later, you will learn more about these sections and the fields they contain. The following table describes the fields of the Job Scheduling Definition screen that you will complete during these exercises.

    Table 1 Job Scheduling Definition Screen Field Descriptions

    Field

    Description

    MEMNAME

    Name of the member that contains the JCL of the job.

    MEMLIB

    Name of the library that contains the JCL of the job.

    GROUP

    Name of the group to which the job belongs.

    DESC

    Free text description of the job.

    DAYS

    Days of the month to schedule the job.

    CONFIRM

    Yes/No indicator (Y/N) specifying whether manual confirmation is required before the job can be submitted.

    OUT

    Prerequisite conditions to be added and/or deleted when the job ends OK

  2. Fill in the fields as indicated in the following table.

    Table 2 Values for Job Scheduling Definition Screen Fields

    Field

    Value to Enter (in Bold), and Explanation

    MEMNAME

    IDJOB1. This value, taken from the entry panel, already appears, because you specified the JCL member name in the JOB field of the entry panel.

    MEMLIB

    Name of the library containing JCL member IDJOB1. For purposes of illustration, you should use CTM.TEST.JCL

    GROUP

    IDGRP1. This name will later be used to filter the display of jobs in the Active Environment screen by Group name.

    DESC

    THIS JOB MUST BE RUN BEFORE IDJOB2 (to remind you what this job does).

    DAYS

    ALL (Schedule the job every day.)

    CONFIRM

    Y (Yes - you want manual confirmation for the job.)

    OUT

    IDJOB1-ENDED-OK    ODAT   +     (After specifying IDJOB1-ENDED-OK, press Tab to get to the field in which to enter ODAT.)

    The Job Scheduling Definition screen is displayed as shown in Figure4.

    Figure 4 Job Scheduling Definition Screen Showing Completed Fields

    Copy 
    JOB: IDJOB1   LIB CTM.TEST.SCHEDULE                             TABLE: IDGS1
    COMMAND ===>                                                    SCROLL===> CRSR
    +-----------------------------------------------------------------------------+
      MEMNAME IDJOB1      MEMLIB   CTM.TEST.JCL                    
      OWNER   ID          TASKTYPE JOB    PREVENT-NCT2   DFLT  N               
      APPL                                GROUP IDGRP1                 
      DESC    THIS JOB MUST BE RUN BEFORE IDJOB2                   
      OVERLIB                                                   STAT CAL       
      SCHENV                         SYSTEM ID                  NJE NODE       
      SET VAR                                                                  
      CTB STEP AT         NAME            TYPE                                 
      DOCMEM  IDJOB1      DOCLIB                                               
      ===========================================================================
      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                      RETRO N MAXWAIT 00  D-CAT                   
      MINIMUM          PDS                                                     
      DEFINITION ACTIVE FROM          UNTIL                                    
      ===========================================================================
      IN                                                                       
      CONTROL                                                                  
      RESOURCE                                                                 
      PIPE                                                                     
      FROM TIME         +     DAYS    UNTIL TIME      +     DAYS  
      DUE OUT TIME      +     DAYS    PRIORITY 00  SAC    CONFIRM Y
      TIME ZONE:                                                  
      ===========================================================================
      OUT      IDJOB1-ENDED-OK      ODAT +                         
      AUTO-ARCHIVE            SYSDB           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                                                                     
      SHOUT WHEN           TIME       +     DAYS     TO                  URGN   
        MS                                                                     
    ======= >>>>>>>>>>>>>>>>>>> END OF SCHEDULING PARAMETERS <<<<<<<<<<<<<<<< =====
     COMMANDS: EDIT, DOC, PLAN, JOBSTAT                                    11.17.00

  3. Exit the Job Scheduling Definition screen. The Job List screen is displayed.

    Figure 5 Job List Screen

    Copy 
    JOB LIST     LIB: CTM.TEST.SCHEDULE                             TABLE: IDGS1
    COMMAND ===>                                                    SCROLL===> CRSR
    OPT  NAME ----- DESCRIPTION ---------------------------------------------------
         IDJOB1     THIS JOB MUST BE RUN BEFORE JOB2                            
     ====== >>>>>>>>>>>>>>>>    NO MORE JOBS IN TABLE     <<<<<<<<<<<<<<<<<<< =====
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
    OPTIONS S SEL D DEL I INS O ORDER F FORCE J JCL C COPY P PLN T JOBSTAT 15.37.39

    The format of the Job List screen may be different than the format indicated in the screen example shown above. The different formats of the Job List screen will be discussed later in this chapter. The following procedure will ensure that you are working with the desired format.

  4. Enter DESC in the COMMAND field of the Job List screen.

    • The Job List screen has the same format as the screen example shown above.

    • The Job List screen contains the list of jobs in the table. In this case, since you created a new table and only one job, there is only one job (IDJOB1) in the list. Notice that the description you provided in the job scheduling definition appears next to the job name in the Job List screen.  Providing useful identifying information in the DESC field of the job scheduling definition can help you with job identification in the Job List screen.

    • You will now create the job scheduling definition for IDJOB2. You could do this much the same way that you created IDJOB1, that is, by returning to the entry panel and there specifying the name IDJOB2. But instead, you will create the job from the Job List screen.

  5. Type I (Insert) in the OPT (Option) field to the left of the entry for IDJOB1, and press Enter.

    Copy 
    JOB LIST     LIB: CTM.TEST.SCHEDULE                             TABLE: IDGS1
    COMMAND ===>                                                    SCROLL===> CRSR
    OPT  NAME ----- DESCRIPTION ---------------------------------------------------
     I   IDJOB1     THIS JOB MUST BE RUN BEFORE IDJOB2                          
     ====== >>>>>>>>>>>>>>>>    NO MORE JOBS IN TABLE     <<<<<<<<<<<<<<<<<<< =====

    The Job Scheduling Definition screen is displayed. When you create a new job using the I (Insert) option in the Job List screen, the newly created job contains most of values defined in the job by which you specified the Ioption. Only the MEMNAME, DOCMEM, and DESCRIPTION values are not carried over; instead, these fields are left blank.

    Copy 
    JOB:          LIB CTM.TEST.SCHEDULE                             TABLE: IDGS1
    COMMAND ===>                                                    SCROLL===> CRSR
    +-----------------------------------------------------------------------------+
    MEMNAME             MEMLIB   CTM.TEST.JCL
    OWNER   ID          TASKTYPE JOB    PREVENT-NCT2 Y DFLT  N
    APPL                                GROUP IDGRP1
    DESC
    OVERLIB                                                   STAT CAL
    SCHENV                         SYSTEM ID                  NJE NODE
    SET VAR
    CTB STEP AT         NAME            TYPE
    DOCMEM              DOCLIB
    ===========================================================================
    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
    CONTROL
    RESOURCE
    PIPE
    TIME: FROM       UNTIL       PRIORITY 00  DUE OUT       SAC      CONFIRM Y
    TIME ZONE:
    ===========================================================================
    OUT      IDJOB1-ENDED-OK        ODAT +
    AUTO-ARCHIVE            SYSDB           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
    SHOUT WHEN           TIME       +     DAYS     TO                  URGN
    MS
    ======= >>>>>>>>>>>>>>>>>>> END OF SCHEDULING PARAMETERS <<<<<<<<<<<<<<<< =====
    COMMANDS: EDIT, DOC, PLAN, JOBSTAT                                    11.17.00

  6. Type IDJOB2 in the MEMNAME field. The DOCMEM field will automatically be filled in with the same value. Leave the DESC field blank.

    Copy 
     +-----------------------------------------------------------------------------+
        MEMNAME IDJOB2     MEMLIB   CTM.TEST.JOBLIB                     
        OWNER   M44         TASKTYPE JOB    PREVENT-NCT2 Y DFLT  N            
        APPL                                GROUP IDGRP1                      
        DESC                                                       
        OVERLIB                                                   STAT CAL    
        SCHENV                         SYSTEM ID                  NJE NODE    
        SET VAR                                                               
        CTB STEP AT         NAME            TYPE                              
        DOCMEM  IDJOB2      DOCLIB                                        
        ===========================================================================

  7. In the IN field, define the same value you had defined as the OUT value in  JOB1 (IDJOB1-ENDED-OK ODAT). You should press Tab before typing ODAT, as you did in IDJOB1. The + from the OUT value is not specified. After defining the IN value, delete the Y from the CONFIRM field.

    Copy 
        ===========================================================================
        IN       IDJOB1-ENDED-OK        ODAT                             
        CONTROL                                                              
        RESOURCE                                                             
        PIPE                                                                 
        FROM TIME         +     DAYS    UNTIL TIME      +     DAYS  
        DUE OUT TIME      +     DAYS    PRIORITY 00  SAC    CONFIRM 
        TIME ZONE:                                                  
        ===========================================================================

  8. Change the plus sign (+) to a minus sign (-) in the OUT statement.

    Copy 
        ===========================================================================
        OUT      IDJOB1-ENDED-OK      ODAT -
        AUTO-ARCHIVE            SYSDB           MAXDAYS      MAXRUNS

    The IN and the OUT fields are used for specifying conditions. These conditions can be used to create job dependencies.

    In this exercise, you used condition IDJOB1-ENDED-OK to ensure that IDJOB2 would not be submitted until IDJOB1 successfully completed:

    • You made IDJOB1-ENDED-OK an IN condition for IDJOB2, which means that IDJOB2 cannot be run until this condition exists, that is, until IDJOB1-ENDED-OK has been created.

    • You made IDJOB1-ENDED-OK an OUT condition of IDJOB1, specifying a plus sign in the appropriate place in the condition definition, which means that the condition will only be created after IDJOB1 completed successfully.

      Therefore, IDJOB1 must complete successfully before IDJOB2 can be submitted.

      Specifying the same condition as an OUT condition with a minus sign in IDJOB2 removes the condition once IDJOB2 has successfully ended. This ensures that an old occurrence of the condition will not satisfy the IN criteria.

      Every condition has an associated date value. This can be an explicitly defined date, such as 0909, or a valid keyword value that represents a date. ODAT is a keyword value that defaults to the current original scheduling date of the job. The original scheduling date, and other date concepts, are discussed in Chapter5, "AutoEdit and JCL."

  9. Exit the job scheduling definition for IDJOB2. The Job List screen is displayed. IDJOB2 now appears in the list, but since you did not define a description for it, no description appears for the job.

    Figure 6 Job List Screen

    Copy 
    JOB LIST     LIB: CTM.TEST.SCHEDULE                             TABLE: IDGS1
    COMMAND ===>                                                    SCROLL===> CRSR
    OPT  NAME -------- DESCRIPTION ------------------------------------------------
         IDJOB1        THIS JOB MUST BE RUN BEFORE IDJOB2                       
         IDJOB2                                                              
     ====== >>>>>>>>>>>>>>>>>>>    NO MORE JOBS IN TABLE     <<<<<<<<<<<<<<<< =====
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
    OPTIONS S SEL D DEL I INS O ORDER F FORCE J JCL C COPY P PLN T JOBSTAT 14.58.14

    Notice the options at the bottom of the Job List screen. You will now use one of them, the O (Order) option, to order these two jobs.

  10. Request option O (Order) in the OPT field for both IDJOB1 and IDJOB2.

  11. If a confirm window is displayed, confirm the job order by entering Y in the CONFIRM field.

    Figure 7 Confirm Window

    Copy 
    JOB LIST     LIB: CTM.TEST.SCHEDULE                             TABLE: IDGS1
    COMMAND ===>                +-------------------------------+   SCROLL===> CRSR
    OPT  NAME ---               |   CONFIRM Y   ODATE 020201    | -----------------
     O   IDJOB1     <===========|   ASK FOR EACH ONE  Y         |                
     O   IDJOB2                 +-------------------------------+                
     ====== >>>>>>>>>>>>>>>>>>>    NO MORE JOBS IN TABLE     <<<<<<<<<<<<<<<< =====
    For each job ordered, the Job Order Messages screen with messages similar to the following will be displayed:

    Figure 8 Job Order Messages Screen

    Copy 
    ------------------------ CONTROL-M JOB ORDER MESSAGES --------------------(2.O)
    COMMAND ===>                                                    SCROLL===> CRSR
    -------------------------------------------------------------------------------
     19.40.14 JOB501I CTMJOB STARTED                                              
     19.40.16 JOB528I MEMBER IDJOB1   ID=0006I ODATE 020201 PLACED ON ACTIVE JOBS F
     19.40.16 JOBD6BI NUMBER OF JOBS ORDERED -        1                           
     19.40.16 JOB525I CTMJOB ENDED                                                
     ======= >>>>>>>>>>>>>>>>>>    END OF MESSAGE LIST    <<<<<<<<<<<<<<<<<<< =====

  12. Press PF03/PF15 or enter the END command to exit the Job Order Messages screen each time it is displayed.

    • The Job List screen is displayed.

    • You can now enter the Active Environment screen and check the results of the job orders. You do not have to return to the IOA Primary Option Menu to request Option 3, the Active Environment screen. Instead, by preceding an option with an equal sign (=), you can move directly there from where you are.

  13. Enter =3 in the COMMAND field.

    • The Active Environment screen is displayed.

Introduction to the Active Environment Screen

The Active Environment screen is your main interface to the Tracking and Control facility. It lists currently scheduled jobs. These jobs may or may not have already been submitted, and may or may not have already completed their executions.

Figure 9 Control-M Active Environment Screen

Copy 
Filter:           ------- Control-M  Active  Environment ------ UP    <D>   (3)
COMMAND ===>                                                    SCROLL ==> CRSR
O Name     Owner    Odate  Jobname  JobID Typ ------------ Status -------------
  CICSPROD M22      020201 CICSPROD/04368 CST EXECUTING (RUN 1) GROUP=CICS-PROD
  CICSTEST M22      020201 CICSTEST/04372 CST EXECUTING (RUN 2) GROUP=CICS-TEST
  BRIVPCC  IVP      020201 BRIVPCC /04369 JOB ENDED "OK"        GROUP=BR-IVP-CC
  BRCC0001 IVP      020201 BRCC0001/04382 JOB ENDED "OK"        GROUP=BR-IVP-CC
  BRCC0002 IVP      020201 BRCC0002/04383 JOB ENDED "OK"        GROUP=BR-IVP-CC
  BRCC0003 IVP      020201 BRCC0003/04384 JOB ENDED "OK"        GROUP=BR-IVP-CC
  BRCCIND  IVP      020201 BRCCIND /04385 JOB ENDED "OK"        GROUP=BR-IVP-CC
  BRUPDT02 IVP      020201 BRUPDT02/04387 JOB ENDED "OK"        GROUP=BR-IVP-CC
  BRREP001 IVP      020201 BRREP001/04388 JOB ENDED "OK"        GROUP=BR-IVP-CC
  BRREP002 IVP      020201 BRREP002/04389 JOB ENDED "OK"        GROUP=BR-IVP-CC
  BRIVPCCE IVP      020201         /      JOB WAIT SCHEDULE     GROUP=BR-IVP-CC
  CRCCEND  IVP      020201         /      JOB WAIT SCHEDULE     GROUP=BR-IVP-CC
  INTR0001 M22      020201         /      JOB HELD WAIT SCHEDULE            
                                              GROUP=INTER-PRODUCTION        
  INTR0002 M22      020201         /      JOB HELD WAIT SCHEDULE            
                                              GROUP=INTER-PRODUCTION        
  INTR0003 M22      020201         /      JOB WAIT SCHEDULE                 
                                              GROUP=INTER-PRODUCTION        
  INTR0004 M22      020201 INTR0004/04371 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

This screen is most probably displaying a number of jobs from your site that are not relevant to these exercises. Soon, you will filter the display so that only the relevant jobs are displayed. But first, look at the list of available commands or options at the bottom of the screen.

Toggling Between Display of Commands and Options

The bottom two lines of the Active Environment screen list either the commands or options available in the screen. Upon entry to the screen, the list of commands is displayed.

Commands: OPt DIsplay Show HIstory RBal REFresh Auto Jobstat SHPF Note Table

           OPt command toggles between Commands and Options display      15.15.

The first command listed is OPt, and the bottom line actually explains that command OPt can be used to toggle between the command display and the option display.

  1. Enter OPT in the COMMAND field to toggle to the option display. The list of available options is displayed at the bottom of the screen.

    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 G Group U Undelete J JCL Edit C Confirm  15.46.0

  2. Again, enter OPT in the COMMAND field to redisplay the list of available commands at the bottom of the screen.

    Commands: OPt DIsplay Show HIstory RBal REFresh Auto Jobstat SHPF Note Table

              OPt command toggles between Commands and Options display     15.15.48

    One or the other of the two lists will be particularly relevant for different steps, and you will be instructed, as necessary, to display the appropriate screen. Now that the Command display appears, notice the SHOW command. You will be using the SHOW command in the next set of steps.

Filtering the Active Environment Display

As mentioned above, when you enter the active environment the screen is probably displaying a number of jobs from your site that are not relevant to these exercises. The following steps show how you can filter the display.

  1. Enter SHOW in the COMMAND field. The Show Screen Filter window is displayed.

    Figure 10 Show Screen Filter Window

    Copy 
    --------------------------- Show Screen Filter ---------------------(3.SHOW)- 
    Filter            Save   (Y/N) Desc:                                       
     Memname                                                                    
     Group                                                                      
     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 Tbl Tbc                         
                 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                                                      
                                                                         
    -----------------------------------------------------------------------------
              OPt command toggles between Commands and Options display     11.07.49

    The Show Screen Filter window enables you to filter the display based on certain fields and values. The following steps explain what you need to know in order to create the filter for use in these exercises. Filtering is explained in greater detail in A Closer Look At Filters .

  2. Specify that you want to create and save a filter called IDGS by entering IDGS in the Filter field, and Y in the Save field. Specify a description for the filter by typing GS-EXERCISES in the Desc field.

  3. Define the filtering criteria by specifying IDGRP in the Group field. The filter appears as shown below:

    Copy 
        +------------------- Show Screen Filter -----------(3.SHOW)+
        |  Filter  IDGS      Save Y (Y/N) Desc: GS-EXERCISES       |
        |  Memname                                                 |
        |  Group   IDGRP                                           |
        |  Sch Lib                                      Tbl________|

    The Group field works on a prefix basis. By assigning the IDGRP prefix value, the filter will only display jobs whose Group name begins with IDGRP. This means only the current jobs in group IDGRP1. In later chapters, it will also display jobs belonging to groups idGRP2, idGRP3, and so on.

  4. Press Enter to exit the window. The Active Environment now displays only IDJOB1 and IDJOB2.

    Figure 11 Filtered Display in the Active Environment Screen

    Copy 
    Filter: IDGS      ------- Control-M  Active  Environment ------ UP    <D> - (3)
    COMMAND ===>                                                    SCROLL ==> CRSR
    O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
      IDJOB1   ID       020201                  JOB Wait Confirmation (for      
                                                    Schedule)                   
      IDJOB2   ID       020201                  JOB Wait Schedule               
    ========= >>>>>>>>>>>>>        Bottom of Jobs List       <<<<<<<<<<<<< ========

Confirming a Job Order

When you examine the Active Environment screen you will see the following:

  • A data line for each job order displays information about the job. This information includes the job name, job owner and the job order date (ODATE), as well as other information.

  • the status of each job order is displayed in the Status field for each data line.

When you examine the status of these jobs you will see the following:

  • The status of IDJOB1 is Wait Confirmation (for schedule).

    • Wait Confirmation (for schedule) status is displayed because you defined this job to require job confirmation.

  • The status of IDJOB2 is Wait Schedule.

    • Wait Schedule status is displayed because IDJOB2 cannot be scheduled, or submitted, until its prerequisite IN condition, IDJOB1-ENDED-OK,has been satisfied, and this can only occur after IDJOB1 successfully ends.

To confirm that JOB1 should be submitted you need to enter the appropriate option in the O (option) field by the job name.

  1. Enter OPT in the COMMAND field to toggle the command/option display.

    The list of available options is displayed at the bottom of the screen.

    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 G Group U Undelete J JCL Edit C Confirm 20.59.34

    You can now see that to confirm the scheduling of a job, you should enter line command C (Confirm).

  2. Enter C in the O (option) field, to the left of IDJOB1.

    Copy 
    Filter: IDGS      ------- Control-M  Active  Environment ------ UP    <D> - (3)COMMAND ===>                                                    SCROLL ==> CRSR
    O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
    c IDJOB1   ID       020201                  JOB Wait Confirmation (for       
                                                    Schedule)                    
      IDJOB2   ID       020201                  JOB Wait Schedule                
    ========= >>>>>>>>>>>>>        Bottom of Jobs List       <<<<<<<<<<<<< ========
                                                                                 

  3. If a confirmation window is displayed, that is, if double confirmation is required, specify Y (Yes) in the confirmation window.

    Figure 12 Confirmation Window

    Copy 
    Filter: IDGS      ------- Control-M  Active  Environment ------ UP    <D> - (3)
    COMMAND ===>                                                    SCROLL ==> CRSR
    O Name               +------------------------+ ---------- Status -------------
    C IDJOB1    <========|   Confirm  Y   (Y/N)   | Wait Confirmation (for       
                         +------------------------+ Schedule)                    
      IDJOB2   ID       020201                      Wait Schedule                
    ========= >>>>>>>>>>>>>        Bottom of Jobs List       <<<<<<<<<<<<< ========

    The Status field display changes for each of the two jobs, as they are executed.

  4. Keep pressing Enter in the Active Environment screen.

    If you press Enter quickly enough, you will note the following progression:

    • IDJOB1 changes status to Wait Submission.

    • IDJOB1 changes status to Submitted.

    • IDJOB1 changes status to Ended "OK".

    • IDJOB2 changes status to Wait Submission.

    • IDJOB2 changes status to Submitted.

    • IDJOB2 changes status to Ended "OK".

    At the end of the process, the screen is displayed as follows:

    Copy 
    Filter: IDGS      ------- Control-M  Active  Environment ------ UP    <D> - (3)
    COMMAND ===>                                                    SCROLL ==> CRSR
    O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
      IDJOB1   ID       020201 M21JOB1 /21309   JOB Ended "OK"                   
      IDJOB2   ID       020201 M21JOB2 /21310   JOB Ended "OK"                   
    ========= >>>>>>>>>>>>>        Bottom of Jobs List       <<<<<<<<<<<<< ========

Checking the Log for the Job from the Active Environment Screen

You can use the L (Log) option of the Active Environment screen to check the job log for these jobs. The log is then displayed in the Control-M Log screen. If this option is specified for multiple jobs in the Active Environment screen, the log displays will be stacked. Each time PF03/PF15 is pressed, the next log in the stack is displayed, until all logs have been displayed.

Figure 13 Log Option in the Active Environment Screen

Copy 
Filter: IDGS      ------- Control-M  Active  Environment ------ UP    <D> - (3)
COMMAND ===>                                                    SCROLL ==> CRSR
O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
L IDJOB1   ID       020201 M21JOB1 /21309   JOB Ended "OK"                   
L IDJOB2   ID       020201 M21JOB2 /21310   JOB Ended "OK"                   
========= >>>>>>>>>>>>>        Bottom of Jobs List       <<<<<<<<<<<<< ========

  1. Type L (Log) in the O (Option) field to the left of IDJOB1 and IDJOB2, and then press Enter. The log for IDJOB1 is displayed.

    Figure 14 Control-M Log Screen

    Copy 
    --------------------- LOG MESSAGES FOR JOB(S) IDJOB1   -----------------(3.LOG)
    COMMAND ===>                                                    SCROLL===> CRSR
    SHOW LIMIT ON ==> USERID GROUP MEM/MIS                     DATE 020201 - 020201
    DATE   TIME   ODATE  USERID   CODE    ------ M E S S A G E --------------------
    020201 151226 020201 ID       JOB511I JOB IDJOB1 OID=001JT ODATE 020201       
                                          TASK=ID /OS35/ID - PLACED ON AJF - THIS
                                           JOB MUST BE RUN BEFORE IDJOB2          
    020201 151908 020201 ID       CTM65AI JOB IDJOB1 OID=001JT ODATE 020201       
                                          CNFSCHED PERFORMED BY ID                
    020201 151911 020201 ID       SEL203I JOB IDJOB1 OID=001JT ELIGIBLE FOR RUN   
    020201 151912 020201 ID       SUB133I JOB IDJOB1 M21 /24861 OID=001JT         
                                          SUBMITTED FROM LIBRARY (P) CTM.TEST.JCL 
    020201 151917 020201 ID       SPY28GI JOB IDJOB1 M21 /24861 OID=001JT TAPE    
                                          DRIVE UNITS USED=00 00                  
    020201 151917 020201 ID       SPY281I JOB IDJOB1 M21 /24861 OID=001JT START   
                                          01033.1519 STOP 01033.1519 CPU 0MIN     
                                          00.02SEC SRB 0MIN 00.00SEC 0.03 7AOS35  
    020201 151917 020201 ID       SPY254I JOB IDJOB1 M21 /24861 OID=001JT SCANNED 
    020201 151918 020201 ID       SEL250I JOB IDJOB1 M21 /24861 OID=001JT         
                                          CONDITION "IDJOB1-ENDED-OK ODATE 0202"  
                                          ADDED; RUN NUMBER=00001                 
    020201 151918 020201 ID       SEL208I JOB IDJOB1 M21 /24861 OID=001JT ENDED   
                                          "OK"                                    
    CMDS: SHOW, GROUP, CATEGORY, SHPF                                      15.22.58  

    You can see the clear progression of messages that were generated as the job executed under the control of Control-M. You can scroll the display forward to see additional lines.

  2. Press PF03/PF15.

    3. The log for IDJOB2 is displayed.

  3. Press PF03/PF15 again.

    The Active Environment screen is redisplayed.

    As an alternative to using the Log option in the Active Environment screen to request the log display for specific jobs, you can use Option 5 (LOG) of the IOA Primary Option menu to request display of the IOA Log screen. This screen displays the log for all INCONTROL for z/OS products. You can then filter the display in much the same way that you filtered the display of the Active Environment screen.

Checking the Sysout for the Job

If Control-M/Restart is installed at your site, and the SYSDATA for a job is automatically archived, you can view the Sysout for that job.

To do so, you must first specify option V (View Sysout) for the job, in the Active Environment screen. This option displays the Job Order Execution History screen, which, as its name indicates, displays the execution history of the job. From the list of job executions, you can decide the job for which you want to view the Sysout.

To see the Sysout of a particular run of the job, specify option S (Select) next to the specific job execution in the Job Order Execution History screen. The sysout for the job is then displayed in the Sysout Viewing screen.

If Control-M/Restart is not operational at your site, or if SYSDATA is not archived, skip the remaining exercises in this section, and proceed to the topic "Holding and Deleting Active Environment Screen Job Orders" below.

Enter option V for job IDJOB1 to check the sysout of job IDJOB1.

The Job Order Execution History screen for IDJOB1 is displayed.

Figure 15 Job Order Execution History Screen

Copy 
------------------------ JOB ORDER EXECUTION HISTORY ---------------------(3.V)
COMMAND ===>                                                    SCROLL===> CRSR
MEMNAME IDJOB1     OWNER ID                         ORDERID 001S3  ODATE 020201
O JOBNAME  JOBID    DATE  START ELAPSED PAGES MAX RC --------- STATUS ---------
S M21      32166   020201 18:05    0:00 00003        ENDED "OK"               
======= >>>>>>>>>>> BOTTOM OF ACTIVE JOB ORDER HISTORY LIST <<<<<<<<<<< =======
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
OPTION:   S SELECT                                                     02.52.14

The Job Order Execution History screen, and the Sysout Viewing screen shown below, are discussed in Navigating the Active Environment.

  1. Enter option S for the job run of IDJOB1 to request the desired Sysout.

    The Sysout Viewing screen is displayed. You can scroll down and up, and right and left, through the Sysout.

    Figure 16 Sysout Viewing Screen

    Copy 
    ------------- CONTROL-M/CONTROL-R SYSOUT VIEWING ------   PAGE      1 OF      3
    COMMAND ===>                                                    SCROLL===> CRSR
    MEMNAME IDJOB1    OWNER ID          JOBNAME M21          ODATE 020201       
    ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8

    1                      J E S 2  J O B  L O G  --  S Y S T E M  O S 3 5  --  N O
    0                                                                             
    18.05.20 JOB25002 ---- FRIDAY, 02 FEB 2001 ----                            
    18.05.20 JOB25002  IRR010I  USERID STCUSER  IS ASSIGNED TO THIS JOB.          
    18.05.20 JOB25002  ICH70001I STCUSER  LAST ACCESS AT 18:03:22 ON FRIDAY, FEBRU
    18.05.20 JOB25002  ICH70001I STCUSER  LAST ACCESS AT 18:03:22 ON FRIDAY, FEBRU
    18.05.20 JOB25002  $HASP373 M21      STARTED - INIT 3    - CLASS A - SYS OS35
    18.05.20 JOB25002  IEF403I M21 - STARTED - TIME=18.05.20                     
    18.05.20 JOB25002  -                                        CPU (Total)  Elapse
    18.05.20 JOB25002  -Jobname  Stepname ProcStep    RC    I/O hh:mm:ss.th  hh:mm:
    18.05.20 JOB25002  -ID       S1                   00      0       00.02       
    18.05.20 JOB25002  IEF404I ID   - ENDED - TIME=18.05.20                        
    18.05.20 JOB25002  -                                                          
    18.05.20 JOB25002  -M21      Job Service Totals           0       00.02       
    18.05.21 JOB25002  $HASP395 M21      ENDED                                   
    0------ JES2 JOB STATISTICS ------                                             
    -  02 FEB 2001 JOB EXECUTION DATE                                             
    -            8 CARDS READ                                                      
    -           44 SYSOUT PRINT RECORDS                                            
    COMMANDS: LEFT, RIGHT, FIND str, FIND str PREV, N n, P n, END          18.17.39

  2. Exit the Sysout Viewing screen, and then exit the Job Order Execution History screen, to the Active Environment screen.

Holding and Deleting Active Environment Screen Job Orders

Although it is unnecessary to delete these job orders from the Active Environment screen—they will probably be automatically deleted during New Day processing, which is discussed in Chapter 7, "Job Ordering and New Day Processing"—you should do so anyway, as part of the lesson.

  1. Type D (Delete) in the O (Option) field for both jobs, as shown below, and press Enter.

    Figure 17 Delete Option in the Active Environment Screen

    Copy 
    Filter: IDGS      ------- Control-M  Active  Environment ------ UP    <D> - (3)
    COMMAND ===>                                                    SCROLL ==> CRSR
    O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
    D IDJOB1   ID       020201 M21     /21309   JOB Ended "OK"                   
    D IDJOB2   ID       020201 M21     /21310   JOB Ended "OK"                   
     ========= >>>>>>>>>>>>>       Bottom of Jobs List       <<<<<<<<<<<<< ========                                                                     

    The jobs are not deleted. Instead, a message appears at the top of the screen, as shown below:

    Copy 
    CTM653E CANNOT DELETE TASK IDJOB1 ODATE 020201 - NOT HELD       UP    <D> - (3)
    COMMAND ===>                                                    SCROLL ==> CRSR
    O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
    D IDJOB1   ID       020201 M21     /24861   JOB Ended "OK"                   
    D IDJOB2   ID       020201 M21     /24866   JOB Ended "OK"                   
    ========= >>>>>>>>>>>>>        Bottom of Jobs List       <<<<<<<<<<<<< ========

    The message, CTM653E CANNOT DELETE TASK IDJOB1 ODATE 020201 - NOT HELD, indicates that the first requested deletion, that of job IDJOB1, could not be performed because the job is not Held. In fact, any action that affects a job order, or the status of a job order, cannot be performed until the job order is placed in Held status. To hold a job order, specify option H (Hold).

  2. Replace the D option by each of the jobs with an H option and press Enter to place the jobs in Held status.

    The status of each job order changes to Requested Held Ended "OK", and messages at the top of the screen indicate the change. The last issued message for IDJOB2 remains displayed at the top of the screen.

    Copy 
    CTM659I HOLD OF TASK IDJOB2 GROUP "IDGRP1 " ODATE 020201 PERFORMED        - (3)
    COMMAND ===>                                                    SCROLL ==> CRSR
    O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
      IDJOB1   ID       020201 M21     /24861   JOB Requested Held Ended "OK"    
      IDJOB2   ID       020201 M21     /24866   JOB Requested Held Ended "OK"    
    ========= >>>>>>>>>>>>>        Bottom of Jobs List       <<<<<<<<<<<<< ========

  3. Press Enter again.

    The status of each job now changes to Held Ended "OK", and the message disappears.

    Copy 
    Filter: IDGS      ------- Control-M  Active  Environment ------ UP    <D> - (3)
    COMMAND ===>                                                    SCROLL ==> CRSR
    O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
      IDJOB1   ID       020201 M21     /24861   JOB Held Ended "OK"              
      IDJOB2   ID       020201 M21     /24866   JOB Held Ended "OK"              
    ========= >>>>>>>>>>>>>        Bottom of Jobs List       <<<<<<<<<<<<< ========

  4. Once again, specify the D option by each of the jobs.

  5. If a Delete Confirmation window is displayed, confirm the Delete request.

    Messages at the top of the screen indicate that the jobs orders are deleted, and the last issued message for IDJOB2 remains displayed. The job orders no longer appear in the screen.

    Copy 
    CTM659I DELETE OF TASK IDJOB2 GROUP "IDGRP1 " ODATE 020201 PERFORMED        (3)
    COMMAND ===>                                                    SCROLL ==> CRSR
    O Name     Owner    Odate  Jobname  JobID   Typ ----------- Status ------------
    ========= >>>>>>>>>>>>>        Bottom of Jobs List       <<<<<<<<<<<<< ========

    Do not confuse deleting a job order from the Active Environment screen with deleting a job scheduling definition from the Job List screen. Deleting the job order impacts only that order. The job scheduling definition itself remains unaffected and can be ordered again. If you delete a job scheduling definition from the Job List screen, the job scheduling definition itself is gone, and the job can no longer be ordered from the table.

Return to the Scheduling Definition Facility

In this chapter, you will do a little more work in the Scheduling Definition facility.

Saving Job Scheduling Definitions

So far, you have created and exited two job scheduling definitions—for IDJOB1 and IDJOB2. But they are currently only in memory; you have not saved them.

You can now save the job scheduling definitions. To do that you must first return to the Scheduling Definition facility.

  1. Enter =2 in the COMMAND field.

    The Job List screen is displayed.

  2. Exit the Job List screen.

    The Exit option window is displayed. This window prompts whether you want to save the job scheduling definitions you created.

    Figure 18 Job List Screen Exit Option Window

    Copy 
    JOB LIST     LIB: CTM.TEST.SCHEDULE                             TABLE: IDGS1  
    COMMAN +-----------------------------------------------------------+  ===> CRSR
    OPT  N |                 PLEASE SELECT EXIT OPTION                 |  ---------
         i |                                                           |          
         i |     SAVE    CREATE                                        |          
     ===== |                                                           |  <<< =====
           |     LIBRARY CTM.TEST.SCHEDULE                             |          
           |     TABLE   IDGS1                                         |          
           |                                                           |          
           +-----------------------------------------------------------+          
                                                                                  
                                                                                  
                                                                                  
                                                                                  
                                                                                  
                                                                                  
                                                                                  
                                                                                  
                                                                                  
                                                                                  
                                                                                  
                                                                                  
                                                                                  
    OPTIONS S SEL D DEL I INS O ORDER F FORCE J JCL C COPY P PLN T JOBSTAT 16.22.13

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

    The window also contains SAVE and CREATE fields. The Exit Option window enables you to perform many actions.

    • To create a new table in a library and save the job scheduling definitions in that table, specify Y (Yes) in the CREATE field of the window, leaving the SAVE field blank, and exit the window.

      Because you specified a new table name in the entry panel—one that had not previously existed—you are now going to permanently create that table as well. Therefore, the values you entered in this chapter are the values that you will use.

      If you changed the library and table fields of the window to reflect a currently non-existing table, you would also use these values.

    • To save the job scheduling definitions in an existing table in a library, specify Y (Yes) in the SAVE field of the window, leaving the CREATE field blank, and exit the window. This procedure should be used even if you change the library and or table fields to a different, but existing, table.

    • To cancel the changes you made, specify N (No) in the both the SAVE and CREATE fields of the window, and exit the window.

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

  3. Specify Y in the CREATE field and leave the SAVE field blank.

    The new table is created and the job scheduling definitions are saved in the table. The Entry Panel is displayed.

Normally, when you exit the Job List screen, the Table List screen is displayed. However, if the Table List screen was bypassed when you entered the Scheduling Definition facility, that is, if you specified a TABLE value in the entry panel, which you did, the Table List screen is not displayed upon exiting the Job List screen; instead, the Entry Panel is displayed.

Selecting a Table from the Table List Screen

You can now enter the Table List screen so that it displays your newly created table.

  1. Ensure that correct library name is entered in the LIBRARY field of the entry panel and that the TABLE field is blank.

    The Table List screen is displayed. Unless you are using a library dedicated to this set of exercises, other table names appear in the Table list screen.

    Figure 19 Control-M Table List Screen

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

    Among the options of the Table List screen are the options S (Select) and B (Browse). Both these options bring you to the Job List screen, where the list of jobs in the table are displayed, but each displays the Job List screen in a different mode:

    • The Select option displays the Job List screen in Edit mode. When you then select a job from the Job List screen, you can edit and update the job scheduling definition.

    • The Browse option displays the Job List screen in Browse mode. When you then select a job from the Job List screen, the job scheduling definition can be viewed, but it cannot be edited or updated.

      You will not edit the job scheduling definition at this point, so use the B(Browse) option.

  2. Either page down until the table name is visible, or perform an ISPF LOCATE to locate your table. Ensure that the cursor is in the OPTION field for your table.

  3. Specify option B (Browse) in the OPTION field next to your table.

The Job List screen is displayed in Browse mode. The screen displays the two defined jobs in your table.

Figure 20 Job List Screen

Copy 
 JOB LIST     LIB: CTM.TEST.SCHEDULE                             TABLE: IDGS1 
 COMMAND ===>                                                    SCROLL===> CRSR
 OPT  NAME ----- DESCRIPTION ---------------------------------------------------
      IDJOB1     THIS JOB MUST BE RUN BEFORE IDJOB2
      IDJOB2    
  ====== >>>>>>>>>>>>>>>>    NO MORE JOBS IN TABLE     <<<<<<<<<<<<<<<<<<< =====
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
OPTIONS S SEL D DEL I INS O ORDER F FORCE J JCL C COPY P PLN T JOBSTAT 15.37.39

From the Job List screen, you can now use the S (Select) option to browse either the IDJOB1 or the IDJOB2 job scheduling definition in the table.

In addition to the screen shown above, there are other possible formats of the Job List screen.

Formats of the Job List Screen

You had previously used the DESC command to ensure the desired format of the screen. This command confirmed that you wanted the display type that shows the description of the job, as taken from the DESC field in the job scheduling definition, to be displayed next to the job name.

Table 3 describes the commands used to display other information.

Table 3 Commands to Display Job List Screen Formats

Command

Description

DATA

Command DATA displays the Application name and Group name of the job next to the job name. The Application name and Group name are taken from the corresponding fields in the job scheduling definition.

STAT

Command STAT displays, next to the job name, the following ISPF-like statistical information about the job: Version and modification numbers, creation date, last modification date, and user ID.

Alternate between specifying the DATA, STAT, and DESC commands in the COMMAND field of the Job List screen, and note the differences in the display following the entry of each command. Ensure that the last command you enter is DESC, because that is the format you are using in the exercises in this guide.

Whichever format you use, the actual jobs listed in the screen, that is, jobs IDJOB1 and IDJOB2, remain the same. The format of the Job List screen does not affect which jobs are listed. It only affects the accompanying data that is displayed for those jobs.

Exiting the Online Facility

You have now finished the most of the exercises in this chapter of the guide. All that remains is to learn to exit the IOA Online facility.

Leave the online facility by exiting one screen at a time, until you have exited the entire online facility.

  1. Press PF03/PF15 or enter the END command.

    The Table List screen is displayed.

  2. Press PF03/PF15 or enter the END command.

    The Entry panel is displayed.

  3. Press PF03/PF15 or enter the END command.

    The IOA Primary Option Menu is displayed.

  4. Enter X in the COMMAND field of the IOA Primary Option menu.

    The IOA Online facility is exited.

Review

In this chapter you

  • accessed the following screens of the scheduling definition facility

    • Entry Panel

    • Table List screen

    • Job List screen

    • Job Scheduling Definition screen

  • created a job scheduling definition directly from the Entry panel, and then created a second job scheduling definition by using the I (Insert) option in the Job List screen

  • learned about and utilized the following job scheduling definition fields while creating your job scheduling definitions

    • MEMNAME

    • MEMLIB

    • GROUP

    • DESC

    • DAYS

    • IN

    • CONFIRM

    • OUT

  • defined one of the jobs to require manual confirmation before submission

  • used IN and OUT conditions to create a dependency between the two jobs

  • ordered the two jobs from the Job List screen

  • viewed messages in the Job Order Messages screen

  • moved between facilities using an =x command instead of returning to the IOA Primary Option menu

  • displayed the Active Environment screen, and toggled between display of the list of commands and the list of options at the bottom of the screen

  • defined a filter and filtered the Active Environment display

  • learned about statuses in the Active Environment screen

  • used the C (Confirm) option in the Active Environment screen to manually confirm a job

  • observed changes to job statuses in the Active Environment screen

  • used the L (Log) option in the Active Environment screen to display the message log for the job orders in the Control-M Log screen

  • used the V option to display the Job Order Execution History screen and from there displayed the Sysout of a job execution in the Sysout Viewing screen

  • used the H (Hold) option so that you could delete job orders from the Active Environment screen

  • used the D (Delete) option in the Active Environment screen to delete the job orders when they were no longer needed

  • used the Exit Option window of the Job List screen to create a new table and save your two job scheduling definitions in the table

  • learned the difference between the S (Select) and B (Browse) options of the Table List screen

  • changed the format of the Job List screen

  • exited the Online facility by working your way up the screen hierarchy as you exited individual screens

Recommended Reading

Before continuing with the next chapter, you should read the following in the Control-M for z/OS User Guide

  • In Chapter 1

    • Introduction to Control-M components

    • Prerequisite condition concept

    • Date concepts

  • In Chapter 2

    • Introduction to the Scheduling Definition Facility

    • Description of the following Scheduling Definition Facility screens including their formats, options and commands

      • Entry Panel

      • Table List screen

      • Job List screen

    • Description of the layout of the Job Scheduling Definition screen and the fields in the screen

    • Topics "Exiting the Scheduling Definition Facility" and "Ordering (Scheduling) Jobs" in the Scheduling Definition facility description

    • Introduction to the Active Environment screen and the description of its fields

    • Descriptions of the Control-M and IOA Log screens

  • In Chapter 3

    Detailed descriptions of the parameters you have already used: CONFIRM, DAYS, DESC, GROUP, IN, MEMLIB, MEMNAME, OUT

The description of the parameter DAYS is quite detailed. Read it for a general understanding of parameter usage and possible parameter formats, without trying to memorize all the detail. For now, you can skip the information related to subparameters DCAL and AND/OR.