ENABLE command

The ENABLE command activates an AT or pattern-match breakpoint after it was disabled with the DISABLE command.

Read syntax diagramSkip visual syntax diagramENABLEAT_commandDTCN*LOADMODloadmod_id*CUcu_id*;
AT_command
A disabled AT command. The AT command must be complete except that the every_clause and command are omitted. Valid forms are the same as those allowed with CLEAR AT.
DTCN LOADMOD or DTCN CU
Re-enable a DTCN profile that was previously disabled by the DISABLE command. The names you specify for loadmod_id or cu_id must match the loadmod_id or cu_id you specified in the DISABLE command.

If you do not specify a loadmod_id or cu_id, z/OS® Debugger enables all previously disabled DTCN profiles. If you try to specify a loadmod_id or cu_id for a profile that was not disabled, z/OS Debugger displays an error message.

Usage notes

  • You can use the ENABLE DTCN command in remote debug mode.

  • You can use the ENABLE command to enable either active or suspended breakpoints. However, you cannot use it to enable suspended label breakpoints.
  • If you want to enable a suspended breakpoint, you must specify both the load module and CU name.
  • To disable an AT command, use the DISABLE command.
  • Breakpoints already enabled within the range(s) specified in the specific AT command are unaffected; however, a warning message is issued for any specified range found to contain no disabled breakpoints.
  • The ENABLE command cannot be used while you replay recorded statements by using the PLAYBACK commands.
  • For pseudo-conversational applications running under CICS®, the ENABLE DTCN command applies only to the current CICS pseudo-conversational task.
  • For PL/I, COBOL, LangX COBOL, assembler and disassembly, if the cu_id is mixed case or case sensitive, you must enclose the name in quotation marks (") or apostrophes (').
  • For C and C++, z/OS Debugger always treats the cu_id as case sensitive, even if it is not enclosed in quotation marks (").

Examples

  • Reenable the previously disabled command AT ENTRY mysub CALL proc1;. 
    ENABLE AT ENTRY mysub;
  • Allow DTCN to start z/OS Debugger every time PROGA runs, which was previously prevented with the command DISABLE DTCN CU PROGA;, by entering the following command: 
    ENABLE DTCN CU PROGA;

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