FILEMAINT Mode - FILE Structure Maintenance › Transfer a Substructure

Transfer a Substructure

Use the TRANSFER function 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 FILEMAINT Mode for the TEST status of the RECORD substructures.

How to Use

Use one of the following procedures to perform this function:

• Select the TRANSFER option on the Structure Functions Menu for the selected structure, fill in the following prompter panel, and press Enter.
• Use the TRANSFER command (see TRANSFER) for the structure.
• Type the TRA (TRN or XFR) margin command in the line number of the occurrence on a structure or index display panel, enter the PROCESS command (press PF4), and press PF9 (APPLY).

When you select the TRANSFER function on the Record Structure Functions Menu, you receive a prompter panel similar to the following example. Press PF9 (APPLY) after completing your entries. If there are no errors, CA Datacom Datadictionary displays a message confirming successful completion of this function.

 =>
 =>
 =>
 1-DDOL000196A - CMPP - PLEASE COMPLETE REQUIRED INFORMATION FOR COMMAND
 ------------------------------------------------------------------------------
 FILE Structure Maintenance
                                                                           TTCF
 TRANSFER RECORD   ________________________________
 TRAN     REC      (name)

 TO  FILE     ________________________________ in STATUS ____
 TO  FIL      (name)                              STAT  (status)

 with PASSWORD      using OVERRIDE
      PSWD    (pswd)      OVRD    (ovrd)






 PF1=HELP  PF2=END  PF3=CLARIFY  PF4=PROCESS  PF5=MENU   PF6=STATUS
 PF7=SCB   PF8=SCF  PF9=APPLY    PF10=PATH    PF11=NEXT  PF12=INPUT

RECORD (name)

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

Valid Entries:

1- to 32-character occurrence name

Default Value:

(No default)

FILE (name)

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

Valid Entries:

1- to 32-character occurrence name

(status)

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

Valid Entries:

T001—T999

Default Value:

(No default)

(pswd)

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

Valid Entries:

1- to 4-character password

Default Value:

(No default)

(ovrd)

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)