Previous Topic: Command ExamplesNext Topic: Display Example: DBEC I,MSID(*),SYSID(*)


Display Example: DBEX I,MUF(??),SYSID(*)

SYSID = CYDS CA Datacom CICS Services APPLID = A31ICYDS DBEC I,MUF(??),SYSID(*) A SYS MUF STATUS W E USERS SIDNAME JOB LVL MUFN/SUB CONDITIONS *LOC DC00117I CA Datacom CICS Services NOT STARTED CBR2 LINK TO SYSTEM IS OUT OF SERVICE CBR3 LINK TO SYSTEM IS OUT OF SERVICE CCR2 LINK TO SYSTEM IS OUT OF SERVICE CCR3 01 CONNECTED P D 006 DBSIDPR QAMUFD 12 MUFD1 CCR3 02 UNCONNECTED P D 004 DBDVMW 000 000 CONN RC=13.179 CCR3 03 UNCONNECTED P D 004 DBDVM5 000 000 CONN RC=13.179 CCR3 04 UNCONNECTED D D 004 PRODMUF 000 000 CCR3 05 UNCONNECTED D D 004 PRODMU2 000 000 CIDS LINK TO SYSTEM IS OUT OF SERVICE CVDS 01 CONNECTED A D 020 DBDVM5 DBDVM5 12 DBDVMUF5 CVDS 02 UNCONNECTED A D 006 DBDVMS DBDVMS1 CVDS 03 UNCONNECTED A D 006 DBDVMT DBDVMT1 CVDS 04 CONNECTED A D 020 PRODMU2 DSL2MU12 12 DSL2MU12 CVDS 05 CONNECTED A D 020 DBDVMR DBDVMR 12 DBDVMR CVDS 06 UNCONNECTED A D 006 MUFW MUFW1 CVDS 07 UNCONNECTED D D 003 MUF1 MUF11 CVDS 08 UNCONNECTED D D 003 MUF6 MUF6 CVDS 09 UNCONNECTED D D 003 MUF7 MUF71 PF1: REFRESH PF7: BACKWARD PF8: FORWARD

Field Descriptions
A

Action to perform with DBEX:

E

Select and display the return code summary for that MUF.

S

Select and begin browse display at the URT level.

T

Select and begin browse display of active tasks for that MUF.

U

Select and begin browse display of the concurrent users summary for that MUF.

SYS

Identifies the CICS system to which this display line refers. *LOC means local CICS or TOR.

MUF

Identifies sequence number of the MUF.

STATUS

Indicates the CONNECT status of the MUF:

UNCONNECTED

Not yet connected by a program call, PLT, or a DBEC transaction.

DISCONNECTED

Explicitly disconnected with a DBEC P,DISCONNECT.

DISCONNECTING

Disconnect requested by DBEC P,DISCONNECT command, but not yet disconnected pending completion of a read in progress, URT closes, or a transaction having exclusive control.

CONNECTED

Connected by CA Datacom CICS Services but no transaction to disconnect it has been issued.

CONNECTING

Connect requested by DBEC P,CONNECT command, but not yet connected pending completion of the request in progress in the MUF.

W

(WHEN) Indicates when CA Datacom CICS Services connects the MUF:

P

(PLT) Specifies the MUF is to connect by CA Datacom CICS Services at startup time.

A

(AUTO) Specifies the MUF is automatically connected by CA Datacom CICS Services when an application request or URT open needs this MUF.

D

(DEFER) Specifies the MUF can only be connected with an explicit DBEC command.

E

The E (EOJ_OK) value represents CA Datacom CICS Services participation in an EOJ being issued for the default MUF. A value of No indicates that CA Datacom CICS Services does not participate in the EOJ of MUF. This means that MUF cannot EOJ until the MUF is disconnected in CA Datacom CICS Services. The value of Disconnect or Immediate determines the CA Datacom CICS Services action when notified of a MUF EOJ. If these two values are specified and there is no request activity within a specific time interval in CICS for this MUF, MUF severs the connection. The MUF startup option of X_EOJ_OK_S_DELAY determines this interval. This feature is not supported in CA Datacom/DB Version 12.0.

USERS

Number of tasks allocated to this MUF for processing requests.

SIDNAME

