Introduction to Control-M (2024)

This chapter includes the following topics:

  • Overview

  • Preparations

  • Main Components of Control-M

  • Online Facility Primary Options

  • Introduction to the Scheduling Definition Facility

  • Introduction to the Active Environment Screen

    • Toggling Between Display of Commands and Options

    • Filtering the Active Environment Display

    • Confirming a Job Order

    • Checking the Log for the Job from the Active Environment Screen

    • Checking the Sysout for the Job

    • Holding and Deleting Active Environment Screen Job Orders

  • Return to the Scheduling Definition Facility

    • Saving Job Scheduling Definitions

    • Selecting a Table from the Table List Screen

    • Formats of the Job List Screen

  • Exiting the Online Facility

  • Review

    • Recommended Reading

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.

    Figure1Control-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 ASSIGNMENT23.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.

    Figure2Control-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 ASSIGNMENT23.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.

    Figure3Job Scheduling Definition Screen

    Copy

    JOB: JOB1LIB CTM.TEST.SCHEDULETABLE: IDGS1
    COMMAND ===>SCROLL===> CRSR
    +-----------------------------------------------------------------------------+
    MEMNAME IDJOB1MEMLIB
    OWNERIDTASKTYPE JOBPREVENT-NCT2DFLTN
    APPLGROUP
    DESC
    OVERLIBSTAT CAL
    SCHENVSYSTEM IDNJE NODE
    SET VAR
    CTB STEP ATNAMETYPE
    DOCMEMIDJOB1DOCLIB
    ===========================================================================
    DAYSDCAL
    AND/OR
    WDAYSWCAL
    MONTHS1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
    DATES
    CONFCALSHIFTRETRO N MAXWAIT 00D-CAT
    MINIMUMPDS
    DEFINITION ACTIVE FROMUNTIL
    ===========================================================================
    IN
    CONTROL
    RESOURCE
    PIPE
    FROM TIME+DAYSUNTIL TIME+DAYS
    DUE OUT TIME+DAYSPRIORITYSACCONFIRM
    TIME ZONE:
    ===========================================================================
    OUT
    AUTO-ARCHIVEYSYSDBYMAXDAYSMAXRUNS
    RETENTION:# OF DAYS TO KEEP# OF GENERATIONS TO KEEP
    SYSOUT OP(C,D,F,N,R)FROM
    MAXRERUNRERUNMEMINTERVALFROM
    STEP RANGEFR (PGM.PROC).TO.
    ON PGMSTPROCSTCODESA/O
    DO
    SHOUT WHENTIME+DAYSTOURGN
    MS
    ======= >>>>>>>>>>>>>>>>>>> END OF SCHEDULING PARAMETERS <<<<<<<<<<<<<<<< =====
    COMMANDS: EDIT, DOC, PLAN, JOBSTAT11.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.

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

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

    Figure4Job Scheduling Definition Screen Showing Completed Fields

    Copy

    JOB: IDJOB1LIB CTM.TEST.SCHEDULETABLE: IDGS1
    COMMAND ===>SCROLL===> CRSR
    +-----------------------------------------------------------------------------+
    MEMNAME IDJOB1MEMLIBCTM.TEST.JCL
    OWNERIDTASKTYPE JOBPREVENT-NCT2DFLTN
    APPLGROUP IDGRP1
    DESCTHIS JOB MUST BE RUN BEFORE IDJOB2
    OVERLIBSTAT CAL
    SCHENVSYSTEM IDNJE NODE
    SET VAR
    CTB STEP ATNAMETYPE
    DOCMEMIDJOB1DOCLIB
    ===========================================================================
    DAYSALLDCAL
    AND/OR
    WDAYSWCAL
    MONTHS1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
    DATES
    CONFCALRETRO N MAXWAIT 00D-CAT
    MINIMUMPDS
    DEFINITION ACTIVE FROMUNTIL
    ===========================================================================
    IN
    CONTROL
    RESOURCE
    PIPE
    FROM TIME+DAYSUNTIL TIME+DAYS
    DUE OUT TIME+DAYSPRIORITY 00SACCONFIRM Y
    TIME ZONE:
    ===========================================================================
    OUTIDJOB1-ENDED-OKODAT +
    AUTO-ARCHIVESYSDBMAXDAYSMAXRUNS
    RETENTION:# OF DAYS TO KEEP# OF GENERATIONS TO KEEP
    SYSOUT OP(C,D,F,N,R)FROM
    MAXRERUNRERUNMEMINTERVALFROM
    STEP RANGEFR (PGM.PROC).TO.
    ON PGMSTPROCSTCODESA/O
    DO
    SHOUT WHENTIME+DAYSTOURGN
    MS
    ======= >>>>>>>>>>>>>>>>>>> END OF SCHEDULING PARAMETERS <<<<<<<<<<<<<<<< =====
    COMMANDS: EDIT, DOC, PLAN, JOBSTAT11.17.00
  3. Exit the Job Scheduling Definition screen. The Job List screen is displayed.

    Figure5Job List Screen

    Copy

    JOB LISTLIB: CTM.TEST.SCHEDULETABLE: IDGS1
    COMMAND ===>SCROLL===> CRSR
    OPTNAME ----- DESCRIPTION ---------------------------------------------------
    IDJOB1THIS 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 LISTLIB: CTM.TEST.SCHEDULETABLE: IDGS1
    COMMAND ===>SCROLL===> CRSR
    OPTNAME ----- DESCRIPTION ---------------------------------------------------
    IIDJOB1THIS 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.SCHEDULETABLE: IDGS1
    COMMAND ===>SCROLL===> CRSR
    +-----------------------------------------------------------------------------+
    MEMNAMEMEMLIBCTM.TEST.JCL
    OWNERIDTASKTYPE JOBPREVENT-NCT2 Y DFLTN
    APPLGROUP IDGRP1
    DESC
    OVERLIBSTAT CAL
    SCHENVSYSTEM IDNJE NODE
    SET VAR
    CTB STEP ATNAMETYPE
    DOCMEMDOCLIB
    ===========================================================================
    DAYSALLDCAL
    AND/OR
    WDAYSWCAL
    MONTHS1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
    DATES
    CONFCALSHIFTRETRO N MAXWAIT 00D-CAT
    MINIMUMPDS
    DEFINITION ACTIVE FROMUNTIL
    ===========================================================================
    IN
    CONTROL
    RESOURCE
    PIPE
    TIME: FROMUNTILPRIORITY 00DUE OUTSACCONFIRM Y
    TIME ZONE:
    ===========================================================================
    OUTIDJOB1-ENDED-OKODAT +
    AUTO-ARCHIVESYSDBMAXDAYSMAXRUNS
    RETENTION:# OF DAYS TO KEEP# OF GENERATIONS TO KEEP
    SYSOUT OP(C,D,F,N,R)FROM
    MAXRERUNRERUNMEMINTERVALFROM
    STEP RANGEFR (PGM.PROC).TO.
    ON PGMSTPROCSTCODESA/O
    DO
    SHOUT WHENTIME+DAYSTOURGN
    MS
    ======= >>>>>>>>>>>>>>>>>>> END OF SCHEDULING PARAMETERS <<<<<<<<<<<<<<<< =====
    COMMANDS: EDIT, DOC, PLAN, JOBSTAT11.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 IDJOB2MEMLIBCTM.TEST.JOBLIB
    OWNERM44TASKTYPE JOBPREVENT-NCT2 Y DFLTN
    APPLGROUP IDGRP1
    DESC
    OVERLIBSTAT CAL
    SCHENVSYSTEM IDNJE NODE
    SET VAR
    CTB STEP ATNAMETYPE
    DOCMEMIDJOB2DOCLIB
    ===========================================================================
  7. In the IN field, define the same value you had defined as the OUT value inJOB1 (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

    ===========================================================================
    INIDJOB1-ENDED-OKODAT
    CONTROL
    RESOURCE
    PIPE
    FROM TIME+DAYSUNTIL TIME+DAYS
    DUE OUT TIME+DAYSPRIORITY 00SACCONFIRM
    TIME ZONE:
    ===========================================================================
  8. Change the plus sign (+) to a minus sign (-) in the OUT statement.

    Copy

    ===========================================================================
    OUTIDJOB1-ENDED-OKODAT -
    AUTO-ARCHIVESYSDBMAXDAYSMAXRUNS

    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.

    Figure6Job List Screen

    Copy

    JOB LISTLIB: CTM.TEST.SCHEDULETABLE: IDGS1
    COMMAND ===>SCROLL===> CRSR
    OPTNAME -------- DESCRIPTION ------------------------------------------------
    IDJOB1THIS 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.

    Figure7Confirm Window

    Copy

    JOB LISTLIB: CTM.TEST.SCHEDULETABLE: IDGS1
    COMMAND ===>+-------------------------------+SCROLL===> CRSR
    OPTNAME ---|CONFIRM YODATE 020201| -----------------
    OIDJOB1<===========|ASK FOR EACH ONEY|
    OIDJOB2+-------------------------------+
    ====== >>>>>>>>>>>>>>>>>>>NO MORE JOBS IN TABLE<<<<<<<<<<<<<<<< =====
    For each job ordered, the Job Order Messages screen with messages similar to the following will be displayed:

    Figure8Job 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 IDJOB1ID=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.

Figure9Control-M Active Environment Screen

Copy

Filter:------- Control-MActiveEnvironment ------ UP<D>(3)
COMMAND ===>SCROLL ==> CRSR
O NameOwnerOdateJobnameJobID Typ ------------ Status -------------
CICSPROD M22020201 CICSPROD/04368 CST EXECUTING (RUN 1) GROUP=CICS-PROD
CICSTEST M22020201 CICSTEST/04372 CST EXECUTING (RUN 2) GROUP=CICS-TEST
BRIVPCCIVP020201 BRIVPCC /04369 JOB ENDED "OK"GROUP=BR-IVP-CC
BRCC0001 IVP020201 BRCC0001/04382 JOB ENDED "OK"GROUP=BR-IVP-CC
BRCC0002 IVP020201 BRCC0002/04383 JOB ENDED "OK"GROUP=BR-IVP-CC
BRCC0003 IVP020201 BRCC0003/04384 JOB ENDED "OK"GROUP=BR-IVP-CC
BRCCINDIVP020201 BRCCIND /04385 JOB ENDED "OK"GROUP=BR-IVP-CC
BRUPDT02 IVP020201 BRUPDT02/04387 JOB ENDED "OK"GROUP=BR-IVP-CC
BRREP001 IVP020201 BRREP001/04388 JOB ENDED "OK"GROUP=BR-IVP-CC
BRREP002 IVP020201 BRREP002/04389 JOB ENDED "OK"GROUP=BR-IVP-CC
BRIVPCCE IVP020201/JOB WAIT SCHEDULEGROUP=BR-IVP-CC
CRCCENDIVP020201/JOB WAIT SCHEDULEGROUP=BR-IVP-CC
INTR0001 M22020201/JOB HELD WAIT SCHEDULE
GROUP=INTER-PRODUCTION
INTR0002 M22020201/JOB HELD WAIT SCHEDULE
GROUP=INTER-PRODUCTION
INTR0003 M22020201/JOB WAIT SCHEDULE
GROUP=INTER-PRODUCTION
INTR0004 M22020201 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 display15.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 display15.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 Confirm15.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 display15.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.

    Figure10Show Screen Filter Window

    Copy

    --------------------------- Show Screen Filter ---------------------(3.SHOW)-
    FilterSave(Y/N) Desc:
    Memname
    Group
    Sch LibTbl
    ======== In Process Y ======= | EndedY | ======= State Y ========
    ---------------------------------------------------------------------------
    Wait SchedYWait timeY | Ended "OK"Y | FreeYForced OK Y
    Wait ConfYWait CondY | Not "OK"Y | HeldYTbl HeldY
    Wait SUBYWait quantY | RerunY | On ReqYCMEM Forc Y
    SubmittedYWait contrl Y | DisappearedY | DeletedNNoteY
    Wait ExecYTbl ActiveY | AbendedY | LateNRestarted Y
    ExecutingY| Unexpected CCY | PseudoN
    On Out Queue Y| JCL ErrorY |
    Task Type: Job Cyc Emr Stc Cst Est Ecj Ecs Tbl Tbc
    YYYYYYYYYY
    Res Name
    Resource Type: In Y Out Y Conds Y Resource Y Control Y
    Owner
    Odate:FromToPriority
    JobAppl
    CPU IdLPAR

    -----------------------------------------------------------------------------
    OPt command toggles between Commands and Options display11.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)+
    |FilterIDGSSave Y (Y/N) Desc: GS-EXERCISES|
    |Memname|
    |GroupIDGRP|
    |Sch LibTbl________|

    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.

    Figure11Filtered Display in the Active Environment Screen

    Copy

    Filter: IDGS------- Control-MActiveEnvironment ------ UP<D> - (3)
    COMMAND ===>SCROLL ==> CRSR
    O NameOwnerOdateJobnameJobIDTyp ----------- Status ------------
    IDJOB1ID020201JOB Wait Confirmation (for
    Schedule)
    IDJOB2ID020201JOB 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-MActiveEnvironment ------ UP<D> - (3)COMMAND ===>SCROLL ==> CRSR
    O NameOwnerOdateJobnameJobIDTyp ----------- Status ------------
    c IDJOB1ID020201JOB Wait Confirmation (for
    Schedule)
    IDJOB2ID020201JOB 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.

    Figure12Confirmation Window

    Copy

    Filter: IDGS------- Control-MActiveEnvironment ------ UP<D> - (3)
    COMMAND ===>SCROLL ==> CRSR
    O Name+------------------------+ ---------- Status -------------
    C IDJOB1<========|ConfirmY(Y/N)| Wait Confirmation (for
    +------------------------+ Schedule)
    IDJOB2ID020201Wait 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-MActiveEnvironment ------ UP<D> - (3)
    COMMAND ===>SCROLL ==> CRSR
    O NameOwnerOdateJobnameJobIDTyp ----------- Status ------------
    IDJOB1ID020201 M21JOB1 /21309JOB Ended "OK"
    IDJOB2ID020201 M21JOB2 /21310JOB 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.

