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.
Debug Environment Maintenance - Debugger documentation
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 |
|
||||||||||||||||||
Sel. List |
|
||||||||||||||||||
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 |
||||||||||||||||||
File | The file number (FNR) of a source or a target system file (FNAT
or FUSER).
Valid file numbers are 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 |
|
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:
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). |
One of the following line commands can be entered in the C (Command) column of a Selection screen:
Line |
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). |
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:
DEBUG
|
name | ||||
FM
[LIBRARY ]
lib-name
[where-clause]
|
|||||
TO
[LIBRARY ]
lib-name
[where-clause]
[with-clause]
|
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
|
DEBUG
|
name | IN
[LIBRARY ]
lib-name
|
[where-clause] | [with-clause] |
DELETE DEBUG U* IN TESTLIB FNR 150
D DEBUG TEST* IN TESTLIB IN DBID 177 FNR 205
LIST
|
DEBUG
|
name | IN
[LIBRARY ]
lib-name
|
[where-clause] | [with-clause] |
LIST DEBUG ENV* IN TESTLIB DBID 1 FNR 5
L D DT* IN TESTLIB DBID 10
RENAME
|
DEBUG
|
name | AS new-name
[with-clause]
|
IN [LIBRARY ]
lib-name
[where-clause]
|
|||
TO
[LIBRARY ]
lib-name
[where-clause]
|
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 ] [DBID
dbid
] [FNR
fnr]
[NAME
vsam-name
] |
|||||||||||||||||
[CIPHER
cipher]
|
|
password |
[WITH ] [REPLACE ] [RCOP ]
|
[HELP ]
|