Using DPL in a FEPI or Link3270 server adapter

If the FEPI or Link3270 bridge server adapter uses an inline DPL command, the runtime behavior for the DPL command differs from that of a DPL command used in a regular adapter.

When the FEPI server adapter or Link3270 bridge server adapter is generated, the adapter contains an embedded EXEC CICS LINK command for the DPL command, instead of the generated statements that define and perform a new BTS activity to execute the link.

In Figure 1, linkname contains the linkname from the MAT_LINKNAME property in the properties file. The command input message variable is the DPL Command node input terminal message. The sysid variable is the MAT_SYSID property from the Connection Resource file.

Figure 1. Invocation of DPL in FEPI service flow
EXEC CICS LINK PROGRAM (linkname)
      COMMAREA (command input message)
        LENGTH  (length of command input message)
        SYSID   (sysid)
        RESP    (CICS-RESP)
        RESP2   (CICS-RESP2)
      END-EXEC.

      IF CICS-RESP NOT EQUAL 0
        MOVE +9                 TO ERROR-IND
        MOVE DPL-ERRMSG         TO WS-ERR-MESSAGE
        MOVE DPL-ERROR-CODE     TO WS-ERR-CODE
        MOVE CICS-RESP          TO EDC-DPL-RESP
        MOVE CICS-RESP2         TO EDC-DPL-RESP2
        MOVE linkname           TO EDC-DPL-PROGRAM
        MOVE sysid              TO EDC-DPL-SYSID
        MOVE SPACES             TO EDC-DPL-TRANSID
        MOVE SPACES             TO EDC-DPL-SYNCONRETURN
        MOVE LENGTH OF command input message
                                TO EDC-DPL-LENGTH
        MOVE LENGTH OF command input message
                                TO EDC-DPL-DATALENGTH
        MOVE command input message
                                TO EDC-DPL-DATA
        PERFORM POST-NAVIGATOR-ERROR-RTN
          THRU POST-NAVIGATOR-ERROR-EXIT                 
        PERFORM 9010-NAVIGATOR-RETURN.  

The EXEC CICS LINK for the inline DPL command runs under the same activity as the FEPI or Link3270 server adapter itself. Therefore, the FEPI or Link3270 service adapter issues a direct link to the user-written program as part of the current activity (unit-of-work boundary) as opposed to defining and starting a new BTS activity as occurs for DPL commands in a regular (that is, non-FEPI or non-Link3270) service flow.

Failure of an inline EXEC CICS LINK to complete successfully (for example, PGMIDERR) is handled in the same manner as a LINK failure in a generated DPL command program. From a modeling perspective, runtime error handling for a DPL Command node in a FEPI or Link3270 service flow is the same as a DPL Command node in a regular service flow.

The SYNCPOINT and SYNCPOINT ROLLBACK commands cannot be executed in the linked-to program or any of its subprograms. Also, using the ABEND command in the linked-to program or any of its subprograms might cause an undesirable state of the current activity.



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