409 lines
11 KiB
HTML
409 lines
11 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<!-- Begin Header records -->
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
|
<title>Retrieve Policy Data (QPDETRTV) API</title>
|
|
<!-- 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 050110 by RBS -->
|
|
<!-- Change history: -->
|
|
<!-- 050110 RBS New Part -->
|
|
<!-- Reason v5r4m0 stlomeli 031505 Add max PTF ordre size -->
|
|
<!-- 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 Policy Data (QPDETRTV) API</h2>
|
|
|
|
|
|
<div class="box" style="width: 80%;">
|
|
<br>
|
|
Required Parameter Group:<br><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 name</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">Error Code</td>
|
|
<td align="left" valign="top">I/O</td>
|
|
<td align="left" valign="top">Char(*)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Default Public Authority: *EXCLUDE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: Yes<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
|
|
<p>The Retrieve Policy Data (QPDETRTV) API retrieves policy data.</p>
|
|
|
|
<br>
|
|
|
|
<!-- Please NOTE: DO NOT DELETE THIS SECTION if this API has no authorities and locks. -->
|
|
<!-- Instead, use the commented out coding below to indicate NONE. -->
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<!-- Use this if there are no authorities and locks. -->
|
|
<p>None.</p>
|
|
<br>
|
|
|
|
<h3>Required Parameter Group</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Receiver variable</strong></dt>
|
|
|
|
<dd>OUTPUT; CHAR(*)
|
|
|
|
<p>The variable that will receive the policy information being retrieved.
|
|
For the format, see <a href="#format">Format of data returned</a>.
|
|
|
|
</p>
|
|
</dd>
|
|
|
|
<dt><strong>Length of receiver variable</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
<p>The length of the receiver variable described in Format of data returned. If the length is larger
|
|
than the size of the receiver variable, the results may not be predictable. The minimum length is 8 bytes.
|
|
|
|
</p>
|
|
</dd>
|
|
|
|
<dt><strong>Format name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The format of the information to be returned. You must use one of the following format names:</p>
|
|
|
|
<dl>
|
|
<dt><strong>RPOL0100</strong></dt>
|
|
|
|
<dd>Retrieve service cleanup interval.<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>RPOL0200</strong></dt>
|
|
|
|
<dd>Retrieve problem documentation level.<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>RPOL0300</strong></dt>
|
|
|
|
<dd>Retrieve maximum PTF order size.<br>
|
|
<br>
|
|
</dd>
|
|
|
|
</dl>
|
|
</dd>
|
|
|
|
<dt><strong>Error code</strong></dt>
|
|
|
|
<dd>I/O; CHAR(*)
|
|
|
|
<p>The structure in which to return error information. For the format of the
|
|
structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p>
|
|
</dd>
|
|
</dl>
|
|
<br>
|
|
|
|
<h3><a name="format">Format of Data Returned</a></h3>
|
|
|
|
The receiver variable holds the policy information returned.
|
|
<br>
|
|
<h4>RPOL0100 - Retrieve service cleanup interval</h4>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" 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">Number of days
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
<br>
|
|
|
|
<h4>RPOL0200 - Retrieve problem documentation level</h4>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" 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">Problem documentation level
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
<h4>RPOL0300 - Retrieve maximum PTF order size</h4>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" 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">Maximum PTF order size over LAN</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">Maximum PTF order size over a modem</td>
|
|
</tr>
|
|
|
|
</table>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="flddsc">Field Descriptions</a></h3>
|
|
|
|
|
|
<p><strong>Bytes available.</strong> The number of bytes of data available to
|
|
be returned. All available data is returned if enough space is provided.</p>
|
|
|
|
<p><strong>Bytes returned.</strong> The number of bytes of data returned.</p>
|
|
|
|
<p><strong>Maximum PTF order size over a modem.</strong> The maximum size in megabytes for
|
|
a PTF order to be delivered over a modem.
|
|
A value of -1 indicates PTF orders of any size are delivered
|
|
over a modem. A value of 100 MB (MB equals approximately 1 000 000 bytes) is used
|
|
if a lower value is retrieved.</p>
|
|
|
|
<p><strong>Maximum PTF order size over LAN.</strong> The maximum size in megabytes for
|
|
a PTF order to be delivered over the local area network (LAN).
|
|
A value of -1 indicates PTF orders of any size are delivered
|
|
over the LAN. A value of -1 is used if a value lower than 100 MB
|
|
(MB equals approximately 1 000 000 bytes) is retrieved.
|
|
</p>
|
|
|
|
<p><strong>Number of days.</strong> The number of days an object covered by
|
|
this policy is allowed to exist before being deleted by the Service Monitor.
|
|
Objects covered by this policy are: Service Monitor logs and Integrated File
|
|
System files created by the FFDC process.</p>
|
|
|
|
<p><strong>Problem documentation level.</strong> Indicates how much problem
|
|
documentation should be included when problems are automatically reported to
|
|
the service provider Only the following values are returned:</p>
|
|
|
|
<table border width="80%">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top" width="20%">*BASE</td>
|
|
<td align="left" valign="top" width="60%">Minimal documentation is sent in the service request record. No additional data will be uploaded.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" width="20%">*DEFAULT</td>
|
|
<td align="left" valign="top" width="60%">Minimal documentation will be sent in the service request record. If no fix for the problem is found, additional documentation will be automatically uploaded. Additional documentation may include information such as joblogs and service dumps.
|
|
</td>
|
|
</tr>
|
|
|
|
</table>
|
|
<br><br>
|
|
<h3><a name="errmsg">Error Messages</a></h3>
|
|
|
|
<p>The following messages may be sent from this function:</p>
|
|
|
|
<table width="100%">
|
|
<tr>
|
|
<th align="left" valign="top">Message ID</th>
|
|
<th align="left" valign="top">Error Message Text</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td width="15%" valign="top">CPF3CF1</td>
|
|
<td width="85%" valign="top">Error code parameter not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>CPF3CF2</td>
|
|
<td>Error(s) occurred during running of * API.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>CPF3C1D</td>
|
|
<td>Input variable length in parameter * not
|
|
valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>CPF3C1E</td>
|
|
<td>Required parameter * omitted.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>CPF3C17</td>
|
|
<td>Error occurred with input data parameter.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>CPF3C21</td>
|
|
<td>Format name * is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>CPF3C4A</td>
|
|
<td>Value not valid for field *.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>CPF3C4B</td>
|
|
<td>Value not valid for field *.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>CPF3C4C</td>
|
|
<td>Value not valid for field *.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>CPF9872</td>
|
|
<td>Program or service program * in library * ended.
|
|
Reason code *.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<img src="deltaend.gif" alt="End of change">
|
|
|
|
<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=
|
|
"pm1.htm">Problem Management APIs</a> | <a href="aplist.htm">APIs by
|
|
category</a></td>
|
|
</tr>
|
|
</table>
|
|
</center>
|
|
</body>
|
|
</html>
|
|
|