Editing Mission Definitions in the IOA Edit Environment

Mission definition parameters can be edited (moved, copied, deleted, repeated) by performing IOA line editing commands, similar to standard ISPF line commands, from within the IOA Edit environment.

The Edit environment in a Mission Definition screen is accessed by typing EDIT in the COMMAND field and pressing Enter.

Figure 469 Edit Environment in The Mission Definition Screen

Copy 
--------- CONTROL-D/V CATEGORY DAILY              JOB  DAYTASK  ----------(R.S)
COMMAND ===>                                                    SCROLL===> CRSR
+-----------------------------------------------------------------------------+
__ CATEGORY DAILY                     JOBNAME DAYTASK  GENERIC   MONITOR
__ OWNER    M22         TASKTYPE REP  GROUP   DAILY-JOB          JOBID
__ DESC     INVENTORY AND EMPLOYEE SAMPLE REPORTS
__ DESC
__ ===========================================================================
__ DAYS                                                          DCAL
__                                                                    AND/OR
__ WDAYS   ALL                                                   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      PLRPT010-ENDED-OK    ODAT
__ WHEN IN QUEUE Y CLS   TIME FROM 0100 UNTIL 0630 INTERVAL 001  PRIORITY
__ DSN
__ ===========================================================================
__ OUT
__ SHOUT WHEN NOTOK                                TO OPER2            URG R
__  MSG ==== REPORT DECOLLATION FOR REPORT1 ENDED  N O T O K ====
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH               15.15.24

A 2-character line editing command field, marked by underscores, is displayed for each line on the screen.

Editing commands are typed directly onto these underscores.

Incorrectly specified line editing commands can be corrected by typing over them correctly. Line editing commands can be deleted by blanking them out or by specifying the RESET command in the COMMAND field.

Specified line editing commands are processed when Enter is pressed.

Control-V performs automatic syntax checking to ensure that the mission definition is syntactically correct after editing. If an edit invalidates the mission definition, a message is displayed at the top of the screen and the edit is not performed. For editing mission definitions, see "Maintaining Valid Mission Definitions" in this appendix for guidelines and recommendations.

All operations available in a Mission Definition screen can be performed while in the Edit environment (for example, parameter values can be changed, the mission can be saved, and the screen exited).

To exit the Edit environment, retype EDIT in the COMMAND field and press Enter. Line editing command fields are removed from the display.

Line editing commands can be performed on the following:

Table 285 Subjects for Line Editing Commands

Subject

Description

Single Lines

One single line on the screen.

  • Additional lines of parameter IN.

  • Single lined DO statements (such as DO COND).

Logical Lines

All parameter lines for a specific parameter, including its subparameters.

  • Statement DO SHOUT, whose subparameters are distributed over more than one line.

  • Single lined DO statements (such as DO COND).

Logical Blocks

Functional group of parameter lines.

ON block, which consists of its parameter lines and DO statement lines.

Multiple Lines

User-specified group of parameter lines.

A series of DO statements.

Line Editing Commands

The following types of line editing commands exist in the Edit environment.

Table 286 Delete Commands

Command

Effect

DS

Delete a single line.

DL

Delete a logical line.

DB

Delete a logical block.

DD

Delete lines between two DD specifications.

D

Delete a line. Control-V determines whether to delete a single or logical line based on the line type.

Table 287 Copy Commands

Command

Effect

CS

Copy a single line.

CL

Copy a logical line.

CB

Copy a logical block.

CC

Copy lines between two CC specifications.

C

Copy a line. Control-V determines whether to copy a single or logical line based on the line type.

Copy commands are used in conjunction with Location commands. The lines or blocks are placed at the position indicated by Location command A or B (described below).

Table 288 Move Commands

Command

Effect

MS

Move a single line.

ML

Move a logical line.

MB

Move a logical block.

MM

Move lines between two MM specifications.

M

