FCCA gate, QUIESCE_REQUEST function
This function issues a record-level sharing (RLS) quiesce request.
DFHFCCA issues quiesce requests to SMSVSAM
on behalf of the quiesce component of CICS®;
it issues IDAQUIES calls of the following types:
- QUICLOSE to request SMSVSAM to notify all CICS systems that have ACBs open against this data set that these ACBs are to be closed. In addition, the data set is marked in the VSAM catalog as being quiesced after these ACBs have been closed.
- QUIOPEN to request SMSVSAM to mark the data set as no longer quiesced; that is, it is unquiesced. In addition, QUIOPEN will cancel a QUICLOSE that is in progress.
- QUIBEND to request SMSVSAM to cancel a BWO backup of a data set that is in progress.
- QUICEND to request SMSVSAM to cancel a non-BWO backup of a data set that is in progress.
Input Parameters
- DATASET
- The 44-character name of the base data set to be quiesced.
- IMMEDIATE
- Optional Parameter
- This parameter applies only when the QUIESCE_TYPE parameter
is set to QUIESCE. This parameter indicates whether
the quiesce will force files to close immediately, or will allow inflight
units of work to reach sync point. Values for the parameter are:
- YES
- NO
- QUIESCE_TYPE
- The type of quiesce. Values for the parameter are:
- QUIESCE
- UNQUIESCE
- NONBWO_END
- BWO_END
Output Parameters
- ACCMETH_RETURN_CODE
- A 2-byte code returned by SMSVSAM.
- CHECK_TOKEN
- A token that will be used on the CHECK request.
- CONFLICTING_QUIESCE
- Indicates the type of quiesce that conflicts with
this request. Values for the parameter are:
- QUIESCE
- UNQUIESCE
- NONBWO_END
- BWO_END
- NONBWO_START
- BWO_START
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- VSAM_REQUEST_ERROR
- RLS_FAILURE
- The following value is returned when RESPONSE is DISASTER:
- ABEND
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- Values for the parameter are:
- OK
- EXCEPTION
- DISASTER
- INVALID
- KERNERROR
- PURGED