SMFD Control Statement Reference › TAPEINIT

TAPEINIT

This control statement forces CA SMF Director to use a new magnetic tape volume the next time an SMF history file needs to be created. When using a tape device, this product writes multiple files to a single tape volume until the end of the volume has been reached, unless this control statement has been issued. TAPEINIT is useful when a tape volume becomes damaged, or a new volume is desired for some other reason.

TAPEINIT must be used if you are migrating from tape to DASD history files.

Note: If a configuration has streams defined that have active tapes being used for dumping, the TAPEINIT process will force all streams to begin using new tapes.

Statement Format:

TAPEINIT

►►─ TAPEINIT ─ SID(sid) ─┬─────────────┬─┬───────────────────────────┬─ . ─►◄
                         ├─ PRIMARY ◄ ─┤ ├─ LSNAME( ─┬─ lsname ─┬─ ) ┤
                         └─ ALTERNATE ─┘ │           └─ NONE ───┘    │
                                         └─ SUBNAME( ─┬ subname ─┬ ) ┘
                                                      └ NONE ────┘

Operands and Descriptions:

SID(SID)

Specifies the SMF ID for the system configuration to be used in processing the TAPEINIT control statements.

PRIMARY

Identifies that the history tape to be changed is for the primary pool. The default is primary.

ALTERNATE

Identifies that the history tape to be changed is for the alternate pool.

LSNAME(lsname|NONE)

Forces an end-of-volume on a tape being used for dumping the specified logstream. All other tapes remain valid. If NONE is coded, only the MAN file archive tape and substream tapes are to be reset. All other tapes remain valid. LSNAME and SUBNAME are mutually exclusive unless both are NONE.

SUBNAME(subname|NONE)

Forces an end-of-volume on a tape being used for dumping the specified substream. All other tapes remain valid. If NONE is coded, only the MAN file archive tape and logstream tapes are to be reset. All other tapes remain valid. LSNAME and SUBNAME are mutually exclusive unless both are NONE.

Sample TAPEINIT Statement:

TAPEINIT SID(XE44) PRIMARY.

TAPEINIT statement output:

 CA                                              AUDIT TRAIL REPORT                           SMFD       PAGE     1
 CA SMF Director     12.6                                                             SYSA      01 JUL yyyy  12:37:35
 
   TAPEINIT SID(XE44) PRIMARY  .
 
 CAF0801I  PRIMARY  POOL VOLUME 201731 FOR SID(XE44) MARKED COMPLETE - NEW TAPE REQUESTED
 
 CAF2901I  RUN COMPLETE, HIGHEST CONDITION CODE WAS 0