FCLBK - 32-bit CP - V4R4.0

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' PORT NAME set
              ...1 ....      FCLBRSET       X'10' BR_LBA set
              .... 1...      FCLLNSET       X'08' LUN set
              .... .1..      FCLBPSET       X'04' BPS set
              .... ..1.      FCLSCSET       X'02' SCPDATA set
    0001    1 Bitstring    1 FCLIPLOP       IPL Options Flag
              1... ....      FCLILOAD       X'80' List-Directed IPL
              .1.. ....      FCLIDUMP       X'40' List-Directed IPL with Dump
              ..1. ....      FCLISTOP       X'20' STOP Option Specified
              ...1 ....      FCLIATTN       X'10' ATTN Option Specified
              .... ...1      FCLDUMP        X'01' DUMPDEV parms (otherwise
                                            LOADDEV)
    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' Indicates data in EBCDIC
                                            HEX
              .1.. ....      FCLPAGE        X'40' 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' Indicates data in EBCDIC
                                            HEX
              .1.. ....      FCLPAGE        X'40' Indicates if full page
                                            obtained with HCPGETST (needed to
                                            determine which HCPRELST to use)
    000D   13 Bitstring    3 *              Unused
         HCPFCLCU process control flags
              1... ....      FCLTBUF        X'80' Ignored if caller provides
                                            output buffer 0=fret output buf
                                            before return 1=return output buf
                                            addr in R1
              .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
    FCLDUMP        0001 01
    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 V4R4.0.
    Last updated on 29 Jul 2003 at 15:34:27 EDT.

    Copyright IBM Corporation, 1990, 2003