CNTL Commands and Menus › Initiate Monitoring › Protection Options › Set Protection Options

Set Protection Options

Set options to override the CA InterTest for CICS default protection rules for modifying main storage, the CSA, and load modules. Remove the protection options to reinstate the default protection rules.

Important! Because the protection options can potentially damage your CICS system if misused, exercise caution in specifying them. These options are password protected unless your site has removed this restriction.

To set or remove protection options follow these steps.

1. Specify function 21, S or R.
2. Specify the program name on the Function Selection Menu, and press Enter.

   The Protection Options screen shown next opens. For detailed instructions, see The Function Selection Menu earlier in this chapter.

CA InterTest MONITORING COMMAND BUILDER  PROTECTION OPTIONS       21
                                                                               
        SET  one or more options to override the default protection rules in:  
                                  PROG=COBDEMO                                
                                                                               
                                                                               
        Bypass storage protection:      From    ________   To       ________  
        Unprotect CSA:                  Offset  ____       Length   ___        
        Unprotect CWA:                  Offset  ____       Length   ___       
        Unprotect main storage area:    Address ________   Length   _____     
        Unprotect load module:          Name    ________                       
        Protect main storage area:      Address ________   Length   _____      
                                                                              
                                                                              
                                                                               
        Limit monitoring to your TERMINAL  '*' or TERMID:          ____       
        user ID (or .ANY) who will execute the program             _____   

Specify the following options on this screen. In the descriptions, the command syntax equivalent for each monitoring option is specified in parentheses.

Bypass storage protection (BYP)—Permits a specified section of program code to modify any area of main storage, issue SVC instructions, or issue BALR, BASSM. or BASR 14,15 or 14,14 instructions.

• Specify the beginning and ending program addresses or program offsets. Specify addresses as six- to eight-hexadecimal digits, and offsets as one- to five-hexadecimal digits.
• If you specify .ANY in the From field and an address or offset in the To field, CA InterTest for CICS suspends monitoring when any BALR, BASSM, or BASR 14,15 or 14,14 instruction passes control to the specified location. Monitoring resumes when the routine executed by the instruction returns control to the next byte after the instruction.
• At a breakpoint, specify * in the From field and leave the To field blank to instruct CA InterTest for CICS to bypass the current instruction.

Unprotect CSA (CSA)—Permits a program to modify areas in the CSA. Specify the offset and the length in hexadecimal.

Unprotect CWA (CWA)— Permits a program to modify areas in the CWA. Specify the offset and the length in hexadecimal.

Unprotect main storage area (LET)—Permits a program to modify a designated area of storage. Specify the beginning address as six to eight hexadecimal digits. Specify the length of the area in hexadecimal.

Unprotect load module (LET)—Permits a program to modify a load module.

Protect main storage area (PRO)—Prevents a program from modifying a designated area of storage not protected by CA InterTest. Specify the beginning address as six to eight hexadecimal digits. Specify the length of the area in hexadecimal.

Limit monitoring (TON)—Specifies that the program be monitored and that the protection options, if specified, take effect only when the program executes at the current terminal (*), a specific terminal (termid), or without a terminal (.NO).