Figure13 Log Option in the Active Environment Screen

Copy

Filter: IDGS------- Control-MActiveEnvironment ------ UP<D> - (3)
COMMAND ===>SCROLL ==> CRSR
O NameOwnerOdateJobnameJobIDTyp ----------- Status ------------
L IDJOB1ID020201 M21JOB1 /21309JOB Ended "OK"
L IDJOB2ID020201 M21JOB2 /21310JOB 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.

    Figure14Control-M Log Screen

    Copy

    --------------------- LOG MESSAGES FOR JOB(S) IDJOB1-----------------(3.LOG)
    COMMAND ===>SCROLL===> CRSR
    SHOW LIMIT ON ==> USERID GROUP MEM/MISDATE 020201 - 020201
    DATETIMEODATEUSERIDCODE------ M E S S A G E --------------------
    020201 151226 020201 IDJOB511I JOB IDJOB1 OID=001JT ODATE 020201
    TASK=ID /OS35/ID - PLACED ON AJF - THIS
    JOB MUST BE RUN BEFORE IDJOB2
    020201 151908 020201 IDCTM65AI JOB IDJOB1 OID=001JT ODATE 020201
    CNFSCHED PERFORMED BY ID
    020201 151911 020201 IDSEL203I JOB IDJOB1 OID=001JT ELIGIBLE FOR RUN
    020201 151912 020201 IDSUB133I JOB IDJOB1 M21 /24861 OID=001JT
    SUBMITTED FROM LIBRARY (P) CTM.TEST.JCL
    020201 151917 020201 IDSPY28GI JOB IDJOB1 M21 /24861 OID=001JT TAPE
    DRIVE UNITS USED=00 00
    020201 151917 020201 IDSPY281I 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 IDSPY254I JOB IDJOB1 M21 /24861 OID=001JT SCANNED
    020201 151918 020201 IDSEL250I JOB IDJOB1 M21 /24861 OID=001JT
    CONDITION "IDJOB1-ENDED-OK ODATE 0202"
    ADDED; RUN NUMBER=00001
    020201 151918 020201 IDSEL208I JOB IDJOB1 M21 /24861 OID=001JT ENDED
    "OK"
    CMDS: SHOW, GROUP, CATEGORY, SHPF15.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.

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

