Nucleus Audit Administration

#### Search Results

Search

# Nucleus Audit Administration

To use Adabas Auditing Administration to perform inquiries against an Adabas nucleus, select option N and specify an Adabas nucleus in the Database field (which must be running with `ADARUN AUDITING=YES`) from the Adabas Auditing Administration Main Menu.

The Nucleus Audit Administration screen appears as follows:

    17:47:39         ***** A D A B A S  AUDIT Administration *****       2021-01-13
    Audit database           Nucleus Audit Administration                M-AU0020

                      Code    Function
                      ----    ------------------------
                        P     Nucleus Audit Parameters
                        S     Nucleus Audit Statistics
                        ?     Help
                        .     Exit
                      ----    -----------------------
               Code ... _
           Database ... 1955_   WIS1955

    Command ==>

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

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:
--- | ---
P | Perform inquiries against the selected Adabas nucleus pertaining to parameter status and structure (with reference to the ADAANP input statements for that nucleus).
S | Perform inquiries against the selected Adabas nucleus pertaining to statistical information.

Note
From this screen you can choose a different Adabas nucleus running with `ADABAS AUDITING=YES` by specifying its database ID in the Database field. If you specify a database ID that is not an Adabas nucleus running with `ADABAS AUDITING=YES`, you will be returned to the main menu.

- Nucleus Audit Parameters

- Nucleus Audit Statistics

## Nucleus Audit Parameters

To use Adabas Auditing Administration to perform inquiries against an Adabas nucleus running with `ADARUN AUDITING=YES` pertaining to parameter status and structure, select option P from the Nucleus Audit Administration screen.

The Nucleus Audit Parameters screen appears showing all available inquiry options.

    17:39:00         ***** A D A B A S  AUDIT Administration *****       2021-08-04
    Audit database             Nucleus Audit Parameters                  M-AU3000

                      Code    Function
                      ----    ----------------------------
                        A     Nucleus Global Parameters
                        F     Nucleus File Parameters
                        T     Act/Deact Auditing for Files
                        U     Force Connection Attempt
                        X     Display Adabas Parameters
                        Y     Modify Adabas Parameters
                        ?     Help
                        .     Exit
                      ----    ----------------------------
               Code ... _
           Database ... 1955    WIS1955

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

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:
--- | ---
A | Display the auditing Global parameters by which the specified Adabas nucleus is currently executing.
F | Display the auditing File parameters by which the specified Adabas nucleus is currently executing.
X | Display Adabas parameters for the specified Adabas nucleus.
T | Activate or Deactivate Auditing for files by which the specified Adabas nucleus is currently executing.
U | Force a connection attempt to an Auditing Server.
Y | Modify Adabas parameters for the specified Adabas nucleus.

- Display Nucleus Global Parameters

- Display Nucleus File Parameters

- Activate/Deactivate Auditing for Files

- Force Connection Attempt

- Display Adabas Parameters

- Modify Adabas Parameters

### Display Nucleus Global Parameters

To use Adabas Auditing Administration to display Global parameters currently in use by the selected Adabas nucleus (running `ADABAS AUDITING=YES`), select option A from the Nucleus Audit Parameters screen. The Nucleus Global Parameters screen appears.

    17:58:53         ***** A D A B A S  AUDIT Administration *****       2021-01-13
    DBID 1955                  Nucleus Global Parameters                 M-AU3100
    Audit database

    Nucleus Global Parameters  --------------

    GAPWARNINCREMENT ..........            10     Warning increment
    GAPWARNMESSAGELIMITsize ...             5     Warning message limit
    GAPWARNPERCENT ............            50     Warning percent
    GAPWARNINTERVAL ...........            60     Warning interval
    GCONNECTCOUNT .............             0     Connect count
    GCONNECTINTERVAL ..........             0     Connect interval

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

The following table describes the fields on this screen.

Refer to the chapter Adabas Audit Reference > Adabas Nucleus Auditing Parameters > section Global Auditing Parameters for more information about these fields.

Field | Description
--- | ---
`GAPWARNINCREMENT` | Specifies the increment, in percent of Auditing pool usage (`ADARUN LAP=`), at which auditing pool warning messages should be written.
`GAPWARNMESSAGELIMIT` | Specifies the number of Auditing pool usage (`ADARUN LAP=`) messages that may be written before these messages are suppressed.
`GAPWARNPERCENT` | Specifies the threshold, in percent of Auditing pool usage (`ADARUN LAP=`), at which auditing pool warning messages should be written.
`GAPWARNINTERVAL` | Specifies the interval (in seconds) during which Auditing pool usage (`ADARUN LAP=`) warning messages are suppressed on the console.
`GCONNECTCOUNT` | Specifies the number of connect attempts for an Adabas nuclei (running `ADARUN AUDITING=YES`) when the first attempt to connect to an Audit Server fails.
`GCONNECTINTERVAL` | Specifies the interval (in seconds) between connection attempts when the first Adabas nuclei (running `ADARUN AUDITING=YES`) attempt to connect to an Audit Server fails.

