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.

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

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

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]