Limited support

   

BMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.

BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Ops Infrastructure 7.1  .

BBI control commands

BBI control commands are used to control resources and functions.

Tip

The information described in this chapter applies to the following products only:

  • BMC AMI Ops Automation

  • BMC AMI Ops Monitor for CICS

  • BMC AMI Ops Monitor for Db2

  • BMC AMI Ops Monitor for DBCTL

  • BMC AMI Ops Monitor for IMS Online

  • BMC AMI Ops Monitor for MQ

These commands log the status of and modify the BBI-SS PAS online system. As described in Issuing a BBI control command, BBI control commands can be issued from a terminal session, an operator console, or a BMC AMI Ops Automation  EXEC. For example, to log the status of the target BBI-SS PAS to the journal log, the DISPLAY ACTIVE command could be entered from a terminal session as follows:

.D A

The status information can then be viewed by using the BBI general service LOG DISPLAY.

To issue BBI control commands:

  • Use a blank between commands and keywords.

  • Use an equal sign, blank, or comma between keywords and parameters.

The following table lists all the BBI control commands by using the following notation conventions:

  • Some commands, keywords, and parameters are shown in mixed case (such as Cancel). The uppercase letters (C, for example) represent a valid abbreviation.

  • The phrase Not applicable in the Parameters column means that there are no parameters for that command.

Command

Keywords

Parameters

Description

Cancel

DeLaY

delayID | ALL

( BMC AMI Ops Automation only) Cancels all delayed actions (ALL) or a specific action specified by the delayID

Use the .DISPLAY DLY command to see a list of delayed actions. After you have identified a message from the Delay ID token, you can use the .CANCEL DLY command to cancel the delayed action.

Exec

eid | All

( BMC AMI Ops Automation only) Cancels the EXEC identified by eid (either running or queued) or cancels all EXECs

Warning

Use extreme caution when using the ALL keyword as all EXECs that are running or queued at that point in time will be canceled.

Display



















































Active

Not applicable

Logs the status of the BBI-SS PAS

Active

Configuration

Displays information about BBPARM members configured in the BBCFG ddname in the JCL for this PAS (Use command syntax .D A C)
BBparm

Dataset

Displays information about the data sets concatenated together in the BBIPARM ddname in the JCL for this PAS (Use command syntax .D BB,D)
BBparmList

Displays a list of BBPARM members that are in use within this PAS. It will tell you the member name, including the suffix, and the data set from which that member was read (Use command syntax .D BB,L)

AOLOG

Not applicable

( BMC AMI Ops Automation only) displays the current status of the Automation Logger application

DeLaY

All | commandType

( BMC AMI Ops Automation only) Displays a list of delayed actions sorted by the Delay ID token, which is assigned to a message when it is delayed

commandType is the type of delay you want to view. The following values are valid:

  • WTO

  • EXEC

  • MQEXEC

  • CMDCICS

  • CMDSS

  • CMDBBI

  • CMDNETV

  • CMDMQ

  • CMDIMS

You can use the * wildcard with commandType. For example, CMD*, shows all delayed action types that start with CMD.

After you have identified a message from the Delay ID token, you can use the .CANCEL DLY command to cancel the delayed action.

Exec

All | High | Normal | Hot | First | Stats

( BMC AMI Ops Automation only) Displays statistics for running and queued EXECs

  • STATS shows statistical information for all running and queued EXECs.

  • HIGH shows running and queued high priority EXECs.

  • NORMAL shows running and queued normal priority EXECs.

  • HOT shows running and queued EXECs that are designated as HOT priority and are queued to the Hot priority queue.

  • FIRST shows running and queued EXECs that are designated as FIRST priority and are queued to the Hot priority queue.

  • ALL shows status information or all running or queued EXECs.

For more information about EXEC priorities, refer to Using advanced automation with BMC AMI Ops Automation Open link .

Gme

All | Conn [,node] Publish | Receive Trace [,nnnn]

