Adabas Auditing

This document describes how to use Adabas Manager to perform the administration tasks necessary for Adabas Auditing operations.


System Requirements

Please refer to the documentation of Adabas Auditing on Mainframe > Installation > System Requirements for information on what is required to set up Adabas Auditing Server on the mainframe.

Accessing Adabas Auditing

Start of instruction setTo access Adabas Auditing

  • Click on the icon Administer Adabas Auditing on the Adabas Manager home page.

    The Adabas Auditing overview screen is displayed.

    From the overview page you can manage subscriptions, destinations, format buffers, and filters.

    The overview page consists of 4 panels, one each for subscriptions, destinations, format buffers, and filters. Each panel displays of list of the known objects of a given type, if objects of that type exist, together with some information about each object.

Managing Destinations

This section describes how to manage destinations using Adabas Manager.

Creating a new Destination

Start of instruction setTo create a new destination

  1. Click on the plus icon (+) in the Destinations panel of the overview page.

    Or:
    Click on the link Create New from the Destinations drop-down menu.

    Or:
    Click on the link Create New in the Destinations navigation area, if it is open.

    The Create Destination dialog is displayed.

  2. There are two destination types available - AUDIT and NULL. Click on the radio button of the destination type that you want to create.

  3. Enter the name for the destination in the text box Name. The name must be between 1 and 8 characters long. Only alphanumeric characters are allowed.

  4. Select the options that you want to use from the list boxes Active at start up and Open at start up.

  5. If the destination type is AUDIT, click on the SAVE button to save the new destination.

    Or:
    If the destination type is NULL, continue as described below.

  6. Enter a value for the architecture in the field Architecture. Valid values are 0, 1, and 2.

  7. Enter a value for the commit threshold in the filed Commit Threshold. Valid values are between 0 and 2147483647, the default is 5.

  8. Enter a value for the maximum output size in the field Max Output Size. Valid values are between 0 and 2147483647, the default is 0.

  9. Click on the Save button to save the new destination.

Modifying a Destination

Start of instruction setTo modify a destination

  1. Click on the name of the destination that you want to modify in the list in the Destinations panel of the overview page.

    Or:
    Click on the name of the destination from the Destinations drop-down menu.

    Or:
    Click on the name of the destination in the Destinations navigation area, if it is open.

    The details of the destination are loaded in the data area.

  2. Click on the button Edit in the data area. You can now edit the destination as described in the section Creating a new Destination.

  3. Once you have made all of the changes that you want, click on the Save button in the data area to save the modified destination.

Deleting a Destination

Start of instruction setTo delete a destination

  1. Click on the name of the destination that you want to delete in the list in the Destinations panel of the overview page.

    Or:
    Click on the name of the destination from the Destinations drop-down menu.

    Or:
    Click on the name of the destination in the Destinations navigation area, if it is open.

    The details of the destination are loaded in the data area.

  2. Click on the Delete button in the data area.

    The pop-up Delete Destination dialog box is displayed.

  3. Click on the button Yes, delete destination to delete the destination.

Managing Filters

This section describes how to manage buffers using Adabas Manager.

Creating a new Filter

Start of instruction setTo create a new filter

  1. Click on the plus icon (+) in the Filters panel of the overview page.

    Or:
    Click on the link Create New from the Filters drop-down menu.

    Or:
    Click on the link Create New in the Filters navigation area, if it is open.

    The Create new Filter dialog is displayed.

  2. Enter the name for the filter in the text box Name. The name must be between 1 and 8 characters long. Only alphanumeric characters are allowed.

  3. Select the type of filter that you want to create (Exclude or Include) from the drop-down list Type.

  4. Click on the Save button to save the new filter.

    Or:
    Click on the New "OR" Group button to add an OR group to the filter. In this case, the Create New Condition dialog is displayed.

    Enter the values that you want to use for the source and target, select the condition that is to apply from the Condition drop-down list, and then click on the Save button to save the new filter.

  5. Once you have saved the filter, you can add/delete further OR groups, as well as add/delete AND conditions

Modifying a Filter

Start of instruction setTo modify a filter

  1. Click on the name of the filter that you want to modify in the list in the Filters panel of the overview page.

    Or:
    Click on the name of the filter from the Filters drop-down menu.

    Or:
    Click on the name of the filter in the Filters navigation area, if it is open.

    The details of the filter are loaded in the data area.

  2. Click on the button Edit in the data area. You can now edit the filter as described in the section Creating a new Filter.

  3. Once you have made all of the changes that you want, click on the Save button in the data area to save the modified filter.

Deleting a Filter

Start of instruction setTo delete a filter

  1. Click on the name of the filter that you want to delete in the list in the Filters panel of the overview page.

    Or:
    Click on the name of the filter from the Filters drop-down menu.

    Or:
    Click on the name of the filter in the Filters navigation area, if it is open.

    The details of the filter are loaded in the data area.

  2. Click on the Delete button in the data area.

    The pop-up Delete Filter dialog box is displayed.

  3. Click on the button Yes, delete filter to delete the filter.

Managing Format Buffers

This section describes how to manage buffers using Adabas Manager.

Creating a new Format Buffer

