| |
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure XDIBK XDISK services messaging content
0000 0 Signed 4 XDIPAYLD (0) The XDISERVC field in the request
indicates which type of request
this XDIBK represents. The
receive task (HCPXDLRC) stacks a
call to the reply function
(HCPXDLRP) who uses XDISERVC to
determine where to route the
request.
0000 0 Bitstring 1 XDISERVC XDISK service
.... .... XDILINKQ 0 XDILINKQ Link information
request
.... .1.. XDIWTLNG 4 XDIWTLNG Notify write link
granted
.... 1... XDIQLINK 8 XDIQLINK QUERY LINKS request
.... 11.. XDISPOOL 12 XDISPOOL Spool volume checking
...1 .... XDIWTLND 16 XDIWTLND Notify write link
detached
...1 .1.. XDIMDAVA 20 XDIMDAVA MDISK availability
request
...1 1... XDILINKV 24 XDILINKV Get write link info
...1 11.. XDIATTCH 28 XDIATTCH ATTACH SPOL request
..1. .... XDILKACQ 32 XDILKACQ Acquire Lock request
..1. .1.. XDILKREL 36 XDILKREL Release Lock request
..1. 1... XDIRPGID 40 XDIRPGID Get PGID of reserve
holder
..1. 11.. XDIRSVCK 44 XDIRSVCK Check DASD reserve
state
..11 .... XDISHVCK 48 XDISHVCK Check shared volume
attach
..11 .1.. XDISPDET 52 XDISPDET Detach spool volume
..11 1... XDISRLAB 56 XDISRLAB Read volume label
XDIFLAG is used to store information regarding the type of
request or the reply being sent.
0001 1 Bitstring 1 XDIFLAG Flags
1... .... XDILKYES X'80' XDILKYES Request approved
.1.. .... XDILKIGN X'40' XDILKIGN Request ignored
..1. .... XDILKNO X'20' XDILKNO Request denied
...1 .... XDILKCOM X'10' XDILKCOM Release with
COMMIT
.... 1... XDILKABT X'08' XDILKABT Release with ABORT
.... .1.. XDILKSAF X'04' XDILKSAF Received while in
SAFE mode
XDIPARM can be used as a parameter area that may differ
between different request/reply types
0002 2 Bitstring 1 XDIPARM Parameter Field *** For Lock
requests, this represents the
piggyback type
00000000 XDITLOCK 0 Basic Lock Type
XDIPARM2 can be used as a 2nd parameter area that may
differ between different request/reply types
0003 3 Bitstring 1 XDIPARM2 Parameter Field 2 *** For LOCK
requests, this contains the Lock
Type (XLKTYPE)
0004 4 Bitstring 1 * Reserved for IBM use
0005 5 Bitstring 1 XDISEQN Sequence Number of Request
0006 6 Signed 2 XDISYSTM Sender's slot number
0008 8 Signed 4 XDIUNQ Copy of XLKUNQ
000C 12 Signed 4 XDIMSG (0)
0000000C XDIHDRLN (*-XDIBK) For dynamic-sized
payloads, use this length to
allocate a single payload header
STATIC SIZED PAYLOADS (1 PER XDIBK)
Length of entire XDIBK can be determined
Many requests just pass the DUID and start and end extents as
input. They can all use XDIMDMSG as their request input with
the appropriate value in XDISERVC.
000C 12 Signed 4 XDIMDMSG (0) Minidisk messages
000C 12 Bitstring 40 XDIDUID Device EQid/DUID
0034 52 Bitstring 1 XDIDUIDL Length of EQid/DUID
0035 53 Bitstring 1 XDIGFLAG Used by requests for anything
0036 54 Bitstring 1 * (2) Reserved for future IBM use
0038 56 Signed 4 XDIMSEXT MDISK starting extent
003C 60 Signed 4 XDIMEEXT MDISK ending extent
0040 64 Signed 4 XDIMDEND (0) End of generic mdisk request
00000040 XDIMDSIZ (*-XDIBK) Size of minidisk
request in bytes
Link request (XDILINKQ)
0040 64 Character 8 XDIOWNRU Owner userid
0048 72 Signed 2 XDIOWNRV Owner VDEV
004A 74 Bitstring 6 * Reserved for future IBM use
00000050 XDILNKRQ (*-XDIBK) Size of link request in
bytes
Reply to link request (XDILINKQ)
000C 12 Signed 4 XDIRDCNT Minidisk read link count
XDIRUSER/XDIRMEMB, XDIWUSER/XDIWMEMB, XDISUSER/XDISMEMB
and XDIEUSER/XDIEMEMB are all filled in for the case where
we issue messages such as HCP101E through HCP106E which
output more than one user in the message.
0010 16 Character 8 XDIRUSER Userid of read link
0018 24 Character 8 XDIRMEMB Member name for read link
0020 32 Signed 4 XDIWTCNT Minidisk write link count
0024 36 Character 8 XDIWUSER Userid of write link
002C 44 Character 8 XDIWMEMB Member name for write link
0034 52 Signed 4 XDISTCNT Minidisk stable link count
0038 56 Character 8 XDISUSER Userid of stable link
0040 64 Character 8 XDISMEMB Member name for stable link
0048 72 Character 8 XDIEUSER Userid of exclusive link
0050 80 Character 8 XDIEMEMB Member name for excl link
XDIVUSER/XDIVMEMB and XDIKUSER/XDIKMEMB are always filled
in. When the replying system has a V suffix or WRKALLEG
link, we will use these fields in message HCP6640E formats
-04 and -06. When we are requesting a V suffix or WRKALLEG
link and any link exists in the SSI, we will use these
fields in message HCP6640E formats -03 and -05.
0058 88 Character 8 XDIVUSER Userid of V mode suffix link
0060 96 Character 8 XDIVMEMB Member name for V suffix link
0068 104 Character 8 XDIKUSER Userid of WRKALLEG link
0070 112 Character 8 XDIKMEMB Member name for WRKALLEG link
XDIDUSER and XDIDMEMB are always filled in for potential
use in messages 6640-10 and 6640-11.
0078 120 Character 8 XDIDUSER Userid of MDISK DEVNO
0080 128 Character 8 XDIDMEMB Member name for MDISK DEVNO
0088 136 Bitstring 1 XDIMFLAG Minidisk flag
1... .... XDIWRTLN X'80' XDIWRTLN Write link found
but not used for link conflict
.1.. .... XDIEXCLU X'40' XDIEXCLU Exclusive link
held on minidisk
..1. .... XDIRDADJ X'20' XDIRDADJ Read link user is
adjunct
...1 .... XDIOTADJ X'10' XDIOTADJ Other link user is
adjunct
.... 1... XDILINKS X'08' XDILINKS Link exists in
VMplex
.... .1.. XDIRDFPO X'04' XDIRDFPO RDEV has existing
fullpack overlay
.... ..1. XDIDEVNO X'02' XDIDEVNO MDISK DEVNO
defined
0089 137 Bitstring 1 XDIVFLAG "v" suffx and WRKALLEG flag
1... .... XDIFPV X'80' XDIFPV Fullpack link with
"v"
.1.. .... XDIFPNV X'40' XDIFPNV Fullpack link no
"v"
..1. .... XDINFPV X'20' XDINFPV Non-fullpack link
with "v"
...1 .... XDINFPNV X'10' XDINFPNV Non-fullpack no
"v"
.... 1... XDIFPW X'08' XDIFPW Fullpack link with
WRKALLEG
.... .1.. XDIFPNW X'04' XDIFPNW Fullpack link no
WRKALLEG
.... ..1. XDINFPW X'02' XDINFPW Non-fullpack link
w/WRKALLEG
.... ...1 XDINFPNW X'01' XDINFPNW Non-fullpack link
no WRKALLEG
0000008A XDILNKRS (*-XDIBK) Size of link reply in
bytes
Reply to QUERY LINKS request (XDIQLINK)
000C 12 Signed 4 XDINUMLK Number of link pages which follow
0010 16 Bitstring 1 XDIQLFLG QUERY LINKS response flag
1... .... XDIQLTRN X'80' XDIQLTRN Response data
truncated
0011 17 Bitstring 1 * (3) Reserved for future IBM use
00000014 XDIQLSIZ (*-XDIBK) Size of QUERY LINKS
request with no data
Request to get virtual PGID of guest holding reserve
(XDIRPGID)
000C 12 Bitstring 40 XDIPDUID Device EQid/DUID
0034 52 Bitstring 1 XDIPDUIL Length of EQid/DUID
0035 53 Bitstring 1 * (3) reserved
0038 56 Character 8 * Reserved
00000040 XDIPQSIZ (*-XDIBK) Size of PGID request
Reply for PGID request
000C 12 Character 11 XDIGPGID Guest virtual PGID
0017 23 Bitstring 1 XDIPFLAG Flag
1... .... XDIRESVH X'80' XDIRESVH Reserve held by
system
00000018 XDIPRSIZ (*-XDIBK) Size of PGID reply
Request to get DASD reserve state following relocation of
a reserved dasd when running second level on z/VM 5.4 or
older.
(XDIRSVCK)
000C 12 Character 8 XDIZUSER Userid of guest
0014 20 Bitstring 2 XDIZVDEV Virtual device number
0016 22 Bitstring 1 * (6) Reserved
0000001C XDIZQSIZ (*-XDIBK) Size of reserve check
request
Reply for PGID request
000C 12 Bitstring 1 XDIZFLAG Flag
1... .... XDIZESVH X'80' XDIZESVH Reserve held by
user
000D 13 Bitstring 1 * (7) Reserved
00000014 XDIZRSIZ (*-XDIBK) Size of RSVCK reply
Request to ATTACH w/SPOL extents (XDIATTCH)
000C 12 Bitstring 1 XDIAFLAG ATTACH request flag
1... .... XDIATTCK X'80' XDIATTCK Perform ATTACH
checking
.1.. .... XDIATTPF X'40' XDIATTPF Perform ATTACH
..1. .... XDIDFCPO X'20' XDIDFCPO Perform DEF
CPOWNED
000D 13 Bitstring 40 XDIADUID Device EQid/DUID
0035 53 Character 6 XDIATVLS Volume serial identifier
003B 59 Bitstring 1 XDIADUIL Length of EQid/DUID
003C 60 Bitstring 1 XDIATCPV CPVCODE - index into CPVOL list
003D 61 Bitstring 1 * (3) Reserved for future use
00000040 XDITQSIZ (*-XDIBK) Size of ATTACH request
bytes
Reply for ATTACH w/SPOL extents
000C 12 Character 6 XDIATVSR Volume serial identifier
0012 18 Bitstring 1 XDIATFLG Flag
1... .... XDIAUNDF X'80' XDIAUNDF Slot undefined
.1.. .... XDIASLTM X'40' XDIASLTM Slot mismatch
..1. .... XDIATSPL X'20' XDIATSPL Already attached
w/SPOL
...1 .... XDIATNSP X'10' XDIATNSP Already attached
no SPOL
.... 1... XDIAOFFL X'08' XDIAOFFL Device offline
.... .1.. XDINOSLT X'04' XDINOSLT Slot does not
exist
00000013 XDITRSIZ (*-XDIBK) Size of ATTACH reply
bytes
Reply for write link information
000C 12 Bitstring 1 XDIWFLAG
1... .... XDIWTLNK X'80' XDIWTLNK Write link exists
.1.. .... XDISLNKS X'40' XDISLNKS Link exists in SSI
..1. .... XDISAFEM X'20' XDISAFEM SSI in safe mode
...1 .... XDIRELOC X'10' XDIRELOC MDISK has
relocation
000D 13 Bitstring 1 XDIWVFLG "v" suffx and WRKALLEG flag
1... .... XDIFPV X'80' XDIFPV Fullpack link with
"v"
.1.. .... XDIFPNV X'40' XDIFPNV Fullpack link no
"v"
..1. .... XDINFPV X'20' XDINFPV Non-fullpack link
with "v"
...1 .... XDINFPNV X'10' XDINFPNV Non-fullpack no
"v"
.... 1... XDIFPW X'08' XDIFPW Fullpack link with
WRKALLEG
.... .1.. XDIFPNW X'04' XDIFPNW Fullpack link no
WRKALLEG
.... ..1. XDINFPW X'02' XDINFPW Non-fullpack link
w/WRKALLEG
.... ...1 XDINFPNW X'01' XDINFPNW Non-fullpack link
no WRKALLEG
000E 14 Bitstring 1 * (2) Reserved for future IBM use
00000010 XDIWLKSZ (*-XDIBK) Size of link reply in
bytes
Request to read volume label
000C 12 Bitstring 40 XDIRLDUI Device EQid/DUID
0034 52 Bitstring 1 XDIRLDUL Length of EQid/DUID
0035 53 Character 6 XDIRLVOL Volume serial identifier
003B 59 Bitstring 1 * Reserved for suture IBM use
0000003C XDIRLSIZ (*-XDIBK) Size of read lable
request
DYNAMIC SIZED PAYLOADS
N instances of XDIMSG
Length of XDIBK cannot be determined statically
Length of XDIBK = XDIHDRLN + (N * YOUR_XDIMSG_LEN)
000C 12 Bitstring 40 XDIRDMDU Device EQid/DUID
0034 52 Bitstring 1 XDIRDMLN Length of EQid/DUID
00000029 XDIRDVMS (*-XDIMSG) Size of an RDEV
Mapping slot
Request to validate spool information (XDISPOOL)
000C 12 Bitstring 1 XDISQVOL # spool volume entries
000D 13 Bitstring 1 * (3) Reserved for future use
00000010 XDISVQSZ (*-XDIBK) Size of spool
validation request with no
entries
0010 16 Bitstring 44 XDISPREQ (0)
0010 16 Bitstring 40 XDISDUID Device EQid/DUID
0038 56 Bitstring 1 XDISDUIL Length of EQid/DUID
0039 57 Bitstring 1 XDICPVCD CPVCODE - index into CPVOL list
003A 58 Bitstring 1 * Reserved for future use
00000006 XDISQSZD (*-XDISPREQ+7)/8 Size of spool
entry in DWs
0000002B XDISQSIZ (*-XDISPREQ) Size of a spool
request entry
Reply for spool validation
000C 12 Signed 2 XDISRVOL # spool volume entries
0000000E XDISVRSZ (*-XDIBK) Size of spool
validation reply with no entries
000E 14 Bitstring 49 XDISPREP (0)
000E 14 Bitstring 40 XDIRDUID Device EQid/DUID
0036 54 Bitstring 1 XDIRDUIL Length of EQid/DUID
0037 55 Character 6 XDIVOLSR Volume serial identifier
003D 61 Bitstring 1 XDISPFLG Flag Values for XDISPFLG
00000000 XDISUNDF 0 Slot undefined
00000004 XDIROFFL 4 RDEV not online
00000008 XDIDSLOT 8 Slot mismatch
0000000C XDIASLOT 12 Additional slot on target
003E 62 Bitstring 1 XDIRPVCD CPVCODE - index into CPVOL list
(add one for slot# in message)
00000007 XDISRSZD (*-XDISPREP+7)/8 Size of spool
entry in DWs
00000031 XDISRSIZ (*-XDISPREP) Size of a spool
reply entry
LOCK REQUEST HEADER - Lock requests have a second header,
which appears after XDIMSG, that contains information used
to map the lock between systems in a VMplex.
000C 12 Bitstring 40 XDIEQID EQID for lock request
0034 52 Bitstring 1 XDIEQIDL Length of EQID
0035 53 Bitstring 3 * Reserved for IBM use
0038 56 Signed 4 XDIRLKMS (0) RDEV Lock message payload
00000038 XDILKHDR (*-XDIBK) Size of the lock
request header
LOCK PIGGYBACK PAYLOADS - For piggyback requests, the
payload appears after the XDILKHDR.
Sample piggyback message payload:
ORG XDIRLKMS Start after XLK header
XDI..... DS F Associated data...
XDI..... DS F for the piggyback...
XDI..... DS F request.
XDI...SZ EQU (*-XDIBK) Size of the request
in bytes
00000012 XDISIZE (*-XDIBK+7)/8 size in double
words
00000090 XDIBSIZE XDISIZE*8 size in bytes
| |