SMFD Control Statement Reference › UPDTX

UPDTX

This control statement provides the ability to change the device name, expiration date, volume serials, or file sequence number for a range of index entries on the SCDS. The actual history file data set attributes are not changed. All entries within the date range specified will be updated with the new information.

Important! We highly recommend that the SCDS be backed up before execution of any UPDTX command, especially with the ALL parameter coded.

Statement Format:

UPDTX

►►─ UPDTX ─┬─ LOW(date time) ──┬─┬─ HIGH(date time) ──┬─ SID(sid) ────────────►
           └─ JLOW(date time) ─┘ └─ JHIGH(date time) ─┘

 ►─┬───────┬─┬─────────────────┬─┬───────────────┬─┬──────────────────┬───────►
   └─ ALL ─┘ └─ UNIT(devname) ─┘ └─ EXPDT(date) ─┘ └─ FILESQ(filesq) ─┘

 ►─┬──────────────────┬─┬─────────────┬─┬──────────────────────────┬─ . ──────►◄
   └─ VOLUME(volser) ─┘ └─ ALTERNATE ─┘ ├─ LSNAME(logstream name) ─┤
                                        └─ SUBNAME(substream name) ┘

Operands and Descriptions:

LOW(date time)

If the ALL parameter is coded, this specifies the exact starting date and time of the first SCDS index entry to be updated. Otherwise, it specifies the exact starting date and time of the only SCDS entry to be updated.

"date" is in Gregorian (mmddyy) format.

"time" is in hour/minute/second format (hhmmss).

HIGH(date time)

If the ALL parameter is coded, this specifies the exact ending date and time of the last SCDS index entry to be updated. Otherwise, it specifies the exact ending date and time of the only SCDS entry to be updated.

"date" is in Gregorian (mmddyy) format.

"time" is in hour/minute/second (hhmmss) format.

SID(sid)

Specifies the SMF ID for the history file index, and defines the origin of the SMF input data.

"sid" is a valid SMF SYSID.

JLOW(date time)

If the ALL parameter is coded, this specifies the exact starting date and time of the first SCDS index entry to be updated. Otherwise, it specifies the exact starting date and time of the only SCDS entry to be updated.

"date" is in Gregorian (mmddyy) format.

"time" is in hour/minute/second format (hhmmss).

JHIGH(date time)

If the ALL parameter is coded, this specifies the exact ending date and time of the last SCDS index entry to be updated. Otherwise, it specifies the exact ending date and time of the only SCDS entry to be updated.

"date" is in Gregorian (mmddyy) format.

"time" is in hour/minute/second (hhmmss) format.

ALL

Indicates that more than one SCDS index entry is to be updated. If this parameter is coded, the LOW/JLOW specification must exactly equal the starting date and time of a SCDS index entry, and the HIGH/JHIGH specification must exactly equal the ending date and time of a SCDS entry. If ALL is not coded, the LOW/JLOW and HIGH/JHIGH operands must exactly equal, respectively, the starting and ending dates and times of a single SCDS index entry.

UNIT(devname)

Specifies the new device name to be used when allocating the history file.

VOLUME(volser)

Specifies the new serial number of the volume on which the indexed data set resides.

EXPDT(date)

Specifies the new Julian date in the form of (cyyddd) when the index entry will expire, where c designates the century (0 is the 20th century and 1 is the 21st century). If the AUTODEL option is enabled, index entries that are expired will be removed from the SCDS file.

See Control Statement Language Rules for a description of two special expiration dates: 099000 and 099366.

FILESQ(filesq)

Specifies the new file sequence number of the indexed data set if it resides on tape. If the data set resides on DASD, the value should be 0.

ALTERNATE

Specifies that the entry to be updated is for the alternate pool index.

LSNAME(logstream name)

Updates entries in the specified logstream. If the name is omitted, the update will be performed on dumps that are not associated with a logstream. The LSNAME and SUBNAME operands are mutually exclusive.

SUBNAME(substream name)

Updates entries in the specified substream. If the name is omitted, the update will be performed on dumps that are not associated with any substream. The LSNAME and SUBNAME operands are mutually exclusive.

Sample UPDTX Statement:

UPDTX    SID(XE44) LOW(040198 010100) HIGH(041898 235800) ALL
         UNIT(3490) ALTERNATE.

UPDTX statement output:

 CA                                              AUDIT TRAIL REPORT                           SMFD       PAGE     1
 CA SMF Director     12.6----                                                         SYSA      27 JUL yyyy  13:39:55
 
   UPDTX    SID(XE44) LOW(040198 010100) HIGH(041898 235800) ALL
            UNIT(3490) ALTERNATE.
 
 CAF3610I  INDEX ENTRY FOR SYSPROG.SF16.MS070698.T1626I15               UPDATED
 CAF3610I  INDEX ENTRY FOR SYSPROG.SF16.MS071098.T1036I15               UPDATED
 CAF3610I  INDEX ENTRY FOR SYSPROG.SF16.MS070798.T1736I57               UPDATED
 CAF3611I  3 INDEX ENTRIES UPDATED
 
 CAF2900I  RUN COMPLETE