Editing Rule Definitions in the IOA Edit Environment

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 definition screen is accessed by typing EDIT in the COMMAND field and pressing Enter. The Vault Definition screen below illustrates a definition screen after the Edit environment has been accessed.

Figure 219 Edit Environment in The Vault Definition Screen

Copy 
  VAULT VAULT_01  LIB CTT.PROD.RULES                               TABLE: $$VAULT
  COMMAND ===>                                                    SCROLL===> CRSR
  +-----------------------------------------------------------------------------+
  __ VAULT NAME  VAULT_01
  __ LOCAL       Y
  __ ===========================================================================
  __ DESC        FOR DIVISION 1 MEDIA.
  __ DESC
  __ OWNER       M43
  __ ADDRESS     1234 MAIN STREET
  __ ADDRESS
  __ PHONE       123-123-1234
  __ SCHEDULE    DAILY PROCESSING, EXCEPT ON WEEKENDS AND HOLIDAYS
  __ SCHEDULE    FOR ACCOUNTING DEPARTMENT
  __ SCHEDULE
  __ DOCMEM  CTTDOCS     DOCLIB   CTT.PROD.DOC
  __ ===========================================================================
  __ DOC                                                    
  __=========================== GLOBAL CAPACITY ================================
  __ CAPACITY 00001000 TYPE   SLOT     MEDIA 3400
  __          00000500 TYPE   SLOT     MEDIA 3420
  __          00001500 TYPE   SLOT     MEDIA 3490
  ======= >>>>>>>>>>>>>> END OF VAULT DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====
  FILL IN VAULT DEFINITION. CMDS: EDIT, SHPF, DOC                        10.23.19

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-M/Tape performs automatic syntax checking to ensure that the definition is still syntactically correct after editing. If an edit invalidates the definition, a message is displayed at the top of the screen and the edit is not performed. For guidelines and recommendations for editing definitions, see Maintaining Valid Definitions.

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

To exit the Edit environment, re-type 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 191 Subjects of Line Editing Commands

Subject

Description

Single Lines

One single line on the screen. Example:

  • Single line DO statements (such as DO LABEL).

Logical Lines

All parameter lines for a specific statement, including its subparameters and continuation lines. Example:

  • DO CONDITION, whose subparameters span several lines.

Logical Blocks

Functional group of parameter lines. Example:

  • ON block and its parameter lines.

Multiple Lines

User-specified group of parameter lines. Example:

  • Series of DO statements.

Separator Lines

A line of equal signs that separates blocks on the definition screen. Separator lines are not processed.

Line Editing Commands

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

Table 192 Line Editing Commands - Delete Commands

Command

Description

DS

Delete a single line.

DL

Delete a logical line.

DB

Delete a logical block or sub-block.

DD

Delete lines between two DD specifications.

D

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

Table 193 Line Editing Commands - Copy Commands

Command

Description

CS

Copy a single line.

CL

Copy a logical line.

CB

Copy a logical block or sub-block.

CC

Copy lines between two CC specifications.

C

Copy a line. Control-M/Tape product 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 and blocks are placed at the position indicated by Location command A or B (described below).

Table 194 Line Editing Commands - Move Commands

Command

Description

MS

Move a single line.

ML

Move a logical line.

MB

Move a logical block or sub-block.

MM

Move lines between two MM specifications.

M

Moves a line. Control-M/Tape determines whether to move a single or logical line based on line type.
Move commands are used in conjunction with Location commands. The lines and blocks are placed at the position indicated by Location command A or B (described below).

Table 195 Line Editing Commands - Repeat Commands

Command

Description

RS

Repeat a single line.

RL

Repeat a logical line.

RB

Repeat a logical block or sub-block.

RR

Repeat lines between two RR specifications.

R

Repeat a line. Control-M/Tape determines whether to repeat a single or logical line based on line type.
The repeated lines and blocks are placed immediately after the lines and blocks marked with the command.

Table 196 Line Editing Commands - Insert Command

Command

Description

I

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

