Restore Structures

FILEMAINT Mode - FILE Structure Maintenance › Restore Structures

Restore Structures

Use the RESTORE function to replicate a structure or substructure that is in PROD or HIST status to a TEST status. Only use this function with structures or substructures that are in PROD status or HIST status.

You can use the RESTORE function against FILE, RECORD, and DATAVIEW structures and substructures. KEY and ELEMENT substructures must be restored by restoring the entire RECORD substructure.

Important! We recommend that you restore the structure or substructure from PROD status immediately before you change it to avoid any loss of information.

How It Works

You can use the date/time stamp (ASOF) to construct a TEST version of what your PROD or HIST status version looked like on that day. Using the date/time stamp, you can determine which structures were in PROD status at a given time and re-create the structure or substructure in the specified TEST status. If you want to restore a HIST version to PROD, first restore it to TEST and then copy it to PROD status.

Note: If your time value includes seconds, round up to the nearest minute.

When you restore a TEST structure or substructure, the existing structure or substructure is entirely replaced by the structure or substructure from which it is being restored. Any occurrences or relationships are deleted or added as necessary to make the restored structure or substructure the same as the one from which it is being restored.

Required Definitions: If you are restoring a RECORD substructure, the parent entity-occurrence definition must exist in the same version to which you are restoring the occurrence. For example, if you are restoring a RECORD substructure to T001 status, the FILE entity-occurrence definition for that RECORD must exist in T001 status for the RESTORE to be successful.
From History Status: When you restore a structure or substructure from HIST status, CA Datacom Datadictionary cannot complete the process if any of the related occurrences have been deleted due to exceeding the maximum number of allowed HIST versions. CA Datacom Datadictionary returns an error message if the structure is incomplete due to deleted occurrences of this type.
Relationships

If the structure contains relationships with occurrences outside the structure, the relationships may not be restored with the structure or substructure. The copy-rule specified for the relationship determines whether the relationship is restored. For more information about relationship copy-rules, see the CA Datacom Datadictionary User Guide.

How to Use:

You can restore a structure by using one of the following procedures:

Select the RESTORE option on the Structure Functions Menu for the selected structure, fill in the following prompter panel, and press Enter.
Enter the RESTORE command (see RESTORE) for the structure and press PF9 (APPLY).
When you select the RESTORE function on the File Structure Functions panel, 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 responds with a message confirming successful completion of the function.

 =>
 =>
 =>
 1-DDOL000196A - CMPP - PLEASE COMPLETE REQUIRED INFORMATION FOR COMMAND
 -------------------------------------------------------------------------------
 FILE Structure Maintenance
                                                                            TRCF
 RESTORE FILE     ________________________________ to STATUS ____
 RES     FIL      (name)                              STAT  (stat)


 FROM STATUS ____ AS OF ____________
      STAT  (stat)     (YYYYMMDDhhmm)


 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

The following list describes each field, the valid entries, and the default (if one exists). Fields that require an entry are highlighted on your terminal. Fields which are not highlighted indicate that an entry is optional.

(name)

(Required) Specify the name of the root or base occurrence of the structure or substructure you are restoring.

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

to (stat)

(Required) Specify the status of the occurrence to which you are restoring.

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

FROM (stat)

(Required) Specify the status of the occurrence from which you are restoring.

Valid Entries:

PROD

1—999
H000—H997

ASOF (if you want to use the AS OF option)

Default Value:

(No default)

AS OF (YYYYMMDDhhmm)

(Optional) If you enter ASOF in the status field, specify the date/time stamp to display the version of the structure that was in PROD status at that date and time. You can specify the full date and time or a partial date, such as 201001 for the year and month or 20100131 for the year, month, and day.

Note: If your time value includes seconds, round up to the nearest minute.

Valid Entries:: 1 to 12 digits
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)