Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### 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

#### 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

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

    Copyright IBM Corporation, 1990, 2008