SMFD Control Statement Reference › DELETEX

DELETEX

This control statement removes entries from the index of SMF data that is maintained on the SCDS. DELETEX is useful for removing old or duplicate entries for overlapping data. See the Systems Programmer Guide for more details.

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

Statement Format:

DELETEX

►►─ DELETEX ─ SID(sid) ─ LOW(date time) ─ HIGH(date time) ────────────────────►

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

Operands and Descriptions:

SID(sid)

Specifies the SMF ID for the history-file index. This is the 4-character identifier that appears in the SMF data.

LOW(date time)

Specifies the date and time of the first SMF record in the entry being deleted from the data set index.

"date" - Gregorian (mmddyy) format.

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

HIGH(date time)

Specifies the date and time of the last SMF record in the entry being deleted from the data set index. "date" is in Gregorian (mmddyy) format. "time" is in hour/minute/second format (hhmmss).

ALTERNATE

Specifies that the index being deleted is the alternate history index for this SID. If not specified, the primary index is deleted.

ALL

Deletes all index entries within the date and time range specified on the LOW and HIGH operands. The LOW and HIGH operands must exactly equal, respectively, the low date/timestamp of a SCDS entry and the high date/timestamp of a SCDS entry; otherwise, nothing will be deleted. If ALL is not coded, the LOW and HIGH operands must exactly equal, respectively, the low and high timestamps of a single SCDS entry in order for that entry to be deleted.

LSNAME(logstream name)

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

SUBNAME(substream name)

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

Sample DELETEX Statement:

DELETEX SID(XE44) LOW(042998 103019) HIGH(042998 104444)
  ALTERNATE .

DELETEX statement output:

  CA                                              AUDIT TRAIL REPORT                         SMFD       PAGE     1
 CA SMF Director     12.6                                                            SYSA      23 JUL yyyy  15:42:00
 
    DELETEX SID(XE44) LOW(042998 103019) HIGH(042998 104444)
      ALTERNATE .
 
  CAF3602I  DATASET INDEX UPDATE PERFORMED
 
  CAF2900I  RUN COMPLETE