Maintaining Format Buffer Definitions

This section describes the following topics:


Listing Format Buffer Definitions

Start of instruction setTo use the Adabas Auditing Configuration to list the Format Buffer definitions stored in the Auditing system file, complete the following steps:

  • Select option G from the Adabas Auditing Configuration Main Menu.

    The List of Format Buffers screen appears showing all Format Buffer definitions in the Adabas Auditing Configuration.

    17:48:52        ***** A D A B A S  AUDITING CONFIGURATION *****      2021-01-12
                                List of Format Buffers                   M-RP1130  
                                                                                   
     Sel Name                              ID       Pub                            
     --- --------------------------------  -------  ---                            
      _  NAME_OF_SALARY_FILE_FORMAT_BUF    SLRYFBUF  Y                             
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
    Command ==>                                                                    
                                                                                   
                                                                                   
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Gen   Exit  Add   Repos Name   -     +                      Menu   

    The following tables describe the options on this menu.

    Sel Allows you to:
    M Modify a Format Buffer definition
    C Copy a Format Buffer definition
    D Delete a Format Buffer definition
    PF Key Allows you to:
    PF1 Get screen help
    PF2 Generate a Format Buffer from Predict
    PF3 Exit this screen and return to the previous screen
    PF4 Add a new Format Buffer definition
    PF5 Reposition to a specific Format Buffer definition in the list
    PF6 Toggle between the sorting of Format Buffers by ID or Name
    PF12 Exit this screen and return to the main menu

    Note:
    You can only delete or modify a Format Buffer if it has not yet been published (by pressing F5). Once a Format Buffer is published, it cannot be changed.

Adding Format Buffer Definitions

Start of instruction setTo use the Adabas Auditing Configuration to generate a Format Buffer definition using Predict, complete the following steps:

  1. Select G from the Adabas Auditing Configuration main menu to list the Format Buffer definitions, as described earlier in Listing Format Buffer Definitions.

  2. Press PF4 (Add).

    The Predict Parameters screen appears.

    11:55:22        ***** A D A B A S  AUDITING CONFIGURATION *****      2021-03-18 
    FDIC=(1955,13)                Predict Parameters                     M-RP1121   
                                                                                    
    FB ID ........... _______                                                     
                                                                                    
    File ID ......... * ________________________________                            
    Target file ID .. * ________________________________                            
                                                                                    
    ----------  Generation Information ----------                                   
                                                                                    
    User ..............                                                             
    Date ..............                                                             
    Time ..............                                                             
    FDIC .............. DBID ..       FNR ..                                        
                                                                                    
    Adabas version ....                                                             
    Occurrences used ..                                                             
    Full format .......                                                             
                                                                                    
                                                                                    
    Command ==>                                                                     
                                                                                    
                                                                                    
                                                                                    
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- 
          Help        Exit        Exec  Sel   Unlnk                         Menu    
    
  3. Update the fields on this screen as described in the following table:

    Field Name Description Default
    FB ID

    A unique ID for the format buffer definition. The ID must be between one and seven characters long.

    none
    File ID

    The name of a Predict file with a file type of Adabas (A) or Adabas user view (U).

    Place your cursor on this field and press PF6 to select a file from a List of Predict Files screen. To select from the list screen, type an "S" next to the file you want to use and press PF5.

    none
    Target file ID

    The name of a Predict file with a file type of sequential (S).

    This file may be used to insert space notation (nX) into the format buffer. For fields in the target file with matching definitions in the File ID file (in other words, if a field exists with the same field long name), a short name clause is generated. For fields that do not have a matching definition in the File ID file, an appropriate space notation (nX clause) is generated. The spaces defined by nX clauses can be filled using a user exit.

    Place your cursor on this field and press PF6 to select a file from a List of Predict Files screen. To select from the list screen, type an "S" next to the file you want to use and press PF5.

    none
  4. When you first create a definition, the remaining fields on this screen are blank. However, when you modify the definition later, the fields are filled in, although you cannot modify them. These display-only fields are described in the following table:

    Field Name Description
    FDIC=(top of screen)

    The current database and file number of the Predict file.

    User

    The user ID of the user who generated the Format Buffer.

    Date

    The date the Format Buffer was generated.

    Time

    The time of day the Format Buffer was generated.

    FDIC…DBID..FNR

    The database and file number of the Predict file.

    Adabas version

    The version of Adabas for which the Format Buffer was generated.

    Occurrences used

    How multiple occurrences of PE and MU fields are generated in the Format Buffer and resulting field table (GFFT).

    A value of "M" indicates that the maximum number of occurrences should be generated (191).

    A value of "N" indicates that no occurrences will be generated.

    A value of "Y" indicates that the number of occurrences defined by the Predict Occ attribute should be generated.

    Full format

    Whether the full Format Buffer was generated. The full Format Buffer includes the length and format of Adabas fields.

    A value of "Y" indicates that the full format buffer was generated.

    A value of "N" indicates it was not.

    Note:
    The Format Buffer can only be modified or deleted if it has not yet been published.

  5. When you have supplied values for the FB ID, File ID, and Target file ID fields, press PF5 to start generating the Format Buffer.

    A small window appears requesting more information:

    +-----------------------------+
    ! Adabas Version ...* I7      !
    ! Occurrences used..* Y       !
    ! Full format ....... Y (Y/N) !
    +-----------------------------+
  6. Update the fields on this small window as described in the following table:

    Full format

    You cannot edit this parameter. It indicates that the full format buffer should be generated.

    Y
    Field Name Description Default
    Adabas version

    The version of Adabas for which the format buffer will be generated.

    The version should be expressed as "I7" or "R7". If you want special fields and descriptors included in the generated FB and corresponding field tables (GFFTs), specify "R7".

    I7
    Occurrences used

    How multiple occurrences of PE and MU fields are generated in the FB.

    A value of "M" indicates that the maximum number of occurrences should be generated (191).

    A value of "N" indicates that no occurrences will be generated.

    A value of "Y" indicates that the number of occurrences defined by the Predict Occ attribute should be generated.

    Y
  7. When these fields are set appropriately, press Enter.

    The Format Buffer definition and field table (GFFT) are generated and the Format Buffer screen appears.

  8. Press PF5 to save the Format Buffer definition in the Auditing system file. After saving, the Format Buffer can no longer be deleted or modified.

