Materialize Resource Management Data (MATRMD)

Instruction Syntax

Operand 2: Character(8) scalar.

Built-in number for MATRMD is 69.
MATRMD (
        receiver       : address
        control_data   : address
)

Warning

The following information is subject to change from release to release. Use it with caution and be prepared to adjust for changes with each new release.

Description:

The data items requested by operand 2 are materialized into the receiving object specified by operand 1. Note: Some templates contain input fields in the receiving object that must be filled in prior to the call to MATRMD. Refer to the template description for the option you are specifying to see if any fields are input fields. Operand 2 is an 8-byte character scalar. The first byte identifies the generic type of information being materialized, and the remaining 7 bytes further qualify the information desired. Unless otherwise stated, the data items requested for operand 2 are for the current partition.

Operand 1 contains the materialization and has the following format:

The remainder of the materialization depends on operand 2 and on the machine implementation. The following values are allowed for operand 2: See

The following defines the formats and values associated with each of the above materializations of resource management data.

Original Processor Utilization (Hex 01)

Processor time since IPL is the total amount of processor time used, both by threads and internal machine functions, since IPL. The significance of bits within the field is the same as that defined for the time-of-day clock. On a machine with more than one active virtual processor, the value returned will be the average of the processor time used since IPL by all virtual processors.

Secondary workload processor time since IPL is the total processor time, used for workloads that can not fully exploit dedicated server resources, since IPL. If a system is not a dedicated server, a value of hex 0000000000000000 is returned. The significance of bits within this field is the same as that defined for the time-of-day clock. On a machine with more than one active virtual processor, the value returned will be the average of the processor time used since IPL by all virtual processors.

Database processor time since IPL is the total processor time, used performing database processing, since IPL. If the system does not support this metric, a value of hex 0000000000000000 is returned. If the system does support this and needs to return a value of 0, a value of hex 0000000000001000 is returned. For all other cases, the significance of bits within this field is the same as that defined for the time-of-day clock. On a machine with more than one active virtual processor, the value returned will be the average of the processor time used since IPL by all virtual processors.

Database threshold is the highest level of database processor utilization which can be sustained without causing a disproportionate increase in system overhead. The value returned is the fraction of processor capacity, expressed in tenths of a percent. For example, a value of 237 means that the threshold is 23.7%. On a machine with no limit on database utilization, the value returned will be 1000 (100%).

Database limit is the maximum sustainable level of database processor utilization. The value returned is the fraction of processor capacity, expressed in tenths of a percent. For example, a value of 275 means that the limit is 27.5%. On a machine with no limit on database utilization, the value returned will be 1000 (100%).

Interactive processor time since IPL is the total processor time, used by interactive processes, since IPL. If the system does not support this metric, a value of hex 0000000000000000 is returned. If the system does support this and needs to return a value of 0, a value of hex 0000000000001000 is returned. For all other cases, the significance of bits within this field is the same as that defined for the time-of-day clock. On a machine with more than one active virtual processor, the value returned will be the average of the processor time used since IPL by all virtual processors. An interactive process is any process doing 5250 display device I/O. For additional information on interactive processes, see manual SC41-0607 iSeries Performance Capabilities Reference manual which is available in the Information Center.

Interactive threshold is the highest level of interactive processor utilization which can be sustained without causing a disproportionate increase in system overhead. The value returned is the fraction of processor capacity, expressed in tenths of a percent. For example, a value of 237 means that the threshold is 23.7%. On a machine with no limit on interactive utilization, the value returned will be 1000 (100%).

Interactive limit is the maximum sustainable level of interactive processor utilization. The machine determines the interactive limit based on the interactive feature. The value returned is the fraction of processor capacity, expressed in tenths of a percent. For example, a value of 275 means that the limit is 27.5%. On a machine with no limit on interactive utilization, the value returned will be 1000 (100%).

In a partition sharing physical processors, processor time since IPL, secondary workload processor time since IPL, database processor time since IPL, and interactive processor time since IPL are scaled appropriately so that the CPU utilization calculations can be done as if the partition was using dedicated processors.

Storage Management Counters (Hex 03)

Access pending is a count of the number of times that a paging request must wait for the completion of a different request for the same page.

Storage pool delays is a count of the number of times that threads have been momentarily delayed by the unavailability of a main storage frame in the proper pool.

Directory look-up operations is a count of the number of times that auxiliary storage directories were interrogated, exclusive of storage allocation or de-allocation.

Directory page faults is a count of the number of times that a page of the auxiliary storage directory was transferred to main storage, to perform either a look-up or an allocation operation.

Access group member page faults is a count of the number of times that a page of an object contained in an access group was transferred to main storage.

Microcode page faults is a count of the number of times a page of LIC was transferred to main storage.

Microtask read operations is a count of the number of transfers of one or more pages of data from auxiliary main storage on behalf of a task rather than a thread.

Microtask write operations is a count of the number of transfers of one or more pages of data from main storage to auxiliary storage on behalf of a task, rather than a thread.

Storage Transient Pool Information (Hex 04)

The pool number materialized is the number of the main storage pool, which is being used as the transient storage pool. A value of 0 indicates that the transient pool attribute is being ignored.

Machine Address Threshold Data (Hex 08)

Total permanent addresses possible is the maximum number of permanent addresses for the machine.

Total temporary addresses possible is the maximum number of temporary addresses for the machine.

Permanent addresses remaining is the number of permanent addresses that can still be created.

Temporary addresses remaining is the number of temporary addresses that can still be created.

Permanent addresses remaining threshold is a number that, when it exceeds the number of permanent addresses remaining, causes an event to be signaled.

Temporary addresses remaining threshold is a number that, when it exceeds the number of temporary addresses remaining, causes an event to be signaled.

Total permanent 4GB addresses possible is the maximum number of permanent 4GB addresses for the machine.

Total permanent 256MB addresses possible is the maximum number of permanent 256MB addresses for the machine.

Total temporary 4GB addresses possible is the maximum number of temporary 4GB addresses for the machine.

Total temporary 256MB addresses possible is the maximum number of temporary 256MB addresses for the machine.

Permanent 4GB addresses remaining is the number of permanent 4GB addresses that can still be created.

Permanent 256MB addresses remaining is the number of permanent 256MB addresses that can still be created.

Temporary 4GB addresses remaining is the number of temporary 4GB addresses that can still be created.

Temporary 256MB addresses remaining is the number of temporary 256MB addresses that can still be created.

Permanent 4GB addresses remaining threshold is a number that, when it exceeds the number of permanent 4GB addresses remaining, causes an event to be signaled if the suppress 4GB permanent address usage event flag is set to no.

Permanent 256MB addresses remaining threshold is a number that, when it exceeds the number of permanent 256MB addresses remaining, causes an event to be signaled if the suppress 256 MG permanent address usage event flag is set to no.

Temporary 4GB addresses remaining threshold is a number that, when it exceeds the number of temporary 4GB addresses remaining, causes an event to be signaled if the suppress 4GB temporary address usage event flag is set to no.

Temporary 256MB addresses remaining threshold is a number that, when it exceeds the number of temporary 256MB addresses remaining, causes an event to be signaled if the suppress 256MB temporary address usage event flag is set to no.

Main Storage Pool Information (Hex 09):

Machine minimum transfer size is the smallest number of bytes that may be transferred as a block to or from main storage.

Maximum number of pools is the maximum number of storage pools into which main storage may be partitioned. These pools will be assigned the logical identification beginning with 1 and continuing to the maximum number of pools.

Current number of pools is a user-specified value for the number of storage pools the user wishes to utilize. These are assumed to be numbered from 1 to the number specified. This number is fixed by the machine to be equal to the maximum number of pools.

Main storage size is the amount of main storage, in units equal to the machine minimum transfer size, which may be apportioned among main storage pools. Note that on overflow, the machine returns 2,147,483,647 in the main storage size field without any indication of error. You can use option "Main Storage Pool Information (Hex 2D)" to materialize the correct value.

Pool 1 minimum size is the amount of main storage, in units equal to the machine minimum transfer size, which must remain in pool 1. This amount is machine and configuration dependent.

Individual main storage pool information is data in an array that is associated with a main storage pool by virtue of its ordinal position within the array. In the descriptions below, database refers to all other data, including internal machine fields. Pool size, pool maintenance, amount of pool not assigned to virtual addresses and data transferred information is expressed in units equal to the machine minimum transfer size described above.

Pool size is the amount of main storage assigned to the pool. Note that on overflow, the machine returns 2,147,483,647 in the pool size field without any indication of error. You can use option "Main Storage Pool Information (Hex 2D)" to materialize the correct value.

Pool maintenance is the amount of data written from a pool to secondary storage by the machine to satisfy demand for resources from the pool. It does not represent total transfers from the pool to secondary storage, but rather is an indication of machine overhead required to provide primary storage within a pool to requesting threads. Note that on overflow, the machine resets the pool maintenance value from 2,147,483,647 back to 0 without any indication of error. You can use option "Main Storage Pool Information (Hex 2D)" to materialize the correct value.

Thread interruptions (database and non-database) is the total number of interruptions to threads (not necessarily assigned to this pool) which were required to transfer data into the pool to permit instruction execution. Note that on overflow, the machine resets the thread interruptions (database or non-database) value from 2,147,483,647 back to 0 without any indication of error. You can use option "Main Storage Pool Information (Hex 2D)" to materialize the correct value.

Data transferred to pool (database and non-database) is the amount of data transferred from auxiliary storage to the pool to permit instruction execution and as a consequence of set access state, implicit access group movement, and internal machine actions. Note that on overflow, the machine resets the data transferred to pool (database or non-database) value from 2,147,483,647 back to 0 without any indication of error. You can use option "Main Storage Pool Information (Hex 2D)" to materialize the correct value.

