Switching the active data set

Use the SWITCH command to switch the recording data set for the persistent data store to the next available data set.

Important: The content in this section was created for and applies to persistent data store V2 (PDS V2).

To switch the currently active data set to the next available data set, enter the following MODIFY command:

F stcname,KPQ SWITCH APPL=application

where:

stcname is the started task name of the address space where the persistent data store is running.
application is the code of the component (for example, KC5 for OMEGAMON for CICS).

The command output is written to RKLVLOG. After the switch occurs, details about the status of each data set in the persistent data store is also written to the log. To review this information, locate messages KLVOP191, KPQH017I, KPQH021I, and KPQH022I.

Tip: You can review the status of each data set in the persistent data store at any time using the QUERY DATASTORE command. For more information, see Displaying PDS V2 data set information.

Tip: If there is a delay when writing records to RKLVLOG, you can use the following command to see the output immediately:

F stcname,FLUSH RKLVLOG

Example

Command entered:

F TEMSSTC,KPQ SWITCH APPL=application

Sample output:

KLVOP191    'KPQ SWITCH APPL=KM5'                                                       
KPQH017I KPQHSMGR: SWITCH SUCCESSFUL FOR KM5, WRITING TO TDUSER.TS1234.PDSPRSB1.HM520007
KPQH021I KPQHSMGR: KM5 PDSV2 STORE STATE: ACTIVE DATASETS = 6                           
KPQH022I KPQHSMGR: HM520001: DD=HM500001, SN= 1, ACTIVE=N, EMPTY=N, IGNORED=N, ECR=N    
KPQH022I KPQHSMGR: HM520001: START=22-01-12 14:28:31.333, SPAN=      0s                 
KPQH022I KPQHSMGR: HM520001: REC=      0, SPACE=4096/143769600, EXT=0                   
KPQH022I KPQHSMGR: HM520002: DD=HM500002, SN= 2, ACTIVE=N, EMPTY=N, IGNORED=N, ECR=N    
KPQH022I KPQHSMGR: HM520002: START=22-01-14 14:11:20.474, SPAN=      0s                 
KPQH022I KPQHSMGR: HM520002: REC=      0, SPACE=4096/143769600, EXT=0                   
KPQH022I KPQHSMGR: HM520004: DD=HM500004, SN= 4, ACTIVE=N, EMPTY=N, IGNORED=N, ECR=N    
KPQH022I KPQHSMGR: HM520004: START=22-01-14 14:54:52.260, SPAN=      0s                 
KPQH022I KPQHSMGR: HM520004: REC=      0, SPACE=4096/143769600, EXT=0                   
KPQH022I KPQHSMGR: HM520005: DD=HM500005, SN= 5, ACTIVE=N, EMPTY=N, IGNORED=N, ECR=N    
KPQH022I KPQHSMGR: HM520005: START=22-01-18 11:17:01.537, SPAN=      0s                 
KPQH022I KPQHSMGR: HM520005: REC=      0, SPACE=4096/143769600, EXT=0                   
KPQH022I KPQHSMGR: HM520007: DD=HM500007, SN= 7, ACTIVE=Y, EMPTY=N, IGNORED=N, ECR=N    
KPQH022I KPQHSMGR: HM520007: START=22-01-19 15:20:52.414, SPAN=      0s                 
KPQH022I KPQHSMGR: HM520007: REC=      0, SPACE=4096/143769600, EXT=0                   
KPQH022I KPQHSMGR: HM520006: DD=HM500009, SN= 6, ACTIVE=N, EMPTY=Y, IGNORED=N, ECR=N    
KPQH022I KPQHSMGR: HM520006: START=                  N/A, SPAN=      0s                 
KPQH022I KPQHSMGR: HM520006: REC=      0, SPACE=4096/143769600, EXT=0