Report Decollating Missions: Generic

This chapter includes the following topics:

Managing MSGCLASS Job Output

Control-D manages MSGCLASS job output with the help of a report decollating mission.

The decollating mission retrieves output from the system spool, creates compressed output datasets, and establishes ownership of the output (reports).

There are two types of decollating missions:

  • A generic decollating mission that contains all instructions required for Control-D to process a selected group of output from one or more predefined classes (meaning, one generic decollating mission for one or more jobs). A good example of a generic decollating mission is the MSGCLASS output of all production jobs.

  • A job decollating mission that contains all instructions required for Control-D to process one job name (meaning, one job decollating mission per job).

Define report decollating mission parameters only once for each job or group of jobs. Control-D uses these parameters for numerous executions of the same decollating mission. You can modify the parameters at any time, as needed.

Begin

From the IOA Primary Option menu, do the following:

  1. From the IOA Primary Option menu, select option R and press Enter. The Report Decollating Mission Definition entry panel is displayed.

    Figure 6 Report Decollating Mission Definition Entry Panel

    Copy
    -------- CONTROL-D/V REPORT DECOLLATING MISSION DEFINITION ENTRY PANEL -----(R)
    COMMAND ===>
     
     
     
    SPECIFY LIBRARY, JOB/REPORT NAME, CATEGORY
     
    LIBRARY   ===> CTD.PROD.REPORTS
    JOB       ===>                      (Blank for job selection list)
    CATEGORY  ===>                      (Blank for category selection list)
     
     
     
     
     
     
    SHOW SCHEDULING CRITERIA ===> N     (Y/N)
     
     
     
     
     
     
    USE THE COMMAND "SHPF" TO SEE PFK ASSIGNMENT                           12.39 42

    If the library name in the LIBRARY field is not the same as your Control-D REPORTS library name, correct it.

  2. Press Enter. The Job List screen is displayed.

    Figure 7 List of Decollating Missions on the Job List Screen

    Copy
    LIST OF JOBS LIB: CTD.PROD.REPORTS                            ----------------
     COMMAND ===>                                                    SCROLL===> CRSR
     OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
          I610INR1          01.01 00/03/02 00/04/04 12:11    14    12     0 IOA610
          I610INR2          01.00 00/05/03 00/05/04 17:50    31    31     0 IOA610
          PRODJCL           01.00 00/05/04 00/05/04 17:59    31    31     0 IOA610
      ====== >>>>>>>>>>>>>>>>>> NO MORE JOBS IN LIBRARY <<<<<<<<<<<<<<<<<<<<<< =====
     
     
     
     
     
     
     
     
     
    OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE           13.20.55
  3. A list of all decollating missions used in the Walkthrough is displayed in the Job List screen.

    PRODJCL, a generic decollating mission, is the first decollating mission discussed.

    The statistics accompanying each mission name may or may not be displayed, depending on the site-defined default.

  4. Position the cursor in the OPT field, to the left of the PRODJCL mission.

  5. Type S and press Enter.

    Figure 8 A One-Category Decollation Mission

    Copy
    CATEGORIES OF LIB CTD.PROD.REPORTS                                JOB: PRODJCL
    COMMAND ===>                                                    SCROLL===> CRSR
    OPT  NAME ----------------- DESCRIPTION ---------------------------------------
         DAILY                  GENERIC - FOR ALL PRODUCTION MSGCLASS (JCL)
     ====== >>>>>>>>>>>>>>  NO MORE CATEGORIES FOR THE JOB <<<<<<<<<<<<<<<<<< =====
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
    OPTIONS:  S SELECT   D DELETE   I INSERT   O ORDER   F FORCE   C COPY  15.18.57
  6. Each decollating mission has one or more categories. In this example, PRODJCL has one category. For more information about categories, see the Control-D and Control-V User Guide.

  7. Position the cursor in the OPT field, to the left of the DAILY category.

  8. Type S and press Enter.

    Figure 9 Predefined Generic Decollating Mission Definition

    Copy
    ----- CONTROL-D/V CATEGORY DAILY                JOB  *        ----------- (R.S)
     COMMAND ===>                                                    SCROLL===> CRSR
     +-----------------------------------------------------------------------------+
       CATEGORY DAILY                  JOBNAME *         GENERIC Y  MONITOR 1
       DEF COPIES 01 LVL    USER UNIDENT              DEST          MAX COPIES
       ===========================================================================
       ON CLASS      =           EXTWTR               DEST          FORM
       PRT COPIES    LVL    USER                      DEST          MAX COPIES
           PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
           PRINT/CDAM PARMS =
       WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
            STRING =
       DO NAME    = PRODUCTION JCL
       DO USER    = PRODCNTL                  LVL    LINE        COL       -
                               S N T         SYNONYM =       CONCAT =
       DO BACKUP  = BKP0007D
       DO
       WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
            STRING =
       DO
       ===========================================================================
       ON
    FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH               13.53.36

    This is a predefined generic decollating mission definition. At this stage you only need to be concerned with a few of the parameter fields on the screen. In general, Control-D allows you to view all the parameters for each mission in one screen; however, only a few parameters are used in a typical mission.

    Note the following fields:

    Table 1 Decollation Mission Parameters

    Parameter

    Description

    JOBNAME

    * (asterisk) selects any jobname. All jobs are selected.

    GENERIC

    Y indicates a generic decollating mission. The mission selects the non-held output from the specified class (as described in the ON CLASS parameter in this table), and decollates it.

    ON CLASS

    Specifies the generic class to process. During the installation process, one to eight generic classes are defined.

    PRINT/CDAM PARMS

    = ALLOCOPT=JOBSDSN1

    Use the ALLOCOPT parameter to improve Control-D performance according to the type of output processed. For more information, see the CDAM chapter in the Control-D and Control-V User Guide. The optimum parameter for MSGCLASS generic processing is JOBSDSN1.

    WHEN LINE STRING

    Use the WHEN parameter to identify each page in a report. Because MSGCLASS output is not identified by page, leave this field blank for this example.

    DO

    After output is selected, DO statements instruct Control-D what to do with the output. You can specify any number of DO statements. In this example:

    • DO NAME=PRODUCTION JCL

      All output processed from the specified class is named PRODUCTION JCL in Control-D.

    • DO USER=PRODCNTL

      All output processed from the specified class is directed (not necessarily printed) to the recipient PRODCNTL.

    • DO BACKUP=BKP0007D

      All output processed from the specified class is backed up to tape or cartridge and retained for a week. For more information about backup, see Backup and Restoring.

    Additional empty DO, WHEN, and ON clauses appear after the set of filled-in DO lines. These additional clauses are not required for this decollating mission, but they are available if you want to add additional criteria later.

    The set of empty DO, WHEN, and ON clauses is created each time you fill-in and enter a new set of DO, WHEN, and ON clauses.

  9. When you define scheduling criteria for the decollating mission for the first time, these scheduling criteria are usually hidden, and they are seldom used. Display them as follows:

    1. Position the cursor in the COMMAND field.

    2. Type SCHED and press Enter.

      Figure 10 Scheduling Criteria Display

      Copy
      ----- CONTROL-D/V CATEGORY DAILY                JOB  *        ----------- (R.S)
       COMMAND ===>                                                    SCROLL===> CRSR
       +-----------------------------------------------------------------------------+
         CATEGORY DAILY                  JOBNAME *         GENERIC Y  MONITOR 1
         OWNER    M22       TASKTYPE REP GROUP MSGCLASS-JCL           JOBID
         DESC     GENERIC - FOR ALL PRODUCTION MSGCLASS (JCL)
         DESC
         ===========================================================================
         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
         MINIMUM          PDS
         ===========================================================================
         IN
         WHEN IN QUEUE   CLS   TIME FROM      UNTIL      INTERVAL      PRIORITY
         DSN
         ===========================================================================
         OUT
         SHOUT WHEN NOTOK                                TO OPER2            URG R
          MSG GENERIC DECOLLATING MISSION --> PRODJCL ENDED  N O T O K !!!!
      FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH               14.06.08

      The scheduling criteria are displayed.

    3. Look for the SHOUT option. This SHOUT sends a highlighted, unscrollable message to the operator console if this mission finishes without executing successfully.

  10. To hide the scheduling criteria again do the following:

    1. Position the cursor in the COMMAND field.

    2. Type SCHED and press Enter. The scheduling criteria are hidden again.

  11. Press PF03/PF15. You are returned to the Category list.

  12. Press PF03/PF15 once again. If any modifications were made to the generic decollating mission, the Exit Option window is displayed.

    Type N in the SAVE field and press Enter.

    N stands for NO SAVE, so that the sample generic decollating mission required for the tutotial is not accidentally changed.

  13. Press PF03/PF15 twice to return to the IOA Primary Option menu.