The amount of pool not assigned to virtual addresses represents the storage available to be used for new transfers into the main storage pool without displacing any virtual data already in the pool. The value returned will not include any storage that has been reserved for load/dump sessions active in the pool. Note that on overflow, the machine returns 2,147,483,647 in the amount of pool not assigned to virtual addresses field without any indication of error. You can use option "Main Storage Pool Information (Hex 2D)" to materialize the correct value.

MPL Control Data with 2-byte counts (Hex 0A)

Machine-Wide MPL Control:

• Maximum number of MPL classes is the largest number of MPL classes allowed in the machine. These are assumed to be numbered from 1 to the maximum.
• Current number of MPL classes is a user-specified value for the number of MPL classes in use. They are assumed to be numbered from 1 to the current number.
• MPL (max) always materializes as hex 7FFF. The machine does not support a machine-wide limit for the number of threads in active state.
• Ineligible event threshold always materializes as hex 7FFF. The machine does not monitor a machine-wide threshold for the number threads in ineligible state.
• MPL (current) is the current number of threads in the active state.
• Number of threads in ineligible state is the number of threads not currently active because of enforcement of class MPL rules.

MPL Class Information

• MPL class information is data in an array that is associated with an MPL class by virtue of its ordinal position within the array.
• MPL (max) is the number of threads assigned to the class which may be concurrently active.
• Ineligible event threshold is a number which, if exceeded by the number of threads in ineligible state defined below, will cause an event to be signaled.
• MPL (current) and number of threads in ineligible state are as defined above but apply only to threads assigned to the class.
• Number of threads assigned to class is the total number of threads, in any state, assigned to the class.
• The total number of transitions among the active, wait, and ineligible states by threads assigned to a class are:
  1. Number of active to ineligible transitions
  2. Number of active to MI wait transitions
  3. Number of MI wait to ineligible transitions
• Note that transitions from wait state to active state can be derived as (2 - 3) and transitions from ineligible state to active state as (1 + 3). On overflow, the machine wraps these Bin(2) numbers from 32,767 to 0 without any indication of error.

Machine Reserved Storage Pool Information (Hex 0C)

Pool size is the amount of main storage assigned to the pool (including the machine reserved portion). The units of measure is the machine minimum transfer size. Note that on overflow, the machine returns 2,147,483,647 in the pool size field without any indication of error. The main storage pool size field will return the correct value.

Machine portion of the pool specifies the amount of storage from the pool that is dedicated to machine functions. The units of measure is the machine minimum transfer size.

Main storage pool size is the amount of main storage assigned to the pool (including the machine reserved portion). The units of measure is the machine minimum transfer size.

User storage area 1 - OBSOLETE (Hex 11)

This option is no longer used. The number of bytes available for materialization will always indicate that no user data is available.

Auxiliary Storage Information (Hex 12)

The auxiliary storage information describes the ASPs (auxiliary storage pools) which are configured within the machine and the units of auxiliary storage currently allocated to an ASP or known to the machine but not allocated to an ASP. This option does not return information for independent ASPs which are varied off. You can use option "Auxiliary Storage Information including offline Independent ASPs (Hex 20)" to return information about independent ASPs which are varied off.

Also note that through appropriate setting of the number of bytes provided field for operand 1, the amount of information to be materialized for this option can be reduced thus avoiding the processing for unneeded information. As an example, by setting this field to only provide enough bytes for the common 16 byte header, plus the option hex 12 control information, plus the system ASP entry of the ASP information, you can get just the information up through the system ASP entry returned and avoid the overhead for the user ASPs and unit information.

Number of ASPs is the number of ASPs configured within the machine. One, the minimum value, indicates just the system ASP exists and that there are no user ASPs configured. Up to 254 user ASPs can be configured. The system ASP always exists. The number of ASPs includes the system ASP, user ASPs which are basic ASPs (that is, user ASPs which cannot be varied on or off), and independent ASPs which are currently varied on to this system.

Number of allocated auxiliary storage units is the total number of configured units logically addressable by the system as units. This is the number of configured, non-mirrored units plus the number of mirrored pairs allocated to the ASPs. This number includes only the first path of a multipath connection unit. The count of the remaining paths connected to multipath units is materialized in number of additional entries for multipath units. The total number of disk actuator arms on the system is the sum of the allocated auxiliary storage units plus the number of unallocated auxiliary storage units plus the number of pairs of mirrored units. Information on these units is materialized as part of the unit information. Any two units of the same size may be associated to form a mirrored pair. Association of two units as a mirrored pair reduces the amount of logically available storage by the number of bytes contained on one of the mirrored units in the mirrored pair. The disk units reside in the system ASP, a basic ASP, or an independent ASP. This number specifies the number of unit information entries that can be materialized.

Number of unallocated auxiliary storage units is the number of auxiliary storage units that are currently not allocated to an ASP. Information on these units is materialized as part of the unit information.

Maximum auxiliary storage allocated to temporaries is the maximum number of bytes of temporary storage allocated at any one time since the last IPL of the machine. This includes the temporary storage allocated on the load source unit.

Unit information offset is the offset, in bytes, from the start of the operand 1 materialization template to the start of the unit information. This value can be added to a space pointer addressing the start of operand 1 to address the start of the unit information.

Number of pairs of mirrored units represents the number of mirrored pairs in the system. Each mirrored pair consists of two mirrored units; however, only one of the two mirrored units is guaranteed to be operational.

Mirroring main storage is the number of bytes of main storage in the machine storage pool used by mirroring. This increases when mirror synchronization is active. This amount of storage is directly related to the number of mirrored pairs.

Number of multipath units is the number of disk units that have multiple connections to a disk unit. This means that there are multiple resource names that all represent the same disk unit, yet each represents a unique path to the disk unit. All active connections will be used for communicating with the disk unit.

Current auxiliary storage allocated to temporaries is the number of bytes of temporary storage allocated on the system. This includes the temporary storage allocated on the load source unit.

Number of bytes in a page is the number of bytes in a single page. This can be used to convert fields that are given in pages into the correct number of bytes.

Number of independent ASPs is the number of independent ASPs varied on to this system. An independent ASP is an ASP that can be varied on or off.

Number of disk units in all varied on independent ASPs is the number of configured units logically addressable by all independent ASPs which are currently varied on to this system. Information on these units is materialized as part of the unit information.

Number of basic ASPs is the number of basic ASPs configured on this system. A basic ASP is a user ASP that cannot be varied on or off.

Number of disk units in all basic ASPs is the total number of configured units logically addressable by all basic ASPs. Information on these units is materialized as part of the unit information.

Number of disk units in the system ASP is the total number of configured units logically addressable in the system ASP. Information on these units is materialized as part of the unit information.

Number of additional entries for multipath units is the number of additional unit entries that can be materialized for the multipath connection devices. The first path of each unit is not included in this total.

ASP information is repeated once for each configured ASP within the machine that is online. The number of ASPs configured is specified by the number of ASPs field. ASP 1, the system ASP, is materialized first. Because the system ASP always exists, its materialization is always available. The user ASPs which are configured are materialized after the system ASP in ascending numerical order. There may be gaps in the numerical order. That is, if just user ASPs 3 and 5 are configured, only information for them is materialized producing information on just ASP 1, ASP 3 and ASP 5 in that order.

ASP number uniquely identifies the auxiliary storage pool. The ASP number may have a value from 1 through 255. A value of 1 indicates the system ASP. A value of 2 through 255 indicates a user ASP. Note that independent ASPs have a value of 33 through 255.

Suppress threshold exceeded event flag indicates whether or not the machine is suppressing signaling of the related event when the event threshold in effect for this ASP has been exceeded. A value of binary 1 indicates that the signaling is being suppressed; binary 0 indicates that the signaling is not being suppressed. The default after each IPL of the machine is that the signaling is not suppressed; i.e. default is binary 0. For the system ASP, this flag is implicitly set to binary 1 by the machine when the machine auxiliary storage threshold is exceeded. For a basic ASP, this flag is implicitly set to binary 1 by the machine when the user auxiliary storage threshold is exceeded.

The ASP overflow flag indicates whether or not object allocations directed into a basic ASP have overflowed into the system ASP. A value of binary 1 indicates overflow; binary 0 indicates no overflow. This flag does not apply to the system ASP and a value of binary 0 is always returned for it. This flag does not apply to independent ASPs and a value of binary 0 is always returned for independent ASPs.

ASP mirrored flag specifies whether or not the ASP is configured to be mirror protected. A value of binary 1 indicates that ASP mirror protection is configured. Refer to the mirrored unit protected flag to determine if mirror protection is active for each mirrored pair. A value of binary 0 indicates that none of the units associated with the ASP are mirrored.

User ASP MI state indicates the state of the user ASP. A value of binary 1 indicates that the user ASP is in the 'new' state. This means that a context may be allocated in this user ASP. A value of binary 0 indicates that the user ASP is in the 'old' state. This means that there are no contexts allocated in this user ASP. This flag has no meaning for the system ASP and a value of binary 0 will always be returned. A value of binary 1 will always be returned for independent ASPs.

ASP overflow storage available flag indicates whether or not the amount of auxiliary storage that has overflowed from the basic ASP into the system ASP is available. A value of binary 1 indicates that the amount is maintained by the machine and available in the ASP overflow storage field. A value of binary 0 indicates that the amount is not available. This flag does not apply to independent ASPs and a value of binary 0 is always returned for independent ASPs.

