SET IGNORELINK command

Specifies that any new LINK level (nested enclave) is ignored while the setting is ON. z/OS® Debugger does not gather information or stop at the programs in this newly created enclave. The initial setting is OFF.

Read syntax diagramSkip visual syntax diagramSETIGNORELINK ONOFF ;
ON
Programs in new enclaves (links) are ignored. z/OS Debugger does not stop at programs in new enclaves.
OFF
Programs in new enclaves (links) are not ignored. z/OS Debugger stops at any breakpoint for a program in new enclaves.
Usage notes
  • A new enclave is created by language constructs like EXEC LINK or EXEC XCTL, which invoke a new main program.
  • This command is valid only in CICS® programs.
  • You can use this command in remote debug mode.
  • DTCN profiles override the setting of SET IGNORELINK.
  • You can use the STEP INTO command to step into a new enclave, which overrides the SET IGNORELINK setting. However, this does not change the setting of SET IGNORELINK.
  • If you use the STEP RETURN command, you can only return to the parent enclave if it was not ignored by z/OS Debugger because at the time it was created, the setting of SET IGNORELINK was OFF. Otherwise, z/OS Debugger runs to the next breakpoint in a previous enclave that was not ignored by z/OS Debugger or it runs to the end of the application.
  • The DISABLE DTCN and ENABLE DTCN commands override the setting of SET IGNORELINK. This allows you to debug the new enclave, but does not change the setting of SET IGNORELINK.
  • Breakpoints are not restored for a compile unit in a new enclave when the SET IGNORELINK setting is ON.
  • z/OS Debugger does not stop for any deferred entry breakpoints for a compile unit in a new enclave when the SET IGNORELINK setting is ON.
  • z/OS Debugger does not stop for any breakpoint in the new enclave when the SET IGNORELINK setting is ON.
  • Conditions raised in the application are reported regardless of the setting of SET IGNORELINK.
  • You can use this command in a preferences, commands, or global preferences file so that it is run at the beginning of every new debugging session.
  • When both SET IGNORELINK ON and SET EXPLICITDEBUG ON are in effect, and you have run an LDD, AT ENTRY, or NAMES INCLUDE for the initial load module and compile unit for the LINK target, z/OS Debugger ignores the SET IGNORELINK for that specific LINK. However, this does not change the setting of SET IGNORELINK.

Refer to the following topics for more information related to the material discussed in this topic.