Previous Topic: DBEC/DBEX: Monitoring Remote System Resources with Enhanced CommandsNext Topic: Command Examples


Displaying MUF-Level Processing Options

Requests for information on MUF resources are issued with the DBEC or the DBEX transaction followed by the INQUIRE operand. The options enable you to invoke a display of all MUFs.

If you issue the command with the DBEX transaction ID, you cannot update any information on the resulting scrollable display. The only allowable entries in the Action field are an S, E, T, or U, where:

S

Toggles to the URT-level display to display all the URTs for the MUF row containing your entry.

E

Toggles to the return code summary display for the MUF row containing your entry.

T

Toggles to the active task summary for the MUF.

U

Toggles to the task usage summary for the MUF.

If you issue the command with DBEC, you may alter certain fields on the panel or issue a statistics reset.

The following is an example of DBCSID macro. In a multiple MUF environment, a DBCSID macro is coded and appended to the DBCVTPR macro, each defining a particular CA Datacom/DB MUF connection. The values for the bold-faced parameters in this example are displayed on the MUF-level inquiry.

DBCSID SIDNAME=DBSIDPR,USERS=3,CONNECT=PLT,EOJ_OK=DISCONNECT

Invoke the following transaction to display the status of CA Datacom/DB MUFs.

Note: The status of any MUF displayed in this manner is current as of the time of the last request processed by that MUF. For example, if the last request processed by a MUF was 90 seconds ago, a DBEC I,MUF (or DBEX I,MUF) request displays the status of that MUF as it was 90 seconds ago.

►►─┬─ DBEC ─┬─ INQuire,MUF(nn) ──────────┬─┬────────────┬─ ,SYSid(aaaa) ──►◄
   └─ DBEX ─┘         └MSIDname(xxxxxxxx)┘ └─ ,limiter ─┘
DBEC/DBEX

(Required) Specify a transaction ID valid with Enhanced commands used to monitor MUFs. Select the transaction ID for which you are authorized. Leave a space between the transaction ID and the command.

INQuire

(Required) Requests a scrollable display of MUFs. (INQ and I are valid abbreviations.)

,MUF(nn)

(Required) Specifies the inquiry is to invoke the MUF-level display. The value within the parentheses identifies the number of the MUF relative to the order of the DBCSID macros appended to the DBCVTPR macro, if multiple MUF are defined. This cannot be used with MSIDNAME.

nn

Specifies that you want to display only the MUF with the specific 2-digit number nn.

Alternately, instead of using the nn number to specify only a specific MUF, you can use the wildcard symbol ? (a question mark) to accept any digit 0 through 9 for one (or both) of the two digits of the number.

See Command Examples.

MSIDname(xxxxxxxx)

(Required) Specifies the inquiry is to invoke the MUF-level display. The value within the parentheses identifies the MUFs identified by the SIDNAME specified in the DBCSID macros appended to the DBCVTPR macro if MUFs are defined. The MUFs that meet the qualification of your request are presented in the order that they are defined in the DBCSID macros of the DBCVTPR. MSIDname(xxxxxxxx) cannot be used with the MUF(nn) qualifier.

xxxxxxxx

Specifies that you want to display only the MUF with the SIDNAME specified as defined for the DBSIDPR module name xxxxxxxx for this MUF.

Alternately, instead of using the xxxxxxxx name to specify only a specific MUF, you can use the wildcard symbol * (asterisk) to accept SIDNAMEs that begin with a specific value. The asterisk represents any trailing characters in the SIDNAME.

See Command Examples.

Note: MUF(nn) and MSIDname(xxxxxxxx) cannot both be used. Use the one to qualify the MUF inquiry in the manner that meets your needs.

,limiter

(Optional) Limits the inquiry to URTs of designated type, status, how defined for opening or those with no CICS System Definition data set (CSD) entry. The following are the values for designating limiters of each type:

Status
DISconnect

MUFs explicitly disconnected through a DBEC command. (DIS is a valid abbreviation.)

DISCONNECTING

MUFs with a disconnect in progress, where disconnect status is set at the completion of the current read or update and/or URT closes.

CONnect

MUFs that are currently connected. (CON is a valid abbreviation.)

CONNECTING

MUFs with a connect in progress, where connect status is set at the completion of the connect in the MUF.

UNConnected

MUFs defined as AUTO or DEFER that have not been connected by a program call or a DBEC transaction. (UNC is a valid abbreviation.)

When
AUTO

MUFs defined to be connected when required by a program or a URT open.

DEFer

MUFs defined to be connected only by an explicit DBEC command. (DEF is a valid abbreviation.)

PLT

MUFs connected at CA Datacom CICS Services startup, meaning those not defined for AUTO or DEFER.

Statistics
STATS

MUFs statistics display. Such statistics are available for dynamic reset by the R line command with the DBEC transaction ID.

,SYSid(aaaa)

(Required) For an MRO environment, the value within the parentheses determines whether the inquiry is for a single remote CICS system or for all CICS systems. Valid values are as follows:

aaaa

Four-character CICS identifier for a single remote CICS system, as defined in the CICS connection table.

*

All attached CICS systems, beginning with the local system.

(SYS is a valid abbreviation.)