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.

       16:39:51        ***** A D A B A S  AUDITING CONFIGURATION *****      2025-08-20
                                 List of Subscription SFILEs                M-RP1415
       Subscription  #A1243      Current
              Name   #A1243
                           File Type                  send Request  send Client
        Sel   DBID  File   Nat Sec Cor     User       S  D  I  U    S  D  I  U
        -----------------------------------------------------------------------------
         _       1     1    Y                         Y  Y  Y  Y    Y  Y  Y  Y
         _       3     3            Y                 Y  Y  Y  Y    Y  Y  Y  Y
         _       4    45        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).

       16:42:05        ***** A D A B A S  AUDITING CONFIGURATION *****      2025-08-20
                                  File-Related Parameters                   M-RP1420

       Subscription Name ............ #A1243
       Subscription ID .............. #A1243    Current
       Description .................. TEST ONE
       DBID / File Number ........... ____4  __45
                                  Schema and Filter Settings
       File Type (N,S,C,' ') ........ S           Request Schema .......... REQUEST
       Data Schema .................. NSC-ANY     Request Filter .......... ________
       Data Filter Criteria ......... ________    MF Client Schema ........ CLIENT_
       Data Filter Schema Criteria .. _______     MF Client Filter ........ ________
       Data Origin (Mf,Luw,Both) .... B           LUW Client Schema ....... CLIENTL
                                                  LUW Client Filter ....... ________
       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               FType             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
   File Type | Used to select options on a pop-up map. Specify N for Natural (NAT), S for Security (SEC), or C for Adabas System Coordinator (COR). See also File Type below. | blank - indicates a "user" file type
   Data Schema | Choose an existing File Schema for the Data being sent. | none
   Data Filter Criteria | Choose an existing Filter ID to apply to the Data File Schema. | none
   Data Filter Schema Criteria | Choose an existing File Schema 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 Schema | Cannot be chosen at this release, internal default. | none
   Request Filter | Specify the filter ID that will be applied to the Request File Schema for selection of data. | none
   MF Client Schema | Cannot be chosen at this release, internal default. | none
   MF Client Filter | Specify the filter ID that will be applied to the Mainframe Client File Schema for selection of data. | none
   LUW Client Schema | Cannot be chosen at this release, internal default. | none
   LUW Client Filter | Specify the filter ID that will be applied to the LUW Client File Schema 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 this release. | N
   VB Buffer | Future setting, not used at this release. | N
   UB Buffer | Future setting, not used at this release. | N
   Request Buffer (Req) | For this release, not available for choice. | Y
   Client Buffer (Clnt) | For this release, not available for choice. | Y

   Notes:

   1. The PF6 selection option applies to any of the File Schema 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. PF9 presents the pop-up windows again, based on the setting of File Type.

   #### File Type

   One of the following pop-ups is shown, based on the setting of File Type:

   - When N (Natural) is selected, the following pop-up is shown:

               - File View Natural -
                    Selections

            Load ....................... _
            Source ..................... _

            Enter 'Y' for selecting

            PF3---
            Cancel

   - When S (Security) is selected, the following pop-up is shown:

               - File View Selections -
            Natural
             Load .................... _
             Source .................. _

            Security
            Choose objects ........... _

            Mark selections with 'Y'

            PF3---
            Cancel

     If you mark Security Choose objects, additional pop-ups are shown:

                         - Security View: Other Objects 1 of 2 -

            Base application record ... _   Link member group ........... _
            Comp. application record .. _   Link node ................... _
            Control record ............ _   Link owner .................. _
            Default library profile ... _   Link Predict PRD-3GL-Library. _
            Default user profile ...... _   Link Predict PRD-doct-object. _
            Default utility profile ... _   Link Predict PRD-ext-object.. _
            Link dataset .............. _   Link Predict PRD-function ... _
            Link DDM modifier ......... _   Link printer ................ _
            Link disallowed modules ... _   Link private mode library ... _
            Link environment .......... _   Link steplib library ........ _
            Link file ................. _   Link user library ........... _
            Link library processor user _   Link user library commands .. _
            Link mailer mailbox ....... _   Link user library processors. _
            PF3 Cancel   PF10 Sel All   Enter Y for selecting and next page

     and

                         - Security View: Other Objects 2 of 2 -

            Link user mailbox ......... _   Profile mailbox ............. _
            Link utility .............. _   Profile Natural ............. _
            Logon errors .............. _   Profile NatWebio server ..... _
            Logon records ............. _   Profile node ................ _
            Logon user exit error ..... _   Profile operations .......... _
            Predict PRD-3GL-library ... _   Profile printer ............. _
            Predict PRD-docu-object ... _   Profile RPC server .......... _
            Predict PRD-extern-object . _   Profile user ................ _
            Predict PRD-function ...... _   Profile Utility ............. _
            Profile batch job ......... _   Profile Volume Serial ....... _
            Profile dataset ........... _   Profile VTAM application .... _
            Profile file .............. _   Release ET .................. _
            Profile library ........... _
            PF7 Previous page   PF10 Sel All   Enter Y for selecting

   - When C (Adabas System Coordinator) is selected, the following pop-up is shown:

                      - Adabas System Coordinator -
            Group parameter ........ _   Client Runtime Ctrl
            Daemon parameter ....... _     Base .......... _
            System settings ........ _     Override ...... _
                                           Cluster ....... _
                           - Adabas Fastpath -
            Buffer parameter ....... _   Buffer history .. _
            File parameter   ....... _   System settings . _
                            - Adabas Vista -
            Trans. target category . _   Partitioning .... _
            Trans. generation ...... _   System settings . _
            Trans. generation delta. _
            Trans. rule ............ _
            Trans. page ............ _
                          - Adabas SAF Security -
            System settings ........ _

            PF3 Cancel   PF10 Sel All   Enter Y to select

   Based on your selections, the File Schema entry will be chosen for you.

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