Closing or Swapping the Journal Data set

To close the Xchange journal data set, you must do one of the following:

• Shut down the Xchange subsystem
• Close or swap the journal data set

Shut down the Xchange subsystem using the SHUTDOWN command as described in Terminating-Xchange.

Close or swap the journal from the operator console. If you are an Xchange administrator, you can also close or swap the journal from the batch facility. For information on designating Xchange administrators, see Task-8-3-5-Designating-Xchange-administrators.

Every time an Xchange journal data set is closed, the following message is displayed in the Xchange log:

XG0012 ssss LOG xxxxxxxx CLOSED

Automated recognition software could be instructed to recognize this message and submit job UNLDLOG located in library CPWR.MLXGnnn.SLXGCNTL to capture the data set to a pre-defined GDG. To review this data at a later date, submit job RELDLOG located in library CPWR.MLXGnnn.SLXGCNTL to restore a GDG to a test journal file. The contents of this file can be viewed using several methods. For information on each method, see the sections later in this section, beginning with Online-Journal-Facility.

Closing or Swapping From the Operator Console

To close or swap the journal data set from the operator console, type the CLOSE or SWAPLOG command on the console in the following format

R nn,command

Replace nn with the message sequence number and replace command with CLOSE or SWAPLOG. To open the next journal data set, replace command with OPEN.

The CLOSE command closes and deallocates the current journal data set but does not open the next journal data set. No records are written until you enter the OPEN command. You can abbreviate the CLOSE command as C, CL, CLO, or CLOS.

The OPEN command allocates and opens the next journal data set. It is valid only following the successful completion of the CLOSE command. You can abbreviate the OPEN command as O, OP, or OPE.

The SWAPLOG command closes and deallocates the current journal data set and allocates and opens the next journal data set. You can abbreviate the SWAPLOG command as SW, SWA, SWAP, SWAPL, or SWAPLO.

You can also specify commands with the MVS MODIFY (F) command in the following format:

F jobname,command

where jobname is the name of the Xchange job, and command is CLOSE, OPEN, or SWAPLOG.

Closing or Swapping From the Batch Facility

If you are an Xchange administrator, you can enter the CLOSE, OPEN, and SWAPLOG commands from the batch facility, and they will be processed as if they were entered by the console operator. Invoke the batch facility with the JCL shown in the following figure:

Closing or Swapping JCL

Replace CPWR with the high-level qualifier chosen for your site. You must also provide information for the request variable, according to the syntax SUBSYS=ssid,OPCMD=command where ssid is a four-character subsystem ID and command is CLOSE, OPEN, or SWAPLOG.