HFZXDLOCLocate dump storage using system buffering

Format


#include "hfzxufmh.h"

int HFZXDLOC(int addr, int len);

General description

The HFZXDLOC() function is used to access storage in the analyzed address space by virtual address and length.

Note: To prevent out-of-storage conditions when accessing large amounts of virtual storage, use the HFZXXLOC function instead. For details, see HFZXXLOC – Locate dump storage using own buffering.

For real-time processing, the storage that is accessed is generally that of the actual address space which is being analyzed. For reanalysis, the storage is obtained from the minidump.

Regardless of real time or reanalysis mode, do not dereference storage areas that are not obtained by calling the HFZXDLOC() function, since protection exceptions might otherwise occur.

HFZXDLOC() is functionally equivalent to the Z Abend Investigator REXX command "Evaluate".

Returned value

If the storage is available for the requested length, then HFZXDLOC() returns the address of the storage area.

HFZXDLOC() returns a negative value if the requested address is available, but for a length that is less than the requested length. The available length can be determined by subtracting the returned value from 0. To obtain the address of the partial storage area, call HFZXDLOC() again with the reduced length.

A zero value is returned if the requested address is not available, regardless of length.

Example


#include "hfzxufmh.h"

int maddr, cvt;
maddr = HFZXDLOC(16,4);  /* Get address of CVT pointer /
if (maddr > 0)
  cvt = (int )maddr;     /* Get CVT pointer */