gtpo1m40Operations

ZDECB-Display In-Use Entry Control Blocks

Use this command to display information about entry control blocks (ECBs) that are in use.

Requirements and Restrictions

None.

Format




ACN
displays ECBs by activation number.

Sort-header
displays ECBs sorted by input header, where header is one of the following:

ACN
The ECB activation number.

ADDR
The system virtual memory (SVM) address.

DSP
The displacement of the last macro issued in a program.

FILE
The collection of FILE type macros issued.

FIND
The collection of FIND type macros issued.

FRM
The frames attached to an ECB.

GETF
The GETFC macro issued.

HOLD
The ECB records held.

INPUT
The ECB input message.

IO
The status of I/O operations.

IS
The I-stream.

MILS
The amount of CPU time, in milliseconds, used by the ECB.

ORIGIN
The information about the ECB that is created.

PGM
The program name.

SSU
The subsystem user (SSU).

SVC
The last supervisor call (SVC) issued.

TIME
The amount of time an ECB has been active.

You can specify as many as three input headers.

ecbaddr
displays detailed ECB information, where ecbaddr is the SVM ECB address. This information includes the I/O count, records held, and the chain addresses of entries waiting for records held.

Inputs
displays all ECBs that are in use and input messages that result from the ECBs being created. The display is sorted by time and shown in minutes and seconds.
Note:
You must modify the CVXS segment to display the input message field.

MTR ecbaddr
displays a macro trace for an ECB that is in use, where ecbaddr is the ECB address.

Nest ecbaddr
displays nesting level information for an ECB, where ecbaddr is the ECB address.

OLD
displays information about the specified number of active ECBs and the total number of ECBs that are in use in the TPF system. If you do not specify a number, the default is the five oldest active ECBs are displayed. The display is sorted by time, starting with the oldest ECB, and shown in minutes and seconds.
Note:
If you do not enter any parameters with the ZDECB command, it is equivalent to entering the ZDECB command with the OLD parameter specified.

ALL
displays all ECBs that are in use.

ecbs
is the number of ECBs to be displayed.

STATs
displays statistics for the specified number of ECBs that are in use with the highest total of milliseconds (ms). If you do not specify a number, the default is five ECBs in use are displayed.

AVerage
displays the average count per second of the GETFC, FIND, and FILE macros for the specified number of ECBs that are in use, and is sorted by milliseconds per second.

SVM ecbaddr evmaddr
displays the equivalent SVM address for the ECB virtual memory (EVM) address specified, where ecbaddr is the SVM ECB address and evmaddr is the EVM address.

999
displays ECBs older than or equal to the number of seconds specified in the range 0-999.

Additional Information

Online help information is available for this command. To display the help information, enter one of the following:

ZDECB HELP

ZDECB ?

Examples

The following example displays all ECBs that are in use and equal to or older than 3 seconds. The asterisks (*) indicate the ECBs that are not active during the time frame specified. File addresses that are in 4x4 mode will be displayed as 4-byte addresses. File addresses that are 8-byte FARF6 addresses will not be displayed so that the line will not wrap.

+--------------------------------------------------------------------------------+
|User:   ZDECB 3                                                                 |
|                                                                                |
|System: DECB0014I 11.45.38 DISPLAY ECB SUMMARY                                  |
|        ECB ADDR  SSU IS  PGM   MIN SC  ORIGIN  I H DSP SVC                     |
|        01A0C000 HPN   1 CVSNTS  63 26  1052    1       FILNC CC022801          |
|        01A30000 HPN   1 CVSNTS  63 23  1052    1       FINDC CC022801          |
|        01A42000 HPN   1 CVSNTS  63 20  1052    1   1FC FINWC CC022801          |
|        01A4E000*HPN   1 CVSNTS  63 18  1052    1   2CC TOPNC                   |
|        01D39000*HPN   1 CVSNTS     5   1052    1 2 536 FIWHC CC022804          |
|        01D51000*HPN   1 CVSNTS     5 CREM CVSN 1 2 620 FIWHC CC022803          |
|        01DFF000 HPN   1 CLTW40 63 30 CREM CLTY 1   DLM EVNWC                   |
|        TOTAL     7                                                             |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

In the following example, the nesting level information for an ECB is displayed.

+--------------------------------------------------------------------------------+
|User:   ZDECB NEST 1B88000                                                      |
|                                                                                |
|System: DECB0011I 07.15.00 PROGRAM NESTING FOR ECB 01B88000 STARTED             |
|        ECB ADDR  SSU IS  PGM   MIN SC  ORIGIN   I H DSP  SVC                   |
|        01B88000 HPN   1 COSA40   8 58   CXFR    1 1 2E8  EVNWC                 |
|           MILS  FRM   FIND   FILE   GETF  INPUT                                |
|            987   11     43      7      0                                       |
|        NESTING LEVEL  PROGRAM NAME  DISPLACEMENT                               |
|               1          COTB40         16A                                    |
|               0          CTKS40         40C                                    |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

