Programming Interface Information: This page documents intended Programming Interfaces that allow the customer to write programs to obtain the services of z/VM.

#### USERSAVE

Prolog

Control Block Contents
USERSAVE DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### USERSAVE Prolog

     Name       : USERSAVE
     Description: User Save Area
     DSECT      : USERSAVE
     Function   : Maps the area pointed to by R13 upon
                  entry to a program called by SVC.

#### USERSAVE Control Block Content

#### USERSAVE DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      USERSAVE       User Save Area
    0000    0 Dbl-Word     8 * (12)         Reserved for the user.
              00000060       USERSIZE       *-USERSAVE Size of area reserved
                                            for user.
    0060   96 Dbl-Word     8 USERINFO       Information passed to user.
    0060   96 Bitstring    1 USECTYP        Contains CALLTYP value.
    0061   97 Bitstring    1 USEUFLG        Contains UFLAGS value.
    0062   98 Bitstring    1 * (2)          Reserved for IBM use.
    0064  100 Bitstring    1 USEMFLG        Miscellaneous bits.
              1... ....      USECMS         X'80' USECMS Invoked by CMSCALL.
              .1.. ....      USEA31         X'40' USEA31 Caller's AMODE is
                                            31.
              ..1. ....      USESCBLK       X'20' USESCBLK SCBLOCK is
                                            available in R2.
              ...1 ....      USEPLIST       X'10' USEPLIST Extended PLIST
                                            available in R0, only valid if
                                            invoked by CMSCALL.
              .... 1...      USEAR          X'08' USEAR Caller was in AR-mode
                                            when CMSCALL issued
    0065  101 Bitstring    1 * (3)          Reserved for IBM use.
              0000000D       USERSAVL       (*-USERSAVE+7)/8 BLOCK LENGTH
                                            (DOUBLEWORD)

#### USERSAVE Storage Layout

    *** USERSAVE - User Save Area
    *
    *     +-------------------------------------------------------+
    *   0 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  60 |                       USERINFO                        |
    *     +-------------------------------------------------------+
    *  68
    *
    *** USERSAVE - User Save Area

    *** Overlay for USERINFO in USERSAVE
    *
    *     +------+------+-------------+------+--------------------+
    *  60 |:CTYP |:UFLG |/////////////|:MFLG |////////////////////|
    *     +------+------+-------------+------+--------------------+
    *  68
    *
    *** Overlay for USERINFO in USERSAVE

#### USERSAVE Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    USEAR          0064 08
    USEA31         0064 40
    USECMS         0064 80
    USECTYP        0060
    USEMFLG        0064
    USEPLIST       0064 10
    USERINFO       0060
    USERSAVL       0065 0000000D
    USERSIZE       0000 00000060
    USESCBLK       0064 20
    USEUFLG        0061

This information is based on z/VM V6R1.0.
Last updated on 23 Oct 2009 at 11:04:05 EDT.
Copyright IBM Corporation, 1990, 2008