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:
- Copy either the
EQAUEDAT
orEQAUEDAC
member from thehlq.SEQASAMP
library to a private library. - 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.
- Submit the JCL.
- 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 ofhlq.SEQAMOD
.