Activating a Decollating Mission Manually

Decollating missions defined in a library are activated by "ordering" them. In Control-D, missions are ordered in two ways:

  • Automatic Ordering: Use automatic orders for most regularly scheduled processing. All missions defined for automatic processing are "ordered" automatically. For more information, see Setting Up Automatic Orders of Missions.

  • Manual Ordering: Use manual orders for missions that cannot be planned in advance, and for mission testing.

Order the decollating mission for the Walkthrough manually since it was not planned in advance.

Begin

  1. From the IOA Primary Option menu, select option R and press Enter.

    Figure 11 Report Decollating Mission Definition Entry Panel

    Copy
    --------CONTROL-D/V REPORT DECOLLATING MISSION DEFINITION ENTRY PANEL -----(R)
    COMMAND ===>
     
     
    SPECIFY LIBRARY, JOB/REPORT NAME, CATEGORY
     
     LIBRARY   ===> CTD.PROD.REPORTS
     JOB       ===>                      (Blank for job selection list)
     CATEGORY  ===>                      (Blank for category selection list)
     
     
     
     
     
     
     
     SHOW SCHEDULING CRITERIA ===> N     (Y/N)
     
     
     
     
     
    USE THE COMMAND "SHPF" TO SEE PFK ASSIGNMENT                           12.39.42

    You have entered the Control-D Report Decollating Mission Definition entry panel. Do not change the library name that you just used.

  2. Press Enter. The Job List screen is displayed.

    Figure 12 Report Decollation Job List

    Copy
    LIST OF JOBS LIB: CTD.PROD.REPORTS                            ----------------
     COMMAND ===>                                                    SCROLL===> CRSR
     OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
          I610INR1          01.01 00/03/03 00/04/04 12:11    14    12     0 IOA610
          I610INR2          01.00 00/05/05 00/05/05 17:50    31    31     0 IOA610
          PRODJCL           01.00 00/05/05 00/05/05 17:59    31    31     0 IOA610
      ====== >>>>>>>>>>>>>>>>>> NO MORE JOBS IN LIBRARY <<<<<<<<<<<<<<<<<<<<<< =====
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
    OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE           13.20.55
  3. Position the cursor in the OPT field, to the left of the PRODJCL mission.

  4. Type O and press Enter. The following Confirmation window is displayed:

    Figure 13 Confirmation Window

    Copy
    LIST OF JOBS LIB: CTD.PROD.REPORTS                            ----------------
     COMMAND ===>                                                    SCROLL===> CRSR
     OPT  NAME ------------ VV.MM  CREATED     CHANGED     SIZE  INIT   MOD   ID
          jobnamR1                                                 31
          jobnamR2          01.0 +-------------------------------+ 31     0 N44
      O   PRODJCL    <-----------|   CONFIRM     ODATE 050500    | 12     0 N44
    ====== >>>>>>>>>>>>>>>>>> NO +-------------------------------+ <<<<<<<<<<< =====
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
    OPTIONS:  S SELECT   O ORDER   F FORCE   B BROWSE   D DELETE           14.53.22
  5. Type Y in the CONFIRM field and press Enter. The following screen is displayed:

    Figure 14 Report Order Messages

    Copy
    ----------------------- CONTROL-D REPORT ORDER MESSAGES ------------------(R.O)
    COMMAND ===>                                                    SCROLL===> CRSR
    -------------------------------------------------------------------------------
     18.29.23 CTD049I MISSION PROCESSING STARTED
     18.29.23 CTD528I MISSION *        ODATE 050500 PLACED ON ACTIVE MISSIONS FILE
     18.29.23 CTD696I ALL MISSIONS PROCESSED SUCCESSFULLY
     ====== >>>>>>>>>>>>>>>>>      END OF MESSAGE LIST      <<<<<<<<<<<<<<<<< =====
     
    PRESS END TO RETURN.  LEFT AND RIGHT TO SEE MORE.                      15.58.31
  6. You have just ordered your first decollating mission.

  7. To return to the IOA Primary Option menu for the next exercise, press PF03/PF15 three times.