Table 197 Line Editing Commands - Location Commands

Command

Description

Indication of the position where lines or blocks are placed.

A (After)

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

B (Before)

Indicates that lines or blocks are 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 Definitions

Since definitions must be syntactically correct at all times, 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, the D command deletes either a single line or a logical line, based on the line type.

  • Logical lines form a unit and must not be separated.

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

  • Block commands are specified on the main lines of the block.

  • For example, to delete an ON block, specify the DB (Delete Block) command on the ON line.

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

  • Blank parameter lines are added automatically by Control-M/Tape, to allow the user to specify additional parameters, and cannot be deleted.

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

Examples

Example 1

Repeat a DO block (that is modified later) in the Rule Definition screen

Figure 220 Example - Repeating A DO Block - Before

Copy 
 RULE: DBBKP1   LIB CTT.PROD.RULES                               TABLE: RULE2
 COMMAND ===>                                                    SCROLL===> CRSR
 +---------------------------------------+
 __ RULE NAME   DBBKP1    GROUP DATABASE-BACKUP           MODE PROD (Prod/Test)
 __ OWNER       M09A      SEQUENCE PRIORITY    CONTINUE SEARCH Y    (Y/N)
 __ DESCRIPTION
 __ DOCMEM      DBBKP1    DOCLIB CTT.PROD.DOC
 __ ===========================================================================
 __ ON DATASET   = BKP.DB*                                         And/Or/Not
 __ ===========================================================================
 __ DO POOL      = DATABASE-BKP
 __ DO RETENTION = DAYS              00060                         And/Or
 __ DO VAULT     = MAINLIB                    BY BOX    (Y/N)
 __      UNTIL     DAYS               0010                         And/Or
 R_    VAULT     = VAULT2
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     =
 __ DO SHOUT     = TO OPER              URGENCY  R
 __    MESSAGE   END OF DATABASE BACKUP
 __           AT   CLOSE
 __ DO
 __ ===========================================================================
 __                           D O   O P T I O N S
 FILL IN RULE DEFINITION. CMDS: EDIT, SHPF, DOC, SCHED, DOOPT, ONOPT    10.00.27

The DO block has been repeated.

Figure 221 Example - Repeating A DO Block - After

Copy 
 RULE: DBBKP1   LIB CTT.PROD.RULES                               TABLE: RULE2
 COMMAND ===>                                                    SCROLL===> CRSR
 +---------------------------------------+
 __ RULE NAME   DBBKP1    GROUP DATABASE-BACKUP           MODE PROD (Prod/Test)
 __ OWNER       M09A      SEQUENCE PRIORITY    CONTINUE SEARCH Y    (Y/N)
 __ DESCRIPTION
 __ DOCMEM      DBBKP1    DOCLIB CTT.PROD.DOC
 __ ===========================================================================
 __ ON DATASET   = BKP.DB*                                         And/Or/Not
 __ ===========================================================================
 __ DO POOL      = DATABASE-BKP
 __ DO RETENTION = DAYS              00060                         And/Or
 __ DO VAULT     = MAINLIB                    BY BOX    (Y/N)
 __      UNTIL     DAYS               0010                         And/Or
 __    VAULT     = VAULT2
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     = VAULT2
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     =
 __ DO SHOUT     = TO OPER              URGENCY  R
 __    MESSAGE   END OF DATABASE BACKUP
 __           AT   CLOSE
 __ DO
 FILL IN RULE DEFINITION. CMDS: EDIT, SHPF, DOC, SCHED, DOOPT, ONOPT    10.02.12

Example 2

Repeat selected DO statements in the Rule Definition screen.

Figure 222 Example - Repeating A DO Statement - Before