( BMC AMI Ops Automation only) With no parameter, displays the status of General Message Exchange (GME) connections and statistics message transmission.

  • CONN displays the status of all General Messages Exchange (GME) connections, including BIIM connections. To display a specific connection, specify a node name (such as, D G C,CELLCON1).

  • PUBLISH displays details of published subjects.

  • RECEIVE displays details of the applications that are registered to receive messages.

  • TRACE displays a summary of the trace records by class. TRACE,nnnn displays up to 10 trace records starting with the specified trace record sequence number.

Image

Not applicable

( BMC AMI Ops Monitor for CICS , BMC AMI Ops Monitor for IMS Online , BMC AMI Ops Monitor for DBCTL , BMC AMI Ops Monitor for Db2 only) Logs the status of BBI-SS PAS image log

JESF

Not applicable

( BMC AMI Ops Automation only) Displays the current status of the JES filter setting (inactive or active)

Journal

Not applicable

Logs the status of the BBI-SS PAS journal log and the Logger

Link

All | ssid

Logs the status of all or specified communication links to this BBI-SS PAS

MVLog

Not applicable

Displays the current settings for Logger and diagnostic information about its use

If MVLOG=NO was specified in BBISSPxx, a message is issued that indicates no data is available.

PARTNERS

Not applicable

( BMC AMI Ops Automation only) Displays the status of the TapeSHARE partners in the TapeSHARE PLEX

Products

prdname ACTIVE | INACTIVE

Displays all BBI products with their current status which can be

  • prdname is the name of the product.

  • ACTIVE indicates that the product was initialized properly and was not stopped.

  • INACTIVE indicates that the product was initialized properly at BBI-SS PAS startup, but it was stopped or was not found (not initialized properly).

Remote

Not applicable

Displays status of all remote terminal session users connected to this BBI-SS PAS through a remote BBI-SS PAS

RULES

Not applicable

( BMC AMI Ops Automation only) Shows whether BMC AMI Ops Automation R Rule processing is enabled or disabled

RULESET

[,ruleStatus],[ruleSetName],[start],[count]

( BMC AMI Ops Automation only) Displays Rule Sets that are in the status specified in the command. The default parameters are:
D RULESET,ENA,*,1,20.

  • ruleStatus
    Displays Rule Sets that are in the specified status. This value is optional and defaults to ENA if not specified.

    The following lists all of the possible valid values:

    • ENA
      Display Rule Sets with a status of enabled

    • DIS
      Display Rule Sets with a status of disabled

    • TST
      Display Rule Sets with a status of test

    • LOD
      Display Rule Sets with a status of loaded

    • ALL
      Display all Rule Sets regardless of the status

  • ruleSetName
    A full or partial Rule Set name used to select Rule Sets for display. This value is optional and defaults to an asterisk (*) if not specified

    The ruleSetName must start with RUL or AAORUL to be valid; for 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).

  • count
    The number of Rule Sets or Rules to display. This value is optional and defaults to 20. Valid values are from 1 to 75.

    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
    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.
RULESET,RUL,[ruleSetName],[start],[count]

( BMC AMI Ops Automation only) Displays all of the Rules within the specified Rule Sets. The default parameters are:
D RULESET,RUL,*,1,20.

  • ruleSetName
    A full or partial Rule Set name used to select Rule Sets for display. This value is optional and defaults to an asterisk (*) if not specified

    The ruleSetName must start with RUL or AAORUL to be valid; for example:

    • RUL*
    • AAORUL*
    • AAORULA1

  • start
    The relative starting Rule number. This value is optional and defaults to 1 (start with the first matching Rule Set).

  • count
    The number of Rules to display. This value is optional and defaults to 20. Valid values are from 1 to 75.

    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.

RULESET,OV

( BMC AMI Ops Automation only) Displays status information about automation.

SOF

Not applicable

( BMC AMI Ops Automation only) Displays the Shared Object Facility

SSR

Not applicable

Displays subsystem resource usage, including CPU usage for each exit

TIMER