Tracking and Control

Perform all tracking and control of currently active missions (tasks) under one screen, the Control-D Active Missions screen (AMS). View the status of all missions that have executed recently, are currently executing, or will execute in the near future on the AMS.

Begin

  1. From the IOA Primary Option menu, type A and press Enter. The Active Missions Environment screen is displayed:

    Figure 15 Active Missions Environment

    Copy
    ------------------- CONTROL-D/V ACTIVE MISSIONS ENVIRONMENT ----------------(A)
     COMMAND ===>                                                    SCROLL===> CRSR
     O NAME     ODATE  TYP OWNER    ------------------STATUS ------------------  UP
      ======== >>>>>>>>>>>>>>>>>>>>> TOP OF ACTIVE MISSIONS LIST <<<<<<<<<<<<<<< ===
       STD      050500 PRT M22      WAIT SCHEDULE
       BKP0007D 050500 BKP M22      WAIT PROCESS
       BKP0031D 050500 BKP M22      WAIT PROCESS
       BKP0180D 050500 BKP M22      WAIT PROCESS
       BKP0365D 050500 BKP M22      WAIT PROCESS
       RST0060M 050500 CRS M22      WAIT PROCESS
       RSTADHOC 050500 RST M22      WAIT PROCESS
       *        050500 REP M22      GENERIC WAIT PROCESS
      ======== >>>>>>>>>>>>>>>>>>> BOTTOM OF ACTIVE MISSIONS LIST <<<<<<<<<<<<<< ===
     
     
     
     
     
     
     
     
     
     
    OPT: ? WHY H HOLD D DELETE F FREE L LOG Z ZOOM R RERUN P PRINT CONTROL 16.50.50
  2. Notice the field on the far right side of the third line on the screen. UP indicates that the Control-D Monitor is currently active. DOWN indicates that the Control-D Monitor is currently not active.

    The Control-D Online Facility is not dependent on the Control-D Monitor being active.

    When the Control-D monitor is brought up, Generic Classes processing is automatically activated. You may need to activate Generic Classes processing manually after Control-D is brought up. Use caution if you manually activate the Generic option when it has not been activated automatically.

    To manually automate Generic Classes processing, issue operator command:

    F CONTROLD,STARTGEN

    The following message is displayed on the operator console from which the modify command was issued:

    CTD139I GENERIC JOB DECOLLATION IS ACTIVE ON CLASSES (class-list)

    To deactivate Generic Classes processing, issue operator command:

    F CONTROLD,STOPGEN

    The last scrollable line in the screen is where the decollating mission that you ordered in the previous exercise is displayed. Other missions in the list are used in later sections of the Getting Started Guide.

    The status of the newly ordered decollating mission is GENERIC WAITING FOR JOB. This indicates that Control-D is waiting for a non-held job output to appear in the output class specified in the ON CLASS statement of the decollating mission.

    1. Press Enter periodically to display status changes. If the status remains unchanged for more than a few seconds (maximum thirty), there is no non-held output in the generic class on spool.

    2. For purposes of this tutorial, release a few MSGCLASS outputs to this class (using FLASHER, SDSF or any other spool display facility installed at your data center). When the decollating mission is processing the output of a job, its status changes to GENERIC DECOLLATING and the job name and job ID are also displayed.

      The status may change to ENDED OK and to other statuses during operation. When the decollating mission returns to WAITING FOR JOB status, there is no more non-held output in the generic output class on spool.

  3. Position the cursor to the left of the decollating mission.

  4. Type L and press Enter. The Log Messages screen is displayed.

    Figure 16 Log Messages Screen

    Copy
    ------------------- LOG MESSAGES FOR MISSION(S) *        ---------------(A.LOG)
     COMMAND ===>                                                    SCROLL===> CRSR
     SHOW LIMIT ON ==> USERID MEM/MIS                           DATE 050500 - 050500
     DATE   TIME   ODATE  USERID   CODE    ------ M E S S A G E --------------------
     ======== >>>>>>>>>>>>>>>>   T O P   O F   R A N G E    <<<<<<<<<<<<<<<< =======
     050500 164147 050500 N44      CTD511I REP * ODATE 050500 PLACED ON ACTIVE
                                           MISSIONS FILE-GENERIC - FOR ALL
                                           PRODUCTION MSGCLASS (JCL)
     ======== >>>>>>>>>>>>>>>>   NO  MORE  LOG  MESSAGES    <<<<<<<<<<<<<<<< =======
     
     
     
     
     
     
     
     
     
     
     
     
     
     
    CMDS: SHOW, GROUP, CATEGORY, SHPF                                      16.58.32
  5. Review all processing performed by the decollating mission, the jobs processed, and other information of interest. This is actually a filtered Control-D Log that shows only messages related to this decollating mission.

  6. Press PF03/PF15 to return to the AMS.

    Before proceeding to the next decollating mission exercise, the following short exercise demonstrates how you can quickly transfer to another Control-D screen (option) without passing through the IOA Primary Option menu.

  7. Type =U in the COMMAND field and press Enter. The User Reports entry panel is displayed.

  8. Type =A in the COMMAND field and press Enter. This transfers you back to the Active Missions screen.

    Notice that you return to the exact position that you were in before the transfer.

  9. Type =1 in the COMMAND field and press Enter to transfer to the IOA Primary Option menu with the same method.