Move a line. Control-V determines whether to move a single or logical line based on the line type.

Move commands are used in conjunction with Location commands. The lines or blocks are placed at the position indicated by Location command A or B (described below).

Table 289 Repeat Commands

Command

Description

RS

Repeat a single line.

RL

Repeat a logical line.

RB

Repeat a logical block.

RR

Repeat lines between two RR specifications.

R

Repeat a line. Control-V determines whether to repeat a single or logical line based on the line type.

The repeated lines or blocks are placed immediately after the lines or blocks that has been repeated.

Table 290 Insert Commands

Command

Description

I (Insert)

Insert a new logical line or block after the logical line or block marked with an I.

Table 291 Location Commands

Command

Description

Indication of the position where lines or blocks should be placed.

A (After)

Indicates that lines or blocks should be placed after the line marked with an A.

B (Before)

Indicates that lines or blocks should be placed before the line marked with a B.

Location commands A and B are used in conjunction with Copy (C, CS, CL, CC, CB), and Move (M, MS, ML, MM, MB) commands.

Maintaining Valid Mission Definitions

Since mission definitions must be syntactically correct at all times, the user should consider the following issues when specifying line editing commands:

  • The result of a line editing command is dependent on the line on which the command is specified. For example, command D deletes either a single or a logical line based on the line type.

  • Logical lines form a unit and cannot be separated.

  • When a logical command is specified within a logical line (that is, on a subparameter line or a continuation line), the specified operation is performed on the entire logical line.

  • Block commands should be specified on the main lines of the block.

  • A separator line must exist between blocks and cannot be deleted.

  • Blank parameter lines are added automatically by Control-V (to allow the user to specify additional parameters) and cannot be deleted.

  • BMC recommends that, wherever possible, commands D, C, M and R be used for editing (instead of DS, DL, CS, CL, MS, ML, RS and RL) because these commands automatically retain the logical structure of the mission definition.

Before: Insert an additional DO statement in a DO block using command I (Insert).

Figure 470 Example 1 - Inserting Additional DO Statement - Before

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      = W         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 =
I_   DO NAME     = PRODUCTION JCL               LINE     COL     -
__   DO USER     = PRODCNTL              LVL    LINE     COL     -     S N T
                                         SYNONYM =       CONCAT =
__   DO BACKUP   = BKP0007D
__   DO USER     = OPERATE               LVL    LINE     COL     -     S A T
                                         SYNONYM =       CONCAT =
__   DO USER     = OPERMGMT              LVL    LINE     COL     -     S A T
                                         SYNONYM =       CONCAT =
__   DO
__ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
 FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH              17.29.18

After: An additional DO statement line has been opened.

Figure 471 Example 1 - Inserting Additional DO Statement - After

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      = W         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               LINE     COL     -
__   DO
__   DO USER     = PRODCNTL              LVL    LINE     COL     -     S N T
                                         SYNONYM =       CONCAT =
__   DO BACKUP   = BKP0007D
__   DO USER     = OPERATE               LVL    LINE     COL     -     S A T
                                         SYNONYM =       CONCAT =
__   DO USER     = OPERMGMT              LVL    LINE     COL     -     S A T
                                         SYNONYM =       CONCAT =
__   DO
 FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH               17.29.33

Before: Delete the ON CLASS A block. Using the DB (Delete Block) command is the preferred method. The DB command removes all parameters, comments, continuation lines, and separator lines of the specified block. DB must be specified on a main line of the block (that is, ON CLASS).

Figure 472 Example 2 - Use of Delete Block Command - Before

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
__ ===========================================================================
DB ON CLASS      = A         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               LINE     COL     -
__   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 CLASS      = B         EXTWTR               DEST          FORM
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH               18.37.54

After: The ON CLASS A block has been deleted.

