|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
DDEV
Control Block Contents
DDEV DSECT
Cross Reference (Contains links to field and bit definitions)
DDEV Prolog
NAME : HCPDDEV
DESCRIPTION: DIRECTORY DEVICE DEFINITION BLOCK
DSECT : DDEV
FUNCTION : THE HCPDDEV BLOCK DESCRIBES THE DEVICES ASSOCIATED
WITH A VIRTUAL MACHINE AS SPECIFIED IN THE SYSTEM
DIRECTORY
LOCATED BY : DUNIDDAS FIELD OF HCPDUNDX
DUNIDDSP FIELD OF HCPDUNDX
CREATED BY : HCPDEF, HCPUDR
DELETED BY : HCPDEF, HCPLND, HCPLNK
DDEV Control Block Content
DDEV DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure DDEV DIRECTORY DEVICE DEFINITION BLOCK
DDEV Device Definition (Generic).
0000 0 Signed 2 DDEVDEV VIRTUAL DEVICE ADDRESS
0002 2 Bitstring 1 DDEVFLGA DIRECTORY DEVICE INFORMATION
1... .... DDEVTMDK X'80' MDISK DIRECTORY ENTRY
.1.. .... DDEVTLNK X'40' LINK DIRECTORY ENTRY
..1. .... DDEVTSPC X'20' SPECIAL / NICDEF DIRECTORY
ENTRY
...1 .... DDEVTDED X'10' DEDICATE DIRECTORY ENTRY
.... 1... DDEVTSPL X'08' SPOOL / CONSOLE DIRECTORY
ENTRY
.... .1.. DDEVTDSK X'04' T-DISK TO BE ALLOCATED
.... ..1. DDEVRO X'02' DEVICE IS READ ONLY
.... ...1 DDEVRELR X'01' VIRTUAL RESERVE RELEASE
REQUESTED
0003 3 Bitstring 1 DDEVMODL DIRECTORY DEVICE MODEL
INFORMATION
0004 4 Bitstring 2 DDEVCODE (0) VIRTUAL DEVICE CLASS AND TYPE
0004 4 Bitstring 1 DDEVCLAS VIRTUAL DEVICE CLASS
0005 5 Bitstring 1 DDEVTYPE VIRTUAL DEVICE TYPE
00000006 DDEVHDLN *-DDEV DDEV common header length
(bytes)
0006 6 Character 50 DDEVSPEC Device-Specific overlays
DDEVSPEC for MDISK device.
All releases of CP prior to ESA 2.0 use DDEVSCYL and DDEVECYL for
minidisk extents. In ESA 2.0, DDEVSEXT and DDEVEEXT were defined for
minidisk extents. These new fields were added for FBA because FBA
minidisk extents are in blocks instead of cylinders and a block number
could be larger than a halfword. But the time will come when CKD dasd
is so large that cylinder extents may grow larger than a halfword.
Starting with ESA 2.0, DDEVSEXT and DDEVEEXT should always be used for
both CKD and FBA minidisk extents. ESA 2.0 must still be able to
process directories created with previous supported releases of
DIRECTXA. Because of this, directory processing modules must consider
the possibility that the new fullword fields may not contain the
minidisk extents. If the DDEVFWEX flag in DDEVFLGC is not on, then the
old halfword fields will contain the minidisk extents. In this case,
when HCPUDR gets a copy of the DDEV it will copy the contents of
DDEVSCYL/DDEVECYL into DDEVSEXT/DDEVEEXT. So, starting with ESA 2.0,
the rest of CP only needs to use the newly defined fullword fields.
Directories created with ESA 2.0 (and later releases of CP) must be in
a format that is compatible with all previous supported releases of CP.
For this reason, CKD minidisk extents are still stored in the old
halfword fields as well as the new fullword fields. When ESA 2.0
becomes the oldest supported release, DDEVSCYL and DDEVECYL will no
longer need to be maintained.
0006 6 Bitstring 4 DDEVEXTN (0) CKD virtual dasd cylinder extents
0006 6 Signed 2 DDEVSCYL CKD virtual dasd start cylinder
0008 8 Signed 2 DDEVECYL CKD virtual dasd end cylinder
000A 10 Character 6 DDEVVSER VOLUME SERIAL NUMBER
0010 16 Bitstring 1 DDEVALNK TYPES OF LINKS ALLOW TO THIS DEV
1... .... DDEVLR X'80' READ LINKS ALLOWED
.1.. .... DDEVLW X'40' WRITE LINKS ALLOWED
..1. .... DDEVLM X'20' MULT-WRITE LINKS ALLOWED
0011 17 Bitstring 1 DDEVMODE ACCESS MODE Decimal byte values
0-11 are read modes; 12-63 are
write. For more understanding of
how link access modes are used,
see how DDEVMODE and LKX*MOD* are
used in module HCPLNS.
1... .... DDEVE X'80' Exclusive link bit
.1.. .... DDEVS X'40' Stable link bit
.... ...1 DDEVD X'01' Deferred link
00000000 DDEVR 00 'R' LINK-MODE FOR OWNER
00000004 DDEVRR 04 'RR' LINK-MODE FOR OWNER
0000000C DDEVW 12 'W' LINK-MODE FOR OWNER
00000010 DDEVWR 16 'WR' LINK-MODE FOR OWNER
0000001C DDEVM 28 'M' LINK-MODE FOR OWNER
00000020 DDEVMR 32 'MR' LINK-MODE FOR OWNER
00000024 DDEVMW 36 'MW' LINK-MODE FOR OWNER
00000040 DDEVSR 64 DDEVS+DDEVR ('R' with stable)
0000004C DDEVSW 76 DDEVS+DDEVW ('W' with stable)
0000005C DDEVSM 92 DDEVS+DDEVM ('M' with stable)
00000080 DDEVER 128 DDEVE+DDEVR ('R' with
exclusive)
0000008C DDEVEW 140 DDEVE+DDEVW ('W' with
exclusive)
For object directories created from VM/ESA 2.0 and later... If the
minidisk is defined on CKD DASD, DDEVSEXT will contain the starting
cylinder number. If the minidisk is defined on FBA DASD, DDEVSEXT will
contain the starting block number. The DDEVFWEX flag in DDEVFLGC will
be on if DDEVSEXT contains valid information. See the comment for
DDEVSCYL/DDEVECYL for more details.
0012 18 Bitstring 4 DDEVSEXT (0) Minidisk start extent
0012 18 Bitstring 2 DDEVSE1H First half of starting extent
0014 20 Bitstring 2 DDEVSE2H Second half of starting extent
0016 22 Bitstring 1 DDEVFLGB ACCESS CONTROL FOR CACHE DASD
1... .... DDEVWKAL X'80' Working allegiance on
minidisk
.1.. .... DDEVCNA X'40' CACHING NOT AVAILABLE
..1. .... DDEVSCTL X'20' SUBSYSTEM CONTROL
...1 .... DDEVDCTL X'10' DEVICE CONTROL
.... 1... DDEVNCTL X'08' NO CONTROL
.... .1.. DDEVNMDC X'04' MINIOPT NOMDC specified
.... ..1. DDEVQDSK X'02' V-disk will be allocated
.... ...1 DDEVYMDC X'01' MINIOPT MDC specified NOTES
: DDEVFLGC is NOT exclusive to
MDISK devices.
0017 23 Bitstring 1 DDEVFLGC EXTENSION OF DIRECTORY DEVICE
INFO
1... .... DDEVNOSG X'80' "NOASSIGN" OPTION
.1.. .... DDEVEND X'40' "END" SPECIFIED ON MDISK
STATEMENT
..1. .... DDEVINV X'20' DDEV IS NOT VALID, IT WAS
ONLY PARTIALLY FILLED IN AND
SHOULD BE IGNORED
...1 .... DDEVFWEX X'10' The fullword extent fields
are valid. DDEVSEXT and DDEVEEXT
contain valid extent information.
.... 1... DDEVDEVN X'08' "DEVNO" SPECIFIED ON MDISK
STMT
.... .1.. DDEVPROF X'04' DDEV was written as part of
a PROFILE
.... ..1. DDEVIOPS X'02' User set I/O Assist off for
device
.... ...1 DDEVFBA X'01' MDISK is on FBA dasd
0018 24 Dbl-Word 8 DDEVPASR PASSWORD FOR READ ACCESS
0020 32 Dbl-Word 8 DDEVPASW PASSWORD FOR WRITE ACCESS
0028 40 Dbl-Word 8 DDEVPASM PASSWORD FOR MULTIPLE ACCESS
0030 48 Signed 2 DDEVRDEV REAL DEVICE NUMBER
NOTES : DDEVFLGD is NOT exclusive to MDISK devices.
0032 50 Bitstring 1 DDEVFLGD Extension of cache and dev info
1... .... DDEVRECC X'80' RECORDMDC specified on
MINIOPT
.1.. .... DDEVMSGP X'40' SPECIAL MSGP Statement
..1. .... DDEVNQAS X'20' NOQIOAssist Option
Specified
0033 51 Bitstring 1 * RESERVED FOR IBM USE
For object directories created from VM/ESA 2.0 and later... If the
minidisk is defined on CKD DASD, DDEVEEXT will contain the ending
cylinder number. If the minidisk is defined on FBA DASD, DDEVEEXT will
contain the ending block number. The DDEVFWEX flag in DDEVFLGC will be
on if DDEVEEXT contains valid information. See the comment for
DDEVSCYL/DDEVECYL for more details.
0034 52 Signed 4 DDEVEEXT (0) Minidisk end extent
0034 52 Signed 2 DDEVEE1H First half of the ending extent
0036 54 Signed 2 DDEVEE2H Second half of the ending extent
DDEVSPEC for LINK or DEDICATED device.
0006 6 Bitstring 16 * Reserved
0016 22 Bitstring 1 * (DDEVFLGB) Flags
0017 23 Bitstring 1 * (DDEVFLGC) Flags
0018 24 Bitstring 2 * Reserved
001A 26 Signed 2 DDEVLINK LINK: Subject disk to be linked
DEDICATE: Real device to attach
001C 28 Bitstring 4 * Reserved
0020 32 Character 8 DDEVLKID LINK: Owner of disk to be linked
0028 40 Bitstring 10 * Reserved
0032 50 Bitstring 1 * (DDEVFLGD) Flags
0033 51 Bitstring 5 * Reserved
DDEVSPEC for SPOOL or CONSOLE device.
0006 6 Bitstring 12 * Reserved
0012 18 Bitstring 1 DDEVWIDH 3800: Paper Width Code
0013 19 Bitstring 1 DDEVLENH 3800: Paper Length (HALF-INCHES)
NOTES : DDEVPRFG is NOT exclusive to SPOOL devices.
0014 20 Bitstring 1 DDEVPRFG Virtual printer flags
1... .... DDEVBTS X'80' BURSTER TRIMMER STACKER
(BTS)
.1.. .... DDEVFULL X'40' REFLECT ALL DATA CHECKS
(DATCK)
.... .1.. DDEVSNGL X'04' "SINGLEuser" Attach cmd
option
.... ..1. DDEVSHRD X'02' "MULTIuser" Attach cmd
option
.... ...1 DDEVNOMS X'01' "NOCPMS" Attach command
option
0015 21 Bitstring 1 DDEVFTRC DEVICE FEATURE CODES
1... .... DDEV4WCG X'80' 3800 HAS 4 WCGM'S (OFF =
2WCGM)
0016 22 Bitstring 1 * (DDEVFLGB) Flags
0017 23 Bitstring 1 * (DDEVFLGC) Flags
0018 24 Character 1 DDEVSPCL SPOOL DEVICE OUTPUT CLASS
0019 25 Bitstring 1 DDEVGROP CONSOLE DEFINITION FLAGS
1... .... DDEVGRCN X'80' GRAPHICS CONSOLE
001A 26 Bitstring 24 * Reserved
0032 50 Bitstring 1 * (DDEVFLGD) Flags
0033 51 Bitstring 5 * Reserved
DDEVSPEC for SPECIAL device.
A SPECIAL device (DDEVFLGA.DDEVTSPC) may be defined by a SPECIAL
statement or a NICDEF statement.
DDEVSPEC for CTCA and MSGP definitions.
0006 6 Bitstring 1 DDEVSPCF SPECIAL device flags
1... .... DDEVNICD X'80' SPECIAL via NICDEF
statement
0007 7 Bitstring 15 * Reserved
0016 22 Bitstring 1 * (DDEVFLGB) Flags
0017 23 Bitstring 1 * (DDEVFLGC) Flags
0018 24 Dbl-Word 8 DDEVCTUS ALLOWED USERID TO COUPLE TO CTCA
(OR BLANKS IF NO USERID SUPPLIED,
INDICATING ANY USERID ALLOWED TO
TO COUPLE TO THIS CTCA)
0020 32 Character 4 DDEVCTCD CTCA Descriptor (see VDEVCTCD)
0024 36 Bitstring 2 DDEVMPBS MSGP buffer sets
0026 38 Bitstring 12 * Reserved
0032 50 Bitstring 1 * (DDEVFLGD) Flags
0033 51 Bitstring 5 * Reserved
DDEVSPEC for NIC definitions.
0006 6 Bitstring 1 * (DDEVSPCF) SPECIAL device flags
0007 7 Bitstring 1 DDEVNIC_ATTR NIC Attributes
1... .... DDEVNIC_CHPID_SET
X'80' - DDEVNIC_CHPID is set
.1.. .... DDEVNIC_MAC_SET
X'40' - DDEVNIC_MACID is set
..1. .... DDEVNIC_LAN_SET
X'20' - DDEVNCLO||DDEVNCLN is set
0008 8 Bitstring 1 DDEVNIC_CHPID Preferred CHPID Number
0009 9 Bitstring 10 * Reserved
0013 19 Bitstring 3 DDEVNIC_MACID Preferred MAC Sequence Number
0016 22 Bitstring 1 * (DDEVFLGB) Flags
0017 23 Bitstring 1 * (DDEVFLGC) Flags
0018 24 Character 8 DDEVNCLO LAN Owner for default connection
(or blanks if no LAN is specified
in the directory).
0020 32 Character 8 DDEVNCLN LAN Name for default connection
(or blanks if no LAN is specified
in the directory).
0028 40 Character 4 DDEVNCID Network Card ID (HIPE/QDIO)
002C 44 Signed 2 DDEVNCNN Number of devices for this NIC
002E 46 Bitstring 4 * Reserved
0032 50 Bitstring 1 * (DDEVFLGD) Flags
0033 51 Bitstring 5 * Reserved
DDEVSPEC (END).
00000007 DDEVSIZE (*-DDEV+7)/8 DDEV size in
doublewords
DDEVBLOK EXTENSION FOR DIRECTORY RECORD ON DASD
NOTES : This DDEV extension is NOT utilized during LINK processing. As
a result, all LINK related fields must be defined above (in the
DDEVSPEC region).
0038 56 Signed 4 DDEVDASD (0) SLOT ADDR OF NEXT USER RECORD
CCPV for CKD DASD addresses PPPV
for FBA DASD addresses
0038 56 Bitstring 3 DDEVPAGE Page portion of DDEVDASD field
CCP for CKD DASD addresses PPP
for FBA DASD addresses
003B 59 Bitstring 1 DDEVSYSV Volume portion of DDEVDASD field
V (Volume number in SYSVOL) for
CKD or FBA DASD addresses
003C 60 Signed 2 DDEVDISP DISP OF NEXT RECORD INTO PAGE
003E 62 Signed 2 * RESERVED FOR FUTURE IBM USE
0040 64 Signed 4 * RESERVED FOR FUTURE IBM USE
0044 68 Character 4 DDEVLABL LABEL TO VALIDATE THIS BLOCK
0048 72 Character 8 DDEVUSER USER id to validate this block;
will contain owning USER unless
DDEVPROF is true, in which case
it will contain SYSTEM.
0000000A DDEVESIZ (*-DDEV+7)/8 Extended DDEV size
in doublewords
00000050 DDEVESZB *-DDEV Extended DDEV size in
bytes
DDEV Storage Layout
*** DDEV - DIRECTORY DEVICE DEFINITION BLOCK
*
* +-------------+------+------+------+------+-------------+
* 0 | DDEVDEV |:VFLGA|:VMODL|:VCLAS|:VTYPE| |
* +-------------+------+------+------+------+ |
* 8 | |
* = DDEVSPEC =
* | |
* +--------------------+------+-------------+-------------+
* 38 | DDEVPAGE |:VSYSV| DDEVDISP |/////////////|
* +--------------------+------+-------------+-------------+
* 40 |///////////////////////////| DDEVLABL |
* +---------------------------+---------------------------+
* 48 | DDEVUSER |
* +-------------------------------------------------------+
* 50
*
*** DDEV - DIRECTORY DEVICE DEFINITION BLOCK
*** Overlay for DDEVSPEC in DDEV
*
* +-------------+
* 0 ... 6 | DDEVSCYL |
* +-------------+---------------------------+-------------+
* 8 | DDEVECYL | DDEVVSER |
* +------+------+-------------+-------------+------+------+
* 10 |:VALNK|:VMODE| DDEVSE1H | DDEVSE2H |:VFLGB|:VFLGC|
* +------+------+-------------+-------------+------+------+
* 18 | DDEVPASR |
* +-------------------------------------------------------+
* 20 | DDEVPASW |
* +-------------------------------------------------------+
* 28 | DDEVPASM |
* +-------------+------+------+-------------+-------------+
* 30 | DDEVRDEV |:VFLGD|//////| DDEVEE1H | DDEVEE2H |
* +-------------+------+------+-------------+-------------+
* 38
*
*** Overlay for DDEVSPEC in DDEV
*** Overlay for DDEVSPEC in DDEV
*
* +-------------+
* 0 ... 6 |/////////////|
* +-----------------------------------------+/////////////|
* |///////////////////////////////////////////////////////|
* |/////////////////////////////////////////+------+------+
* 10 |/////////////////////////////////////////|//////|//////|
* +-------------+-------------+-------------+------+------+
* 18 |/////////////| DDEVLINK |///////////////////////////|
* +-------------+-------------+---------------------------+
* 20 | DDEVLKID |
* +-------------------------------------------------------+
* 28 |///////////////////////////////////////////////////////|
* |/////////////+------+----------------------------------+
* 30 |/////////////|//////|//////////////////////////////////|
* +-------------+------+----------------------------------+
* 38
*
*** Overlay for DDEVSPEC in DDEV
*** Overlay for DDEVSPEC in DDEV
*
* +-------------+
* 0 ... 6 |/////////////|
* +-----------------------------------------+/////////////|
* |///////////////////////////////////////////////////////|
* |/////////////+------+------+------+------+------+------+
* 10 |/////////////|:VWIDH|:VLENH|:VPRFG|:VFTRC|//////|//////|
* +------+------+------+------+------+------+------+------+
* 18 |:VSPCL|:VGROP|/////////////////////////////////////////|
* +------+------+/////////////////////////////////////////|
* 20 |///////////////////////////////////////////////////////|
* =///////////////////////////////////////////////////////=
* |/////////////+------+----------------------------------+
* 30 |/////////////|//////|//////////////////////////////////|
* +-------------+------+----------------------------------+
* 38
*
*** Overlay for DDEVSPEC in DDEV
*** Overlay for DDEVSPEC in DDEV
*
* +------+------+
* 0 ... 6 |:VSPCF|//////|
* +-----------------------------------------+------+//////|
* |///////////////////////////////////////////////////////|
* |/////////////////////////////////////////+------+------+
* 10 |/////////////////////////////////////////|//////|//////|
* +-----------------------------------------+------+------+
* 18 | DDEVCTUS |
* +---------------------------+-------------+-------------+
* 20 | DDEVCTCD | DDEVMPBS |/////////////|
* +---------------------------+-------------+/////////////|
* |///////////////////////////////////////////////////////|
* |/////////////+------+----------------------------------+
* 30 |/////////////|//////|//////////////////////////////////|
* +-------------+------+----------------------------------+
* 38
*
*** Overlay for DDEVSPEC in DDEV
*** Overlay for DDEVSPEC in DDEV
*
* +------+------+
* 0 ... 6 |//////|(007) |
* +------+----------------------------------+------+------+
* 8 |(008) |////////////////////////////////////////////////|
* +------+/////////////+--------------------+------+------+
* 10 |////////////////////| DDEVNIC_MACID |//////|//////|
* +--------------------+--------------------+------+------+
* 18 | DDEVNCLO |
* +-------------------------------------------------------+
* 20 | DDEVNCLN |
* +---------------------------+-------------+-------------+
* 28 | DDEVNCID | DDEVNCNN |/////////////|
* +-------------+------+------+-------------+-------------+
* 30 |/////////////|//////|//////////////////////////////////|
* +-------------+------+----------------------------------+
* 38
*
*** Overlay for DDEVSPEC in DDEV
DDEV Cross Reference
Symbol Dspl Value -------------- ---- ----- DDEVALNK 0010 DDEVBTS 0014 80 DDEVCLAS 0004 DDEVCNA 0016 40 DDEVCODE 0004 DDEVCTCD 0020 DDEVCTUS 0018 DDEVD 0011 01 DDEVDASD 0038 DDEVDCTL 0016 10 DDEVDEV 0000 DDEVDEVN 0017 08 DDEVDISP 003C DDEVE 0011 80 DDEVECYL 0008 DDEVEEXT 0034 DDEVEE1H 0034 DDEVEE2H 0036 DDEVEND 0017 40 DDEVER 0011 00000080 DDEVESIZ 0048 0000000A DDEVESZB 0048 00000050 DDEVEW 0011 0000008C DDEVEXTN 0006 DDEVFBA 0017 01 DDEVFLGA 0002 DDEVFLGB 0016 DDEVFLGC 0017 DDEVFLGD 0032 DDEVFTRC 0015 DDEVFULL 0014 40 DDEVFWEX 0017 10 DDEVGRCN 0019 80 DDEVGROP 0019 DDEVHDLN 0005 00000006 DDEVINV 0017 20 DDEVIOPS 0017 02 DDEVLABL 0044 DDEVLENH 0013 DDEVLINK 001A DDEVLKID 0020 DDEVLM 0010 20 DDEVLR 0010 80 DDEVLW 0010 40 DDEVM 0011 0000001C DDEVMODE 0011 DDEVMODL 0003 DDEVMPBS 0024 DDEVMR 0011 00000020 DDEVMSGP 0032 40 DDEVMW 0011 00000024 DDEVNCID 0028 DDEVNCLN 0020 DDEVNCLO 0018 DDEVNCNN 002C DDEVNCTL 0016 08 DDEVNIC_ATTR 0007 DDEVNIC_CHPID 0008 DDEVNIC_CHPID_SET 0007 80 DDEVNIC_LAN_SET 0007 20 DDEVNIC_MAC_SET 0007 40 DDEVNIC_MACID 0013 DDEVNICD 0006 80 DDEVNMDC 0016 04 DDEVNOMS 0014 01 DDEVNOSG 0017 80 DDEVNQAS 0032 20 DDEVPAGE 0038 DDEVPASM 0028 DDEVPASR 0018 DDEVPASW 0020 DDEVPRFG 0014 DDEVPROF 0017 04 DDEVQDSK 0016 02 DDEVR 0011 00000000 DDEVRDEV 0030 DDEVRECC 0032 80 DDEVRELR 0002 01 DDEVRO 0002 02 DDEVRR 0011 00000004 DDEVS 0011 40 DDEVSCTL 0016 20 DDEVSCYL 0006 DDEVSEXT 0012 DDEVSE1H 0012 DDEVSE2H 0014 DDEVSHRD 0014 02 DDEVSIZE 0033 00000007 DDEVSM 0011 0000005C DDEVSNGL 0014 04 DDEVSPCF 0006 DDEVSPCL 0018 DDEVSPEC 0006 DDEVSR 0011 00000040 DDEVSW 0011 0000004C DDEVSYSV 003B DDEVTDED 0002 10 DDEVTDSK 0002 04 DDEVTLNK 0002 40 DDEVTMDK 0002 80 DDEVTSPC 0002 20 DDEVTSPL 0002 08 DDEVTYPE 0005 DDEVUSER 0048 DDEVVSER 000A DDEVW 0011 0000000C DDEVWIDH 0012 DDEVWKAL 0016 80 DDEVWR 0011 00000010 DDEVYMDC 0016 01 DDEV4WCG 0015 80
Copyright IBM Corporation, 1990, 2003