Suppress available storage lower limit reached event flag indicates whether the machine will signal the related event when the available storage lower limit has been reached. This field currently has meaning only in the system ASP (ASP 1). This value will always be returned as binary 0 for a user ASP. A value of binary 1 indicates that signaling of the event is being suppressed; binary 0 indicates that signaling of the event is not suppressed. The default after each IPL of the machine is binary 0, i.e., signaling of this event is not suppressed. This flag is set to binary 1 by the machine when the available storage lower limit reached (hex 000C,02,08) event is signaled. This is done to avoid repetitive signaling of the event when the available storage lower limit reached condition occurs.

ASP overflow recovery result flags indicate the result of the ASP overflow recovery operation which is performed during an IPL upon request by the user. When this operation is requested, the machine attempts to recover a basic ASP from an overflow condition by moving overflowed auxiliary storage from the system ASP back to the basic ASP during the Storage Management recovery step of an IPL. The successful flag is set to a value of binary 1 when all the overflowed storage was successfully moved. The failed due to insufficient free space flag is set to a value of binary 1 when there is not sufficient free space in the basic ASP to move all the overflowed storage. The cancelled flag is set to a value of binary 1 when the operation was cancelled prior to completion (e.g., system power loss, user initiated IPL). This flag does not apply to independent ASPs and a value of binary 0 is always returned for independent ASPs.

Number of allocated auxiliary storage units in ASP is the number of configured units logically addressable by the system as units for this ASP. This is the number of configured, non-mirrored units plus the number of mirrored pairs allocated in the ASPs. The total number of units (actuator arms) on the system is the sum of the allocated auxiliary storage units plus the number of unallocated auxiliary storage units plus the number of pairs of mirrored units. For example, each 9335 enclosure represents two units. Information on these units is materialized as part of the unit information. Any two units of the same size may be associated to form a mirrored pair. Association of two units as a mirrored pair reduces the amount of logically available storage by the number of bytes contained on one of the mirrored units in the mirrored pair.

Mirroring mode for geographic mirroring specifies the mode in which geographic mirroring operates. A value of hex 00 indicates geographic mirroring is not configured. A value of hex 01 indicates synchronous mode. In synchronous mode, synchronous writes are performed to save the data to disk on the mirror copy node. Synchronous mode is the only mode that is crash-consistent on the mirror copy node and is best for most environments. A value of hex 02 indicates asynchronous mode. In asynchronous mode, asynchronous writes are performed to save the data to disk on the mirror copy node. A value of hex FF indicates that the mirroring mode for geographic mirroring is not known.

Remote mirror copy data state specifies the condition of the data on the target. A value of hex 00 indicates that remote independent ASP mirroring is not configured. A value of hex 01 indicates that the remote copy is absolutely in sync with the production copy. A value of hex 02 indicates that the remote copy contains usable data. A detached mirror copy always has usable data state. A value of hex 03 indicates that there is incoherent data state in the mirror copy and the data cannot be used.

ASP media capacity specifies the total space, in number of bytes of auxiliary storage, on the storage media allocated to the ASP. This is just the sum of the unit media capacity fields for (1) the units allocated to the ASP or (2) the mirrored pairs in the ASP.

ASP space available is the number of bytes of auxiliary storage that is not currently assigned to objects or internal machine functions, and therefore, is available for allocation in the ASP. Note that a mirrored pair counts for only one unit.

ASP event threshold specifies the minimum value for the number of bytes of auxiliary storage available in the ASP prior to the exceeded condition occurs when the ASP space available value becomes equal to or less than the ASP event threshold value. Refer to the definition of the suppress threshold exceeded event flag for more information.

The ASP event threshold value is calculated from the ASP event threshold percentage value by multiplying the ASP media capacity value by the ASP event threshold percentage and subtracting the product from that same capacity value.

ASP event threshold percentage specifies the auxiliary storage space utilization threshold as a percentage of the ASP media capacity. This value is used, as described above, to calculate the ASP event threshold value. This value can be modified through use of Dedicated Service Tool DASD configuration options.

Terminate immediately when out of storage indicates whether the system will be terminated immediately when a request for space occurs in the system ASP that cannot be satisfied because the system is out of storage. A value of binary 1 indicates that when a request for space in the system ASP cannot be satisfied, then the system will be terminated immediately. This field currently has meaning only in the system ASP (ASP 1). This value will always be returned as binary 0 for a user ASP.

A value of binary 0 indicates that when a request for space in the system ASP cannot be satisfied, then the system will not be terminated immediately, but will be allowed to continue to run however it can.

ASP contains compressed and non-compressed units flag specifies whether or not the ASP has compressed and non-compressed configured units. A value of binary 1 indicates that both compressed and non-compressed units exist in this ASP. A value of binary 0 indicates that a mix of compressed and non-compressed units does not exist in this ASP.

Recover overflowed basic ASP during normal mode IPL flag specifies whether or not the machine will attempt to recover the overflowed ASP data during normal mode IPLs. Overflowed data is data from the basic ASP which exists in the system ASP because there was insufficient auxiliary storage in the basic ASP. A value of binary 1 indicates that the machine will attempt to automatically recover any overflowed data for that basic ASP during normal mode IPLs. A value of binary 0 indicates that the machine will not attempt to recover the overflowed data. A value of binary 0 is always returned for the system ASP (ASP 1). A value of binary 0 is always returned for an independent ASP (since an independent ASP can never overflow its data into the system ASP).

Independent ASP flag specifies whether or not the ASP is an independent ASP; that is, it can be varied on and off. A value of binary 1 indicates the ASP is an independent ASP. A value of binary 0 indicates that this ASP is a basic ASP or the system ASP and cannot be varied on or off.

ASP is online flag always returns the value of binary 1.

Independent ASP address threshold exceeded flag is only valid for an Independent ASP and specifies whether or not the independent ASP address threshold, selected by the machine, has been exceeded. A value of binary 1 indicates the threshold has been exceeded and the Independent ASP is running low on addresses. A value of binary 0 indicates that the address threshold has not been exceeded.

Independent ASP is remote mirrored indicates that the independent ASP is remote mirrored. Remote independent ASP mirroring provides high availability by supporting multiple physical independent ASP copies at different sites that contain the same user data with the same virtual addresses. A value of binary 0 indicates that the independent ASP is not remote mirrored. A value of binary 1 indicates that the independent ASP is remote mirrored.

ASP is encrypted flag specifies whether or not the data contained in the ASP is encrypted. A value of binary 1 indicates that the ASP is encrypted; binary 0 indicates that it is not encrypted.

Suppress temporary storage threshold exceeded event flag indicates whether or not the machine is suppressing signaling of the related event when the event threshold in effect for this ASP has been exceeded. A value of binary 1 indicates that the signaling is being suppressed; binary 0 indicates that the signaling is not being suppressed. The default after each IPL of the machine is that the signaling is not suppressed unless the temporary storage threshold is set to binary 0. This flag is implicitly set to binary 1 when the temporary storage threshold exceeded event (hex 000C,02,0D) is signaled. Option hex 12 of the Modify Resource Management Controls (MODRMC) instruction can be used to explicitly reset the suppression of the temporary storage threshold exceeded event. This field only has meaning for the system ASP (ASP 1). This value will always be returned as binary 0 for a user ASP.

If the mirror copy IASP is partially varied on field is binary 1, the IASP is a mirror copy IASP and the IASP is varied on to a level where it can receive data from the production copy IASP. If the mirror copy IASP is partially varied on field is binary 0, the IASP either is not a mirror copy IASP, or it is a mirror copy IASP that is not varied on.

IASP vary-off is in progress specifies whether or not the independent ASP is being varied off. A value of binary 1 indicates that the ASP is being varied off; binary 0 indicates that it is not being varied off.

ASP compression recovery policy indicates how Storage Management handles a failure condition due to a compressed disk unit being temporarily full as auxiliary storage space is reserved on the unit.

A value of binary 00 indicates that if the I/O processor can make storage space available by rearranging and further compressing data on the unit, Storage Management waits for space to be made available. When the I/O processor makes sufficient space on the compressed unit to contain the Storage Management request, the request completes successfully and the system resumes normal processing. If space can not be made available on the unit, auxiliary storage overflows from the basic ASP to the system ASP.

A value of binary 01 indicates that auxiliary storage overflows from the user ASP to the system ASP. Storage Management does not wait for the I/O processor to make storage space available on the unit.

A value of binary 10 indicates that Storage Management waits indefinitely for storage space to be made available on the unit, even if the I/O processor can not make space available on the unit. No auxiliary storage overflows from the user ASP to the system ASP.

A value of binary 00 is always returned for the system ASP (ASP 1). A value of binary 10 is always returned for independent ASPs (that is, for ASPs which can be varied on or off). An independent ASP can never have a value of binary 01 (overflow immediately) because independent ASPs are not allowed to overflow into the system ASP.

Primary ASP flag indicates that the independent ASP is a primary ASP in an ASP group. A primary ASP defines a collection of directories and contexts and may have secondary ASPs associated with it. This flag only has meaning for an independent ASP. A value of binary 1 indicates the independent ASP is a primary ASP. A value of binary 0 indicates the independent ASP is not a primary ASP.

Secondary ASP flag indicates that the independent ASP is a secondary ASP in an ASP group. A secondary ASP is associated with a primary ASP. There can be many secondary ASPs associated with the same primary ASP. The secondary ASP defines a collection of directories and contexts. This flag only has meaning for an independent ASP. A value of binary 1 indicates the independent ASP is a secondary ASP. A value of binary 0 indicates the independent ASP is not a secondary ASP.

