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
 RELOCATION CONSIDERATIONS : None

 FCSPL DSECT
Top of page

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' FCLPNSET PORT NAME set
          .1.. ....      FCLBTSET       X'40' FCLBTSET BOOTREC set
          ..1. ....      FCLALSET       X'20' FCLALSET ALTERNATE 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
          .... ...1      FCLSISET       X'01' FCLSISET Secure IPL set
          1.11 1...      FCLSCSIU       FCLPNSET+FCLLNSET+FCLBRSET+FCLALS
                                        ET FCLSCSIU SCSI unique operands
          .1.. ....      FCLECKDU       FCLBTSET FCLECKDU ECKD unique
                                        operands
0001    1 Bitstring    1 FCSFLAGO       Other Flags unique to FCSPL
          1... ....      FCSPN2SO       X'80' FCSPN2SO Indicates PORTNAME
                                        WORD 2 set
          .1.. ....      FCSLN2SO       X'40' FCSLN2SO Indicates LUN WORD
                                        2 set
          ..1. ....      FCSBR2SO       X'20' FCSBR2SO Indicates BR_LBA
                                        WORD 2 set
          ...1 ....      FCSCLRSO       X'10' FCSCLRSO Indicates CLEAR
                                        set
          .... 1...      FCSDUMP        X'08' FCSDUMP Indicates DUMP cmd
                                        if set else LOAD cmd if not set
          .... .1..      FCSSCISO       X'04' FCSSCISO Indicates Secure
                                        IPL requested
          .... ..1.      FCSSCINO       X'02' FCSSCINO Indicates NOSECURE
                                        IPL requested
          .... ...1      FCSAP2SO       X'01' FCSAP2SO Indicates
                                        ALTERNATE PORTNAME WORD 2 set
0002    2 Bitstring    1 FCSFLAG2       2nd byte of parm "set" flags
          1... ....      FCLSCSI        X'80' FCLSCSI SCSI device
                                        operands set
          .1.. ....      FCLECKD        X'40' FCLECKD ECKD device
                                        operands set
          ..1. ....      FCLDVSET       X'20' FCLDVSET Device number has
                                        been set
          ...1 ....      FCLBTRLB       X'10' FCLBTRLB BOOTREC=LABEL was
                                        specified
          .... 1...      FCLBPAUT       X'08' FCLBPAUT BOOTPROG set to
                                        AUTOmatic
          .... .1..      FCLNSIST       X'04' FCLNSIST NOSECURE was
                                        specified
0003    3 Bitstring    1 *              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
0020   32 Address      1 FCSALTCT       Alternate device count
0021   33 Bitstring    1 *              Unused
0022   34 Bitstring    1 FCSALTPD (0)   Alternate path data
0022   34 Bitstring    2 FCSALTDV       Alternate device
0024   36 Bitstring    8 FCSALTPT (0)   Alternate port
0024   36 Bitstring    4 FCSALTP1       Word 1
0028   40 Bitstring    4 FCSALTP2       Word 2
002C   44 Signed       4 *              Reserved for future use
      SCPDATA - Notes      : this section is mapped to VPARM DSECT
0030   48 Signed       2 FCSSC (0)
0030   48 Address      4 FCSSCPMA       Address of parameter name
0034   52 Signed       4 FCSSCDLN       Input data length
          ..11 .111      FCSSCDLB       FCSSCDLN+3 FCSSCDLB Input data
                                        length byte
0038   56 Character  128 FCSSCDAT       Input data buffer
00B8  184 Bitstring    1 FCSSCFG        Option flags (see VPFLAG bits)
00B9  185 Bitstring    1 FCSSCFGI       Input Option flags(see VPFLAGI
                                        bits)
00BA  186 Bitstring    2 *              Unused
00BC  188 Signed       4 FCSSCOFF       Offset
00C0  192 Address      4 FCSSCTPA       Temp buf addr (allocated during
                                        input processing)
00C4  196 Signed       4 FCSSCTPL       Length of temp buffer
00C8  200 Signed       4 FCSSCTPU       Length of UTF-8 data
00CC  204 Signed       4 FCSBTCYL       Boot Record cylinder
00D0  208 Bitstring    1 FCSBTHD        Boot Record head
00D1  209 Bitstring    1 FCSBTREC       Boot Record record
00D2  210 Signed       2 FCSVDEV        IPL device number
          000000D4       FCSBYSZ        *-FCSPL Byte length of FCSPL
          0000001B       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
