Programming Interface Information:
This page documents intended Programming Interfaces that allow the customer to write programs to obtain the services of z/VM. |
IPARM
Control Block Contents
IPARM DSECT
IPAX DSECT
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
Copyright IBM Corporation, 1990, 2011