Open List of ASPs (QYASPOL) API
Required Parameter Group:
| 1 |
Receiver variable |
Output |
Char(*) |
| 2 |
Length of receiver variable |
Input |
Binary(4) |
| 3 |
List information |
Output |
Char(80) |
| 4 |
Number of records to return |
Input |
Binary(4) |
| 5 |
Number of filters |
Input |
Binary(4) |
| 6 |
Filter information |
Input |
Char(*) |
| 7 |
Format name |
Input |
Char(8) |
| 8 |
Error Code |
I/O |
Char(*) |
Optional Parameter:
| 9 |
Sort information |
Input |
Char(*) |
Default Public Authority: *USE
Threadsafe: No
The Open List of ASPs (QYASPOL) API generates a list of ASPs or
information about an ASP. This can be any of the following:
- Identification of all ASPs configured to a system
- Attributes of an ASP
- Unassigned disk units or disk units assigned to an ASP
- Hardware problems during varyon of an independent ASP.
- Current varyon activity.
- Jobs using an independent ASP.
On successful completion of this API, a handle is returned in the list
information parameter. You may use this handle on subsequent calls to the
following APIs:
- Get List Entries (QGYGTLE)
- Close List (QGYCLST)
Authorities and Locks
None.
Required Parameter Group
- Receiver variable
- OUTPUT; CHAR(*)
The receiver variable that receives the information requested. You can
specify the size of the area to be smaller than the format requested as long as
you specify the length parameter correctly. As a result, the API returns only
the data the area can hold.
- Length of receiver variable
- INPUT; BINARY(4)
The length of the receiver variable provided. The length of the receiver
variable parameter may be specified up to the size of the receiver variable
specified in the user program. If the length of receiver variable parameter
specified is larger than the allocated size of the receiver variable specified
in the user program, the results are not predictable.
- List information
- OUTPUT; CHAR(80)
The variable used to return status information about the list of opened
ASPs. For a description of the layout of this parameter, see
Format of Open List Information.
- Number of records to return
- INPUT; BINARY(4)
The number of records in the list to put into the receiver variable after
filtering has been done. The valid values for this field are as follows:
| -1 |
All records are built synchronously in the list
by the main job. |
| 0 |
All records are built asynchronously in the list
by a server job. |
| records-to-return |
If a positive number of records is specified, at
least that many records are built synchronously (in order to return those
records immediately to the caller of this API) and the remainder are built
asynchronously by a server job. |
- Number of filters
- INPUT; BINARY(4)
The number of filters provided in the filter information.
- Filter information
- INPUT; CHAR(*)
The information in this parameter is used to determine which ASPs to include
in the list. See Format of Filter Information for a
description of the layout of this parameter.
- Format name
- INPUT; CHAR(8)
The format of the ASP information being returned. You must specify one of
the following:
| YASP0100 |
Identification of the ASPs configured to a
system. This includes the system ASP and all user ASPs. The list is sorted by
ASP number. For more information about the YASP0100 format, see YASP0100 Format. |
| YASP0200 |
The basic attributes of the ASP. For more
information about the YASP0200 format, see YASP0200
Format. |
| YASP0300 |
The disk units assigned to the ASP.
Records of this format are returned only if the disk units are owned by
the system. Disk units that have been switched to another system are
not owned and will not have YASP0300 format records returned.
For more information about the YASP0300 format,
see YASP0300 Format. |
| YASP0400 |
The hardware error information related to use of
an ASP. Records of this format are returned only if the ASP is an independent
ASP and if any errors were detected. For more information about the YASP0400
format, see YASP0400 Format. |
| YASP0500 |
The progress status related to use of an ASP. A
record of this format is returned only if the ASP is an independent ASP. For
more information about the YASP0500 format, see YASP0500
Format. |
| YASP0600 |
Identification of the jobs and their threads currently
using an ASP. Records of this format are returned only if the ASP is an independent ASP.
An entry will be returned for each thread in the job that is using the ASP.
For more information about the
YASP0600 format, see YASP0600 Format. |
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the
structure, see Error Code Parameter.
Optional Parameter
- Sort information
- INPUT; CHAR(*)
Information on which fields within the record of information to sort. See Format of Sort Information for a description of the
layout of this parameter. If this parameter is omitted, no sorting is done.
The following tables describe the order and format of the data that is
returned in the receiver variable.
| Offset |
Type |
Field |
| Dec |
Hex |
| 0 |
0 |
BINARY(4) |
ASP number |
| 4 |
4 |
CHAR(10) |
Resource name |
| 14 |
E |
CHAR(10) |
Device description name |
| 24 |
18 |
BINARY(4) |
Version |
| 28 |
1C |
BINARY(4) |
ASP usage |
| 32 |
20 |
BINARY(4) |
ASP status |
| 36 |
24 |
CHAR(18) |
Database name |
| 54 |
36 |
CHAR(10) |
Primary ASP resource name |
| Offset |
Type |
Field |
| Dec |
Hex |
| 0 |
0 |
BINARY(4) |
ASP number |
| 4 |
4 |
BINARY(4) |
Number of disk units |
| 8 |
8 |
BINARY(4) |
ASP capacity - total |
| 12 |
C |
BINARY(4) |
ASP capacity available - total |
| 16 |
10 |
BINARY(4) |
ASP capacity - protected |
| 20 |
14 |
BINARY(4) |
ASP capacity available - protected |
| 24 |
18 |
BINARY(4) |
ASP capacity - unprotected |
| 28 |
1C |
BINARY(4) |
ASP capacity available - unprotected |
| 32 |
20 |
BINARY(4) |
ASP system storage |
| 36 |
24 |
BINARY(4) |
Overflow storage |
| 40 |
28 |
BINARY(4) |
Space allocated to the error log |
| 44 |
2C |
BINARY(4) |
Space allocated to the machine log |
| 48 |
30 |
BINARY(4) |
Space allocated to the machine trace |
| 52 |
34 |
BINARY(4) |
Space allocated for main storage dump |
| 56 |
38 |
BINARY(4) |
Space allocated to the microcode |
| 60 |
3C |
BINARY(4) |
Storage threshold percentage |
| 64 |
40 |
CHAR(2) |
ASP type |
| 66 |
42 |
CHAR(1) |
Overflow recovery result |
| 67 |
43 |
CHAR(1) |
End immediate control |
| 68 |
44 |
CHAR(1) |
Compression recovery policy |
| 69 |
45 |
CHAR(1) |
Compressed disk units in ASP |
| 70 |
46 |
CHAR(1) |
Balance status |
| 71 |
47 |
CHAR(1) |
Balance type |
| 72 |
48 |
CHAR(13) |
Balance date and time |
| 85 |
55 |
CHAR(3) |
Reserved |
| 88 |
58 |
BINARY(4) |
Balance data moved |
| 92 |
5C |
BINARY(4) |
Balance data remaining |
| 96 |
60 |
BINARY(4) |
Trace duration |
| 100 |
64 |
CHAR(1) |
Trace status |
| 101 |
65 |
CHAR(13) |
Trace date and time |
| 114 |
72 |
CHAR(1) |
Changes written to disk |
| 115 |
73 |
CHAR(1) |
Reserved |
| 116 |
74 |
BINARY(4) |
Number of multiple connection disk units |
| 120 |
78 |
BINARY(4) |
Geographic mirror role |
| 124 |
7C |
BINARY(4) |
Geographic mirror copy state |
| 128 |
80 |
BINARY(4) |
Geographic mirror copy data state |
| Offset |
Type |
Field |
| Dec |
Hex |
| 0 |
0 |
BINARY(4) |
ASP number |
| 4 |
4 |
CHAR(4) |
Disk type |
| 8 |
8 |
CHAR(4) |
Disk model |
| 12 |
C |
CHAR(10) |
Disk serial number |
| 22 |
16 |
CHAR(10) |
Resource name |
| 32 |
20 |
BINARY(4) |
Disk unit number |
| 36 |
24 |
BINARY(4) |
Disk capacity |
| 40 |
28 |
BINARY(4) |
Disk storage available |
| 44 |
2C |
BINARY(4) |
Disk storage reserved for system |
| 48 |
30 |
CHAR(1) |
Mirrored unit protected |
| 49 |
31 |
CHAR(1) |
Mirrored unit reported |
| 50 |
32 |
CHAR(1) |
Mirrored unit status |
| 51 |
33 |
CHAR(1) |
Reserved |
| 52 |
34 |
BINARY(4) |
Unit control |
| 56 |
38 |
BINARY(4) |
Blocks transferred to main storage |
| 60 |
3C |
BINARY(4) |
Blocks transferred from main storage |
| 64 |
40 |
BINARY(4) |
Requests for data transfer to main storage |
| 68 |
44 |
BINARY(4) |
Requests for data transfer from main storage |
| 72 |
48 |
BINARY(4) |
Permanent blocks transferred from main
storage |
| 76 |
4C |
BINARY(4) |
Requests for permanent data transfer from main
storage |
| 80 |
50 |
BINARY(4) |
Sample count |
| 84 |
64 |
BINARY(4) |
Not busy count |
| 88 |
68 |
CHAR(1) |
Compression status |
| 89 |
69 |
CHAR(1) |
Disk protection type |
| 90 |
6A |
CHAR(1) |
Compressed unit |
| 91 |
6B |
CHAR(1) |
Storage allocation restricted unit |
| 92 |
6C |
CHAR(1) |
Availability parity set unit |
| 93 |
6D |
CHAR(1) |
Multiple connection unit |
| Offset |
Type |
Field |
| Dec |
Hex |
| 0 |
0 |
BINARY(4) |
ASP number |
| 4 |
4 |
CHAR(4) |
Error code |
| 8 |
8 |
BINARY(4) |
Disk unit number |
| 12 |
C |
CHAR(1) |
Mirrored unit identifier |
| Offset |
Type |
Field |
| Dec |
Hex |
| 0 |
0 |
BINARY(4) |
ASP number |
| 4 |
4 |
CHAR(2) |
Transition target |
| 6 |
6 |
CHAR(2) |
Reserved |
| 8 |
8 |
CHAR(16) |
Function |
| 24 |
18 |
BINARY(4) |
Current count |
| 28 |
1C |
BINARY(4) |
Total count |
| 32 |
20 |
BINARY(4) |
Current item count |
| 36 |
24 |
BINARY(4) |
Total item count |
| 40 |
28 |
CHAR(6) |
Elapsed time |
| Offset |
Type |
Field |
| Dec |
Hex |
| 0 |
0 |
BINARY(4) |
ASP number |
| 4 |
4 |
BINARY(4) |
Use identification |
| 8 |
8 |
CHAR(10) |
Job name |
| 18 |
12 |
CHAR(10) |
Job user name |
| 28 |
1C |
CHAR(6) |
Job number |
| 34 |
22 |
CHAR(2) |
Reserved |
| 36 |
24 |
CHAR(8) |
Thread identifier |
| 44 |
2C |
UNSIGNED BINARY(4) |
Thread handle |
| 48 |
30 |
CHAR(4) |
Thread status |
Note: Megabytes, as used in this topic, means millions of
bytes.
ASP capacity - protected. The total number of used and
unused megabytes in the ASP that are protected by mirroring or device parity. A
special value of -2 is returned if the size of this field is exceeded.
ASP capacity available - protected. The number of unused
megabytes in the ASP that are protected by mirroring or device parity. A
special value of -2 is returned if the size of this field is exceeded.
ASP capacity - total. The total number of used and unused
megabytes in the ASP. A special value of -2 is returned if the size of this
field is exceeded.
ASP capacity available - total. The total number of unused
megabytes in the ASP. A special value of -2 is returned if the size of this
field is exceeded.
ASP capacity - unprotected. The total number of used and
unused megabytes in the ASP that are not protected by mirroring or device
parity. A special value of -2 is returned if the size of this field is
exceeded.
ASP capacity available - unprotected. The number of unused
megabytes in the ASP that are not protected by mirroring or device parity. A
special value of -2 is returned if the size of this field is exceeded.
ASP number. A unique identifier for an auxiliary storage
pool.
Possible values are 1 through 255.
ASP status.
The device configuration status of an auxiliary storage pool. The possible ASP
status values are:
| 0 |
There is no status. This value is used for the
system ASP and any basic user ASPs. |
| 1 |
The status of the ASP is varyoff. |
| 2 |
The status of the ASP is varyon. |
| 3 |
The status of the ASP is active. |
| 4 |
The status of the ASP is available. |
ASP system storage. The amount of storage in megabytes
currently allocated in the ASP for system use.
ASP type. The type of ASP. The possible ASP types are:
| 00 |
The ASP is the system ASP. |
| 10 |
The ASP is a user ASP that does not contain
libraries. |
| 11 |
The ASP is a user ASP that does contain
libraries. |
ASP usage.
The use that is assigned to the auxiliary storage pool. The possible ASP usage
values are:
| 0 |
The usage attribute does not apply or is not
known. This value is used for the system ASP, any basic user ASPs and any
independent ASPs whose use cannot be determined (eg, one whose disk drives are
not powered on). |
| 1 |
The ASP is a user-defined file system ASP. |
| 2 |
The ASP is a primary ASP. |
| 3 |
The ASP is a secondary ASP. |
Availability parity set unit. An indicator of whether a disk
unit is in an availability parity set.
| 0 |
The disk unit is not in an availability parity
set. |
| 1 |
The disk unit is in an availability parity
set. |
Balance data moved. The number of megabytes that have been
moved by the balance function. A special value of -2 is returned if the size of
this field is exceeded.
If the ASP status is neither ACTIVE nor AVAILABLE, 0 is returned.
Balance data remaining. The number of megabytes that remain
to be moved by the balance function before the move is considered complete. A
special value of -2 is returned if the size of this field is exceeded.
If the ASP status is neither ACTIVE nor AVAILABLE, 0 is returned.
Balance date and time. The date and time of the last status
change for the balance function.
This field is valid for an IASP if its status is either ACTIVE or AVAILABLE,
otherwise hexadecimal zeros are returned.
The 13 characters are:
| 1 |
Century, where 0 indicates years 19xx and 1
indicates years 20xx. |
| 2-7 |
The date, in YYMMDD (year, month, day)
format. |
| 8-13 |
The time of day, in HHMMSS (hours, minutes,
seconds) format. |
Balance status. The current status of the balance function
for this ASP.
This field is valid for an IASP if its status is either ACTIVE or AVAILABLE,
otherwise hexadecimal zeros are returned.
The following special values are returned:
| 0 |
No balance activity has occurred for this
ASP. |
| 1 |
The ASP balance function is currently running for
this ASP. |
| 2 |
The ASP balance function is currently in the
process of ending. Either the time limit has run out or the End ASP Balance
(ENDASPBAL) command was issued for this ASP. |
| 3 |
The ASP balance function has run, but was ended
before the ASP was completely balanced. The Start ASP Balance (STRASPBAL)
command can be used to restart the balance function. |
| 4 |
The ASP balance function has completed running.
The ASP is completely balanced. |
Balance type. The type of balance activity that is
currently running or was done last.
This field is valid for an IASP if its status is either ACTIVE or AVAILABLE,
otherwise hexadecimal zeros are returned.
The possible types of ASP balancing are:
| 0 |
No ASP balance activity was requested for the
ASP. |
| 1 |
Capacity balancing to redistribute data so that
the percentage of disk space used is the same on all disk units within the
ASP. |
| 2 |
Usage balancing to redistribute data so that the
percentage of disk activity is the same on all disk units within the ASP.
High-use and low-use data is identified by running the Trace ASP Balance
(TRCASPBAL) command. Usage balancing moves data among the disk units, guided by
the trace results, in an attempt to equalize the utilizations. |
| 3 |
The Heirarchical Storage Management (HSM) balance
can be run only on an ASP that contains a mixture of high-performance and
low-performance disk units. An example of low-performance disk units is
compressed disk units. The HSM balance function moves high-use data to
high-performance units and moves low-use data to low-performance units. The
high-use and low-use data is identified by running the Trace ASP Balance
(TRCASPBAL) command. |
Blocks transferred from main storage. The number of
512-byte blocks transferred to the disk unit since the last IPL. This value
wraps around to zero and continues counting in the case of an overflow of the
field with no indication of the overflow having occurred.
Blocks transferred to main storage. The number of 512-byte
blocks transferred from the disk unit since the last IPL. This value wraps
around to zero and continues counting in the case of an overflow of the field
with no indication of the overflow having occurred.
Changes written to disk. An indicator of whether all
changes made the previous time the IASP was online were written to disk.
Varyoff processing attempts to write changed IASP storage but, in some failures,
it may not be successful.
| 0 |
Not all changes were written. |
| 1 |
All changes were written. |
Compressed disk units in ASP. Whether there are compressed
disk units in the ASP. The following special values are returned:
| 0 |
No compressed disk units in this ASP. |
| 1 |
Compressed and uncompressed disk units in this
ASP. |
| 2 |
All disk units in this ASP are compressed. |
Compressed unit. The compression attribute of the disk unit.
| 0 |
Data on the disk unit is not compressed. |
| 1 |
Data on the disk unit is compressed. |
Compression recovery policy. The compression recovery
policy for the ASP. If the ASP has compressed drives as part of its
configuration, this value controls how overflow situations are handled for this
ASP. The following policies allow the user to control what is done when the ASP
appears full. For more information about the compression recovery policy, see
the Backup and
Recovery
book. The following values
are returned:
| 1 |
When the system detects that the ASP capacity is
about to be exceeded, the system posts system reference code (SRC) A6xx 0277 in
the system control panel and waits for a limited time for space to become
available. If space becomes available before the limited time ends, the SRC is
removed from the system control panel and normal operations resume. If space
does not become available before the limited time ends, data overflows into the
system ASP. |
| 2 |
When the system detects that the ASP capacity is
about to be exceeded, the data immediately overflows into the system ASP. |
| 3 |
When the system detects that the ASP capacity is
about to be exceeded, the system posts SRC A6xx 0277 in the system control
panel and waits indefinitely for space to become available. The user must take
action before normal operation resumes. Possible actions include deleting
objects from the ASP or changing the compression recovery policy to a value
that allows the ASP to overflow. |
Compression status. The current status of compression for
this disk unit. The following values are returned:
| 0 |
Compression for this disk unit is not
active. |
| 1 |
Compression for this disk unit is active. |
Current count. The number of entities that have been
processed by the function. The definition of an entity depends on the function;
it may be an object, an address, a data structure, and so on.
Current item count. The number of items that have been
processed by the function. The definition of an item depends on the
function.
Database name. The name that is assigned to the database that this ASP defines.
If the ASP is neither a primary or secondary ASP, this field consists of
blanks.
Device description name. The name of the device description
that brought the independent ASP to varyon/active state. If the ASP is not an
independent ASP or if it is an independent ASP, but its state is not
varyon/active, this field consists of blanks.
Disk capacity. The total size of the disk unit in
megabytes.
Disk model. The model of the disk unit.
Disk protection type. The type of protection that has been
assigned to this disk unit. The following values are returned:
| 0 |
No storage protection has been set up for this
disk unit. |
| 1 |
This disk unit has been set up with mirrored
protection. |
| 2 |
This disk unit is part of a parity protection
array. |
Disk serial number. The serial number of the disk unit.
Disk storage available. The number of megabytes of space
not currently assigned.
Disk storage reserved for system. The number of megabytes
of auxiliary storage on the disk unit reserved for use by the system. This
storage contains system data related to hardware configuration, hardware error
processing, and so forth.
Disk type. The type of disk unit.
Disk unit number. A unique identifier for each non-mirrored
unit or mirrored pair among the configured disk units. Both mirrored units of a
mirrored pair have the same disk unit number. The value of the disk unit number
is assigned by the system when the disk unit is assigned to the ASP.
Elapsed time. The time that has elapsed since the start
of the function. This value is in the format HHMMSS where HH is the hour,
MM is the minute, and SS is the second.
End immediate control. This field has meaning in the system
ASP (ASP 1) only.
| 0 |
If a request for space in the system ASP cannot
be satisfied because there is not enough storage, the system will be allowed to
continue running. |
| 1 |
If a request for space in the system ASP cannot
be satisfied because there is not enough storage, the system will be ended
immediately. |
Error code. An error code that identifies a hardware
problem related to the use of an independent ASP (error codes are not available
for other ASP types). An error code of less than 1000 is an error. An error
code of 1000 or greater is a warning. The possible error code values
and their descriptions and recovery actions can be found in message file
QSYS/QCPFMSG in these messages: CPDB8E0, CPDB8E1, CPDB8E2 and CPDB8E3.
Function. The function that is currently running as part of
a state transition for an ASP. The possible values are:
| C9FF108000000000 |
Cluster vary job submission. |
| C9FF204000000000 |
Waiting for devices - none are present. |
| C9FF208000000000 |
Waiting for devices - not all are present. |
| C600450A00000000 |
DASD checker running. |
| C600420402000000 |
Storage management recovery. |
| C600420403000000 |
Synchronization of mirrored data. |
| C600420500000000 |
Synchronization of mirrored data. |
| C600426006010000 |
Scanning DASD pages. |
| C600426006020000 |
Directory recovery - processing permanent
directory. |
| C600405500000000 |
Authority recovery. |
| C600405300000000 |
Context rebuild. |
| C600405600000000 |
Journal recovery. |
| C600405700000000 |
Data base recovery. |
| C600405800000000 |
Journal synchronization. |
| C600405900000000 |
Commit recovery. |
| C600406000000000 |
Data base initialization. |
| C600406100000000 |
Journal cleanup. |
| C600406200000000 |
Commit initialization. |
| C9FF408000000000 |
User profile creation. |
| C900297000000000 |
Damage notification and database, journal, commit
(Part 1). |
| C900297300000000 |
Identifying interrupted DDL operations. |
| C900297600000000 |
Recovering system managed journals. |
| C9002AA500000000 |
POSIX directory recovery. |
| C9002AA000000000 |
Database, journal, commit (Part 2). |
| C9002AA300000000 |
Cleaning up cross-reference files. |
| C9002AA200000000 |
Cleaning up journal receivers. |
| C9002AA100000000 |
Commit recovery (Part 2). |
| C9FF808000000000 |
UID/GID mismatch correction. |
| C9002AB000000000 |
Database access path recovery. |
| C9FFB08000000000 |
Database cross-reference file merge. |
| C90029B000000000 |
SPOOL initialization. |
| C9FFA08000000000 |
Command analyzer recovery. |
| C9FFD08000000000 |
Ending jobs using the ASP. |
| C9FFE08000000000 |
Writing changes to disk. |
| 0000000000000000 |
Unidentified activity. |
Geographic mirror copy data state. The condition of the data
on the target.
| 0 |
Geographic mirroring is not configured. |
| 1 |
The remote copy is absolutely in sync with the
production copy. |
| 2 |
The remote copy contains usable data. A detached
mirror copy always has this state. |
| 3 |
There is incoherent data in the mirror copy and
the data cannot be used. |
Geographic mirror copy state. The mirror state of the mirror
copy.
| 0 |
Geographic mirroring is not configured. |
| 1 |
The system attempts to perform geographic mirroring
when the IASP is online. |
| 2 |
The geographic mirroring role is resuming. |
| 3 |
The system is resuming and the IASP is online and
performing synchronization. |
| 4 |
The geographic mirroring mirror copy is detached and
geographic mirroring is not being performed. |
Geographic mirror role. The current role of a physical IASP.
| 0 |
Geographic mirroring is not configured. |
| 1 |
System does not own a physical IASP copy. |
| 2 |
Geographic mirror role is unknown. |
| 196 |
System owns a detached mirror copy. |
| 212 |
System owns the mirror copy. |
| 215 |
System owns the production copy. |
Job name.
The simple job name of the job that is using an ASP.
Job number.
The system-assigned job number of the job that is using an ASP.
Job user name. The user name under which the job that is using an ASP was
started.
Mirrored unit identifier. One of a pair of mirrored units.
The possible values are:
| 0 |
The disk unit is not mirrored or the error does
not relate to a specific disk unit. |
| 1 |
The first half of a mirrored pair. |
| 2 |
The second half of a mirrored pair. |
Mirrored unit protected. The mirrored status of the
mirrored pair of which this unit is a member.
| 0 |
One mirrored unit of a mirrored pair is not
active. |
| 1 |
Both mirrored units of a mirrored pair are
active. |
Mirrored unit reported. This mirrored unit reported
present. Information concerning this unit may or may not be current.
| 0 |
The mirrored unit is missing. Information
concerning the unit may not be current. |
| 1 |
The mirrored unit reported at the time this
information was gathered. The information is current to that point in
time. |
Mirrored unit status. The mirrored status of the unit.
| 1 |
This mirrored unit of a mirrored pair is active
(that is, online with current data). |
| 2 |
This mirrored unit is being synchronized. |
| 3 |
This mirrored unit is suspended. |
Multiple connection unit. A disk unit may have multiple
resource names. Each resource name represents a unique connection to the disk unit.
All active connections are used to communicate with the disk unit.
This attribute indicates whether the disk unit has more than one connection.
| 0 |
The disk unit has only one connection. |
| 1 |
The disk unit has more than one connection. |
Not busy count. The number of times the disk queue was
empty during the same time period that the sample count was taken.
Number of disk units. The total number of disk units in the
ASP. If mirroring is active for disk units within the ASP, the mirrored pair of
units is counted as one.
Number of multiple connection units. The total number of disk
units with multiple connections.
Overflow recovery result. An indicator of the result of the
ASP overflow recovery operation, which is performed during IPL at the user's
request. When this operation is requested, the machine attempts to recover the
user ASP from an overflow condition by moving overflowed auxiliary storage from
the system ASP back to the user ASP during the storage management recovery step
of an IPL.
| 0 |
All overflowed storage was successfully
moved. |
| 1 |
ASP overflow recovery failed due to insufficient
space in the user ASP. |
| 2 |
ASP overflow recovery was cancelled prior to
completion. |
Overflow storage. The number of megabytes of storage that
has overflowed from the user ASP into the system ASP. A special value of -2 is
returned if the size of this field is exceeded.
Permanent blocks transferred from main storage. The number
of 512-byte blocks of permanent storage transferred to the disk unit since the
last IPL. If the field overflows, this value wraps around to zero and continues
counting, with no indication that the overflow condition occurred.
Primary ASP resource name. The resource name of the primary
ASP for a secondary ASP. Only a secondary ASP contains this value.
Requests for data transfer from main storage. The number of
output data transfer requests processed for the disk unit since the last IPL.
If the field overflows, this value wraps around to zero and continues counting,
with no indication that the overflow occurred. This value is not directly
related to the number of blocks transferred for the disk unit because the
number of blocks to be transferred for a given transfer request can vary
greatly.
Requests for data transfer to main storage. The number of
input data transfer requests processed for the disk unit since the last IPL. If
the field overflows, this value wraps around to zero and continues counting,
with no indication that the overflow occurred. This value is not directly
related to the number of blocks transferred for the disk unit because the
number of blocks to be transferred for a given transfer request can vary
greatly.
Requests for permanent data transfer from main storage. The
number of output permanent data transfer requests processed for the disk unit
since the last IPL. If the field overflows, this value wraps around to zero and
continues counting, with no indication that the overflow occurred. This value
is not directly related to the permanent blocks transferred from main storage
for the disk unit because the number of blocks transferred for a given transfer
request can vary greatly.
Reserved. An ignored field.
Resource name. The unique system-assigned name of the disk
unit.
Sample count. The number of times the disk queue was
checked to determine whether or not the queue is empty.
Space allocated for main storage dump. The number of
megabytes of auxiliary storage allocated to the main storage dump space.
Space allocated to the microcode. The number of megabytes
of auxiliary storage allocated to the microcode and space used by the
microcode.
Space allocated to the error log. The number of megabytes
of auxiliary storage allocated to the error log.
Space allocated to the machine log. The number of megabytes
of auxiliary storage allocated to the machine log.
Space allocated to the machine trace. The number of
megabytes of auxiliary storage allocated to the machine trace.
Storage allocation restricted unit. An indicator of whether
new storage allocations are allowed on the disk unit.
| 0 |
The disk unit does not allow new storage
allocations. |
| 1 |
The disk unit allows new storage allocations. |
Storage threshold percentage. When the storage in the ASP
reaches this percentage, a warning message is sent to the QSYSOPR message
queue. When this percentage is reached for the system ASP (ASP 1), message
CPF0907 is sent. When this percentage is reached for one of the user ASPs,
message CPI0953 is sent.
Thread
handle. A value that addresses a particular thread within a job. While
the thread identifier uniquely identifies the thread within the job, the thread
handle can improve performance when referencing the thread.
Thread identifier. A value that uniquely identifies a
thread within a job.
Thread status. The current status of the thread.
Refer to the description of Thread status in
Work Management API Attribute Descriptions for
the possible values that can be returned.
Total count. The total number of entities to be processed
by the function. The definition of an entity depends on the function; it may be
an object, an address, a data structure, and so forth.
Total item count. The total number of items that are to be
processed by the function. An item is a part of an object, but has no precise
definition; that is, items differ by object type if an object type has them at
all.
Trace date and time. The date and time of the last status
change for the trace function. The 13 characters are:
| 1 |
Century, where 0 indicates years 19xx and 1
indicates years 20xx. |
| 2-7 |
The date, in YYMMDD (year, month, day)
format. |
| 8-13 |
The time of day, in HHMMSS (hours, minutes,
seconds) format. |
Trace duration. The number of minutes that the trace
function has run collecting data for this ASP. The trace can be run multiple
times for an ASP.
If the ASP status is neither ACTIVE nor AVAILABLE, zero is returned.
Trace status. The current status of the trace function. The
trace gathers statistics about the data on the disk units within the ASP. This
data is used by the balance functions.
This field is valid for an IASP if its status is either ACTIVE or AVAILABLE,
otherwise hexadecimal zeros are returned.
The following special values are
returned:
| 0 |
There is no current trace data for this ASP. |
| 1 |
The trace function is currently running for this
ASP. |
| 2 |
The trace function is currently in the process of
ending. Either the time limit has run out or the trace was stopped through use
of the Trace ASP Balance (TRCASPBAL) command. |
| 3 |
The trace function has completed running. The
statistics for the ASP have been gathered and are ready for the balance
function to start. |
| 4 |
The trace data for this ASP is being
cleared. |
| 5 |
The trace function has completed and the
statistics for the ASP have been gathered. The ASP is ready for further
collection or for the balance function to start. |
Transition target. The state transition target of the ASP.
This field is valid for an IASP if its status is either ACTIVE or AVAILABLE,
otherwise hexadecimal zeros are returned.
The possible values are:
| 00 |
The ASP is not in a state transition. |
| 01 |
The ASP is in the process of making an upward
transition to the varyon state. |
| 02 |
The ASP is in the process of making an upward
transition to the active state. |
| 03 |
The ASP is in the process of making an upward
transition to the available state. |
| 04 |
The ASP is in the process of making a downward
transition to the active state. |
| 05 |
The ASP is in the process of making a downward
transition to the varyoff state. |
Unit control. The disk status for the disk unit. The
possible values for the field are:
| 0 |
There is no unit control value. |
| 1 |
The disk unit is active. |
| 2 |
The disk unit has failed. |
| 3 |
Some other disk unit in the disk subsystem has
failed. |
| 4 |
There is a hardware failure within the disk
subsystem that affects performance, but does not affect the function of the
disk unit. |
| 5 |
There is a hardware failure within the disk
subsystem that does not affect the function or performance of the disk
unit. |
| 6 |
The disk unit's parity protection is being
rebuilt. |
| 7 |
The disk unit is not ready. |
| 8 |
The disk unit is write protected. |
| 9 |
The disk unit is busy. |
| 10 |
The disk unit is not operational. |
| 11 |
The disk unit has returned a status that is not
recognizable by the system. |
| 12 |
The disk unit cannot be accessed. |
| 13 |
The disk unit is read/write protected. |
Use identification. An identification of how an ASP is being used.
| 0 |
Objects in the ASP are being used through library-based
access, through the Integrated File System or both. |
Version. The version of objects in an independent ASP.
| 0 |
Objects are usable by a system at release level
V5R1M0. |
| 1 |
Objects are usable by a system at release level
V5R2M0. |
| 2 |
Objects are usable by a system at release level
V5R3M0. |
| 3 |
Objects are usable by a system at release level
V5R4M0. |
| Offset |
Type |
Field |
| Dec |
Hex |
| 0 |
0 |
BINARY(4) |
Size of filter entry |
| 4 |
4 |
BINARY(4) |
Filter key |
| 8 |
8 |
BINARY(4) |
Size of filter data |
| 12 |
C |
CHAR(*) |
Filter data |
Filter data. When the filter key is 1 (an ASP number), the
filter data contains the number of the ASP for which information is to be
returned. A value larger than 0 is the number of the ASP. A zero or negative
number has special meaning as follows:
| 0 |
No ASPs are selected. If the requested format is
YASP0300, disk unit records are returned for those disk units that are not
assigned to an ASP. For all other formats, no records are returned. |
| -1 |
All ASPs are selected. |
| -2 |
All user ASPs are selected. |
| -3 |
All independent ASPs are selected. |
When the filter key is 2, 3,
or 4, the filter data contains respectively the resource name, device
description name, or database name of the ASP for which information is to be
returned.
Filter key. The field to use to filter the list
information. The filter key and its corresponding filter data length and filter
data is:
| Entry size |
Key |
Data size |
Filter data |
| 16 |
1 |
BINARY(4) |
ASP number |
| 24 |
2 |
CHAR(10) |
Resource name |
| 24 |
3 |
CHAR(10) |
Device description name |
| 32 |
4 |
CHAR(18) |
Database name |
Size of filter entry. The combined size of all fields in
the filter entry (size, key, and data).
| Offset |
Type |
Field |
| Dec |
Hex |
| 0 |
0 |
BINARY(4) |
Number of keys to sort on |
| Offsets vary. These
fields repeat for each sort key field. |
BINARY(4) |
Sort key field starting position |
| BINARY(4) |
Sort key field length |
| BINARY(2) |
Sort key field data type |
| CHAR(1) |
Sort order |
| CHAR(1) |
Reserved |
Number of keys to sort on. The number of fields within the
record structure on which to sort. If 0 is specified, the list is not
sorted.
The following special value is supported for format YASP0600 only.
| -1 |
The list of jobs threads are order by ASP number,
job name, job user name, job number, thread identifier and use identification.
This parameter is only used with format YASP0600. |
Reserved. Reserved field. This field must be set to
hexadecimal or binary zero.
Sort key field data type. Data type of field to sort. Refer
to the Sort (QLGSORT) API for information on the list
of data types available.
Sort key field length. The length of the field on which to
sort.
Sort key field starting position. Within the record of
information, the starting position of the field on which to sort.
Sort order. Whether the list should be sorted in ascending
or descending order according to the key.
| 1 |
Sort in ascending order. |
| 2 |
Sort in descending order. |
Error Messages
| Message ID |
Error Message Text |
| CPF24B4 E |
Severe error while addressing parameter list. |
| CPF3C19 E |
Error occurred with receiver variable specified. |
| CPF3C21 E |
Format name &1 is not valid. |
| CPF3C90 E |
Literal value cannot be changed. |
| CPF3CF1 E |
Error code parameter not valid. |
| CPF9872 E |
Program or service program &1 in library &2 ended.
Reason code &3. |
| GUI0002 E |
&1 is not valid for length of receiver variable. |
| GUI0027 E |
&1 is not valid for number of records to return. |
| GUI0141 E |
Filter specification is not valid. |
| GUI0149 E |
&1 is not valid for number of keys to sort on. |
API introduced: V4R4