IBM: IPLBK

Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

IPLBK

Prolog

Control Block Contents

IPLBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

IPLBK Prolog

 NAME       : HCPIPLBK
 DESCRIPTION: IPL Command Work Buffer
 DSECT      : IPLBK
 FUNCTION   : Used by the virtual IPL command (HCPCLS/HCPCLT)
              as a work area.
 LOCATED BY : NONE
 CREATED BY : HCPCLS
 DELETED BY : HCPCLS

IPLBK Control Block Content


IPLBK DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      IPLBK          IPL Command Work Buffer
0000    0 Signed       2 IPLCADR        GUEST CONSOLE ADDRESS
0002    2 Signed       2 IPLDEVAD       IPL DEVICE ADDRESS
0004    4 Address      4 IPLOPTLH (2)   LENGTH AND ADDRESS OF OPTION ON
                                        COMMAND LINE (RETURNED BY
                                        HCPSCCFD)
000C   12 Address      4 IPLPARMA       ADDRESS OF "PARM" DATA STRING
0010   16 Signed       2 IPLPARML       LENGTH OF "PARM" DATA STRING
0012   18 Signed       2 IPLNSSLN       LENGTH OF NSS NAME
0014   20 Character    8 IPLNSSNM       SAVE AREA FOR NSS NAME
001C   28 Signed       4 IPLCYLBK       CYLINDER/BLOCK NUMBER
0020   32 Address      4 IPLNSABK       ADDRESS OF NSABK
0024   36 Character    8 IPLLOADV       "LOADPARM" VALUE SPECIFIED
002C   44 Address      4 IPLSAVE        HOST REAL IPL SIMULATOR ADDRESS
0030   48 Character    8 IPLSTOR        BUFFER FOR STORAGE SIZE FOR MSG.
0038   56 Character    1 IPLDEVCD       IPL DEVICE TYPE CODE
0039   57 Character    1 IPLDEVTP       IPL DEVICE TYPE
003A   58 Character    1 IPLCONST       CONSOLE DEVICE TYPE
003B   59 Bitstring    1 *              Reserved for IBM use
003C   60 Address      4 IPLOPTST       Starting addr. of IPL cmd in
                                        GSDBK
0040   64 Dbl-Word     8 * (0)          Alignment
0040   64 Character   32 IPLSUBD        MESSAGE SUBSTITUTION DATA
          00000048       IPLSUBDL       IPLSUBD+8,1 SUBSTITUTION DATA
                                        DELIMITER FIELD
0060   96 Bitstring    1 IPLNSSFG       NAMED SAVED SYSTEM (NSS) FLAGS
          .... ...1      IPLNSSST       X'01' INDICATE PRESENCE OF NSS
          .... ..1.      IPLCONV        X'02' TO DIFFERENTIATE, WHEN
                                        NEITHER THE DEVICE OR THE SYSTEM
                                        NAME EXISTS
          .... .1..      IPLNSAFG       X'04' REMINDER TO RELEASE NSABK
0061   97 Bitstring    1 IPLCOPTS       OPTIONS SPECIFIED ON IPL COMMAND
          .... ...1      IPLLOADP       X'01'
          .... ..1.      IPLSTOP        X'02'
          .... .1..      IPLNOCLR       X'04'
          .... 1...      IPLCLR         X'08'
          ...1 ....      IPLPARM        X'10'
          ..1. ....      IPLVMXA        X'20'
          .1.. ....      IPLATTN        X'40'
          0000000D       IPLBSIZE       (*-IPLBK+7)/8
0040   64 Character    3 IPL177SB (0)   SUBSTITUTION DATA FOR MESSAGE 177
0040   64 Character    2 IPL177LT       LIMIT THAT WAS EXCEEDED
0042   66 Character    1 IPL177EN       DELIMITER FOR END OF SUBSTITUTION

IPLBK Storage Layout

*** IPLBK - IPL Command Work Buffer
*
*     +-------------+-------------+---------------------------+
*   0 |  IPLCADR    |  IPLDEVAD   |        IPLOPTLH-          |
*     +-------------+-------------+---------------------------+
*   8 |          -(004)           |         IPLPARMA          |
*     +-------------+-------------+---------------------------+
*  10 |  IPLPARML   |  IPLNSSLN   |        IPLNSSNM-          |
*     +-------------+-------------+---------------------------+
*  18 |          -(014)           |         IPLCYLBK          |
*     +---------------------------+---------------------------+
*  20 |         IPLNSABK          |        IPLLOADV-          |
*     +---------------------------+---------------------------+
*  28 |          -(024)           |         IPLSAVE           |
*     +---------------------------+---------------------------+
*  30 |                       IPLSTOR                         |
*     +------+------+------+------+---------------------------+
*  38 |:DEVCD|:DEVTP|:CONST|//////|         IPLOPTST          |
*     +------+------+------+------+---------------------------+
*  40 |                                                       |
*     =                       IPLSUBD                         =
*     |                                                       |
*     +------+------+-----------------------------------------+
*  60 |:NSSFG|:COPTS| 62
*     +------+------+
*
*** IPLBK - IPL Command Work Buffer
*** Overlay for IPLSUBD in IPLBK
*
*     +-------------+------+
*  40 |  IPL177LT   |:177EN| 43
*     +-------------+------+
*
*** Overlay for IPLSUBD in IPLBK