CEEVHRPT — obtain dynamic heap storage report

CEEVHRPT returns information about an application's user heap storage (specifically, enclave-level heap ID 0). CEEVHRPT returns information that is similar to the information in the user heap storage section of the report that is generated when you specify the RPTSTG(ON) runtime option.

Using CEEVHRPT, an application that is running can obtain information about heap storage. However, CEEVHRPT will not report any information that relates to the heap pool manager; rather, storage information about heap pools will be included in the number of allocated user heap bytes that is returned by the service.

CEEVHRPT

Call this CWI interface as follows:

L     R15,CEECAACELV-CEECAA(,R12) 
L     R15,4032(,R15)
BALR  R14,R15

uheap_size (input)

The total amount of user heap storage that is currently allocated by the application.

uheap_bytes_alloc (input)

The amount of user heap storage that is currently in use by the application.

uheap_bytes_free (input)

The amount of user heap storage that is currently available to the application. Note that the available storage may not be contiguous.

fc (output/optional)

A 12-byte feedback code that indicates the results of this service.

Condition
CEE000	Severity	0
	Msg_No	N/A
	Message	The service completed successfully.
CEE0P2	Severity	4
	Msg_No	802
	Message	Heap storage control information was damaged.
CEE3JN	Severity	0
	Msg_No	3704
	Message	Expected data at address address: data
CEE3JO	Severity	0
	Msg_No	3705
	Message	Pointer at address should point to a valid controlblock
CEE4VG	Severity	3
	Msg_No	5104
	Message	The z/OS UNIX System Services callable service BPX1PTQ failed.