Using the MODIFY command to change Extractor operation

CASWAIT=

specifies the time that the PAS should wait for the CAS to start, both during initial PAS startup and if the CAS terminates while the PAS is executing

The value is from 0 to 9999 minutes. The default value is 10 minutes. If you specify CASWAIT=0, the initialization process does not retry the connection to the CAS. The abbreviation CW can be used in the JCL PARM field.

CPM=

specifies that CPM mode is to be started, stopped, or executed under a different control statement set; xx specifies a new control statement set

The current control statement set, if one is running, is terminated before the new one is executed.

If CPM=STOP is specified, the Extractor terminates the CPM monitoring mode. If the IPM mode is not active when CPM=STOP is specified, the address space is cancelled.

DC=

specifies that the data collectors are to be stopped or started, or that status information about the data collectors should be displayed on the console

If both the CAS and MVS PAS are initialized, you can control whether CMF MONITOR Online is executing by issuing this command. When a MODIFY command is issued with

• DC=STOP, the Extractor continues to function, but CMF MONITOR Online becomes unavailable and the PGDDLAY and CFDATA samplers stop performing their sampling functions
• DC=START, CMF MONITOR Online is initialized and the PGDDLAY and CFDATA samplers, if defined, begin or resume their sampling functions
• DC=CPM, the data collectors initiate in CPM mode
• DC=IPM, the data collectors initiate in IPM mode

To view status information about the data collectors on the console, specify the DC=STATUS attribute.

FLIP=

causes the Extractor to begin writing (flip) to the next available alternate data set for either IPM or CPM mode

If an alternate data set was not defined, the MODIFY command is rejected.

IPM=

specifies that IPM mode is to be started, stopped, or executed under a different control statement set; xx specifies a new control statement set

The current control statement set, if one is running, is terminated before the new one is executed.

If IPM=STOP is specified, the Extractor terminates the IPM monitoring mode.

jobname

name of the Extractor job to receive the MODIFY command; this is the name of MVS PAS PROC

MSGFREE

causes the Extractor message file to be dynamically deallocated and spun off for printing

The message file, defined at the //CMFMSG DD statement, is reallocated immediately after deallocation with no loss of data.

PROFILE

displays system configuration information about the console

This information is also available by using the CONFIG utility option available through CMF MONITOR Online. (For more information about the CONFIG utility, see Using-CMF-MONITOR-Online.)

STATUS

displays information about the console regarding the status of the active submonitors, CPM, and IPM; this information is the same information that you can view through the STATUS Extractor utility in CMF MONITOR Online

When a MODIFY command is issued with

• STATUS displays status information for any active monitors
• STATUS=CPM displays status information for a CPM monitor only
• STATUS=IPM displays status information for an IPM monitor only

(For more information about the STATUS utility, see Using-CMF-MONITOR-Online.)

TZOVRLAP

controls the writing of records with overlapping local times when a backward Daylight Saving time change is detected

• TZOVRLAP=RECORD—writes all records to the specified output files; no SMF data is discarded
• TZOVRLAP=DISCARD—discards all SMF records that would otherwise be written during the hour following detection of the backward time change

XDS=

specifies that the CMF Cross System Data Server (XDS) is to be started, stopped, or executed under a different control statement set

• XDS=xx—causes the PAS to activate XDS using xx as the suffix of a hilevel.BBPARM member CMFXDSxx
• XDS=STOP—causes the PAS to disable XDS