NDVRDLVR Command Syntax

Promotion Support Facilities › NDVRDLVR Definition Delivery › NDVRDLVR Command Syntax

NDVRDLVR Command Syntax

►►────── SIGnon ──┬─────────────────────────────────┬────────────────────────►
                  ├─ DBNAme ──────┬── is dictname ──┘
                  └─ DICtName ────┘

 ►────┬─────────────────────────┬───┬──────────────────────────┬─────────────►
      └─ USEr name is user-id ──┘   └─ PASsword is password ───┘

 ►───────────┬────────────────────────────────────────┬────────── . ─────────►◄
             └─ CCId name is ───┬─────── ccid ────────┤
                                │                     │
                                │     ┌─── , ───┐     │ 
                                └─ ( ─▼─ ccid ──┴─ ) ─┘

►►────────┬──────────────────────────────────────────────────────────────────►
          └─┬── IDMs ───────┬─────┬─────────────────────────────────┬────────
            ├── TARget ─────┤     └── USEr name is dc-user-name ────┘
            └── SOUrce ─────┘

 ►────────────────────────────────────────────────────────────┬──────────────►◄
  ────────┬────────────────────────────────┬─── . ────────────┘
          └── PASsword is dc-password ─────┘

►►──────┬─────────────────────────────────────────────────────────────┬──────►◄
        └─ TAG with CLAss class-name ATTribute attribute-name ─── . ──┘

►►────────┬───────────────────────────────────────────────┬──────────────────►◄
          └─ EXPort ───┬─── SOUrce ───────┬─ form ── . ───┘
                       └─── EXEcutable ───┘

►►────────┬────────────────────────────────────────┬─────────────────────────►◄
          └─ MODe is ───┬─────────────────┬── . ───┘
                        ├─── EXEcute ◄────┤
                        └─── BACkoff ─────┘

►►─┬────────────────────────────────────────────────────────────────────┬────►◄
   │ ┌───────────────────────────────────────────────────────────────┐  │
   └─▼─ SET ─┬── SOUrce IDMsdddl SESsion ─┬─ OPTions options ──── . ─┴──┘
             ├── SOUrce IDMsdddl RECord ──┤
             ├── SOUrce IDMsdddl ELEment ─┤
             ├── SOUrce SCHema ───────────┤
             ├── SOUrce SUBschema ────────┤
             ├── SOUrce RHDcmput PROcess ─┤
             ├── TARget IDMsdddl SESsion ─┤
             └── TARget RHDcmput PROcess ─┘

Note: The option text referred to in the syntax above identifies option values that are not validated by CA Endevor/DB. When the option values are specified, CA Endevor/DB simply inserts them into the appropriate CA IDMS compiler command. Also, if a SET OPTIONS command is repeated, only the last one specified will be used.

SIGNON

The SIGNON command identifies the user responsible for the migration and optional password and CCID list. If no CCID list is specified, the default CCIDs for the user are assigned from the CCDB.

Note: For this utility to operate, the user must be authorized in the Security Class for MIGRATE=Y and (optionally) NM-MODE=Y if TAG is selected.

IDMS USER

The IDMS command is used to specify the IDD USER and (optionally) PASSWORD information used to access the migration dictionaries. The IDMS USER statement and the SOURCE/TARGET USER statements are mutually exclusive: if you specify IDMS USER, you cannot specify either SOURCE or TARGET USER. If you specify either the SOURCE or TARGET USER command, you cannot specify the IDMS USER command. If you specify the IDMS USER command, the user and password on that command will be used for the dictionary processing at both the source and target dictionaries. If omitted, you may specify either SOURCE and/or TARGET USER commands. If you specify none of these, no CA IDMS user identification will be used at either the target or the source dictionaries.

SOURCE USER

The SOURCE command is used to specify the IDD USER and (optionally) PASSWORD information used to access the source dictionary. The SOURCE USER statement and the IDMS USER statements are mutually exclusive: if you specify SOURCE USER, you cannot specify IDMS USER. Likewise, if you specify the IDMS USER command, you cannot specify the SOURCE USER command. You may specify or omit the TARGET USER command if you specify SOURCE USER. The SOURCE USER command must be used when a source IDD user name is needed and either a different or no target IDD user name is needed.

