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.

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

-------- 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.
Press Enter. The Job List screen is displayed.
Figure 7 List of Decollating Missions on the Job List Screen

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

A list of all decollating missions used in the Walkthrough is displayed in the Job List screen.

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

PRODJCL, a generic decollating mission, is the first decollating mission discussed.
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

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

Each decollating mission has one or more categories. In this example, PRODJCL has one category. For more information about categories, see Chapter 3 of the Control-D and Control-V User Guide.
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

----- 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	* 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. Note: 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:
1. Position the cursor in the COMMAND field.
2. Type SCHED and press Enter.
Figure 10 Scheduling Criteria Display

----- 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.
1. 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:
1. Position the cursor in the COMMAND field.
2. 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.

Parent Topic

Report Decollating Missions – Generic