Figure 473 Example 2 - Use of Delete Block Command - After

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      = B         EXTWTR               DEST          FORM
__ PRT COPIES    LVL    USER                      DEST          MAX COPIES
__     PRINT/CDAM PARMS =
__ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
__      STRING =
__   DO NAME     = PRODUCTION JCL               LINE     COL     -
__   DO
__ ===========================================================================
__ ON
__ PRT COPIES    LVL    USER                      DEST          MAX COPIES
__     PRINT/CDAM PARMS =
__ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
__      STRING =
__   DO
======= >>>>>>>>>> END OF JOB/REPORT PARAMETERS FOR THIS CATEGORY <<<<<<< =====
  
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH                18.39.54

Before: Move multiple DO statements from one ON block to another. Command MM (Multiple Move) is specified at the beginning and the end of the DO statements that are moved. Command A (After) specifies the location after which these lines are placed.

Figure 474 Example 3 - Use of Multiple Move Command - Before

Copy 
 ------- CONTROL-D/V CATEGORY DAILY                JOB  * (R.S)
 COMMAND ===>                                                    SCROLL===> CRSR
 +------------------------------------+
 __
LINE     -     COL     -     PRINT   REF NEXT PAGE   CONTID   AND/OR
 __      STRING =
 __   DO NAME     = PRODUCTION JCL               LINE     COL     -
 MM   DO USER     = NONPRODCNTL           LVL    LINE     COL     -     S N T
                                          SYNONYM =       CONCAT =
 __   DO BACKUP   = BKP0007D
 __   DO SHOUT    TO TSO-001             URGENCY
 MM    = NON-PRODUCTION JCL COMPLETED
 __ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
 __      STRING =
 __   DO
 __ ===========================================================================
 __ ON CLASS      = B         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 =
 A_   DO NAME     = NON-PRODUCTION JCL           LINE     COL     -
 __   DO
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH                18.47.45

After: The three specified DO statements have been moved to the specified location.

Figure 475 Example 3 - Use of Multiple Move Command - After

Copy 
 ------- CONTROL-D/V CATEGORY DAILY                JOB  *        - (R.S)
 COMMAND ===>                                                    SCROLL===> CRSR
 +------------------------------------+
 __ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
 __      STRING =
 __   DO NAME     = PRODUCTION JCL               LINE     COL     -
 __   DO
 __ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
 __      STRING =
 __   DO
 __ ===========================================================================
 __ ON CLASS      = B         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     = NON-PRODUCTION JCL           LINE     COL     -
 __   DO USER     = NONPRODCNTL           LVL    LINE     COL     -     S N T
  
 __   DO BACKUP   = BKP0007D
 __   DO SHOUT    TO TSO-001             URGENCY R
  
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH                18.50.58

Before: Copy a WHEN statement and some of its DO statements to another WHEN statement. Command CC (Multiple Copy) is specified at the beginning and the end of the lines that are copied. Command B (Before) specifies the location before which these lines are placed.

Figure 476 Example 4 - Use of Multiple Copy Command - Before

Copy 
 ------- CONTROL-D/V CATEGORY DAILY                JOB  * (R.S)
 COMMAND ===>                                                    SCROLL===> CRSR
 +-----------------------------------+
 __ ON CLASS      = A         EXTWTR               DEST          FORM
 __ PRT COPIES    LVL    USER                      DEST          MAX COPIES
 __     PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
 __     PRINT/CDAM PARMS =
 CC WHEN LINE 00001 - 00001 COL       -       PRINT   REF NXT   CT     AND/OR
 __      STRING = DD
 __   DO NAME     = PRODUCTION JCL               LINE     COL     -
 CC   DO USER     = PRODCNTL              LVL    LINE     COL     -     S N T
                                          SYNONYM =       CONCAT =
 __   DO BACKUP   = BKP0007D
 __   DO
 B_ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
 __      STRING =
 __   DO
 __ ===========================================================================
 __ ON CLASS      = C         EXTWTR               DEST          FORM
 __ PRT COPIES    LVL    USER                      DEST          MAX COPIES
 __     PRINT/CDAM PARMS =
 __ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
 __      STRING =
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH                18.57.05

