Maintaining Subscription Definitions

#### Search Results

Search

# Maintaining Subscription Definitions

A Subscription is a set of specifications to be applied to the auditing of the data. These include (but are not limited to):

- Architecture key, output alpha, and wide-character keys that should be used

- Various settings relating to the availability of the subscription in specific circumstances

Subscription definitions identify subscription file definitions that should be used. At least one subscription file definition is required.

This section describes the following topics:

- Listing Subscription Definitions

- Adding Subscription Definitions

- Modifying Subscription Definitions

- Copying Subscription Definitions

- Deleting Subscription Definitions

## Listing Subscription Definitions

To use the Adabas Auditing Configuration to list the Subscription definitions stored in the Auditing system file, complete the following steps:

- Select option S from the Adabas Auditing Configuration Main Menu.

  The Available Subscriptions screen appears showing all Subscription definitions in the Adabas Auditing Configuration.

      17:52:32        ***** A D A B A S  AUDITING CONFIGURATION *****      2021-01-12
                                  Available Subscriptions                  M-RP1400

      Incomplete     Sel  Name                              ID        Description
      -------------- ---  --------------------------------  --------  --------------
      ----->  C       _   PAYROLL_APPLICATION_SUBSCRIPTION  PAYRSUB1  PAYROLL APPLIC
                      _   WAREHOUSE_APPLICATION_SUBSCRIPT   WHS00011  WAREHOUSE APPL

      Command ==>

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

  The following tables describe the options on this menu.

  Sel | Allows you to:
  --- | ---
  M/E/S | Modify a Subscription definition
  C | Copy a Subscription definition
  D | Delete a Subscription definition
  PF Key | Allows you to:
  PF1 | Get screen help
  PF2 | Reposition to a specific Subscription definition in the list
  PF3 | Exit this screen and return to the previous screen
  PF4 | Add a new Subscription definition
  PF6 | Toggle between the sorting of Subscriptions by ID or Name
  PF12 | Exit this screen and return to the main menu

## Adding Subscription Definitions

To use the Adabas Auditing Configuration to add a Subscription definition to the Auditing system file, complete the following steps:

- Step 1. Access the Subscription Definition Area of the Adabas Auditing Configuration

- Step 2. Specify a Subscription Definition ID and Description

- Step 3. Add Destination(s) to the Subscription Definition

- Step 4. Add Source Files and related parameters to the Subscription Definition

- Step 5. Save the Subscription Definition

### Step 1. Access the Subscription Definition Area of the Adabas Auditing Configuration

To access the Subscription Definition area of the Adabas Auditing Configuration, complete the following steps:

1. Select S from the Adabas Auditing Configuration main menu to list the Subscription definitions, as described above in Listing Subscription Definitions.

2. Press PF4 (Add).

   The Subscription Definition screen appears.

       18:00:49        ***** A D A B A S  AUDITING CONFIGURATION *****      2021-01-12
                                  Subscription Definition                   M-RP1410

       Subscription Name ............. PAYROLL_APPLICATION_SUBSCRIP_2
       Subscription ID ............... PAYRSUB2
       Description ................... PAYROLL APPLICATION EXT-2

       Destination Name List ......... _
       File-related Parameters ....... _

       Subscription Active ........... Y

       Command ==>

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

### Step 2. Specify a Subscription Definition ID and Description

To specify a Subscription definition ID and description:

1. Tab to the Subscription Name field and specify a unique name for the Subscription definition. The name must use alphanumeric characters and be between 1 and 32 characters long. Embedded spaces are automatically changed to underscores.

2. Tab to the Subscription ID field and specify a unique ID for the Subscription definition. The ID must use alphanumeric characters and be between 1 and 8 characters long.

3. Tab to the Description field and specify a description of the Subscription. The description must use alphanumeric characters and be between 1 and 32 characters long.

4. Although no Destinations or Source Files have yet been specified for the Subscription definition, press PF5 to save it.

### Step 3. Add Destination(s) to the Subscription Definition

To add one or more Destinations to the Subscription definition:

