All SYSMAIN functions except the find function can be performed on automatic and free rules.
If Predict is installed, we recommend that you use Predict instead of SYSMAIN for the processing of rules; Natural does not process all information on rules (for example, format and verification type) provided by Predict.
The rule 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 rules and the syntax that applies when using direct commands.
The Rules menu contains all SYSMAIN functions required for the processing of rules. 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 rule. | |
D |
Delete rule. | |
L |
List rule. | |
M |
Move rule. | |
R |
Rename rule. | |
| Sel. List | Specifies whether selective processing or automated processing is used: | |
Y |
Yes. Selective processing is activated. A selection list is displayed when processing rules. This is the default setting. For the columns and line commands available on a selection list, see Selection Lists for Rules. | |
N
|
No. Selective processing is deactivated. | |
| Name | The name of the rule to be processed or a range of names: see also Specifying a Range of Names. | |
| New Name | The name to be given to a rule when it is renamed with the rename function. | |
| Type | The type of rule to be processed: | |
A |
Only automatic rules are processed. | |
F |
Only free rules are processed. | |
AF, * or empty field
|
All rules are processed: automatic and/or free rules. This is the default setting. | |
| Database | The database ID (DBID) of a source or a target
database.
The source database contains the FDIC system file where the rule to be processed is stored. The target database contains the FDIC system file to which the rule is to be copied or moved, or where the rule is renamed. 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 rule to be processed. The target file is the file to which the rule is to be copied or moved, or where the rule is renamed. |
|
|
Name
|
Only applies to VSAM files.
The DDNAME/FCT entry for the source or target file number. |
|
| Replace | Specifies whether a rule is to be replaced when using the move, copy or rename function: | |
Y |
Yes. A rule with the same name which exists in the target environment is replaced. | |
N |
No. A rule with the same name which exists in the target environment is not replaced. This is the default setting. | |
| See also Using the Replace Option. | ||
If selective processing has been activated, a selection list of all rules 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 rule:
The following columns are displayed on a Selection screen:
| Column | Explanation |
|---|---|
| C | Input field for line commands (see below). |
| Rule Name | The name of the rule that meets the specified selection criteria. |
| Type | The type of rule: Free or Auto (Automatic)
rule.
|
| Ver. Type | The verification type: an attribute of the rule which is directly taken
from the verification as defined in Predict. A value of Unknown
indicates that there is no corresponding verification information in Predict
available. For valid values, see the Predict documentation.
|
| Format | The format type: an attribute of the rule which is directly taken from the
verification as defined in Predict. A value of Unknown indicates
that there is no corresponding verification information in Predict available.
For valid values, see the relevant Predict documentation.
|
| Message | The message which indicates the current processing status of a rule. For possible messages, see Status Messages. |
One of the following line commands can be entered in the C (Command) column of a Selection screen:
|
Line |
Function |
|---|---|
A
|
Process the specified rule. |
F
|
Only applies to automatic rules.
All DDMs and fields which have the specified rule assigned are displayed. |
H
|
Produce a hardcopy of the saved (source) object of a rule.
The source code of the specified rule is printed and listed on the screen. |
I
|
Display directory information of the rule.
This command is similar to
the system command |
L
|
Display the source code of a rule. |
This section shows the syntax that applies when performing a SYSMAIN function on rules 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:
|
|
|
RULE
|
name |
|
FM
where-clause
|
|
TO
where-clause [with-clause]
|
C RULE TESTRULE FM FNR 20 TO FNR 24 REPLACE
COPY R C< FM FNR 20 TO FNR 24
M RULE TESTRULE FM FNR 20 TO FNR 24 REPLACE
MOVE RULE C< FM FNR 20 TO FNR 24
DELETE
|
RULE
|
name [with-clause] |
|
IN
where-clause
|
|
D RULE DEMORULE IN DBID 12 FNR 27
LIST
|
RULE
|
name |
|
IN
where-clause
|
|
[with-clause] |
L RULE * DBID 1 FNR 5
RENAME
|
RULE
|
name |
AS
new-name
|
|
FM
where-clause
|
|
|
TO
where-clause
|
|
[with-clause] |
RENAME R OLDRULE AS NEWRULE FM DBID 1 FNR 4 TO DBID 1 FNR 5
R RULE OLDRULE AS NEWRULE FM FNR 4 TO FNR 5 REPLACE RCOP
[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] [TYPE
type] [REPLACE] [RCOP]
|
|
|
|
|
[HELP]
|