Reporting Facility Commands › COPYDD Command

COPYDD Command

(Area 2A)

The COPY command provides an interface between the Reporting Facility and CA Datacom Datadictionary to achieve consistent definition of frequently referenced elements stored on the CA Datacom Datadictionary. You can use this command during the compile phase to dynamically include one element definition directly behind that COPYDD command.

The Reporting Facility assigns attributes and calculates the displacement of each field presented by CA Datacom Datadictionary. The system can then reference these fields in other Reporting Facility commands by specifying the generated field names on the DEFINE commands.

You can reference element definitions that belong to either CA Datacom/DB tables or non-database files (VSAM or tape). When multiple occurrences of the same element definition are contained in the dictionary, you can specify the version number of the definition desired (001 through 999) or the CA Datacom Datadictionary defined status of the element (PROD, TEST, or HIST).

Additionally, you can instruct the Reporting Facility to generate DEFINE commands with specific field names contained within the CA Datacom Datadictionary, that is, the Assembler or COBOL labels or the CA Datacom Datadictionary entity-occurrence names.

The format of the COPYDD command is:

►►─ COPYDD ─┬─ record-name ─┬─ element-name ─┬─ version ─┬────────────────────►
            └─ table-name ──┘                └─ status ──┘

 ►─┬────────────────────┬─────────────────────────────────────────────────────►◄
   └─ USE ─ label-type ─┘

record-name or table-name

Specifies the CA Datacom Datadictionary entity-occurrence name of the record or table to which the element being requested is associated. It is 1—32 characters long.

element-name

Specifies the CA Datacom Datadictionary entity-occurrence name of the element for which definition is requested. It is 1—32 characters long.

Note: For partitioned tables, you must use the table and element names for the full parent table, not one of the child (table partition) tables.

version

Indicates a version number of the element to be accessed. Valid entries are 1—999.

status

Indicates the generic CA Datacom Datadictionary status of the element to be accessed. The system uses the first entity-occurrence found with a matching status. Valid entries are PROD, TEST, and HIST.

label type

Indicates which label CA Datacom Datadictionary is to use when generating field names on the Reporting Facility DEFINE commands. The default is COMPILER.

The following list contains all valid label entries:

Assembler Label

ASSEMBLER
ASM

PL/I Label

PL1
PLI

Compiler Label

COMPILER
COM
COBOL
COB

Entity Label

ENTITY
ENT

Note the following:

• You can use multiple COPYDD commands to define a single file, one per element being accessed.
• When you are defining elements for a CA Datacom/DB table, the physical order of the COPYDD commands must correspond to the order of the CA Datacom/DB element list specified when a GET command is issued to the file.
• COPYDD commands cannot appear in cataloged library members.
• A FILE command, DEFINE command, or another COPYDD command must precede a COPYDD command.