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

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

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

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.