|
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure EDEV EMULATION DEVICE BLOCK
0000 0 Bitstring 2 EDEVLEN Total byte length of object
0002 2 Bitstring 1 EDEVTYPE Emulation Type
1... .... EDEVSCFB X'80' EDEVSCFB SCSI with FBA
emulation
.1.. .... EDEVRMFB X'40' EDEVRMFB RAM Disk with FBA
emulation
0003 3 Bitstring 1 EDEVFLAG EDEV flag
1... .... EDEVSRCF X'80' EDEVSRCF SYSRES EDEV built
from config file
.1.. .... EDEVLOAD X'40' EDEVLOAD Device has been
loaded by container
0004 4 Bitstring 4 * Reserved for future IBM use
SUBCHANNEL INFORMATION BLOCK
0008 8 Bitstring 52 EDEVSCHB THE SCHIB, AS ARCHITECTED (mapped
by HCPSCHIB COPY)
003C 60 Bitstring 4 * RESERVED FOR FUTURE USE
OPERATION REQUEST BLOCK
0040 64 Bitstring 32 EDEVORB THE ORB, AS ARCHITECTED (mapped
by HCPORBLK COPY)
INTERRUPT RESPONSE BLOCK
0060 96 Bitstring 96 EDEVIRB THE IRB, AS ARCHITECTED (mapped
by HCPIRBLK COPY)
MEASUREMENT BLOCK
00C0 192 Bitstring 64 EDEVMEAS (0)
00C0 192 Bitstring 32 EDEVMBLK The 32-byte measurement block, as
architected (mapped by HCPSCMBK
COPY)
00C0 192 Bitstring 64 EDEVMBLG The 64-byte measurement block, as
architected (mapped by HCPSCGBK
COPY)
SUBCHANNEL CONTROL BLOCK
THE SUBCHANNEL CONTROL BLOCK USED TO MANAGE THE OPERATION
OF THE EMULATION DEVICE. IN COMBINATION WITH THE SCHIB
AND ORB, THIS STRUCTURE REPRESENTS THE STATE OF THE
EMULATION DEVICE.
TOD clock times are taken at various points of channel
simulation. They are used to compute the channel
measurements at the end of an operation.
0100 256 Dbl-Word 8 EDEVSSTM TOD VALUE WHEN THE START FUNCTION
BEGAN
0108 264 Dbl-Word 8 EDEVSATM TOD VALUE WHEN THE SUBCHANNEL
WENT ACTIVE
0110 272 Dbl-Word 8 EDEVSCTM TOD VALUE WHEN THE START FUNCTION
ENDED.
QDISK BLOCK for managing the emulated FBA device
0118 280 Dbl-Word 8 EDEVQDSK (21) Imbedded QDISK Block (mapped by
HCPQDISK COPY)
Work area for channel simulation
01C0 448 Signed 4 EDEVCBLK Current Block Number
01C4 452 Signed 4 EDEVCOFF Current Offset within curr block
01C8 456 Dbl-Word 8 EDEVDT64 (0) Expected addr of contiguous stor
01C8 456 Signed 4 EDEVDT6H High word of EDEVDT64
01CC 460 Signed 4 EDEVDT6L Low word of EDEVDT64
01D0 464 Signed 4 EDEVXSV1 Extended save area for chan sim
01D4 468 Address 4 EDEVSAV Location to save R13 for singly
linked list of SAVBKs
01D8 472 Signed 4 * (8) Reserved for future use
Common emulation device information
01F8 504 Address 4 EDEVRDEV Pointer to RDEV of real device
01FC 508 Address 4 EDEVDSVA Device Simulation Vector address
0200 512 Address 4 EDEVRAMA HLA(RAM Disk Origin)
0204 516 Address 4 EDEVPADA Full page of zeros used for
padding function.
0208 520 Signed 2 EDEVPBLK Optimum blocking size for
multiple 4K pages for page/spool
writes, in number of pages (e.g,
48K bytes is 12 4K pages, EDVPBLK
should be an even multiple of
decimal 12, x'C')
020A 522 Signed 2 EDEVPLOD Free storage load required to do
paging I/O writes for a paging
block of pages of size EDVPBLK,
in whole pages (rounded up)
020C 524 Signed 2 EDEVQDTH I/O Queue Depth (number of
concurrent I/Os allowed)
020E 526 Bitstring 10 * Reserved for future use
SCSI Stack serialization information
0218 536 Bitstring 1 EDEVSTAT Request status flags
1... .... EDEVABRT X'80' EDEVABRT I/O aborted (end
channel simul.)
.1.. .... EDEVSNS X'40' EDEVSNS Valid sense
information present
..1. .... EDEVURGT X'20' EDEVURGT High priority
processing needed
...1 .... EDEVIOER X'10' EDEVIOER I/O error from
strategy call
.... 1... EDEVACTV X'08' EDEVACTV HCPSZCOP is active
.... ..1. EDEVFFMT X'02' EDEVFFMT Fast Format in
progress
.... ...1 EDEVSIDA X'01' EDEVSIDA IDA support
suppressed
0219 537 Bitstring 1 * Reserved for future IBM use
021A 538 Bitstring 1 EDEVACTL Activity Control (same as
SCHACTL)
021B 539 Bitstring 1 EDEVABND Last ABEND checkpoint code
021C 540 Signed 4 EDEVCPEA HLA(CPEBK) to return control from
SCSI stack via IODONE
0220 544 Signed 4 EDEVSCA Strategy Call Anchor
0224 548 Signed 4 EDEVSCLP Strategy Call Last Req Pointer
0228 552 Signed 4 EDEVRCNT Outstanding Request Block Count
(serialized by CS logic)
022C 556 Signed 4 EDEVBLA Buffered List Anchor (SZREQs)
0230 560 Signed 4 EDEVBLLP Buffered List Last Pointer
0234 564 Signed 4 EDEVSCNL Strategy Call Next to Last Req
0238 568 Dbl-Word 8 EDEVLOCK (3) EDEV lockword
0250 592 Dbl-Word 8 EDEVILCK (3) EDEV Interrupt lockwork
0268 616 Address 4 EDEVIUSR VMDBK address under which the
EDEV Interrupt Lock (EDEVILCK)
was obtained. This field is
serialized by EDEVILCK.
026C 620 Signed 4 EDEVLRCT RCNT of last strategy call (RAS)
The following fields are for Native SCSI Paging support
only. They are not used by FBA Emulation.
0270 624 Signed 4 EDEVNPSR Native Paging Active Single Reads
0274 628 Signed 4 EDEVNPSW Native Paging Active Single
Writes
0278 632 Signed 4 EDEVNPMR Native Paging Active Mult Reads
027C 636 Signed 4 EDEVNPMW Native Paging Active Mult Writes
0280 640 Address 4 EDEVAIO Native Paging Active I/O request
0284 644 Address 4 EDEVDQN Defer Queue NEXT pointer
0288 648 Address 4 EDEVDQL Defer Queue LAST pointer
BUFFER EXTENSION structure for PURGE support
struct buf_ext definition used to PASS purge request
identification information to the SCSI container. The
data from this structure is COPIED by the container. The
structure is not directly used nor modified by the
container.
The address of EDEVBEXT is passed to the container in the
SZRBEXT field of each SZREQ request block in a strategy
call to uniquely identify an I/O request. A purge request
is initiated by passing the same address to HCPSZBPU. This
data is serialized by RDEVAIOR (one active I/O at a time).
It must be initialized prior to initiating each strategy
call.
028C 652 Bitstring 128 EDEVBEXT Start of Buffer Extension
BUFFER EXTENSION structure for Native Paging PURGE support
This buf ext is needed to distinguish paging I/O requests
from normal FBA Emulation requests for purge support.
030C 780 Bitstring 128 EDEVNPBX Start of Native Paging Buf Ext
The address overlap list is used by the channel simulator
to detect chained READ CCWs that use the same data address.
The length of this table should be greater than or equal
to the average number of pages processed per READ request.
Too low a number will cause fragmentation of strategy
calls resulting in performance degradation. The
downside to making it bigger is the overhead of searching
a longer table as new addresses are added.
038C 908 Signed 4 EDEVACNT Number of entries in EDEVALST
0390 912 Bitstring 16 EDEVALST (120) Address overlap list used only by
HCPSZC (mult. DWD pairs=16 bytes)
00000078 EDEVAMAX (*-EDEVALST)/16 Max DWORD pairs
in EDEVALST
Additional Query Edev details information
0B10 2832 Bitstring 1 EDEVPDTY SCSI peripheral device type
0B11 2833 Bitstring 1 EDEVIELN IEEE id length
0B12 2834 Bitstring 1 EDEVIETY IEEE id type
0B13 2835 Bitstring 1 EDEVVNDR Vendor-specific storage byte
0B14 2836 Signed 4 EDEVBKSZ Blocksize of this disk
0B18 2840 Address 4 EDEVIEEE IEEE identifier ADDRESS (ASCII)
0B1C 2844 Bitstring 4 * Keep DWORD boundary
0B20 2848 Bitstring 8 EDEVVID Vendor ID (ASCII)
0B28 2856 Bitstring 16 EDEVPRID Product ID (ASCII)
0B38 2872 Bitstring 4 EDEVREVI Product revision level
0B3C 2876 Bitstring 8 EDEVBLKS Number of blocks in this LUN
0B44 2884 Bitstring 8 EDEVBLKL Number of blocks at load time
0B4C 2892 Signed 4 EDEVFFLG (0) Device dependent flags If FAStT
(EDEVATTR=EDEVFAST):
0B4C 2892 Bitstring 1 EDEVFTF1 cache flag byte 1
.... .1.. EDEVCWOB X'04' EDEVCWOB FAStT-cache
without batteries
.... ..1. EDEVFWT X'02' EDEVFWT FAStT-force write
thru on two minute warning from
ups
.... ...1 EDEVCME X'01' EDEVCME FAStT-cache mirror
enable
0B4D 2893 Bitstring 1 EDEVFTF2 cache flag byte 2
1... .... EDEVABPR X'80' EDEVABPR FAStT-alt ctrl
batteries present
.1.. .... EDEVBPR X'40' EDEVBPR FAStT-batteries
present
..1. .... EDEVACMA X'20' EDEVACMA FAStT-alt ctrl
cache mirror active
...1 .... EDEVCMA X'10' EDEVCMA FAStT-ctrl cache
mirror active
.... 1... EDEVABOK X'08' EDEVABOK FAStT-alt ctrl
batteries ok
.... .1.. EDEVBOK X'04' EDEVBOK FAStT-ctrl
batteries ok
.... ..1. EDEVRCA X'02' EDEVRCA FAStT-read cache
active
.... ...1 EDEVWCA X'01' EDEVWCA FAStT-write cache
active
0B4E 2894 Bitstring 1 EDEVFTF3 cache flag byte 3
0B4F 2895 Bitstring 1 EDEVFTF4 cache flag byte 4
00000B50 EDEVHDLN *-EDEV EDEV header length
00000B50 EDEVDVCF * Start of Device Configuration
SCSI with FBA emulation specific area
0B50 2896 Bitstring 1 EDEVATTR Attributes Type
1... .... EDEVSCSI X'80' EDEVSCSI General SCSI
Attributes
.1.. .... EDEV2105 X'40' EDEV2105 2105 SCSI
Attributes
..1. .... EDEVFAST X'20' EDEVFAST FAStT SCSI
Attributes
...1 .... EDEV2107 X'10' EDEV2107 2107 SCSI
Attributes
.... 1... EDEV1750 X'08' EDEV1750 1750 SCSI
Attributes
.... .1.. EDEV2145 X'04' EDEV2145 2145 SCSI
Attributes
.... ..1. EDEVXIV X'02' EDEVXIV XIV SCSI Attributes
0B51 2897 Bitstring 1 EDEVVPM Valid Path Mask
0B52 2898 Bitstring 1 EDEVSCPM SID/CHPID source path mask
0B53 2899 Bitstring 1 EDEVPCNT Count of path triplets
0B54 2900 Bitstring 1 EDEVPFPM Preferred Path Mask (1750's)
0B55 2901 Bitstring 1 * Reserved for future IBM use
0B56 2902 Bitstring 1 EDEVDVFG EDEV device specific flags
1... .... EDEVWSAM X'80' EDEVWSAM Write Same
supported (Fast Format)
0B57 2903 Bitstring 1 * Reserved for future IBM use
0B58 2904 Character 8 EDEVATBL SCSI Disk Attributes Table Name
0B60 2912 Bitstring 16 EDEVDVID IOSC Device ID (devid)
0B70 2928 Bitstring 224 EDEVPTHS Area to hold up to 8 Path
triplets
0C50 3152 Bitstring 8 * Reserved for future use
0C58 3160 Bitstring 8 * Reserved for future use
0C60 3168 Bitstring 8 * Reserved for future use
0C68 3176 Bitstring 8 * Reserved for future use
*** FBA SCSI specific values for EDEVPBLK, EDEVPLOD
00000018 EDEVSCPB 24 EDEVPBLK value for SCSI - 24
pages is two full 48K (=12 pages)
SZREQ request blocks
00000078 EDEVSCPL EDEVSCPB*5 EDEVPLOD value for
SCSI - size of optimal paging
block times (assumed) number of
free storage pages consumed by
SCSI per pageable page
written/read
00000C70 EDEVSCZB *-EDEV SCSI EDEV byte size
0000018E EDEVSCZD (*-EDEV+7)/8 SCSI EDEV doubleword
size
Emulation Device Simulation Vector
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure EDEVSIM EMULATION DEVICE BLOCK
0000 0 Address 4 EDEVSIMA ADDR OF CHANNEL CMD SIMULATOR
0004 4 Address 4 EDEVIOCS CLEAR SUBCHANNEL
0008 8 Address 4 EDEVIOHS HALT SUBCHANNEL
000C 12 Address 4 EDEVIOMS MODIFY SUBCHANNEL
0010 16 Address 4 EDEVIORS RESUME SUBCHANNEL
0014 20 Address 4 EDEVIOSS START SUBCHANNEL
0018 24 Address 4 EDEVIOST STORE SUBCHANNEL
001C 28 Address 4 EDEVIOTS TEST SUBCHANNEL
0020 32 Address 4 EDEVIOXS CANCEL SUBCHANNEL
SCSI Path Triplet DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure EDEVPATH EMULATION DEVICE BLOCK
0000 0 Bitstring 2 * Reserved for IBM use
0002 2 Bitstring 2 EDEVFCP FCP Device Number
0004 4 Bitstring 4 EDEVFCPR FCP Device RDEV address
0008 8 Bitstring 8 EDEVWWPN World Wide Port Number (WWPN)
0010 16 Bitstring 8 EDEVLUN Logical Unit Number (LUN)
0018 24 Bitstring 1 EDEVPTYP Path type
.... ...1 EDEVP2P 1 EDEVP2P Path is using point to
point conn
.... ..1. EDEVSWIT 2 EDEVSWIT Path is using switch
connection
0019 25 Bitstring 1 EDEVPSTA Path status
.... ...1 EDEVPOK 1 EDEVPOK Path is online (active)
.... ..1. EDEVPBAD 2 EDEVPBAD Path is offline
(stopped)
.... ..11 EDEVPBRK 3 EDEVPBRK Path is offline (never
enabled)
.... .1.. EDEVPERR 4 EDEVPERR Path is offline
(broken)
001A 26 Bitstring 2 * Reserved for IBM use
0000001C EDEVPTSZ *-EDEVPATH Size of path triplet
in bytes
BUFFER EXTENSION DSECT for Purge Support
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure EDEVBX EMULATION DEVICE BLOCK
0000 0 Bitstring 16 EDEVPRTI (0) primary resource tracking
identifier CP uses only 31-bit
HLA in EDEVPRTL
0000 0 Bitstring 12 *
000C 12 Address 4 EDEVPRTL Low Word: HLA(RDEVAIOR) FBA
Emulation HLA(VMDBASE) Native
Paging
0010 16 Bitstring 16 EDEVSRTI (0) secondary resource tracking ID CP
uses only 31-bit HLA in EDEVSRTL
0010 16 Bitstring 12 *
001C 28 Address 4 EDEVSRTL Low word of EDEVSRTI = HLA(RDEV)
0020 32 Bitstring 16 EDEVUTKN (0) user provided purge token CP uses
only 31-bit HLA in EDEVUTKL
0020 32 Bitstring 12 *
002C 44 Address 4 EDEVUTKL Low word of EDEVUTKN =
HLA(VMDBASE)
0030 48 Bitstring 16 EDEVDVRF IOSC handle for device (devref)
0040 64 Bitstring 32 * Reserved for SCSI Container use
0060 96 Signed 4 EDEVPND Count of pending I/O requests
0064 100 Signed 4 EDEVACT Count of active I/O requests
0068 104 Signed 4 EDEVPPND Count of pending I/O pages
006C 108 Signed 4 EDEVPACT Count of active I/O pages
0070 112 Bitstring 16 * Reserved for SCSI Container use
00000080 EDEVBXSZ *-EDEVBX Size of buffer extension
ABEND checkpoint codes (0-255)
HCPSZC checkpoint codes (1-20)
00000001 EDEVID1 1
00000002 EDEVID2 2
00000003 EDEVID3 3
00000004 EDEVID4 4
00000005 EDEVID5 5
00000006 EDEVID6 6
00000007 EDEVID7 7
00000008 EDEVID8 8
00000009 EDEVID9 9
0000000A EDEVID10 10
0000000B EDEVID11 11
0000000C EDEVID12 12
0000000D EDEVID13 13
0000000E EDEVID14 14
0000000F EDEVID15 15
00000010 EDEVID16 16
00000011 EDEVID17 17
00000012 EDEVID18 18
00000013 EDEVID19 19
HCPSZA checkpoint codes (21-40)
00000015 EDEVID21 21
00000016 EDEVID22 22
00000017 EDEVID23 23
00000018 EDEVID24 24
00000019 EDEVID25 25
0000001A EDEVID26 26
0000001B EDEVID27 27
0000001C EDEVID28 28
0000001D EDEVID29 29
0000001E EDEVID30 30
HCPSZI checkpoint codes (41-60)
00000029 EDEVID41 41
0000002A EDEVID42 42
0000002B EDEVID43 43
0000002C EDEVID44 44
0000002D EDEVID45 45
0000002E EDEVID46 46
0000002F EDEVID47 47
00000030 EDEVID48 48
00000031 EDEVID49 49
HCPSZS checkpoint codes (61-80)
0000003D EDEVID61 61
0000003E EDEVID62 62
0000003F EDEVID63 63
00000040 EDEVID64 64
00000041 EDEVID65 65
| |