1. On the Subscription Definition screen for the Subscription being added mark the Destination Name List field with any character (e.g. “S”).

   The Destination List screen appears with the Subscription ID listed at the top of the screen.

       18:04:58        ***** A D A B A S  AUDITING CONFIGURATION *****      2021-01-12
                                      Destination List                      M-RP1440
                                         Current
       Subscription ID ... PAYRSUB2 Description ... PAYROLL APPLICATION EXT-2
       Subscription Name . PAYROLL_APPLICATION_SUBSCRIP_2

        ID              ID              ID              ID              ID
       --------        --------        --------        --------        --------
       AUDIT1__        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________
       ________        ________        ________        ________        ________

       Command ==>

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

2. Type the required Destination ID (if you know it) into the list, and press PF5 to save.

   Alternatively, you can press PF6 which will display the following pop-up screen which lists all the available Destinations:

       18:12:22    ***** A D A B A S  AUDITING CONFIGURATION *****     2021-01-12
                                     Available Destinations                M-RP1201

           Sel   ID     Typ   Sel   ID     Typ   Sel   ID     Typ   Sel   ID   Typ
           -----------------  -----------------  -----------------  ----------------
            _  AUDIT1   AUD
            _  AUDIT2   AUD
            _  DESTXYZ  AUD
            _  INPL1    NUL
            _  INPL2    AUD
            _  NULL1    NUL
            _  NULL2    NUL
            _  TESTDAY1 AUD
            _  TESTNUL2 NUL

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

3. Choose the required Destination by selecting it with an “S” and press PF5 to accept it.

   The selected Destination is added to the Subscription definition.

### Step 4. Add Source Files and related parameters to the Subscription Definition

To add/modify one or more Source Files (and related parameters) to the Subscription definition:

1. On the Subscription Definition screen for the Subscription being added/modified mark the File-related Parameters field with any character (e.g. “S”).

   The List of Subscription SFILEs screen appears with the Subscription ID listed at the top of the screen.

       18:24:17        ***** A D A B A S  AUDITING CONFIGURATION *****      2021-01-12
                                 List of Subscription SFILEs                M-RP1415
       Subscription  TEST1       Current
                     Name   NAME_FOR_SUBSCRIPTION_TEST1
                           send Data        send FB   send Request  send Client
        Sel   DBID  File   S  D  I  U  BI   S  I  U   S  D  I  U    S  D  I  U
        -----------------------------------------------------------------------------
         _    1955     1   Y  Y  Y  Y  N    Y  Y  Y   Y  Y  Y  Y    Y  Y  Y  Y

       Command ==>

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

2. Press PF4 to add a new Subscription SFILE entry.

   The File-Related Parameters screen appears, either by PF4 (when adding an entry) or by selecting an entry (when modifying an existing entry).

       18:55:19        ***** A D A B A S  AUDITING CONFIGURATION *****      2021-01-12
                                  File-Related Parameters                   M-RP1420

       Subscription Name ........... NAME_FOR_SUBSCRIPTION_TEST1
       Subscription ID ............. TEST1     Current
       Description .................. TEST 1
       DBID / File Number ........... _____  ____
                                  Format and Filter Settings
                                                  Request FB ID             ________
       Data Format Buffer ID ........ _______     Request Filter ID ....... ________
       Data Filter ID .......::...... ________    MF Client FB ID ......... ________
       Data Filter FB ID .::......... _______     MF Client Filter ID ..... ________
       Data Origin (Mf,Luw,Both)      _           LUW Client FB ID  ....... ________
                                                  LUW Client Filter ID      ________
       Buffers       Data BI FB SB VB UB Req Clnt
       Select cmd ...  Y      Y  N  N  N  Y   Y
       Insert cmd ...  Y      Y           Y   Y
       Update cmd ...  Y   N  Y           Y   Y
       Delete cmd ...  Y                  Y   Y

       Command ==>

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

   The File-related parameter field names are described in the following table:

   Field Name | Description | Default
   --- | --- | ---
   Subscription Name | The previously entered Name of the current Subscription. | none
   Subscription ID | The previously entered ID of the current Subscription. | none
   Description | The previously entered description of the current Subscription. | none
   DBID / File Number | Specify the DBid and the file number for which you want to have Auditing information extracted. | none
   Data Format Buffer ID | Choose an existing FB for the Data being sent. | none
   Data Filter ID | Choose an existing Filter ID to apply to the Data Format Buffer. | none
   Data Filter FB ID | Choose an existing Format Buffer that applies to the Data Filter ID chosen. | none
   Data Origin (Mf,Luw,Both) | Specify the origin of the audit event; M for Mainframe (MF), L for Linux/Unix/Windows (LUW), or B for Both. | none
   Request FB ID | Cannot be chosen at this release, internal default. | none
   Request Filter ID | Specify the filter ID that will be applied to the Request FB for selection of data. | none
   MF Client FB ID | Cannot be chosen at this release, internal default. | none
   MF Client Filter ID | Specify the filter ID that will be applied to the Mainframe Client FB for selection of data. | none
   LUW Client FB ID | Cannot be chosen at this release, internal default. | none
   LUW Client Filter ID | Specify the filter ID that will be applied to the LUW Client FB for selection of data. | none
   Data Buffer | Set indicators of “Y”, or “N” if you desire the buffer to be sent for Select, Insert, Update, or Delete commands. | Y
   BI Buffer | Set to “Y” if the Before Image Data buffer is required to be sent. | N
   FB Buffer | Set to “Y” if the Format Buffer data is required to be sent. | Y
   SB Buffer | Future setting, not used at the Beta release. | N
   VB Buffer | Future setting, not used at the Beta release. | N
   UB Buffer | Future setting, not used at the Beta release. | N
   Request Buffer (Req) | For the Beta release, not available for choice. | Y
   Client Buffer (Clnt) | For the Beta release, not available for choice. | Y

   Notes:

   1. The PF6 selection option applies to any of the Format or Filter ID fields. Simply place the cursor at the desired field location, press PF6, and you get a selection of the appropriate values to select from. You can also enter the name for those fields without going through the selection process.
   2. For the Buffer areas, with the commands listed; only the Data, BI, and FB fields are selectable for setting at this release.