### Display Nucleus File Parameters

To use Adabas Auditing Administration to display File parameters currently in use by the selected Adabas nucleus (running `ADARUN AUDITING=YES`), select option F from the Nucleus Audit Parameters screen. The Nucleus File Parameters screen appears.

    18:00:43         ***** A D A B A S  AUDIT Administration *****       2021-01-13
    DBID 1955                   Nucleus File Parameters                  M-AU3200
    Audit database
    File   Audit Server id
    -----  -----
        1   1956                   File Settings for

    Select               Delete              Insert               Update
    FACCACBX ... Y       FDELACBX ... N      FINSACBX ... N       FUPDACBX ... N
    FACCDS ..... N       FDELDS ..... N      FINSDS ..... N       FUPDAI ..... N
    FACCINFO ... N       FDELINFO ... N      FINSINFO ... N       FUPDBI ..... N
    FACCFB ..... N                           FINSFB ..... N       FUPDINFO ... N
                                                                  FUPDFB ..... N

    Select fields ..

    Update fields ..

                                                                         File
                                                                        Totals
                                                                        1 of 2

    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit                     -     +                      Menu

Use PF7 and PF8 to page forwards and backwards through the parameter screen for each file.

The following table describes the fields on this screen.

Refer to chapter Adabas Audit Configuration > Adabas Nucleus Auditing Parameters > section File Auditing Parameters for more information about these fields.

Field | Description
--- | ---
`FACCACBX` | Collects ACBX data for an access command.
`FACCDS` | Collects the data storage image for an access command.
`FACCINFO` | Collects client info for an access command.
`FACCFB` | Collects format buffer for an access command.
`FDELACBX` | Collects ACBX data for a delete command.
`FDELDS` | Collects the data storage image for a delete command.
`FDELINIO` | Collects client info for a delete command.
`FINSACBX` | Collects ACBX data for an insert command.
`FINSDS` | Collects the data storage image for an insert command.
`FINSINFO` | Collects client info for an insert command.
`FINSFB` | Collects format buffer for an insert command.
`FUPDACBX` | Collects ACBX data for an update command.
`FUPDAI` | Collects the after image of data storage for an update command.
`FUPDBI` | Collects the before image of data storage for an update command.
`FUPDINFO` | Collects client info for an update command.
`FUPDFB` | Collects format buffer for an update command.

### Activate/Deactivate Auditing for Files

Use the codes displayed below, together with a file number, to do the following:

- Activate auditing for a file under the current DBid.

- Deactivate auditing for a file under the current DBid.

- Inquire to the auditing status of a file.

The Act/Deact Auditing for Files screen appears as follows:

    17:45:45         ***** A D A B A S  AUDIT Administration *****       2021-08-04
    Audit database           Act/Deact Auditing for Files                M-AU3300

                      Code    Function
                      ----    -------------------------------
                        A     Activate Auditing for file
                        D     Deactivate Auditing for file
                        I     Inquire Auditing status of file
                        ?     Help
                        .     Exit
                      ----    -------------------------------
               Code ... _
               File ... _____
           Database ... 1955    WIS1955

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

### Force Connection Attempt

Specify “U” and the DBid of an Auditing Server that the Adabas should attempt a connection to.

The Force Connection Attempt screen appears as follows:

    17:51:06         ***** A D A B A S  AUDIT Administration *****       2021-08-04
    Audit database         Nucleus with Auditing Connection              M-AU3400

                      Code    Service
                      ----    ----------------
                        U     Force Connection
                        ?     Help
                        .     Exit
                      ----    ----------------
        Code .......... _
        Database ...... 1955    WIS1955
        Connect To .... _____

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

### Display Adabas Parameters

To use Adabas Auditing Administration to display Adabas parameters in use by the specified Adabas nucleus (running `ADARUN AUDITING=YES`), select option X from the Nucleus Audit Parameters screen.

The Display Adabas parameters screen is identical to that displayed in the Adabas Online System (AOS) when displaying parameters used by an Adabas database.

