TCB

The TCB service displays information for the various tasks (TCBs) within an address space or a specific task (TCB).

Syntax

The parameters are defined as follows:

Parameter	Description
asi	Address space instance; see Identifying-address-spaces for more information. When an asi is provided, summary information for all TCBs is displayed, except for the first two TCBs. See the ALL parameter for more information.
@TCBn	Is a symbolic name generated by a previous invocation of the TCB service. Detailed information for the specified TCB is displayed and symbolic names are assigned to the values in most of the displayed fields. See the list of generated symbols for details. One symbol is generated for each TCB within the target address space, and the symbols are numbered consecutively beginning with 001. The symbols are deleted and reassigned each time the TCB service is invoked specifying any value other than @TCBnnn as the first parameter.
MAP	Ignored when @TCBn is specified as the first parameter. When an asi is specified as the first parameter, indicates that detailed information for all of the TCBs (except the first two, see the ALL parameter) is to be displayed. However, symbolic names are not assigned to the various fields.
ALL	Ignored when @TCBn is specified as the first parameter. When an asi is specified as the first parameter, indicates that information for the first two TCBs is to also be displayed.

Example 1

To display summary information for all of the tasks (except the first two) within the address space with jobname VAM3R7, type

TCB,VAM3R7

TCB,VAMTT71I Address Space: VAM3R7 Step: GO                                    [1]
AMTT72I @TCB4 TCB 6FF3A0 Prty 255 NDSP 0400 PK 40                        [2]
AMTT7LI ---|-------------------------------------------------------- 4 [3]
AMTT7YI OTC 6FF130 NTC 000000 LTC 6C4528 JSTCB 6FF3A0     0.00 CPU Sec [4]
AMTT73I PRB 6FF020 EP AF300000 WLIC 00020001               SYSPROG    [5]
AMTT7XI PSW 070C0000 AF300592 WT 01 CDE 006FFA28                       [6]

AMTT72I @TCB5 TCB 6C4528 Prty 255 NDSP 0400 PK 40
AMTT7LI ----|------------------------------------------------------- 5
AMTT7YI OTC 6FF3A0 NTC 000000 LTC 6C4390 JSTCB 6FF3A0     0.00 CPU Sec
AMTT73I PRB 6FF318 EP AF301000 WLIC 00020001               ASTSSI10
AMTT7XI PSW 070C1000 AF301236 WT 01 CDE 006FC798

AMTT72I @TCB6 TCB 6C4390 Prty 255 NDSP 0400 PK 40
AMTT7LI -----|------------------------------------------------------ 6
AMTT7YI OTC 6C4528 NTC 000000 LTC 6A0BF8 JSTCB 6FF3A0     0.04 CPU Sec
AMTT73I PRB 6C4308 EP AF307000 WLIC 0002007D               ASTXA1MN
AMTT7XI PSW 074C0000 AF380986 WT 01 CDE 006FF2D8
AMTT72I @TCB7 TCB 6A0BF8 Prty 255 NDSP 0400 PK 40
AMTT7LI ------|----------------------------------------------------- 7
AMTT7YI OTC 6C4390 NTC 6A0E88 LTC 000000 JSTCB 6FF3A0     0.00 CPU Sec
AMTT73I PRB 6D72B0 EP AF39F000 WLIC 00020001               AST$$AYM
AMTT7XI PSW 074C1000 AF39F5F8 WT 01 CDE 006C4258
AMTT72I @TCB8 TCB 6A0E88 Prty 255 NDSP 0400 PK 40
AMTT7LI ------|----------------------------------------------------- 7
AMTT7YI OTC 6C4390 NTC 6C4068 LTC 000000 JSTCB 6FF3A0     0.00 CPU Sec
AMTT73I PRB 6A0AE8 EP AF39E000 WLIC 00020001               AST$$VQI
AMTT7XI PSW 074C1000 AF39E2E8 WT 01 CDE 006C4278
AMTT72I @TCB9 TCB 6C4068 Prty 255 NDSP 0400 PK 40
AMTT7LI ------|----------------------------------------------------- 7
AMTT7YI OTC 6C4390 NTC 000000 LTC 6D70A8 JSTCB 6FF3A0     0.01 CPU Sec
AMTT73I PRB 6D7338 EP AF38B000 WLIC 00020001               AST$$AEW
AMTT7XI PSW 074C1000 AF32CA58 WT 01 CDE 006C4028
AMTT72I @TCB10 TCB 6D70A8 Prty 255 NDSP 0080 PK 40        Normal Term    [7]
AMTT7LI -------|---------------------------------------------------- 8
AMTT7YI OTC 6C4068 NTC 000000 LTC 000000 JSTCB 6FF3A0     0.00 CPU Sec
AM3R7,

Example 2

To display detailed information for the ninth TCB displayed in example 1 above, which has a symbolic name of @TCB9, type

TCB,@TCB9

