|
The following describes SSGARGL. SSGARGL is the area pointed
to by the word that Word 2 points to. Word 2 is part of the parameter
list passed to IDCSS01. The caller must establish some fields; IDCSS01
establishes other fields. The caller must set
an option flag to indicate whether information requested is status
information (SSGRSS), counts information (SSGRPD), Space Efficient
Volume status (SSGSEV), or Extent Pool Configuration status (SSGEPC). If
the caller passes SSGADDN, IDCSS01 establishes SSGAVOL and SSGUNIT.
.
If counts information is requested, the caller must indicate whether
it applies to all subsystems (SSGALL), a specific subsystem (SSG1SS),
or a specific device (SSGDEV). In addition, the caller must either
pass the ddname (through SSGADDN) of a DD statement that allocates
a caching subsystem volume, or the caller must identify the volume
and unit (through SSGAVOL and SSGUNIT) of a caching subsystem volume
for which information is being requested.
If Space Efficient Volume status, or Extent Pool
Configuration status is requested, the caller must follow the
instruction described in the mapping for the space efficient
volume status output buffer, or mapping for the extent pool configuration
status output buffer described in later of this section.
Note: The SSGOLN may be larger than the data returned
in the SSGBUFR buffer. To detect end of data, the following should
be considered: - If "current index into the SSGBUFR buffer" is within SSGOLN-4
bytes, then the full six bytes of SSGDAVOL being zero is the way to
determine the premature "end of data".
- If "current index into the SSGBUFR buffer" is beyond SSGOLN-4
bytes of the data, then they are at "end of data".
The following list contains other fields that
IDCSS01 establishes: ====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 96 SSGARGL
0 (0) CHARACTER 8 SSGHEAD SSGARGL IDENTIFIER
8 (8) ADDRESS 4 SSGADDN DDNAME ADDRESS
12 (C) ADDRESS 4 SSGAVOL VOLUME ADDRESS
16 (10) BITSTRING 4 SSGUNIT DEVICE TYPE
16 (10) BITSTRING 1 SSGUNIT1 GENERAL FLAGS
17 (11) BITSTRING 1 SSGUNIT2 GENERAL FLAGS
18 (12) BITSTRING 1 SSGUNIT3 DEVICE CLASS
19 (13) BITSTRING 1 SSGUNIT4 DEVICE TYPE WITHIN THE CLASS
20 (14) SIGNED 4 SSGOLN LENGTH OF OUTPUT BUFFER
24 (18) ADDRESS 4 SSGOADR ADDRESS OF OUTPUT BUFFER
28 (1C) BITSTRING 2 SSGOPT OPTIONS BYTE
1... .... SSGRPD SENSE SUBSYSTEM COUNTS
.1.. .... SSGRSS SENSE SUBSYSTEM STATUS
..1. .... SSGCACHE ON=CACHING,OFF=PAGING
...1 .... SSGSDS ON=1 SD, OFF= 2 SD'S
.... 1... SSGALL SENSE FOR ALL SUBSYSTEMS
.... .1.. SSG1SS SENSE FOR SPECIFIED SUBSYSTEM
.... ..1. SSGDEV SENSE FOR SPECIFIED DEVICE
.... ...1 SSGAMD PTR TO 3880 MODEL PASSED
INSTEAD OF PTR TO VOLUME
29 (1D) 1... .... SSG2SD PRINT 2 SD
.1.. .... SSGACD ACCESSCODE
..1. .... SSGOFFL SSGAVOL POINTS TO DEVICE ID OF
AN OFFLINE DEVICE
...1 .... SSGARGL2 this flag indicates that the
parameter list is extended by
the 16 bytes defined as
SSGARGLX
.... 1... SSGLINKP Link performance statistics
supported by caller and
request return of statistics
when request for Subsystem
counts are made (SSGRPD = ON)
for one or more Subsystems
(SSG1SS=ON or SSGALL = ON).
Results passed back in area
pointed to by SSGLPOAR
Extended size statistics are
provided if SSGEXRQ is
specified. The returned field,
SSGLLSET, will be set to the
size for each set of link
statistics.
.... .1.. SSGARGL3 this flag indicates that the
paramter list is extended with
area defined as SSGARLGY
30 (1E) BITSTRING 1 SSGMDLID CU MODEL IDENTIFIER
31 (1F) CHARACTER 1 SSGRCIOS 'old' parameter list end
Parameter List Extension.
Note: IDCSS01 will not reference fields contained in SSGARGLX
unless the bit defined as SSGARGL2 is set to '1'.
====================================================================================
32 (20) CHARACTER 16 SSGARGLX parm list extension
32 (20) UNSIGNED 1 SSGATIME I/O timeout value in
seconds.When SSGATIME is
not zero, it will be stored
into IOSXTIME in the IOSB. If
the I/O is active or queued
longer that SSGATIME, the I/O
will be terminated and IDCSS01
will return a return code of
60. Hex values for SSGATIME
support seconds from 1 to 255.
33 (21) CHARACTER 2 SSGADEVN Binary device number that
received an IO (RC8) or
timeout (RC60) from IDCSS01
35 (23) UNSIGNED 1 SSGLPRET Reason code from link
performance statistics
processing
36 (24) ADDRESS 4 SSGLPOAR Address of link performance
Statistics output buffer
queue. When zero on return
statistics not available for
devices found on counts
request or statistics not not
requested by the caller
40 (28) CHARACTER 8 * reserved for future use
Parameter List Extension number 3
Note: IDCSS01 will not reference fields contained in SSGARGLY
unless the bit defined as SSGARGL3 is set to '1'.
Entire section added
====================================================================================
48 (30) CHARACTER 48 SSGARGLY Parm list extension 3
48 (30) BITSTRING 4 SSGOPTY Extended options
1... .... SSGRANKP RANK performance statistics
are supported by caller and
request return of statistics
when request for Subsystem
counts are made (SSGRPD = ON)
for one or more Subsystems
(SSG1SS=ON or SSGALL = ON).
Results passed back in area
pointed to by SSGRSOAR
.1.. .... SSGSEGMP Segment pool statistics are
supported by caller and
request return of statistics
when request for Subsystem
counts are made (SSGRPD = ON)
for one or more Subsystems
(SSG1SS=ON or SSGALL = ON).
Results passed back in area
pointed to by SSGSPOAR
..1. .... SSGSEV Space Efficient Volume
(SEVOL) status is
supported by caller and
request return of status
in SSGSEBUF pointed by
SSGSEOAR when request for
SEVOL are made (SSGSEV
=ON) for the scope of
single device
(SSGDEV=ON), online SEVOL
devices in the subsystem
(SSG1SS=ON), or all
online SEVOL devices
(SSGALL=ON). For single
offline SEVOL status,
caller set address of
the MVS addr character
in SSGAVOL and set
offline (SSGOFFL=ON).
The Fixed Block (FB)
SEVOL device status is
returned when the
reporting scope is single
(SSGDEV=ON), the FB user
request is active
(SSGURFBD=ON), FB LSS
number is in SSGFBLSS,
and FB device number is
in SSGFBDEV. FB SEVOL
status is available
through CKD I/O device
that resides in the same
Storage Facility Image as
FB SEVOL and resides in
the same Even or Odd
number LSS as even or odd
FB LSS. SEVOL status is
not supported when other
statistics or status is
requested by caller.
...1 .... SSGEPC Extent Pool Config (EPC)
status is supported by
caller and request return
of status in SSGEPBUF
pointed by SSGEPOAR when
request for EPC of
Storage Facility Image
oriented by I/O device in
SSGADDN or SSGAVOL are
made (SSGEPC=ON). When
Extent Pool ID (SSGEPID)
is set as 'FFFF'X by
caller, EPC summary
status is returned. When
even numbered Extent Pool
ID is specified in
SSGEPID with the I/O
device in the even LSS,
detail status of EPC for
the specified Extent Pool
is returned. When odd
numbered Extent Pool ID
is specified with the I/O
device in the odd LSS,
detail status of EPC for
the specified Extent Pool
is returned. SSGURBMP is
internal use only. When
Extent Pool ID (SSGEPID)
is set as 'FFFF'X with
SSGURBMP is ON, branch
entry caller receives
error. Whether ON or OFF
of SSGURBMP does not make
difference in EPC detail
status for branch entry
caller. EPC status report
is not supported when
other statistics or
status is requested
by caller.
.... 1... SSGURFBD Request Fixed Block SEVOL
status by turning
SSGURFBD flag ON.
.... .1.. SSGURBMP IDCAMS internal use.
Refer SSGEPC bit
description.
.... ..1. SSGEXRQ By setting this attribute bit
along with other request(s),
caller supports and requests the
return of extended length
statistics. The extended
length is any set of statistics
that is larger than the standard
length of statistics. The
extended length statistics will
be returned if target storage
facility supports it, otherwise
the standard size statistics
will be returned. Ignored this
attribute bit for requests where
the statistics do not support
the extended length and where
caller does not make any
request.
Current request that supports
the extended length is:
- Link performance statistics
52 (34) CHARACTER 8 SSGRETY Extended return codes
52 (34) UNSIGNED 1 SSGRSRET Reason code from Rank
Performance Statistics
processing
53 (35) UNSIGNED 1 SSGSGRET Reason code from Segm
Performance Statistics
processing
60 (3C) ADDRESS 4 SSGRSOAR Address of Rank performance
Statistics output buffer
queue. When zero on return
statistics not available for
devices found on counts
request or statistics not not
requested by the caller
64 (40) ADDRESS 4 SSGSPOAR Address of segment pool
performance Statistics output
buffer queue. When zero on
return statistics not
available for devices found on
counts request or statistics
not not requested by the
caller
68 (44) ADDRESS 4 SSGSEOAR Address of SE Volume
status output buffer
queue. When zero on
return status not
available for devices
found on SEVOL status
request or status not
requested.
72 (48) ADDRESS 4 SSGEPOAR Address of Extent Pool
Config (EPC) status
output buffer. When zero
on return status not
available for Storage
Facility Image found on
EPC status request or
status not requested
by the caller.
76 (4C) UNSIGNED 2 SSGEPID Extent Pool ID.
'FFFF'X indicates no
Ext Pool ID is
provided by caller.
78 (4E) UNSIGNED 2 SSGFBLSS Fix Block device number
80 (50) UNSIGNED 2 SSGFBDEV Fix Block LSS number
82 (52) CHARACTER 14 * reserved for future use
MAPPING FOR THE SUBSYSTEM GET OUTPUT BUFFER
====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE * SSGBUFR
0 (0) CHARACTER 6 SSGDAVOL VOLUME SERIAL
6 (6) BITSTRING 1 SSGDAFLG
1... .... SSG_UA_FLAG "ONE" UNIT ADDR FORMAT
.1.. .... SSG_FND_STG2 2ND STG DIR PATH FND SS01 TO
LA01 IDCSS01 PASSED TO IDCLA01
..11 1111 * RESERVED
7 (7) CHARACTER 1 SSGDCUID Real CUID for data in
SSGDADA
8 (8) CHARACTER 4 SSGDAUA1 FIRST UNIT ADDRESS
12 (C) CHARACTER 2 SSGDAUB1 FIRST UNIT ADDRESS (BINARY)
14 (E) SIGNED 2 SSGDALN DATA LENGTH
16 (10) CHARACTER 192 SSGDADA DATA AREA
16 (10) CHARACTER 192 SSGDAXPF CACHING SUBSYSTEM PERFORMANCE
STATISTICS
16 (10) CHARACTER 160 SSGDASPF CACHING SUBSYSTEM COUNTS
16 (10) CHARACTER 80 SSGDA2SD STATUS FOR 2 SD
16 (10) CHARACTER 80 SSGDAIPF PAGING SUBSYSTEM COUNTS
16 (10) CHARACTER 44 SSGDASS SUBSYSTEM STATUS (LNGTHND)
16 (10) CHARACTER 40 SSGDASS_40
STATUS FOR 3380
16 (10) CHARACTER 24 SSGDAACD
ACCESSCODES
16 (10) CHARACTER 12 SSGDAAC0
STORAGE CLUSTER 0 WORD
28 (1C) CHARACTER 12 SSGDAAC1
STORAGE CLUSTER 1 WORD
MAPPING FOR THE SUBSYSTEM GET OUTPUT BUFFER
FOR LINK PERFORMANCE STATISTICS
Output buffer is a chain, anchored by SSGLPOAR, of link
performance statistics tables. Each table entry represents
data read from a single storage subsystem box. The
statistics from a single box may be described with more than
table entry. The chain is a single threaded queue. Each
chain element needs to be freed by the caller of this
interface. Output buffer is built for storage boxes
that support link performance statistics and are returned
only if requested by caller (SSGLINKP) on a request for
performance data (SSGRPD) for requests with scope of
of subsystem (SSG1SS) or all subsystems (SSGALL).
The parameter list extension must also be passed as
indicated with SSGARLG2.
====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE * SSGLBUFR
0 (0) CHARACTER 56 SSGLHDR Queue element header
0 (0) UNSIGNED 4 SSGLQDAL Length of this queue element,
header plus data
4 (4) UNSIGNED 4 SSGLQDAO Offset to the start of the
statistics sets
8 (8) ADDRESS 4 SSGLFWDP Pointer to next queue element,
when zero end of queue
Orientation to subsystem that stats pertain
====================================================================================
12 (C) CHARACTER 6 SSGLVOL Volume serial of device that
stats where read from
18 (12) CHARACTER 2 SSGLDEVN Device number of device that
Stats where read from
20 (14) CHARACTER 8 * Reserved
28 (1C) CHARACTER 28 SSGLLHDR Link stats info
28 (1C) UNSIGNED 2 SSGLNSET Num of link stats sets read
30 (1E) UNSIGNED 2 SSGLLSET Size of each set
The extended size would be set
if the target storage facility
supports it and SSGEXRQ is set,
otherwise the standard 96-bytes
entry size for each interface
ID will be set.
32 (20) CHARACTER 6 SSGLCUT Control unit type
38 (26) CHARACTER 3 SSGLCUM Control unit model
41 (29) CHARACTER 10 SSGLSEQ Control unit sequence number
51 (33) CHARACTER 1 SSGLVER Version of link statistics.
When value of version is X'00',
it indicates that the link
statistics are defined in the
96 byte format. When value of
version is X'01', it indicates
that the link statistics are
defined in the 156 byte format.
52 (34) CHARACTER 4 * Not used
56 (38) CHARACTER * SSGLDADA Link performance stats
read
SSGLDADA consists of link statistics sets with Interface ID
containing one or more table information entries. Each
entry can be 96 bytes defined in SSGLLSTA or 156 bytes
defined in SSGLXSTA depending on version number in SSGLVER.
====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
56 (38) CHARACTER 96 SSGLLSTA(*) Stats entry
56 (38) UNSIGNED 1 SSGLLTYP Link type
01 - ESCON
02 - Fibre Channel 1 Gb/s
03 - Fibre Channel 2 Gb/s
04 - Fibre Channel 4 Gb/s
05 - Fibre Channel 8 Gb/s
06 - Fibre Channel 16 Gb/s
57 (39) UNSIGNED 1 * Unused
58 (3A) UNSIGNED 1 SSGLLBYI Byte increment 01 - 128K bytes
59 (3B) UNSIGNED 1 SSGLLTMI Time increment 01 - 16 MS
60 (3C) CHARACTER 2 * Unused
62 (3E) CHARACTER 2 SSGLLIID Interface id
64 (40) CHARACTER 88 SSGLLSAT Link statistics
64 (40) UNSIGNED 4 SSGLERDB Eckd read bytes in byte
increment
68 (44) UNSIGNED 4 SSGLEWRB Eckd write bytes in byte
increment
72 (48) UNSIGNED 4 SSGLERDO Eckd read operations. for
escon ports, one count per
chain which transfers data to
the host. for ficon ports, one
count per command which
transfer data to the host
76 (4C) UNSIGNED 4 SSGLEWRO Eckd write operations. for
escon ports, one count per
chain which transfers data to
the host. for ficon ports, one
count per command which
transfer data to the host
80 (50) UNSIGNED 4 SSGLERDT Eckd read accumulated time on
channel. the active processing
time for each command is
accumulated based on increment
value.
84 (54) UNSIGNED 4 SSGLEWRT Eckd write accumulated time on
channel. the active processing
time for each command is
accumulated based on increment
value.
88 (58) UNSIGNED 4 SSGLPRDB Pprc send bytes in byte
increment
92 (5C) UNSIGNED 4 SSGLPWRB Pprc received bytes in byte
increment
96 (60) UNSIGNED 4 SSGLPRDO Pprc send operations. each
pprc write command sent by the
pprc primary
100 (64) UNSIGNED 4 SSGLPWRO Pprc received operations. each
pprc write command received by
the pprc secondary.
104 (68) UNSIGNED 4 SSGLPRDT Pprc send accumulated time
based on incremant value
108 (6C) UNSIGNED 4 SSGLPWRT Pprc received accumulated time
based on increment value
112 (70) UNSIGNED 4 SSGLSRDB Scsi read bytes in byte
increment
116 (74) UNSIGNED 4 SSGLSWRB Scsi write bytes in byte
increment
120 (78) UNSIGNED 4 SSGLSRDO Scsi read operations. each
scsi read is counted
124 (7C) UNSIGNED 4 SSGLSWRO Scsi write operations. each
scsi write is counted
128 (80) UNSIGNED 4 SSGLSRDT Scsi read accumulated time
based on increment value
132 (84) UNSIGNED 4 SSGLSWRT Scsi write accumulated time
based on increment value
136 (88) CHARACTER 16 * Reserved
SSGLDADA consists of table entris defined by SSGLXSTA shown
below when SSGLVER is decimal value of 1.
====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ================================
56 (38) CHARACTER 156 SSGLXSTA(*) Stats entry
56 (38) UNSIGNED 96 * Mapped in SSGLLSTA
152 (98) UNSIGNED 4 SSGLFLKF Fibre Channel Link Failure
Error Count.
This count is the number of
miscellaneous fibre channel link
errors, such as unexpected NOS
received or a link state machine
failure detected.
156 (9C) UNSIGNED 4 SSGLFLSY Fibre Channel Loss of
Synchronization Error Count.
This count is the number of loss
of synchronization errors where
it is a confirmed and
a persistent synchronization
loss on the fibre channel link.
160 (A0) UNSIGNED 4 SSGLFLSG Fibre Channel Loss of Signal
Error Count.
This count is the number of times
that a loss of signal was
detected on the fibre channel
link when a signal was
previously detected.
164 (A4) UNSIGNED 4 SSGLFPSQ Fibre Channel Primitive Sequence
Error Count.
This count is the number of
primitive sequence protocol error
counts where an unexpected
primitive sequence was received.
168 (A8) UNSIGNED 4 SSGLFITW Fibre Channel Invalid
Transmission Word Error Count.
This count is the number of times
a "bit" error was detected.
Examples of a "bit" errors are a
code violation, invalid special
code alignment, or disparity
errors.
172 (AC) UNSIGNED 4 SSGLFCRC Fibre Channel CRC Error Count.
This count is the number of
times a received frame's CRC
is in error.
176 (B0) UNSIGNED 4 SSGLFLR1 Fibre Channel Link Recovery
(LR) Sent Count Count.
This count is the number of times
the port has transitioned from
an active (AC) state to a Link
Recovery (LR1) state.
180 (B4) UNSIGNED 4 SSGLFLR2 Fibre Channel Link Recovery
(LR) Received Count Recovery
Count.
This count is the number of times
the port has transitioned from
an active (AC) state to a Link
Recovery (LR2) state.
184 (B8) UNSIGNED 4 SSGLFILF Fibre Channel Illegal Frame
Count. This count is the number
of frames that violated Fibre
Channel protocol. One example is
an invalid frame header. One
common reason is when the first
frame of data sequence is missing
and a subsequent data frame is
detected as illegal.
188 (BC) UNSIGNED 4 SSGLFOOD Fibre Channel Out of Order
Data Count.
This count is the number of times
that a out of order frame is
detected. The frame is either
missing from a data sequence or
it is received beyond the port's
sequence reassembly threshold.
192 (C0) UNSIGNED 4 SSGLFOOA Fibre Channel Out of Order
ACK Count.
This count is the number of times
that a out of order ACK frame is
detected. The frame is either
missing from a data sequence
or it is received beyond the
port's sequence reassembly
threshold.
196 (C4) UNSIGNED 4 SSGLFDPF Fibre Channel Duplicate
Frame Count.
This count is the number of
times a frame was received
that has been detected as
previously processed.
200 (C8) UNSIGNED 4 SSGLFIRO Fibre Channel Invalid
Relative Offset Count.
This count is the number of
times that a frame was received
with bad relative offset in the
frame header.
204 (CC) UNSIGNED 4 SSGLFSQT Fibre Channel Sequence
Timeout Count.
This count is the number of
times the port has detected a
timeout condition on receiving
sequence initiative for a fibre
channel exchange.
208 (D0) UNSIGNED 4 SSGLFBER Fibre Channel Bit Error
Rate Count.
This count is the number of the
bit error (invalid transmission
word) bursts for the previous 5
minute counting window.
MAPPING FOR THE SUBSYSTEM GET OUTPUT BUFFER
FOR RANK PERFORMANCE STATISTICS
Output buffer is a queue, anchored by SSGRSOAR, of rank
performance statistics. Each queue element represents data
read from a single storage subsystem box that describes sets
of statistics. The queue is a single threaded queue. Each
queue element needs to be freed by the caller of this
interface. Output buffer built for storage subsystem boxes
that support rank performance statistics and are returned
only if requested by caller (SSGRANKP) on a request for
performance data (SSGRPD) for requests with scope of
of subsystem (SSG1SS) or all subsystems (SSGALL).
====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE * SSGRBUFR
0 (0) CHARACTER 56 SSGRHDR Queue element header
0 (0) UNSIGNED 4 SSGRQDAL Length of this queue element,
header plus data
4 (4) UNSIGNED 4 SSGRQDAO Offset to the start of the
statistics sets
8 (8) ADDRESS 4 SSGRFWDP Pointer to next queue element,
when zero end of queue
Orientation to subsystem that stats pertain
====================================================================================
12 (C) CHARACTER 6 SSGRVOL Volume serial of device that
stats where read from
18 (12) CHARACTER 2 SSGRDEVN Device number of device that
Stats where read from
20 (14) CHARACTER 8 * Reserved
28 (1C) CHARACTER 28 SSGRRHDR Rank stats info
28 (1C) UNSIGNED 2 SSGRNSET Num of rank stat sets
available to be returned on
the ESS starting from first
rank ID SSGRRID. Can be used
to determine buffer
requirements
30 (1E) UNSIGNED 2 SSGRLSET Size of each rank stats set
excluding size of array info
SSGRRAR
32 (20) CHARACTER 6 SSGRCUT Control unit type
38 (26) CHARACTER 3 SSGRCUM Control unit model
41 (29) CHARACTER 10 SSGRSEQ Control unit sequence number
51 (33) CHARACTER 1 SSGRVER Version of rank statistics
52 (34) UNSIGNED 2 SSGRARNM Num of array info sets avail
to be returned on the ESS
starting from first rank id
SSGRRID. Can be used to
determine buffer requirements
54 (36) UNSIGNED 2 SSGRARSZ Size of each array information
set SSGRRAR
56 (38) CHARACTER * SSGRDADA Rank performance stats read
56 (38) CHARACTER 56 SSGRRSTA(*) Rank statistics entry
56 (38) UNSIGNED 2 SSGRRKID Rank Identifier
The returned data consists of rank sets with each rank set
containing one or more array information entries.
====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE * SSGRRSTT Rank stats entry mapping
includes one or more entries
for array information
0 (0) UNSIGNED 2 SSGRRID Rank identifier
2 (2) UNSIGNED 2 SSGRRPNM Segment pool number
4 (4) UNSIGNED 1 SSGRRCNT Count of arrays in rank
5 (5) BITSTRING 1 SSGRRRTQ Rank Type Qualifier
1... .... SSGRRDER Data Encrypted Rank. When '1',
the data stored on the physical
media (i.e disk) is encrypted.
6 (6) CHARACTER 2 * Not used
In the statistics below bytes are accumulated in units of
128 KB, and time is accumulated in units of 16 milliseconds
====================================================================================
8 (8) UNSIGNED 4 SSGRRBYR Rank bytes read
12 (C) UNSIGNED 4 SSGRRBYW Rank bytes written
16 (10) UNSIGNED 4 SSGRRROP Rank read operations
20 (14) UNSIGNED 4 SSGRRWOP Rank write operations
24 (18) UNSIGNED 4 SSGRRKRT Rank read repsonse time
28 (1C) UNSIGNED 4 SSGRRKWT Rank wrirte response time
32 (20) CHARACTER 24 SSGRRAR(*) Array information
mapping
The format of the next 24 bytes is repeated the number
times as indicated by SSGRRCNT.
32 (20) UNSIGNED 2 SSGRRAID Rank array id
34 (22) CHARACTER 16 SSGRREBC Array type in ebcdic
50 (32) UNSIGNED 1 SSGRRTYP Array type
01 = RAID-5
02 = RAID-10
03 = RAID-6
04-FF NOT USED
51 (33) UNSIGNED 1 SSGRRAWD Array width
52 (34) UNSIGNED 1 SSGRRASP Array speed (1000 RPM)
53 (35) BITSTRING 1 SSGRRACS Array Device Class and Array
Status
11.. .... SSGRRADC Mask bits for Array Device Class
Device Class
'00'b Enterprise
'01'b Near-line (An Advanced
Technology Attachment
(ATA) Drive)
'10'b SATA (Serial Advanced
Technology Attachment
(ATA) Drive)
'11'b Solid State Drive (SSD)
..1. .... SSGRRAS1 Raid Degraded. One or more
array members need rebuilding
...1 .... SSGRRAS2 DDM Throttling. A Near-line DDM
in the array is throttling
performance due to temperature
or workload.
.... 1... SSGRRAS3 RPM Exception. A DDM with an
slower RPM than the normal
array DDMs is a member of
the array as a result of
a sparing action.
54 (36) CHARACTER 2 SSGRRACP Array capacity (GB)
MAPPING FOR THE SUBSYSTEM GET OUTPUT BUFFER
FOR SEGMENT POOL PERFORMANCE STATISTICS
Output buffer is a queue, anchored by SSGSPOAR, of segment
pool perf statistics. Each queue element represents data
read from a single storage subsystem box that describes sets
of statistics. The queue is a single threaded queue. Each
queue element needs to be freed by the caller of this
interface. Output buffer built for storage subsystem boxes
that support rank performance statistics and are returned
only if requested by caller (SSGSEGMP) on a request for
performance data (SSGRPD) for requests with scope of
of subsystem (SSG1SS) or all subsystems (SSGALL).
====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE * SSGSBUFR
0 (0) CHARACTER 56 SSGSHDR Queue element header
0 (0) UNSIGNED 4 SSGSQDAL Length of this queue element,
header plus data
4 (4) UNSIGNED 4 SSGSQDAO Offset to the start of the
statistics sets
8 (8) ADDRESS 4 SSGSFWDP Pointer to next queue element,
when zero end of queue
Orientation to subsystem that stats pertain
====================================================================================
12 (C) CHARACTER 6 SSGSVOL Volume serial of device that
stats where read from
18 (12) CHARACTER 2 SSGSDEVN Device number of device that
Stats where read from
20 (14) CHARACTER 8 * Reserved
28 (1C) CHARACTER 28 SSGSSHDR Segment pool stats info
28 (1C) UNSIGNED 2 SSGSNSET Num of pool stats sets read
30 (1E) UNSIGNED 2 SSGSLSET Size of each set
32 (20) CHARACTER 6 SSGSCUT Control unit type
38 (26) CHARACTER 3 SSGSCUM Control unit model
41 (29) CHARACTER 10 SSGSSEQ Control unit sequence number
51 (33) CHARACTER 1 SSGSVER Version of pool statistics
52 (34) BITSTRING 1 SSGSFLG Flags
1... .... SSGSVLD Extent pool statistics valid
Bytes 44-67 starting at
SSGSSRSC
53 (35) CHARACTER 3 * Not used
56 (38) CHARACTER * SSGSDADA Segment pool perf stats read
56 (38) CHARACTER 52 SSGSSSTA(*) Segment pool stats entry
56 (38) UNSIGNED 2 SSGSSGID Segment pool
identifier
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 52 SSGSSSTT seg pool statistics entry
includes one or more entry
0 (0) UNSIGNED 2 SSGSSPID Seg pool identifier
2 (2) UNSIGNED 1 SSGSSPLT Segment pool type
00-03 = reserved
04 = FB 1GB
05-131 = reserved
132 = CKD 1GB
133-255 = reserved
3 (3) BITSTRING 1 SSGSSPTQ Extent Pool Type Qualifier
1... .... SSGSSDEP Data Encrypted Extent Pool.
When '1', the data stored on
the physical media (i.e disk)
is encrypted.
4 (4) UNSIGNED 4 SSGSSCAP Real seg pool capacity (GB)
00-03 = reserved
04 = FB 1GB
05-131 = reserved
132 = CKD 1GB
133-255 = reserved
====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
3 (3) CHARACTER 1 * Not used
4 (4) UNSIGNED 4 SSGSSCAP Real seg pool capacity (GB)
8 (8) UNSIGNED 4 SSGSSNMS Num real segments in seg pool
12 (C) UNSIGNED 4 SSGSSNMA Num real allocated segments in
in segment pool
16 (10) UNSIGNED 4 SSGSSRSC Real segment conversions
20 (14) UNSIGNED 4 SSGSSVCP Virtual seg pool capacity(GB)
24 (18) UNSIGNED 4 SSGSSNMV Number of virtual segments in
segment pool
28 (1C) UNSIGNED 4 SSGSSVSC Virtual segment conversions
32 (20) UNSIGNED 4 SSGSSSDY Number of segments that were
sources of dynamic segment
relocations
36 (24) UNSIGNED 4 SSGSSTDY Number of segments that were
targets of cynamic segment
relocations
40 (28) CHARACTER 12 * Not used
MAPPING FOR THE SPACE EFFICIENT VOLUME STATUS
OUTPUT BUFFER
Output buffer is a queue, anchored by SSGSEOAR, of Space
Efficient Volume (SEVOL) status. Each queue element represents
status of the space efficient volume specified in the header.
The queue is a single threaded queue. Each queue element
needs to be freed by the caller of this interface.
Output buffer is built for SEVOL(s) when SEVOL status is
requested (SSGSEV=ON).
Caller sets the scope of SEVOL(s) by turning one of flag bit
that is the single device (SSGDEV), subsystem (SSG1SS),
or all subsystems (SSGALL). For a single SEVOL status request,
the SEVOL status can be obtain when the path of SEVOL is
available. For a subsystem (SSG1SS) and all systems (SSGALL)
scope, the SEVOL status is available when SEVOL is ONLINE.
When the scope is the single device (SSGDEV=ON) and
the Fix Block SEVOL is requested (SSGURFBD=ON), the status
of FB SEVOL oriented by LSS (SSGFBLSS) and Device
(SSGFBDEV) is reported. FB SEVOL status is not available
with the scope of the subsystem (SSG1SS=ON) or
the all subsystems (SSGALL=ON). FB SEVOL status is available
when LSS number of both the I/O device (SSGAVOL or SSGDDN) and
FB SEVOL are numbered in the same even or odd number.
Flag and variable combinations of SEVOL status request
are shown as below in the railroad chart format.
>>_SSGSEV_ _SSGALL________ ________________> (A)
|_SSG1SS________|
|
|_SSGDEV_ ____________________ __> (B)
|_SSGFBLSS__SSGFBDEV_|
(A)>__ _SSGAVOL__SSGUNIT__ __ __________________><
|_SSGADDN___________| |
|
|
(B)> __ _SSGAVOL__SSGUNIT__ _|
|_SSGADDN___________|
|_SSGAVOL__SSGOFFL__|
MAPPING FOR THE SPACE EFFICIENT VOLUME STATUS OUTPUT
BUFFER
====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 84 SSGSEBUF
0 (0) CHARACTER 56 SSGSEHDR Queue element header
0 (0) UNSIGNED 4 SSGSEQAL Length of this queue
element, header plus
data
4 (4) UNSIGNED 4 SSGSEQAO Offset to the start
of the statistics sets
8 (4) ADDRESS 4 SSGSEFWP Pointer to next queue
element, when zero end
of queue
Orientation to device that status pertain
==============================================================
12 (C) CHARACTER 6 SSGSEVOL Volume serial of device
that stat where read
from
18 (12) CHARACTER 2 SSGSEDEV Device number of device
that Status where read
from
20 (14) CHARACTER 2 SSGSESCX Subsystem ID
22 (16) CHARACTER 2 * not used
24 (18) UNSIGNED 4 SSGSETTL Total SE VOL Count,
only valid for head of
buffer queue
28 (1C) CHARACTER 28 SSGSVHDR SE VOL header
28 (1C) UNSIGNED 2 SSGSESZ Size of data
30 (1E) CHARACTER 6 SSGSECUT Control unit type
36 (24) CHARACTER 3 SSGSECUM Control unit model
39 (27) CHARACTER 3 SSGSECUC Control unit maker /
company
42 (2A) CHARACTER 2 SSGSECUP Control unit plant
44 (2C) CHARACTER 12 SSGSESEQ Control unit sequence
number
56 (38) CHARACTER 28 SSGSEDAD SE Vol statistics
56 (38) BITSTRING 1 SSGSEFLG Flag byte 1
1... .... SSGSEVF ON=SE Vol
.1.. .... SSGSEAN Space currently
allocated is
not available
57 (39) CHARACTER 1 * not used
58 (3A) UNSIGNED 2 SSGSEEP Extent Pool ID
The following two fields are a remaining percentage of
usable space that will initiate a notification to the host
==============================================================
60 (3C) UNSIGNED 1 SSGSECWW Capacity warning
watermark
61 (3D) UNSIGNED 1 SSGSEGWW Guarantee warning
watermark
62 (3E) CHARACTER 2 * not used
The following fields are expressed in number of
cylinders for CKD device. The following fields are
expressed in TENTH of binary Gigabytes for Fix Block
device.
==============================================================
64 (40) UNSIGNED 4 SSGSEC SE Volume capacity
limit. This field is
always zero.
68 (44) UNSIGNED 4 SSGSEG SE Volume guarantee
capacity. This field
is always zero.
72 (48) UNSIGNED 4 SSGSESCA Space currently
consumed
76 (4C) UNSIGNED 4 SSGSEEPR Size of Repository
volume in Extent Pool
80 (50) UNSIGNED 4 SSGSECAP SE Volume capacity
MAPPING FOR THE EXTENT POOL CONFIGURATION STATUS
OUTPUT BUFFER
Output buffer is a queue, anchored by SSGEPOAR, of Extent
Pool Configuration status. Each queue element represents
the status of the Extent Pools defined in Storage Facility
image. If the caller provide a Extent Pool ID ( SSGEPID
has value between '0'X and 'FFFE'X ), then in addition to
the summary status of Extent Pool, the detail status of
that Extent Pool identified by Extent Pool ID is reported.
Caller is responsible for freeing the output buffer.
The flag and variable combinations for EPC status is
shown as below railroad chart.
Below variable defines scope
>>__SSGEPC__ _SSGEPID=('FFFF'X)________________________>(A)
|_SSGEPID=('0'X to 'FFFE'X of even number)_>(B)
|_SSGEPID=('1'X to 'FFFD'X of odd number)__>(C)
(A)>______________________________ ______________________>
(B)>_(Even LSS I/O dev follows)_ _|
(C)>_(Odd LSS I/O dev follows)__|
Following variable and flag represent I/O device
>______ _SSGAVOL__SSGUNIT__ ______________________________><
|_SSGADDN___________|
|_SSGAVOL__SSGOFFL__|
MAPPING FOR THE EXTENT POOL CONFIGURATION STATUS OUTPUT BUFFER
====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE * SSGEPBUF
0 (0) CHARACTER 36 SSGEHDR Queue element header
0 (0) UNSIGNED 4 SSGEPQAL Length of this queue
element,
header plus data
4 (4) UNSIGNED 4 SSGEPQAO Offset to the start of
the statistics sets
8 (8) UNSIGNED 4 SSGEPFWD Pointer to next queue
element,
when zero end of queue
Orientation to device that stats pertain
==============================================================
12 (C) CHARACTER 6 SSGEPVOL Volume serial of device
that status where read
from
18 (12) CHARACTER 2 SSGEPDEV Device number of device
that tats where read from
20 (14) UNSIGNED 2 SSGEPIDC Ext Pool ID provided by
caller
22 (16) CHARACTER 6 * Reserved
28 (1C) ADDRESS 4 SSGEPSIP Internal code use only.
Branch Entry caller shall
set zero.
32 (20) UNSIGNED 2 SSGEPSDO Offset to 1st Summary data
(SSGEPSUM) array
34 (22) UNSIGNED 2 SSGEPDDO Offset to Detail data
(SSGEPDAT)
36 (24) CHARACTER * SSGEPDAD Ext Pool Config status
36 (24) CHARACTER 32 SSGEPDHL Fixed length of epc data
header
36 (24) UNSIGNED 2 SSGEPLEN Length of data returned
38 (26) UNSIGNED 2 SSGEPCNT Count of Extent Pools
40 (28) BITSTRING 2 SSGEPFL1 Extent Pool Flags
1... .... SSGEPIDV Ext Pool detailed data
valid
.1.. .... SSGEPLSS 0 = odd LSS 1 = even LSS
..1. .... SSGEPCC No EPC status data is
available. Following
2 cases cause no EPC
data.
When Ext Pool ID specified
in even number, EPC
status request was sent
to the device in the odd
numbered LSS.
When Ext Pool ID specified
in odd number, EPC status
request was sent to the
device in the even
numbered LSS.
42 (2A) CHARACTER 6 SSGEPCUT Control unit type
48 (30) CHARACTER 3 SSGEPCUM Control unit model
51 (33) CHARACTER 3 SSGEPCUC Control unit maker/company
54 (36) CHARACTER 2 SSGEPCUP Control unit plant
56 (38) CHARACTER 12 SSGEPSEQ Control unit sequence
number
The format of the next eight bytes is repeated the number
times as indicated by SSGEPCNT.
==============================================================
68 (44) CHARACTER 8 SSGEPSUM Ext Pool summary data
68 (44) CHARACTER 2 SSGEPIDS Extent Pool ID
The following two fields are a remaining percentage of
usable space that will initiate a notification to the host
==============================================================
70 (46) UNSIGNED 1 SSGEPRWP Ext Pool Repository full
warning percentage
71 (47) UNSIGNED 1 SSGEPFWP Ext Pool Full warning
percentage
72 (48) BITSTRING 2 SSGEPFLG Ext Pool flags
1... .... SSGEPFB 0=CKD Ext Pool,
1=FB Ext Pool
.1.. .... SSGEPRC Ext Pool repository
configured
..1. .... SSGEOPV Over Provisioned volumes
in Ext pool
...1 .... * not used
.... 1... * not used
.... .1.. SSGEPWP Ext Pool at warning
percentage
.... ..1. SSGEPF Ext Pool full
74 (4A) CHARACTER 2 * not used
The following fields contain detailed Extent Pool
configuration information for Extent Pool identified
by Ext Pool ID specified by caller. The address of SSGEPDAT is
the sum of SSGEPOAR and SSGEPDDO.
===================================================================================
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
OFFSET OFFSET
======== ======== ========= ======== ============== ===============================
0 (0) CHARACTER 12316 SSGEPDAT
0 (0) CHARACTER 2 SSGEPIDD Ext Pool ID for detailed
data
2 (2) BITSTRING 1 SSGEPDFG Extent Pool Detailed Flags
1... .... SSGEPARN Allocated Space in
Repository is not
available
.1.. .... SSGEPRAW Repository at warning
percent
..1. .... SSGEPRF Repository full
3 (3) CHARACTER 1 * not used
The following fields are expressed in number of cylinders
for CKD device. The following fields are expressed
in TENTH of binary Gigabytes for Fix Block device.
==============================================================
4 (4) UNSIGNED 4 SSGEPSZ Ext Pool size
8 (8) UNSIGNED 4 SSGEALOC Space currently allocated
in Ext Pool
12 (C) UNSIGNED 4 SSGEPRSZ Size of Ext Pool
Repository, this set
to 0 when SSGEPRC=0
16 (10) UNSIGNED 4 SSGEPRAL Space currently allocated
in Ext Pool Repository,
set to 0 when SSGEPRC=0
20 (14) UNSIGNED 4 SSGEPGSZ Amount of guaranteed
space in Repository.
Set to 0 when SSGEPRC=0
24 (18) CHARACTER 4 * not used
The next three fields are 32k bitmaps
==============================================================
28 (1C) BITSTRING 4096 SSGENORM Normally provisioned
volumes
4124 (101C) BITSTRING 4096 SSGEPOPV Over provisioned volumes
8220 (201C) BITSTRING 4096 SSGEPSEV Space Efficient volumes
MAPPING FOR THE DEVICE PERFORMANCE STATISTICS
OUTPUT BUFFER
Output buffer is anchored by SSGOADR, of a device performance
statistics output table. Output buffer needs to be freed
by the caller of this interface. Output buffer is built
for a device that supports device performance statistics and
returned only if requested by caller for performance data
(SSGRPD) for a request with scope of of device (SSGDEV).
The parameter list extension must also be passed as
indicated with SSGARGL2.
====================================================================================
OFFSET OFFSET
DECIMAL HEX TYPE LENGTH NAME (DIM) DESCRIPTION
======== ======== ========= ======== ============== ===============================
0 (0) STRUCTURE 256 SSGDPBUF DEVICE PERFORMANCE
STATISTICS OUTPUT BUFFER
0 (0) CHARACTER 6 SSGDPVOL VOLUME SERIAL
6 (6) BITSTRING 1 SSGDPFLG
1... .... SSGDP_UA_FLAG 'ONE' UNIT ADDR FORMAT
.1.. .... SSGDP_FND_STG2 2ND STG DIR PATH FND
SS01 TO LA01 IDCSS01
PASSED TO IDCLA01
..11 1111 * RESERVED
7 (7) CHARACTER 1 SS
GDPCUI Real CUID for data
in ssgdada
8 (8) CHARACTER 4 SSGDPUA1 FIRST UNIT ADDRESS
12 (C) CHARACTER 2 SSGDPUB1 FIRST UNIT ADDRESS
(BINARY)
14 (E) SIGNED 2 SSGDPLN DATA LENGTH
16 (10) CHARACTER 192 SSGDPDA DEVICE PERFORMANCE
STATISTICS DATA AREA
16 (10) BITSTRING 1 SSGDPFTF
1... .... SSGDPNAV Bit =1 : Cache Storage
unavailable (Set to zero
for 2107/1750)
.111 .... SSGDPPDR Mask bits for Format of
Perf Data Returned
Value after masking
( SSGDPFTF & SSGDPPDR )
'000'b 3990 Format
'001'b 2107/1750 Format
.... 1111 SSGDPFDR Mask bits for Format of
data returned.
The same definition and
values of bit 4-7 of
byte 0 from Sense
Subsystem status.
17 (11) CHARACTER 1 SSGDPDUA Device Unit Address of
the device to which the
statistics pertain
18 (12) CHARACTER 2 SSGDPDST Device Status. The same
as Sense Subsystem
Status in bytes 26-27
20 (14) UNSIGNED 4 SSGDPRNI Search/Read Normal I/O
Requests. The number of
command chains which meet
the following requirements.
- The chain is not part of
a sequential operation.
- The chain did not include
a Define Extent command
which specified Cache
Fast Write Data.
- The chain contained at
least one search or read
command but no write
commands.
24 (18) UNSIGNED 4 SSGDPRNH Search/Read Normal I/O
Request Hits. The number of
command chains which meet
the following requirements.
- The chain is not part of
a sequential operation.
- The chain did not include
a Define Extent command
which specified Cache Fast
Write Data.
- The chain contained at
least one search or read
command but no write
commands.
- The chain was completed
without requiring access
to any DDM.
28 (1C) UNSIGNED 4 SSGDPWNI Write Normal I/O Requests.
The number of command chains
which meet the following
requirements.
- The chain is not part of
a sequential operation.
- The chain did not include
a Define Extent command
which specified Cache
Fast Write Data.
- The chain contained at
least one write command.
32 (20) UNSIGNED 4 SSGDPFWH DASD Fast Write I/O Request
Hits. The number of command
chains which meet the
following requirements.
- The chain is not part of
a sequential operation.
- The chain did not include
a Define Extent command
which specified Cache Fast
Write Data.
- The chain contained at
least one write command.
- The chain was completed
without requiring access
to any DDM.
36 (24) UNSIGNED 4 SSGDPRSI Search/Read Sequential I/O
Requests. The number of
sequential mode command
chains which meet the
following requirements.
- The chain contained at
least one search or read
command but no write
commands.
40 (28) UNSIGNED 4 SSGDPRSH Search/Read Sequential I/O
Request Hits. The number of
sequential mode command
chains which meet the
following requirements.
- The chain contained at
least one search or read
command but no write
commands.
- The chain was completed
without requiring access
to any DDM.
44 (2C) UNSIGNED 4 SSGDPWSI Write Sequential I/O
Requests. The number of
sequential mode command
chains which meet the
following requirements.
- The chain contained at
least one write command.
48 (30) UNSIGNED 4 SSGDPWSH Fast Write Sequential I/O
Request Hits. The number
sequential write operations
that did not require movement
of data to or from a storage
device before completion of
the I/O operation.
52 (34) UNSIGNED 4 SSGDPRCF Search/Read Cache Fast Write
I/O Requests. The number of
command chains which meet
the following requirements.
- The chain included a Define
Extent command which
specified the Cache Fast
Write Data attribute.
- The chain contained at
least one search or read
command but no write
commands.
- Cache Fast Write Data must
be activated for the
subsystem.
56 (38) UNSIGNED 4 SSGDPRCH Search/Read Cache Fast Write
I/O Request Hits. The number
of command chains which meet
the following requirements.
- The chain included a
Define Extent command
which specified the Cache
Fast Write Data attribute.
- The chain contained at
least one search or read
command but no write
commands.
- Cache Fast Write Data must
be actuated for the
subsystem.
- The chain was completed
without requiring access
to any DDM.
60 (3C) UNSIGNED 4 SSGDPCFW Cache Fast Write I/O
Requests. The number of
command chains which meet
the following requirements.
- The chain included a Define
Extent command which
specified the Cache Fast
Write Data attribute.
- The chain contained at
least one write command.
- Cache Fast Write Data must
be actuated for the
subsystem.
64 (40) UNSIGNED 4 SSGDPCFH Cache Fast Write I/O Request
Hits. The number of command
chains which meet the
following requirements.
- The chain included a Define
Extent command which
specified the Cache Fast
Write Data attribute.
- The chain contained at
least one write command.
- Cache Fast Write Data must
be actuated for the
subsystem.
- The chain was completed
without requiring access
to any DDM.
68 (44) UNSIGNED 4 SSGDPICL Inhibit Cache Loading I/O
Request that operate with
DASD (Set to zeros for
2107/1750)
72 (48) UNSIGNED 4 SSGDPBCI Bypass Cache I/O Requests
(Set to zeros for
2107/1750)
76 (4C) UNSIGNED 4 SSGDPSDC Seq DASD to Cache
Transfer Operations
80 (50) UNSIGNED 4 SSGDPDCC DASD to Cache Transfer
Operation Count
84 (54) UNSIGNED 4 SSGDPCDC Cache to DASD Transfer
Operation Count
88 (58) UNSIGNED 4 SSGDPFWD DASD Fast Write Operation
Delayed Due to
non-volatile storage
Space constraints
92 (5C) UNSIGNED 4 SSGDPNFW Normal 'DASD Fast Write'
Write Operation Counts.
The number of command chains
which meet the following
requirements.
- The chain is not part of
a sequential operation.
- The chain did not include
a Define Extent command
which specified Cache Fast
Write Data.
- The chain contained at
least one write command.
- The chain was completed
without requiring access
to any DDM.
96 (60) UNSIGNED 4 SSGDPSFW Sequential Access 'DASD
Fast Write' Write
Operation Counts
100 (64) UNSIGNED 4 SSGDPNRM Number of record cache
Read misses
104 (68) CHARACTER 1 SSGDPDS2 Device Status - Group 2
The device status,
SSGDPDS2, is identical
to the data returned by
the Sense Subsystem
Status in Byte 36.
Note: The format of the
data in SSGDPDS2 is
determined by the value
in SSGDPFDR.
105 (69) UNSIGNED 4 SSGDPQWP Quick Write Promotes
109 (6D) BITSTRING 1 SSGDPDVD Flag byte
SSGDPDVD describes the
validity of data returned
and the increment values
used for certain counters
1111 .... SSGDPRVA Mask for reserved bits
.... 1... SSGDPZHV When set on, SSGDPZHR and
SSGDPZHW are valid.
......11. SSGDPUNI Mask bits for Units
Value after masking
( SSGDPDVD & SSGDPUNI )
'00'b Unit of SSGDPRRT,
SSGDPWRT,SSGDPBRD,
SSGDPBWR,SSGDPRAT,
and SSGDPWAT is
16 milliseconds.
Unit of SSGDPPBR
SSGDPPBW is
128 KB.
'01'b Reserved
'10'b Reserved
'11'b Reserved
.... ...1 SSGDPBYV 1 indicates SSGDPBRD,
SSGDPBWR, SSGDPRAT, and
SSGDPWAT are valid
110 (6E) CHARACTER 2 SSGDPSID SSID
112 (70) UNSIGNED 4 SSGDPITA Irregular Track Accesses
116 (74) UNSIGNED 4 SSGDPITH Irregular Track Access
Hits
120 (78) UNSIGNED 4 SSGDPODC Operation Delayed Due To
Cache Space Constraints
124 (7C) UNSIGNED 4 SSGDPMSL Milliseconds of lower
interface I/O activity
for the indicated device
(Set to zeros for
2107/1750)
128 (80) BITSTRING 1 SSGDPNVI Non-volume information
contain in the record
Value Definition
0 No Additional Information
1 RAID Rank Information
2 Segment Pool and Physical
Storage Counter information
3-255 Not Defined
129 (81) CHARACTER 1 SSGDPRVB Not used
130 (82) CHARACTER 2 SSGDPSPI Segment Pool ID
132 (84) CHARACTER 1 SSGDPSTY Non-volume information
contained in the record
Segment Type
00-03 Reserved
04 FB 1GB
05-131 Reserved
132 CKD 1GB
133-255 Reserved
133 (85) BITSTRING 1 SSGDPSFL Segment Flags
1... .... SSGDPSF0 Dynamic Segment
Allocation
.1.. .... SSGDPSF1 Data Sharing
..1. .... SSGDPSF2 Migrating/Migration Error
State
134 (86) CHARACTER 2 * Not used
136 (88) UNSIGNED 4 SSGDPPRO Physical Storage Read
Operations
140 (8C) UNSIGNED 4 SSGDPPWO Physical Storage Write
Operations
144 (90) UNSIGNED 4 SSGDPPBR Physical Storage Bytes
Read. See Increment Value
in SSGDPDVD
148 (94) UNSIGNED 4 SSGDPPBW Physical Storage Bytes
Written. See Increment
Value in SSGDPDVD
152 (98) UNSIGNED 4 SSGDPRMR Record Mode Read
Operations
156 (9C) UNSIGNED 4 SSGDPNTR Number of tracks read
from the concurrent Copy
or XRC Sidefile
160 (A0) UNSIGNED 4 SSGDPNCW Number of contaminating
writes for a Concurrent Copy
or XRC volume as a result of:
- Update to a Concurrent Copy
protected track.
- Update to an XRC monitored
track.
164 (A4) UNSIGNED 4 SSGDPTTS Number of tracks or
portion of tracks that
were transferred to
the secondary device of
a PPRC pair
168 (A8) UNSIGNED 4 SSGDPNSA NVS Space Allocations
172 (AC) UNSIGNED 4 SSGDPRRT Physical Storage Read
Response Time. See
Increment Value in
SSGDPDVD
176 (B0) UNSIGNED 4 SSGDPWRT Physical Storage Write
Response Time. See
Increment Value in
SSGDPDVD
180 (B4) UNSIGNED 4 SSGDPBRD Bytes Read. See Increment
Value in SSGDPDVD
184 (B8) UNSIGNED 4 SSGDPBWR Bytes Written. See
Increment Value in
SSGDPDVD
188 (BC) UNSIGNED 4 SSGDPRAT Read Accumulated Time.
The accumulated response
time for all read
operations.
See Increment Value in
SSGDPDVD
192 (C0) UNSIGNED 4 SSGDPWAT Write Accumulated Time.
The accumulated response
time for all write
operations. See Increment
Value in SSGDPDVD
196 (C4) UNSIGNED 4 SSGDPZHR zHPF Read I/O Requests. This
count is the number of Transport
Mode read command chains. The
Read I/O Request will also be
counted in one of the following
counters:
- SSGDPRNI, Search/Read Normal
I/O Requests
- SSGDPRSI, Search/Read
Sequential I/O Requests
- SSGDPRCF, Search/Read Cache
Fast Write I/O Requests
200 (C8) UNSIGNED 4 SSGDPZHW zHPF Write I/O Requests. This
count is the number of Transport
Mode write command chains. The
Write I/O Request will also be
counted in one of the following
counters:
- SSGDPWNI, Write Normal I/O
Requests
- SSGDPWSI, Write Sequential I/O
Requests
- SSGDPCFW, Cache Fast Write I/O
Requests
204 (CC) CHARACTER 4 SSGDPRVX Not used - zeros
208 (D0) UNSIGNED 4 SSGDPZHL zHPF List Pre-fetch I/O
Requests. This count is the
number of command chains which
meet the following requirements:
- The Transport Mode operation
specified a non-zero Imbedded
Locate Record Count.
212 (D4) UNSIGNED 4 SSGDPZHH zHPF List Pre-fetch I/O Requests
Hits. This count is the number
of common chains which meet the
following requirements:
- The Transport Mode operation
specified a non-zero Imbedded
Locate Record Count.
- The chain was completed
without requiring access to
any DDM.
216 (D8) UNSIGNED 4 SSGDPGSF Global Mirror Collisions
Sidefile Count. A GM collision
occurs when, during the sending
of data to the secondary to
create a consistency group, a
subsequent host update is
attempted before the modified
track has been transmitted to
the secondary volume. The
modified track will be moved
to the sidefile before allowing
a new host write. This counter
will be incremented by one when
a track is added to the
sidefile.
220 (DC) UNSIGNED 4 SSGDPGSS Global Mirror Collisions Send
Synchronous Count. When a
write collision occurs, the
modified track data which
belongs to the current
consistency group may be sent
to the remote control unit
before allowing the write. The
data may come from the
sidefile if it is full or from
cache if the collision
sidefile is not being
utilized.
224 (E0) CHARACTER 32 SSGDPRVY Not used - zeros
RETURN CODES FROM IDCSS01
====================================================================================
LEN TYPE VALUE NAME DESCRIPTION
===== ========= ================= =============== ===============================
2 NUMB HEX 0000 SS01CC00 SUCCESSFUL COMPLETION
2 NUMB HEX 0004 SS01CC04 GETMAIN FAILED
2 NUMB HEX 0008 SS01CC08 I/O ERROR OCCURRED
2 NUMB HEX 000C SS01CC12 VOLUME NOT FOUND
2 NUMB HEX 0010 SS01CC16 ESTAE FAILED
2 NUMB HEX 0014 SS01CC20 LRA INSTRUCTION FAILED
2 NUMB HEX 0018 SS01CC24 BUFFER NOT LARGE ENOUGH
2 NUMB HEX 001C SS01CC28 FILE NOT IN TIOT
2 NUMB HEX 0020 SS01CC32 VOLUME NOT FOUND ALL
2 NUMB HEX 0024 SS01CC36 NO PATH(S) TO SD(S)
2 NUMB HEX 0028 SS01CC40 NO ONLINE PATH FROM IOS
2 NUMB HEX 002C SS01CC44 REQUEST NOT SUPPORTED
2 NUMB HEX 0030 SS01CC48 WARNING MSG ISSUED
2 NUMB HEX 0034 SS01CC52 ERROR MSG ISSUED
2 NUMB HEX 0038 SS01CC56 SERIOUS ERROR MSG
2 NUMB HEX 003C SS01CC60 I/O timeout occured
2 NUMB HEX 0040 SS01CC64 Reserved
2 NUMB HEX 0044 SS01CC68 RESERVED
2 NUMB HEX 0046 SS01CC70 IOSCDR ERROR
2 NUMB HEX 0047 SS01CC71 UCBINFO ERROR
2 NUMB HEX 0048 SS01CC72 RESERVED
2 NUMB HEX 0049 SS01CC73 MISSING CDR INFOR
2 NUMB HEX 004A SS01CC74 ERR DURING CDR INFOR
GATHERING.
2 NUMB HEX 0063 SS01CC99 RESERVED
REASON CODES FROM ESS (BOX) PERFORMANCE STATISTICS
(SSGLPRET, SSGRSRET, SSGSGRET).
====================================================================================
LEN TYPE VALUE NAME DESCRIPTION
===== ========= ================= =============== ===============================
1 NUMB HEX 01 SS01LP01 Stats requested, all stats
returned on supporting
subsystem boxes
1 NUMB HEX 02 SS01LP02 Stats not requested by the
caller
1 NUMB HEX 03 SS01LP03 Stats requested, but no
supporting subsystem boxes
found to support them
1 NUMB HEX 04 SS01LP04 Stats requested, but stats
from one or more supporting
subsystem boxes could not be
read
|