Maintaining Format Buffer Definitions

#### Search Results

Search

# Maintaining Format Buffer Definitions

This section describes the following topics:

- Listing Format Buffer Definitions

- Adding Format Buffer Definitions

- Modifying Format Buffer Definitions

- Copying Format Buffer Definitions

- Deleting Format Buffer Definitions

## Listing Format Buffer Definitions

To 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

To 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:

   Field Name | Description | Default
   --- | --- | ---
   Full format

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

   Y
   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

To 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

To 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

To 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.

### On this page

- Listing Format Buffer Definitions
- Adding Format Buffer Definitions
- Modifying Format Buffer Definitions
- Copying Format Buffer Definitions
- Deleting Format Buffer Definitions