Figure15Job Order Execution History Screen

Copy

------------------------ JOB ORDER EXECUTION HISTORY ---------------------(3.V)
COMMAND ===>SCROLL===> CRSR
MEMNAME IDJOB1OWNER IDORDERID 001S3ODATE 020201
O JOBNAMEJOBIDDATESTART ELAPSED PAGES MAX RC --------- STATUS ---------
S M2132166020201 18:050:00 00003ENDED "OK"
======= >>>>>>>>>>> BOTTOM OF ACTIVE JOB ORDER HISTORY LIST <<<<<<<<<<< =======

















OPTION:S SELECT02.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 ------PAGE1 OF3
    COMMAND ===>SCROLL===> CRSR
    MEMNAME IDJOB1OWNER IDJOBNAME M21ODATE 020201
    ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8

    1J E S 2J O BL O G--S Y S T E MO S 3 5--N O
    0
    18.05.20 JOB25002 ---- FRIDAY, 02 FEB 2001 ----
    18.05.20 JOB25002IRR010IUSERID STCUSERIS ASSIGNED TO THIS JOB.
    18.05.20 JOB25002ICH70001I STCUSERLAST ACCESS AT 18:03:22 ON FRIDAY, FEBRU
    18.05.20 JOB25002ICH70001I STCUSERLAST ACCESS AT 18:03:22 ON FRIDAY, FEBRU
    18.05.20 JOB25002$HASP373 M21STARTED - INIT 3- CLASS A - SYS OS35
    18.05.20 JOB25002IEF403I M21 - STARTED - TIME=18.05.20
    18.05.20 JOB25002-CPU (Total)Elapse
    18.05.20 JOB25002-JobnameStepname ProcStepRCI/O hh:mm:ss.thhh:mm:
    18.05.20 JOB25002-IDS100000.02
    18.05.20 JOB25002IEF404I ID- ENDED - TIME=18.05.20
    18.05.20 JOB25002-
    18.05.20 JOB25002-M21Job Service Totals000.02
    18.05.21 JOB25002$HASP395 M21ENDED
    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, END18.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 Chapter7, "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.

    Figure17Delete Option in the Active Environment Screen

    Copy

    Filter: IDGS------- Control-MActiveEnvironment ------ UP<D> - (3)
    COMMAND ===>SCROLL ==> CRSR
    O NameOwnerOdateJobnameJobIDTyp ----------- Status ------------
    D IDJOB1ID020201 M21/21309JOB Ended "OK"
    D IDJOB2ID020201 M21/21310JOB 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 HELDUP<D> - (3)
    COMMAND ===>SCROLL ==> CRSR
    O NameOwnerOdateJobnameJobIDTyp ----------- Status ------------
    D IDJOB1ID020201 M21/24861JOB Ended "OK"
    D IDJOB2ID020201 M21/24866JOB 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 NameOwnerOdateJobnameJobIDTyp ----------- Status ------------
    IDJOB1ID020201 M21/24861JOB Requested Held Ended "OK"
    IDJOB2ID020201 M21/24866JOB 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-MActiveEnvironment ------ UP<D> - (3)
    COMMAND ===>SCROLL ==> CRSR
    O NameOwnerOdateJobnameJobIDTyp ----------- Status ------------
    IDJOB1ID020201 M21/24861JOB Held Ended "OK"
    IDJOB2ID020201 M21/24866JOB 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 NameOwnerOdateJobnameJobIDTyp ----------- 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.

    Figure18Job List Screen Exit Option Window

    Copy

    JOB LISTLIB: CTM.TEST.SCHEDULETABLE: IDGS1
    COMMAN +-----------------------------------------------------------+===> CRSR
    OPTN |PLEASE SELECT EXIT OPTION|---------
    i ||
    i |SAVECREATE|
    ===== ||<<< =====
    |LIBRARY CTM.TEST.SCHEDULE|
    |TABLEIDGS1|
    ||
    +-----------------------------------------------------------+













    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.

    Figure19Control-M Table List Screen

    Copy

    LIST OF TABLES IN CTM.TEST.SCHEDULE-------------(2)
    COMMAND ===>SCROLL===> CRSR
    OPTNAME ------------ VV.MMCREATEDCHANGEDSIZEINITMODID
    ADABAS01.00 98/09/09 00/05/09 00:5070700 O01
    APPLNTN01.00 98/09/09 00/05/09 00:501801800 O01
    APPLPRDI01.00 98/09/09 00/05/09 00:5041410 O01
    ARCNIGHT01.00 98/09/09 00/05/09 00:50550 S07
    ASMBTR101.00 98/09/09 00/05/09 00:50990 S07
    ASMBTR201.00 98/09/09 00/05/09 00:5014140 S07
    BACKUP01.00 98/09/09 00/05/09 00:50550 S07
    CICSJOBS01.00 98/09/09 00/05/09 00:5070700 O01
    CICSPROD01.00 98/09/09 00/05/09 00:501801800 O01
    CICSTEST01.00 98/09/09 00/05/09 00:5041410 O01
    CICSUPT01.00 98/09/09 00/05/09 00:50550 S07
    CLIENTS01.00 98/09/09 00/05/09 00:50990 S07
    DB2EXE01.00 98/09/09 00/05/09 00:5014140 S07
    DLOAD01.00 98/09/09 00/05/09 00:50550 S07
    MAINDAY01.00 98/09/09 00/05/09 00:501801800 O01
    MAINT01.00 98/09/09 00/05/09 00:5041410 O01
    MAINTPL01.00 98/09/09 00/05/09 00:50550 S07
    ONSPOOL01.00 98/09/09 00/05/09 00:50990 S07
    ONSPOOLT01.00 98/09/09 00/05/09 00:5014140 S07
    OPERCLN01.00 98/09/09 00/05/09 00:50550 S07
    OPTIONS S SELECTO ORDERF FORCEG GRAPHIC FLOWB BROWSED 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.

