WHERE primary command — identify an area at a given address

Use the WHERE primary command to identify an area at a given address. See the WHERE subcommand for more examples of the primary command.

Syntax
```
    { WHERE } data-descr
    { W     }
```
Parameter
data-descr
Specifies the data description parameter, which consists of two parts:
- An address
- Address processing parameters
Data description parameter has more information about the syntax and use of the data description parameter.
Note: The WHERE primary command uses only two of the five possible parts of a data description parameter.
Usage notes
- WHERE can be used from the BROWSE option pointer panel and storage panel, and from the dump display reporter panel.
- WHERE produces a brief report describing all areas, structures, and modules that contain the address of interest.
- The area, structure, or module with the closest address to the address of interest is the one that will be added to the pointer stack. (More than one area may satisfy the search criteria.)

Example: Identify an area at a given address.

Action

The following screen shows the WHERE primary command being issued from the BROWSE option pointer panel. The same results occur if the command are issued from a dump display reporter panel.

DSNAME('D46IPCS.DRVC400.SA00001') POINTERS  -----------------------------------
-----------------------
|COMMAND ===> w 6b0_   |                                       SCROLL ===> CSR
-----------------------
PTR   Address  Address space                            Data type
00001 00000000 ASID(X'0003')                            AREA
      Remarks:
00002 000006B0 ASID(X'0003')                            AREA
      Remarks:
00003 00FD7420 ASID(X'0001')                            STRUCTURE(Cvt)
      Remarks: Communications Vector Table
**************************** END OF POINTER STACK *****************************

Result

First, all items that contain this address are displayed using the dump display reporter panel.

IPCS OUTPUT STREAM -------------------------------------- LINE 0 COLS 1 78
COMMAND ===> _                                             SCROLL ===> CSR
 ****************************** TOP OF DATA ***********************************
      ASID(X'0003') 000006B0. STRUCTURE(Psa)+06B0 IN PSA
      ASID(X'0003') 000006B0. IEAVFX00+06B0 IN PSA
 ****************************** END OF DATA ***********************************

Then, the item with the smallest offset that contains the address ‘6b0’ – in this case, the PSA – is added to the pointer stack. The following screen shows the updated pointer stack.

DSNAME('D46IPCS.DRVC400.SA00001') POINTERS  -----------------------------------
COMMAND ===> _                                             SCROLL ===> CSR
PTR   Address  Address space                            Data type
00001 00000000 ASID(X'0003')                            AREA
      Remarks:
00002 000006B0 ASID(X'0003')                            AREA
      Remarks:
00003 00FD7420 ASID(X'0001')                            STRUCTURE(Cvt)
      Remarks: Communications Vector Table
-------------------------------------------------------------------------------
|00004 00000000 ASID(X'0003')                           STRUCTURE(Psa)        |
|      Remarks:                                                               |
-------------------------------------------------------------------------------
**************************** END OF POINTER STACK *****************************