Report Decollating Missions: Generic
This chapter includes the following topics:
Managing MSGCLASS Job Output
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:
-
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 42If the library name in the LIBRARY field is not the same as your Control-D REPORTS library name, correct it.
-
Press Enter. The Job List screen is displayed.
Figure 7 List of Decollating Missions on the Job List Screen
CopyLIST 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 -
Position the cursor in the OPT field, to the left of the PRODJCL mission.
-
Type S and press Enter.
Figure 8 A One-Category Decollation Mission
CopyCATEGORIES 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 -
Position the cursor in the OPT field, to the left of the DAILY category.
-
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.36This 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.
-
-
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:
-
Position the cursor in the COMMAND field.
-
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.08The scheduling criteria are displayed.
-
Look for the SHOUT option. This SHOUT sends a highlighted, unscrollable message to the operator console if this mission finishes without executing successfully.
-
-
To hide the scheduling criteria again do the following:
-
Position the cursor in the COMMAND field.
-
Type SCHED and press Enter. The scheduling criteria are hidden again.
-
-
Press PF03/PF15. You are returned to the Category list.
-
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.
-
Press PF03/PF15 twice to return to the IOA Primary Option menu.
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.
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.
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
-
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.42You have entered the Control-D Report Decollating Mission Definition entry panel. Do not change the library name that you just used.
-
Press Enter. The Job List screen is displayed.
Figure 12 Report Decollation Job List
CopyLIST 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 -
Position the cursor in the OPT field, to the left of the PRODJCL mission.
-
Type O and press Enter. The following Confirmation window is displayed:
Figure 13 Confirmation Window
CopyLIST 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 -
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 -
To return to the IOA Primary Option menu for the next exercise, press PF03/PF15 three times.
You have just ordered your first decollating mission.
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
-
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 -
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.
-
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.
-
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.
-
-
Position the cursor to the left of the decollating mission.
-
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 -
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.
-
Type =U in the COMMAND field and press Enter. The User Reports entry panel is displayed.
-
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.
-
Type =1 in the COMMAND field and press Enter to transfer to the IOA Primary Option menu with the same method.
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.
Viewing and Editing MSGCLASS Output Online
Viewing MSGCLASS Output
Begin
-
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 -
Position the cursor in the USER field.
-
Type PRODCNTL.
-
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.
-
Position the cursor in the DISPLAY TYPE field.
-
Type J and press Enter. The Active Report List screen is displayed.
Figure 18 Active Report List Screen
CopyACTIVE 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 -
-
Select any job in the list:
-
Position the cursor to the left of the line in which the job appears.
-
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
-
-
Practice a few minutes to familiarize yourself with the various scrolling options.
-
Scroll Forward and Backward: Press PF08/PF20 and PF07/PF19.
-
Shift Left and Right: Press PF10/PF22 and PF11/PF23.
-
Scroll to the Bottom of the Report: Type M (Maximum) in the COMMAND field and press PF08/PF20.
-
Scroll to the Top of the Report: Type M (Maximum) in the COMMAND field and press PF07/PF19.
-
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.
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).
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
-
To view a MSGCLASS output, you now "activate" a previously defined ruler:
-
Position the cursor in the COMMAND field.
-
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 -
-
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:
-
Position the cursor in the COMMAND field.
-
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.
-
Use the RULER command $JOBCHK on the MSGCLASS of any job under Control-D.
-
-
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
-
On the Active List screen, position the cursor to the left of the MSGCLASS output you decide to print.
-
Type P and press Enter. The Online Print Option window is displayed.
Figure 21 Online Print Option Window
CopyACTIVE 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 -
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.
-
Type 1 (for Immediate Printing) and press Enter. The following message is displayed on the top line of the screen:
CopyCTD947I 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).
-
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.
-
Type P and press Enter. The same Print Option window you saw earlier is displayed again.
-
Type the same parameters that you typed previously.
-
Add an additional parameter as follows:
-
Type 1.
-
Type $JOBCHK in the RULER field (over DEFAULT), and press Enter.
The following message is displayed on the top line of the screen:
CopyCTD947I 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.
-
-
Return to the IOA Primary Option menu for the next exercise.