Facility state cleanup processing — TSQ

Stabilized feature: Service Flow Runtime and Service Flow Modeler capability in IBM Developer for z/OS 14.2.3 are stabilized. Consider exposing and orchestrating applications as API services by using z/OS Connect Enterprise Edition or CICS® web services, or by writing web applications in Java or Node.js. See also Stabilization notices and discontinued functions.

If you are running simple, nonpersistent Link3270 service flows, facility state cleanup processing runs against temporary storage queues (TSQ) and is handled by the CICS Service Flow Runtime Facility State Cleanup (TSQ) program (DFHMALSC).

DFHMALSC browses Link3270 facility state temporary storage (TS) queues and initiates the processing to delete the expired CICS Service Flow Runtime Link3270 facility session state data. It invokes the processing to deallocate the associated Link3270 bridge facilities that CICS has not automatically deleted because the facility was inactive for the keeptime interval. See Developing for external interfaces for more information on the keeptime interval processing by CICS.

Processing is as follows:
  1. DFHMALSC browses the Link3270 facility state temporary storage (TS) queue.
    The TS queue names are 16 bytes long and of the following format: 
    TSQ name = "DFHMA"  +  facility token (8 byte hex value) +  x'FFFFFF' (3 byte hex value = HIGH-VALUES).
  2. If the following conditions are true, DFHMALSC calls the Link3270 Facility Deallocate Cleanup program, DFHMALFD:
    • A matching TS queue is found and not in use.

      The CICS Service Flow Runtime facility session state expiration time is checked to see if it has been exceeded.

    • The expiration time of the facility session state has been exceeded.

      The existence of the Link3270 bridge facility is checked and is not in a RELEASED state.

  3. If the Link3270 bridge facility has been deleted, the TS queue containing CICS Service Flow Runtime facility session state data is deleted and the browse of the TS queues is resumed. When the 'END' condition is encountered on the browse, this cleanup task is scheduled to be started at the requested SI interval. See Configuring the autostart procedure for the Link3270 facility state cleanup programs for information on setting the SI interval.
  4. The Link3270 Facility Deallocate Cleanup program deallocates existing bridge facilities and deletes the associated facility session state data whether that data is stored in a TS queue or a VSAM data set.