CEEHDMP — hexadecimal storage dump service

The CEEHDMP low-level service dumps a section of storage in both hex and character representations. It contains protection against addresses that are not valid.

CHARn     *title;
INT4      *title_length;
INT4      *address;
INT4      *length;
FEED_BACK *fc;

CEEHDMP

Call this CWI interface as follows:

L     R15,CEECAACELV-CEECAA(,R12)   Address of CAA in R12
L     R15,0044(,R15)
BALR  R14,R15

title (input)

A fixed-length character string that identifies the displayed storage section.

title_length (input)

A fullword binary integer containing the length of the title. The maximum length is 60 characters.

address (input)

A 31-bit address of the first byte of storage to be dumped.

length (input)

A fullword binary integer containing the length of the storage area.

fc (output)

A 12-byte feedback code passed by reference. The following symbolic conditions can result from this service; if more than one error condition occurs, the feedback code reflects the last diagnosed condition:

Condition
CEE000	Severity	0
	Msg_No	N/A
	Message	The service completed successfully.
CEE30T	Severity	2
	Msg_No	3101
	Message	The title string was longer than 132 characters and was truncated.
CEE30V	Severity	3
	Msg_No	3103
	Message	An error occurred in writing messages to the dump file.
CEE313	Severity	3
	Msg_No	3107
	Message	Dump terminated before all storage could be dumped because inaccessible storage was encountered.

Lines in the dump contain the format shown in Figure 1.

Figure 1. CEEHDMP output format

1

The string given on the title argument. The string is truncated if it is too long to fit on a single dump line.

2

The starting address of this section of storage.

3

The offset in hexadecimal from the first byte of the dump.

4

The hexadecimal address of the first byte dumped on the line.

5

32 bytes of storage dumped as 8 single hexadecimal numbers.

6

The same 32 bytes of storage dumped in character form. Any byte values between X'00' and X'3F' are displayed as periods, however.