UDFS ASP flag indicates that the independent ASP is a UDFS (User-defined File System) ASP. This type of independent ASP cannot be a member of an ASP group. This flag only has meaning for an independent ASP. A value of binary 1 indicates the independent ASP is a UDFS ASP. A value of binary 0 indicates the independent ASP is not a UDFS ASP.

Restricted ASP flag indicates that the ASP is restricted. This flag only has meaning for a Primary ASP -- a value of binary 0 will be returned for all other ASP types. A value of binary 1 indicates the Primary ASP is restricted. A value of binary 0 indicates the Primary ASP is not restricted.

Remote mirror role identifies the current role of the physical independent ASP copy. A value of hex 00 indicates that remote independent ASP mirroring is not configured. A value of hex 01 indicates that the system does not own a physical independent ASP copy. A value of hex 02 indicates that the remote mirror role is unknown. A value of hex C4 indicates that the system owns a detached mirror copy. A value of hex D4 indicates that the system owns the mirror copy. A value of hex D7 indicates that the system owns the production copy.

Remote mirror copy state identifies the mirror state of the mirror copy. A value of hex 00 indicates that remote independent ASP mirroring is not configured. A value of hex 01 indicates that the system attempts to perform independent ASP remote mirroring when it is online. A value of hex 02 indicates that the remote independent ASP role is resuming, but the independent ASP is offline so it is not performing synchronization. A value of hex 03 indicates that the system is resuming and the independent ASP is online, so it is performing synchronization. A value of hex 04 indicates that the remote independent ASP role is detached and remote mirroring is not being performed. A value of hex FF indicates that the remote mirror copy state is not known.

ASP system storage specifies the amount of system storage currently allocated in the ASP in bytes.

ASP overflow storage indicates the number of bytes of auxiliary storage that have overflowed from a basic ASP into the system ASP. This value is valid only if the ASP overflow storage available field is set to a value of binary 1.

Space allocated to the error log is the number of pages of auxiliary storage that are allocated to the error log. This field only applies to the system ASP.

Space allocated to the machine log is the number of pages of auxiliary storage that are allocated to the machine log. This field only applies to the system ASP.

Space allocated to the machine trace is the number of pages of auxiliary storage that are allocated to the machine trace. This field only applies to the system ASP.

Space allocated for main store dump is the number of pages of auxiliary storage that are allocated to the main store dump space. The contents of main store are written to this location for some system terminations. This field only applies to the system ASP.

Space allocated to the microcode is the number of pages of auxiliary storage that are allocated for microcode and space used by the microcode. The space allocated to the error log, machine log, machine trace, and main store dump space is not included in this field.

Remote mirror synchronization priority indicates the priority assigned to synchronization between the physical copy and the mirrored copy related to work on the system. A value of hex 00 indicates that remote independent ASP mirroring is not configured on this independent ASP. A value of hex 10 indicates that the synchronization is given high priority, and is completed quickly at the expense of significant degradation to work on the system. A value of hex 20 indicates that the synchronization is given medium priority, and is completed at a moderate rate with some degradation to work on the system. A value of hex 30 indicates that the synchronization is given low priority, and is completed at a slow rate with minimum degradation to work on the system. A value of hex FF indicates that the remote mirror synchronization priority is not known.

Remote mirror encryption mode indicates the encryption mode for the remote mirrored independent ASP. A value of hex 00 indicates that remote independent ASP mirroring is not configured on this independent ASP. A value of hex 01 indicates that the user has chosen not to encrypt the data being sent to the remote mirror site. A value of hex 02 indicates that the user has chosen to encrypt the data being sent to the remote mirror site. A value of hex FF indicates that the remote mirror encryption mode is not known.

Remote mirror error recovery indicates the error recovery policy selected by the user. A value of hex 00 indicates that remote independent ASP mirroring is not configured on this system. A value of hex 02 indicates that remote mirroring is suspended when an IASP error is detected. After suspend, if the target node becomes accessible, the system automatically resumes remote independent ASP mirroring. A value of hex 03 indicates that remote mirroring is ended when an IASP error is detected. A value of hex FF indicates that the remote mirror error recovery policy is not known.

Remote mirror minutes until timeout is the number of minutes the system waits for a write acknowledgement from the remote system before the error recovery policy selected by the user is implemented. A value of hex FF indicates that the number of minutes until the system waits for a write acknowledgement is not known.

Available storage lower limit is the number of bytes of available auxiliary storage in the system ASP prior to the available storage lower limit reached condition occurring. When the amount of auxiliary storage available in the system ASP becomes less than this amount, the available storage lower limit reached (hex 000C,02,08) event is signaled if it is not suppressed. Redundant signaling of this event is suppressed as indicated by the setting of the suppress available storage lower limit reached event flag.

Protected space capacity specifies the total number of bytes of auxiliary storage that is protected by mirroring or device parity in the ASP. Note that a varied-off independent ASP could have 0 in this field because the system could not determine what disk units exist in a varied-off independent ASP .

Unprotected space capacity specifies the total number of bytes of auxiliary storage that is not protected by mirroring or device parity in the ASP. Note that a varied-off independent ASP could have 0 in this field because the system could not determine what disk units exist in a varied-off independent ASP .

Protected space available specifies the number of bytes of protected auxiliary storage that is not currently assigned to objects or internal machine functions, and therefore, is available for allocation in the ASP. Note that a varied-off independent ASP could have 0 in this field because the system could not determine what disk units exist in a varied-off independent ASP .

Unprotected space available specifies the number of bytes of unprotected auxiliary storage that is not currently assigned to objects or internal machine functions, and therefore, is available for allocation in the ASP. Note that a varied-off independent ASP could have 0 in this field because the system could not determine what disk units exist in a varied-off independent ASP .

Temporary storage event threshold specifies the maximum number of bytes of auxiliary storage that can be allocated to temporary objects before the temporary storage threshold event (000C,02,0D) is signaled. The temporary storage event threshold is calculated by multiplying the ASP media capacity by the temporary storage event threshold percent. When the number of bytes of auxiliary storage allocated to temporary objects becomes larger than this value, the Temporary storage threshold event is signaled. If this field is zero it indicates that the temporary storage event threshold is not set. The event will not be signaled if the temporary storage event threshold is not set. Refer to the definition of the suppress temporary storage threshold exceeded event flag for more information

Number of addresses remaining in independent ASP contains the number of virtual addresses remaining for use by the independent ASP. This field only has meaning for an independent ASP. The information in this field is only valid if the independent ASP address threshold exceeded flag is set to binary 1.

Geographic mirror seconds until timeout is the number of seconds the system waits for a write acknowledgement from the remote system before the error recovery policy selected by the user is implemented. A value of hex FFFF indicates that the number of seconds the system waits for a write acknowledgement is not known.

Transmission delivery specifies the delivery method for geographic mirroring. A value of hex 00 indicates synchronous delivery. A value of hex 01 indicates asynchronous delivery. Asynchronous delivery allows the production copy to proceed without waiting for the mirror copy to receive the information, but more resources are consumed on the production copy node. A value of hex 99 indicates geographic mirroring is not configured. A value of hex FF indicates that the transmission delivery is not known.

Total data in transit indicates the amount of data that has been queued up to send to the mirror copy node, but has not yet been received by the mirror copy node. This is a value in bytes. This parameter is only valid for asynchronous transmission delivery mode.

Temporary storage event threshold percent specifies the amount of auxiliary storage that can be used for temporary objects, as a percentage of the media capacity, before the temporary storage threshold exceeded event is signaled. If this field is zero it indicates that the temporary storage event threshold percent is not set. The event will not be signaled if the temporary storage event threshold percent is not set. The temporary storage event threshold percent can be set using MODRMC option hex 12 (Auxiliary storage pool controls).

Unit information is materialized in the following order:

• Group 1: Configured units consisting of non-mirrored units and the first subunit of a pair of mirrored units.
• Group 2: Non-configured units.
• Group 3: Configured units consisting of the mates of mirrored units listed in group 1 (above).

• Group 1: Number of non-mirrored, configured units + number of mirrored pairs
• Group 2: Number of non-configured storage units (also called unallocated units).
• Group 3: Number of mirrored pairs

Disk type identifies the type of disk enclosure containing this auxiliary storage unit. This is the four byte character field from the vital product data for the disk device which identifies the type of drive. For example, the value is character string '6607' for a 6607 device.

Disk model identifies the model of the type of disk enclosure containing this auxiliary storage unit. This is the four byte character field from the vital product data for the disk device which identifies the model of the drive.

Unit number uniquely identifies each non-mirrored unit or mirrored pair among the configured units. Both mirrored units of a mirrored pair have the same unit number. The value of the unit number is assigned by the system when the unit is allocated to an ASP. For unallocated units, the unit number is set to binary 0.

Unit ASP number specifies the ASP to which this unit is currently allocated. A value of 0 indicates that this unit is currently unallocated. A value of 1 specifies the system ASP. A value from 2 through 255 specifies a user ASP and correlates to the ASP number field in the ASP information entries. Values 33 to 255 specify a independent ASP. Values 2 to 32 specify a basic ASP.

Unit mirrored flag indicates that this unit number represents a mirrored pair. This bit is materialized with both mirrored units of a mirrored pair.

Mirrored unit protected flag indicates the mirror status of a mirrored pair. A value of 1 indicates that both mirrored units of a mirrored pair are active. A 0 indicates that one mirrored unit of a mirrored pair is not active. Active means that both units are on line and fully synchronized (i.e. the data is identical on both mirrored units).

