Program link server adapter

The program link server adapter performs programming links to CICS applications using the EXEC CICS LINK command.

The program link server adapter is called DFHMASDP and is invoked for all programming links that are modeled in the service flow. These links can target either applications in the same CICS region as the CICS Service Flow Runtime environment or in another CICS region. If the target application is remote, DFHMASDP performs a distributed programming link (DPL) to access the remote application. Because DFHMASDP is handling all of the programming links, it is always invoked by a flow navigator and runs by default under the CMAS transaction. You can override the transaction that runs DFHMASDP in service flow project tools.

DFHMASDP supports linking to target applications with either a COMMAREA or using a channel and containers, depending on what was modeled in the service flow. DFHMASDP creates the COMMAREA or channel and containers, links to the application, and then waits for a response before returning to the flow navigator.

Restrictions

The maximum COMMAREA length that can be passed from this server adapter to the target application is 32 767 bytes. 267 bytes are taken up by the message header and the remaining 32 500 bytes can be used for application data. To overcome this limit, use a channel and containers instead. A container can hold up to 2 GB of data.

If you want to pass the data using a channel and containers, you can send or receive only up to 999 containers on a channel. The following container names are reserved for use by CICS Service Flow Runtime:

  • ADAPTER.PROCESS
  • ADAPTER.ERROR
  • COMMAND.STATUS
  • COMMAND.INPUT
  • COMMAND.OUTPUT
  • DPL.DATA


dfhcr_adapter_dpl.html | Timestamp icon Last updated: Sunday, 4 June 2017