TARGET USER

The TARGET command is used to specify the IDD USER and (optionally) PASSWORD information used to access the target dictionary. The TARGET USER statement and the IDMS USER statements are mutually exclusive: if you specify TARGET USER, you cannot specify IDMS USER. Likewise, if you specify the IDMS USER command, you cannot specify the TARGET USER command. You may specify or omit the SOURCE USER command if you specify TARGET USER. The TARGET USER command must be used when a target IDD user name is needed and either a different or no source IDD user name is needed.

TAG

The TAG command is used to instruct NDVRDLVR to build a CLASS and ATTRIBUTE structure to tag the entities contained in the NDVRENI file.

EXPORT

The EXPORT command causes NDVRDLVR to extract the entities contained in the NDVRENI file from the source dictionary. Two mutually exclusive options are available:

EXECUTABLE FORM -- whenever possible, only LOAD MODULES for entities will be extracted from the dictionary. See the "NDVRDLVR Output Files" section for a description of generated output.
SOURCE FORM -- whenever possible, source descriptions of the entities will be extracted for regeneration on the target system. See the "NDVRDLVR Output Files" section for a description of generated output.

MODE

The MODE command determines whether to add CLASS/ATTRIBUTE relationships or remove them. To create a CLASS/ATTRIBUTE relationship on each entity in the NDVRENI file list, run with MODE = EXECUTE. To reverse the effects of a prior run, run the same NDVRENI file back into NDVRDLVR with MODE = BACKOFF. Only the CLASS/ATTRIBUTE relationships are deleted by BACKOFF. If TAG has not been run, there is nothing to back-off.

SET SOURCE IDMSDDDL SESSION OPTIONS

This command allows changes to the default session options used by CA Endevor/DB for the source dictionary. CA Endevor/DB sets the source IDMSDDDL session options using the following DDDL command:

SET SESSION OPTIONS
QUOTE IS '
INPUT 1 THRU 72 OUTPUT 80
DISPLAY AS SYNTAX VERB REPLACE
WITH DETAILS MODULE SOURCE PICTURE OVERRIDES SYNONYMS
ATTRIBUTES ALL COMMENT TYPES.

These options may be overridden or added to by specifying the SET SOURCE IDMSDDDL SESSION OPTIONS command. For example, the command:

SET SOURCE IDMSDDDL SESSION OPTIONS REGISTRATION OVERRIDE.

causes a second DDDL SET SESSION OPTIONS command to be used, which turns off entity occurrence security.

Refer to the CA IDMS IDD DDDL Reference Guide for a full discussion of DDDL session options.

SET SOURCE IDMSDDDL RECORD OPTIONS

This command allows changes to the default punch record options specified by CA Endevor/DB when punching record definitions from the source dictionary. CA Endevor/DB sets the following options by default when punching record definitions from the source dictionary.

PUNCH RECORD record-name VERSION version-nr ALSO
WITH FILES ELEMENTS SUBORDINATE ELEMENTS.

Note that the 'ALSO WITH' indicates that these options are to be added to the source IDMSDDDL session options.

The punch record options can be overridden by specifying the SET SOURCE IDMSDDDL RECORD OPTIONS command. If you specify any options here, you must specify them all. The option text specified must begin with the 'ALSO WITH' or 'WITHOUT' or 'WITH' text. For example, the command:

SET SOURCE IDMSDDDL RECORD OPTIONS ALSO WITH OLQ HEADERS.

includes OLQ headers in the punched record output.

With this command, following punch record command is issued:

PUNCH RECORD record-name VERSION version-nr ALSO WITH
OLQ HEADERS.

Refer to the CA IDMS IDD DDDL Reference Guide for a full discussion of DDDL PUNCH RECORD options.

SET SOURCE IDMSDDDL ELEMENT OPTIONS

This command allows changes to the default options specified by CA Endevor/DB when punching element definitions from the source dictionary. CA Endevor/DB sets the following options by default when punching element definitions from the source dictionary:

PUNCH ELEMENT element-name VERSION version-nr.

The element options can be overridden by specifying the SET SOURCE IDMSDDDL ELEMENT OPTIONS command. If you specify any options here, you must specify them all. The options text specified must begin with the 'ALSO WITH' or 'WITH' or 'WITHOUT' text. For example, the command:

