XSET (XRC session parameters)

Use request type XSET to set XRC session parameters. This invokes ANTRQST ILK=XRC REQUEST=XSET.

SID(session)

Specifies the name of the XRC session to which the request is sent. It is required.

DVCBLOCK(ON | WPn | OFF)

Specifies whether device blocking or write pacing is enabled or disabled.

Start of change Workload-based write pacing affects the behavior of DVCBLOCK. For more information, refer to Workload-based write pacing. End of change

ON: Device blocking is enabled. This is the default.
When workload-based write pacing is in use, XRC automatically converts DVCBLOCK(ON) to DVCBLOCK(WPn), where n is the discretionary level, 6.
OFF: Both device blocking and write pacing are disabled
WPn: Specifies that write pacing is to be activated for the specified volume(s), with n specifying the level of write pacing delay, 0-F. WP0 specifies that the session default level will be used, as specified in the SHADOW DfltWritePacingLvl PARMLIB value. For values ranging from WP1-WPF, please refer to the ANTRQST macro.

PVOLSER(ALLB | ALL | ALLDP | ALLP | volser)

When specifying the DVCBLOCK, this optional input field specifies the name of the primary volume serial of a volume that is to have its device blocking or write pacing status changed.

ALLB: All primary volumes set to DVCBLOCK=ON are to be changed. This is the default.
ALL: All primary volumes are to be changed
ALLDP: All primary volumes set to write pacing level WP0 are to be changed
ALLP: All primary volumes set to write pacing level WP1-WPF are to be changed
volser: MVS volume serial number for the volume to be processed according to the value specified in the DVCBLOCK parameter

REFRESHP(NO | YES)

Specifies whether the system data mover should examine the capabilities of the specified primary storage control(s) and update the data mover's internal control information. REFRESHP is mutually exclusive with SUSLBUSY and TIMEOUT.

NO: System data mover control information remains unchanged. This is the default.
YES: System data mover should examine the capabilities and update the data mover's internal control information

SSID may be specified with REFRESHP to identify the primary storage control(s) to be examined. If it is omitted, all primary storage controls associated will be examined.

COPY(FUL | QIK)

Specifies what type of volume initialization should be used to copy a primary volume to a secondary volume.

FUL: Full initial copy. This is the default.
QIK: Quick initial copy

PAGEFIX(8 | pagefix)

Specifies the number of megabytes assigned to the data mover as permanently page-fixed real storage. 8MB is the default.

PMEMBER(parmlib-member)

Contains a PARMLIB member name.

PDSNAME(pds-name)

Contains the name of a partitioned data set that contains PMEMBER (up to 44 characters).

PACTION(V | A)

Indicates whether the PARMLIB member is to be verified or verified and then applied.

V: Verify the PARMLIB member. This is the default.
A: Verify the PARMLIB member, and, if no errors are found, apply it

PRIORITY(LOAD | FIFO)

Indicates how the next volume to be synchronized or resynchronized will be selected.

LOAD: the next volume is based on which controller has the least load. This is the default.
FIFO: The next volume is based on the order of the XADDPAIR commands

RFREQUENCY(00.00.00 | hh.mm.ss)

Specifies how often the software bitmap is toggled. The format is HH.MM.SS. 00:00:00 specifies that time-controlled toggling is deactivated. This is the default.

RTRACKS(7500 | rtracks)

Specifies how many tracks have changed before the software bitmap is toggled. To deactivate track-controlled toggling, specify 0. Valid values are 0–99999. The default is 7500.

SCSYNCHP(2 | sc-synchp)

Specifies the maximum number of concurrent synchronization or resynchronization tasks allowed per primary storage controller. Valid values are 0–45. The default is 2.

SCSYNCHS(sc-synchs)

Specifies the maximum number of concurrent synchronization or resynchronization tasks allowed per secondary storage controller. Valid values are 0–45. The default is 2.

SSID(ALL | ssid)

Specifies the storage controls that are to be processed by the XSET TIMEOUT, REFRESHP or SUSLBUSY command. ALL indicates all storage controls are to be processed.

SUSLBUSY(NO | YES)

Enables or disables the Suspend on Long Busy function. SUSLBUSY is mutually exclusive with REFRESHP and TIMEOUT.

NO: Suspend on Long Busy is disabled. This is the default.
YES: Suspend on Long Busy is enabled. If associated SSID(s) are specified, the change will be made to just those SSID(s). If they are not specified then this will become the storage default.

SYNCH(4 | synch)

Specifies the maximum number of concurrent synchronization or resynchronization tasks allowed per session. Valid values are 0–45. The default is 4.

TIMEOUT(hh.mm.ss)

Specifies the primary control timeout value. The format is HH.MM.SS. The storage control default is usually 00.05.00. The value can range from a minimum of one second (00.00.01) to a maximum of 18 hours (18.00.00) TIMEOUT is mutually exclusive with SUSLBUSY and REFRESHP.

UTILITY(FLT | FIX)

Indicates what type of utility device support should be enabled when an ADDPAIR is done with a secondary volume of XRCUTL.

FLT: Floating utility device support. This is the default.
FIX: Fixed utility device support

MESSAGES(msg)

Specifies a variable in which ANTRQST will place the address of a buffer containing messages about the results of the processed request. These are messages that would have been returned to the caller if the TSO interface had been used. Refer to the ANTRQST macro for the format of the buffer.

WAITTIME(waittime | 0)

Contains a number of seconds that SDM must wait for a request to complete. A value of zero specifies that the request should not be timed. Valid values are 0 through 65535. The default is 0.