Start of instruction setTo create a new format buffer

  1. Click on the plus icon (+) in the Format Buffers panel of the overview page.

    Or:
    Click on the link Create New from the Format Buffers drop-down menu.

    Or:
    Click on the link Create New in the Format Buffers navigation area, if it is open.

    The Create Format Buffer dialog is displayed.

  2. Enter the name for the format buffer in the text box Format Buffer Name. The name must be between 1 and 8 characters long. Only alphanumeric characters are allowed.

  3. There are two format buffer source options available - Predict Input and Data Definition Module (DDM). Click on the radio button of the option that you want to use. Click on the Next button to continue.

    The Create Format Buffer Source dialog is displayed.

  4. If the source option is Predict Input, select the Predict location that you want to use from the Predict Location drop-down list, then select the file that you want to use from the Predict File drop-down list. Click on the Next button to continue.

    The list of Adabas fields from the selected Predict file is displayed in the data area. Select the fields that you want to include in the format buffer (by default all fields are selected), then click on the Next button to continue.

    The Create Format Buffer GFFT dialog is displayed.

  5. If the source option is Data Definition Module (DDM), browse to the location of the DDM file that you want to use, select the file, then click on the Open button. Click on the Next button to continue.

    The list of Adabas fields from the selected DDM file is displayed in the data area. Select the fields that you want to include in the format buffer (by default all fields are selected), then click on the Next button to continue.

    The Create Format Buffer GFFT dialog is displayed.

  6. Select the options that you want to use (Read Only, Key, CharSet). If a field is an MU or PE field, you can also select MUOcc, MUStart, PEOcc and PEStart.

  7. Click on the Create button to create the new format buffer.

Modifying a Format Buffer

Start of instruction setTo modify a format buffer

  1. Click on the name of the format buffer that you want to modify in the list in the Format Buffers panel of the overview page.

    Or:
    Click on the name of the format buffer from the Format Buffers drop-down menu.

    Or:
    Click on the name of the format buffer in the Format Buffers navigation area, if it is open.

    The details of the format buffer are loaded in the data area.

  2. Click on the button Edit in the data area. You can now edit the format buffer as described in the section Creating a new Format Buffer.

  3. Once you have made all of the changes that you want, click on the Save button in the data area to save the modified format buffer.

Deleting a Format Buffer

Start of instruction setTo delete a format buffer

  1. Click on the name of the format buffer that you want to delete in the list in the Format Buffers panel of the overview page.

    Or:
    Click on the name of the format buffer from the Format Buffers drop-down menu.

    Or:
    Click on the name of the format buffer in the Format Buffers navigation area, if it is open.

    The details of the format buffer are loaded in the data area.

  2. Click on the Delete button in the data area.

    The pop-up Delete Format Buffer dialog box is displayed.

  3. Click on the button Yes, delete format buffer to delete the format buffer.

Managing Subscriptions

This section describes how to manage subscriptions using Adabas Manager.

Creating a new Subscription

Start of instruction setTo create a new subscription

  1. Click on the plus icon (+) in the Subscriptions panel of the overview page.

    Or:
    Click on the link Create New from the Subscriptions drop-down menu.

    Or:
    Click on the link Create New in the Subscriptions navigation area, if it is open.

    The Create Subscription Definition Parameters dialog is displayed.

  2. Enter the name for the subscription in the text box Name. The name must be between 1 and 8 characters long. Only alphanumeric characters are allowed.

  3. Enter a description of the subscription in the text box Description.

  4. Select the subscription status from the Subscription Status drop-down list.

  5. Select a format buffer from the Request Info Format Buffer drop-down list.

  6. Select a format buffer from the Client Info Format Buffer drop-down list.

  7. Click on the Next button. The Create Subscription Destinations dialog is displayed.

  8. Select a destination by ticking the check box next to its name in the list All Available Destination(s). Click on the blue right arrow icon to move the destination to the list All Selected Destination(s). Tick the check box in the top left of the All Available Destination(s) list if you want to select all available destinations, then click on the blue right arrow icon to move the destinations to the list All Selected Destination(s). You can remove a destination from the list All Selected Destination(s) by ticking the check box next to its name, and then clicking on the blue left arrow icon.

  9. Once you have selected one or more destinations, click on the Next button. The Create Subscription Subscription Files dialog is displayed.

  10. Click on the SFile button to add a new subscription file. Enter the database ID and the file number in the fields DBID and File. Select a filter from the Filter drop-down list. Select a format buffer from the Format Buffer drop-down list.

    You can remove an Sfile from the definition of the subscription by clicking on the waste basket icon (graphics/waste_bin_84.png) next to the file in the list of subscription files.

  11. Click on the SAVE button to save the new subscription.

Modifying a Subscription

Start of instruction setTo modify a subscription

  1. Click on the name of the subscription that you want to modify in the list in the Subscriptions panel of the overview page.

    Or:
    Click on the name of the subscription from the Subscriptions drop-down menu.

    Or:
    Click on the name of the Subscription in the Subscriptions navigation area, if it is open.

    The details of the subscription are loaded in the data area.

  2. Click on the button Edit in the data area. You can now edit the subscription as described in the section Creating a new Subscription.

  3. Once you have made all of the changes that you want, click on the Save button in the data area to save the modified destination.

Deleting a Subscription

Start of instruction setTo delete a subscription

  1. Click on the name of the subscription that you want to delete in the list in the Subscription panel of the overview page.

    Or:
    Click on the name of the subscription from the Subscriptions drop-down menu.

    Or:
    Click on the name of the subscription in the Subscriptions navigation area, if it is open.

    The details of the subscription are loaded in the data area.

  2. Click on the Delete button in the data area.

    The pop-up Delete Subscription dialog box is displayed.

  3. Click on the button Yes, delete subscription to delete the subscription.