Space announcement We are no longer updating this version of the documentation for the infrastructure components (DBC, LGC, and NGL).  You can no longer leave comments on it. For the latest version of the documentation, see Common Mainframe Infrastructure 2022 release.

DBC commands


You can interact with the DBC subsystem by using any of the following commands.

The ssid variable refers to the subsystem ID of the DBC subsystem.

DBC commands

Commands

Description

/ssid DBC,DIAG

Sends diagnostic information to the DBCPRINT and DBCTRACE data sets.

BMC Support might direct you to execute this command to assist in diagnosing problems.

/ssid DBC,DB2C,ssid,command

Executes a DB2 command in the DB2 subsystem identified by 'ssid' and returns the result to DBCPRINT. This command can be used to execute any native DB2 command that the user is authorized for.

Note: This command cannot be used for DSN subcommands.

/ssid DBC,RESETPRINT

Closes the DBCPRINT data set and allocates a new one in order to clear data from DBCPRINT.

/ssid DBC,RESETTRACE

Clears the DBCTRACE data set and allocates a new one.

/ssid STOP

Stops the DBC subsystem.

/ssid DBC,TRACEOFF

Disables DBC tracing.

/ssid DBC,TRACEON

Enables DBC tracing.

DBC writes trace data to the DBCTRACE data set. The DBCTRACE data set is dynamically allocated.

Warning: If you leave tracing enabled, be aware that the DBCTRACE data set can grow to a significant size. BMC recommends using caution when using the TRACEON command.

/ssid DBC,TRACEFLUSH

Forces unwritten trace information to the DBCTRACE data set.

This command is useful if trace was disabled. DBC writes any trace data that exists in an internal buffer that is used to maintain trace information.

/ssid DBC,PRODCMDS,ppp

Displays all commands for product ppp ( Displays only commands that conform to the ppp,command format).

/ssid DBC,DISPLAY,object

The details of the DBC, DISPLAY command for each object type are documented in the following table.

DISPLAY Command Options

DISPLAY object (alternative syntax)

Description

PRODUCTS (PRODUCTS, PRD, PDXD) [,ppp]

Displays the Product Definition XML Document (PDXD) from the DBC repository. If no parameters are specified, information is displayed for all products.

If the three-character product code is specified, DBC displays information for only that product. If multiple PIIDS exist for that product code, they are all displayed.

CMDS [,ppp]


Displays all operator command definitions. If no parameters are specified, commands for all products are displayed.

If the three-character product code is specified, DBC displays only commands for that product.

EVENT (EV),eventName [subid]


Displays all subscription information the named event.

If the subid is specified, only information for the named subscription is displayed.

CMD,cmdtext

Displays the ACTION XML for the named command.

AGENTS (AG) [,ppp]


Displays all agents that are currently executing.

This command generates message BMCDBC0126I, which indicates the TCB address of the agent and whether it is a job step TCB. If no parameters are specified, this command displays information for all products.

If the three-character product code is specified, displays currently execution agents for only the product specified

PROCESSES


Displays all active PROCESSES. If no other parameters are specified, PROCESSES for all products are displayed.

If the three-character product code is specified, displays currently active PROCESSES for only the product specified

DB2 [,ssid][,LOCAL | ALL ]


Displays the DB2INFO block for DB2 subsystems. If no parameters are specified, this command displays DB2INFO blocks for all subsystems known to the DBC group.

If the ssid is specified, DB2INFO blocks for only matching DB2 subsystems are displayed. You can partially use wildcards for this value by specifying an asterisk at the end (e.g. DE* selects all DB2 subsystems with ssid beginning 'DE').

If neither ALL or LOCAL is specified, the command considers DB2 subsystems from all LPARs known to the DBC group. LOCAL causes only subsystems executing on the local LPAR to be selected.

IMS [,imsid][,LOCAL | ALL ]


Displays the IMSINFO block for IMS subsystems. If no parameters are specified, this command displays IMSINFO blocks for all subsystems known to the DBC group.

If the imsid is specified, IMSINFO blocks for only matching IMS subsystems are displayed. You can partially use wildcards for this value by specifying an asterisk at the end (e.g. MX* selects all IMS subsystems with IMSID beginning 'MX').

If neither ALL or LOCAL is not specified, the command considers IMS subsystems from all LPARs known to the DBC group. LOCAL causes only subsystems executing on the local LPAR to be selected.

MQ [,ssid][,LOCAL | ALL ]


Displays the MQINFO block for MQ subsystems. If no parameters are specified, this command displays MQ blocks for all subsystems known to the DBC group.

If the ssid is specified, MQINFO blocks for only matching MQ subsystems are displayed. You can partially use wildcards for this value by specifying an asterisk at the end (e.g. MX* selects all MQ subsystems with SSID beginning 'MX').

If neither ALL or LOCAL is specified, the command considers MQ subsystems from all LPARs known to the DBC group. LOCAL causes only subsystems executing on the local LPAR to be selected.

SRBS [,ppp ]


Displays currently active SRBs. If no parameters are specified, SRBs for all products are displayed.

If the three-character product code is specified, displays currently active SRBs only for the product specified.

STATS [,TCBS,name] [,MEM][,QUEUES]


If no parameters are specified, this command displays all available statistics.

  • name displays statistics for only the named task
  • MEM displays memory usage statistics
  • QUEUES displays queue usage statistics

DSNS

Displays all data sets currently allocated and specifies if the data set allocation results from STEPLIB, product, or agent definition.

SOCKETS

Displays the state of all sockets currently in use.



 

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