DFHZXRL module

For an ALLOCATE request, control passes to subroutine ZXRL_ALLOCATE which establishes a session between the application-owning region and the alternate facility, and builds a surrogate session TCTTE.

Subroutine ZXRL_ALLOCATE:
  1. Checks that the parameter list contains the TCTSE address for the remote LU6.2 system.
  2. Obtains the address of the TCTSE of the system to which the LU6.2 commands are to be routed.
  3. Allocates a session to the terminal-owning region.

    The connection between the terminal-owning region and application-owning region which supports remote alternate facilities may be an LU6.2 ISC connection or an MRO connection. Subroutine ZXRL_ALLOCATE allocates the session using a DFHTC TYPE=ALLOCATE macro call that can allocate a session on either type of connection.

    The default profile DFHCICSR is used; this may specify the modename for an LU6.2 connection. The modename specified on the EXEC CICS ALLOCATE is not used here, but is shipped to the terminal-owning region where it is used to allocate an LU6.2 session between the terminal-owning region and the APPC device.

    The queuing option (NOQUEUE|NOSUSPEND) specified on the ALLOCATE request by the caller is used when the DFHTC TYPE=ALLOCATE macro call is issued for the connection. If NOQUEUE is not specified, the request may also be queued when it is issued in the terminal-owning region. If a session failure occurs during this period, the transaction in the application-owning region and the relay transaction in the terminal-owning region abend.

    If a session between the application-owning region and terminal-owning region cannot be allocated:
    • When the failure is due to CICS logic, corruption of CICS storage, or incorrect resource definition by the user, the transaction abends.
    • When the failure is due to other conditions (such as session failure or ‘SYSBUSY’), an appropriate return code is passed to the caller.
      The return code is handled so as to minimize the differences between local and remote APPC devices as seen by the user of the DFHLUC interface. The actions available are:
      • Where the condition could be encountered with a local terminal, reflect the return code to the caller in LUCRCOD2 and LUCRCOD3 with LUCESYSI (X'01') in LUCRCOD1.
      • Where the condition would not occur with a local terminal, reflect a different return code to the caller.
  4. Issues a DFHIS TYPE=XTP,XFNUM=3 macro call that invokes a stream that is passed to the terminal-owning region.
  5. Issues a DFHTC TYPE=(WRITE,WAIT,READ),FMH=YES macro call to send the request to the terminal-owning region and receive the response.
  6. Issues a DFHIS TYPE=RALL that invokes DFHZTSP to build a surrogate session TCTTE, then chains the link session TCTTE and the surrogate session TCTTE together.
  7. Issues a DFHIS TYPE=XTP,XFNUM=2 macro call that invokes DFHXTP to unwrap the response from the terminal-owning region and update the surrogate session TCTTE and the parameter list created by the DFHLUC macro.
  8. Examines the return codes in the response:
    • If the request has been successful, returns the surrogate session TCTTE address to the caller.
    • If the request has not been successful, issues a DFHIS TYPE=RDET macro call to free the surrogate session TCTTE.


dfhs395.html | Timestamp icon Last updated: Monday, 5 June 2017