SYMTRACE: Symbol resolution tracing

The SYMTRACE option requests the binder to report some symbol resolution information.

Code the SYMTRACE option as follows:

{SYMTRACE=symbol | SYMTRACE(symbol)}

This option requests symbol resolution information to be produced in SYSPRINT. Messages include:

The traced symbol may be resolved dynamically (from a DLL):
- IMPORT information encountered: IEW2336I, IEW2337I.
- IMPORT used for resolution: IEW2423I, IEW2424I.
The traced symbol is referenced in a section:
- Section comes from a data set or DDname: IEW2417I.
- Section comes from a z/OS® UNIX archive member or file: IEW2418I.
The traced symbol is defined in a section:
- Section comes from a data set or DDname: IEW2419I.
- Section comes from a z/OS UNIX archive member or file: IEW2420I.
If origination information is available, the above messages are accompanied by one of these:
- Origination section comes from a data set or DDname: IEW2421I.
- Origination section comes from a z/OS UNIX archive member or file: IEW2422I.
The traced symbol is not yet resolved so will be searched for using AUTOCALL:
- Searching a data set or DDname: IEW2546I.
- Searching a z/OS UNIX archive library or directory: IEW2547I.

If the traced symbol is not found in all explicitly included modules and libraries, no symbol trace message is issued.

When the binder is required to print a message containing a variable (symbol) with a length greater than 1024 bytes, the message prints only the first 1024 bytes of the variable (symbol). Refer to The message summary report for this limitation.

Note: By default, SYMTRACE is off. After it is turned on, you can turn it off again by specifying SYMTRACE=".

If compilers have mangled symbol names, the mangled names should be used for the SYMTRACE option.

As symbol resolution is case sensitive, to trace a case-sensitive symbol name, either set the CASE option to MIXED or specify the symbol name in single-quotes.

Modifying a symbol name by any of the following means does not have any affect on the name of the symbol be traced:

Changed by a CHANGE or REPLACE control statement or corresponding ALTERW API call; renamed by a RENAME control statement or corresponding RENAME API call, or renamed according to other rules described in Renaming.
Changed by the interface validation user exit, action code 4.