BBI control commands - Documentation for MainView Infrastructure 6.3
Michael Hansen
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.
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
Configuration
Dataset
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 logJESF
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
- ENA
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 specifiedThe 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.
(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 specifiedThe 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.
(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
ALL [anyname] |
EXEC [execname] |
RULE [rulename] |
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: (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*
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,NOGIVETAKE | 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 PASStartup 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
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 PASJESconct
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 taskJournal
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.