REP Control Statement

Utilities › TMSUDSNB Utility—Apply Batch Updates to DSNB/Control Records › Control Statement Specification › REP Control Statement

REP Control Statement

The REP control statement indicates the new value of an updated field. A Control Record or DSNB is updated only if all VER and REP control statements for the record are correct. The format of the REP control statement is:

1   5

REP keyword=value,...,keyword=value

Control Statement Definition

REP: Is the control statement identifier. Start the identifier in position 1 and follow it by a space.
keyword: Is one of the recognized TMSUDSNB keywords. For a list of recognized TMSUDSNB keywords, see the Programming Guide.
value: Is the new value to be placed in the field that is specified by the keyword. The reserved word $REMOVE$, if used with the PASSWRD keyword, removes the password of a password-protected tape. The value field can contain only the characters A-Z, 0-9, $, # or @. If the value field must contain any special characters or embedded blanks, the field must be enclosed in delimiters. You can use any special characters as a delimiter (for example, 'C01 AC$TMS$Z' or *C01 AC$TMS$Z*). The keyword HEXZEROS can be used to replace a field with binary zeros. For date fields, binary zeros can be loaded using a keyword of ZEROS and the highest allowed value is 2155/366.

Examples:

Example 1 updates Control Record #2. The record ID is verified then USED is changed to 215.
```
PASSWORD=system.password
CTL2
VER RECID=TMSCTL#2
REP USED=215
```
Example 2 connects DSNB 675 to DSNB 680 after NEXT is verified.
```
PASSWORD=system.password
DSNB 675
VER NEXT=0
REP NEXT=680
```
Example 3 suppresses verification and makes the same update as Example 1.
```
PASSWORD=system.password
CTL2 NOVER
REP USED=215
```
Example 4 shows a way for sites that have only a small test TMC/AUDIT used by 1 LPAR and a larger production TMC/AUDIT shared by multiple LPARs. Enable the Unique_RNAME feature to update directly control record 1 (TMSCTL#1) on the TMC/AUDIT used by only a single LPAR.
```
PASSWORD=system.password
CTL1  
VER RECID=TMSCTL#1
REP FLAG1=40
```

Note: If multiple LPARs share the TMC, use TMSXTEND.

More information:

TMSXTEND Utility—Dynamic TMC Extend Process Control Program