StorageRange

Read syntax diagramSkip visual syntax diagram
Syntax

   .-NOSTORAGERANGE----------------------------------------.   
>>-+-------------------------------------------------------+---><
   +-NOStorageRange----------------------------------------+   
   |                  .-,-----------------------------.    |   
   |                  V                               |    |   
   '-StorageRange--(----begin_address--,--end_address-+--)-'   

This option can be used to request that one or more specific areas of storage are shown in the analysis report, instead of the default event-associated or system-wide hex-dumped storage.

The primary usage of this option is expected to be with HFZSNAP calls from application programs, where only a certain area (or areas) of storage is of interest. For example, a COBOL programmer can choose to call HFZSNAP with a StorageRange option that specifies a particular variable in the program's working-storage section. Instead of the analysis report containing all of the program's associated storage, it instead contains only the area requested.

For information about how to specify this option in a call to HFZSNAP, see Using the program SNAP interface (HFZSNAP).

If this option is in effect for real-time analysis, then the same specification is in effect during any subsequent reanalysis of the fault entry, without the ability to override the option.

The begin address is the address of the first byte of the storage area, while the end address is the address of the byte immediately following the last byte of the storage area. That is, the end address minus the begin address equals the length of the storage area to be included.

Multiple storage ranges can be specified in any order, as long as the end address is greater than the begin address. Any invalid storage ranges are ignored.

Multiple specifications of the StorageRange option replace any prior specifications, that is, the option is not cumulative.

The StorageRange option is shown in the "Options in Effect" section of the analysis report only if it has been specified in real time with at least one valid storage range.