FCQS gate, SEND_QUIESCES function

This function sends a quiesce request to SMSVSAM.

This function consists of a forever loop around a dispatcher wait on a list of event control blocks (ECBs). Work is received from tasks that want to send a quiesce request to SMSVSAM. Such tasks call DFHFCQI with function INITIATE_QUIESCE, which queues the request to DFHFCQS by adding an FC Quiesce Send Element (FCQSE) to the chain anchored in file control static storage and by posting an ECB associated with the chain, also in FC static.

When the ECB is posted, it initiates the CFQS transaction, which runs the code in DFHFCQS. The FCQSEs on the chain are processed, and DFHFCCA is called with function QUIESCE_REQUEST to issue the appropriate type of IDAQUIES macro to SMSVSAM. This operation is asynchronous and SMSVSAM returns the address of an ECB that will be posted when the IDAQUIES completes. The addresses returned by SMSVSAM are saved in the FCQSE.

DFHFCQS then returns to its dispatcher wait for a list of ECBs, the ECB for the chain plus an ECB for each IDAQUIES request. It starts and processes the chain whenever one of these ECBs is posted. The wait also specifies a timeout interval so that IDAQUIES requests that are in an endless loop can be detected. When DFHFCQS starts up, there might be new work on the chain, or a quiesce request has completed, or a quiesce request has timed out, or CICS is stopping. When a quiesce request has completed or timed out, DFHFCQS will resume the initiating task if it is waiting, after issuing appropriate messages and calling global user exit XFCQUIS if active.

Input Parameters

None.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • TIMEOUT_CANCEL_ERROR
  • DISASTER_PERCOLATION
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_FCQSsend_quiesces.html | Timestamp icon Last updated: Monday, 5 June 2017