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:

MainView AutoOPERATOR
MainView for CICS
MainView for DB2
MainView for DBCTL
MainView for IMS Online
MainView 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 MainView AutoOPERATOR 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 and uses 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.

BBI control commands

Command	Keywords	Parameters	Description
Cancel	DeLaY	delayID \| ALL	(MainView AutoOPERATOR 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.
Cancel	Exec	eid \| All	(MainView AutoOPERATOR 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)
	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	(MainView AutoOPERATOR only) displays the current status of the Automation Logger application
	DeLaY	All \| commandType	(MainView AutoOPERATOR 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	(MainView AutoOPERATOR 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 MainView AutoOPERATOR Advanced Automation Guide.
		All \| Conn [,node] Publish \| Receive Trace [,nnnn]	(MainView AutoOPERATOR only) With no parameter, displays the status of BMC Impact Integration for MainView (BIIM), including statistics on its messages 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	(MainView for CICS, MainView for IMS* Online, MainView for DBCTL, MainView for DB2 only)* Logs the status of BBI-SS PAS image log
	JESF	Not applicable	(MainView AutoOPERATOR 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 MainView Logger
	Keys	Not applicable	Displays all the option password keys read from the BBKEYS member of BBPARM and their validation status
	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 MainView 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	(MainView AutoOPERATOR 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	(MainView AutoOPERATOR only) Shows whether MainView AutoOPERATORR Rule processing is enabled or disabled
	RULESET	[,ruleStatus],[ruleSetName],[start],[count]	(MainView AutoOPERATOR 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 RULESETDisplays 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]	(MainView AutoOPERATOR 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	(MainView AutoOPERATOR only) Displays status information about automation.
	SOF	Not applicable	(MainView AutoOPERATOR 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: ( MainView AutoOPERATOR 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: ( MainView AutoOPERATOR 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: (MainView AutoOPERATOR 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 MainView 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]	(MainView AutoOPERATOR 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	(MainView AutoOPERATOR 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	(MainView AutoOPERATOR 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	(MainView AutoOPERATOR 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	(MainView for DB2 only) Stops and restarts the connection between MainView 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	(MainView AutoOPERATOR only) Resets the statistics for running and queued EXECs
	FOCal	Not applicable	(MainView FOCAL POINT only) Stops and restarts MainView FOCAL POINT without shutting down the BBI-SS PAS
	Gme	nodename \| connectionName	nodename stops and restarts communication with a General Messages Exchange (GME) server node by using the parameters that are specified in the active AAOGMExx member nodename can be one of the following values: TGTNAME is the name of the GME server node whose connection is to be stopped and started. Typically, this name will be the workstation ID of the system where the remote GME server node is running. IPAddress:Port is a combination of the IP address and the port number connected by a colon (:). Hostname:Port is a combination of the host name and the port number connected by a colon (:). connectionName stops and restarts communication with a BMC Impact Manager cell by using the parameters that are specified in the active AAOGMExx member and the MCELL.DIR data set.
	MVLog	Not applicable	Stops the connection to the active instance of MainView Logger (if any), and starts a new connection to an instance of MainView 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, MainView Logger is not restarted).
	Parm	AAOALSxx	(MainView AutoOPERATOR only) Reinitializes the parameters that are specified in member AAOALSxx
		AAOALTxx	(MainView AutoOPERATOR-to-PATROL Enterprise Manager Interface only) Drops all connections to PATROL Enterprise Manager and terminates the VTAM session After processing of AAOALTxx, where xx can be any suffix, the VTAM connection and all remote connections are established.
		AAOARPxx	(MainView AutoOPERATOR only) Reinitializes the parameters that are specified in member AAOARPxx
		AAOEXPxx	(MainView AutoOPERATOR 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 MainView AutoOPERATOR.
		AAORULxx	Reinitializes the AAORULxx Rule Set
		AAOTRNxx	(MainView AutoOPERATOR only) Reinitializes the parameters that are specified in member AAOTRNxx
		AAOTSPxx	(MainView AutoOPERATOR only) Reinitializes the parameters that are specified in member AAOTSPxx
		CMRCTG	(MainView for CICS only) Resets the current CICS Transaction Gateway (CTG) monitoring parameters to the parameters that are specified in member CMRBEXnn
		CMRPRBT	(MainView 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	(MainView for CICS and MainView AutoOPERATOR for CICS option only) Reinitializes the CMRSECU module and creates a table of security definitions
		CMRSOPT region	(MainView 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	(MainView for DB2, MainView for IMS* Online, and MainView for DBCTL* only) DMRBEX00 resets the MainView for DB2 message logging, background sampler exception, and application trace parameters. IMFBEX00 defines the MainView for IMS* Online* and MainView 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	(MainView AutoOPERATOR only) Stops and restarts the connection to the specified MQ queue manager The MQ queues that are being monitored by MainView AutoOPERATOR are closed and reopened.
	RULes	Not applicable	(MainView AutoOPERATOR 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	(MainView AutoOPERATOR only) Resets message and automation statistics
	TS	VALIDATE	(MainView AutoOPERATOR 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]	(MainView AutoOPERATOR only) Modifies the JESFLTR setting in member BBISSPxx
	RULE	[ENA \| DIS \| TEST] ruleID	(MainView AutoOPERATOR 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	(MainView AutoOPERATOR 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	(MainView AutoOPERATOR 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	(MainView AutoOPERATOR only) Attempts to start the connection to the Automation Logger PAS
	BM	DB2id	(MainView for DB2 only) Attempts to re-establish a connection between MainView for DB2 and the target Db2 subsystem ID If the connection is successfully established, it restarts all background monitors for that subsystem.
	Exec	(patternName)	(MainView AutoOPERATOR only) Starts EXECs by using matching patternName (use * for all EXECs)
	FOCal	Not applicable	(MainView FOCAL POINT only) Starts MainView FOCAL POINT, if it was previously stopped
	Gme	nodename\| connection_name	nodename starts communication with a General Messages Exchange (GME) server 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 a BMC Impact Manager cell by using the parameters that are specified in the active AAOGMExx member and the MCELL.DIR data set.
	GTS	[nn]	(MainView AutoOPERATOR and MainView 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	(MainView for CICS, MainView for IMS* Online, MainView for DBCTL, MainView 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 MainView 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 MainView Logger logging is not available.
	Rules	Not applicable	(MainView AutoOPERATOR only) Starts Rules processing
stoP	BM	DB2id	(MainView for DB2 only) Terminates a connection between MainView for DB2 and the target IBM Db2 subsystem ID
	Exec	(patternName)	(MainView AutoOPERATOR 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.
	FOCal	Not applicable	(MainView FOCAL POINT only) Stops MainView FOCAL POINT without shutting down the BBI-SS PAS
	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 a BMC Impact Manager cell.
	GTS	Not applicable	(MainView AutoOPERATOR and MainView for MQ only) Stops the Generic TCP/IP Server (GTS)
	Image	Not applicable	(MainView for CICS, MainView for IMS* Online, MainView for DBCTL, MainView 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 MainView Logger (if any)
	Rules	Not applicable	(MainView AutoOPERATOR only) Stops Rules processing The effect is similar to inactivating all active Rule Set entries.
swItch	Image	Not applicable	(MainView for CICS, MainView for IMS* Online, MainView for DBCTL, MainView 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	(MainView 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.

BBI control commands

On this page