Using BBI control commands

BBI control commands affect the current BBI-SS PAS and its resources.

Refer to the MainView Administration Guide for information about BBI control commands.

To use BBI control commands

Enter BBI commands on the COMMAND line of any MainView AutoOPERATOR application in this format:. command keyword parameter

Each BBI control command must be entered with a period (.) prefix. Delimiters in the control command statement can be a blank, comma, or equal sign.

The following examples are the most frequently used BBI control commands. The command abbreviations are shown in bold type.

Example

Description

.D A

is the same as .DISPLAY ACTIVE ALL and writes the status of the BBI-SS PAS and its resources to the Journal log

Use LOG DISPLAY to see this information online.

.D E HIGH

is the same as .DISPLAY EXEC HIGH and displays the high-priority EXECs

.D V

is the same as .DISPLAY VPOOL and displays the EXEC statistics for the SHARED variable pools

.H E

is the same as. HELP RESET and displays an explanation of the BBI RESET control command

.HELP

displays information on all the BBI control commands

.D RULESET

displays information about Rule Sets and Rules; the command format is:

.D RULESET[,type],[rulesetid],[start],[count] where:

  • type: the type of data to be shown; this value is optional and, if not specified, defaults to ENA. The following values are valid:
    • ENA: show enabled Rule Sets
    • DIS: show disabled Rule Sets
    • TST: show Rule Sets in TST mode
    • LOD: show Rule Sets in LOADED mode
    • ALL: show Rule Sets of all types

  • rulesetid: a full or partial Rule Set name used as a mask to select Rule Sets for display; this value is optional and the defaults is an asterisk (*) if not specified

    The rulesetid must start with RUL or AAORUL to be valid.

    Example

    • RUL*
    • AAORUL*
    • AAORULA1
  • start: the relative starting Rule Set number; this value is optional and defaults to 1 (start with the first matching Rule Set) if not specified

  • count: the number of Rule Sets or Rules to display; valid values from 1 to 75; this value is optional and the defaults is 20 if not specified

    Use this parameter to limit the number of lines in the display and prevent flooding the Journal or SYSLOG with returned values.

You can omit (or skip) parameters by using a comma as a placeholder. The following list shows some sample commands:

  • .D RULESET,ENA,,,10 (displays the first 10 enabled Rule Sets)
  • .D RULESET (displays the first 20 enabled Rule Sets)
  • .D RULESET,DIS,AAORUL* (displays up to 20 disabled Rule Sets starting with the first one found that matches the characters AAORUL)
  • .D RULESET,,,15 (displays up to 20 enabled Rule Sets starting with the 15th one)

.C E 2109

is the same as .CANCEL EXEC eid (where eid is the EXEC ID number as shown in DISPLAY EXEC and can be a numeric value or the name of the EXEC)

This command cancels an EXEC that is either queued or running.

Warning

The CANCEL command causes an abnormal termination of the TSO/E EXEC command and of any other command or program that is currently running within the EXEC. The abnormal termination might result in resources, such as storage, being improperly cleaned up. Particularly, if the command or program does not explicitly issue a freemain for subpool 0 storage and relies upon task termination to clean up this storage, the storage will not be freed and an eventual private storage problem might be experienced, such as ABEND878 RC10.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*