1425 lines
47 KiB
HTML
1425 lines
47 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>Retrieve Monitored Resource Information (QfpadRtvMonitoredResourceInfo) 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. -->
|
||
|
<!-- Created for V5R4 on 040611 by EDDELEON -->
|
||
|
<!-- Change history: -->
|
||
|
<!-- YYMMDD INITIALS change description -->
|
||
|
<!-- DCR/PTR Rel Date Person : Description of change -->
|
||
|
<!-- D99682 5D40 040611 EDDELEON: New API -->
|
||
|
<!-- D99682 5D40 050408 NLKRYKA: Resource_Status I0 change -->
|
||
|
<!-- D99682 5D40 050503 NLKRYKA: Attribute Global Status I0 change-->
|
||
|
<!-- D99682 5D40 050720 NLKRYKA/RBIERLE: API review comments -->
|
||
|
<!-- End Header Records -->
|
||
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
</head>
|
||
|
<body>
|
||
|
<!-- Java sync-link -->
|
||
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
</script>
|
||
|
|
||
|
<a name="Top_Of_Page"></a>
|
||
|
|
||
|
<h2><img src="delta.gif" alt="Start of change">Retrieve Monitored Resource Information
|
||
|
(QfpadRtvMonitoredResourceInfo) API</h2>
|
||
|
|
||
|
<div class="box" style="width: 70%;">
|
||
|
<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">Format of receiver variable</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(8)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">4</td>
|
||
|
<td align="left" valign="top">Manager type</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(10)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">5</td>
|
||
|
<td align="left" valign="top">Monitored resource information</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(*)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">6</td>
|
||
|
<td align="left" valign="top">Length of monitored resource information</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Binary(4)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">7</td>
|
||
|
<td align="left" valign="top">Format of monitored resource information </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">Server information</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(*)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">9</td>
|
||
|
<td align="left" valign="top">Length of server information</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Binary(4)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">10</td>
|
||
|
<td align="left" valign="top">Format of server information </td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(8)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">11</td>
|
||
|
<td align="left" valign="top">Server defined output</td>
|
||
|
<td align="left" valign="top">Output</td>
|
||
|
<td align="left" valign="top">Char(*)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">12</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>
|
||
|
Service Program Name: QFPADAP1<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
Default Public Authority: *EXCLUDE<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
Threadsafe: Yes<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
</div>
|
||
|
|
||
|
<p>The Retrieve Monitored Resource Information (QfpadRtvMonitoredResourceInfo) API
|
||
|
returns information about monitored resources.</p>
|
||
|
|
||
|
<p>A monitored resource may be a system object or a set of attributes not associated with a specific system object, such as the
|
||
|
set of system environment variables. System objects and attributes are monitored by the system to allow notifications of changes to
|
||
|
the attributes to be passed to a supporting system function or application for system management purposes.
|
||
|
</p>
|
||
|
|
||
|
<p>This API will do the following when the manager type is *ADMDMN:
|
||
|
</p>
|
||
|
|
||
|
<ul>
|
||
|
<li>Return information about monitored resource entries that is stored on the system where the API was called. If cluster
|
||
|
resource services is not started or the cluster administrative domain is partitioned, the information returned may
|
||
|
not reflect the most current information in the cluster administrative domain.</li>
|
||
|
</ul>
|
||
|
|
||
|
<h3>Authorities and Locks</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><strong><em>Monitored resources</em></strong></dt>
|
||
|
|
||
|
<dd>The following authorities and locks are required if the API user requests information about these monitored resource types.</dd>
|
||
|
|
||
|
<dd><em>User Profile</em></dd>
|
||
|
<dd> *READ</dd>
|
||
|
<dd><em>Job Description Object Authority</em></dd>
|
||
|
<dd> *USE</dd>
|
||
|
<dd><em>Job Description Library</em></dd>
|
||
|
<dd> *EXECUTE</dd>
|
||
|
<dd><em>Class Object Authority</em></dd>
|
||
|
<dd> *USE</dd>
|
||
|
<dd><em>Class Library</em></dd>
|
||
|
<dd> *EXECUTE</dd>
|
||
|
<dd><em>Independent Auxiliary Storage Pool (ASP) Device Description Authority</em></dd>
|
||
|
<dd> *USE</dd>
|
||
|
<dd><em>Independent Auxiliary Storage Pool (ASP) Device Description Lock</em></dd>
|
||
|
<dd> *EXCLRD</dd>
|
||
|
<dd><em>Network Attribute</em></dd>
|
||
|
<dd> NONE</dd>
|
||
|
<dd><em>System Environment Variable Authority</em></dd>
|
||
|
<dd> NONE</dd>
|
||
|
<dd><em>TCP/IP Attribute Authority</em></dd>
|
||
|
<dd> NONE</dd>
|
||
|
|
||
|
</dl>
|
||
|
|
||
|
<h3>Required Parameter Group</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><strong>Receiver variable</strong></dt>
|
||
|
|
||
|
<dd>OUTPUT; CHAR(*)
|
||
|
|
||
|
<p>The receiver variable to hold the monitored resource entry information.</p>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Length of receiver variable</strong></dt>
|
||
|
|
||
|
<dd>INPUT; BINARY(4)
|
||
|
|
||
|
<p>The length of the receiver variable in bytes. The minimum length is 8 bytes. If the length of the receiver variable
|
||
|
is not large enough to hold the repeating fields of the information specified in the Monitored Resource Entry Information Format Name
|
||
|
parameter, only the number of records specified by the Number of Records Returned field will be returned.</p>
|
||
|
|
||
|
<dt><strong>Format of receiver variable </strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(8)
|
||
|
|
||
|
<p>The format name of the monitored resource entry information which will be returned. The following format names are allowed:</p>
|
||
|
|
||
|
<p><a href="#Qfpad_DENR0100"><em>DENR0100</em></a> Information about one or more monitored resource entries.</p>
|
||
|
<p><a href="#Qfpad_DENR0200"><em>DENR0200</em></a> Information about the monitored attributes for a single monitored resource.</p>
|
||
|
|
||
|
<dt><strong>Manager type</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(10)
|
||
|
|
||
|
<p>The management function which is to monitor the resource. *ADMDMN must be specified.</p>
|
||
|
|
||
|
<dt><strong>Monitored resource information</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(*)
|
||
|
|
||
|
<p>Information to identify the monitored resource or resources that are to be returned. See EENT0100 for a description of the monitored resource
|
||
|
information.</p>
|
||
|
|
||
|
<dt><strong>Length of monitored resource information</strong></dt>
|
||
|
|
||
|
<dd>INPUT; BINARY(4)
|
||
|
|
||
|
<p>The length of the monitored resource information.</p>
|
||
|
|
||
|
<dt><strong>Format of monitored resource input information</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(8)
|
||
|
|
||
|
<p>The format name of the monitored resource information. The following format name is allowed:</p>
|
||
|
|
||
|
<p><a href="#Qfpad_EENT0100"><em>EENT0100</em></a> The format of monitored resource input information in a cluster administrative domain.</p>
|
||
|
|
||
|
<dt><strong>Server information</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(*)
|
||
|
|
||
|
<p>Information about the server. When the manager type is *ADMDMN, the server is the cluster resource group associated with the cluster administrative domain.</p>
|
||
|
|
||
|
<dt><strong>Length of server information</strong></dt>
|
||
|
|
||
|
<dd>INPUT; BINARY(4)
|
||
|
|
||
|
<p>The length of the server information.
|
||
|
The length of the server information parameter must be set to the size of the
|
||
|
SRVI0100 structure.</p>
|
||
|
|
||
|
<dt><strong>Format of server information</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(8)
|
||
|
|
||
|
<p>The format name of the server information. The following format name is allowed:</p>
|
||
|
|
||
|
<p><a href="#Qfpad_SRVI0100"><em>SRVI0100</em></a> The format of the server information when the server is a cluster.</p>
|
||
|
|
||
|
<dt><strong>Server defined output</strong></dt>
|
||
|
|
||
|
<dd>OUTPUT; CHAR(*)
|
||
|
|
||
|
<p>Information returned which is specific to the server type. When the manager type is *ADMDMN, the following
|
||
|
information is returned:</p>
|
||
|
<p><strong>Information status. </strong></dt>One byte which indicates the consistency of the retrieved
|
||
|
information.</p>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>0</em></td>
|
||
|
<td align="left" valign="top" width="95%">The information is consistent for all active nodes in the cluster administrative domain.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>1</em></td>
|
||
|
<td align="left" valign="top" width="95%">The information retrieved from the node running the API may not be consistent with all active nodes in the cluster. In order to obtain consistent information:</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<table>
|
||
|
<tr>
|
||
|
<td width="13%"></td>
|
||
|
<td align="left" valign="top" width="87%">Call this API on an active node in the cluster, if the node running the API is not active.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td width="13%"></td>
|
||
|
<td width="87%" align="left" valign="top">Start Cluster Resource Services on the node running the API if it is not active.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
|
||
|
<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>
|
||
|
|
||
|
|
||
|
<h3><a name="Qfpad_DENR0100">Monitored Resource Entry Information (DENR0100 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%">Bytes returned</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">Bytes available</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">Offset to first record</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">Length of fixed portion of record</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">Number of records returned</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong>
|
||
|
Record entry information. These fields are repeated for each record entry returned.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Displacement to next record</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Monitored resource type</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Monitored resource library name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Global status</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Resource status</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Displacement to monitored resource name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Length of monitored resource name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Displacement to node array</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Length of node array entry</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Number of node array entries</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Displacement to message information</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Length of message information</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong>
|
||
|
Use the displacements in the fixed portion of the record to get to the following fields.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">CHAR(*)</td>
|
||
|
<td align="left" valign="top">Monitored resource name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">CHAR(*)</td>
|
||
|
<td align="left" valign="top">Node array</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">CHAR(*)</td>
|
||
|
<td align="left" valign="top">Message information</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<h3><a name="Qfpad_DENR0200">Attribute Information (DENR0200 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%">Bytes returned</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">Bytes available</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">Offset to first record</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">Length of fixed portion of record</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">Number of records returned</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong>
|
||
|
Record entry information. These fields are repeated for each record entry returned.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Displacement to next record</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Monitored resource type</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Monitored resource library name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Global status</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Resource status</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Displacement to monitored resource name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Length of monitored resource name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Displacement to attribute list</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Length of fixed portion of attribute list entry</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Number of attribute list entries</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong>
|
||
|
Use the displacements in the fixed portion of the record to get to the following fields.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">CHAR(*)</td>
|
||
|
<td align="left" valign="top">Monitored resource name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">CHAR(*)</td>
|
||
|
<td align="left" valign="top">Attribute list</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
<h3><a name="Header_8">Field Descriptions</a></h3>
|
||
|
|
||
|
<p><strong>Attribute list.</strong> A list of attributes for the monitored resource described in the current record.
|
||
|
This structure consists of a list of repeating entries. See <a href="#Attribute" >Attribute List Entry Format</a>
|
||
|
for the format of a single entry.</p>
|
||
|
|
||
|
<p><strong>Bytes available.</strong> The number of bytes of data available to be returned to the user.
|
||
|
If all data is returned, this is the same as the number of bytes returned. If the receiver variable was not
|
||
|
big enough to contain all of the data, this is the number of bytes that can be returned.</p>
|
||
|
|
||
|
<p><strong>Bytes returned.</strong> The number of bytes of data returned to the user. This is the lesser of the number of
|
||
|
bytes available to be returned or the length of the receiver variable. If the requested monitored resource is not monitored by the system, this value
|
||
|
will be set to 20.</p>
|
||
|
|
||
|
<p><strong>Displacement to attribute list.</strong> The displacement in bytes from the start of the current entry to the attribute list.</p>
|
||
|
|
||
|
<p><strong>Displacement to message information.</strong> The displacement in bytes from the start of the current entry to the message information.</p>
|
||
|
|
||
|
<p><strong>Displacement to monitored resource name.</strong> The displacement in bytes from the start of the current entry to the monitored resource name field.</p>
|
||
|
|
||
|
<p><strong>Displacement to next record.</strong> The displacement in bytes from the start of the current entry to the next
|
||
|
entry.</p>
|
||
|
|
||
|
<p><strong>Displacement to node array.</strong> The displacement in bytes from the start of the current entry to the node
|
||
|
array. This will be set to 0 if the global status for the monitored resource is not set to 1 (INCONSISTENT).</p>
|
||
|
|
||
|
<p><strong>Global status.</strong> The status of the resource across the active cluster administrative domain. Possible values are:</p>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>0</em></td>
|
||
|
<td align="left" valign="top" width="15%"><em>CONSISTENT</em></td>
|
||
|
<td align="left" valign="top" width="80%">The values for all the resource's attributes monitored by the system are the same within the
|
||
|
cluster administrative domain.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>1</em></td>
|
||
|
<td align="left" valign="top"><em>INCONSISTENT</em></td>
|
||
|
<td align="left" valign="top">One or more of the monitored attributes for a monitored resource entry are not set to the value known by the
|
||
|
cluster administrative domain on one or more nodes in the domain.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>2</em></td>
|
||
|
<td align="left" valign="top"><em>PENDING</em></td>
|
||
|
<td align="left" valign="top">The values of the monitored attributes are in the process of being synchronized across
|
||
|
the cluster administrative domain.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>3</em></td>
|
||
|
<td align="left" valign="top"><em>ADDED</em></td>
|
||
|
<td align="left" valign="top">The monitored resource entry and its attributes have been added to the monitored resource directory
|
||
|
in the cluster administrative domain but has not yet been synchronized.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p><strong>Length of fixed portion of attribute list entry.</strong> The length, in bytes, of the
|
||
|
fixed fields in an attribute list entry.</p>
|
||
|
|
||
|
<p><strong>Length of fixed portion of record.</strong> The length of the fixed fields in the format description.
|
||
|
If no records are returned, this field will be set to 0.</p>
|
||
|
|
||
|
<p><strong>Length of message information.</strong> The length, in bytes, of the message information.</p>
|
||
|
|
||
|
<p><strong>Length of monitored resource name. </strong> The length, in bytes, of the monitored resource entry name.</p>
|
||
|
|
||
|
<p><strong>Length of node array entry.</strong> The length, in bytes, of the node array entry. </p>
|
||
|
|
||
|
<p><strong>Message information.</strong> The message information associated with the monitored resource or attribute.
|
||
|
See <a href="#Qfpad_Message">Message Information Format</a> for
|
||
|
the format of this data.</p>
|
||
|
|
||
|
<p><strong>Monitored resource name.</strong> The name of the monitored resource entry for which information is returned.</p>
|
||
|
|
||
|
<p><strong>Monitored resource library name.</strong> The name of the library of the monitored resource. Blanks will be returned for the monitored resource types *SYSVAL, *NETA, *ENVVAR, *TCPA, and *ALL.</p>
|
||
|
|
||
|
|
||
|
<p><strong>Monitored resource type.</strong> The type of monitored resource. Possible values are:</p>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr>
|
||
|
<td align="left" valign="top" width="15%"><em>*USRPRF</em></td>
|
||
|
<td align="left" valign="top" width="85%">User profile</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*JOBD</em></td>
|
||
|
<td align="left" valign="top">Job description</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CLS</em></td>
|
||
|
<td align="left" valign="top">Class</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ASPDEV</em></td>
|
||
|
<td align="left" valign="top">Independent auxiliary storage pool (ASP) device description</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*SYSVAL</em></td>
|
||
|
<td align="left" valign="top">System value</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*NETA</em></td>
|
||
|
<td align="left" valign="top">Network attributes</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ENVVAR</em></td>
|
||
|
<td align="left" valign="top">System environment variable</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*TCPA</em></td>
|
||
|
<td align="left" valign="top">TCP/IP attributes</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ALL</em></td>
|
||
|
<td align="left" valign="top">Return information for all monitored resource types</td>
|
||
|
</tr>
|
||
|
</table></p>
|
||
|
|
||
|
<p><strong>Node array.</strong> The array of cluster node names that represents the list of nodes where a
|
||
|
problem caused the global status of the monitored resource to be set to INCONSISTENT.</p>
|
||
|
|
||
|
<p><strong>Number of attribute list entries.</strong> The number of entries in the attribute list. If the receiver
|
||
|
variable is not large enough to hold all of the information, this number contains only the number of attribute list
|
||
|
entries actually returned. </p>
|
||
|
|
||
|
<p><strong>Number of node array entries.</strong> The number of entries in the node array.</p>
|
||
|
|
||
|
<p><strong>Number of records returned.</strong> The number of entries in the DENR0100 or DENR0200 format returned.
|
||
|
If the receiver variable is not large enough to hold all of the information, this number contains only the number
|
||
|
of record entries actually returned. If no records are returned, this field is set to 0.</p>
|
||
|
|
||
|
<p><strong>Offset to first record.</strong> The offset, in bytes, from the beginning of the receiver variable to
|
||
|
the first record. If no entries are returned, the offset is set to zero. </p>
|
||
|
|
||
|
<p><strong>Reserved.</strong> This field will be set to hexadecimal zeroes.</p>
|
||
|
|
||
|
<p><strong>Resource status.</strong> The resource status of the monitored resource on the local node.The following values are valid:</p>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>0</em></td>
|
||
|
<td align="left" valign="top" width="10%"><em>CURRENT</em></td>
|
||
|
<td align="left" valign="top" width="85%">There are no pending updates for the monitored resource on this node.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>2</em></td>
|
||
|
<td align="left" valign="top"><em>DLTPND</em></td>
|
||
|
<td align="left" valign="top">The monitored resource has been deleted on a node in
|
||
|
the cluster and the process has not fully completed for all nodes.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>3</em></td>
|
||
|
<td align="left" valign="top"><em>UPDPND</em></td>
|
||
|
<td align="left" valign="top">There are pending updates for the monitored resource on this node.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>4</em></td>
|
||
|
<td align="left" valign="top"><em>RSTPND</em></td>
|
||
|
<td align="left" valign="top">The monitored resource has been restored on a node in the cluster and the process has not fully completed for all nodes.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>5</em></td>
|
||
|
<td align="left" valign="top"><em>RNMPND</em></td>
|
||
|
<td align="left" valign="top">The monitored resource has been renamed on a node in the cluster and the process has not fully completed for all nodes.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>6</em></td>
|
||
|
<td align="left" valign="top"><em>MOVPND</em></td>
|
||
|
<td align="left" valign="top">The monitored resource has been moved on a node in the cluster
|
||
|
and the process has not fully completed for all nodes.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>8</em></td>
|
||
|
<td align="left" valign="top"><em>DLTFAIL</em></td>
|
||
|
<td align="left" valign="top">The resource on has been deleted on a node in the cluster and the administrator needs to complete the process.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>9</em></td>
|
||
|
<td align="left" valign="top"><em>UPDFAIL</em></td>
|
||
|
<td align="left" valign="top">An update of the resource on this node has failed.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>10</em></td>
|
||
|
<td align="left" valign="top"><em>RSTFAIL</em></td>
|
||
|
<td align="left" valign="top">The resource has been restored on a node in the cluster and the administrator needs to complete the process.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>11</em></td>
|
||
|
<td align="left" valign="top"><em>RNMFAIL</em></td>
|
||
|
<td align="left" valign="top">The resource has been renamed on a node in the cluster and the administrator needs to complete the process.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>12</em></td>
|
||
|
<td align="left" valign="top"><em>MOVFAIL</em></td>
|
||
|
<td align="left" valign="top">The resource has been moved on a node in the cluster and the administrator needs to complete the process.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
|
||
|
<h3><a name="Attribute">Attribute List Entry Format</a></h3>
|
||
|
|
||
|
For detailed descriptions of the fields in this table, see <a href="#Attr_FD"> Field Descriptions</a>.
|
||
|
|
||
|
<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%">Displacement to next attribute list 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">Global status</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">Data type</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">Displacement to attribute name</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">Length of attribute name</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">Displacement to attribute value</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">Length of attribute value</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">CHAR(*)</td>
|
||
|
<td align="left" valign="top">Attribute name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="center" valign="top"> </td>
|
||
|
<td align="left" valign="top">CHAR(*)</td>
|
||
|
<td align="left" valign="top">Attribute value</td>
|
||
|
</tr>
|
||
|
|
||
|
</table>
|
||
|
|
||
|
<h3><a name="Attr_FD">Field Descriptions</a></h3>
|
||
|
|
||
|
<p><strong>Attribute name.</strong> The name of the attribute name.</p>
|
||
|
|
||
|
<p><strong>Attribute value.</strong> The value of the attribute. If the global status for the resource is CONSISTENT,
|
||
|
this is the value of the attribute across the active cluster administrative domain. If the global status is INCONSISTENT or PENDING,
|
||
|
this value represents the last attempted change to the attribute within the active cluster administrative domain.</p>
|
||
|
|
||
|
<p><strong>Data Type.</strong> The data type of the attribute value. Valid data types are:</p>
|
||
|
<!--These values are found in cst.xpf/AdminDomain/cstAdmObjectHandler.H -->
|
||
|
<table width="100%">
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>0</em></td>
|
||
|
<td align="left" valign="top" width="95%">Character data</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>1</em></td>
|
||
|
<td align="left" valign="top" width="95%">Binary data</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>2</em></td>
|
||
|
<td align="left" valign="top" width="95%">Object data</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>3</em></td>
|
||
|
<td align="left" valign="top" width="95%">Authority data</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>4</em></td>
|
||
|
<td align="left" valign="top" width="95%">User profile options data</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>5</em></td>
|
||
|
<td align="left" valign="top" width="95%">Supplemental groups data</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>6</em></td>
|
||
|
<td align="left" valign="top" width="95%">Path data</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>7</em></td>
|
||
|
<td align="left" valign="top" width="95%">Message log data</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>8</em></td>
|
||
|
<td align="left" valign="top" width="95%">Text data</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>9</em></td>
|
||
|
<td align="left" valign="top" width="95%">Environment variable data</td>
|
||
|
</tr>
|
||
|
<!--<tr>-->
|
||
|
<!--<td align="center" valign="top" width="5%"><em>10</em></td>-->
|
||
|
<!--<td align="left" valign="top" width="95%">Subsystem description storage pool data</td>-->
|
||
|
<!--</tr> -->
|
||
|
|
||
|
</table>
|
||
|
|
||
|
<p><strong>Displacement to attribute name.</strong> Displacement from the beginning of the
|
||
|
current attribute list entry to the attribute name.</p>
|
||
|
|
||
|
<p><strong>Displacement to attribute value.</strong> The displacement from the beginning of
|
||
|
the current attribute list entry to the value.</p>
|
||
|
|
||
|
<p><strong>Displacement to next attribute list entry.</strong> Displacement from the beginning
|
||
|
of the current attribute list entry to the next attribute list entry. The value will be zero,
|
||
|
if there are no more entries in the list.</p>
|
||
|
|
||
|
<p><strong>Global status.</strong> The status of the resource attribute value
|
||
|
across the active cluster administrative domain. Possible values are:</p>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="5%"><em>0</em></td>
|
||
|
<td align="left" valign="top" width="15%"><em>CONSISTENT</em></td>
|
||
|
<td align="left" valign="top" width="80%">
|
||
|
The value for this attribute is the same on all active nodes in the cluster
|
||
|
administrative domain.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top"><em>1</em></td>
|
||
|
<td align="left" valign="top"><em>INCONSISTENT</em></td>
|
||
|
<td align="left" valign="top">The value for this attribute is not the same
|
||
|
on all active nodes in the cluster administrative domain.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p><strong>Length of attribute name.</strong> The length in bytes of the attribute name.</p>
|
||
|
|
||
|
<p><strong>Length of attribute value.</strong> The length in bytes of the attribute value.</p>
|
||
|
|
||
|
|
||
|
<h3><a name="Qfpad_Message">Message Information Format</a></h3>
|
||
|
|
||
|
For detailed descriptions of the fields in this table, see <a href="#Msg_Inf"> Field Descriptions</a>.
|
||
|
|
||
|
<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%">CHAR(7)</td>
|
||
|
<td align="left" valign="top" width="60%">Message ID</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">7</td>
|
||
|
<td align="center" valign="top">7</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Message file</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">17</td>
|
||
|
<td align="center" valign="top">11</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Message library</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">27</td>
|
||
|
<td align="center" valign="top">1B</td>
|
||
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
<td align="left" valign="top">Reserved</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">Displacement to message replacement data</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">Length of message replacement data</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">Message replacement data CCSID</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">40</td>
|
||
|
<td align="center" valign="top">28</td>
|
||
|
<td align="left" valign="top">CHAR(*)</td>
|
||
|
<td align="left" valign="top">Message replacement data</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
<p>Message information is available when the global status is INCONSISTENT.</p>
|
||
|
|
||
|
<h3><a name="Msg_Inf">Field Descriptions</a></h3>
|
||
|
|
||
|
<p><strong>Displacement to message replacement data.</strong> The displacement in bytes from the beginning of the message information
|
||
|
to the message replacement data. If there is no message information data, this field is set to zero.</p>
|
||
|
|
||
|
<p><strong>Length of message replacement data.</strong> The length, in bytes, of the message replacement data.</p>
|
||
|
|
||
|
<p><strong>Message file.</strong> The message file.</p>
|
||
|
|
||
|
<p><strong>Message ID.</strong> The message identifier.</p>
|
||
|
|
||
|
<p><strong>Message library.</strong> The message library.</p>
|
||
|
|
||
|
<p><strong>Message replacement data.</strong> The message replacement data.</p>
|
||
|
|
||
|
<p><strong>Message replacement data CCSID.</strong> The coded character set identifier (CCSID) of the convertible character
|
||
|
(CCHAR) portion of the exception data.</p>
|
||
|
|
||
|
|
||
|
<p><strong>Reserved.</strong> Reserved field. This field will be set to hexadecimal zeroes.</p>
|
||
|
|
||
|
|
||
|
<h3><a name="Qfpad_EENT0100">Monitored Resource Input Information (EENT0100 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%">CHAR(10)</td>
|
||
|
<td align="left" valign="top" width="60%">Monitored resource input type</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">10</td>
|
||
|
<td align="center" valign="top">A</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Monitored resource input library name</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">Length of monitored resource input name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">24</td>
|
||
|
<td align="center" valign="top">18</td>
|
||
|
<td align="left" valign="top">CHAR(*)</td>
|
||
|
<td align="left" valign="top">Monitored resource input name</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<h3>Field Descriptions</h3>
|
||
|
|
||
|
<p><strong>Length of monitored resource input name. </strong> The length, in bytes, of the monitored resource name.</p>
|
||
|
|
||
|
<p><strong>Monitored resource input library name.</strong> The name of the library for the specified monitored resource. Allowed values are:</p>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr>
|
||
|
<td align="left" valign="top" width="15%"><em>Blank</em></td>
|
||
|
<td align="left" valign="top" width="85%">Specify a blank monitored resource library name for the
|
||
|
monitored resource types *SYSVAL, *ENVVAR, *NETA, *TCPA, or *ALL.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>Monitored resource library name</em></td>
|
||
|
<td align="left" valign="top">The name of the library for monitored resource types *USRPRF, *ASPDEV, *JOBD, and *CLS. Monitored resource types of *USRPRF and *ASPDEV must specify QSYS for the monitored resource library name. Library special values,e.g. *CURLIB or *LIBL, are not allowed.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p><strong>Monitored resource input name.</strong> The name of the monitored resource or list of resources for which information is returned. The allowed values are:</p>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr>
|
||
|
<td align="left" valign="top" width="15%"><em>Monitored resource name</em></td>
|
||
|
<td align="left" valign="top" width="85%">The name of a monitored resource.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ALL</em></td>
|
||
|
<td align="left" valign="top">Returns information for all monitored resources.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p><strong>Monitored resource input type.</strong> The type of monitored resource for which information is to be returned. Possible values are:</p>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr>
|
||
|
<td align="left" valign="top" width="15%"><em>*USRPRF</em></td>
|
||
|
<td align="left" valign="top" width="85%">User profile</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*SBSD</em></td>
|
||
|
<td align="left" valign="top">Subsystem description</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*JOBD</em></td>
|
||
|
<td align="left" valign="top">Job description</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CLS</em></td>
|
||
|
<td align="left" valign="top">Class</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ASPDEV</em></td>
|
||
|
<td align="left" valign="top">Independent auxiliary storage pool (ASP) device description</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*SYSVAL</em></td>
|
||
|
<td align="left" valign="top">System value</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*NETA</em></td>
|
||
|
<td align="left" valign="top">Network attributes</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ENVVAR</em></td>
|
||
|
<td align="left" valign="top">System environment variable</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*TCPA</em></td>
|
||
|
<td align="left" valign="top">TCP/IP attributes</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*ALL</em></td>
|
||
|
<td align="left" valign="top">Return information for all monitored resource types</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
<br>
|
||
|
<h3><a name="Qfpad_SRVI0100">Server Information (SRVI0100 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%">Length of server defined output</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">Cluster name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">14</td>
|
||
|
<td align="center" valign="top">D</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Cluster administrative domain name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">24</td>
|
||
|
<td align="center" valign="top">18</td>
|
||
|
<td align="left" valign="top">CHAR(30)</td>
|
||
|
<td align="left" valign="top">Reserved</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<h3>Field Descriptions</h3>
|
||
|
<p><strong>Cluster administrative domain name.</strong> The name of the cluster administrative domain where the monitored resource is monitored by the system.</p>
|
||
|
|
||
|
<p><strong>Cluster name.</strong> The name of the cluster associated with the cluster administrative domain.</p>
|
||
|
|
||
|
<p><strong>Length of server defined output.</strong> The length, in bytes, of the server defined output parameter.
|
||
|
For a *ADMDMN manager type, this value must be 1.</p>
|
||
|
|
||
|
<p><strong>Reserved.</strong> This field will be set to hexadecimal zeroes.</p>
|
||
|
|
||
|
<h3><a name="usage_notes">Usage Notes</a></h3>
|
||
|
|
||
|
<h4>Retrieving Monitored Resource Information in a Cluster Administrative Domain</h4>
|
||
|
<p>See <a href="../rzaig/rzaigconceptsbasiccluster.htm">Cluster basics</a>
|
||
|
for more information about using this API to retrieve monitored resource information in a cluster administrative domain.
|
||
|
</p>
|
||
|
<p>Unless otherwise noted, all character strings are assumed to be in the CCSID of the program that calls this API.</p>
|
||
|
|
||
|
<h3>Error Messages</h3>
|
||
|
|
||
|
<table width="100%">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<th align="left" valign="top">Message ID</th>
|
||
|
<th align="left" valign="top">Error Message Text</th>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF1098 E</td>
|
||
|
<td valign="top">No authority to class &1 in library &2.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF2634 E</td>
|
||
|
<td valign="top">Not authorized to object &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF2697 E</td>
|
||
|
<td valign="top">The request did not complete in the time allotted.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF3C24 E</td>
|
||
|
<td valign="top">Length of the receiver variable is not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF3C29 E</td>
|
||
|
<td valign="top">Object name &1 is not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF3C1E E</td>
|
||
|
<td valign="top">Required parameter &1 omitted.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF3C21 E</td>
|
||
|
<td valign="top">Format name &1 is not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF3C3C E</td>
|
||
|
<td valign="top">Value for parameter &1 not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF3CF1 E</td>
|
||
|
<td valign="top">Error code parameter not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF3CF2 E</td>
|
||
|
<td valign="top">Error(s) occurred during running of &1 API.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF9801 E</td>
|
||
|
<td valign="top">Object &2 in library &3 not found.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF9802 E</td>
|
||
|
<td valign="top">Not authorized to object &2 in &3.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF9803 E</td>
|
||
|
<td valign="top">Not authorized to object &2 in &3.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF9804 E</td>
|
||
|
<td valign="top">Object &2 in library &3 damaged.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF9810 E</td>
|
||
|
<td valign="top">Library &1 not found.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPF9820 E</td>
|
||
|
<td valign="top">Not authorized to use library &1.</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">CPFA0AA E</td>
|
||
|
<td valign="top">Error occurred while attempting to obtain space.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPFB0CE E</td>
|
||
|
<td valign="top">&1 special authority is required.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td valign="top">CPFBBB6 E</td>
|
||
|
<td valign="top">Library &1 not allowed for resource &2.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
|
||
|
<p><img src="deltaend.gif" alt="End of change"> </p>
|
||
|
|
||
|
<hr>
|
||
|
API introduced: V5R4
|
||
|
|
||
|
<hr>
|
||
|
<center>
|
||
|
<table cellpadding="2" cellspacing="2">
|
||
|
<tr align="center">
|
||
|
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href="ss1.htm">Server Support APIs</a> | <a href="aplist.htm">APIs by
|
||
|
category</a></td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
</center>
|
||
|
</body>
|
||
|
</html>
|
||
|
|