Mirrored pair reported flag indicates that a mirrored unit reported as present. The mirrored unit reported present during or following IMPL. Current attachment of a mirrored unit to the system cannot be inferred from this bit. A 0 indicates that the mirrored unit being materialized is missing. The last known information pertaining to the missing mirrored unit is materialized. A 1 indicates that the mirrored unit being materialized has reported. The information for this reported unit is current to the last time it reported status to the system.

Mirrored unit status indicates mirrored unit status.

• A value of 1 indicates that this mirrored unit of a mirrored pair is active (i.e. on-line with current data).
• A value of 2 indicates that this mirrored unit is being synchronized.
• A value of 3 indicates that this mirrored unit is suspended.

Mirrored synchronization percent complete indicates the percent complete (from 0 to 100) of a resuming mirrored unit. This value must be 100 before the mirrored unit status is active. This field is only valid if mirrored unit status is set to value 2.

Unit media capacity is the space, in number of bytes of auxiliary storage, on the non-mirrored unit or mirrored pair, that is, the capacity of the unit prior to any formatting or allocation of space by the system it is attached to. For a mirrored pair, this space is the number of bytes of auxiliary storage on either one of the mirrored units. The space is identical on both of the mirrored units. Caution, do not attempt to add the capacities of the two units of a mirrored pair together. Unit media capacity is also known as "logical capacity". For compressed drives, the logical capacity is dynamic, and changes, depending on how well the data is compressed. A typical compressed logical capacity might be twice the drive's physical capacity.

Unit storage capacity has the same value as the unit media capacity for configured disk units. This value is 0 for non-configured units.

Unit space available is the number of bytes of secondary storage space that is not currently assigned to objects or internal machine functions, and therefore, is available for allocation on the unit (or the mirrored pair). For a mirrored pair, this space is the number of bytes of auxiliary storage available on either one of the mirrored units. The space is identical on both of the mirrored units. Caution, do not attempt to add the capacities of the two units of a mirrored pair together. This value is 0 for non-configured units.

Unit space reserved for system is the total number of bytes of auxiliary storage on the unit reserved for use by the machine. This storage is not available for storing objects, redundancy data, and other internal machine data. This value is 0 for non-configured units.

Unit is device parity protected - a value of 1 indicates that this unit is device parity protected.

Subsystem is active indicates whether the array subsystem is active.

If the unit in subsystem has failed field is binary 1, the unit in an array subsystem being addressed has failed. Data protection for this subsystem is no longer in effect.

If the other unit in subsystem has failed field is binary 1, the unit being addressed is operational, but another unit in the array subsystem has failed. Data protection for this subsystem is no longer in effect.

If the subsystem runs in degraded mode field is binary 1, the array subsystem is operational and data protection for this subsystem is in effect, but a failure that may affect performance has occurred. It must be fixed.

If the hardware failure field is binary 1, the array subsystem is operational and data protection for this subsystem is in effect, but hardware failure has occurred. It must be fixed.

If the device parity protection is being rebuilt field is 1, the device parity protection for this device is being rebuilt following a repair action.

If the unit is not ready field is binary 1, the unit being addressed is not ready for I/O operation.

If the unit is write protected field is binary 1, the write operation is not allowed on the unit being addressed.

If the unit is busy field is binary 1, the unit being addressed is busy.

If the unit is not operational field is binary 1, the unit being addressed is not operational. The status of the device is not known.

If the unit is not recognizable field is binary 1, the unit being addressed has an unexpected status. I.e. the unit is operational, but its status returned to Storage Management from the IOP is not one of those previously described.

If the status is not available field is binary 1, the machine is not able to communicate with I/O processor. The status of the device is not known.

If the unit is read/write protected is binary 1, a DASD array may be in the read/write protected state when there is a problem, such as a cache problem, configuration problem, or some other array problems that could create a data integrity exposure.

If the unit is compressed field is binary 1, the logical capacity of the unit may be greater than its physical capacity in bytes, depending on how well the data can be compressed.

If the do not allocate additional storage on this disk unit field is binary 1, then new allocations will be directed away from this unit.

If the unit is in availability parity set field is binary 1, the unit being addressed is in a parity set optimized for availability.

If the unit is multipath unit field is binary 1, the unit being addressed has multipath connections to the disk unit.

If the unit is resume pending field is binary 1, the unit being addressed is either in a system ASP on a system which is not IPLed past DST, or in a varied-off independent ASP. Mirror synchronization will begin when the system is IPLed past DST, or the independent ASP is varied-on. Refer to the mirrored unit status field definition for more information.

If the unit is encrypted field is binary 1, the data stored on the unit being addressed is encrypted. If the unit is encrypted field is binary 0, the data stored on the unit being addressed is not encrypted.

If the unit is connected to a dual storage IOA field is binary 1, the unit is controlled by two storage I/O adapters (IOA). If the unit is connected to a dual storage IOA field is binary 0, the unit is not controlled by two storage I/O adapters (IOA).

If the active path field is binary 1, the path is connected to the disk unit and is used when reading and writing to the associated disk unit. This field is not valid and is set to binary 0 if unit is connected to a dual storage IOA is binary 0.

If the passive path field is binary 1, the path is connected to the disk unit but is not used when reading or writing to the associated disk unit. This path is a backup in case an active path fails. This field is not valid and is set to binary 0 if unit is connected to a dual storage IOA is binary 0.

If the connected via Fibre Channel field is binary 1, the unit is connected to the system via a Fibre Channel adapter. If the value is binary 0, the unit is not connected to the system via a Fibre Channel adapter.

If the unit is solid state drive field is binary 1, the unit is a solid state drive. If the field is binary 0, the unit is not a solid state drive.

If the unit is thinly provisioned field is binary 1, the unit is part of an external storage box and has more storage assigned to it than it has physically available. If the field is binary 0, the unit is not thinly provisioned.

If the unit is HyperSwap field is binary 1, the disk unit is either the primary or secondary unit in a Metro Mirror relationship with HyperSwap failover capability. If the unit is HyperSwap field is binary 0, the disk unit is not in a Metro Mirror relationship with HyperSwap failover capability.

If the HyperSwap standby field is binary 1, the path is connected to a disk unit that is the secondary unit in a Metro Mirror relationship. This disk unit is in full synchronization with the primary disk unit and is ready in the event of a HyperSwap fail-over from the primary. If the HyperSwap standby field is binary 0, the path is not a HyperSwap standby path.

If the HyperSwap resuming field is binary 1, the path is connected to a disk unit that is the secondary unit in a Metro Mirror relationship. This disk unit is in the process of being re-synchronized with the primary disk unit. When the re-synchronization completes, the disk unit will be ready in the event of a HyperSwap fail over from the primary. If the HyperSwap resuming field is binary 0, the path is not a HyperSwap resuming path.

If the HyperSwap ineligible field is binary 1, the path is connected to a disk unit that is the secondary unit in a Metro Mirror relationship where Metro Mirror replication is suspended. The system cannot perform a HyperSwap fail over unless Metro Mirror replication is resumed. If the HyperSwap ineligible field is binary 0, the path is not a HyperSwap ineligible path.

If the HyperSwap standby failed field is binary 1, the path is connected to a disk unit that is the secondary unit in a Metro Mirror relationship. This disk unit is not ready in the event of a HyperSwap fail-over from the primary. If the HyperSwap standby failed field is binary 0, the path is not a HyperSwap standby failed path.

RAID type identifies the current type of RAID (device parity) array that a unit belongs to. A value of hex 00 indicates that the unit is not in a parity set. A value of hex 05 indicates that the unit belongs to a RAID 5 parity set. A value of hex 06 indicates that the unit belongs to a RAID 6 parity set. A value of hex 0A indicates that the unit belongs to a RAID 10 parity set.

Blocksize indicates the size in bytes of a single page on the disk unit.

Serial number specifies the serial number of the device containing this auxiliary storage unit. This is the ten character serial number field from the vital product data for the disk device.

Resource name is the unique ten-character name assigned by the system

Unit usage information specifies statistics relating to usage of the unit. For unallocated units, these fields are meaningless.

Blocks transferred to/from main storage fields specify the number of 512-byte blocks transferred for the unit since the last IMPL. These values wrap around to zero and continue counting in the case of an overflow of the field with no indication of the overflow having occurred.

Requests for data transfer to/from main storage fields specify the number of data transfer (I/O) requests processed for the unit since the last IMPL. These values wrap around to zero and continue counting in the case of an overflow of the field with no indication of the overflow having occurred. These values are not directly related to the number of blocks transferred for the unit because the number of blocks to be transferred for a given transfer request can vary greatly.

Permanent blocks transferred from main storage specifies the number of 512-byte blocks of permanent data transferred from main storage to auxiliary storage for the unit since the last IMPL. In the case of an overflow of the field, this value wraps around back to zero and continues counting, with no indication of the overflow condition having occurred.

Requests for permanent data transfer from main storage specifies the number of transfer (I/O) requests for transfers of permanent data from main storage to auxiliary storage that have been processed for the unit since the last IMPL. In the case of an overflow of the field, this value wraps around back to zero and continues counting, with no indication of the overflow condition having occurred. This value is not directly related to the permanent blocks transferred from main storage value for the unit ASP because the number of blocks to be transferred for any particular transfer request can vary greatly.

Sample count specifies the number of times the disk queue was checked to determine whether or not the queue is empty.

Not busy count specifies the number of times the disk queue was empty during the same time period that the sample count was taken.

Extended serial number specifies the 15 character extended serial number of the device containing the auxiliary storage unit. This field will contain one of two serial number formats. For auxiliary storage units that support it, this field will contain the 12 character, 11S format serial number padded to the right with blanks. For auxiliary storage units that do not support the 11S serial number, this field will contain the older 10 character serial number padded to the right with blanks.