Copy 
 RULE: DBBKP1   LIB CTT.PROD.RULES                               TABLE: RULE2
 COMMAND ===>                                                    SCROLL===> CRSR
 +--------------------------------------+
 __ RULE NAME   DBBKP1    GROUP DATABASE-BACKUP           MODE PROD (Prod/Test)
 __ OWNER       M09A      SEQUENCE PRIORITY    CONTINUE SEARCH Y    (Y/N)
 __ DESCRIPTION
 __ DOCMEM      DBBKP1    DOCLIB CTT.PROD.DOC
 __ ===========================================================================
 __ ON DATASET   = BKP.DB*                                         And/Or/Not
 __ ===========================================================================
 __ DO POOL      = DATABASE-BKP
 __ DO RETENTION = DAYS              00060                         And/Or
 __ DO VAULT     = MAINLIB                    BY BOX    (Y/N)
 __      UNTIL     DAYS               0010                         And/Or
 RR    VAULT     = VAULT2
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     = VAULT3
 RR      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     =
 __ DO SHOUT     = TO OPER              URGENCY  R
 __    MESSAGE   END OF DATABASE BACKUP
 __           AT   CLOSE
 __ DO
 FILL IN RULE DEFINITION. CMDS: EDIT, SHPF, DOC, SCHED, DOOPT, ONOPT    10.02.12

The specified DO statements have been repeated.

Figure 223 Example - Repeating A DO Statement - After

Copy 
 RULE: DBBKP1   LIB CTT.PROD.RULES                               TABLE: RULE2
 COMMAND ===>                                                    SCROLL===> CRSR
 +----------------------------------------+
 __ RULE NAME   DBBKP1    GROUP DATABASE-BACKUP           MODE PROD (Prod/Test)
 __ OWNER       M09A      SEQUENCE PRIORITY    CONTINUE SEARCH Y    (Y/N)
 __ DESCRIPTION
 __ DOCMEM      DBBKP1    DOCLIB CTT.PROD.DOC
 __ ===========================================================================
 __ ON DATASET   = BKP.DB*                                         And/Or/Not
 __ ===========================================================================
 __ DO POOL      = DATABASE-BKP
 __ DO RETENTION = DAYS              00060                         And/Or
 __ DO VAULT     = MAINLIB                    BY BOX    (Y/N)
 __      UNTIL     DAYS               0010                         And/Or
 __    VAULT     = VAULT2
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     = VAULT3
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     = VAULT2
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     = VAULT3
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     =
 FILL IN RULE DEFINITION. CMDS: EDIT, SHPF, DOC, SCHED, DOOPT, ONOPT    10.03.47

Example 3

Delete an unnecessary DO block from the Rule Definition screen.

Figure 224 Example - Deleting A DO Block - Before

Copy 
 RULE: DBBKP1   LIB CTT.PROD.RULES                               TABLE: RULE2
 COMMAND ===>                                                    SCROLL===> CRSR
 +-----------------------------------------------------------------------------+
 __ RULE NAME   DBBKP1    GROUP DATABASE-BACKUP           MODE PROD (Prod/Test)
 __ OWNER       M09A      SEQUENCE PRIORITY    CONTINUE SEARCH Y    (Y/N)
 __ DESCRIPTION
 __ DOCMEM      DBBKP1    DOCLIB CTT.PROD.DOC
 __ ===========================================================================
 __ ON DATASET   = BKP.DB*                                         And/Or/Not
 __ ===========================================================================
 __ DO POOL      = DATABASE-BKP
 __ DO RETENTION = DAYS              00060                         And/Or
 __ DO VAULT     = MAINLIB                    BY BOX    (Y/N)
 __      UNTIL     DAYS               0010                         And/Or
 __    VAULT     = VAULT2
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     = VAULT3
 __      UNTIL     VAULT DAYS         0050                         And/Or
 D_    VAULT     = VAULT4
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     = VAULT5
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     =
 FILL IN RULE DEFINITION. CMDS: EDIT, SHPF, DOC, SCHED, DOOPT, ONOPT    10.03.47

The unnecessary DO block has been deleted.

Figure 225 Example - Deleting A DO Block - After