Top of page

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' 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)
0089  137 Bitstring    1 VPFLAGI        Input option flags
          1... ....      VPFLGNEW       X'80' VPFLGNEW Indicates NEW
                                        specified
          .1.. ....      VPFLGOFF       X'40' VPFLGOFF 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 - FCP List Directed IPL Parameter List
*
*     +------+------+------+------+---------------------------+
*   0 |:FLAG |:FLAGO|:FLAG2|//////|          FCSBPS           |
*     +------+------+------+------+---------------------------+
*   8 |         FCSPNW1           |         FCSPNW2           |
*     +---------------------------+---------------------------+
*  10 |         FCSLUNW1          |         FCSLUNW2          |
*     +---------------------------+---------------------------+
*  18 |         FCSBRW1           |         FCSBRW2           |
*     +------+------+-------------+---------------------------+
*  20 |:ALTCT|//////|  FCSALTDV   |         FCSALTP1          |
*     +------+------+-------------+---------------------------+
*  28 |         FCSALTP2          |///////////////////////////|
*     +---------------------------+---------------------------+
*  30 |         FCSSCPMA          |         FCSSCDLN          |
*     +---------------------------+---------------------------+
*  38 |                                                       |
*     =                       FCSSCDAT                        =
*     |                                                       |
*     +------+------+-------------+---------------------------+
*  B8 |:SCFG |:SCFGI|/////////////|         FCSSCOFF          |
*     +------+------+-------------+---------------------------+
*  C0 |         FCSSCTPA          |         FCSSCTPL          |
*     +---------------------------+---------------------------+
*  C8 |         FCSSCTPU          |         FCSBTCYL          |
*     +------+------+-------------+---------------------------+
*  D0 |:BTHD |:BTREC|  FCSVDEV    | D4
*     +------+------+-------------+
*
*** 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

 
Symbol         Dspl Value
-------------- ---- -----
FCLALSET       0000 20
FCLBPAUT       0002 08
FCLBPSET       0000 04
FCLBRSET       0000 10
FCLBTRLB       0002 10
FCLBTSET       0000 40
FCLDVSET       0002 20
FCLECKD        0002 40
FCLECKDU       0000 40
FCLHEX         0088 80
FCLLNSET       0000 08
FCLNSIST       0002 04
FCLPAGE        0088 40
FCLPNSET       0000 80
FCLQUERY       0098 00000001
FCLSCSET       0000 02
FCLSCSI        0002 80
FCLSCSIU       0000 B8
FCLSET         0098 00000000
FCLSISET       0000 01
FCSALTCT       0020
FCSALTDV       0022
FCSALTPD       0022
FCSALTPT       0024
FCSALTP1       0024
FCSALTP2       0028
FCSAP2SO       0001 01
FCSBPS         0004
FCSBRLBA       0018
FCSBRW1        0018
FCSBRW2        001C
FCSBR2SO       0001 20
FCSBTCYL       00CC
FCSBTHD        00D0
FCSBTREC       00D1
FCSBYSZ        00D2 000000D4
FCSCLRSO       0001 10
FCSDUMP        0001 08
FCSDWSZ        00D2 0000001B
FCSFLAG        0000
FCSFLAGO       0001
FCSFLAG2       0002
FCSLN2SO       0001 40
FCSLUN         0010
FCSLUNW1       0010
FCSLUNW2       0014
FCSPN          0008
FCSPNW1        0008
FCSPNW2        000C
FCSPN2SO       0001 80
FCSSC          0030
FCSSCDAT       0038
FCSSCDLB       0034 37
FCSSCDLN       0034
FCSSCFG        00B8
FCSSCFGI       00B9
FCSSCINO       0001 02
FCSSCISO       0001 04
FCSSCOFF       00BC
FCSSCPMA       0030
FCSSCTPA       00C0
FCSSCTPL       00C4
FCSSCTPU       00C8
FCSVDEV        00D2
VPDATA         0008
VPFLAG         0088
VPFLAGI        0089
VPFLGNEW       0089 80
VPFLGOFF       0089 40
VPLEN          0004
VPOFF          008C
VPPNMA         0000
VPTEMPA        0090
VPTEMPL        0094
VPTEMPLU       0098