Conventions used in this manual

Sideheads

The manuals of Adabas Audit Data Retrieval contain different types of information:

  • Task-based information, for example, procedures containing a sequence of numbered steps
  • Reference information, for example, panel and field descriptions

The sideheads in the margin help you locate the required information quickly.

Keys

All keys are written in uppercase letters. Function keys (also called program function keys) are referred to as PFn, for example:

Use PF11 to scroll to the right and PF10 to scroll to the left.

Panel navigation

All procedures and panel descriptions use the "Primary Selection Menu" as point of reference. For example:

To display the system profile options:

  • From the "Primary Selection Menu", select option P.2.

You don't have to enter these options in separate steps and you don't have to return to the "Primary Selection Menu" all the time. Do the following to access the "Beta System Profile Options" panel in one step:

Enter ...

in the command line to call this panel from ...

P.2

the Adabas Audit Data Retrieval "Primary Selection Menu"

=P.2

any Adabas Audit Data Retrieval panel

Note: The ISPF jump function is not available under VDF.

Panels

Panels are displayed in a monospaced font and framed in a box, as in the following example. As a rule, the entire panel is displayed.

The following applies to the displayed panels:

  • The padding character for required fields is the dot ( . ) and the padding character for optional fields is the underline character ( _ ).
  • The panel ID is displayed in the top-left corner of the panel. (You can turn this display on or off using the primary command PANELID.)
PEB0PRF ----------------------------------------------------------------------
 Command ===> _________________________________________________________________

 Beta System Profile Options

 System Name ===> B97PROD.
 System Location ===> BERLIN..........
 Subsystem ID : B97P
 System Level : BSA Level :
 System PTF Level : BSA PTF Level :


 User Date Mask ===> MM/DD/YYYY MM/DD/YY, DD.MM.YY, DD/MM/YY, YY.DDD
 MM/DD/YYYY, DD.MM.YYYY, DD/MM/YYYY
 YYYY.DDD, YYYY-MM-DD
 Beta Product Language ===> E (E)nglish,(G)erman

 Extended Help Mode ===> YES (Y)es, (N)o



 Press the ENTER key to update your system profile options.
 Press the END key to return to the previous menu.

JCL

JCL is displayed in a small monospaced font and framed in a dashed box. Lowercase italic characters are used for generic cards and variables.

+--------------------------------------------------------------------+
|jobcard |
|//B97DLOAD EXEC PGM=BST01RFF,REGION=0M,PARM=('S=97', |
|// 'PGM=B97DLOAD', |
|// 'B01LST=xx', |
|// 'B97LST=xx', |
|// 'SIGNON=YES') |
|//STEPLIB DD DISP=SHR, |
|// DSN=BETA97.LOAD |
|// DD DISP=SHR, |
|// DSN=BSA.LOAD |
|//* |
|//B97DEF DD DISP=SHR, |
|// DSN=BETA97.DB.DEF |
|//SFFPARM DD DISP=SHR, |
|// DSN=BETA.PARMLIB |
|... |
+--------------------------------------------------------------------+

The values in lowercase italic characters must be replaced with the appropriate values, for example xx, which stands for the last two digits of the members B01LSTxx and B97LSTxx.

Dataset names

The manual uses the high-level qualifier BETA for libraries that are typically shared by BSA and the Beta Systems products. For example, BETA.PARMLIB is used to refer to the Beta parameter library.

The manual uses the high-level qualifier BETA97 for Adabas Audit Data Retrieval libraries and databases. BSA is used for libraries of Beta Systems Architecture. For example, BETA97.LOAD is used for the Adabas Audit Data Retrieval load module library, and BSA.LOAD is used for the BSA load module library.

Libraries and databases at your data center will most likely have different names. Make sure that your JCL has the correct high-level qualifiers, which comply to the conventions used at your data center.

Listings and reports

Like JCL, listings and reports are also displayed in a small monospaced font and framed in a dashed box.

Console commands

Console commands are displayed in a large monospaced font. For example:

To start the product started task, enter the following console command:

S stcname

where stcname must be replaced with the name of the product started task.

Primary commands

Primary commands are displayed in uppercase letters. To execute a primary command, type the primary command in the command line and press ENTER.

Many primary commands have a long form and one or several short forms. Instructions in this manual use the long form of the primary command and include short forms in parentheses. For example:

In the Beta Browser, enter the primary command LASTPAGE (LP) to display the last hit page.

Generic names and variables

Generic names and variables are displayed in lowercase italic letters. For example:

To display a specific page in the Beta Browser, enter the following primary commands (long or short form):

PAGE n (P n)

where n must be replaced with the desired page number.

Allowed values

Allowed values are separated using a vertical bar ( | ). Square brackets indicate that a parameter is optional.

For example, the primary command PAGEBREAK ON (PBR ON) turns the display of page breaks on, the primary command PAGEBREAK OFF (PBR OFF) turns the display of page breaks off, and the primary command PAGEBREAK (PBR) without any parameters toggles between the two. This is indicated in the syntax of the primary command as follows:

PBR [ON|OFF]

Line commands

Line commands are written in bold uppercase letters. Line commands consist of one, two, or three characters. The manual shows available line commands like this:

A

Description of line command A

AB

Description of line command AB

To execute a line command, type the line command in the Sel column of the table in front of the desired entry and press ENTER.

The available line commands are displayed in ISPF tables underneath the panel title. Depending on the table type, you can switch this display off by entering Extended help = No in your profile (option P.2).

You can also switch the display on and off with the primary commands PROF HL OFF and PROF HL ON.

Keyword and positional parameters

Keyword parameters and positional parameters are displayed in a monospaced font using the following syntax:

PARM='ssid[,TRACE=Y|N]'

ssid is a required positional parameter where ssid refers to the subsystem ID. The subsequent keyword parameter is optional, which is indicated by square brackets. A vertical bar separates alternative values. Keywords are displayed in uppercase letters.

Double-dot operator

The double-dot operator between integers indicates a range of integer values. For example, 2..5 expands to a list containing the values 2, 3, 4, and 5.