Export Directory Objects

To export the Optim™ Directory objects to a sequential file, use Option 1 on the Upgrade panel. This option allows you to backup the Directory before it is upgraded and identify errors in the Directory before they are propagated to the new release.

Note: Before exporting, you must disable Optim™ security under your current installation of Optim™.

Use the Summary File Name to identify errors in the Directory. If errors exist, you can correct them in the Export File (Output Dataset) or correct them in the Directory and run the Export Process again. For information about importing objects into the Directory, see Use the Import Process section in the Common Elements Manual.

Figure 1. Export Directory Objects
---------------------  Export Optim Directory Objects ------------------------
OPTION  ===>

The following objects will be exported from the Optim directory:

    AD - Access Definitions          PK - Primary Keys
    R  - Relationships,              TM - Table Maps
    CD - Compare Definitions         CM - Column Maps
    ED - Environment Definitions     RD - Retrieval Definitions
    LT - Legacy Tables              

 This task must be performed using the load library and plan
 bound with the prior release from which you are upgrading.

 Load Library Name     ===>                             
 Plan Name             ===> 
 Output Dataset        ===>                        
 Dataset Disposition   ===> O   (M-Mod, O-Old)
 Enter Directory Report File Name or Leave Blank for SYSOUT *
 Dir Report File Name  ===>                                               
 Enter Report File Name or Leave Blank for SYSOUT *
 Report File Name  ===>                                               
 Enter Summary Report File Name or Leave Blank for SYSOUT *
 Summary File Name     ===>                                              
 On Export Error       ===> S   (C-Continue, S-Stop) 
(Selecting 'C' will allow the upgrade process to continue if errors 
 are encountered during the EXPORT process.  Use this option carefully.)
Load Library Name
Fully qualified name of the load library used by the release you are upgrading from.
Plan Name
The plan name you are upgrading from.
Output Dataset
The name of a sequential data set for the exported objects--the Export File.
Dataset Disposition
Placement of exported objects copied to an existing data set. Specify:
  • M for MOD. The object data is appended to the data set. Note that this does not apply to PDS member output.
  • O for OLD. The contents of the data set are replaced.
Dir Report File Name
The name of a sequential data set that lists all exported objects. If you leave this prompt blank, the output is directed to a SYSOUT class, and you can use an output processor, such as SDSF, to display and print it.
Report File Name
The name of a sequential data set that lists general error information. If you leave this prompt blank, the output is directed to a SYSOUT class, and you can use an output processor, such as SDSF, to display and print it.
Summary File Name
The name of a sequential data set that lists the processed EXPORT syntax along with errors. If you leave this prompt blank, the output is directed to a SYSOUT class, and you can use an output processor, such as SDSF, to display and print it.
On Export Error
Indicator for whether the EXPORT process should continue if an error is encountered within a directory table. Specify:
  • C for Continue. The EXPORT process will continue and subsequent directory tables will be processed.
    Note: Use this option carefully as objects reported to be in error will not be exported.
  • S for Stop. The EXPORT process will terminate and subsequent directory tables will not be processed.

When you run the Export, the batch syntax for the Export Process is reproduced in the Process Report; for example:


ERROR CONT
EXPORT TYPE ALL SUBDEF YES NAME %
SECURITY_VIOLATION WARN

See the Batch Utilities Guide for a detailed explanation of this syntax.