RAID rebuild percent complete indicates the percent complete (from 0 to 100) that the I/O Adapter (IOA) has constructed the data on the disk unit using RAID algorithms and parity data from the disk units in the parity set. During the time the RAID rebuild is running, the performance of some applications or processes may be negatively affected. This field is only valid if device parity protection is being rebuilt is set to binary 1.

Mirror subunit indicates whether the entry is for subunit 'A' (hex C1) or 'B' (hex C2) of a mirrored pair. If the unit is not a mirrored pair, the value will be a blank (hex 40). This field is only valid if unit mirrored is set to binary 1.

Unit is NVMe indicates whether or not this is a Non-Volatile Memory Experss device. A value of binary 1 indicates this is a Non-Volatile Memory Express (NVMe) device.

Unit is IASP configuration device indicates whether or not this disk unit contains the configuration information for the Independent Auxiliary Storage Pool (IASP). A value of binary 1 indicates this unit is the IASP configuration device,

Unit is unmap capable indicates whether or not this unit is capable of performing the Unmap command. A value of binary 1 indicates this unit is capable of performing the Unmap command.

Note that on overflow, the machine resets the following BIN(4) fields from 2,147,483,647 back to 0 without any indication of error: blocks transferred to main storage, blocks transferred from main storage, requests for data transfer to main storage, requests for data transfer from main storage, permanent blocks transferred from main storage, requests for permanent data transfer from main storage, sample count, and not busy count.

Original Multiprocessor utilizations (Hex 13)

This option always returns a number of bytes available for materialization equal to the length of the entire structure detailed above (it does not vary with the number of configured or active processors).

Maximum number of active processors in the partition is the maximum number of virtual processors that can be active on the current IPL of the partition.

Number of active processors in the partition is the number of virtual processors currently active in the partition. It will always be less than or equal to the maximum number of active processors in the partition.

A value of binary 1 for the processor is active field indicates the processor is active. A value of binary 0 indicates the processor is currently varied off or is not installed on the system.

The significance of bits within the processor time busy since IPL fields are the same as that defined for the time-of-day clock. For a partition sharing physical processors, processor time busy since IPL is scaled appropriately so that CPU utilization calculations can be done as if the partition was using dedicated processors.

Virtual processors that are not currently active (but were active at some previous time in the IPL) will not have their processor time busy since IPL reported.

Storage pool tuning (Hex 14)

Current number of pools is a user-specified value for the number of storage pools the user wishes to utilize. These are assumed to be numbered from 1 to the number specified. This number is fixed by the machine to be equal to the maximum number of pools.

Type of pool tuning determines what the system is doing to tune the performance of a storage pool.

• When no tuning is being done for a pool (hex 00), the system tries to minimize the amount of main storage that is used by each of the jobs in the system independent of the amount of main storage that exists in a pool. The values returned for nondatabase objects and database objects by class will be all zeros to represent that the default values are being used.
• If static tuning is being done (hex 10), the system will use the values specified for pool information to determine the amount of data to transfer to main storage and auxiliary storage.
• When dynamic tuning of transfers to main storage is being done (hex 20), the system bases the amount of data to transfer to main storage based on the demand for storage in the storage pool, the size of the pool, the number of active users in the pool and other performance attributes. The values returned for database objects by class and nondatabase objects is the current value being used by the system to handle the objects.
• When dynamic tuning of transfers to main storage and auxiliary storage is being done (hex 30), the system bases the amount of data to transfer to main storage and to auxiliary storage based on the demand for storage in the storage pool, the size of the pool, the number of active users in the pool and other performance attributes. The values returned for database objects by class and nondatabase objects is the current value being used by the system to handle the objects.

When tuning is requested (hex 10, 20 or 30), the system periodically categorizes database objects into four different performance classes. The classes are:

Class 1

Object access appears to be very random - a disk access is required for nearly each record that is accessed

Class 2

Some locality of reference detected, several records are being accessed per disk access

Class 3

High locality of reference detected, object is being processed in a sequential manner, references are highly clustered, large portions of the object are resident in memory.

Class 4

See following explanation.

The class of a database object is adjusted if the object's size is small in comparison to the available storage in the storage pool. This class adjustment involves adding 1 to the class number, so a class 3 database object (as defined above) would be treated as a class 4 if it is small in comparison to the available storage in the storage pool.

Reference information for determining an object's class is collected periodically and by storage pool so an object's class will vary over time and by storage pool.

Changed page handling affects when the system will write changed pages to auxiliary storage. When the system page replacement algorithm (hex 00) is specified as the changed page handling mechanism, the system will transfer changed pages to auxiliary storage when:

• Explicitly requested to transfer the page (for example, Set Access State (SETACST) instruction)
• There is a demand for pages in the pool

• Explicitly requested to transfer the page (for example, Set Access State (SETACST) instruction)
• There is a demand for pages in the pool
• Periodically look for changed pages in a pool and transfer the changed pages to auxiliary storage

Blocking factor determines how much data should be brought into main storage when the object is needed in main storage.

Allow exchange operations controls which method the system should use to find main storage to hold data. With the exchange method (hex C5), the system uses the page frames associated with a specific object to satisfy the request. If exchange operations are disabled (hex D5), the system will use the normal page replacement algorithm to find page frames for the request. If objects should be treated as good candidates for replacement (hex D9), the system makes the page frames associated with the object being exchanged a good replacement candidate but uses the normal page replacement algorithm to find page frames for the request.

Handling of requests to transfer object to auxiliary storage determines when the data is transferred to auxiliary storage and when the page frames containing the object are available to contain other data. If purging is active (hex D7) and a request is made to purge the object to auxiliary storage, the system will immediately schedule the request to transfer the data and when the transfer is completed, the page frames containing the data just written will be made available to hold other objects. If writing is active (hex E6) and a request is made to purge the object to auxiliary storage, the system will immediately schedule the request to transfer the data and the page frames are not made good candidates to be reused. If objects are good candidates for replacement (hex D9), the objects are likely to be removed from main storage by transferring the objects to auxiliary storage when the system needs to transfer other objects into main storage. If the system page replacement algorithm is used (hex D5), the system decides when the object should be transferred from main storage to auxiliary storage.

Delay cost scheduling information (Hex 15)

MPL Control Data (Hex 16)

Machine-Wide MPL Control:

• Maximum number of MPL classes is the largest number of MPL classes allowed in the machine. These are assumed to be numbered from 1 to the maximum.
• Current number of MPL classes is a user-specified value for the number of MPL classes in use. They are assumed to be numbered from 1 to the current number.
• MPL (max) always materializes as hex FFFFFFFF. The machine does not support a machine-wide limit for the number of threads in active state.
• Ineligible event threshold always materializes as hex FFFFFFFF. The machine does not monitor a machine-wide threshold for the number threads in ineligible state.
• MPL (current) is the current number of threads in the active state.
• Number of threads in the ineligible state is the number of threads not currently active because of enforcement of class MPL rules.

MPL Class Information

• MPL class information is data in an array that is associated with an MPL class by virtue of its ordinal position within the array.
• MPL (max) is the number of threads assigned to the class which may be concurrently active.
• Ineligible event threshold is a number which, if exceeded by the number of threads in ineligible state defined below, will cause an event to be signaled.
• MPL (current) and number of threads in ineligible state are as defined above but apply only to threads assigned to the class.
• Number of threads assigned to class is the total number of threads, in any state, assigned to the class.
• The total number of transitions among the active, wait, and ineligible states by threads assigned to a class are:
  1. Number of active to ineligible transitions
  2. Number of active to MI wait transitions
  3. Number of MI wait to ineligible transitions
• Note that transitions from wait state to active state can be derived as (2 - 3) and transitions from ineligible state to active state as (1 + 3). On overflow, the machine wraps these UBin(4) numbers from hex FFFFFFFF to 0 without any indication of error.

Allocation and De-allocation counts per task and thread (Hex 17)

The materialized data should not be used for accounting purposes as the intended use of this data is for diagnostic purposes, such as, to help determine which task or thread is currently consuming large amounts of space on the system. The user of this MI instruction should be aware that process initiation and termination will be slowed by over use.

Note that through appropriate setting of the number of bytes provided for materialization field for operand 1, the amount of information to be materialized for this option can be reduced thus avoiding the processing for unneeded information.

• Requested function is the option on how the data should be returned back to the requester. This field is input from the requester. The sorting is performed on all the data before determining which elements will be returned.
• Total number of tasks and threads is the total number of tasks and threads on the system at the time of the sampling. This includes all machine tasks, initial threads and secondary threads.
• Total number of entries is the number of task and thread information elements that are being returned.

Task and thread information

• Task and thread indicator specifies whether the element is for a task, initial thread or a secondary thread.
• Task name is the name of the task. All threads within a process will have the same process control space (PCS) name.
• Task identifier contains a value assigned by the machine, which uniquely identifies the task within the machine for as long as the task exists.
• Thread identifier contains a value assigned by the machine, which uniquely identifies this thread within its process. The value will not be re-assigned to another thread within the process. For a task this field will be zero.
• Allocated storage is the amount of auxiliary storage in pages that has been allocated by this task or thread. The value of this field only increases over time.
• De-allocated storage is the amount of auxiliary storage in pages that has been de-allocated by this task or thread. The value of this field only increases over time.
• Delta storage is the amount of auxiliary storage in pages that is the difference between the amount allocated and de-allocated by this task or thread. If the de-allocated storage is larger than the allocated storage, then the field will be set to zero.

Processor Multi-tasking mode (Hex 18)

This option is used to materialize the pending and current values for the processor multi-tasking mode.

