TRANSFER

Use the TRANSFER command to remove the relationship of an occurrence from one subject and relate it to another subject. The occurrence receiving the transfer must be in the same status as the occurrence you are transferring.

You can use this function in DBMAINT Mode for the TEST status of the AREA and TABLE substructures and in FILEMAINT Mode for a RECORD substructure.

Use the following format for this command:

Note: If your completed command exceeds the 76 spaces available in one command line, use the prompter panel to issue the command.

►►─┬─ TRANSFER ─┬─ entity1 ─ occ-name1 ─ TO ─ entity2 ─ occ-name2 ────────────►
   └─ TRAN ─────┘

 ►─┬─ STATUS xxxx ─┬─┬─────────────────┬─┬─────────────────┬──────────────────►◄
   └─ STA xxxx ────┘ ├─ PASSWORD xxxx ─┤ ├─ OVERRIDE xxxx ─┤
                     └─ PSWD xxxx ─────┘ └─ OVRD xxxx ─────┘

entity1

(Required) Specify the entity of the occurrence to be the object of the transfer.

entity2

(Required) Specify the entity for the occurrence to be the subject of the transfer.

Valid Entries in DBMAINT Mode:

AREA|ARA: DATABASE|BAS
TABLE|TBL: AREA|ARA

Valid Entries in FILEMAINT Mode:

RECORD|REC.: FILE|FIL
Default Value:: (No default)

occ-name1

(Required) Specify the occurrence name of the occurrence to be the object of the transfer.

Valid Entries:: 1- to 32-character occurrence name
Default Value:: (No default)

occ-name2

(Required) Specify the occurrence name of the occurrence to be the subject of the transfer.

Valid Entries:: 1- to 32-character occurrence name
Default Value:: (No default)

STA xxxx

(Required) Specify the status of both the subject and the object of the transfer.

Valid Entries:: T001—T999
Default Value:: (No default)

PSWD xxxx

Only required if this occurrence has password protection against unauthorized maintenance. Supply the password for this occurrence.

Valid Entries:: 1- to 4-character password
Default Value:: (No default)

OVRD xxxx

Only required if this occurrence is restricted from unauthorized maintenance or retrieval with a lock level assignment. Supply the override code.

Valid Entries:: 1- to 4-character override code
Default Value:: (No default)

When you press PF9 (APPLY), CA Datacom Datadictionary responds with a message confirming completion of the function.