The IHADVA macro supports two parameters:
- DSECT={YES|NO}
- If you code DSECT=YES, you get a single area with a DSECT. This
is the default. Its name depends on whether you code INFO= and what
you code for it. The DSECT name depends on the first value that you
code for INFO=.
The following applies if you code DSECT=NO:
- If you omit INFO= or you code INFO=NONE, then the area begins
with the symbol DVAREA and it is not a DSECT.
- If you code any combination of INFO values other than NONE, then
DVAREA is not defined and there is no DSECT.
- INFO={NONE|DEVTYPE|DASD|SUFFIX|AMCAP}
- If you omit the INFO keyword, then the mapping is for all of the
following at the same origin:
- - the minimum type of call
- UCBLIST= without INFO=
- INFO=DASD
- INFO=DEVTYPE
- INFO=SUFFIX
- INFO=NONE.
- This generates the mapping for the minimum type of call or when
you code UCBLIST= without INFO=. You cannot code NONE in combination
with any other value.
- INFO=DASD
- Generate the mapping for the area returned by coding INFO=DASD.
The DSECT name or first symbol is DVAIDASD.
- INFO=DEVTYPE
- Generate the mapping for the area returned by coding INFO=DEVTYPE.
The DSECT name or first symbol is DVAUCBTY.
- INFO=SUFFIX
- Generate the mapping for the area returned by coding INFO=SUFFIX.
The DSECT name or first symbol is DVASUFFX.
- INFO=AMCAP
- Generate the mapping for the area returned by coding INFO=AMCAP.
The DSECT name or first symbol is DVAAMCAP.
=======================================================================
DEVTYPE return area (mapping macro IHADVA)
THIS MACRO MAPS THE AREA RETURNED TO THE CALLER BY THE DEVTYPE SVC
=======================================================================
OFFSET
DEC(HEX) TYPE LEN NAME DESCRIPTION
======== ======== ===== ========= ===========================
0 (0) STRUCTURE 24 DVAREA
0 (0) CHARACTER 8 DVAPREFX Area if no INFOLIST=, DEVTAB
or RPS
Following four bytes are also returned for INFO=DEVTYPE
0 (0) CHARACTER 4 DVAUCBTY UCB TYPE FIELD
0 (0) BITSTRING 2 DVAOPTS UCB OPTIONS
2 (2) BITSTRING 1 DVACLASS DEVICE CLASS
3 (3) BITSTRING 1 DVAUNIT UNIT TYPE
4 (4) SIGNED 4 DVAMAXRC MAXIMUM RECORD SIZE
8 (8) CHARACTER 12 DVATAB SECTION INCLUDED BY DEVTAB
8 (8) UNSIGNED 2 DVACYL PHYS NUMBER CYL PER VOLUME
10 (A) SIGNED 2 DVATRK NR OF TRACKS PER CYL
12 (C) SIGNED 2 DVATRKLN TRACK LENGTH ( BYTES)
14 (E) SIGNED 2 DVAOVHD BLOCK OVERHEAD IF DVA2BOV IS
ON
IF DVA2BOV IS OFF USE INSTEAD THE FOLLOWING TWO VALUES
14 (E) ADDRESS 1 DVAOVNLB OVERHEAD NOT LAST BLOCK
15 (F) ADDRESS 1 DVAOVLB OVERHEAD LAST BLOCK
16 (10) ADDRESS 1 DVAOVNK OVERHEAD DECR IF NOT KEYED
17 (11) BITSTRING 1 DVAFLAGS FLAG BYTE
1... .... DVABDCYL IF 1, DVACYL IS INVALID
YL02130
.1.. .... DVADEFLR DEFINE EXTENT/LOCATE RECORD
AND RELATED TRANSFER COMMANDS
ARE IMPLEMENTED
..1. .... DVADEFEX DEFINE EXTENT IMPLEMENTED
...1 .... DVAMODL IF ON, USE MODULO TRACK
ALGORTIHM
.... 1... DVA2BOV IF ON, USE DVAOVHD ELSE USE
DVAOVNLB & DVAOVLB
.... .1.. DVAPAGES IF ON DEVICE SUPPORTS PAGING
CCWS
.... ..1. DVANOALT NO ALT TRKS AVAILABLE
.... ...1 DVAFTOL IF ON, APPLY TOLERANCE FACTOR
18 (12) SIGNED 2 DVATOL TOLERANCE FACTOR
(BLKSI+KEYLE) DVATOL/DVADVSR GIVES THE ADJUSTED BLOCK SIZE
TO WHICH APPROPRIATE OVERHEADS ARE THEN ADDED.
20 (14) CHARACTER 4 DVARPS RPS SECTION
20 (14) SIGNED 2 DVAOVR0 OVERHEAD BYTES FOR RECORD 0
22 (16) ADDRESS 1 DVASECT NUMBER OF SECTORS IN FULL
TRACK
23 (17) ADDRESS 1 DVASECTD NUMBER OF DATA SECTORS
====================================================================
THE FOLLOWING SECTION IS RETURNED BY DEVTYPE FOR INFO=DASD.
====================================================================
0 (0) STRUCTURE 16 DVAIDASD
0 (0) UNSIGNED 4 DVAICYL NUMBER OF CYLINDERS
4 (4) UNSIGNED 4 DVAITRK TRACKS PER CYLINDER
8 (8) UNSIGNED 1 DVAIFLAG FLAGS
1... .... DVAECKD1 ECKD SUPPORTED, ALSO ON FOR
VIO DATA SETS
.1.. .... DVALRE1 LOCATE RECORD EXTENDED
SUPPORTED
..1. .... DVACACHE1 DEVICE IS CACHED
...1 .... DVAIXVLD DVACYLMG, DVAEADSCB, DVAVIRSZ
valid.
.... 1... DVACYLMG Cylinder-managed space exists
on this volume and begins at
DVALCYL in multicylinder units
of DVAMCU. DVAEADSCB is also
set with this flag on. Valid
when DVAIXVLD is set.
.... .1.. DVAEADSCB Extended attribute DSCBs,
Format 8 and 9 DSCBs, are
allowed on this volume. Valid
when DVAIXVLD is set.
.... ..1. DVASSDEV The device is solid state
.... ...1 DVACRYPT Data encrypted device.
9 (9) UNSIGNED 1 DVAMCU Minimum allocation size in
cylinders for cylinder-managed
space. Each extent in this
space must be a multiple of
this value. space. Also
referred to as the
multicylinder unit (MCU). This
is the smallest unit of disk
space in cylinders that can be
allocated in cylinder-managed
space. Valid when DVACYLMG is
set. This field is zero on
releases before z/OS 1.10 or
if the status is not yet
known. In these two cases
DVAIXVLD is not set.
10 (A) UNSIGNED 2 DVALCYL First cylinder address divided
by 4095 where space is managed
in multicylinder units.
Cyl-managed space begins at
this address. Valid when
DVACYLMG is set. This field is
zero on releases before z/OS
1.10 or if the status is not
yet known. In these two cases
DVAIXVLD is not set.
12 (C) UNSIGNED 1 DVAITSET TRACK SET SIZE
13 (D) UNSIGNED 1 * Reserved. DEVTYPE currently
returns zeroes but could
return something different in
a future release.
14 (E) UNSIGNED 2 DVAVIRSZ Block size of the index data
set. Valid when DAVIXVLD is
set on. When valid and zero
the volume has no working VTOC
index. This field is zero on
releases before z/OS 1.10 or
if the status is not yet
known. In these cases DVAIXVLD
is not set.
====================================================================
THE FOLLOWING SECTION IS RETURNED BY DEVTYPE FOR INFO=AMCAP.
====================================================================
0 (0) STRUCTURE 32 DVAAMCAP ACCMETH
CAPABILITY
0 (0) BITSTRING 1 DVAAMFLG FLAGS
1... .... DVAAMLBI BSAM, QSAM AND (IF DASD) BPAM
SUPPORT THE LARGE BLOCK
INTERFACE & THE LIMIT IS IN
THE NEXT DOUBLEWORD.
.1.. .... DVAAM_XTIOT This data set allocation has an
XTIOT. Either all or none of the
entries for a concatenation are
XTIOT.
..1. .... DVAAM_XTIOTAM BSAM, QSAM and BPAM (if DASD)
support XTIOT for this device,
and the NON_VSAM_XTIOT option in
PARMLIB allows it. DEVTYPE will
turn this on if the UCB is DASD
or tape or the DD is dummy and
the PARMLIB option allows it.
...1 .... DVAAM_31UCB One or more UCB addresses for
this data set allocation (or
concatenation) point above the 16
MB and have not been captured for
the allocation. If this bit is
off, the data set still might be
extended to another volume and
gain a 31-bit address UCB.
.... 1... DVAAM_31UCBAM BSAM, QSAM and BPAM (if DASD)
support 31-bit UCB addresses in
the DEB and the NON_VSAM_XTIOT
option in PARMLIB allows it.
.... .1.. DVAAM_DSAB DSAB is above the line.
.... ..1. DVAAM_DSABAM BSAM, QSAM and BPAM (if DASD)
support DSAB above the line and
the NON_VSAM_XTIOT option in
PARMLIB allows it.
1 (1) CHARACTER 7 * RESERVED
8 (8) BITSTRING 8 DVAMAXBLK MAXIMUM BLOCK SIZE SUPPORTED
WITH
SAM LBI
16 (10) BITSTRING 8 DVAOPTBLK RECOMMENDED MAXIMUM BLOCK SIZE
LONGER BLOCKS MIGHT BE LESS
EFFICIENT OR LESS RELIABLE.
LESS THAN OR EQUAL TO PREVIOUS
FIELD.
24 (18) BITSTRING 8 DVAMAXLR MAXIMUM UNSPANNED LOGICAL
RECORD
LENGTH SUPPORTED BY BSAM, QSAM
AND BPAM
====================================================================
THE FOLLOWING SECTION IS RETURNED BY DEVTYPE FOR INFO=SUFFIX.
====================================================================
0 (0) SIGNED 2 DVASUFFX SUFFIX LENGTH