Processing Debug Environments

#### Search Results

Search

# Processing Debug Environments

All SYSMAIN functions, except the find function, can be performed on debug environments.

The debug environment specification must always correspond to the database ID (DBID) and file number (FNR) of the relevant FUSER system file.

This section describes menu functions and selection list options provided to perform a SYSMAIN function on debug environments and the syntax that applies when using direct commands.

- Fields in the Debug Environments Menu

- Selection Lists for Debug Environments

- Direct Command Syntax for Debug Environments

#### Related Topic:

Debug Environment Maintenance - Debugger documentation

## Fields in the Debug Environments Menu

The Debug Environments menu contains all SYSMAIN functions required for the processing of debug environments. The fields provided in the menu are described in the following table:

Field | Explanation
--- | ---
Code |
Specifies the function to be performed as described in Description of Functions:
`C` | Copy debug environment.
`D` | Delete debug environment.
`L` | List debug environment.
`M` | Move debug environment.
`R` | Rename debug environment.
Note When a debug environment has been moved or copied from one library to another, the breakpoints and watchpoints must be adapted to the new library. For details, refer to Maintaining Debug Environments in Different Libraries in the Debugger documentation.
Sel. List |
Specifies whether selective processing or automated processing is used:
`Y` | Yes. Selective processing is activated. A selection list is displayed when processing debug environments. This is the default setting. For the columns, fields and line commands available on a selection list, see Selection Lists for Debug Environments.
`N` | No. Selective processing is deactivated.
Name | The name of the debug environment to be processed or a range of names: see also Specifying a Range of Names. The default setting is an asterisk (*) which means that all names are selected.
New Name | The name to be given to a debug environment when it is renamed with the rename function.
Library | The name of a source or a target library. The source library contains the debug environment to be processed. The target library is the library to which the debug environment is to be copied or moved, or where the debug environment is renamed. See also Listing and Selecting Libraries.
Database | The database ID (DBID) of a source or a target database. The source database contains the library and system file where the debug environment to be processed is stored. The target database contains the library and system file to which the debug environment is to be copied or moved, or where the debug environment is renamed. Valid database IDs are `1` to `65535`.
File | The file number (FNR) of a source or a target system file (FNAT or FUSER). Valid file numbers are `1` to `65535`. The source file contains the library where the debug environment to be processed is stored. The target file contains the library to which the debug environment is to be copied or moved, or where the debug environment is renamed.
Replace |
Specifies whether a debug environment is to be replaced when using the move, copy or rename function:
`Y` | Yes. A debug environment with the same name which exists in the target environment is replaced.
`N` | No. A debug environment with the same name which exists in the target environment is not replaced. This is the default setting.
See also Using the Replace Option.

## Selection Lists for Debug Environments

If selective processing has been activated, a selection list of all debug environments that meet the specified selection criteria is displayed on a Selection screen.

This section describes the columns and fields contained on a Selection screen and the line commands provided to further process a debug environment:

- Columns and Fields

- Line Commands

### Columns and Fields

The following columns and fields are displayed on a Selection screen:

Column/Field | Explanation
--- | ---
C | Input field for line commands (see below).
Environment | The name of the debug environment that meets the specified selection criteria.
Message | The message that indicates the processing status of a debug environment. For possible messages, see Status Messages.
Listed Library | The name of the library that contains the selected debug environment(s).

### Line Commands

One of the following line commands can be entered in the C (Command) column of a Selection screen:

Line Command | Function
--- | ---
`A` | Process the debug environment. This line command is not available on the List Selection screen. On a List Selection screen, you can only enter a period (.) to leave the screen.
`L` | Display a list of the debug environments contained in the specified library. Only applies to a Library Selection screen (see also Listing and Selecting Libraries).

## Direct Command Syntax for Debug Environments

This section shows the syntax that applies when performing a SYSMAIN function on debug environments by using direct commands in either online or batch mode. For general instructions on using direct commands, refer to Executing Commands.

For explanations of the keywords and variable values used in the syntax diagrams below, refer to Keywords and Variables in Direct Commands. The symbols in the syntax diagrams correspond to the syntax symbols used for system commands. These symbols are explained in System Command Syntax in the System Commands documentation.

The syntax of the where-clause and the with-clause are identical for each command.

This section covers the following topics:

- COPY and MOVE

- DELETE

- LIST

- RENAME

- where-clause

- with-clause

### COPY and MOVE

| `COPY` `MOVE` |  | `DEBUG` | name |
`FM` [`LIBRARY`] lib-name [where-clause]
`TO` [`LIBRARY`] lib-name [where-clause] [with-clause]

#### Examples:

    COPY D ENV FM TESTLIB WHERE DBID 1 FNR 5 TO PRODLIB WHERE DBID 2 FNR 5 WITH REP

    C DEBUG ENV FM TESTLIB FNR 6 TO PRODLIB FNR 7 REP

    MOVE DEBUG ENV FM OLDLIB WHERE DBID 1 FNR 5 TO NEWLIB WHERE DBID 2 FNR 5

    M DEBUG ENV FM OLDLIB FNR 6 TO NEWLIB FNR 7 REP

### DELETE

`DELETE` | `DEBUG` | name |  | `IN` [`LIBRARY`] lib-name |  | [where-clause] | [with-clause]

#### Examples:

    DELETE DEBUG U* IN TESTLIB FNR 150

    D DEBUG TEST* IN TESTLIB IN DBID 177 FNR 205

### LIST

`LIST` | `DEBUG` | name |  | `IN` [`LIBRARY`] lib-name |  | [where-clause] | [with-clause]

#### Examples:

    LIST DEBUG ENV* IN TESTLIB DBID 1 FNR 5

    L D DT* IN TESTLIB DBID 10

### RENAME

`RENAME` | `DEBUG` | name | `AS` new-name [with-clause]
|  |  | `IN` [`LIBRARY`] lib-name [where-clause]
|  |  | `TO` [`LIBRARY`] lib-name [where-clause]

#### Examples:

    RENAME D OLDENV AS NEWENV IN TESTLIB RCOP

    R DEBUG OLDENV AS NEWENV IN TESTLIB DBID 1 FNR 4 TO PRODLIB DBID 1 FNR 5

    R DEBUG OLDENV AS NEWENV IN TESTLIB FNR 4 TO PRODLIB FNR 5 REPLACE RCOP

### where-clause

[`WHERE`] [`DBID` dbid `]` [`FNR` fnr] [`NAME` vsam-name `]`
[`CIPHER` cipher] |  |  |  | `PASSWORD` `PSW` |  | password |  |  |  |  |  |  |  |  |  |  |

### with-clause

[`WITH`] [`REPLACE`] [`RCOP`] |  | `PROMPT` `NOPROMPT` |  |  | `MON` `NOMON` |  | [`HELP`]

### On this page

- Fields in the Debug Environments Menu
- Selection Lists for Debug Environments
- Direct Command Syntax for Debug Environments