Refer to the Adabas Online System documentation for an explanation of the content of this screen.

### Modify Adabas Parameters

To use Adabas Auditing Administration to modify Adabas parameters in use by the specified Adabas nucleus (running `ADARUN AUDITING=YES`), select option Y from the Nucleus Audit Parameters screen.

The Modify Adabas parameters screen is identical to that displayed in the Adabas Online System (AOS) when modifying parameters used by an Adabas database.

Refer to the Adabas Online System documentation for an explanation of the content of this screen.

## Nucleus Audit Statistics

To use Adabas Auditing Administration to perform inquiries against an Adabas nucleus (running with `ADARUN AUDITING=YES`) pertaining to statistics, select option S from the Nucleus Audit Administration screen.

The Nucleus Audit Statistics screen appears showing all available inquiry options.

    18:18:11         ***** A D A B A S  AUDIT Administration *****       2021-01-13
    Audit database              Nucleus Audit Statistics                 M-AU4000

                      Code    Function
                      ----    -------------------------
                        A     Nucleus Global Statistics
                        F     Nucleus Files Statistics
                        U     Interval High Water Marks
                        W     Session High Water Marks
                        ?     Help
                        .     Exit
                      ----    -------------------------
               Code ... _
           Database ... 1955    WIS1955

    Command ==>

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

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:
--- | ---
A | Display the Global statistics for the selected Adabas nucleus.
F | Display the File statistics for the selected Adabas nucleus.
U | Display the interval high water marks for the selected Adabas nucleus.
W | Display the session high water marks for the selected Adabas nucleus.

- Display Nucleus Global Statistics

- Display Nucleus File Statistics

- Display Nucleus Interval High Water Marks

- Display Nucleus Session High Water Marks

### Display Nucleus Global Statistics

To use Adabas Auditing Administration to display Global statistics for the selected Adabas nucleus, select option A from the Nucleus Audit Statistics screen. The Nucleus Global Statistics screen appears.

    18:20:40         ***** A D A B A S  AUDIT Administration *****       2021-01-13
    DBID 1955                  Nucleus Global Statistics                 M-AU4100
    Audit database

    Nucleus Global Statistics ----------------------------

    Total audit items .........                          0
    Pending audit items .......             0
    Incomplete audit items ....             0

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

The following table describes the fields on this screen.

Field | Description
--- | ---
Total audit items | The total count of audit items in the selected Adabas DBid executing with `AUDITING=YES`.
Pending audit items | The total count of pending audit items in the selected Adabas DBid executing with `AUDITING=YES`.
Incomplete audit items | The total count of incomplete audit items in the selected Adabas DBid executing with `AUDITING=YES`.

### Display Nucleus File Statistics

To use Adabas Auditing Administration to display File statistics for the selected Adabas nucleus, enter F on the Nucleus Audit Statistics screen. The Nucleus File Statistics screen appears.

    18:29:53         ***** A D A B A S  AUDIT Administration *****       2021-01-13
    DBID 1955                   Nucleus File Statistics                  M-AU4200
    Audit database

    File Statistics -------------------------------------

    File .....................     1
    Total items ..............                          0
    Pending audit items ......             0
    Incomplete audit items ...             0

                                                                         File
                                                                        Totals
                                                                        1 of 15

    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit                     -     +                      Menu

Use PF7 and PF8 to page forwards and backwards through the list of Files.

The following table describes the fields on this screen.

Field | Description
--- | ---
File | The file number for the statistics given.
Total items | The total count of audit items for the selected Adabas DBid / File.
Pending audit items | The total count of pending audit items for the selected Adabas DBid / File.
Incomplete audit items | The total count of incomplete audit items for the selected Adabas DBid / File.

### Display Nucleus Interval High Water Marks

To use Adabas Auditing Administration to display the interval high water marks for the selected Adabas nucleus, enter U on the Nucleus Audit Statistics screen.

The Display Interval High Water Marks screen is identical to that displayed in the Adabas Online System (AOS) when displaying interval high water marks for an Adabas database.

Refer to the Adabas Online System documentation for an explanation of the content of this screen.

### Display Nucleus Session High Water Marks

To use Adabas Auditing Administration to display the session high water marks for the selected Adabas nucleus, enter W on the Nucleus Audit Statistics screen.

The Display Session High Water Marks screen is identical to that displayed in the Adabas Online System (AOS) when displaying session interval high water marks for an Adabas database.

Refer to the Adabas Online System documentation for an explanation of the content of this screen.

### On this page

- Nucleus Audit Parameters
- Nucleus Audit Statistics