Starting data set support

Assume that before starting the data gatherer, you defined six VSAM data sets for data set recording. Issue the following START command to begin the data gatherer:

MODIFY  RMF,START III,MEMBER(08),DS(DEL(RMF.DS05),ADD(RMF.DS06),SWITCH)

You must identify the VSAM data set names to RMF™ through the DATASET option. The data set names must be identical to the names used to define the data sets, otherwise RMF will not recognize them.

Because MEMBER(08) is specified in the START command, RMF generates the member name ERBRMF08 and locates the member (normally found in SYS1.PARMLIB). Assume that ERBRMF08 contains the following DATASET options:

DATASET(START)
DATASET(ADD(RMF.DS01))
DATASET(ADD(RMF.DS02))
DATASET(ADD(RMF.DS03))
DATASET(ADD(RMF.DS04))
DATASET(ADD(RMF.DS05))

The default NOSWITCH at the beginning of this session permits RMF to continue writing on the active data set of the previous session (in this case, RMF.DS05).

Assume the following is true about the data sets at the beginning of this session:

Data sets RMF.DS01 through RMF.DS04 are full
RMF.DS05 is the active data set for this session
RMF.DS06 is an empty data set.

With the DS options specified as parameters on the START session command, you modify the options as follows:

Make a new data set available (ADD(RMF.DS06))
Prevent RMF from writing on the currently active data set (DEL(RMF.DS05))
Switch the recording of data to another data set (SWITCH).

START initiates data set recording, and RMF can use all the data sets listed with the ADD suboption.

As a result, RMF produces the following list of options following the rules of processing session options:

ERB305I  III : PARAMETERS
ERB305I  III : DATASET(WHOLD(7)) -- DEFAULT
ERB305I  III : DATASET(ADD(RMF.DS01)) -- MEMBER
ERB305I  III : DATASET(ADD(RMF.DS02)) -- MEMBER
ERB305I  III : DATASET(ADD(RMF.DS03)) -- MEMBER
ERB305I  III : DATASET(ADD(RMF.DS04)) -- MEMBER
ERB305I  III : DATASET(DEL(RMF.DS05)) -- COMMAND
ERB305I  III : DATASET(ADD(RMF.DS06)) -- COMMAND
ERB305I  III : DATASET(SWITCH) -- COMMAND
ERB305I  III : DATASET(START) -- MEMBER
ERB305I  III : MEMBER(08) -- COMMAND
ERB305I  III : WSTOR(32) -- DEFAULT

For more information, see How RMF processes session options.

RMF.DS06 is now available for data set recording. RMF.DS05 cannot be used for recording during the session. RMF.DS05 can be preallocated at the beginning of a TSO Monitor III reporter session and the data on it displayed and analyzed. For more information, see Transferring Monitor III VSAM data sets to other systems.

SWITCH causes RMF to switch to the next available data set, in this case, RMF.DS06 because it is empty. RMF.DS06 becomes the new active data set for this session. If you did not specify SWITCH in this example, data set recording would switch to an available data set anyway because RMF.DS05, the previously active data set, cannot be used. DATASET(DEL) has removed it from the list of data sets available for data set recording.

Note: If a data set contains the system ID or sysplex ID of another system or sysplex, Monitor III cannot overwrite this data set.