Viewing and Editing MSGCLASS Output Online

Viewing MSGCLASS Output

Begin

  1. From the IOA Primary Option menu, type U and press Enter. The User Reports entry panel is displayed.

    Figure 17 User Reports Entry Panel

    Copy
    -------------------- CONTROL-D/V - USER REPORTS ENTRY PANEL  ---------------(U)
    COMMAND ===>
     
     
    OPTIONS ===>               1. PERMANENT  2. ACTIVE/MIGRATED  3. HISTORY
     
     
         REPORT NAME   ===>
         Report name, prefix or mask
         USER          ===> PRODCNTL              Recipient name or prefix
         DATE FROM     ===>        TO             Report date or relative day
         JOBNAME       ===>                       Job name, prefix or mask
     
         SHOW MIGRATED ===> N                     Include migrated reports
     
         INDEX         ===>                       Index name, prefix or mask
         VALUE                 ===>
     
     
     
         DISPLAY TYPE  ===> J                      BYPASS PANEL ===> N
  2. The User Reports entry panel is the main end-user (recipient) interface to Control-D information. Many facilities are provided under the User Reports screens. These are explained in depth in Report Decollating Missions: Job.

  3. Position the cursor in the USER field.

  4. Type PRODCNTL.

  5. The Control-D Online Viewing facility displays the list of reports in many different display types. The display type you use now is for MSGCLASS (JCL) output.

    1. Position the cursor in the DISPLAY TYPE field.

    2. Type J and press Enter. The Active Report List screen is displayed.

    Figure 18 Active Report List Screen

    Copy
    ACTIVE LIST    <J> JOB          REP                      USR PRODCNTL       (U)
    COMMAND ===>                                                    SCROLL===> CRSR
    O JOBNAME   JNUM STARTED        ENDED  PAGES    LINES V REMARK
      PRDRPTS2   8879 05/05/00 08:47 08:47      5       78   C0000
      PRDKPL01   9723 05/05/00 09:17 09:17      4      186   S0C4
      M22PRO1    8042 05/05/00 09:28 09:32      4       54   C0000
      M22PRO2    8059 05/05/00 09:47 09:56      4       48   C0000
      M010ERM    8068 05/05/00 09:48 10:22     17      679   C0000
      M200EP3    8100 05/05/00 10:29 10:29     15      583   JFAIL
      M22PARM    8218 05/05/00 11:58 11:58      9      251   C0000
      M12AWDT    8423 05/05/00 14:50 14:51     24      855   C0004
      M08STMIS   9261 05/05/00 15:07 15:10    331    16497   S222
      M0869REP   9262 05/05/00 15:08 15:10    320    16021   U1024
      M225MANL   8443 05/05/00 15:08 15:08      8      539   C0000
      M225MSGD   8463 05/05/00 15:21 15:21      9      701   C0012
      M28RPTU    8521 05/05/00 16:07 16:32     12      954   C0016
      M12WTO2    8650 05/05/00 18:20 18:21     83     3641   C0004
      M12AMWTO   8655 05/05/00 18:23 18:24    152     6737   C0000
      PRDKPL01   8657 05/05/00 18:25 18:25      4      185   S0C4
      M14TES1    8690 05/05/00 18:51 18:51      4       47   C0000
      M19SMPJ    8716 05/05/00 19:18 20:06    135     6143   S222
      M20INSCD   8365 05/05/00 20:07 20:52     19     1012   C0000
    P PRINT     V VIEW     U UPDATE     I INSERT     A ADD INFO     E EDIT
    X INDEX     N NOTE     G GIVETO     D DELETE     Q QUICK ACCESS       12.39.17
  6. This screen list of all jobs decollated by the decollating mission appears on the screen.

    Notice the REMARK field. This field indicates the highest condition code or abend of the job. It is possible to specify selection criteria according to the REMARK. A common use of this option is to select all jobs that have ended NOTOK by specifying NOTOK in the REMARK field of the Show Option window as accessed from the User Reports entry panel.

    If you need more information on any of the fields on the screen, refer to the Control-D and Control-V User Guide or use the HELP key (PF01/PF13).

  7. Select any job in the list:

    1. Position the cursor to the left of the line in which the job appears.

    2. Type V and press Enter.

      A screen similar to the one in Figure 19 is displayed.

      Because the INCONTROL Administrator can change the letters used for screen options, the data you see may be different.

      Figure 19 Report Viewing Screen

      Copy
      ----------------- CONTROL-D REPORT VIEWING   NOTES    0   PAGE      1 OF      5
       COMMAND ===>                                                   SCROLL ===> CRSR
       USER   PRODCNTL    JOBNAME  M22UPDT1 JOBNUMB 0001948 DATA  050500 RULER
       REPORT  PRODUCTION JCL
      ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8
      J E S 2  J O B  L O G  --  S Y S T E M  F D S F  --  N O
       
      13.38.46 JOB 1948  $HASP373 M22UPDT1 STARTED - INIT  2 - CLASS A - SYS FDSF
      13.38.47 JOB 1948  IEF403I M22UPDT1 - STARTED - TIME=13.38.47
      13.39.26 JOB 1948  M22UPDT1.STEP1   .#01; - COMPLETION CODE=0000
      13.39.26 JOB 1948  M22UPDT1.STEP2   .#02; - COMPLETION CODE=0004
      13.39.27 JOB 1948  M22UPDT1.STEP3   .#03; - COMPLETION CODE=0000
      13.39.29 JOB 1948  M22UPDT1.STEP4   .#04; - COMPLETION CODE=0000
      13.39.29 JOB 1948  M22UPDT1.STEP5   .#05; - COMPLETION CODE=NOT RUN
      13.39.29 JOB 1948  IEF453I M22UPDT1 - JOB FAILED - JCL ERROR - TIME=13.39.29
      13.39.29 JOB 1948  $HASP395 M22UPDT1 ENDED
      ------ JES2 JOB STATISTICS ------
          05 MAY 00 JOB EXECUTION DATE
                 32 CARDS READ
                230 SYSOUT PRINT RECORDS
                  0 SYSOUT PUNCH RECORDS
                 13 SYSOUT SPOOL KBYTES
               0.71 MINUTES EXECUTION TIME
         1     //M22UPDT1 JOB ,GPL,MSGCLASS=R,CLASS=Q,NOTIFY=M22
      CMDS: FIND str (PREV),  EDIT, RULER on/off/name,  N n  P n       11.57.55
  8. Practice a few minutes to familiarize yourself with the various scrolling options.

    1. Scroll Forward and Backward: Press PF08/PF20 and PF07/PF19.

    2. Shift Left and Right: Press PF10/PF22 and PF11/PF23.

    3. Scroll to the Bottom of the Report: Type M (Maximum) in the COMMAND field and press PF08/PF20.

    4. Scroll to the Top of the Report: Type M (Maximum) in the COMMAND field and press PF07/PF19.

