How does z/OS Debugger locate source and listing files?

z/OS® Debugger reads the source or listing file for a CU each time it needs to display information about that CU. While you are debugging your CU, the data set from which the file is read can change. Each time z/OS Debugger needs to read a source or listing file, it searches for the data set in the following order:

  1. SET SOURCE command
  2. SET DEFAULT LISTINGS command. If the EQAUEDAT user exit is implemented and a EQADEBUG DD statement is not specified, the data set name might be modified by the EQAUEDAT user exit.
  3. if present, the EQADEBUG DD statement
  4. to find listing files for CUs compiled with Enterprise COBOL for z/OS Version 4, the EQASRCE DD statement.
  5. to find listing files for CUs compiled with Enterprise COBOL for z/OS Version 4, the EQA_SRC_PATH environment variable.
  6. default data set name. If a data set with the default data set name cannot be located, and if the EQAUEDAT user exit is implemented and an EQADEBUG DD statement is not specified, the data set name might be modified by the EQAUEDAT user exit.
Note: You cannot alter the listing content in anyway other than inserting the NL characters for each record when you move or copy listing from MVS to HFS. The moved or copied listing file should be exactly the same as generated directly by the compiler to an HFS file.