In the following example, statistics for the five in-use ECBs with the highest total of milliseconds are displayed under MILS.

+--------------------------------------------------------------------------------+
|User:   ZDECB STAT                                                              |
|                                                                                |
|System: DECB0014I 11.49.35 DISPLAY ECB SUMMARY                                  |
|        ECB ADDR IS PGM    MIN SC  MILS  FRM   FIND    FILE  GETF               |
|        01A0C000  1 CVSNTS  67 23 550356   8      2  772505     0               |
|        01A30000  1 CVSNTS  67 20 439617   8 770727       0     0               |
|        01A42000  1 CVSNTS  67 17 402578   8 770030       0     0               |
|        01DFF000  1 CLTW40  67 27   1739   7      0       0     0               |
|        01AC0000  1 CVSNTS      4     25   8      3       0     0               |
|        TOTAL    8                                                              |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

In the following example, the record held information of the specified ECB is displayed.

+--------------------------------------------------------------------------------+
|User:   ZDECB 0263A000                                                          |
|                                                                                |
|System: DECB0012I 15.27.49 ANALYZER FOR ECB 0263A000 STARTED                    |
|        ECB ADDR  SSU IS  PGM   MIN SC  ORIGIN   I H DSP  SVC                   |
|        0263A000 HPN   1 CVSNTS     23   1052    1 2 53A FIWHC F4023811         |
|            MILS  FRM   FIND   FILE   GETF  INPUT                               |
|               8   10      3      0      0                                      |
|                                                                                |
|        WAITING ON - FIWHC 00000000F4023811                                     |
|                                                                                |
|        RECORD HOLD TABLE INFORMATION FOR ECB 0263A000                          |
|          HOLDING F/A      WAITING F/A    HOLDING ECB                           |
|                         00000000F4023811  02640000                             |
|        00000000F402380D                                                        |
|        ECB ANALZYER COMPLETE FOR ECB 0263A000                                  |
+--------------------------------------------------------------------------------+

In the following example, the macro trace information of the specified ECB is displayed.

+--------------------------------------------------------------------------------+
|User:   ZDECB MTR 2433000                                                       |
|                                                                                |
|System: DECB0013I 15.50.18 MACRO TRACE FOR ECB 02433000 STARTED                 |
|        ECB ADDR  SSU IS  PGM   MIN SC  ORIGIN   I H DSP  SVC                   |
|        02433000 HPN   1 CVSNTS     17   1052    1   206 FIWHC F4023805         |
|            MILS  FRM   FIND   FILE   GETF  INPUT                               |
|            1487   10   8870      0      0                                      |
|        START OF MACRO TRACE FOR ECB 02433000                                   |
|        MACRO                  IS   PROGRAM PSW    PROG      TIME               |
|                                                                                |
|        FINWC 00000000F4023805 01 071D000083733206 CVSN B3D71D2A1DC8C105        |
|        RELCC                  01 071D00008373320E CVSN B3D71D2A1E7D9385 _      |
|        FINWC 00000000F4023805 01 071D000083733206 CVSN B3D71D2A1E7DBB85        |
|        RELCC                  01 071D00008373320E CVSN B3D71D2A1F9E4D46        |
|        FINWC 00000000F4023805 01 071D000083733206 CVSN B3D71D2A1F9E8046        |
|        RELCC                  01 071D00008373320E CVSN B3D71D2A2057CE07        |
|        FINWC 00000000F4023805 01 071D000083733206 CVSN B3D71D2A2057FA07 _      |
|        RELCC                  01 071D00008373320E CVSN B3D71D2A2111C448        |
|        FINWC 00000000F4023805 01 071D000083733206 CVSN B3D71D2A2111EE88        |
|        RELCC                  01 071D00008373320E CVSN B3D71D2A21CA7840        |
|        FINWC 00000000F4023805 01 071D000083733206 CVSN B3D71D2A21CAA740        |
|        MORE DATA AVAILABLE, ENTER ZPAGE TO CONTINUE+                           |
|                                                                                |
+--------------------------------------------------------------------------------+

In the following example, the EVM address of the specified ECB is converted to an SVM address. The EVM address used in this example is the address of a core block attached to the ECB. The EVM address was obtained by entering the ZDCOR command to display the ECB.

+--------------------------------------------------------------------------------+
|User:   ZDECB SVM 1A42000 61EE80                                                |
|                                                                                |
|System: DECB0005I 11.51.14 ECB- 1A42000, EVM-61EE80, SVM-84EE80                 |
+--------------------------------------------------------------------------------+

Related Information

None.