FCLBK

Prolog  

Control Block Contents  
   FCLBK DSECT
   FCLVPARM DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  

FCLBK Prolog

 NAME       : HCPFCLBK
 DESCRIPTION: FCP List Directed IPL Block Mapping
 DSECT      : FCLBK
 FUNCTION   : Provide symbolic references for the fields used
              by List Directed IPL.
 LOCATED BY : VMDFCLBK
 CREATED BY : HCPFCLSE - With SET LOADDEV command
              HCPUDM   - With LOADDEV directory entry
 DELETED BY : HCPFCLSE - SET LOADDEV CLEAR command
              HCPUSP   - LOGOFF / FORCE
 RELOCATION CONSIDERATIONS : This control block is relocated as part of a live
              guest relocation (LGR).  The bits and fields that
              need to be relocated are defined in the
              corresponding LGRFCLBK COPY file.  Whenever changes
              are made to this control block, consideration must
              be given to any effects these changes will have on
              a relocation.  If any new fields or bits are
              defined, they may need to be relocated.  If
              existing bits or fields are changed, corresponding
              modifications may be required in the LGR version of
              this control block.  Consider also the effects of
              these changes on a relocation involving a back-level
              release of CP.

FCLBK Control Block Content

FCLBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      FCLBK          FCP List Directed IPL Block Mapping
0000    0 Bitstring    1 FCLPFLAG       Parameter "SET" flags
          1... ....      FCLPNSET       X'80' FCLPNSET PORT NAME set
          ...1 ....      FCLBRSET       X'10' FCLBRSET BR_LBA set
          .... 1...      FCLLNSET       X'08' FCLLNSET LUN set
          .... .1..      FCLBPSET       X'04' FCLBPSET BPS set
          .... ..1.      FCLSCSET       X'02' FCLSCSET SCPDATA set
0001    1 Bitstring    1 FCLIPLOP       IPL Options Flag
          1... ....      FCLILOAD       X'80' FCLILOAD List-Directed IPL
          .1.. ....      FCLIDUMP       X'40' FCLIDUMP List-Directed IPL
                                        with Dump
          ..1. ....      FCLISTOP       X'20' FCLISTOP STOP Option
                                        Specified
          ...1 ....      FCLIATTN       X'10' FCLIATTN ATTN Option
                                        Specified
0002    2 Signed       2 FCLDEV         Device Number of FCB Subchannel
0004    4 Signed       4 FCLBPS         BOOT PROGRAM SELECTOR
0008    8 Dbl-Word     8 FCLPTNM (0)    PORT NAME
0008    8 Signed       4 FCLPTNW1       PORT NAME 1
000C   12 Signed       4 FCLPTNW2       PORT NAME 2
0010   16 Dbl-Word     8 FCLLUN (0)     LUN
0010   16 Signed       4 FCLLUNW1       LUN ID WORD 1
0014   20 Signed       4 FCLLUNW2       LUN ID WORD 2
0018   24 Dbl-Word     8 FCLBRLBA (0)   BOOT RECORD LOGICAL BLOCK ADDR
0018   24 Signed       4 FCLBRW1        BOOT RECORD LBA 1
001C   28 Signed       4 FCLBRW2        BOOT RECORD LBA 2
      SCPDATA - Notes      : this section is mapped to FCLVPARM DSECT
          00000AAC       FCLSCMXL       PFX4096 Maximum SCPDATA length
                                        (user input)
          00000AAC       FCLSCMXU       PFX4096 Maximum SCPDATA length
                                        (UTF-8)
0020   32 Signed       2 FCLSC (0)
0020   32 Address      4 FCLSCA         SCP Data address (original input)
0024   36 Signed       4 FCLSCL         Length of SCP Data (input)
0028   40 Signed       4 FCLSCU         Length of SCP Data (UTF-8)
002C   44 Bitstring    1 FCLSCFLG       Option flags for SCP Data
          1... ....      FCLHEX         X'80' FCLHEX Indicates data in
                                        EBCDIC HEX
          .1.. ....      FCLPAGE        X'40' FCLPAGE Indicates if full
                                        page obtained with HCPGETST
                                        (needed to determine which
                                        HCPRELST to use)
002D   45 Bitstring    3 *              RESERVED FOR FUTURE IBM USE
      Reserved for future use
