Conventions used in this manual

Sideheads

This manual contains different types of information:

  • Task-based information, for example, procedures containing a sequence of numbered steps
  • Reference information, for example, panel and parameter 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 PF8 to scroll downwards and PF7 to scroll upwards.

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

Panels

Panels are displayed in a monospaced font and framed in a box. 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.)
PEB4GCB -----------------------------------------------------------------------
 Command ===> _________________________________________________________________

 Started Task Status Information Subsys-ID - B92P
 Sysname - BETA

 STC Name : BETA92P JES Id : S0010230 ASID: 486
 Start Date : 15.04.2013 Start Time : 14:40:37:00
 Elapsed Time : 4033 MIN
 Status : ACTIVE
 OCF Conn. : NO ARM Conn. : NO
 DB Type : MASTER / SHARED
 System : PROD Location : BERLIN
 Storage Region / Allocated
 Above Below
 524288K / 57272K 9128K / 2804K

 STC Transaction Information
 GCB Name ===> *________ (Name or Mask)
 FCB Name ===> _________ (Name or Mask)


 Press the ENTER key to display the selected information.

Panel names are included in the index to help you find tasks and procedures that refer to certain panels.

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 |
|//INIT EXEC PGM=BST01ARI, |
|// PARM='ssid,BETA.PARMLIB(BnnSSIxx)' |
|//* |
|//*STEPLIB DD DSN=BETA.APFLOAD, |
|//* DISP=SHR |
|//* |
|//SYSUDUMP DD SYSOUT=* |
+-----------------------------------------------------------------------+

The values in lowercase italic characters must be replaced with the appropriate values, for example, nn and xx in the member name BnnSSIxx.

Dataset names

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

The manual uses the high-level qualifier BSA for BSA libraries. BETAnn is used for libraries and databases of the product with the identifier nn. For example, BSA.LOAD is used for the BSA load module library, and BETA92.LOAD is used for the _beta log|z load module library.

Libraries and databases at your data center will most likely have different names. Make sure that your JCL contains uses 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.

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.

Allowed values

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

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.

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:

SORT col1[,A|D col2,A|D col3,A|D]

Sorts the displayed table in ascending (A) or descending (D) order in accordance with the specified column(s) (col1, col2, col3.

A list of the column names is displayed in the help panel.

SORT

Displays a help panel for the SORT command for the displayed table.

TPRINT

Prints the displayed table. You can determine where you want to print in the panel TPRINT Parameter which is displayed when you enter the command in the command line.

Line commands

Line commands are displayed in the manual in bold uppercase letters. Line commands consist of one, two, or three characters.

Available line commands are listed with each panel, 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.