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' 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 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
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 FCSSCDLB 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' 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 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 V6R1.0. Last updated on 18 Feb 2010 at 08:39:51 EDT.
Copyright IBM Corporation, 1990, 2008