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

Set Replacement Options

When you specify replacement options for a transaction, the resources are replaced in all its programs. When you specify replacement options for a terminal, the resources are replaced in all programs executing from that terminal.

To set or remove replacement options:

1. Specify function 20, S or R,
2. Specify the program names, transaction codes, or terminal names on the Function Selection Menu, and press Enter.

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

          CA InterTest MONITORING COMMAND BUILDER  REPLACEMENT OPTIONS    
                                                                               
     SET one or more options to replace one CICS resource name with another in:
                                  PROG=COBDEMO                                 
                                                                               
                                                                               
        Replace program name:         ________   with   ________               
        Replace file name:            pfile___   with   tfile___               
        Replace TD queue name:        ____       with   ____                   
        TS selection mask:            ____________________________________    
        TS replacement mask:          ____________________________________    
                                                                              
        Limit monitoring to your terminal  '*'  or TERMID:           ____ 
        user ID (or .ANY) who will execute the program               _____ 

Specify five options on this screen. The equivalent option used in single‑line commands is specified in parentheses on the following option list.

Replace program name (RPC)—Allows a program name to be replaced. Specify the original program name and the new name.

Replace file name (RFC)—Allows a file name to be replaced. Specify the original file name and the new name. The sample screen shown previously specifies that program COBDEMO use file TFILE instead of PFILE.

Replace TD queue name (RTD)—Allows a transient data queue name to be replaced. Specify the original TD queue name and the new name.

TS selection mask; TS replacement mask (RTS)—Allows a temporary storage ID to be replaced. Specify the original temporary storage ID in the TS selection mask field, and the new temporary storage ID in the TS replacement mask field. Specify both masks as eight bytes in either character (C'data') or hexadecimal (X'data') format. In the following example, STORAGE2 replaces STORAGE1 in all temporary storage requests issued by the program.

TS selection mask: C'STORAGE1'
TS replacement mask: C'STORAGE2'

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

When you have specified the necessary information, press Enter.