3. Press PF5 to save the Source File and related file parameters to the Subscription definition.

### Step 5. Save the Subscription Definition

To save the Subscription definition:

- Press PF5 to save the Subscription definition in the Auditing system file.

## Modifying Subscription Definitions

To use the Adabas Auditing Configuration to modify a Subscription definition in the Auditing system file:

1. List the Subscription definitions in the Adabas Auditing Configuration, as described above in Listing Subscription Definitions.

2. Locate the definition you want to modify on the screen and enter an M in the Sel column for that definition.

   You can locate the definition you want in the list by pressing the PF7 (F7) or PF8 (F8) keys to scroll through the list. You can also press PF2 (F2) to specify the ID of the definition to which the list should be repositioned.

   An appropriate Subscription definition screen appears for the Subscription you selected.

3. For information about the fields on this screen, refer to the field descriptions described above in Adding Subscription Definitions.

   Note
   You cannot alter the ID of the Subscription definition. If you want to rename a Subscription definition, first copy it using the ID you want and then delete the original.

4. When all modifications have been made, press PF5 to save the changes.

## Copying Subscription Definitions

To use the Adabas Auditing Configuration to copy a Subscription definition in the Auditing system file:

1. List the Subscription definitions in the Adabas Auditing Configuration, as described in Listing Subscription Definitions.

2. Locate the definition you want to copy on the screen and enter a C in the Sel column for that definition.

   You can locate the definition you want in the list by pressing the PF7 (F7) or PF8 (F8) keys to scroll through the list. You can also press PF2 (F2) to specify the ID of the definition to which the list should be repositioned.

   A dialog appears requesting a Name and ID for the copy of the Subscription definition.

        Enter new
         Name: ________________________________
           ID: ________
        or press PF3 to cancel

3. Specify new, unique Name and ID for the copy of the Subscription definition and press Enter.

   The Subscription definition is copied, and the copy appears on the Available Subscriptions screen.

## Deleting Subscription Definitions

To use the Adabas Auditing Configuration to delete a Subscription definition in the Auditing system file:

1. List the Subscription definitions in the Adabas Auditing Configuration, as described in Listing Subscription Definitions.

2. Locate the definition you want to delete on the screen and enter a D in the Sel column for that definition.. Press Enter. The Subscription definition is deleted.

   You can locate the definition you want in the list by pressing the PF7 (F7) or PF8 (F8) keys to scroll through the list. You can also press PF2 (F2) to specify the ID of the definition to which the list should be repositioned.

### On this page

- Listing Subscription Definitions
- Adding Subscription Definitions
- Modifying Subscription Definitions
- Copying Subscription Definitions
- Deleting Subscription Definitions