Maintaining Destination Definitions

A destination definition defines the destination of audit data.

This section describes the following topics:


Listing Destination Definitions

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

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

    The Available Destinations screen appears showing all Destination definitions in the Adabas Auditing Configuration.

    17:35:57        ***** A D A B A S  AUDITING CONFIGURATION *****      2021-01-12
                               Available Destinations                    M-RP1200  
                                                                                   
     Sel  Name                               ID       Type                       
     ---  --------------------------------   --------   ----                       
      _   PAYROLL_APPL._AUDIT_DESTINATION    PYRLDEST   AUDT                       
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
    Command ==>                                                                    
                                                                                   
                                                                                   
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Repos Exit  Add         ID     -     +                      Menu   
    

The following tables describe the options on this menu.

Sel Allows you to:
M Modify a Destination definition
C Copy a Destination definition
D Delete a Destination definition
PF Key Allows you to:
PF1 Get screen help
PF2 Reposition to a specific Destination definition in the list
PF3 Exit this screen and return to the previous screen
PF4 Add a new Destination definition
PF6 Toggle between the sorting of Destination definition in the list
PF12 Exit this screen and return to the main menu

Adding Destination Definitions

Start of instruction setTo use the Adabas Auditing Configuration to add a Destination definition to the Auditing system file, complete the following steps:

  1. Select D from the Adabas Auditing Configuration main menu to list the Destination definitions, as described above in Listing Destination Definitions.

  2. Press PF4 (Add).

    The Audit Destination Definition screen appears.

    17:38:42        ***** A D A B A S  AUDITING CONFIGURATION *****      2021-01-12
                             Audit Destination Definition                M-RP1250  
                                                                                   
    Destination Name ...... NAME_OF_DESTINATION_ID_AUDIT1                                               
    Destination ID ........ AUDIT1__                                               
                                                                                   
    Active at Startup ..... Y                                                      
    Architecture .......... 2                                                      
    Open at Startup ....... G                                                      
    Maximum Output size ... _________0                                             
    
    
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
    Command ==>                                                                    
                                                                                   
                                                                                   
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit        Save                                      Menu   
    
  3. Update the fields on this screen as described in the following table.

    Field Name Description Default
    Destination Name

    The name of the output destination.

    All destination definitions require a unique name. The name must use alphanumeric characters and be between 1 and 32 characters long. Embedded spaces are replaced automatically with underscores.

    None
    Destination ID

    The ID of the output destination.

    All destination definitions require a unique ID. The ID must use alphanumeric characters and be between 1 and 8 characters long.

    None
    Active at Start-up

    Whether the destination should be activated at Audit Server start-up.

    Valid values are “Y” (activate destination) or “N” (do not activate destination).

    Y
    Architecture

    Use this field to specify the data architecture for fields in the URB* control structures sent to the destination. To calculate a value for this parameter, add the value of the byte order element and the encoding element in the control structure:

    Control Structure Element  Values  Description
    Byte order (b)             0       High-order byte first
                               1       Low-order byte first
    Encoding Family (e)        0       ASCII encoding family
                               2       EBCDIC encoding family

    For example, the default value, 2, indicates that the byte order element value is "0" and the encoding family value is "2".

    2
    Open at Start-up

    Whether or not the destination should be opened at Audit Server startup.

    Valid values are "Y", "N", or "G", with "G" (global value) as the default.

    When this parameter is set to "Y", the destination is opened at Audit Server start-up. When this parameter is set to "N", the destination is not opened at Audit Server start-up.

    G
    Maximum Output size

    The maximum output size (in bytes) for the destination.

    Valid values are 0 or an integer ranging from 4096 through 2,147,483,647.

    0
  4. Press PF5 to save the Destination definition in the Auditing system file.

Modifying Destination Definitions

Start of instruction set

  1. List the Destination definitions in the Adabas Auditing Configuration, as described above in Listing Destination 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 Destination definition screen appears for the Destination you selected.

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

    Note:
    You cannot alter the ID of the Destination definition. If you want to rename a Destination 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.

Copying Destination Definitions

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

  1. List the Destination definitions in the Adabas Auditing Configuration, as described in Listing Destination 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 Destination definition.

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

    The Destination definition is copied, and the copy appears on the List of Destinations screen.

Deleting Destination Definitions

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

  1. List the Destination definitions in the Adabas Auditing Configuration, as described in Listing Destination 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 Destination 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.