ALL [anyname] |
EXEC [execname] |
RULE [rulename] |

MON [monitorname]

Displays the status of one or more time-initiated EXECs or TIME-initiated Rules that are currently running. If no parameter value is specified, only time-initiated EXECs are displayed.

  • ALL: ( BMC AMI Ops Automation only) show all time-initiated EXEC and all TIME-initiated Rules that are currently running. Monitors are not displayed as part of this option. If anyname is specified, only EXECs pr Rules with matching names are displayed. You can specify generic and wildcard characters in anyname. This parameter can be abbreviated to A. For example:

    .D TIMER ALL
    .D TIMER A Q*
    .D TIMER ALL Q++VB*
  • EXEC: ( BMC AMI Ops Automation only) show all time-initiated EXECs that are currently running. If execname is specified, only the named EXEC will be displayed. You can specify generic and wildcard characters in execname. This parameter can be abbreviated to E. For example:

    .D TIMER EXEC
    .D TIMER E QAOV*
    .D TIMER EXEC EX++AO*

RULE: ( BMC AMI Ops Automation only) show all TIME-initiated Rules that are currently running. If rulename is specified, only the named Rule will be displayed. You can specify generic and wildcard characters in rulename. This parameter can be abbreviated to R. For example:

.D TIMER RULE
.D TIMER R RULAO*
.D TIMER RULEC RUL++AO*

  • MON: (any BMC AMI Ops product) show all monitors that are currently running. If monitorname is specified, only the named monitor will be displayed. You can specify generic and wildcard characters in monitorname. This parameter can be abbreviated to M. For example:

    .D TIMER MON
    .D TIMER M TRCDB2*
    .D TIMER MON MY+++M*

User

ALL | name

Logs status of all terminal session users assigned to this BBI-SS PAS

Vpool

ALL | name[PROFILE | SHARED]

( BMC AMI Ops Automation only) Displays the SHARED (default) or PROFILE variable pool statistics for the named variable or for all variables

XCF

Not applicable

Displays the other BBI-SS PASs that this PAS is connected to, their cross-system coupling facility (XCF) member names, and how many requests are pending on this connection

Get

dddd

ONLINE GIVE | NOGIVE TAKE | NOTAKE

( BMC AMI Ops Automation only) Allows you to VARY the status of a tape device online where dddd is the device address

Valid parameters are

  • ONLINE locates the device on any TapeSHARE partner, VARYs it offline to that partner, and online to the local partner.

  • GIVE | NOGIVE changes the status of the device. You can use this parameter with ONLINE. For example, to VARY a device online and not allow it to be given back to its original partner, specify .G dddd,ONLINE,NOGIVE

  • TAKE | NOTAKE changes the status of the device. You can use this parameter with ONLINE. For example, to VARY a device online and not allow it to be taken by another partner, specify .G dddd,ONLINE,NOTAKE

Help

ALL command

Not applicable

Displays syntax information and examples for the BBI control commands

You can request information for a specified command, (.H D) or for all commands (.H ALL). The default is ALL.

Locate

U,dddd

Not applicable

( BMC AMI Ops Automation only) Locates and displays the status of a device, where dddd is the device address

rEset































































Auth

ALL| userid

(BMC proprietary security only) Re-creates the BBPARM data set authorization of all terminal session users or one specific user on this BBI-SS PAS

If ALL is specified, all authorization is re-created for local and remote users, as well as the generic authorization that is defined by $GENERIC, $USERID, and $RMTID.

Bldl

SYSPROC

( BMC AMI Ops Automation only) Reissues the BLDL for the data set (BBPROC) that is allocated by DD name SYSPROC to activate EXEC members that are added or to delete members

The RESET command is not required when existing members are modified because the changes take place immediately.

BM

DB2id

( BMC AMI Ops Monitor for Db2 only) Stops and restarts the connection between BMC AMI Ops Monitor for Db2 and the specified target Db2 subsystem

Dumps

Not applicable

Reuses the dump data set until a reset dump command is issued from a terminal session

