The following table gives an overview of all the KDCDUMP statements and their meanings:
Statement | Meaning |
! | Interrupt KDCDUMP and execute system command |
!! | Execute most recently executed system command again |
AFIND | Find address in UTM dump |
scrolling statements | Position cursor in work area |
DUMP | Read complete UTM dump or part of a UTM dump into memory |
EDT | Call editor |
END | Terminate KDCDUMP |
FIND | Find and show table entry |
FGG | Edit all files of an FGG (file generation group) |
FILE | Edit single dump file |
HELP | Display help for KDCDUMP statements |
LIST | Edit table section |
| REPFILE | Information about REP file (only BS2000 systems) |
SFIND | Search for a pattern in the dump |
SH | SYS | Interrupt KDCDUMP and return to operating system level |
SYSLST | Activate/deactivate logging |
TABLE | Show table |
If an error occurs during the execution of KDCDUMP, such as an input error or an error in the program itself, then job switch 3 will be set to "ON" if the error is not an address error or when the dump is incomplete. The list of KDCDUMP messages can be found in section "Messages of the UTM tool KDCDUMP".
Job switch 3 is set to "ON" by KDCDUMP at the beginning of the program run. If no error occurs during the program run, then the switch is set to "OFF". Switch 3 may also not be manipulated during the program run by the user. In particular, then user may not set the switch to “OFF” using the ! statement or after the SH or SYS statement.
Entering KDCDUMP statements
KDCDUMP statements are read from SYSDTA. A statement may comprise up to 256 characters; longer inputs result in error message K759.
Where statement names can be abbreviated, this is indicated in bold type. Thus, for example AFIND, indicates that you can abbreviate the statement name to AF.
With certain operands, one of the three input formats "C-string", "X-string" or "decimal" must be observed:
Designation | Input format / Example |
C-string | [C]'This is a C-string' |
X-string (hexadecimal) | X'AAAF' or X'aaaf' or X'AaAf' |
Decimal | 12345 |
Only C-strings are case-sensitive. Case is not significant for the other input formats.
If indices or displacements/offsets are specified, then these are always interpreted as being positive.The sections which follow describe the KDCDUMP statements in alphabetical order. Only the statements and operands are described here which are used for evaluating the KDCROOT area (see chapter "The KDCROOT area").