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,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,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,DISPLAY,object

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

DISPLAY object

Description

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.

CMD,cmdtext

Displays the ACTION XML for the named command.

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.

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.

DSNS

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

ENVironment,PROD, [ * | ppp],[piid]

Displays all values from the data set allocated to DBCENV for the product specified. If * is specified, this command displays all values for all products. If piid is specified, the command also displays options specific to that PIID.

EVENT(EV),eventName[subid]

Displays all subscription information the named event.

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

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.

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.

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.

SOCKETS

Displays the state of all sockets currently in use.

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

/ssid DBC,ENVEXEC

Causes DBC to read the DBCPRODS member in the data set allocated to the DBCENV DD statement in the DBC JCL. 

If any product is defined in DBCPRODS that was not defined when DBC started, DBC will start the product. If the product is being migrated from an earlier release, any entries for the product will be extracted from the DBC repository (if present) and placed in the pppOPTS member in order to reuse the values. Once the pppOPTS member has been created in the DBCENV data set, those values will continue to be reused from release to release. 

If maintenance is to be applied to any product, that product's PROD= value will include a ",MAINT" designation. When DBC detects this condition, it will stop and start the product to pick up any new maintenance and then remove the ",MAINT" designation in the DBCPRODS member.

/ssid DBC,EXEC[PROD],ppp,[piid]

Executes the named product (ppp, a three-character product code) and starts any NGL tasks that it requires. If the product is started prior to the command, it will be stopped and restarted.

If you specify NGL as the ppp, you can optionally add a piid.  For example:

  • /ssid DBC,EXEC,NGL refreshes (stop and restart) all NGL PIIDs
  • /ssid DBC,EXEC,NGL,DOM1 refreshes the DOM1 PIID only

/ssid DBC,PRODCMDS,ppp

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

/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 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,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 STOP

Stops the DBC subsystem.


 

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