Business state data management in persistent service flows
For both persistent and nonpersistent complex service flows and for simple persistent service flows, CICS SFR stores, retrieves, and deletes Link3270 server adapter business state data in a CICS® VSAM file, DFHMAL2F.
The VSAM file is used to manage the business state data of facilities and ownership of facilities left allocated by service flow processing. Normally, this file stores the last bridge vector received (maximum 32 000 bytes ADS, text, or 3270 datastream data) from the defined target CICS application transaction as modeled in the service flow. The vector data is used in subsequent Link3270 server adapter processing to determine the allocated facility business state; for example, the last CICS transaction run, the last BMS SEND MAP application data structure (ADS), the last BMS mapset and map names.
- The first VSAM record contains the Link3270 facility business state information used in Link3270 server adapter processing.
- A second VSAM record contains any Link3270 facility business state text
information used in Link3270 server adapter processing as the result of a BMS
SEND TEXT command or SEND command containing
textual information.
In this record, the key field LS-KEY-FILLER contains a value of 'TEXT".
- Allocated facility business state information for that facility owner
- Allocated Link3270 bridge facility token
- The service name that is defined in the service flow properties file.
The facility and its associated business state is available for subsequent use by the owner of that facility in another task. The owner is the signed-on user ID to the local CICS region, as determined by an EXEC CICS ASSIGN command.
When Link3270 server adapter processing is complete, if the Link3270 bridge facility is left allocated with its associated facility business state data stored in the facility business state file (DFHMAL2F), the Link3270 facility state token is returned to the service requester in the reply message for use in subsequent request processing if required. See DFHMAH header structure for further information on the meaning and use of DFHMAH header structure field, DFHMAH-STATETOKEN.
If a Link3270 facility state token is left blank in the request message and a Link3270 server adapter is invoked, a new Link3270 facility is allocated and used in Link3270 server adapter processing.
In addition, Link3270 facilities and their associated business state data might be deallocated and deleted, respectively, by the system cleanup tasks. See Facility state cleanup processing for a description of how CICS SFR cleans up the facility business state VSAM file.
Also, as a normal end-of-day processing strategy, the service requester might invoke a modeled flow to locate any allocated facility, deallocate the facility, and delete its associated facility business state data. This flow must run for each allocated Link3270 facility state token by each service requester invoking service flows.