Figure20Job List Screen

Copy

JOB LISTLIB: CTM.TEST.SCHEDULETABLE: IDGS1
COMMAND ===>SCROLL===> CRSR
OPTNAME ----- DESCRIPTION ---------------------------------------------------
IDJOB1THIS 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.

Table3 describes the commands used to display other information.

Table3Commands 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 userID.

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.

Introduction to Control-M (2024)

FAQs

What is Control-M and how does it work? ›

Control-M empowers you to automate IT- and Business Processes throughout applications, data, and infrastructure. Any application, any data on any infrastructure can be automated and integrated.

What kind of tool is Control-M? ›

Control-M provides a centralized platform across diverse IT infrastructures, allowing users to embed workflow orchestration in their CI/CD pipeline. Users can automate workflows across hybrid and multi-cloud environments with AWS, Azure, and Google Cloud Platform integrations.

What is the difference between airflow and Control-M? ›

Apache Airflow: Offers in-depth views of pipelines and tasks, with the ability to inspect logs and manage tasks directly from the UI. Control-M: Provides a user-friendly interface with dashboard capabilities for monitoring and managing workflows.

Is Control-M widely used? ›

Workload Automation with Control-M Workbench and Agent

Control-M, developed by BMC Software, Inc, is a leading workload automation tool used by businesses worldwide to manage and streamline their batch processing workloads.

