Importing Policy Database Data

Selecting option 1 (Import from PDB) on the Data Management Menu panel leads to the panel shown in Figure 1.

Figure 1. Policy Data Base Import Panel
    MENU  HELP                                                                   
 ------------------------------------------------------------------------------ 
 AOFGIMPP              Import entries from a Policy Database                    
 Option ===>                                                                    
                                                                                
   Current Policy Database              : BASE                                  
   Enterprise Name                      : BASE                                  
                                                                                
   1 Import Policy Data                                                         
            Source Policy Database. . . . IMPORT_DATABASE           (? or name)
            Entry type  . . . . . . . . . APL                       (? or type)
            Import linked entries . . . . NO                        (YES or NO)
                                          (applies to ENS, GRP, SYS, APG, APL, 
                                          TRG and DMN only) 
   2 View import report                                                         
This panel enables you to select entries in a policy database and add them to your current one, and view the import report for the target policy database. It has the following options:
1 Import Policy Data
This option allows you to define the following:
  • An existing policy database that data will be imported from.

    Entering a question mark (?) in this field and pressing Enter displays the Policy Database Selection panel where you can select one of the existing policy databases.

  • The particular entry type that selected entries will be imported for.

    Entering a question mark (?) in this field and pressing Enter displays the Entry Type Selection panel where you can select one of the existing entry types.

  • Whether you want to import entries that are linked to the entry type that you selected in the Entry type field.
    The following rules determine which linked entries are also imported, depending on the entry type that is imported:
    GRP
    Linked entry types SBG or SYS are also imported. For sysplex groups, any linked APG entry type of type SYSPLEX is imported.

    The links between resources where the group is involved are imported.

    SYS
    All entry types that are linked to the selected systems are imported along with the resources that belong to those systems and the links between the resources in the systems.
    APG
    Linked entry types APL, SVP, or TRG are also imported.
    APL
    If the application has an object type of CLASS, its instances and their service periods and triggers are imported.

    If the application has an object type of INSTANCE, the class application that it is linked to and its service periods and triggers are imported.

    TRG
    The entries of entry type EVT that are selected in its startup or shutdown conditions are imported along with it.
    DMN
    Linked entry types REF are also imported.

Importing entry type ENT (Enterprise) and MSG (Messages) is not supported.

2 View import report
This allows you to view the import report that is available in the target policy database. It invokes the ISPF VIEW function. If there is no import report, an empty screen is displayed.
The information that you specify here is saved in your ISPF profile data set and used as the initial values the next time you issue the import function.

Selecting 1 Import Policy Data on this panel takes you to a list of existing entries for the specified type (see Figure 2 for an example).

Figure 2. Entry Name Selection Panel for Import Policy Data
  COMMANDS  ACTIONS   HELP                                                               
 ------------------------------------------------------------------------------ 
 AOFGIMPS                     Entry Name Selection                Row 24 to 32 of 32 
 Command ===>                                                        SCROLL===> CSR

 Action     Status      Entry Name             Short Description 
            SELECTED    RRS                    Resource Recovery Services
                        SYSVAPPL               Automation Application 
                        SYSVIPLC               IPL Data Gatherer 
                        SYSVSSI                Automation Subsystem Interface
                        TCPIP                  TCP/IP 
                        TSO                    Time Sharing Option
 s                      VLF                    Virtual Lookaside Facility  
                        VTAM                   Virtual Telecommunication Access Method 
                        ZFS                    z/OS File System  

Here you can select entries that you want to:

  • Copy to your current policy database
  • Get a modified copy of for your current policy database
Making selections and pressing Enter takes you to the panel shown in Figure 3.
Figure 3. Selected Entry Names For Import Panel
    OPTIONS  ACTIONS  HELP                                                      
 ------------------------------------------------------------------------------ 
 AOFGIMP3             Selected Entry Names for Import         Row 1 to 3 of 3 
 Option ===>                                                  SCROLL===> CSR 
                                                                                
 1 Modify data        2 Check data         3 Run Import       4 View report     
                                                                                
 Action Entry Name           Type C D Short Description                         
        C APPL               APL  * Y Class for general APL definitions         
        RRS                  APL    Y Resource Recovery Services                
        VLF                  APL    Y Virtual Lookaside Facility                
The panel displays the entries that you selected with Entry Name, Entry Type and Short Description. For an application class, column C contains a *. If there is already an entry with the same name and type in the current policy database, it is marked as duplicate with a Y in column D.

This panel allows you to modify the selected entries before you import them. You can:

  • Rename entries in the list by:
    • Overtyping their names
    • Entering RENAME (R) in the Action field
  • Overtype an entry's Short Description field (this only affects non-duplicate entries).
  • Remove entries from the list by:
    • Blanking their names
    • Entering REMOVE (M) in the Action field
  • Locate an entry by entering LOCATE (L) at the command line.
  • Modify data using character string replacement by entering 1 or MODIFY (M) at the command line. This opens a Modify data pop-up window, as shown in Figure 4.
    Figure 4. Modify Data Pop-Up Window
    ┌────────────────────────────────────────────────────────┐
    │ AOFGPMOD  Modify data                            │
    │                                                  │ 
    │                                                  │
    │ Old string. . . . .                              │
    │                                                  │
    │ New string. . . . .                              │
    │                                                  │
    │ Press ENTER to modify import data.               │
    │ Press CANCEL to cancel modify.                   │
    │                                                  │
    └────────────────────────────────────────────────────────┘
    Type data in the Old string and New string fields.

    Replacement happens in a predefined set of fields in the import data. This set of fields supports the cloning of complete systems, for example, IMS, CICS®, or SAP solutions.

    You can update all relevant fields at once with a single modify action. This only works if the naming of a solution was done systematically (for example, consistently using an IMS subsystem ID of IMS1).

    The modification for certain fields is case-sensitive. For a complete list of modifiable fields (including whether data modification is case-sensitive) see the online help.

    Note: No checks are made to prevent &AOCCLONE variables that are used in fields being modified.
  • Check the data that is to be imported by entering 2 or CHECK (K) at the command line.

    This executes an integrity check of the data and links to be imported so that there are no conflicts with definitions in the current policy database. Error messages for any conflicting data properties that are detected are listed in the import report. An import is not carried out.

  • Start the import process by entering 3 or RUN (R) at the command line.

    This executes the same data integrity check as with option 2 and, if no conflicts are found, imports the data into the current policy database.

  • View the import report by entering 4 or VIEW (V) at the command line.

    This allows you to view the most recent import or data check report that is available in the current policy database. It invokes the ISPF VIEW function. If there is no import report, an empty screen is displayed.

  • Return to the Entry Name Selection panel by pressing the END or PF3 key.
  • Go to the Data Management panel by entering CANCEL (C) at the command line.