Debugging connection and sign-on routines

The diagnostic aids can assist you in debugging connection exit routines and sign-on exit routines.

About this task

Begin program-specific programming interface information.Subsystem support identify recovery: The identify ESTAE recovery routine, DSN3IDES, generates the following VRADATA entries. The last entry, key VRAIMO, is generated only if the abend occurred within the connection exit routine.

Table 1. VRADATA entries that are generated by DSN3IDES
VRA keyname Key hex value Data length Content
VRAFPI 22 8 Constant 'IDESTRAK'
VRAFP 23 24
  • 32-bit recovery tracking flags
  • 32-bit integer AGNT block unique identifier
  • AGNT block address
  • AIDL block address
  • Initial primary authorization ID as copied from ASXBUSER or ASXBUSR8
VRAIMO 7C 10
  • Connection exit load module load point address
  • Connection exit entry point address
  • Offset of failing address in the PSW from the connection exit entry point address

Subsystem support sign-on recovery: The sign-on ESTAE recovery routine DSN3SIES generates the following VRADATA entries. The last entry, key VRAIMO, is generated only if the abend occurred within the sign-on exit routine.

Table 2. VRADATA entries that are generated by DSN3SIES
VRA keyname Key hex value Data length Content
VRAFPI 22 8 Constant 'SIESTRAK'
VRAFP 23 20
  • Primary authorization ID (CCBUSER)
  • AGNT block address
  • Identify-level CCB block address
  • Sign-on-level CCB block address
VRAIMO 7C 10
  • Sign-on exit load module load point address
  • Sign-on exit entry point address
  • Offset of failing address in the PSW from the sign-on exit entry point address

Diagnostics for connection exit routines and sign-on exit routines: The connection (identify) recovery routine and the sign-on recovery routine provide diagnostics for the corresponding exit routines. The diagnostics are produced only when the abend occurs in the exit routine. The following diagnostics are available:

Dump title
The component failing module name is DSN3@ATH for a connection exit or DSN3@SGN for a sign-on exit.
z/OS® and RETAIN symptom data
SDWA symptom data fields SDWACSCT (CSECT/) and SDWAMODN (MOD/) are set to DSN3@ATH or DSN3@SGN, as appropriate.
Summary dump additions
The AIDL, if addressable, and the SADL, if present, are included in the summary dump for the failing allied agent. If the failure occurred in connection or sign-on processing, the exit parameter list (EXPL) is also included. If the failure occurred in the system services address space, the entire SADL storage pool is included in the summary dump.End program-specific programming interface information.