Enabling the EQAUEDAT user exit

The EQAUEDAT user exit enables the library administrator or system programmer to direct z/OS® Debugger to the location where source, listing, or separate debug files are stored. If your site policy is to control the location of these files, this user exit supports this policy by allowing your application programmers to debug their programs without knowing where these files are located.

The provided samples are designed to operate only under Language Environment®. If you require an exit to run at any time in a non-Language Environment environment, you must write the exit in assembler and replace the CEEENTRY and CEETERM macro invocations with the proper prologue and epilogue code for your environments. If z/OS Debugger detects a Language Environment-enabled EQAUEDAT when Language Environment is not active, the exit will not be started.

z/OS Debugger provides two samples: EQAUEDAT, which is written in Language Environment-enabled assembler, and EQAUEDAC, which is written in Enterprise COBOL for z/OS and OS/390®. Both samples generate a load module named EQAUEDAT.

To enable this user exit, do the following steps:

  1. Copy either the EQAUEDAT or EQAUEDAC member from the hlq.SEQASAMP library to a private library.
  2. Edit the copy, as instructed in the member. Write the logic required to implement your site policy.

    The address of the load library data set name and the length of the load library data set name cannot be provided as input to the EQAUEDAT user exit when the loading service (provider) that loaded the module is LPA, LLA, AOS loader, or an unknown provider because this information is not available when using these loading services.

  3. Submit the JCL.
  4. Add the private library where the generated EQAUEDAT load module is located to the load module search path for the application that you are debugging and for which you want this site policy enabled, in front of hlq.SEQAMOD.