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 Title Name 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 Name - + 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 Name or Title |
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 Name 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 Title ............ PAYROLL_APPLICATION_SUBSCRIP_2 Subscription Name ............. 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 name and description:
Tab to the Subscription Title field and specify a unique title for the Subscription definition. The title must use alphanumeric characters and be between 1 and 32 characters long. Embedded spaces are automatically changed to underscores.
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 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 name 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 Name .. PAYRSUB2 Description ... PAYROLL APPLICATION EXT-2 Subscription Title . PAYROLL_APPLICATION_SUBSCRIP_2 Name Name Name Name Name -------- -------- -------- -------- -------- AUDIT1__ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ Command ==> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Save Sel Menu
Type the required Destination name (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 Name Typ Sel Name Typ Sel Name Typ Sel Name 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 name 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 Title TITLE_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 Title ........... TITLE_FOR_SUBSCRIPTION_TEST1 Subscription Name ............ TEST1 Current Description .................. TEST 1 DBID / File Number ........... _____ ____ Format and Filter Settings Request FB name ________ Data Format Buffer name ...... _______ Request Filter name ..... ________ Data Filter name ............. ________ MF Client FB name ... ... ________ Data Filter FB name .......... _______ MF Client Filter name ... ________ Data Origin (Mf,Luw,Both) _ LUW Client FB name ..... ________ LUW Client Filter name ________ 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 Title | The previously entered title of the current Subscription. | none |
Subscription Name | The previously entered name 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 name | Choose an existing FB for the Data being sent. | none |
Data Filter name | Choose an existing Filter name to apply to the Data Format Buffer. | none |
Data Filter FB name | Choose an existing Format Buffer that applies to the Data Filter name 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 name | Cannot be chosen at this release, internal default. | none |
Request Filter name | Specify the filter name that will be applied to the Request FB for selection of data. | none |
MF Client FB name | Cannot be chosen at this release, internal default. | none |
MF Client Filter name | Specify the filter name that will be applied to the Mainframe Client FB for selection of data. | none |
LUW Client FB name | Cannot be chosen at this release, internal default. | none |
LUW Client Filter name | Specify the filter name 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 name 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 name of the Subscription definition.
If you want to rename a Subscription definition, first copy it using the name
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 name of the definition to which the list should be repositioned.
A dialog appears requesting a Title and Name for the copy of the Subscription definition.
Enter new Title: ________________________________ Name: ________ or press PF3 to cancel
Specify new, unique Title and Name 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 name of the definition to which the list should be repositioned.