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 or a limited set of MUFs, or to invoke a display of statistics for all or a limited set of MUFs. The MSIDname object can be used instead of MUF for any of the MUF-level commands.
If you issue the command with the DBEX transaction ID, you cannot update any information on the resulting scrollable display. One of the allowable entries is an S in the Action field which toggles to the URT-level to display all the URTs for the row containing your selected MUF. The only other allowable entries are E to display the return code summary, T to display the active task summary, and U to display the task usage summary. If you issue the command with DBEC, you can alter certain fields on the panel. (Any alterations that area made take effect immediately and are valid only during the life of the CICS session.)
The following example is a DBCSID macro. A DBCSID macro is appended to the DBCVTPR macro. Each DBCSID macro defines a connection to a particular CA Datacom/DB MUF. The values for the bold-faced parameters in this example are displayed on the MUF-level inquiry.
To add or delete MUFs, or to change the connection type of the MUFs, or to change the SIDNAMEs, use the DBCSID macros that are appended to the DBCVTPR macro. Assemble and link DBCVTPR and NEWCOPY command to place it into the CICS region. This NEWCOPY request only takes effect if the CA Datacom CICS Services is shut down.
DBCSID SIDNAME=DBSIDPR,USERS=3,CONNECT=PLT,EOJ_OK=DISCONNECT
Invoke the following inquiry to display the status of CA Datacom/DB MUFs or to display the statistics for 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), or DBEC I,MSIDname (or DBEX I,MSIDname) request displays the status of that MUF as it was 90 seconds ago.
►►─┬─ DBEC ─┬─ INQuire,MUF(nn) ─┬──────────┬─┬────────────┬───────────────────►◄ └─ DBEX ─┘ └─ ,STATS ─┘ └─ ,limiter ─┘
(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.
(Required) Requests a scrollable display of MUFs (INQ and I are valid abbreviations).
(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 that are appended to the DBCVTPR macro, if multiple MUFs are defined. If MSIDname(xxxxx) is specified with this qualification, then the MSIDname(xxxxxxxx) is ignored.
Specifies that you want to display only the MUF with the specific two-digit number nn.
Alternately, instead of using the nn number to specify only a specific MUF, you can use the wildcard symbol ? (question mark) to accept any digit 0 through 9 for one (or both) of the two digits of the number.
(Required) Specifies the inquiry is to invoke the MUF-level display. The value within the parentheses identifies the name of the MUF specified in the DBCSID macros that are appended to the DBCVTPR macro, if multiple MUFs are defined. If MUF(nn) is specified with this qualification then this parameter is ignored and the displayed is based on the MUF(nn) qualification.
Specifies that only the MUF with the specific SIDNAME in the DBCSID macro coded with the DBCVTPR is displayed.
You can also use the wildcard symbol * (an asterisk) to display all MUFs or characters that succeeded by the asterisk to display all MUFs beginning with a range of SIDNAMEs by beginning values as specified in the DBCSID macros appended to the DBCVTPR macro.
(Optional) Specifies a MUF-level statistic display as opposed to a MUF-level display. From this display, a line command is available to reset the statistics for a selected MUF when the DBEC transaction ID is used.
(Optional) Limits the inquiry to MUFs of designated status, or how defined for opening. A limiter can be specified with the STATS option to invoke the MUF-level statistics display that is further limited by this option. The following values are for designating limiters of each type:
MUFs explicitly disconnected through a DBEC command. (DIS is a valid abbreviation.)
MUFs with a disconnect in progress, where the status is set to disconnect at the completion of the current read or update and URT closes.
MUFs that are currently connected. CON is a valid abbreviation.
MUFs with a connect in progress, where URT opens are invoked at the completion of the current connect.
MUFs defined as AUTO or DEFER that are not connected by a program call or a DBEC transaction. UNC is a valid abbreviation.
MUFs defined to be connected when they are required by a program.
MUFs defined to be connected only by an explicit DBEC command. (DEF is a valid abbreviation.)
MUFs connected at CA Datacom CICS Services startup, such as MUFs not defined for AUTO or DEFER.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|