BBI control commands
BBI control commands are used to control resources and functions.
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:
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 | |
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) | |
BBparm | List | 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:
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
For more information about EXEC priorities, refer to Using advanced automation with BMC AMI Ops Automation. | |
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.
| |
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
| |
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 AutomationR 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:
You can omit (or skip) parameters by using a comma as a placeholder. The following list shows some sample commands:
| |
RULESET | ,RUL,[ruleSetName],[start],[count] | (BMC AMI Ops Automation only) Displays all of the Rules within the specified Rule Sets. The default parameters are:
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] | 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.
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:
| |
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
|
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:
| ||
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:
| |
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:
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. | |
Gme | Not applicable | Stops 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. |