Editing CMEM Rule Definitions in the Edit Environment

This appendix discusses

CMEM rule 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 Rule Definition screen is accessed by typing EDIT in the COMMAND field and pressing Enter.

Figure 403 The Edit Environment in The Rule Definition Screen

Copy 
RL: JOBNAM1    LIB CTM.PROD.RULES                       TABLE: CMEMRULE
COMMAND ===>                                            SCROLL===> CRSR
+---------------------------------------------------------------------+
__ ON JOBARRIV = JOBNAM1  JTYPE   SMFID      SYSTEM          And/Or/Not
__ OWNER CTMCTLM  GROUP                      MODE PROD    RUNTSEC NONE 
__ DESCRIPTION CONVERSION: ON JOB JOBNAM1  ARRIVAL FORCEJOB            
__ DESCRIPTION                                                         
__ ====================================================================
__ DO FORCEJOB = TABLE  TABLE1   JOB            UFLOW N    DATE ODAT   
__               LIBRARY CTM.PROD.SCHEDULE                             
__ DO                                                                  
__ ====================================================================
======= >>>>>>>>>>> END OF RULE DEFINITION PARAMETERS <<<<<<<<<<< =====
                                                                       
                                                                       
 FILL IN RULE DEFINITION. CMDS: CAPS, EDIT, SHPF,              20.10.46

A 2-character Line Editing command field, marked by underscores, is displayed for each line on the Rule Definition 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.

The Line Editing commands you enter are processed when Enter is pressed.

The CMEM facility performs Automatic Syntax Checking to ensure that the rule definition is still syntactically correct after editing. If an edit may invalidate the rule definition, a message is displayed at the top of the screen and the edit is not performed. For guidelines and recommendations for editing rule definitions, see Maintaining Valid Rule Definitions.

All operations available in the Rule Definition screen can be performed while in the Edit environment. For example, parameter values can be changed, and the Rule Definition screen can be saved and 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 any single ON or DO statement or on a block of ON or DO statements.

All lines of a single statement, for example, the two lines of a DO FORCEJOB statement, constitute a logical line.

Line Editing Commands (CMEM)

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

Table 311 CMEM 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 determines whether to delete a single or logical line based on the line type.

Table 312 CMEM 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 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 313 CMEM 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 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 in Table 316 below.

Table 314 CMEM 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 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 315 CMEM 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 316 CMEM Line Editing Commands: Location Commands

Command

Description

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

A (After)

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

B (Before)

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

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

Maintaining Valid Rule Definitions

Since rule definitions must be syntactically correct at all times, you must 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 function as 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 must be specified on the main lines of the block. For example, to delete an ON block, specify command DB (Delete Block) on the ON line.

  • Blank parameter lines added automatically by CMEM, to allow the user to specify additional parameters, cannot be deleted.

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

Example of Repeating a DO Block

Before: Repeat a DO block in the Rule Definition screen.

Figure 404 Example: Repeating A DO Block - Before

Copy 
RL: JOBNAM1    LIB CTM.PROD.RULES                       TABLE: CMEMRULE
COMMAND ===>                                            SCROLL===> CRSR
+---------------------------------------------------------------------+
__ ON JOBARRIV = JOBNAM1  JTYPE   SMFID      SYSTEM          And/Or/Not
__ OWNER CTMCTLM  GROUP                      MODE PROD   RUNTSEC NONE  
__ DESCRIPTION CONVERSION: ON JOB JOBNAM1  ARRIVAL FORCEJOB            
__ DESCRIPTION                                                         
__ ====================================================================
R_ DO FORCEJOB = TABLE  TABLE1   JOB            UFLOW N    DATE ODAT
__               LIBRARY CTM.PROD.SCHEDULE                            
__ DO                                                                 
__ ====================================================================
======= >>>>>>>>>>> END OF RULE DEFINITION PARAMETERS <<<<<<<<<< =====
                                                                       
                                                                      
 FILL IN RULE DEFINITION. CMDS: CAPS, EDIT, SHPF,              20.10.46

After: The DO block has been repeated.

Figure 405 Example: Repeating A DO Block - After

Copy 
RL: JOBNAM1    LIB CTM.PROD.RULES                       TABLE: CMEMRULE
COMMAND ===>                                            SCROLL===> CRSR
+---------------------------------------------------------------------+
__ ON JOBARRIV = JOBNAM1  JTYPE   SMFID      SYSTEM          And/Or/Not
__ OWNER CTMCTLM  GROUP                      MODE PROD    RUNTSEC NONE
__ DESCRIPTION CONVERSION: ON JOB JOBNAM1  ARRIVAL FORCEJOB            
__ DESCRIPTION                                                         
__ ====================================================================
__ DO FORCEJOB = TABLE  TABLE1   JOB            UFLOW N    DATE ODAT
__               LIBRARY CTM.PROD.SCHEDULE                             
__ DO FORCEJOB = TABLE  TABLE1   JOB            UFLOW N    DATE ODAT
__               LIBRARY CTM.PROD.SCHEDULE                             
__ DO                                                                  
__ ====================================================================
======= >>>>>>>>>> END OF RULE DEFINITION PARAMETERS <<<<<<<<<<< =====
                                                                      
 FILL IN RULE DEFINITION. CMDS: CAPS, EDIT, SHPF,             20.32.47