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 |
|
||||||||||||||
Sel. List |
|
||||||||||||||
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 |
|
||||||||||||||
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 |
|
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 ]
|