The current mode field returns the current value for the processor multi-tasking mode.

The pending mode field returns the pending value for the processor multi-tasking mode.

If the pending mode is set to a supported value for the hardware, the current mode will be changed to the pending mode. However, if the pending mode is set to an unsupported value for the hardware, the value specified for pending mode will be ignored and the pending mode will be reset to the current mode. At IPL, the pending mode may be set to the current mode after changes to the current mode, if any, have been applied.

For a physical machine with firmware level hex 10:

• Current mode and pending mode are materialized for the current partition. The default value is 2 (processor multitasking is system controlled). Both the current mode and pending mode are set to the default value on the initial IPL following an install.

Dynamic priority adjustment mode (Hex 19)

Changes to the dynamic priority adjustment mode take effect on the subsequent IPL. The default value for the current mode field is "enabled" even though the capability is not available on all hardware models. Dynamic priority adjustment mode will not be effective if delay cost scheduling (see option hex 15) has been disabled.

The underlying function, Server Dynamic Tuning, allows the interactive workload on the system to be depressed to allow the non-interactive workload more throughput. As interactive tasks utilize more than a predetermined amount of CPU cycles, their priorities will be lowered to allow non-interactive tasks to obtain CPU cycles. As interactive tasks utilize less than a predetermined amount of CPU cycles, their priorities will be raised toward their assigned priority.

Disk collection / balancing status (Hex 1A)

• ASP number is an input value that uniquely identifies the auxiliary storage pool from which the current collection and balancing status is desired. The ASP number may have a value from 1 through 255. A value of 1 indicates the system ASP. A value of 2 through 255 indicates a user ASP.
• Type of disk balance identifies the type of balance activity that is currently running or was done last for this ASP.
• ASP disk collection status identifies the requested ASP's current collection status.
  • No collection in process (hex 0000) indicates that no collection is active for this ASP. Also no collection data is available for balancing.
  • Collection in process (hex 0001) indicates a collection is currently in process. The collection data consists of how frequently data is referenced from a disk arm in the ASP and how busy the disk is during the collection period.
  • Canceling the collection (hex 0002) indicates the collection has been cancelled. The collection can be resumed or can be used for balancing purposes.
  • Holding the collection data for balancing only (hex 0003) indicates that the collection data is being held for further movement or clearing.
  • Clearing the collection data (hex 0004) indicates the collection is currently being cleared.
  • Holding the collection data for collection or balancing (hex 0005) indicates the collection is currently being held for additional collection, balancing or clearing purposes.
• ASP disk balancing status identifies the requested ASP's current balancing status.
  • No balancing in process (hex 0000) indicates that no balancing is active for this ASP.
  • Balancing in process (hex 0001) indicates a balancing is currently in process. A disk collection must have been run prior to this activity.
  • Balancing has been cancelled (hex 0002) indicates the balancing is being cancelled. The balancing can be resumed or the collection data can be cleared.
  • Balancing has been suspended (hex 0003) indicates the balancing was previously stopped. The balancing can be resumed or the collection data can be cleared.
  • Balancing has completed (hex 0004) indicates the balancing has completed normally.
• Date and time the collection last started. This is an EBCDIC date and time representation indicating when the last collection period was started. If no collection has been started, then the field will be binary zeroes.
  • Year collection last started
  • Month collection last started
  • Day collection last started
  • Hour collection last started
  • Minute collection last started
• ASP contains compressed and non-compressed units flag specifies whether or not the ASP has compressed and non-compressed configured units. A value of binary 1 indicates that both compressed and non-compressed units exist in this ASP. A value of binary 0 indicates that a mix of compressed and non-compressed units does not exist in this ASP.
• ASP is online flag specifies if the ASP is available to the system. If this ASP is an independent ASP, a value of binary 1 indicates the independent ASP is varied on. If this ASP is an independent ASP, a value of binary 0 indicates the independent ASP is varied off. A value of binary 1 is returned if the ASP is a basic ASP or a system ASP.
• Remote mirrored independent ASP is partially varied on flag specifies that the remote mirrored copy of an independent ASP is partially varied on. If this ASP is an independent ASP, a value of binary 1 indicates that it is the mirror copy in a remotely mirrored independent ASP and that the independent ASP is partially varied on. If this ASP is an independent ASP, a value of binary 0 indicates the independent ASP is varied off. A value of binary 0 is returned if the ASP is a basic ASP or a system ASP.
• Number of allocated auxiliary storage units in ASP is the number of configured units logically addressable by the system as units for this ASP. This is the number of configured, non-mirrored units plus the number of mirrored pairs allocated in the ASPs. The total number of units (actuator arms) on the system is the sum of the allocated auxiliary storage units plus the number of unallocated auxiliary storage units plus the number of pairs of mirrored units. For example, each 9335 enclosure represents two units. Information on these units is materialized as part of the unit information. Any two units of the same size may be associated to form a mirrored pair. Association of two units as a mirrored pair reduces the amount of logically available storage by the number of bytes contained on one of the mirrored units in the mirrored pair.
• Cumulative minutes the collection has run. Since the collection can be stopped and restarted several times this gives the user an indication of how long the collection has been run. When the collection is cleared this field is reset to binary zeroes.
• Date and time the collection last ended. This is an EBCDIC date and time representation indicating when the last collection period was ended. If no collection has ended, then the field will be binary zeroes.
  • Year collection last ended
  • Month collection last ended
  • Day collection last ended
  • Hour collection last ended
  • Minute collection last ended
• Date and time the balancing last started. This is an EBCDIC date and time representation indicating when the last balancing period was started. If no balancing has been started, then the field will be binary zeroes.
  • Year balancing last started
  • Month balancing last started
  • Day balancing last started
  • Hour balancing last started
  • Minute balancing last started
• Cumulative minutes the balancing has run. Since the balancing can be stopped and restarted several times this gives the user an indication of how long the balancing has been run. When the collection is cleared this field is reset to binary zeroes.
• Date and time the balancing last ended. This is an EBCDIC date and time representation indicating when the last balancing period was ended. If no balancing has been ended, then the field will be binary zeroes.
  • Year balancing last ended
  • Month balancing last ended
  • Day balancing last ended
  • Hour balancing last ended
  • Minute balancing last ended
• Amount to be moved. This is the target amount in megabytes that the balancing function will attempt to re-balance.
• Amount moved. This is the amount in megabytes that the balancing function has moved to re-balance.

Materialize mapping of partition processors (Hex 1B)

Number of processors for which information is being materialized is the number of the virtual processors that are currently active in the partition. Number of processors for which information is being materialized is less than or equal to the number of processors configured on the machine returned by MATRMD option hex 13.

Physical processor token provides an index that can be used to correlate the virtual processor to its vital product data returned by MATMATR option hex 012C for a system with a maximum of 16 processors. Physical processor token is the index of the physical machine processor (starting from 1) that a partition virtual processor is currently mapped to.

For a partition sharing physical processors, this mapping only provides a snapshot. At a given instance, a partition processor may be mapped to any of the physical processors in the shared pool in which the partition is running.

DASD Management Status (Hex 1C)

This option returns status information from the DASD manager.

The format of the template for the status information from the DASD manager follows:

The handle is an optional input field. If provided, the handle will return the status for the open connection to DASD management. If there is not an open connection to DASD management or the handle does not match the handle of the open connection, action identifier will be set to 5002 and no additional information will be returned. If handle is set to hex zeros, all available information about DASD management will be returned, including status, action identifier, percentage complete, number of return codes, and return code array. The handle has a timeout associated with it. If the handle is not used to perform an action or is not used to check the status using this MATRMD option within 5 minutes after an action completes, the connection to DASD Management is automatically closed and the handle is invalidated and cannot be used for any more DASD management actions. This timeout counter only starts when an action is completed. For example, if a long running action such as add disk units takes an hour to complete, the timer will be started after the add disk units action completes. The connection will close 5 minutes after the add disk units has completed if the handle has not been used to request another action or check the status within that 5 minutes. Once the handle is used to check the status or request a new action, the timer is reset.

The status field is an output field which specifies the status of DASD Management.

The action identifier field is an output field which specifies the most recently attempted action if no action is in progress or the action in progress. If the action specified is 5001 (no actions performed), or 5002 (DST/service tools action), the status field is the only other valid output field.

The percentage complete field is an output field which identifies the percentage complete of an action being performed for an MI user. This field is not defined if DASD Management is currently being used by DST/service tools or if no action is currently being performed. The range of percentages that may be returned is 0 through 100.

The number of return codes is an output field that identifies the number of return codes in the return code array. If the number of return codes is zero and the percentage complete is 100, the action completed successfully.

The return code array is an output field that refers to an array of return codes and data associated with the action identifier. If there is not enough space allocated for all return codes in the array, no return code information will be filled in.

The format of an entry in the return code array follows:

The return code field is an output field which identifies one of the return codes of the most recently completed DASD management action.

The return code details field is an output field which identifies error data associated with the return code. If the failure involves a disk unit, the resource name of that disk unit will be placed in the first ten characters of this field. The remaining 20 characters of this field are reserved for future use. If the failure does not involve a disk unit, this field will be set to binary zeros and should be ignored.

DASD Management Disk Information (Hex 1D)

This option provides information about a list of disks.

The format of the template for disk information follows:

The number of elements in disk information array field is an input/output field which specifies the number of elements in the disk information array.

The length of element in disk information array field is an input field which specifies the length, in bytes, of an entry in the disk information array field.

The disk information array is an array of disk resource names and information about those disks. The format of the disk information array is as follows:

