Adabas Auditing Configuration Overview

#### Search Results

Search

# Adabas Auditing Configuration Overview

You can access Adabas Auditing Configuration from Natural.

First, verify that the Adabas Audit Server and Auditing system file have been installed appropriately, as described in the Installation chapter.

Then, within Natural, log on to the SYSALA library by entering:

    LOGON SYSALA

And enter the following command:

    MENU

The Adabas Auditing Configuration Main Menu will appear.

- Controlling Access to Adabas Auditing Configuration

- The Adabas Auditing Configuration Main Menu

- Getting Help

- Using Function Keys

- Leaving the Adabas Auditing Configuration Screens

## Controlling Access to Adabas Auditing Configuration

You can control access to the Adabas Auditing Configuration using the initialization exit, subprogram N-IEXIT. This exit is a Natural subprogram that runs automatically, whenever a user attempts to access the Adabas Auditing Configuration. Based on Natural code you supply in the exit using the exit parameters, you can:

- Restrict specific users from accessing the Adabas Auditing Configuration.

- Identify the Auditing system file initially used by a user or users.

For complete information on coding Natural subprograms, read your Natural documentation. Once you have supplied code in the N-IEXIT subprogram, the ID of any user attempting to access the Adabas Auditing Configuration is passed to the exit. If the #RESPONSE parameter is set to a non-zero value for that user, they cannot access the Adabas Auditing Configuration.

A sample of the N-IEXIT is shown below.

    0010 ***************************
    0020 *   INITIALIZATION EXIT   *
    0030 ***************************
    0040 DEFINE DATA PARAMETER
    0050 01 #USER              (A08)   /* USER ID
    0060 01 #AUDIT-DBID       (N05)    /* AUDIT ID
    0070 01 #AUDIT-FNR        (N05)    /* AUDITING SYSTEM FILE
    0080 01 #PARM-1            (A40)   /* DATA
    0090 01 #RESPONSE          (B02)   /* USER EXIT RESPONSE CODE
    0100 01 #VERSION           (A04)   /* ONLINE SYSTEM VERSION
    0110 END-DEFINE
    0120 *
    0130 #RESPONSE = H'0000'           /* NON-ZERO WILL TERMINATE
    0140 ESCAPE ROUTINE
    0150 END

You can use the following parameters while coding the Natural subprogram:

Parameter | Description
--- | ---
#PARM-1 | Reserved for future use.
#AUDIT-DBID | The database ID of the Adabas Audit Server whose Auditing system file you want to maintain when the Adabas Auditing Configuration starts. Once you are using the Adabas Auditing Configuration, you can change this setting using the Set LFILE Parameters screen.
#AUDIT-FNR | The file number of the Auditing system file you want to maintain when the Adabas Auditing Configuration starts. Once you are using the Adabas Auditing Configuration, you can change this setting using the Set LFILE Parameters screen.
#RESPONSE | A non-zero response code will cause the Adabas Auditing Configuration to terminate. By setting this to a non-zero number you can restrict access to the Adabas Auditing Configuration for the user identified in the USER parameter or for the Adabas Auditing Configuration version specified in the VERSION parameter.
#USER | The user ID of a potential Adabas Auditing Configuration user.
#VERSION | The version of the Adabas Auditing Configuration.

## The Adabas Auditing Configuration Main Menu

From the main menu of the Adabas Auditing Configuration screens, you can select options that allow you to maintain any Auditing definitions you need. Definitions can be added, reviewed, modified, copied, or deleted.

     16:18:44        ***** A D A B A S  AUDITING CONFIGURATION *****      2021-08-03
    Vers 2.2.1                        Main Menu                          M-RP0010
    DBID 1956  File 89

                      Code    Function
                      ----    ------------------------------
                        D     Destination Definitions
                        F     Filter Definitions
                        G     Format Buffer Definitions
                        S     Subscription Definitions
                        T     Admin Subscription Definitions
                        V     Global Definitions
                        U     Set Lfile parameters
                        ?     Help
                        .     Exit
                      ----    ------------------------------
               Code ... _

    Command ==>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit                                                  Exit

The following table describes the options on this menu. To select an option, enter its associated code in the Code field on the screen.

Code | Allows you to:
--- | ---
D | Maintain Destination definitions
F | Maintain Filter definitions
G | Maintain Format Buffer definitions
S | Maintain Subscription definitions
T | Maintain Admin Subscription definitions
V | Maintain Global definitions
U | Change or set LFILE parameters
? | Get help on this menu
. | Exit Adabas Auditing Configuration

## Getting Help

Online help is provided for every Adabas Auditing Configuration screen and message that appears in the Adabas Auditing Configuration. This section covers the following topics:

- Getting Screen-Level Help

- Getting Help for Messages

### Getting Screen-Level Help

To get screen-level help for any Adabas Auditing Configuration screen:

1. Be sure the screen you want help for is displayed. Navigate to it if you need to.

2. Press the PF1 key to display the help screen.

### Getting Help for Messages

To get help for Adabas Auditing Configuration messages:

- At the Command prompt, enter:

      msg nnn

  where nn is the valid two- or three-digit message number (omit the leading zeros). For example, to get help on message ALA00245, you would enter:

      msg 245

## Using Function Keys

The following table describes the general function keys available while using the Adabas Auditing Configuration screens. Note that not all function keys are available on all screens and some PF keys have meanings only to specific screens.

Function Key | Display Title | Description
--- | --- | ---
PF1 | Help | Provides help on the current screen.
PF2 | Repos | Displays a pop-up screen allowing you to specify the definition name to which you want a list of definitions repositioned. This is useful if you have many definitions listed on one of the Adabas Auditing Configuration list screens.
PF3 | Exit | Exits the current screen without saving any changes you might have made. If the current screen is the Main Menu, this function key has no effect.
PF4 | Add | Displays a screen that allows you to add a definition.
PF5 | Save or Exec | Saves the changes you have made or allows you to execute the program corresponding to the Adabas Auditing Configuration screen displayed.
PF7 | - | Scrolls backwards through the data on a screen.
PF8 | + | Scrolls forward through the data on a screen.
PF12 | Menu | Returns to the Adabas Auditing Configuration main menu.

## Leaving the Adabas Auditing Configuration Screens

To leave the Adabas Auditing Configuration screens, press PF12 from any screen. If you are on a menu screen in the Adabas Auditing Configuration, you can select the dot (.) option to leave.

Note
When you leave the Adabas Auditing Configuration screens, any modifications to the configuration since the last save will not be stored.

### On this page

- Controlling Access to Adabas Auditing Configuration
- The Adabas Auditing Configuration Main Menu
- Getting Help
- Using Function Keys
- Leaving the Adabas Auditing Configuration Screens