Dump data sets are cleared only when specified in the SSJCL.

Exec

Not applicable

( BMC AMI Ops Automation only) Resets the statistics for running and queued EXECs

Gme

nodename | connectionName

nodename stops and restarts communication with a General Messages Exchange (GME) node by using the parameters that are specified in the active AAOGMExx member.

As a GME node, the value TGTNAME can be used as nodename whose connection is to be stopped and started. Typically, this name will be the workstation ID of the system where the remote GME node is running.

connectionName stops and restarts communication with the defined connection by using the parameters that are specified in the active AAOGMExx member.

MVLog

Not applicable

Stops the connection to the active instance of Logger (if any), and starts a new connection to an instance of Logger by using the current values of the MVLOG and MVLOGSS parameters in member BBISSPxx

If MVLOG=NO is found in BBISSPxx, .E MVLOG has the same effect as .P MVLOG (that is, Logger is not restarted).

Parm

























AAOALSxx

( BMC AMI Ops Automation only) Reinitializes the parameters that are specified in member AAOALSxx

AAOARPxx

( BMC AMI Ops Automation only) Reinitializes the parameters that are specified in member AAOARPxx

AAOEXPxx

( BMC AMI Ops Automation only) Reinitializes the parameters that are specified in member AAOEXPxx

AAOGMExx, RECYCLE

AAOGMExx, RESYNC

Reinitializes the parameters that are specified in member AAOGMExx

Valid options are:

  • RECYCLE stops the entire GME component and then restarts it. All current connections are restarted, and new connections are established based on the AAOGMExx member and the MCELL.DIR data set.

  • RESYNC stops any active GME connections that might exist (but have been removed from the active AAOGMExx member) and starts any new connections that might have been added to AAOGMExx since the recycle or startup of BMC AMI Ops Automation .

AAORULxx

Reinitializes the AAORULxx Rule Set

AAOTRNxx

( BMC AMI Ops Automation only) Reinitializes the parameters that are specified in member AAOTRNxx

AAOTSPxx

( BMC AMI Ops Automation only) Reinitializes the parameters that are specified in member AAOTSPxx

CMRCTG

( BMC AMI Ops Monitor for CICS only) Resets the current CICS Transaction Gateway (CTG) monitoring parameters to the parameters that are specified in member CMRBEXnn

CMRPRBT

( BMC AMI Ops Monitor for CICS only) Reinitializes a table that sets default and user threshold values for messages displayed with the PROBLEM service or background problem services

CMRSECU

( BMC AMI Ops Monitor for CICS and BMC AMI Ops Automation for CICS option only) Reinitializes the CMRSECU module and creates a table of security definitions

CMRSOPT region

( BMC AMI Ops Monitor for CICS only) Reinitializes a startup table of monitoring parameters for the CICS environment

The format of the command is

.E PARM CMRSOPT region

where region is the name of the target CICS region to have its CMRSOPT reset.

DMRBEX00 or IMFBEX00

( BMC AMI Ops Monitor for Db2 , BMC AMI Ops Monitor for IMS Online , and BMC AMI Ops Monitor for DBCTL only) DMRBEX00 resets the BMC AMI Ops Monitor for Db2 message logging, background sampler exception, and application trace parameters.

IMFBEX00 defines the BMC AMI Ops Monitor for IMS Online and BMC AMI Ops Monitor for DBCTL parameters for application trace defaults, detail trace buffer allocation, excessive threshold values, shared queues data collection rates, and monitor dump values.

RUL xxxxx

Reinitializes the RULxxxxx Rule Set

QManager

MQssid

( BMC AMI Ops Automation only) Stops and restarts the connection to the specified MQ queue manager

The MQ queues that are being monitored by BMC AMI Ops Automation are closed and reopened.

RULes

Not applicable

( BMC AMI Ops Automation only) Disables all currently active Rule Sets and re-enables the Rule Sets that are defined with the RULESET parameter in BBPARM member AAOPRMxx