The disk resource name field is an input field which specifies the name of the disk unit to return information about. The disk unit resource name of the first element in the array may have the special value of '*UNCONFIG' which indicates all unconfigured disk units in the system will be found and the associated parity information for those disks will be returned. The number of elements in disk information array field will be updated to the number of elements provided.

The disk unit may be included in a new parity set field is an output field which specifies if the disk resource name can be included as one of the disks in that set when creating a new parity set.

The disk unit may be included in existing parity set field is an output field which specifies if disk resource name is eligible to be on a list of disks that is to be added to that parity set.

The disk unit not found field is set to a 1 if a disk unit corresponding to the disk resource name was not found on the system.

The parity set number field is an output field that specifies the parity set a disk unit will belong to after it has been included in a parity set. The value of this field should be ignored if the disk unit is not allowed in a new or existing parity set.

The capacity available after parity started field is an output field that specifies the capacity of the disk unit in millions of bytes after this disk unit becomes part of a parity set. The value of this field should be ignored if the disk unit is not allowed in a new or existing parity set.

The frame associated with disk unit field is an output field that identifies the frame resource to which the disk unit is attached. This field may be used to determine the physical location of the disk unit.

The frame ID associated with disk unit field is an output field that identifies the frame id to which the disk unit is attached. This field may be used to determine the physical location of the disk unit.

Interactive Utilization Data (Hex 1E)

This option provides information about interactive utilization. For additional information, see manual SC41-0607 iSeries Performance Capabilities Reference manual which is available in the Information Center.

Interactive threshold is the highest level of interactive processor utilization which can be sustained without causing a disproportionate increase in system overhead. the value returned is the fraction of processor capacity, expressed in tenths of a percent. For example, a value of 237 means that the threshold is 23.7%.

On a machine with no limit on interactive utilization, the value returned will be 1000 (100%).

Interactive limit is the maximum sustainable level of interactive processor utilization. The machine determines the interactive limit based on the interactive feature. The value returned is the fraction of processor capacity, expressed in tenths of a percent. For example, a value of 275 means that the limit is 27.5%.

On a machine with no limit on interactive utilization, the value returned will be 1000 (100%).

Interactive processor usage since IPL is the total processor time, used by interactive processes since IPL. If the system does not support this metric, a value of hex 0000000000000000 is returned. If the system does support this and needs to return a value of 0, a value of hex 0000000000001000 is returned. For all other cases, the significance of bits within this field is the same as that defined for the time-of-day clock. On a machine with more than one virtual processor, the value returned will be the sum of the interactive processor usage since IPL for all virtual processors.

Interactive processor usage above threshold since IPL is the total processor time, used by interactive processes, since IPL, during which the interactive utilization exceeded the interactive threshold. On a machine with more than one virtual processor, the value returned will be the sum of the interactive processor usage above threshold since IPL for all virtual processors. The significance of bits within this field is the same as that defined for the time-of-day clock.

For a partition using shared processors, interactive processor usage since IPL and interactive processor usage above threshold since IPL are scaled by the configured capacity of the partition. This allows CPU utilization calculations to be done as if the partition was using whole physical processors.

Auxiliary Storage Pool Information (Short format) (Hex 1F)

The auxiliary storage pool information describes the ASPs (auxiliary storage pools) which are configured within the machine. This option does not return information for independent ASPs which are varied off. You can use option "Auxiliary Storage Pool Information including offline Independent ASPs (Hex 22)" to return information about independent ASPs which are varied off.

Also note that through appropriate setting of the number of bytes provided field for operand 1, the amount of information to be materialized for this option can be reduced thus avoiding the processing for unneeded information.

Number of ASPs is the number of ASPs configured within the machine. One, the minimum value, indicates just the system ASP exists and that there are no user ASPs configured. Up to 255 user ASPs can be configured. The system ASP always exists. This number of ASPs include the system ASP, basic ASPs (that is, user ASPs which cannot be varied on), and independent ASPs which are currently varied on to this system.

ASP information is repeated once for each ASP configured within the machine. The number of ASPs configured is specified by the number of ASPs field. ASP 1, the system ASP, is materialized first. Because the system ASP always exists, its materialization is always available. The information about the user ASPs is materialized after the system ASP in ascending numerical order. There may be gaps in the numerical order. For example, if user ASPs 3 and 75 are configured, the materialize will produce information on ASP 1, ASP 3, and ASP 75 in that order.

ASP number uniquely identifies the auxiliary storage pool. The ASP number may have a value from 1 through 255. A value of 1 indicates the system ASP. A value of 2 through 255 indicates a user ASP. Note that independent ASPs have a value of 33 through 255.

Number of allocated auxiliary storage units in ASP is the number of configured units logically addressable by the system as units for this ASP. This is the number of configured, non-mirrored units plus the number of mirrored pairs allocated in the ASPs. Any two units of the same capacity may be associated to form a mirrored pair. Association of two units as a mirrored pair reduces the amount of logically available storage by the number of bytes contained on one of the mirrored units in the mirrored pair.

ASP resource name specifies the name which the user has assigned to this auxiliary storage pool. Blanks (hex value 40) are returned for ASPs which do not have names. Only independent ASPs have names. The ASP name is the resource name in the LUD.

ASP overflow flag indicates whether or not object allocations directed into the basic ASP have overflowed into the system ASP. A value of binary 1 indicates overflow; binary 0 indicates no overflow. This flag does not apply to the system ASP and a value of binary 0 is always returned for it. This flag does not apply to independent ASPs and a value of binary 0 is always returned for independent ASPs.

Independent ASP specifies whether or not the ASP is an independent ASP; that is, a user ASP that can be varied on or off. A value of binary 1 indicates the ASP is an independent ASP. A value of binary 0 indicates that this ASP is a basic ASP (a user ASP that cannot be varied on or off).

ASP protected specifies whether or not the ASP is configured to be protected from a single disk failure. A value of binary 1 indicates that the ASP is protected. All of the disk units in this ASP must be either device parity protected or mirror protected. A value of binary 0 indicates that the disk units in the ASP are not mirror protected, and there is no requirement that the disk units in the ASP be device parity protected.

User ASP MI state indicates the state of the user ASP. A value of binary 1 indicates that the user ASP is in the 'new' state. This means that a context may be allocated in this user ASP. A value of binary 0 indicates that the user ASP is in the 'old' state. This means that there are no contexts allocated in this user ASP. This flag has no meaning for the system ASP and a value of binary 0 will always be returned for the system ASP. A value of binary 1 is always returned for independent ASPs.

Independent ASP address threshold exceeded flag is only valid for an Independent ASP and specifies whether or not the independent ASP address threshold, selected by the machine, has been exceeded. A value of binary 1 indicates the threshold has been exceeded and the Independent ASP is running low on addresses. A value of binary 0 indicates that the address threshold has not been exceeded.

Number of addresses remaining in independent ASP contains the number of virtual addresses remaining for use by the independent ASP. This field only has meaning for an independent ASP. The information in this field is only valid if the independent ASP address threshold exceeded flag is set to binary 1.

ASP number of the primary ASP contains the ASP number of the primary ASP. This value only has meaning for an independent ASP. If the ASP is a secondary ASP, this field contains the ASP number of the primary ASP. If the ASP is a primary ASP, this value is the same as the ASP number. If the ASP is a UDFS ASP or is not an independent ASP, a value of hex 0000 is returned.

Primary ASP flag indicates that the independent ASP is a primary ASP in an ASP group. A primary ASP defines a collection of directories and contexts and may have secondary ASPs associated with it. This flag only has meaning for an independent ASP. A value of binary 1 indicates the independent ASP is a primary ASP. A value of binary 0 indicates the independent ASP is not a primary ASP.

Secondary ASP flag indicates that the independent ASP is a secondary ASP in an ASP group. A secondary ASP is associated with a primary ASP. There can be many secondary ASPs associated with the same primary ASP. The secondary ASP defines a collection of directories and contexts. This flag only has meaning for an independent ASP. A value of binary 1 indicates the independent ASP is a secondary ASP. A value of binary 0 indicates the independent ASP is not a secondary ASP.

UDFS ASP flag indicates that the independent ASP is a UDFS (User-defined File System) ASP. This type of independent ASP cannot be a member of an ASP group. This flag only has meaning for an independent ASP. A value of binary 1 indicates the independent ASP is a UDFS ASP. A value of binary 0 indicates the independent ASP is not a UDFS ASP.

Restricted ASP flag indicates that the ASP is restricted. This flag only has meaning for a Primary ASP -- a value of binary 0 is returned for all other ASP types. A value of binary 1 indidicates the Primary ASP is restricted. A value of binary 0 indicates the Primary ASP is not restricted.

IASP vary-off is in progress specifies whether or not the independent ASP is being varied off. A value of binary 1 indicates that the ASP is being varied off; binary 0 indicates that it is not being varied off.

Auxiliary Storage Information including offline Independent ASPs (Hex 20)

The auxiliary storage information describes the ASPs (auxiliary storage pools) which are configured within the machine and the units of auxiliary storage currently allocated to an ASP or known to the machine but not allocated to an ASP. This option returns information for all ASPs including independent ASPs that are varied off. Option "Auxiliary Storage Information (Hex 12)" returns the same information but does not return information for independent ASPs that are varied off.

Also note that through appropriate setting of the number of bytes provided field for operand 1, the amount of information to be materialized for this option can be reduced thus avoiding the processing for unneeded information. As an example, by setting this field to only provide enough bytes for the common 16 byte header, plus the option hex 20 control information, plus the system ASP entry of the ASP information, you can get just the information up through the system ASP entry returned and avoid the overhead for the user ASPs and unit information.