0030   48 Dbl-Word     8 *              RESERVED FOR FUTURE IBM USE
0038   56 Dbl-Word     8 *              RESERVED FOR FUTURE IBM USE
0040   64 Dbl-Word     8 *              RESERVED FOR FUTURE IBM USE
          00000048       FCLBYSZ        *-FCLBK Byte length of FCLBK
          00000009       FCLDWSZ        ((FCLBYSZ+7)/8) Doubleword length
                                        of FCLBK

FCLVPARM DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      FCLVPARM       Variable Parameter Information Block
0000    0 Address      4 FCLVPDA        Data buffer addr
0004    4 Signed       4 FCLVPLEN       Byte length of buffer
0008    8 Signed       4 FCLVPLNU       Byte length of UTF-8 data
000C   12 Bitstring    1 FCLVPFLG       Parameter flags
          1... ....      FCLHEX         X'80' FCLHEX Indicates data in
                                        EBCDIC HEX
          .1.. ....      FCLPAGE        X'40' FCLPAGE Indicates if full
                                        page obtained with HCPGETST
                                        (needed to determine which
                                        HCPRELST to use)
000D   13 Bitstring    3 *              Unused
      Process control flags passed to HCPFCDCU
          1... ....      FCLTBUF        X'80' Ignored if caller provides
                                        output buffer 0=return output buf
                                        addr in R1 1=fret output buf
                                        before return
          .1.. ....      FCLHXFMT       X'40' 0=input string in EBCDIC
                                        CHAR (text) 1=input string in
                                        EBCDIC HEX

FCLBK Storage Layout

          
*** FCLBK - FCP List Directed IPL Block Mapping
*
*     +------+------+-------------+---------------------------+
*   0 |:PFLAG|:IPLOP|   FCLDEV    |          FCLBPS           |
*     +------+------+-------------+---------------------------+
*   8 |         FCLPTNW1          |         FCLPTNW2          |
*     +---------------------------+---------------------------+
*  10 |         FCLLUNW1          |         FCLLUNW2          |
*     +---------------------------+---------------------------+
*  18 |         FCLBRW1           |         FCLBRW2           |
*     +---------------------------+---------------------------+
*  20 |          FCLSCA           |          FCLSCL           |
*     +---------------------------+------+--------------------+
*  28 |          FCLSCU           |:SCFLG|////////////////////|
*     +---------------------------+------+--------------------+
*  30 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  38 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  40 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  48
*
*** FCLBK - FCP List Directed IPL Block Mapping
          
*** FCLVPARM - Variable Parameter Information Block
*
*     +---------------------------+---------------------------+
*   0 |         FCLVPDA           |         FCLVPLEN          |
*     +---------------------------+------+--------------------+
*   8 |         FCLVPLNU          |:VPFLG|////////////////////|
*     +---------------------------+------+--------------------+
*  10
*
*** FCLVPARM - Variable Parameter Information Block

FCLBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
FCLBPS         0004
FCLBPSET       0000 04
FCLBRLBA       0018
FCLBRSET       0000 10
FCLBRW1        0018
FCLBRW2        001C
FCLBYSZ        0040 00000048
FCLDEV         0002
FCLDWSZ        0040 00000009
FCLHEX         002C 80
FCLHEX         000C 80
FCLHXFMT       000D 40
FCLIATTN       0001 10
FCLIDUMP       0001 40
FCLILOAD       0001 80
FCLIPLOP       0001
FCLISTOP       0001 20
FCLLNSET       0000 08
FCLLUN         0010
FCLLUNW1       0010
FCLLUNW2       0014
FCLPAGE        002C 40
FCLPAGE        000C 40
FCLPFLAG       0000
FCLPNSET       0000 80
FCLPTNM        0008
FCLPTNW1       0008
FCLPTNW2       000C
FCLSC          0020
FCLSCA         0020
FCLSCFLG       002C
FCLSCL         0024
FCLSCMXL       001C 00000AAC
FCLSCMXU       001C 00000AAC
FCLSCSET       0000 02
FCLSCU         0028
FCLTBUF        000D 80
FCLVPDA        0000
FCLVPFLG       000C
FCLVPLEN       0004
FCLVPLNU       0008