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 Signed       4 IPAXDEVN (0)   IPL Device number
00F8  248 Bitstring    1 * (2)          Device number high-order
00FA  250 Bitstring    2 IPAXDEVA       IPL Device Number low-order 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
IPAXDEVN       00F8
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 V6R2.0. Last updated on 21 Nov 2011 at 11:05:42 EDT.
Copyright IBM Corporation, 1990, 2011