SWITCH STREAM command

From m204wiki
Revision as of 23:23, 12 May 2015 by JAL (talk | contribs) (misc formatting)
Jump to navigation Jump to search

Summary

Privileges
System manager
Function
You can switch streams — parallel, ring, concatenated, GDG — to the next member at any time.

Syntax

SWITCH STREAM streamname [ RESET ]

Where:

streamname CCAJRNL, CCAJLOG, CHKPOINT, or CHKPNTS. The command is valid only for these streams.
RESET This optional parameter causes any disabled parallel GDG members to be reopened during the switch.

Valid only for a CCAJLOG stream specified as a Parallel GDG.

Usage notes

  • If you specify:
    • Journal stream CCAJRNL or CCAJLOG: the currently active data set is closed and the next data set defined to the stream is opened.
    • Checkpoint stream CHKPOINT or CHKPNTS: the currently active data set in the stream is closed after the next record is written to the data set.
  • If a SWITCH STREAM CCAJRNL command is issued during CHECKPOINT EXTENDED QUIESCE command processing, the journal is switched, a new checkpoint is issued, and the duration of the extended quiesce time-out set in CPQZSECS is reset to its maximum, original value (disregarding the already-elapsed time).