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