Modifying Format Buffer Definitions

Start of instruction setTo use the Adabas Auditing Configuration to modify a Format Buffer definition in the Auditing system file:

  1. List the Format Buffer definitions in the Adabas Auditing Configuration, as described earlier in Listing Format Buffer Definitions.

  2. Locate the definition you want to modify on the screen and enter an M in the Sel column for that definition.

    You can locate the definition you want in the list by pressing the PF7 (F7) or PF8 (F8) keys to scroll through the list. You can also press PF2 (F2) to specify the ID of the definition to which the list should be repositioned.

    An appropriate Format Buffer definition screen appears for the Format Buffer you selected.

  3. For information about the fields on this screen, refer to the field descriptions described earlier in Adding Format Buffer Definitions.

    Note:
    You cannot alter the ID of the Format Buffer definition. If you want to rename a Format Buffer definition, first copy it using the ID you want and then delete the original.

  4. When all modifications have been made, press PF5 to save the changes. After saving, the Format Buffer can no longer be modified or deleted.

Copying Format Buffer Definitions

Start of instruction setTo use the Adabas Auditing Configuration to copy a Format Buffer definition in the Auditing system file:

  1. List the Format Buffer definitions in the Adabas Auditing Configuration, as described in Listing Format Buffer Definitions.

  2. Locate the definition you want to copy on the screen and enter a C in the Sel column for that definition.

    You can locate the definition you want in the list by pressing the PF7 (F7) or PF8 (F8) keys to scroll through the list. You can also press PF2 (F2) to specify the ID of the definition to which the list should be repositioned.

    A dialog appears requesting a Name and ID for the copy of the Format Buffer definition.

    Enter new                                 
     Name: ________________________________   
       ID: ________                           
     or press PF3 to cancel                    
    
  3. Specify new, unique Name and ID for the copy of the Format Buffer definition and press Enter.

    The Format Buffer definition is copied and the copy appears on the List of Format Buffers screen.

Deleting Format Buffer Definitions

Start of instruction setTo use the Adabas Auditing Configuration to delete a Format Buffer definition in the Auditing system file:

  1. List the Format Buffer definitions in the Adabas Auditing Configuration, as described in Listing Format Buffer Definitions.

  2. Locate the definition you want to delete on the screen and enter a D in the Sel column for that definition and press Enter. The Format Buffer definition is deleted.

    You can locate the definition you want in the list by pressing the PF7 (F7) or PF8 (F8) keys to scroll through the list. You can also press PF2 (F2) to specify the ID of the definition to which the list should be repositioned.

    Note:
    The Format Buffer can only be modified if it has not yet been published.