The SIDNAME specified on the DBCSID macro in the DBCVTPR or the default SIDNAME of DBSI*DPR if no DBCSID macro has been specified in the DBCVTPR macro.

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.

JOB

Identifies the job name of the active MUF.

LVL

Identifies the release level of the active MUF.

MUFN/SUB

This field displays the MUF name if the SIDNAME module is assembled with a name that is specified by the MUFNAME= that matches the MUF name specified in the MUF startup option. Otherwise, this field displays the number of the SVC and SVC sub-ID associated with this MUF as defined in the SIDNAME module.

CONDITIONS

Specifies one of the following:

CONN RC=nn.yyy

The last connect request for this MUF failed for the reason indicated by CA Datacom/DB return code nn and internal return code yyy.

DISC RC=nn.yyy

The last disconnect request for this MUF failed for the reason indicated by CA Datacom/DB return code nn and internal return code yyy.

For CICS regions defined in CICS by CONNECTION and SESSION CSD definitions, see the Message Reference Guide for a description of the messages that are displayed if that the inquiry cannot retrieve the requested MUF-level display information.

From this display, if you key an E in the action field of the first MUF row, the resulting display shows the return code summary for that MUF.

SYSID = CYDS CA Datacom CICS Services APPLID = A31ICYDS DBEX I,MUF(??),SYSID(*) MUF( 01) DATABASE RETURN CODE SUMMARY MSIDNAME( DBSIDPR ) LOW ORDER DIGITS (PERIODS=NONE) 0 1 2 3 4 5 6 7 8 9 -0- 5 ..... ..... ..... ..... ..... ..... ..... ..... ..... -1- ..... ..... ..... ..... ..... ..... ..... ..... ..... ..... -2- ..... ..... ..... ..... ..... 18 ..... ..... ..... ..... -3- ..... ..... ..... ..... ..... ..... ..... ..... ..... ..... -4- ..... ..... ..... ..... ..... ..... ..... ..... ..... ..... -5- ..... ..... ..... ..... ..... ..... ..... ..... ..... ..... -6- ..... ..... ..... ..... ..... ..... ..... ..... ..... ..... -7- ..... ..... ..... ..... ..... ..... ..... ..... ..... ..... -8- ..... ..... ..... ..... ..... ..... ..... ..... ..... ..... -9- ..... ..... ..... ..... ..... ..... ..... ..... ..... ..... PF1: REFRESH PF3: RETURN

From this screen, PF3 returns you to the MUF-level display where you can choose another display, and PF1 refreshes the current display. From the MUF-level display, you can then key a T in the action of a MUF row. The resulting display is the active task summary for that MUF.

SYSID = CYDS CA Datacom CICS Services APPLID = A31ICYDS DBEX I,MUF(??),SYSID(*) A SYS MUF TCB TRAN TERM RTIME TASK W A D E F U S B N PROGRAM OFFSET COMMD TBL CCR3 01 NO TASKS IN USE IN THIS MUF PF1: REFRESH PF3: RETURN PF7: BACKWARD PF8: FORWARD PF11: RIGHT

Field Descriptions
A

There is no available action.

SYS

Identifies the CICS system to which this display line refers. *LOC means local CICS or TOR.

MUF

The ID of the MUF accessed by the current event, consisting of two numbers nn, where nn can be 01 through 99.

TCB

The Task Control Block sequence number which identifies the thread used by the current event.

TRAN

The CICS transaction ID associated with the listed task.

TERM

The ID of the terminal which initiated the listed command, or ???? if no terminal was attached to the issue of the command.

RTIME

Time of day when the task last issued a CA Datacom/DB request.

TASK

CICS Task number.

W

AWAITING DB RESPONSE—A request passed control to the MUF and has not yet returned control to CA Datacom CICS Services.

A

ABENDING—The task has an abend condition or the MUF detected an abnormal condition.

D

COMMIT IN PROCESS—The task is terminating and CA Datacom CICS Services is performing final task cleanup.

E

EXCLUSIVE CONTROL—The task has acquired exclusive control by reading a record for update and the TCB is dedicated to this task until it finishes.

F

COMMIT FAIL—The task is terminating, but the CA Datacom CICS Services final cleanup for the task has failed.

U

DWE IN PROCESS—The task is terminating.

