friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
master
ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/qfpartve.htm

1425 lines
47 KiB
HTML
Raw Permalink Blame History

<!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>
&nbsp;&nbsp;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>
&nbsp;&nbsp;Service Program Name: QFPADAP1<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Default Public Authority: *EXCLUDE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;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>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*READ</dd>
<dd><em>Job Description Object Authority</em></dd>
<dd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*USE</dd>
<dd><em>Job Description Library</em></dd>
<dd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*EXECUTE</dd>
<dd><em>Class Object Authority</em></dd>
<dd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*USE</dd>
<dd><em>Class Library</em></dd>
<dd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*EXECUTE</dd>
<dd><em>Independent Auxiliary Storage Pool (ASP) Device Description Authority</em></dd>
<dd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*USE</dd>
<dd><em>Independent Auxiliary Storage Pool (ASP) Device Description Lock</em></dd>
<dd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*EXCLRD</dd>
<dd><em>Network Attribute</em></dd>
<dd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NONE</dd>
<dd><em>System Environment Variable Authority</em></dd>
<dd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NONE</dd>
<dd><em>TCP/IP Attribute Authority</em></dd>
<dd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Global status</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Resource status</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Monitored resource name</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Node array</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Global status</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Resource status</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Monitored resource name</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Attribute name</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</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 &amp;1 in library &amp;2.</td>
</tr>
<tr>
<td valign="top">CPF2634 E</td>
<td valign="top">Not authorized to object &amp;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 &amp;1 is not valid.</td>
</tr>
<tr>
<td valign="top">CPF3C1E E</td>
<td valign="top">Required parameter &amp;1 omitted.</td>
</tr>
<tr>
<td valign="top">CPF3C21 E</td>
<td valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td valign="top">CPF3C3C E</td>
<td valign="top">Value for parameter &amp;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 &amp;1 API.</td>
</tr>
<tr>
<td valign="top">CPF9801 E</td>
<td valign="top">Object &amp;2 in library &amp;3 not found.</td>
</tr>
<tr>
<td valign="top">CPF9802 E</td>
<td valign="top">Not authorized to object &amp;2 in &amp;3.</td>
</tr>
<tr>
<td valign="top">CPF9803 E</td>
<td valign="top">Not authorized to object &amp;2 in &amp;3.</td>
</tr>
<tr>
<td valign="top">CPF9804 E</td>
<td valign="top">Object &amp;2 in library &amp;3 damaged.</td>
</tr>
<tr>
<td valign="top">CPF9810 E</td>
<td valign="top">Library &amp;1 not found.</td>
</tr>
<tr>
<td valign="top">CPF9820 E</td>
<td valign="top">Not authorized to use library &amp;1.</td>
</tr>
<tr>
<td valign="top">CPF9872 E</td>
<td valign="top">Program or service program &amp;1 in library &amp;2 ended. Reason code &amp;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">&amp;1 special authority is required.</td>
</tr>
<tr>
<td valign="top">CPFBBB6 E</td>
<td valign="top">Library &amp;1 not allowed for resource &amp;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>
Reference in New Issue View Git Blame Copy Permalink