Previous Topic: LOCATE StatementNext Topic: PROCESS Statement


Notations Conventions and Syntax Rules

Be sure to review Exhibit 2.1 for notation conventions and Exhibit 2.2 for parameter syntax rules. Also, review the "Glossary" for the meanings of terms used in this guide.

Example

 

PROCESS

Keywords appear in UPPERCASE.

The minimum required portion of each keyword is UNDERSCORED. If a portion of or an entire keyword is not underscored, you can omit that portion or that keyword.

,SUBSCHEMA=name

Variables appear in lowercase italics. You must substitute an appropriate value for each variable.

[,VERSION=number]

Brackets indicate optional clauses.

/ \
PROCESS = < SCHEMA >
\ SUBSCHEMA /

Braces enclose two or more options. You must select one of them.

,field name ...

An ellipsis indicates that a variable number of field names can be specified, separated by commas.

Exhibit 2.1: Notation Conventions

Item

Explanation

Order of Parameter Statements

CA IDMS Schema Mapper executes parameter statements in the order they are supplied. Only the PROCESS statement is mandatory. Enter the parameter statements in this sequence:

PROCESS--This mandatory statement must be the first statement entered.

OPTIONS--If you want to use OPTIONS parameters enter this statement second.

CHARDEF statements follow the OPTIONS statement to control the graphic components of the data structure diagram.

If DRECLINE and XRECLINE statements are both used, DRECLINE statements must precede XRECLINE statements.

If DSETLINE and XSETLINE statements are both used, DSETLINE statements must precede XSETLINE statements.

INCLUDE statements follow OPTIONS, CHARDEF, DRECLINE, XRECLINE, DSETLINE, and XSETLINE statements and precede all LOCATE statements.

LOCATE statements are entered last.

Continuing a Parameter Statement

To continue a parameter statement onto the next record, key in a trailing comma. Do not split a keyword phrase between two records. LOCATE statements must be self-contained in individual records.

Entering Blanks In Parameter Statements

You can enter blanks (character spaces) to separate keywords and improve readability in a parameter statement without affecting processing. Do not, however, embed blanks within a keyword or value field.

Entering Parameter Statements

On an 80-character input record, you must enter all parameter syntax between positions 1 and 72, inclusive.

Comments

Enter a dollar sign ($) or an asterisk (*) before a comment, in column 1, to indicate that you want the command copied to the resulting Transfer File. Enter three dollar signs or three asterisks in columns 1-3 to indicate a comment that you do not want copied to the Transfer File (to be discarded by CA IDMS Schema Mapper).

Exhibit 2.2: Parameter Syntax Rules

          / SCHEMA    \ [,SCHEMA=name]    [,DICTNAME=name] [,COMPNAME=name] [,DCOMNAME=name]
 PROCESS= < SUBSCHEMA > [,VERSION=number] [,COMPNAME=name] [,DCOMNAME=name]
          \ LIST      / [,SUBSCHEMA=name] [,DICTNODE=name] [,COMPNAME=name] [,DCOMNAME=name]

 OPTIONS [,IXCORNER= < 2 > ]
                     \ 4 /

         [,DPAGELEN=number]  [,DPAGEWID=number]

         [,DPEJECT= < ON  > ] [,BORDER=number]
                    \ OFF /

         [,COMPRESS= < ON  > ] [,LINKAGE= < XREF     > ]
                     \ OFF /              \ SUPPRESS /

 CHARDEF [,RVERCHAR=character]  [,RHORCHAR=character]

         [,RULCHAR=character]  [,RLLCHAR=character]

         [,RURCHAR=character]  [,RLRCHAR=character]

         [,SVERCHAR=character] [,SHORCHAR=character]

         [,SULCHAR=character]  [,SLLCHAR=character]

         [,SURCHAR=character]  [,SLRCHAR=character]

         [,BRKTCHAR=character] [,LARROW=character]

         [,RARROW=character]   [,UARROW=character]

         [,DARROW=character]   [,IBAKCHAR=character]

         [,ISLACHAR=character]

 [DRECLINE field name,field name...]

 [XRECLINE field name,field name...]

 [DSETLINE field name,field name...]

 [XSETLINE field name,field name...]

 [INCLUDE AREA area name...]

 ┌              ┌┌                  ┐┌                 ┐            ┐┐
 | LOCATE name1 || < LEFT  > number || < UP   > number | FROM name2 ||
 └              └└ \ RIGHT /        ┘└ \ DOWN /        ┘            ┘┘

Exhibit 2.3: CA IDMS Schema Mapper Parameter Summary