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


dfhs3_FCCAquiesce_request.html | Timestamp icon Last updated: Monday, 5 June 2017