What are the roles and responsibilities of Control-M admin? ›

ROLE RESPONSIBILITIES:

This includes installing, upgrading, configuring, maintaining and controlling the Information Assurance (IA) posture of the Control M infrastructure. The Worker must analyze user requirements, procedures, and problems to automate processing or to improve existing job flows and schedules systems.

What protocol does Control-M use? ›

Control‑M works with the Secure Sockets Layer (SSL) and Transport Layer Security (TLS) protocols, ensuring secure communication between the various Control-M components.

Does Control-M have an API? ›

Control-M Automation API provides an automated interface to perform Control-M functionalities, such as test, run and deploy job definitions and packages to Control-M. You can manage job workflows as code, similar to the way modern configuration management solutions manage infrastructure as code.

What platforms are supported by Control-M? ›

BMC Helix Control-M supports Google Chrome and Microsoft Edge browsers. Installation, network preparation and client deployment requirements are minimal. Agents for each platform are available in-product and support both Windows and Linux.

What are the three types of airflow system? ›

THREE AIRFLOW TYPES

There are actually three types that we can measure: system, supply/return, and mechanical ventilation. The first type, system airflow, refers to the immediate flow of air in the HVAC equipment. A/C units work because they exchange heat between the home, refrigerant (“Freon”), and outdoors.

