Description of fields on the DTCN Menu 2 screen

The following list describes the fields that you can use to specify the TEST runtime options, other runtime options, commands file, and preferences file that you want to use for the debugging session:

Test Option
TEST⁄NOTEST specifies the conditions under which z/OS® Debugger assumes control during the initialization of your application.
Test Level
ALL⁄ERROR⁄NONE specifies what conditions need to be met for z/OS Debugger to gain control.
Commands File
A valid fully qualified data set name that specifies the commands file for this run. Do not enclose the name of the data set in quotation marks (") or apostrophes ('). The CICS® region must have read authorization to the commands file.

If you leave this field blank and have a value for a default user commands file set through the EQAOPTS COMMANDSDSN command, z/OS Debugger does the following tasks to find a commands file:

  1. z/OS Debugger constructs the name of a data set from the naming pattern specified in the command.
  2. z/OS Debugger locates the data set.
  3. If the data set contains a member with a name that matches the name of the initial load module in the first enclave, it processes that member as a commands file.

If you do not want specify a commands file, and want to prevent z/OS Debugger from using the file specified by the EQAOPTS COMMANDSDSN command, specify NULLFILE for the commands file.

To learn how to specify the EQAOPTS COMMANDSDSN command, see the topic EQAOPTS commands in either the IBM® z/OS Debugger Customization Guide or IBM z/OS Debugger Reference and Messages.

Prompt Level
Specifies whether z/OS Debugger is started at Language Environment® initialization.
Preferences File
A valid fully qualified data set name that specifies the preferences file for this run. Do not enclose the name of the data set in quotation marks (") or apostrophes ('). The CICS region must have read authorization to the preferences file.

If you leave this field blank and have a value for a default user preferences file set through the EQAOPTS PREFERENCESDSN command, z/OS Debugger does the following tasks to find a preferences file:

  1. z/OS Debugger constructs the name of a data set from the naming pattern specified in the command.
  2. z/OS Debugger locates the data set and processes it as a preferences file.

If you do not want to specify a preferences file, and want to prevent z/OS Debugger from using the file specified by the EQAOPTS PREFERENCESDSN command, specify NULLFILE for the preferences file.

To learn how to specify the EQAOPTS PREFERENCESDSN command, see the topic EQAOPTS commands in either the IBM z/OS Debugger Customization Guide or IBM z/OS Debugger Reference and Messages.

EQAOPTS File
A valid fully qualified data set name that specifies the EQAOPTS file for this run. Do not enclose the name of the data set in quotation marks (") or apostrophes ('). The CICS region must have read authorization to the EQAOPTS file.
Any other valid Language Environment Options
You can change any Language Environment option that your site has defined as overrideable except the STACK option. For additional information about Language Environment options, see z/OS Language Environment Programming Reference or contact your CICS system programmer.