If you had manually enabled any Rule Sets after the BBI-SS PAS started, those Rule Sets are not restarted with this command.

Stats

Not applicable

( BMC AMI Ops Automation only) Resets message and automation statistics

TS

VALIDATE

( BMC AMI Ops Automation only) Checks the path validity for all tape devices

For example, suppose a path was marked as ACTIVE before this command is issued. If the path for a tape device becomes INACTIVE when the .E TS,VALIDATE command is issued, the entry in the device table for that tape device will be marked as INACTIVE.

seT

DAE

[ON | OFF]

Activates (or deactivates) the DAE setting in member BBISSPxx

DUMPS=

[YES | NO | SDUMP]

(BBI-SS PAS only) Controls the creation of BBI-formatted dumps

If SDUMP is specified, SVC dumps are created for the BBI-SS PAS.

JESFLTR

[CMD | WTO]

( BMC AMI Ops Automation only) Modifies the JESFLTR setting in member BBISSPxx

RULE

[ENA | DIS | TEST] ruleID

( BMC AMI Ops Automation only) Enables, disables, or places a Rule into test mode by ruleID

Examples of this command are:

  • .T RULE,ENA,ICH00001
  • .T RULE,TEST,ICH00012

RULESET

[ENA | DIS | RES | RFSH | SAV | TST], RuleSetName

( BMC AMI Ops Automation only) Enables or disables a specific Rule Set by RuleSetName

You also can reset or save a Rule Set by RuleSetName. Resetting a Rule Set is the same as disabling and re-enabling a Rule Set.

Specifying TST puts the specified Rule Set in TEST mode.

Examples of this command are:

  • .T RULESET,ENA,RUL01CSM
  • .T RULESET,RES,AAORUL01
  • .T RULESET,SAV,AAORUL02
  • .T RULESET,TST,RULMQS01

The RFSH parameter has the same effect as using the RES parameter in reloading the Rule Set from BBPARM (disk) but without interrupting TIME-initiated Rules (that are unmodified).

For example, the Rule Set RULTIM02 is newly read from BBPARM (disk) similar to using the RES parameter. However the RES parameter causes TIME-initiated Rules in RULTIM02 to be deleted and re-created. A TIME-initiated Rule might skip firing if it is Reset or, enabled shortly before the appointed firing time.

The RES parameter also suspends ATSTART TIME-initiated Rules and these Rules will not fire again until the next PAS start.

When using the RFSH parameter, the unmodified TIME-initiated Rules keep running as though the seT Ruleset command had not been issued.

RULESET

RuleSetName

( BMC AMI Ops Automation only) Disables all the currently enabled Rule Sets and enables the Rule Sets specified by RuleSetName

Prior to issuing the seT command, any Rules that you have created and enabled but have not saved to DASD will be lost when you issue the seT command.

This command does not change the setting you specified in BBPARM member AAOPRMxx; it only lets you override the setting until the BBI-SS PAS is restarted.

Start












AOLOG

Not applicable

( BMC AMI Ops Automation only) Attempts to start the connection to the Automation Logger PAS

BM

DB2id

( BMC AMI Ops Monitor for Db2 only) Attempts to re-establish a connection between BMC AMI Ops Monitor for Db2 and the target Db2 subsystem ID

If the connection is successfully established, it restarts all background monitors for that subsystem.

Exec

(patternName)

( BMC AMI Ops Automation only) Starts EXECs by using matching patternName (use * for all EXECs)

Gme

nodename| connection_name

nodename starts communication with a General Messages Exchange (GME) node by using connection parameters that are read from the active AAOGMExx member

For a list of possible values for nodename, refer to the description of RESET GME nodename in this table.

connection_name starts communication with the specified connection by using the parameters that are specified in the active AAOGMExx member.

GTS

[nn]

( BMC AMI Ops Monitor for MQ only) Starts the Generic TCP/IP Server (GTS) by using the parameters in BBPARM member BBTTCPnn, where nn is the suffix specified for the GTS=nn parameter in BBPARM member BBISSP00