After: The specified WHEN and DO statements have been successfully copied.

Figure 477 Example 4 - Use of Multiple Copy Command - After

Copy 
------- CONTROL-D/V CATEGORY DAILY                JOB  * (R.S)  
COMMAND ===>                                                    SCROLL===> CRSR
 +------------------------------------+
 __ ON CLASS      = A         EXTWTR               DEST          FORM
 __ PRT COPIES    LVL    USER                      DEST          MAX COPIES
 __     PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
 __     PRINT/CDAM PARMS =
 __ WHEN LINE 00001 - 00001 COL       -       PRINT   REF NXT   CT     AND/OR
 __      STRING = DD
 __   DO NAME     = PRODUCTION JCL               LINE     COL     -
 __   DO USER     = PRODCNTL              LVL    LINE     COL     -     S N T
                                          SYNONYM =       CONCAT =
 __   DO BACKUP   = BKP0007D
 __   DO
 __ WHEN LINE 00001 - 00001 COL       -       PRINT   REF NXT   CT     AND/OR
 __      STRING = DD
 __   DO NAME     = PRODUCTION JCL               LINE     COL     -
 __   DO USER     = PRODCNTL              LVL    LINE     COL     -     S N T

 __   DO
 __ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
 __      STRING =
 __   DO
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH                18.58.32

Before: Insert a continuation line between existing continuation lines. It is recommended that command R (Repeat) be used to repeat the previous logical line.

Figure 478 Example 5 - Use of Insert Command - Before

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      = W         EXTWTR               DEST          FORM
 __ PRT COPIES    LVL    USER                      DEST          MAX COPIES
 __     PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
 __     PRINT/CDAM PARMS =
 __ WHEN LINE 00001 - 00002 COL 00005 -       PRINT   REF NXT   CT     AND/OR
 __      STRING = DD
 R_ WHEN LINE 00003 - 00003 COL 00005 -       PRINT   REF NXT   CT     AND/OR
 __      STRING = DISK
 __ WHEN LINE 00004 - 00004 COL 00005 -       PRINT   REF NXT   CT     AND/OR
 __      STRING = TAPE
 __   DO NAME     = PRODUCTION JCL               LINE     COL     -
 __   DO USER     = PRODCNTL              LVL    LINE     COL     -     S N T
                                          SYNONYM =       CONCAT =
 __   DO BACKUP   = BKP0007D
 __   DO
 __ WHEN LINE       -       COL       -       PRINT   REF NXT   CT     AND/OR
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH                19.17.29

After: The continuation line has been repeated. The repeated line can be modified as necessary.

Figure 479 Example 5 - Use of Insert Command - After

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      = W         EXTWTR               DEST          FORM
 __ PRT COPIES    LVL    USER                      DEST          MAX COPIES
 __     PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
 __     PRINT/CDAM PARMS =
 __ WHEN LINE 00001 - 00002 COL 00005 -       PRINT   REF NXT   CT     AND/OR A
 __      STRING = DD
 __ WHEN LINE 00003 - 00003 COL 00005 -       PRINT   REF NXT   CT     AND/OR A
 __      STRING = DISK
 __ WHEN LINE 00003 - 00003 COL 00005 -       PRINT   REF NXT   CT     AND/OR A
 __      STRING = DISK
 __ WHEN LINE 00004 - 00004 COL 00005 -       PRINT   REF NXT   CT     AND/OR 
 __      STRING = TAPE
 __   DO NAME     = PRODUCTION JCL               LINE     COL     -
 __   DO USER     = PRODCNTL              LVL    LINE     COL     -     S N T
                                          SYNONYM =       CONCAT =
 __   DO BACKUP   = BKP0007D
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH                19.18.40