COMMANDSDSN

Indicates that you want z/OS® Debugger to read a user's commands file (with the name of the data set containing the commands file determined by the specified naming pattern) each time it starts. This works in the following situation:
  • You do not specify a data set name or DD name for the user's commands file using any other method; for example, the TEST runtime option.
  • You or your site specifies the EQAOPTS COMMANDSDSN command.
  • The data set specified by the EQAOPTS COMMANDSDSN command exists and contains a member whose name matches the initial load module name in the first enclave.

The following diagram describes the syntax of the COMMANDSDSN command:

Read syntax diagramSkip visual syntax diagramEQAXOPTCOMMANDSDSN, 'file_name_pattern' ,LOUD
file_name_pattern
Specifies a naming pattern that determines the name of the data set that contains the user's commands file. Follow these guidelines when you create the naming pattern:
  • Create a data set name that includes &&USERID. as one of the qualifiers. z/OS Debugger substitutes the user ID of the current user for this qualifier when it determines the name of the data set.
  • Specify NULLFILE to indicate you do not want z/OS Debugger to process a commands file.
LOUD
Specifies that z/OS Debugger display WTO messages, which helps you debug processing done by this command. z/OS Debugger normally does not display any messages if it does not find the data set or data set member. If you are trying to determine why z/OS Debugger is not processing a user's commands file, specify LOUD to see if it displays a message that it cannot find the data set or the member.

If you choose to implement this option, users who want to use this function must create the commands file as a PDS or PDSE with the allocation parameters that are described in Data sets used by z/OS Debugger in the IBM® z/OS Debugger User's Guide. Then, users create a member for each program that they want to debug, with the name of the member matching the initial load module name in the first enclave.

Example

EQAXOPT  COMMANDSDSN,'&&USERID.DBGTOOL.COMMANDS'

If you log in with user ID USERIBM, z/OS Debugger determines the name of the data set to be USERIBM.DBGTOOL.COMMMANDS.