Predict Generation Defaults

This document covers the following topics:


Sets of Generation Defaults

When PAC is initialized, a set of Predict generation defaults called "DEFAULTS" is automatically defined for use with migrations of Predict data into PAC.

Additionally, the PAC administrator may copy and store different sets of Predict generation defaults from Predict and may assign to each a specific name for use with migrations of Predict data into PAC.

The defaults to be used with a Predict migration event can be specified during authorization by entering the appropriate name of the defaults set previously saved.

If no defaults set is specified for a migration of Predict data into PAC, the default set DEFAULTS is used.

Note:
Note: If the DEFAULTS set is not found or if the specified set is not found, error 7012 is returned, indicating the defaults set that could not be located; the migration terminates at the generation step.

Linked Databases

Generation defaults for Adabas files have up to ten (10) databases to which files may be linked. On the Copy View Defaults screen, the Adabas Subsystem Specification DB-ID parameter determines whether a linked database is required. (This means that the generated DDM will not be assigned a DBnr.)

If the DB-ID=N is set in the stored generation defaults of Predict, a DDM with DBnr=0 is generated, even if the file is linked to several databases.

If DB-ID=Y is set in the stored generation defaults, Adabas files can be linked to databases. Note the following:

  • Where no database is linked, the generation aborts and error 2047 is returned.

  • Where one database is linked, PAC generates the view/DDM, using this database. The resulting DDM will have this database Dbnr.

  • Where several databases are linked, PAC determines the database as follows:

    • If the file is linked to one or more databases in the object list of the event, PAC takes the first database in alphabetical order.

    • If the file is linked to one or more databases in the generation defaults, PAC takes the database from there. A database can be specified for each event for which the generation defaults set is used. PAC checks sequentially to determine whether the userview is linked to a database. The first database found with a link to the userview is selected for the generation.

PAC User Exit PACEX037

If the user exit PACEX037 is active, PAC invokes the exit before the generation command is built in order to determine the linked database to be used for the DDM generation. If no linked database is found or DBID=N is set, a blank is passed to the exit. The user exit may then verify, override, or reset the linked database name.

Predict Generation Defaults

From the Predict Generation Defaults menu, you can copy, display, purge, or select Predict userview generation defaults; and modify the list of linked databases.

From the General Defaults menu, enter Code G (Predict Generation Defaults).

The Predict Generation Defaults menu appears:

  17:54:00          ***** PREDICT APPLICATION CONTROL *****             2000-04-20
  User SAGU             - Predict Generation Defaults -                         
                                                                                
                    Code  Sub-Function                                          
                    ----  --------------------------------------                
                      C   Copy Generation Defaults from Predict                 
                      D   Display Generation Defaults                           
                      M   Modify Linked Databases List                          
                      P   Purge Generation Defaults                             
                      S   Select Generation Defaults from a List                
                      ?   Help                                                  
                      .   Exit                                                  
                    ----  --------------------------------------                
                                                                                
    Code ............ _                                                         
    Defaults name ... ________                                                  
    Predict DBnr .... 222 Fnr ... 153                                           
    Replace ......... N                                                         
                                                                                
                                                                                
 Command ===>                                                                   
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Exit                                                  Canc

In addition to the Code field, the following input fields are available for processing generation defaults:

Input Field Description

Defaults Name Name of the set of generation defaults. The name can be 1 to 8 characters long and have any combination of characters.
Predict DBnr/Fnr Database number (DBnr) and file number (Fnr) of the Predict (FDIC) file from which the new defaults are to be copied.
Replace Used with subfunction code C (Copy Generation Defaults from Predict). If a set of generation defaults already exists with the specified name:
N (Default): The existing set is not replaced;
Y: the existing set is replaced.

Copying Predict Generation Defaults from Predict

You can copy the Predict generation defaults in your FDIC file to the PCF system file.

The generation defaults, as they are currently defined in the referenced FDIC, file will be copied.

Note:
The values for these are not modifiable in PAC. To change the options, you must change the values in Predict, then copy the defaults into PAC.

The following are forced defaults for the DDM generation defaults.

Parameter Default