AMTT72I @TCB9 TCB 6C4068 Prty 255 NDSP 0400 PK 40            [2]
AMTT7LI --|----------------------------------------------7   [3]
AMTT7YI OTC 6C4390 NTC 000000 LTC 6D70A8 JSTCB 6FF3A0 0.02 CPU Sec[4]
AMTT73I PRB 6D7338 EP AF38B000 WLIC 00020001 AST$$AEW    [5]
AMTT7XI PSW 074C1000 AF32CA58 WT 01 CDE 006C4028           [6]
AMTT7PI High GPR 0- 3 00000000 00000000 00000000 00000000[8]
AMTT7QI Low GPR 0- 3 00000001 80ABDB30 00000000 00000000[9]
AMTT7PI High GPR 4- 7 00000000 00000000 000001F1 00000000[8]
AMTT7QI Low GPR 4- 7 00000000 00000000 65DAF800 00000000[9]
AMTT7PI High GPR 8-11 000001F1 00000000 00000000 00000000[8]
AMTT7QI Low GPR 8-11 65D0A000 27F87000 7F601400 00000000[9]
AMTT7PI High GPR 12-15 00000000 00000000 00000000 0000001C[8]
AMTT7QI Low GPR 12-15 2F32C600 7F542000 7F5424D8 806D7338[9]
AMTT76I The task is Waiting on ECB1 at 7F5424D8             [11]
AMTT76I The task is Waiting on ECB2 at 7F601624             [11]

In this example, the high-order word of the 16 general purpose registers is displayed because at least one of those words is non-zero. The access registers were not displayed because they all contained zero.

Example 3

After displaying detailed information for the TCB, you might want to use other services to display other information. For example, you can use the DUMP service to display the contents of storage referenced by the task's registers; you can use the WHERE service to determine the subpool and other information. To display the contents of storage at R12 (which refers to the 64-bit address in general register 12), type

DUMP,R12

AMTC1ZI 00000000_2F32C600 KEY= 0    VAM3R7   (ASID 005A)
AMTC12I 2F32C600 A7F40044 58C1E2E3 5BE2C4E5 D95EF0F5 *x4   AST$SDVR;05*
AMTC12I 2F32C610 61F0F261 F1F25EF1 F24BF4F4 5EC4C5E5 */02/12;12.44;DEV*
AMTC12I 2F32C620 6DD3E5D3 5E404040 40404040 5E404040 *_LVL;       ;   *
AMTC12I 2F32C630 40404040 5E5E5E5E 2F32C6A4 5E4DC35D *    ;;;; Fu;(C)*

To display location-related information (such as the subpool, key, and load module name if applicable) and offset into the load module, type

WHERE,R12

AMTWH4I 2F32C600 Found in Extended Private storage
AMTWH7I Subpool 252 (Pageable), key 0, Owned by TCB 6FF3A0 (@TCB4)
AMTWH5I At AST$$FV3+3600      Load Adrs=2F329000, Len=00008000

Example 4

To display more detailed information about a TCB, type

TCB,@TCB5

AMTT71I Address Space: XTST6PAS.PAS6 Step: PAS6

AMTT72I @TCB5 TCB 6EE220 Prty 255 NDSP 0400 PK 40
AMTT7LI---|------------------------------------------------------5
AMTT7YI OTC 6DDAE8 NTC 6DD858 LTC 6C2E88 JSTCB 6DDAE8     0.00 CPU Sec
AMTT73I PRB 6C9278 EP AF3D06B0 WLIC 00020001 BBM9ZB01
AMTT7XI PSW 074C1000 AF3D0BF8 WT 01 CDE 006CA3C8
AMTT7QI Low GPR     0- 3 00000001 80F161DC 7F0E9E1C 006CE8B4
AMTT7QI Low GPR     4- 7 00000040 006C7F68 2F3D1F28 006CE848
AMTT7QI Low GPR     8-11 AF3D0BEC 2F3D06B0 7F0E9FB8 006C6C98
AMTT7QI Low GPR    12-15 2698B5A8 7F0E9CC0 AF3D0FEC 806C9278
AMTT7RI Access Regs 0- 3 00000000 00000000 00000000 00000000 [10]
AMTT7RI Access Regs 4- 7 00000000 00000000 00000000 00000000 [10]
AMTT7RI Access Regs 8-11 00000000 00000000 00000000 00000000 [10]
AMTT7RI Access Regs 12-15 00000000 00000000 00000000 00000C05 [10]

AMTT76I The task is Waiting on ECB1 at 006C6CF8
AMTT76I The task is Waiting on ECB2 at 7F0E9E34

Generated symbols

In addition to generating a symbol for each TCB that refers to the address of the TCB it represents, the following symbols are generated whenever detailed information for a specific TCB is requested.

Symbol	Description
BBBASIC	The address of the basic section (RBBASIC) of the last (most recently created) RB for the task.
PSW	The address contained in the second word of the PSW in the last (most recently created) RB for the task.
R0 through R15	The 64-bit value for the last (most recently created) RB for the task.
ECBn	address of an ECB upon which the task is waiting. One symbol is generated for each ECB upon which the task is waiting.