TABLE - Show table

The TABLE statement serves to output part or all of a table from the currently processed UTM dump. The output can be in dump format or in symbolic form.

TABLE

table-name  [, start-index     [, { END-INDEX = { SAME | LAST }      |          DISPL = displacement             |          SDI = { *YES | struct-par }                [, OUTFILE = { filename | *SYSLST} ]                [, DB = db-no ]         }  ]  ]

table-name	Name of the table to be output. You can use the HELP TABLE-NAMES command to display a list of all table names. The table names can be abbreviated as long as they remain unique. The following rules apply: There must be at least one character at the beginning and after a hyphen. This character must be the first character of the name. The individual name parts which begin with a hyphen and are delimited by the next hyphen or by the end can be omitted if the following name part - where one was present - is also removed. Example The table name HLL-USER-ARE can be abbreviated as HL-U or HL-US or H-U-A etc.
start-index	This positional operand specifies the number of the entry at which the output is to commence. The default value is 0. If the operand is given the value 0, the entire table is output and all other operands have no effect.Notes In the case of the trace tables, with a null specification the current entry is displayed as the last item on the screen page. For bit tables and tables whose entries are always two bytes in length, it is generally not possible to position precisely to the desired entry. But the entry is then contained in first line output with table information.
END-INDEX=	This operand can be used to specify whether, apart from the entry specified under "start-index", any other table entries are to be displayed.
SAME	Only the entry specified with "start-index" is displayed.
LAST	The entire table is displayed starting with the entry "start-index".
DISPL=displacement	This facility can be utilized in order to output the table entry specified in the second positional operand with a displacement from the beginning of the table entry. This capability is supported only for tables in normal dump format, i.e. in hexadecimal representation. The input format is decimal or hexadecimal (see example).

SDI =	The operand SDI (Symbolic Dump Information) serves to output the table entries which have been edited using AID. Not all tables can be edited symbolically. Those tables which can be edited symbolically are flagged by a "D" following the table name in the output produced by the command HELP TABLE-NAMES. If symbolic editing is not possible, this is flagged by means of an "N". Moreover, the KDCDUMP utility must have been started with the operand TEST-OPTION=AID.
*YES	The table element is output with symbolic editing.
struct-par	Fully-qualified name of a structure element without a structure name (see examples below) which is to be edited symbolically. The maximum length of "structure-parameter" is 121 characters. The name must be specified as a C-string.
OUTFILE=	When symbolic editing is employed, this operand can be used to direct the output to a file.
filename	Name of the file to which the edited information is to be written. In this case, the AID link name F0 of the AID command %OUTFILE is destroyed. If the specified file already exists, it will be extended by the output.
*SYSLST	The output is directed to SYSLST.

The default value applies for the optional operands END-INDEX, DISPL and SDI: END-INDEX = SAME.

Notes

• If the selected table information does not fit in one screen page, scrolling statements (see relevant section) can be used to make further data visible (does not apply to symbolic editing).

• If a substructure element is incorrectly specified for symbolic editing, AID will issue an error message. In this case, message K746 is not output and job switch 3 is not set.

Examples

1. T KB,1,S=*YES
   Outputs the KB header and the KB return area.

2. T KB,1,S='KCRFELD' 
Outputs the substructure KB.KCRFELD.

3. T KB,1,D=116
Outputs the KB program area as of displacement 116.

4. T UTM-D,X'2EB'
Outputs the trace entry 2EB of the UTM Diagarea.