General comments Y
Short comments Value is variable, independent of what is set in Predict
List verification Y
Generate UDFs Y
List UDFs Y
List related maps Y
List generated code Y

Start of instruction set To copy Predict generation defaults:

  1. Enter Code C (Copy Generation Defaults) and a name for the Predict userview generation defaults to be copied.

    The Copy View Defaults screen appears, displaying the Predict userview generation defaults to be copied:

    19:08:59          ***** PREDICT APPLICATION CONTROL *****           2000-04-20
      User SAGU                  - Copy View Defaults -                             
                                                                                    
      Generation Defaults ..... DFL00002                                            
      Overwrite option ........ Y  (Y,N)    Adabas Subsystem                        
      List generated code ..... N  (Y,N)      Use ADASTAR access-nr .... N          
      Adabas version .......... I3            Specification DB ID ...... N          
                                            DB2 Subsystem                           
                                              Truncate creator ......... N   (Y,N)  
      Field name prefix .......                                                     
      Line comments ........... N  (Y,N,O)  IMS Subsystem                           
      General comments ........ Y  (Y,N)      Generate UDFs ............ N   (Y,N)  
      Short comments .......... 3  (0-16)     Replace UDFs ............. Y   (Y,N)  
      Generate verif. rules ... Y  (Y,N)      List UDFs ................ N   (Y,N)  
      Replace verif. rules .... Y  (Y,N,S)    IMS field suffix ......... N   (Y,N)  
      List verif. rules ....... Y  (Y,N)    Natural Subsystems                      
                                              Generate security ........ N   (Y,N)  
      VSAM trailing BLANK char ...            Super Natural file opt ... N   (Y,N)  
                                              Super Natural file DBNR ..     (0-254)
      Linked Databases List ...... N          Super Natural file FNR ...     (0-255)
     Command ===>                                                                   
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit                                                  Canc
    

    Note:
    Except for the Linked Databases List, the values for these defaults are not modifiable in PAC. To change the options, you must change the values in Predict, then copy the defaults into PAC.

  2. To modify the linked databases, type Y over the default in the Linked Databases List field.

    For more information, refer to Modify Linked Databases.

  3. To copy the generation defaults, press ENTER. Or, to terminate the function without copying the defaults, press PF3 (Exit) or PF12 (Canc).

    When you press ENTER, the Verification Defaults window appears, verifying that rules as well as views will be copied.

  4. To complete the copying of the generation defaults, press ENTER. Or to terminate the function without copying the defaults, press PF3 (Exit) or PF12 (Canc).

    The message "Generation Defaults have been copied." appears on the Predict Generation Defaults menu after you have successfully copied the Predict generation defaults to your PCF system file.

Modifying Linked Databases

Start of instruction set To modify the list of databases linked to the Predict userview generation defaults

  • access the Modify Linked Databases List screen in one of the following ways:

    From this Screen User Action

    Copy View Defaults Type Y over the N default in the Linked Databases List field.
    Predict Generation Enter Code M (Modify Linked Databases List) and the name of
    Defaults the generation defaults set to be modified.
    Predict GenerationDefaults Selection List Enter M (Modify Linked Databases List) in the C field adjacent to the name of the generation defaults set to be modified.

    The Modify Linked Databases List screen appears:

     14:07:23          ***** PREDICT APPLICATION CONTROL *****          2000-05-07
     User: SAGXX           - Modify Linked Databases List -
    
     Gen Defaults .. DB2-TRUN
     Title ......... DB2 defaults to be used for the truncation of creator________
    
     Linked DBs .... PROD-DB_________________________
                     TEST-DB_________________________
                     ________________________________
                     ________________________________
                     ________________________________
                     ________________________________
                     ________________________________
                     ________________________________
                     ________________________________
                     ________________________________
    
    
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit                                                  Canc
    

    From this screen, you can

    • modify or add the database names of up to 10 databases;

      The database names can be entered, using uppercase or lowercase text; however, the first character must be capitalized.

    • modify the entry in the Title field, which is used to specify an extended name or description for the generation defaults set;

    • press ENTER to confirm your modifications.

      You are returned to the Predict Generation Defaults menu.

Displaying Predict Generation Defaults