Editing MSGCLASS Output

At this stage, you are introduced to report editing, an advanced feature of Control-D. This exercise illustrates some advantages of using rulers (sets of screen editing rules) on MSGCLASS output. In a later section additional uses for rulers and how to define them are discussed.

Production personnel spend much time examining MSGCLASS output for error messages (for example, condition codes, abend codes, JCL errors, NOT CATLGD 2, and so on). Control-D rulers can make this task easier.

Begin

  1. To view a MSGCLASS output, you now "activate" a previously defined ruler:

    1. Position the cursor in the COMMAND field.

    2. Type RULER $JOBCHK and press Enter. The original MSGCLASS output is displayed with a ruler activated. It displays messages and strings that are relevant to production personnel.

    Figure 20 Screen with Defined Ruler Activated

    Copy
     ----------------- CONTROL-D REPORT VIEWING   NOTES    0   PAGE      1 OF      5
     COMMAND ===>                                                   SCROLL ===> CRSR
     USER PRODCNTL   JOBNAME M22UPDT1   JOBNUMB 0001948  DATA 050500   RULER $JOBCHK
     REPORT PRODUCTION JCL
    ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8 
    13.38.47 JOB 1948  IEF403I M22UPDT1 - STARTED - TIME=13.38.47
    13.39.29 JOB 1948  IEF453I M22UPDT1 - JOB FAILED - JCL ERROR - TIME=13.39.29
    IEF142I M22UPDT1 STEP1 - STEP WAS EXECUTED - COND CODE 0000
    IEF142I M22UPDT1 STEP2 - STEP WAS EXECUTED - COND CODE 0004
    IEF142I M22UPDT1 STEP3 - STEP WAS EXECUTED - COND CODE 0000
    IEF142I M22UPDT1 STEP4 - STEP WAS EXECUTED - COND CODE 0000
    IEF212I M22UPDT1 STEP5 DD1 - DATA SET NOT FOUND
    IEF272I M22UPDT1 STEP5 - STEP WAS NOT EXECUTED.
    IEF376I  JOB /M22UPDT1/ STOP  96125.1339 CPU    0MIN 00.38SEC SRB    0MIN 00.04
     ====== >>>>>>>>>>>>>> NO MORE DATA TO VIEW <<<<<<<<<<<<<<<<<<<<<<<<<<<<< =====
     
     
     
     
     
     
     
     
    CMDS: FIND str (PREV),  EDIT, RULER on/off/name, VALUE, N n  P n       11.57.55
  2. Look at the RUL field at the right of the third line of the screen. This field indicates the ruler name activated (if any). It is possible to deactivate the ruler, as follows:

    1. Position the cursor in the COMMAND field.

    2. Type RULER (or just RU) and press Enter.

      Notice that you are viewing the original report again. Activate the ruler as often as you want.

    3. Use the RULER command $JOBCHK on the MSGCLASS of any job under Control-D.

  3. To return to the previous Active List screen, press PF03/PF15.

