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.

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

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