IDIXDLOC – Locate dump storage using system buffering

Format


#include "idixufmh.h"

int IDIXDLOC(int addr, int len);

General description

The IDIXDLOC() 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 IDIXXLOC function instead. For details, see IDIXXLOC – 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 IDIXDLOC() function, since protection exceptions might otherwise occur.

IDIXDLOC() is functionally equivalent to the Fault Analyzer REXX command "Evaluate".

Returned value

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

IDIXDLOC() 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 IDIXDLOC() again with the reduced length.

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

Example


#include "idixufmh.h"

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