All SYSMAIN functions except the find and rename functions can be performed on DDMs.
The DDM environment specification must always correspond to the database ID (DBID) and file number (FNR) of the relevant FDIC system file.
This section describes menu functions and selection list options provided to perform a SYSMAIN function on DDMs and the syntax that applies when using direct commands.
The DDMs menu contains all SYSMAIN functions required for the processing of DDMs. The fields provided in the menu are described in the following table:
| Field | Explanation | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Code |
|
||||||||||||
| Sel. List |
|
||||||||||||
| Name | The name of the DDM to be processed or a range of names: see also Specifying a Range of Names. | ||||||||||||
| DDM DBID | This field can be used to select only DDMs which were cataloged
under the specified database ID (DBID).
Valid database IDs are If this field is empty or set to |
||||||||||||
| DDM FNR | This field can be used to select only DDMs which were cataloged
under the specified file number (FNR).
Valid file numbers are If this field is empty or set to |
||||||||||||
| Database | The database ID (DBID) of a source or a target database.
The source database contains the FDIC system file where the DDM to be processed is stored. The target database contains the FDIC system file to which the DDM is to be copied or moved. Valid database IDs are |
||||||||||||
| File | The file number (FNR) of a source or a target FDIC system file.
Valid file numbers are The source file contains the DDM to be processed. The target file is the file to which the DDM is to be copied or moved. |
||||||||||||
|
Name |
Only applies to VSAM files.
The DDNAME/FCT entry for the source or target file number. |
||||||||||||
| Replace |
|
||||||||||||
| Del.NSC-Def. |
|
||||||||||||
If selective processing has been activated, a selection list of all DDMs that meet the specified selection criteria is displayed on a Selection screen.
This section describes the columns contained on a Selection screen and the line commands provided to further process a DDM:
The following columns are displayed on a Selection screen:
| Column | Explanation |
|---|---|
| C | Input field for line commands (see below). |
| DDM Name | The name of the DDM that meets the specified selection criteria. |
| DBID | The database ID (DBID) under which the DDM was cataloged.
If no DBID or |
| FNR | The file number (FNR) under which the DDM was cataloged. |
| Cat Date | The date on which the DDM was cataloged. |
| Time | The time when the DDM was cataloged. |
| User ID | The ID of the user who cataloged the DDM. |
| Message | The message that indicates the processing status of a DDM.
This column only appears after the line command
For possible messages, see Status Messages. |
The columns Cat Date, Time and User ID are empty if the DDM was cataloged under an older version of Natural which does not supply this type of information.
One of the following line commands can be entered in the C (Command) column of a Selection screen:
|
Line |
Function |
|---|---|
A
|
Process the specified DDM.
This line command is not available with the list function. |
L
|
List the specified DDM.
For detailed information on the field definitions displayed, see Columns of Field Attributes in the SYSDDM Utility documentation. |
R
|
List all automatic rules linked to the specified DDM.
Line command |
X
|
Only applies if Natural Connection and Entire Connection are
installed.
Download DDM(s) to a PC. For detailed instructions, refer to Downloading Objects to a PC. |
This section shows the syntax that applies when performing a SYSMAIN function on DDMs 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.
Note:
For compatibility reasons, instead of the keyword DDM
you can use the keyword VIEW (or its short form V) in
direct commands for DDMs.
This section covers the following topics:
|
|
|
DDM
|
name |
|
FM
where-clause
|
|
TO
where-clause
[with-clause]
|
C DDM PERSONNEL FM FNR 20 TO FNR 24 REPLACE
COPY DDM C< FM FNR 20 TO FNR 24
M DDM PERSONNEL FM FNR 20 TO FNR 24 REPLACE
MOVE DDM C< FM FNR 20 TO FNR 24
DELETE
|
DDM
|
name [with-clause] |
|
IN
where-clause
|
|
D DDM FINANCE IN DBID 12 FNR 27
LIST
|
DDM
|
name |
|
IN
where-clause
|
|
[with-clause] |
L DDM * IN DBID 1 FNR 5
[WHERE] [DBID
dbid] [FNR
fnr] [NAME
vsam-name] [CIPHER
cipher]
|
||||||||
|
|
|
|
|
password |
|
|||
[DIC
(dbid,fnr,password,cipher)]
|
||||||||
[SEC
(dbid,fnr,password,cipher)]
|
||||||||
Commas must be used as separators between the values following the
DIC and SEC keywords, or if a value is missing. For
example: DIC (10,,secret,2a). If the session parameter
ID (see ID -
Input Delimiter Character in the Parameter
Reference documentation) has been set to a comma, use a slash (/) as
the separator between values.
[WITH]
|
|
|
|
DDM-dbid |
|
|
|
|
DDM-fnr |
|
[REPLACE]
|
|
|
|
|
[HELP]
|
