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.
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. |
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 |
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:
To get screen-level help for any Adabas Auditing Configuration
screen:
Be sure the screen you want help for is displayed. Navigate to it if you need to.
Press the PF1 key to display the help screen.
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
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. |
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.