S

SYNCPOINT IN PROCESS—The task is currently in CICS SYNCPOINT processing.

B

DTB IN PROCESS—The task ended abnormally and is terminating with dynamic transaction backout.

N

NORMAL TERMINATION—The task has finished terminating, and all requests have completed.

PROGRAM

Name of the application program of this task.

OFFSET

Offset of the return address (in hexadecimal) of the application program.

COMMD

The last CA Datacom/DB command used by this task.

TBL

The last CA Datacom/DB table used by this task.

From this screen, PF1 refreshes the active task data, PF3 returns to the MUF display, and PF11 displays the second screen of active task data.

SYSID = CYDS CA Datacom CICS Services APPLID = A31ICYDS DBEX I,MUF(??),SYSID(*) A SYS MUF TCB DBID TIME REQS URT1 URT2 URT3 URT4 URT5 URT6 URT7 URT8 URT9 CCR3 01 001 16384 01:62 00001 PF1: REFRESH PF3: RETURN PF7: BACKWARD PF8: FORWARD PF10: LEFT

Field Descriptions
A

There is no available action.

SYS

Identifies the CICS system to which this display line refers. *LOC means local CICS or TOR.

MUF

The ID of the MUF being accessed by the current event, consisting of two numbers nn, where nn can be 01 through 99.

TCB

The Task Control Block sequence number which identifies the thread being used by the current event.

DBID

The last database used by this task.

TIME

Time of day when the task first used this Task Control Block.

REQS

Number of CA Datacom/DB requests issued by the referenced task using the referenced TCB.

URT1-URT9

First through ninth URT used for exclusive control in this task.

From this screen, PF1 refreshes the data of this screen, PF10 returns to the first screen of active task data, and PF3 returns you to the MUF-level display where you can choose another display. From the MUF-level display, you can then key a U in the action of a MUF row. The resulting display is the task usage summary for that MUF.

SYSID = CYDS CA Datacom CICS Services APPLID = A31ICXDS DBEC I,MUF(??),SYSID(*) CONCURRENT USERS FOR MUF( 01 ) MSIDNAME( DBSIDPR ) 20% 40% 60% 80% 100% USERS FREQUENCY PERCENTAGE +--------+---------+---------+---------+---------+ 001 00000023 100.00 ************************************************** 002 00000003 013.04 ******* 003 00000003 013.04 ******* 004 00000003 013.04 ******* 005 00000003 013.04 ******* 006 00000003 013.04 ******* 007** 00000003 013.04 ******* 008** 00000003 013.04 ******* 009** 00000003 013.04 ******* 010** 00000003 013.04 ******* 011** 00000003 013.04 ******* 012** 00000003 013.04 ******* 013** 00000003 013.04 ******* 014** 00000003 013.04 ******* 015** 00000003 013.04 ******* 016** 00000003 013.04 ******* 017** 00000003 013.04 ******* PF1 :REFRESH PF3: RETURN PF7: BACKWARD PF8: FORWARD

Field Descriptions
USERS

A sequence number for a user invoking the reserving of transactions or physically waiting on a read event, where asterisks following the sequence number carry the following meaning:

FREQUENCY

The values shown under the FREQUENCY heading denote the total number of requests at the time a request arrives for service. CA Datacom CICS Services requires n threads (for USERS: nnn) to service the request without waiting for thread availability. For example, for USERS 006 in the example, this means that 3 requests were counted at a time when there were six concurrent users issuing requests.

PERCENTAGE

Indicates the percentage of time that concurrent requests are being issued by the number listed in the USERS column. That is, 6 users are attempting requests concurrently about 13 percent of the time. In the display example, USERS 006 percentage data 13.04 was computed by dividing 3 (frequency of USERS: 006) by 23 (frequency of USERS: 001, which was serviced 100 percent of the time).

CONCURRENT USERS FOR MUF (nn) MSIDNAME (xxxxxxxx)

Users concurrently invoking reserving transactions or physically waiting on a read event for the selected MUF indicated by its sequence number in the DBCSID macros of the DBVTPR and the SIDNAME specified in the respective DBCSID macro.

Note: After statistics are captured over a longer period of time, the graphical display under Concurrent Users for Selected MUF becomes more meaningful.