Immediate Printing

There are two ways to print in Control-D:

  • Deferred Printing: Output is predefined by a printing mission to print in bundles.

  • Immediate Printing: Upon request of a user, the Control-D Online facility immediately prints reports, or parts of reports.

This exercise illustrates how to perform immediate printing.

Begin

  1. On the Active List screen, position the cursor to the left of the MSGCLASS output you decide to print.

  2. Type P and press Enter. The Online Print Option window is displayed.

    Figure 21 Online Print Option Window

    Copy
    ACTIVE LIST    <J> JOB          REP                      USR PRODCNTL       (U)
     COMMAND ===>     +----------------------------------------------------------+ R
     O JOBNAME   JNUM |                                                          |
       PRDRPTS2  8879 |  PRINT OPTION ===>                                       |
       PRDKPL01  9723 |                                                          |
       M22PRO1   8042 |    1  Immediate Printing                                 |
       M22PRO2   8059 |    2  Deferred Printing (by Print Mission)               |
       M010ERM   8068 |    X  Exit (no action)                                   |
       M200EP3   8100 |                                                          |
       M22PARM   8218 |    COPIES  001             FORM STD       CLASS S        |
     P M12AWDT   8423 |                                                          |
       M08STMIS  9261 |    DEST                      WTR                         |
       M0869REP  9262 |                                                          |
       M225MANL  8443 |    FROM PAGE 000001 TO PAGE 000024  RULER DEFAULT        |
       M225MSGD  8463 |                                                          |
       M28RPTU   8521 |    PRINT MISSIONS                                        |
       M12WTO2   8650 |                                                          |
       M12AMWTO  8655 |    PAGEDEF            FORMDEF                            |
       PRDKPL01  8657 |                                                          |
       M14TES1   8690 |  REPORT PRODUCTION JCL                                   |
       M19SMPJ   8716 |  USER PRODCNTL   JOB M12AWDT                             |
       M20INSCD  8365 |                                                          |
       M19SMPJ   8716 +----------------------------------------------------------
    V VIEW E EDIT P PRINT U UPDT I INS D DEL N NOTE A ADD INFO G GIVETO   13.26.50
  3. Change the parameters in the window to fit your requirements. For example, change the DEST parameter to print at a remote printer (as opposed to the main computer printer), or change the copy count or page range.

  4. Type 1 (for Immediate Printing) and press Enter. The following message is displayed on the top line of the screen:

    Copy
    CTD947I REPORT PRINTED OK - FROM ACTIVE FILE jobname/username/reportname

    Your report was sent to the spool for printing. The output has the same name as your logon ID (when working under TSO).

  5. Earlier, you saw that MSGCLASS output is much easier to analyze with the ruler activated. In the following steps, you are going to print the output with the ruler activated. A ruler similar to the ruler you used for viewing is defined for printing.

    A ruler is defined for either viewing or printing.

    Position the cursor to the left of the report you just printed without a ruler activated.

  6. Type P and press Enter. The same Print Option window you saw earlier is displayed again.

  7. Type the same parameters that you typed previously.

  8. Add an additional parameter as follows:

    1. Type 1.

    2. Type $JOBCHK in the RULER field (over DEFAULT), and press Enter.

      The following message is displayed on the top line of the screen:

      Copy
      CTD947I REPORT PRINTED OK - FROM ACTIVE FILE jobname/username/reportname

      Your report was sent to the spool for printing; however, this time the ruler was activated.

  9. Return to the IOA Primary Option menu for the next exercise.