Entering file allocation statements, runtime options, and program parameters

The top part of the Edit–Setup File panel contains the name of the program (load module) that you want to run and the runtime parameter string. If the setup file is for a Db2® program, the panel also contains fields for the Db2 System identifier and the Db2 plan. The bottom part of the Edit–Setup File panel contains the file allocation statements. This part of the panel is similar to an ISPF edit panel. You can insert new lines, copy (repeat) a line, delete a line, and type over information on a line.

To modify the name of the load module, type the new name in the Load Module Name field.

To modify the parameter string:
  1. Select the format of the parameter string and whether the program is to start in the Language Environment®. Non-Language Environment COBOL programs do not run in Language Environment. If you are debugging a non-Language Environment COBOL program, select the non-Language Environment option.
  2. Enter the parameter string in one of the following ways:
    • Type the parameter string in the Enter / to modify parameters field.
    • Type a slash ("/") before the Enter / to modify parameters field and press Enter. The z/OS® Debugger Foreground - Modify Parameter String panel appears. Define your runtime options and suboptions by doing the following steps:
      1. Define the TEST run-time option and its suboptions.
      2. Enter any Language Environment or z/OS Debugger runtime options and other program parameters.
      3. Press PF3. DTSU creates the parameter string from the options that you specified and puts it in the Enter / to modify parameters field.

In the file allocation section of the panel, each line represents an element of a DD name allocation or concatenation. The statements can be modified, copied, deleted, and reordered.

To modify a statement, do one of the following steps:

  • Modify the statement directly on the Edit – Edit Setup File panel:
    1. Move your cursor to the statement you want to modify.
    2. Type the new information over the existing information.
    3. Press Enter.
  • Modify the statement by using a select command:
    1. Move your cursor to the statement you want to modify.
    2. Type one of the following select commands:
      • SA - Specify allocation information
      • SD - Specify DCB information
      • SS - Specify SMS information
      • SP - Specify protection information
      • SO - Specify sysout information
      • SX - Specify all DD information by column display
      • SZ - Specify all DD information by section display
    3. Press Enter.

To copy a statement, do the following steps:

  1. Move your cursor to the Cmd field of the statement you want to copy.
  2. Type R and press Enter. The statement is copied into a new line immediately following the current line.

To delete a statement, do the following steps:

  1. Move your cursor to the Cmd field of the statement you want to delete.
  2. Type D and press Enter. The statement is deleted.

IBM® z/OS Debugger Utilities does not support reordering the DD names, only the data sets within each concatenation. The DD names are automatically sorted in alphabetical order. To reorder statements in a concatenation, do the following steps:

  1. Move your cursor to the sequence number field of a statement you want to move and enter the new sequence number.

To insert a new line, do the following steps:

  1. Move your cursor to the Cmd field of the line right above the line you want a new statement inserted.
  2. Type I and press Enter.
  3. Move your cursor to the new line and type in the new information or use one of the Select commands.

The Edit and Browse line commands allow you to modify or view the contents of the data set name specified for DD and SYSIN DD types.

You can use the DDNAME STEPLIB to specify the load module search order.

For additional help, move the cursor to any field and enter the HELP command or press PF1.

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