MAPSAVAR (Map Save Area) Macro

The MAPSAVAR macro can be used to interpret the save area information that is returned by the STXIT macro.

A mapping DSECT with the name SVUARA is generated.

Format

Read syntax diagramSkip visual syntax diagram MAPSAVAR

Requirements for the caller

RMODE:
24 or ANY

Mapping

Table 1 describes the mapping and contents of the DSECT fields.

Table 1. Mapping of the STXIT Save Area (AMODE=24 and MSGDATA=NO)
Field Name No. of Bytes Contents
SVUPSW 4 First half of (BC-mode) PSW of interrupted program
SVUPSW2 4 Second half of PSW
SVUR00 4 Save area for register 0
SVUR01 4 Save area for register 1
  ⋮   ⋮    ⋮
SVUR0F 4 Save area for register 15
SVUOLDLN   Old save area length

If AMODE=31 or MSGDATA=YES is specified in the STXIT macro, the extended save area as shown in Table 2 is used:

Table 2. Mapping of the Extended STXIT Save Area (AMODE=31 or MSGDATA=YES)
Field Name No. of Bytes Contents
SVUPSW 4 First half of (BC-mode) PSW of interrupted program
SVUPSW2 4 Second half of PSW
SVUR00 4 Save area for register 0
SVUR01 4 Save area for register 1
  ⋮   ⋮   ⋮
SVUR0F 4 Save area for register 15
SVUOLDLN   Old save area length
SVUAPSW 8 Actual PSW of interrupted program
SVUACCOD 1 AB Exit: Cancel Code
  7 Reserved
  64 Exit-dependent area:
SVUABINF   AB exit: Cancel information
SVUMGADR   OC exit: Data from MSG command
SVUMCSID   4-byte console ID (CONSID) of the console where the MSG command was entered. The setting of the high-order bit indicates if the console has 'master' (0) or 'user' (1) authority.
SVUMNAME   8-byte name of the console where the MSG command was entered.
SVUMCART   8-byte command and response token (CART) associated with the MSG command.
SVUMDLNG   2-byte length of MSG data
SVUMDATA   31-bit pointer to MSG data (zero if no data is specified).
SVUEXLNG   Length of OC exit extension
SVUAREG 64 Save area for access registers
SVUAR00   Save area for access register 1
  ⋮   ⋮   ⋮
SVUAR0F   Save area for access register 15
SVULNGTH   New save area length
SVUOCLEN   Save area for OC exit extension
Table 3. Mapping of the STXIT Save Area (AMODE=ANY64)
Field Name No. of Bytes Contents
SVUFPR 128 16 floating point registers
SVUFPCR 4 Floating point control register
SVUREGH 64 High-order halves of 16 general registers
SVUBEAR 8 PC exit: breaking event address
SVULNG64   Length of AMODE=ANY64 save area