Copy 
 LIB CTT.PROD.RULES                               TABLE: RULE2
 COMMAND ===>                                                    SCROLL===> CRSR
 +-----------------------------------------------------------------------------+
 __ RULE NAME   DBBKP1    GROUP DATABASE-BACKUP           MODE PROD (Prod/Test)
 __ OWNER       M09A      SEQUENCE PRIORITY    CONTINUE SEARCH Y    (Y/N)
 __ DESCRIPTION
 __ DOCMEM      DBBKP1    DOCLIB CTT.PROD.DOC
 __ ===========================================================================
 __ ON DATASET   = BKP.DB*                                         And/Or/Not
 __ ===========================================================================
 __ DO POOL      = DATABASE-BKP
 __ DO RETENTION = DAYS              00060                         And/Or
 __ DO VAULT     = MAINLIB                    BY BOX    (Y/N)
 __      UNTIL     DAYS               0010                         And/Or
 __    VAULT     = VAULT2
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     = VAULT3
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     = VAULT5
 __      UNTIL     VAULT DAYS         0050                         And/Or
 __    VAULT     =
 __ DO SHOUT     = TO OPER              URGENCY  R
 __    MESSAGE   END OF DATABASE BACKUP
FILL IN RULE: DBBKP1 RULE DEFINITION. CMDS: EDIT, SHPF, DOC, SCHED, DOOPT, ONOPT    10.05.15

Example 4

Move a volume specification in the Pool Definition screen, so that the list is alphabetized.

Figure 226 Example - Moving A Volume Specification - Before

Copy 
 --------------- POOL DEPT1-POOL                TABLE  $$POOL  -(TP.S)
 COMMAND ===>                                                    SCROLL===> CRSR
 +---------------------------------------+
 __ POOL NAME   DEPT1-POOL                                  OWNER DP1
 __ DESCRIPTION SCRATCH POOL FOR DEPARTMENT #1
 __ DESCRIPTION
 __ ===========================================================================
 __ VOLUMES     FROM  AP1001    TO  AP1999
 A_             FROM  BP1001    TO  BP1999
 __             FROM  FP1001    TO  FP1999
 __             FROM  GP1001    TO  GP1999
 M_             FROM  DP1001    TO  DP1999
 __             FROM            TO
 ======= >>>>>>>>>>>>>>> END OF POOL DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====









 FILL IN POOL DEFINITION. CMDS: EDIT, SHPF                              10.10.51

The volume specification has been moved.

Figure 227 Example - Moving A Volume Specification - After

Copy 
 --------------- POOL DEPT1-POOL                 TABLE  $$POOL    (TP.S)
 COMMAND ===>                                                    SCROLL===> CRSR
 +-----------------------------------------+
 __ POOL NAME   DEPT1-POOL                                  OWNER DP1
 __ DESCRIPTION SCRATCH POOL FOR DEPARTMENT #1
 __ DESCRIPTION
 __ ===========================================================================
 __ VOLUMES     FROM  AP1001    TO  AP1999
 __             FROM  BP1001    TO  BP1999
 __             FROM  DP1001    TO  DP1999
 __             FROM  FP1001    TO  FP1999
 __             FROM  GP1001    TO  GP1999
 __             FROM            TO
 ======= >>>>>>>>>>>>>>> END OF POOL DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====









 FILL IN POOL DEFINITION. CMDS: EDIT, SHPF                              10.17.25

Example 5

Copy a line in the Pool Definition screen.

Figure 228 Example - Copying A Line - Before

Copy 
 --------------- POOL DEPT1-POOL                TABLE  $$POOL--(TP.S)
 COMMAND ===>                                                    SCROLL===> CRSR
 +----------------------------------------+
 __ POOL NAME   DEPT1-POOL                                  OWNER DP1
 C_ DESCRIPTION **********************************
 A_ DESCRIPTION * SCRATCH POOL FOR DEPARTMENT #1 *
 __ DESCRIPTION
 __ DESCRIPTION
 __ ===========================================================================
 __ VOLUMES     FROM  AP1001    TO  AP1999
 __             FROM  BP1001    TO  BP1999
 __             FROM  DP1001    TO  DP1999
 __             FROM  FP1001    TO  FP1999
 __             FROM  GP1001    TO  GP1999
 __             FROM            TO
 ======= >>>>>>>>>>>>>>> END OF POOL DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====







 FILL IN POOL DEFINITION. CMDS: EDIT, SHPF                              10.18.54

