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

#### IPARM

Prolog

Control Block Contents
IPARM DSECT
IPAX DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### IPARM Prolog

     Name       : HCPIPARM
     Description: IPL parameters
     DSECT      : IPARM
     Function   : IPARM maps the parameters passed in general
                  registers 0 through 15 to CP when it is loaded
                  from a module.
     Located by : In R0-R15 at entry to HCPLODNC and saved at
                  HCPLODPM thereafter.
     Created by : HCPSAL, HCPBOU
     Deleted by : N/A

#### IPARM Control Block Content

#### IPARM DSECT

####

####

####

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      IPARM          IPL parameters
    0000    0 Character   32 IPARMS         IPL parameters
    0020   32 Bitstring    1 * (4)          Reserved for Future IBM Use
    0024   36 Address      4 IPAEPARM       Pointer to extended IPL parm area
    0028   40 Bitstring    6 IPADATE        Module date/time (YYMMDDHHMMSS)
    002E   46 Bitstring    1 IPAINITL       Save for SYSINITL field
    002F   47 Bitstring    1 IPARFIFL       Reserved for HCPRFI
    0030   48 Bitstring    1 * (4)          reserved for future use Note:
                                            This word does not survive a
                                            bounce (it contains HCPLOD's
                                            base).
    0034   52 Signed       4 IPAOFFST       Offset to parm disk
    0038   56 Character    8 IPANAME        Name of CP module
              00000040       IPASIZEB       (*-IPARM) Size in bytes
              00000008       IPASIZED       (*-IPARM+7)/8 Size in d-words
          Function   : IPAX maps the extended IPL Parameter area
                       registers 0 through 15 to CP when it is loaded
                       from a module.
          Located by : Created in HCPSAL's and HCPBOU's work page.
                     - IPAEPARM at entry to HCPLODNC and saved at
                       HCPLODPM thereafter.
          Created by : HCPSAL, HCPBOU
          Deleted by : N/A

    IPAX DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      IPAX           IPL parameters
    0000    0 Character  240 IPAXIPRM       IPL Parameter buffer
              1111 ....      IPAXIPRL       240 IPAXIPRL Length of IPL
                                            Parameter buffer
    00F0  240 Address      4 IPAXPSIB       Pointer to PSIBK. Zero if SAPL.
    00F4  244 Signed       4 IPAXDEVS       IPL Device Subchannel ID. If
                                            IPL'ed from FCP, this is FCP
                                            Device SubChannel ID
    00F8  248 Bitstring    1 * (2)          Reserved for Future IBM Use
    00FA  250 Bitstring    2 IPAXDEVA       IPL Device Number. If IPL'ed from
                                            FCP, this is FCP Device Number.
    00FC  252 Bitstring    8 IPAXWWPN       WWPN if IPL'ed from FCP Device
    0104  260 Bitstring    8 IPAXLUN        LUN if IPL'ed from FCP Device
    010C  268 Signed       4 * (2)          Reserved for Future IBM Use Notes
                                            : If IPL from FCP, IPL Parameter
                                            PDVOL=<rdev> must b
                                            specified and IPL Device (where
                                            SAPL is) must = SYSRES device
                                            (where module is) and must = PARM
                                            DISK device (where config file
                                            is).
              00000114       IPAXSIZB       (*-IPAX) Size in bytes
              00000023       IPAXSIZD       (*-IPAX+7)/8 Size in d-words

    IPARM Storage Layout

    *** IPARM - IPL parameters
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                        IPARMS                         =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  20 |///////////////////////////|         IPAEPARM          |
    *     +---------------------------+-------------+------+------+
    *  28 |                IPADATE                  |:INITL|:RFIFL|
    *     +---------------------------+-------------+------+------+
    *  30 |///////////////////////////|         IPAOFFST          |
    *     +---------------------------+---------------------------+
    *  38 |                       IPANAME                         |
    *     +-------------------------------------------------------+
    *  40
    *
    *** IPARM - IPL parameters

    *** IPAX - IPL parameters
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       IPAXIPRM                        =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  F0 |         IPAXPSIB          |         IPAXDEVS          |
    *     +-------------+-------------+---------------------------+
    *  F8 |/////////////|  IPAXDEVA   |        IPAXWWPN-          |
    *     +-------------+-------------+---------------------------+
    * 100 |          -(0FC)           |         IPAXLUN-          |
    *     +---------------------------+---------------------------+
    * 108 |          -(104)           |///////////////////////////|
    *     +---------------------------+---------------------------+
    * 110 |///////////////////////////| 114
    *     +---------------------------+
    *
    *** IPAX - IPL parameters

    IPARM Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    IPADATE        0028
    IPAEPARM       0024
    IPAINITL       002E
    IPANAME        0038
    IPAOFFST       0034
    IPARFIFL       002F
    IPARMS         0000
    IPASIZEB       0038 00000040
    IPASIZED       0038 00000008
    IPAXDEVA       00FA
    IPAXDEVS       00F4
    IPAXIPRL       0000 F0
    IPAXIPRM       0000
    IPAXLUN        0104
    IPAXPSIB       00F0
    IPAXSIZB       010C 00000114
    IPAXSIZD       010C 00000023
    IPAXWWPN       00FC

    This information is
    based on z/VM V6R1.0.
    Last updated on 18 Feb 2010 at 08:44:40 EDT.

    Copyright IBM Corporation, 1990, 2008