What are the two types of mass airflow sensors? ›

There are two common types of mass airflow sensors in use on automotive engines. These are the vane meter and the hot wire.

What is better than airflow? ›

However, there are several other alternatives that offer unique features and benefits. In this blog post, we will discuss five alternatives to manage workflows: Prefect, Dagster, Luigi, Mage AI, and Kedro. These tools can be used for any field, not just limited to data engineering.

What is the Control-M script? ›

Control-M is a workload automation solution that enables you to automate the scheduling and processing of your business workflows across various platforms and applications from a single point of control. Every organization depends upon certain processes running regularly.

How do I manually run a Control-M job? ›

From the Monitoring domain, right-click the job you want to execute and select Run. The job executes, overriding any submission criteria.

What is Control-M Server responsible for? ›

Although Control-M/Server is responsible for job scheduling and processing, it does not have to limit the activity to the computer on which it resides.

What is Control-M shortcut key for? ›

Indent the paragraph

What is the use of Control-M in presentation? ›

Work with presentations and slides
To do thisPress
Insert a new slide.Ctrl+M
Go to the next slide.Page down
Go to the previous slide.Page up
Zoom out.Ctrl+Minus sign (-)
8 more rows

Top Articles
Latest Posts
Recommended Articles
Article information

Author: Ray Christiansen

Last Updated:

Views: 6448

Rating: 4.9 / 5 (49 voted)

Reviews: 88% of readers found this page helpful

Author information

Name: Ray Christiansen

Birthday: 1998-05-04

Address: Apt. 814 34339 Sauer Islands, Hirtheville, GA 02446-8771

Phone: +337636892828

Job: Lead Hospitality Designer

Hobby: Urban exploration, Tai chi, Lockpicking, Fashion, Gunsmithing, Pottery, Geocaching

Introduction: My name is Ray Christiansen, I am a fair, good, cute, gentle, vast, glamorous, excited person who loves writing and wants to share my knowledge and understanding with you.