The line has been copied.

Figure 229 Example - Copying A Line - After

Copy 
 --------------- POOL DEPT1-POOL                TABLE  $$POOL   -TP.S)
 COMMAND ===>                                                    SCROLL===> CRSR
 +---------------------------------------+
 __ POOL NAME   DEPT1-POOL                                  OWNER DP1
 __ DESCRIPTION **********************************
 __ DESCRIPTION * SCRATCH POOL FOR DEPARTMENT #1 *
 __ DESCRIPTION **********************************
 __ DESCRIPTION
 __ DESCRIPTION
 __ ===========================================================================
 __ VOLUMES     FROM  AP1001    TO  AP1999
 __             FROM  BP1001    TO  BP1999
 __             FROM  DP1001    TO  DP1999
 __             FROM  FP1001    TO  FP1999
 __             FROM  GP1001    TO  GP1999
 __             FROM            TO
 ======= >>>>>>>>>>>>>>> END OF POOL DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====






 FILL IN POOL DEFINITION. CMDS: EDIT, SHPF                              10.20.08

Example 6

Insert a line in the Vault Definition screen.

Figure 230 Example - Inserting A Line - Before

Copy 
 VLT: VAULT1    LIB CTT.PROD.PARM                                TABLE: $$VAULT
 COMMAND ===>                                                    SCROLL===> CRSR
 +---------------------------------------+
 __ VAULT NAME  VAULT1
 __ LOCAL       N
 __ ===========================================================================
 __ DESC        REMOTE VAULT #1
 __ DESC
 __ OWNER       M89
 __ ADDRESS     LATHAM N.Y., EBERLE RD
 __ ADDRESS
 __ PHONE       (518) 555-9627
 __ SCHEDULE    ONCE A WEEK
 __ SCHEDULE
 __ DOCMEM   DOCVLT1      DOCLIB CTT.PROD.DOC
 __============================= GLOBAL CAPACITY ==============================
 I_ CAPACITY 00000500     TYPE   BOX      MEDIA TAPE         BOX SIZE 000400
 __          00000200     TYPE   SLOT     MEDIA CART
 __          00000200     TYPE   SLOT     MEDIA CART
 __                       TYPE            MEDIA
 ======= >>>>>>>>>>>>>> END OF VAULT DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====


 FILL IN VAULT DEFINITION. CMDS: EDIT, SHPF, DOC                        10.23.19

The line has been inserted.

Figure 231 Example - Inserting A Line - After

Copy 
 VLT: VAULT1    LIB CTT.PROD.PARM                                TABLE: $$VAULT
 COMMAND ===>                                                    SCROLL===> CRSR
 +--------------------------------------+
 __ VAULT NAME  VAULT1
 __ LOCAL       N
 __ ===========================================================================
 __ DESC        REMOTE VAULT #1
 __ DESC
 __ OWNER       M89
 __ ADDRESS     LATHAM N.Y., EBERLE RD
 __ ADDRESS
 __ PHONE       (518) 555-9627
 __ SCHEDULE    ONCE A WEEK
 __ SCHEDULE
 __ DOCMEM   DOCVLT1      DOCLIB CTT.PROD.DOC
 __============================= GLOBAL CAPACITY ==============================
 __ CAPACITY 00000500     TYPE   BOX      MEDIA TAPE         BOX SIZE 000400
 __                       TYPE            MEDIA              BOX SIZE
 __          00000200     TYPE   SLOT     MEDIA CART
 __          00000200     TYPE   SLOT     MEDIA CART
 __                       TYPE            MEDIA
 ======= >>>>>>>>>>>>>> END OF VAULT DEFINITION PARAMETERS <<<<<<<<<<<<<<< =====

 FILL IN VAULT DEFINITION. CMDS: EDIT, SHPF, DOC                        10.23.46