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:
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 |
| 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 |
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 4. Add Source Files and related parameters to the Subscription Definition
To access the Subscription Definition area of the Adabas
Auditing Configuration, complete the following steps:
Select S from the Adabas Auditing Configuration main menu to list the Subscription definitions, as described above in Listing Subscription Definitions.
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
To specify a Subscription definition ID and description:
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.
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.
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.
Although no Destinations or Source Files have yet been specified for the Subscription definition, press PF5 to save it.
To add one or more Destinations to the Subscription
definition:
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
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 - +
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.
To add/modify one or more Source Files (and related parameters)
to the Subscription definition:
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
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:
Press PF5 to save the Source File and related file parameters to the Subscription definition.
To save the Subscription definition:
Press PF5 to save the Subscription definition in the Auditing system file.
To use the Adabas Auditing Configuration to modify a Subscription
definition in the Auditing system file:
List the Subscription definitions in the Adabas Auditing Configuration, as described above in Listing Subscription Definitions.
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.
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.
When all modifications have been made, press PF5 to save the changes.
To use the Adabas Auditing Configuration to copy a Subscription
definition in the Auditing system file:
List the Subscription definitions in the Adabas Auditing Configuration, as described in Listing Subscription Definitions.
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
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.
To use the Adabas Auditing Configuration to delete a Subscription
definition in the Auditing system file:
List the Subscription definitions in the Adabas Auditing Configuration, as described in Listing Subscription Definitions.
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.