SET SOURCE IDMSDDDL ELEMENT OPTIONS WITHOUT SYNONYMS.

excludes element synonyms from the punched element output.

With this command, the following punch element command is issued:

PUNCH ELEMENT element-name VERSION version-nr
WITHOUT SYNONYMS.

Refer to the CA IDMS IDD DDDL Reference Guide for a full discussion of DDDL PUNCH ELEMENT options.

SET TARGET IDMSDDDL SESSION OPTIONS

This command allows changes to the default session options used by CA Endevor/DB for the target dictionary.

CA Endevor/DB sets the following target IDMSDDDL session options:

QUOTE IS ' DEFAULT IS ON INPUT 1 THRU 72 OUTPUT 80

These options can be overridden or added to by specifying the SET TARGET IDMSDDDL SESSION OPTIONS command. For example, the command:

SET TARGET IDMSDDDL SESSION OPTIONS DECIMAL-POINT IS COMMA.

establishes the comma (,) as the default decimal-point character.

Refer to the CA IDMS IDD DDDL Reference Guide for a full discussion of DDDL session options.

SET SOURCE SCHEMA OPTIONS

This command allows changes to the default options specified by CA Endevor/DB when punching schema definitions from the source dictionary.

CA Endevor/DB sets the following options by default when punching schema definitions from the source dictionary:

PUNCH SCHEMAschema-id VERSION version-nr.

The punch schema options can be overridden by specifying the SET SOURCE SCHEMA OPTIONS command. If you specify any options here, you must specify them all. The options text specified must begin with 'ALSO WITH', 'WITHOUT', or 'WITH' text. For example, the command:

SET SOURCE SCHEMA OPTIONS ALSO WITH HISTORY.

includes all history associated with the schema.

With this command, the following punch schema command is issued:

PUNCH SCHEMA schema-id VERSION version-nr ALSO WITH HISTORY.

Refer to the CA IDMS Database Administration Guide for a full discussion of PUNCH SCHEMA options.

SET SOURCE SUBSCHEMA OPTIONS

This command allows changes to the default options specified by CA Endevor/DB when punching subschema definitions from the source dictionary.

CA Endevor/DB sets the following options by default when punching subschema definitions from the source dictionary:

PUNCH SUBSCHEMA subschema-id.

The punch subschema options can be overridden by specifying the SET SOURCE SUBSCHEMA OPTIONS command. If you specify any options here, you must specify them all. The options text specified must begin with the 'ALSO WITH' or 'WITHOUT' or 'WITH' text. For example, the command:

SET SOURCE SUBSCHEMA OPTIONS ALSO WITH HISTORY.

includes the date and time the subschema was created or last modified.

With this command, the following punch subschema command is issued:

PUNCH SUBSCHEMA subschema-id ALSO WITH HISTORY.

Refer to the CA IDMS Database Administration Guide for a full discussion of PUNCH SUBSCHEMA options.

SET SOURCE RHDCMPUT OPTIONS

This command allows changes to the default RHDCMPUT process options used by CA Endevor/DB for the source dictionary. By default, the following process options are set:

PROCESS=TERSE

This option can be overridden by specifying the SET SOURCE RHDCMPUT PROCESS OPTIONS command. For example, the command:

SET SOURCE RHDCMPUT PROCESS OPTIONS PROCESS=TERSE,DATETIME=YES.

produces the syntax to define a map in terse form with the date/time stamp preserved.

Refer to the CA IDMS Mapping Facility Guide for a full discussion of RHDCMPUT PROCESS options.

TARGET RHDCMPUT OPTIONS

This command allows changes to the default RHDCMPUT process options used by CA Endevor/DB for the target dictionary. By default, the following process options are set:

PROCESS=LOAD

This option can be overridden by specifying the SET TARGET RHDCMPUT PROCESS OPTIONS command. For example, the command:

SET TARGET RHDCMPUT PROCESS OPTIONS PROCESS=LOAD,REPORT.

includes a report of all maps generated.

Refer to the CA IDMS Mapping Facility Guide for a full discussion of RHDCMPUT process options.