If the GTS parameter is not specified in BBISSP00, member BBTTCP00 is used to start the GTS.

To override the GTS parameter in BBISSP00, specify the suffix of an existing BBTTCP nn member (for example, S GTS,02 ).

Image

Not applicable

( BMC AMI Ops Monitor for CICS , BMC AMI Ops Monitor for IMS Online , BMC AMI Ops Monitor for DBCTL , BMC AMI Ops Monitor for Db2 only) Starts image logging for the current BBI-SS PAS

Startup logic is the same as when a BBI-SS PAS is initially started.

JESconct

Not applicable

Starts the JES reconnection process, as specified in member BBISSPxx (JESCNCT=YES)

Journal

Not applicable

Starts journal logging for the current BBI-SS PAS

Startup logic is the same as when a BBI-SS PAS is initially started.

Link

ALL| ssid

Starts the communication link between the BBI-SS PAS subsystem and the current BBI-SS PAS or between all available BBI-SS PASs and the current BBI-SS PAS

START LINK attempts to open the ACB if it is not open.

MVLog

Not applicable

Starts a connection to an instance of Logger and begins logging BBI-SS PAS journal records by using the current values of the MVLOG and MVLOGSS parameters in member BBISSPxx

If MVLOG=NO is found in BBISSPxx, a message is issued that indicates Logger logging is not available.

Rules

Not applicable

( BMC AMI Ops Automation only) Starts Rules processing

stoP

BM

DB2id

( BMC AMI Ops Monitor for Db2 only) Terminates a connection between BMC AMI Ops Monitor for Db2 and the target IBM Db2 subsystem ID

Exec

(patternName)

( BMC AMI Ops Automation only) Stops the EXECs by using a specific patternName

For example, to disable scheduling of all EXECs that begin with the letter A, specify

.STOP EXEC A*

Use * for all EXECs. Issuing the command .RESET BLDL SYSPROC re-enables the scheduling of all EXECs.

GmeNot applicableStops the General Message Exchange (GME) component.

Gme

nodename | connection_name

nodename stops communication with a GME node. For a list of possible values for nodename, refer to the description of RESET GME nodename in this table.

connection_name stops communication with the specified connection. 

GTS

Not applicable

( BMC AMI Ops Monitor for MQ only) Stops the Generic TCP/IP Server (GTS)

Image

Not applicable

( BMC AMI Ops Monitor for CICS , BMC AMI Ops Monitor for IMS Online , BMC AMI Ops Monitor for DBCTL , BMC AMI Ops Monitor for Db2 only) Stops image logging for the current BBI-SS PAS

JESconct

Not applicable

Stops the JES reconnection process, as specified in member BBISSPxx (JESCNCT=NO)

Journal

Not applicable

Stops journal logging for the current BBI-SS PAS

Link

ALL | ssid

Stops the communication link between the BBI-SS PAS subsystem and the current BBI-SS PAS or all available BBI-SS PASs and the current BBI-SS PAS

MVLog

Not applicable

Stops the connection to the active instance of Logger (if any)

Rules

Not applicable

( BMC AMI Ops Automation only) Stops Rules processing

The effect is similar to inactivating all active Rule Set entries.

swItch

Image

Not applicable

( BMC AMI Ops Monitor for CICS , BMC AMI Ops Monitor for IMS Online , BMC AMI Ops Monitor for DBCTL , BMC AMI Ops Monitor for Db2 ) Switches from the current image log data set to the alternate and invokes a started task

Journal

Not applicable

Switches journal logging to the alternate data set and invokes a started task

A switch cannot be made if the alternate data set is full.

CMRDETL|CTGDETL

<cicsName>|ALL

( BMC AMI Ops Monitor for CICS only) Allows you to manually switch the CMRDETL or CTGDETL data sets.

The keywords and parameters also give you the option of switching the data set of individual targets or of all active targets of the specified type. 

Was this page helpful? Yes No Submitting... Thank you

Comments