The following table lists all of the programs and describes the processing performed by each.
Name | Program name | CICS® Tran ID | Description | Comments |
---|---|---|---|---|
CICS Service Flow Runtime XML Header to COBOL Converter |
DFHMAXMI |
This program is called by the DPL Stub programs (DFHMADPL or DFHMADPP) when the request message header is in XML format. The CICS Service Flow Runtime XML Header to COBOL Converter program converts the XML into COBOL data structure so that it can be processed by the CICS Service Flow Runtime. |
For a description of how this program is called, see XML request and response processing |
|
CICS Service Flow Runtime COBOL to XML converter |
DFHMAXMO |
This program is called by the DPL stub programs (DFHMADPL or DFHMADPP) when the service requestor expects that the response to it's request should be in XML format. The CICS Service Flow Runtime COBOL to XML Converter program converts the COBOL data structure into XML so that it can be processed by the service requestor. |
For a description of how this program is called, see XML request and response processing |
|
CICS Service Flow Runtime ADS to XML converter |
DFHMAXPI |
DFHMAXPI is called by the Passthrough DPL Stub program (DFHMADPP). DFHMAXPI parses the inbound XML passthrough request message (the portion of the XML request message following the header structures, DFHMAH and DFHMAH2) and returns the passthrough application data in fixed format to the calling system program. DFHMAXPI also builds the outbound XML passthrough application reply message using any passthrough application reply data passed to it from the calling system program. |
For a description of passthrough processing of an XML request, seeXML request and response processing for passthrough |
|
CICS Service Flow Runtime DPL Stub | DFHMADPL |
This program defines and runs the BTS process that implements an instance of the Adapter service. The DPL Stub program also invokes the programs to support XML messaging (parsing and conversion) from the service requestor for non-passthrough requests. |
Runs under the Transaction ID of the invoking program. An interface between the service requestor and CICS is used to pass a communications area to the DPL Stub program. |
|
CICS Service Flow Runtime DPL Passthrough Stub | DFHMADPP |
This program must be used when processing in passthrough mode. This program defines and runs the BTS process that implements an instance of passthrough processing. The DPL Passthrough Stub program also invokes the programs to support XML messaging (parsing and conversion) from the service requestor for passthrough requests. |
CICS Service Flow Runtime DPL Passthrough Stub runs under the transaction ID of the invoking program. An interface between the service requestor and CICS is used to pass a communications area to the DPL Passthrough Stub program. If the DFHMAH-UOWCONTROL field in the DFHMAH message header is set to 3 for passthrough processing, DFHMADPP must be the stub program name passed through the interface when invoking the CICS Service Flow Runtime. If DFHMAH-UOWCONTROL is set to 3, and the Stub program name is DFHMADPL, the runtime returns an error to the service requestor. |
|
CICS Service Flow Runtime Navigation Manager |
DFHMAMGR |
CMAM |
The functions performed by the Navigation Manager program depend on the deployment pattern of the Adapter service.
|
Runs as DFHROOT in all BTS processes. See Deployment patterns for a description of the different processing patterns supported by the CICS Service Flow Runtime. |
CICS Service Flow Runtime Navigator | User defined |
User defined |
Child to the Navigation Manager and parent to the server adapters. Navigators perform request processing, manage states during the service flow processing and invoke server adapters. |
The Navigator program that is generated is based upon the Adapter service that was modeled and generated using the Service Flow Modeler |
CICS Service Flow Runtime Error Listener (WebSphere MQSeries®) |
DFHMAERR |
CMAE |
This program monitors the defined WebSphere MQSeries error queue (CIA.SYSTEM.ERROR.QUEUE). When the Error Listener program is triggered, it reads from the error queue and writes the error to the CICS Service Flow Runtime Error file (DFHMAERF). |
Error handling by the CICS Service Flow Runtime is configurable. See Error processing for explanations of how errors are handled at run time. |
CICS Service Flow Runtime Error Listener (CICS intrapartition transient data queue (TDQ)) |
DFHMAERQ |
CMAQ |
This program monitors the defined CICS intrapartition transient data queue (CMAQ) for errors. When the Error Listener program is triggered, it reads from the error queue and writes the error to the CICS Service Flow Runtime Error file (DFHMAERF). |
Error handling by the CICS Service Flow Runtime is configurable. See Error processing for explanations of how errors are handled at run time. |
CICS Service Flow Runtime Link3270 Facility State Cleanup (Temporary storage queues (TSQ)) |
DFHMALSC |
CMAK |
The CICS Service Flow Runtime State Cleanup program (TSQ) browses the Link3270 facility state temporary storage (TS) queues and deletes expired Link3270 facility session state data and de-allocates associated Link3270 bridge facilities that CICS has not automatically deleted due to the facility being inactive for the keeptime interval. |
The CICS Service Flow Runtime Facility State Cleanup is used for Link3270 Adapter services that are simple and nonpersistent. You can configure the CICS Service Flow Runtime so that this program is started automatically on CICS system initialization. For information, see Configuring the autostart procedure for the Link3270 facility state cleanup programs. This program performs a CICS enqueue on a resource that specifies a variable equal to the 16 byte Link3270 facility state TSQ QNAME. For a description of facility state cleanup processing on TSQs, see Facility state cleanup processing — TSQ |
CICS Service Flow Runtime Link3270 Facility State Management (Temporary storage queues (TSQ)) |
DFHMALTS |
The CICS Service Flow Runtime State Management (TSQ) is responsible for saving, retrieving and deleting state information from theCICS Service Flow Runtime Link3270 State TSQ for Link3270 Adapter services of the Single connector, nonpersistent type. |
This is a called subprogram. It runs under the transaction ID of the generated Link3270 server adapter if performing adapter services or the transaction ID of the Link3270 Passthrough Manager (DFHMALPT) transaction ID (CMAL) if performing passthrough processing. This program performs a CICS enqueue on a resource that specifies a variable equal to the 16 byte Link3270 facility state TSQ QNAME. See Business state data management in single connector (nonpersistent patterns) for further information. |
|
CICS Service Flow Runtime Link3270 Facility State Cleanup (VSAM) |
DFHMALFC |
CMAF |
This program monitors the CICS Service Flow Runtime Link3270 State VSAM file, (DFHMAL2F) and deletes expired Link3270 facility session state data and de-allocates associated Link3270 bridge facilities that CICS has not automatically deleted due to the facility being inactive for the keeptime interval. |
The CICS Service Flow Runtime Facility
State Cleanup (VSAM) is used for Link3270 Adapter services of the following
styles:
You can configure the CICS Service Flow Runtime so that this program is started automatically on CICS system initialization. For information, see Configuring the autostart procedure for the Link3270 facility state cleanup programs For a description of facility state cleanup processing on the VSAM file, seeFacility state cleanup processing — VSAM |
CICS Service Flow Runtime Link3270 Facility Deallocate Cleanup |
DFHMALFD |
CMAD |
The CICS Service Flow Runtime Link3270 Facility Deallocate Cleanup program is used to deallocate existing bridge facilities and delete the associated facility business state data whether that data is stored in a temporary storage queue (TSQ) or VSAM file. |
Business state data is stored in a TSQ if the Adapter service is of the single connector nonpersistent type. For all other Adapter service types, business state data is stored in the CICS Service Flow Runtime Link3270 Facility State VSAM file (DFHMAL2F). For a description of facility state cleanup processing, see Facility state cleanup processing in the CICS Service Flow Runtime |
CICS Service Flow Runtime Link3270 Facility State Management (VSAM). |
DFHMALFS |
The CICS Service Flow Runtime State Management (VSAM) program is responsible for saving, retrieving and deleting state information from the CICS Service Flow Runtime Link3270 State file (DFHMAL2F) for Link3270 Adapter services of the following types:
|
This is a called subprogram. It runs under the transaction ID of the generated Link3270 server adapter if performing adapter services or the transaction ID of the Link3270 Passthrough Manager (DFHMALPT) transaction ID (CMAL) if performing passthrough processing. CICS Service Flow Runtime Link3270 State file (DFHMALSF) supports Adapter services and flows from MQSI Agent for CICS that have not been regenerated in CICS Service Flow Runtime.If the adapter service or flow is built and generated using the Service Flow Modeler, the file from which state information is stored, retrieved and deleted is (DFHMAL2F). Although it is recommended that customers who are running Link3270 server adapters that were built and generated using MQSI Agent for CICS v1.1.3 regenerate their Adapter services for use in the CICS Service Flow Runtime, DFHMALSF provides upward compatibility. |
|
CICS Service Flow Runtime Link3270 Passthrough Manager |
DFHMALPT |
CMAL |
The CICS Service Flow Runtime Link3270 Passthrough Manager is run by the Navigation Manager to handle passthrough request processing. It is a child activity run by the Navigation Manager activity. |
See Passthrough processing for information on how this program functions when the CICS Service Flow Runtime is invoked with a passthrough request message. |
CICS Service Flow Runtime Link3270 Maintenance |
DFHMALNM |
The CICS Service Flow Runtime Link3270 Maintenance program is invoked by both the generated Link3270 server adapter during request processing and by the Passthrough Manager program (DFHMALPT) for passthrough processing. The CICS Service Flow Runtime Link3270 Maintenance program performs initiate / terminate processing for generated Link3270 server adapters and passthrough processing. |
This is a called subprogram. It runs under the transaction ID of the generated Link3270 server adapter if performing adapter services or the transaction ID of the Link3270 Passthrough Manager (DFHMALPT) transaction ID (CMAL) if performing passthrough processing. . |
|
CICS Service Flow Runtime FEPI 3270 Data Stream Conversion |
DFHMAF |
The CICS Service Flow Runtime FEPI 3270 Data Stream Conversion program is used to convert 3270 data streams to a 1920 byte record format (screen size 24 x 80). It is also used to build 3270 data streams from the 1920 byte record format. |
This is a called subprogram. It runs under the transaction ID of the generated FEPI server adapter. It is used in FEPI server adapter processing only. It must be included on the LINKEDIT step when compiling FEPI server adapters. |
|
CICS Service Flow Runtime Link3270 Initiate Terminate program |
DFHMALIN |
CMAI |
TheCICS Service Flow Runtime Link3270 Initiate Terminate program retrieves any target CICS application transaction COMMAREA information and any TCTUA information (actions performed by terminate processing) from one CICS region (region where the Link3270 bridge facility is currently allocated) and populates that same information (initiate processing) in a second CICS region before running the next target CICS application transaction routed to that second CICS region. | See Configuring the runtime environment to use transaction routing for a description of how DFHMALIN is used. |
CICS Service Flow Runtime Link3270 Vector Logging |
DFHMAVCL |
The CICS Service Flow Runtime Link3270 Vector Logging program writes Link3270 vector data to the Vector log file (DFHMALVF). It is used in both generated Link3270 server adapters and passthrough processing. |
This is a called subprogram. It runs under the transaction ID of the generated Link3270 server adapter if performing adapter services or the transaction ID of the Link3270 Passthrough Manager (DFHMALPT) transaction ID (CMAL) if performing passthrough processing. |
|
CICS Service Flow Runtime Link3270 Vector Processor |
DFHMAVCP |
The Link3270 Vector Processor program is invoked by both the generated Link3270 server adapter during request processing, and the Passthrough Manager program (DFHMALPT) for passthrough processing. The Link3270 Vector Processor program sends vectors to and receives vectors from the Link3270 bridge program (DFHL3270) to interface to any CICS target application that uses BMS commands (with some restrictions) where a single send and receive structure inclusive of the Link3270 bridge header and appropriate input/output vector header is not greater than 32000 bytes. |
This is a called subprogram. It runs under the transaction ID of the generated Link3270 server adapter if performing adapter services or the transaction ID of the Link3270 Passthrough Manager (DFHMALPT) transaction ID (CMAL) if performing passthrough processing. |
CICS Service Flow Runtime utilizes the following IBM® WebSphere MQ tasks when the service requestor uses WebSphere MQ to invoke the server runtime.
These components are part of the WebSphere MQ-CICS bridge. WebSphere MQ-CICS bridge is not part of CICS Service Flow Runtime, but it should be used as the interface between WebSphere MQ and CICS Service Flow Runtime when the service requestor uses WebSphere MQ to invoke the runtime.
Name | Program name | CICS Tran ID | Description | Comments |
---|---|---|---|---|
WebSphere MQ-CICS bridge monitor task | CSQCBR00 |
CKBR |
This task monitors the request queue for messages. When a message arrives in the queue, the bridge monitor task starts the WebSphere MQ CICS bridge link task. |
WebSphere MQ-CICS bridge enables an application, not running in a CICS environment, to run a program or transaction in CICS and get a response back. |
WebSphere MQ-CICS bridge link task | CSQCBP00 |
CKBP |
This task pulls the message off the request queue and links to the DPL Stub program with the DFHMAH header information and the application data. |
WebSphere MQ-CICS bridge enables an application, not running in a CICS environment, to run a program or transaction in CICS and get a response back. |