FCSPL - 64-bit CP - V4R4.0

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

#### FCSPL

Prolog

Control Block Contents
FCSPL DSECT
VPARM DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### FCSPL Prolog

     NAME       : HCPFCSPL
     DESCRIPTION: FCP List Directed IPL Parameter List
     DSECT      : FCSPL
     FUNCTION   : Define references for parameter list data
                  returned by the parser after processing the SET
                  and QUERY LOADDEV commands.  This is a
                  temporary storage area that is created and
                  destroyed each time a command is processed.
     LOCATED BY : HCPFCL
     CREATED BY : HCPFCL
     DELETED BY : HCPFCL

#### FCSPL Control Block Content

#### FCSPL DSECT

####

####

####

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      FCSPL          FCP List Directed IPL Parameter
                                            List
    0000    0 Bitstring    1 FCSFLAG        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 FCSFLAGO       Other Flags unique to FCSPL
              1... ....      FCSPN2SO       X'80' Indicates PORTNAME WORD 2
                                            set
              .1.. ....      FCSLN2SO       X'40' Indicates LUN WORD 2 set
              ..1. ....      FCSBR2SO       X'20' Indicates BR_LBA WORD 2 set
              ...1 ....      FCSCLRSO       X'10' Indicates CLEAR set
              .... 1...      FCSDUMP        X'08' Indicates DUMP cmd if set
                                            else LOAD cmd if not set
    0002    2 Bitstring    2 *              Unused
    0004    4 Signed       4 FCSBPS         BOOT PROGRAM SELECTOR
    0008    8 Dbl-Word     8 FCSPN (0)      PORT NAME
    0008    8 Signed       4 FCSPNW1        PORT NAME WORD 1
    000C   12 Signed       4 FCSPNW2        PORT NAME WORD 2
    0010   16 Dbl-Word     8 FCSLUN (0)     LUN
    0010   16 Signed       4 FCSLUNW1       LUN WORD 1
    0014   20 Signed       4 FCSLUNW2       LUN WORD 2
    0018   24 Dbl-Word     8 FCSBRLBA (0)   BR_LBA
    0018   24 Signed       4 FCSBRW1        BR_LBA WORD 1
    001C   28 Signed       4 FCSBRW2        BR_LBA WORD 2
              00000080       FCSINMXB       128 Max bytes per INPUT string
         SCPDATA - Notes : this section is mapped to VPARM DSECT
    0020   32 Signed       2 FCSSC (0)
    0020   32 Address      4 FCSSCPMA       Address of parameter name
    0024   36 Signed       4 FCSSCDLN       Input data length
              ..1. .111      FCSSCDLB       FCSSCDLN+3 Input data length byte
    0028   40 Character  128 FCSSCDAT       Input data buffer
    00A8  168 Bitstring    1 FCSSCFG        Option flags (see VPFLAG bits)
    00A9  169 Bitstring    1 FCSSCFGI       Input Option flags(see VPFLAGI
                                            bits)
    00AA  170 Bitstring    2 *              Unused
    00AC  172 Signed       4 FCSSCOFF       Offset
    00B0  176 Address      4 FCSSCTPA       Temp buf addr (allocated during
                                            input processing)
    00B4  180 Signed       4 FCSSCTPL       Length of temp buffer
    00B8  184 Signed       4 FCSSCTPU       Length of UTF-8 data
              000000BC       FCSBYSZ        *-FCSPL Byte length of FCSPL
              00000018       FCSDWSZ        (*-FCSPL+7)/8 Plist length in
                                            dwords
         DSECT to reference variable length parameter data. Layout must match
         the associated data areas in FCSPL above. Parms that use this DSECT :
         SCPDATA

    VPARM DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      VPARM          FCP List Directed IPL Parameter
                                            List
    0000    0 Address      4 VPPNMA         Address of parameter name
    0004    4 Signed       4 VPLEN          Input data length
    0008    8 Character  128 VPDATA         Input data buffer
    0088  136 Bitstring    1 VPFLAG         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)
    0089  137 Bitstring    1 VPFLAGI        Input option flags
              1... ....      VPFLGNEW       X'80' Indicates NEW specified
              .1.. ....      VPFLGOFF       X'40' Indicates OFF specified
    008A  138 Bitstring    2 *              Unused
    008C  140 Signed       4 VPOFF          Offset
    0090  144 Address      4 VPTEMPA        Temp buffer addr
    0094  148 Signed       4 VPTEMPL        Byte length of temp buffer
    0098  152 Signed       4 VPTEMPLU       Length of UTF-8 data
         HCPFCSPC function flags
              00000000       FCLSET         0
              00000001       FCLQUERY       1

    FCSPL Storage Layout

    *** FCSPL - FCP List Directed IPL Parameter List
    *
    *     +------+------+-------------+---------------------------+
    *   0 |:FLAG |:FLAGO|/////////////|          FCSBPS           |
    *     +------+------+-------------+---------------------------+
    *   8 |         FCSPNW1           |         FCSPNW2           |
    *     +---------------------------+---------------------------+
    *  10 |         FCSLUNW1          |         FCSLUNW2          |
    *     +---------------------------+---------------------------+
    *  18 |         FCSBRW1           |         FCSBRW2           |
    *     +---------------------------+---------------------------+
    *  20 |         FCSSCPMA          |         FCSSCDLN          |
    *     +---------------------------+---------------------------+
    *  28 |                                                       |
    *     =                       FCSSCDAT                        =
    *     |                                                       |
    *     +------+------+-------------+---------------------------+
    *  A8 |:SCFG |:SCFGI|/////////////|         FCSSCOFF          |
    *     +------+------+-------------+---------------------------+
    *  B0 |         FCSSCTPA          |         FCSSCTPL          |
    *     +---------------------------+---------------------------+
    *  B8 |         FCSSCTPU          | BC
    *     +---------------------------+
    *
    *** FCSPL - FCP List Directed IPL Parameter List

    *** VPARM - FCP List Directed IPL Parameter List
    *
    *     +---------------------------+---------------------------+
    *   0 |          VPPNMA           |          VPLEN            |
    *     +---------------------------+---------------------------+
    *   8 |                                                       |
    *     =                        VPDATA                         =
    *     |                                                       |
    *     +------+------+-------------+---------------------------+
    *  88 |VPFLAG|:LAGI |/////////////|          VPOFF            |
    *     +------+------+-------------+---------------------------+
    *  90 |         VPTEMPA           |         VPTEMPL           |
    *     +---------------------------+---------------------------+
    *  98 |         VPTEMPLU          | 9C
    *     +---------------------------+
    *
    *** VPARM - FCP List Directed IPL Parameter List

    FCSPL Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    FCLBPSET       0000 04
    FCLBRSET       0000 10
    FCLHEX         0088 80
    FCLLNSET       0000 08
    FCLPAGE        0088 40
    FCLPNSET       0000 80
    FCLQUERY       0098 00000001
    FCLSCSET       0000 02
    FCLSET         0098 00000000
    FCSBPS         0004
    FCSBRLBA       0018
    FCSBRW1        0018
    FCSBRW2        001C
    FCSBR2SO       0001 20
    FCSBYSZ        00B8 000000BC
    FCSCLRSO       0001 10
    FCSDUMP        0001 08
    FCSDWSZ        00B8 00000018
    FCSFLAG        0000
    FCSFLAGO       0001
    FCSINMXB       001C 00000080
    FCSLN2SO       0001 40
    FCSLUN         0010
    FCSLUNW1       0010
    FCSLUNW2       0014
    FCSPN          0008
    FCSPNW1        0008
    FCSPNW2        000C
    FCSPN2SO       0001 80
    FCSSC          0020
    FCSSCDAT       0028
    FCSSCDLB       0024 27
    FCSSCDLN       0024
    FCSSCFG        00A8
    FCSSCFGI       00A9
    FCSSCOFF       00AC
    FCSSCPMA       0020
    FCSSCTPA       00B0
    FCSSCTPL       00B4
    FCSSCTPU       00B8
    VPDATA         0008
    VPFLAG         0088
    VPFLAGI        0089
    VPFLGNEW       0089 80
    VPFLGOFF       0089 40
    VPLEN          0004
    VPOFF          008C
    VPPNMA         0000
    VPTEMPA        0090
    VPTEMPL        0094
    VPTEMPLU       0098

    This information is
    based on z/VM V4R4.0.
    Last updated on 30 Jul 2003 at 12:44:48 EDT.

    Copyright IBM Corporation, 1990, 2003