To display Predict userview generation defaults, access the Display View Defaults screen.

From this Screen User Action

Predict Generation Defaults Menu Enter Code D (Display Generation Defaults) and the name of the userview in the Defaults Name field.
Predict Generation Defaults Selection List Enter D (Display Generation Defaults) in the C field adjacent to the name of the userview.

17:59:51          ***** PREDICT APPLICATION CONTROL *****             2000-04-20
  User SAGU               - Display View Defaults -                             
                                                                                
  Generation Defaults ..... DFL00001                                            
  Overwrite option ........ Y  (Y,N)    Adabas Subsystem                        
  List generated code ..... N  (Y,N)      Use ADASTAR access-nr .... N          
  Adabas version .......... I1            Specification DB ID ...... N          
                                        DB2 Subsystem                           
                                          Truncate creator ......... N   (Y,N)  
  Field name prefix .......                                                     
  Line comments ........... N  (Y,N,O)  IMS Subsystem                           
  General comments ........ Y  (Y,N)      Generate UDFs ............ N   (Y,N)  
  Short comments .......... 3  (0-16)     Replace UDFs ............. Y   (Y,N)  
  Generate verif. rules ... Y  (Y,N)      List UDFs ................ N   (Y,N)  
  Replace verif. rules .... Y  (Y,N,S)    IMS field suffix ......... N   (Y,N)  
  List verif. rules ....... Y  (Y,N)    Natural Subsystems                      
                                          Generate security ........ N   (Y,N)  
  VSAM trailing BLANK char ...            Super Natural file opt ... N   (Y,N)  
                                          Super Natural file DBNR ..     (0-254)
  Linked Databases List ...... N          Super Natural file FNR ...     (0-255)
 Command ===>                                                                   
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Exit                                                  Canc

The Display View Defaults screen lists the generation defaults for the specified Predict userview. This screen is similar to the Copy View Defaults screen; however, the Display View Defaults screen may not be modified.

To display a list of databases linked to the generation defaults, type Y over the N default in the Linked Databases List field.

The Display Linked Databases List screen appears. The linked databases list may not be modified. For an example of a similar screen, refer to Modify Linked Databases.

Purge Predict Generation Defaults

The purge function is used to purge the defaults for both rules and userviews.

To purge a Predict generation default set, access the Purge Confirmation window in one of the following ways:

  • From the Predict Generation Defaults menu, enter Code P (Purge Generation Default) and the name of the generation default set to be purged in the Defaults Name field.

  • From the Predict Generation Defaults Selection List, mark the desired generation default set with P in the "C" column.

From the Purge Confirmation window, do one of the following:

  • To purge the Predict generation defaults, enter CONFIRM or press PF5.

  • To terminate the function without purging the defaults, enter a period (.) or press PF3 (Exit) or PF12 (Canc).

The message "Predict ... Generation Defaults purged" appears after you have successfully purged the Predict generation defaults.

Select Generation Defaults

To display a selection list of all Predict generation default sets, enter Code S (Select Generation Defaults). Use range notation if you want to limit the list of generation defaults.

The Predict Generation Defaults Selection List screen appears displaying a list of Predict generation default sets which have been copied into PAC as shown in the following example:

18:02:07              ***** PREDICT APPLICATION CONTROL *****           2000-04-20
  User SAGU       - PREDICT Generation Defaults Selection List -                
   Select  Predict Generation Defaults *                                        
  C Nr Gen Defaults Title                                                       
  - -- ------------ ------------------------------------------------------------
  _  1 DEFAULTS                                                                 
  _  2 DFL00001                                                                 
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                 Mark Selection, Enter Number or 'T' (Top) __                   
                                                                                
 Command ===>                                                                   
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Menu  Exit              --          +                       Canc

To display a specific set of Predict generation defaults on the Display View Defaults screen, mark the defaults set with an X in the C column, or enter the number (from the Nr column) in the Mark Selection... field.

You may modify a linked databases list (M), display generation defaults (D), or purge generation defaults (P) directly from this screen by marking the name of the generation defaults set with the appropriate code in the C column. Refer to the relevant sections for examples of the resulting screens.