ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/qdbstupdatestatistics.htm

1075 lines
30 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!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>Update Statistics Collections (QDBSTUS, QdbstUpdateStatistics)
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. -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- Created by Ulrich Thiemann on 04-May-2001 -->
<!-- Updated by Ulrich Thiemann on 01-Aug-2002 -->
<!-- End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!-- Java sync-link -->
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<h2>Update Statistics Collections (QDBSTUS, QdbstUpdateStatistics) API</h2>
<div class="box" style="width: 80%;">
<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="45%">Input data</td>
<td align="left" valign="top" width="15%">Input</td>
<td align="left" valign="top" width="30%">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">Length of input data</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 input data</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">Feedback area</td>
<td align="left" valign="top">Output</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">5</td>
<td align="left" valign="top">Length of feedback area</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">6</td>
<td align="left" valign="top">Feedback keys</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Array(*) of Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">7</td>
<td align="left" valign="top">Number of feedback keys</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="left" valign="top">Error code</td>
<td align="left" valign="top">I/O</td>
<td align="left" valign="top">Char(*)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Service Program Name: QDBSTMGR<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: Yes<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Update Statistics Collection (QDBSTUS, QdbstUpdateStatistics) API allows
the user to update the attributes and to refresh the data of an existing single
statistics collection.</p>
<p>In addition, the QdbstUpdateStatistics API allows to block all future system
initiated statistics collection requests for a specific database file member.</p>
<br>
<h3>Section overview</h3>
<ul>
<li><a href="#AuthAndLocks">Authorities and Locks</a></li>
<li><a href="#ReqParmGroup">Required Parameter Group</a></li>
<li><a href="#STIU0100Format">STIU0100 Input Format</a></li>
<li><a href="#VALIDKEYS_UPDATE">Valid Keys - Update</a></li>
<li><a href="#VALIDKEYS_FEEDBACK">Valid Keys - Feedback</a></li>
<li><a href="#FeedbackFormat">Feedback Area Format</a></li>
<li><a href="#FieldDescriptions">Field Descriptions</a></li>
<li><a href="#ErrorMsgs">Error Messages</a></li>
<li><a href="#RelInfo">Related Information</a></li>
</ul>
<br>
<h3><a name="AuthAndLocks">Authorities and Locks</a></h3>
<dl>
<dt><em>ASP Device Authority</em></dt>
<dd>*EXECUTE</dd>
<dt><em>File Authority</em></dt>
<dd>*OBJALTER, *OBJOPR</dd>
<dt><em>File Library Authority</em></dt>
<dd>*EXECUTE</dd>
<dt><em>File Lock</em></dt>
<dd>*SHRRD</dd>
</dl>
<br>
<h3><a name="ReqParmGroup">Required Parameter Group</a></h3>
<dl>
<dt><strong>Input data</strong></dt>
<dd>INPUT; CHAR(*)
<p>The buffer containing the input parameters according to the format of input
data parameter. The buffer content has to start at a four-byte boundary.</p>
</dd>
<dt><strong>Length of input data</strong></dt>
<dd>INPUT; BINARY(4)
<p>The length of the input data buffer provided.</p>
</dd>
<dt><strong>Format of input data</strong></dt>
<dd>INPUT; CHAR(8)
<p>The format of the input data. Possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>STIU0100</em></td>
<td align="left" valign="top">Update statistics collection via unique statistics ID
and keyed input.</td>
</tr>
</table>
<p>Refer to <a href="#STIU0100Format">STIU0100 Input Format</a> for more
information.</p>
</dd>
<dt><strong>Feedback area</strong></dt>
<dd>OUTPUT; CHAR(*)
<p>The buffer to receive feedback data. See <a href="#FeedbackFormat">Feedback
Area Format</a> for more information. The buffer content has to start at a
four-byte boundary.</p>
</dd>
<dt><strong>Length of feedback area</strong></dt>
<dd>INPUT; BINARY(4)
<p>The length of the feedback area buffer provided. The required minimum length
is 16, to fit the feedback area header (see <a href="#FeedbackFormat">
Feedback Area Format</a>).</p>
</dd>
<dt><strong>Feedback keys</strong></dt>
<dd>INPUT; ARRAY(*) OF BINARY(4)
<p>The list of fields to return in the feedback area. For a list of valid keys
see <a href="#VALIDKEYS_FEEDBACK">Valid Keys - Feedback</a>.</p>
</dd>
<dt><strong>Number of feedback keys</strong></dt>
<dd>INPUT; BINARY(4)
<p>The number of fields to return in the feedback area. If zero is specified,
all other feedback area parameters (<em>Feedback area</em>,
<em>Length of feedback area</em>, and
<em>Feedback keys</em>) are ignored.</p>
</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>
<h4><a name="STIU0100Format">STIU0100 Input Format</a></h4>
<p>Update statistics collection input parameters. See <a href=
"#FieldDescriptions">Field Descriptions</a> for details of the fields
listed.</p>
<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%">ASP device name</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">File name</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">File library name</td>
</tr>
<tr>
<td align="center" valign="top">30</td>
<td align="center" valign="top">1E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">File member name</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Internal statistics ID</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to fields to update</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of fields to update</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="left" valign="top" rowspan="5" colspan="2">These fields repeat, in
the order listed, for each field to be updated, started at the given
offset.</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of field information</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Key identifier</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved (padding to the next 4-byte
boundary)</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">Reserved</td>
</tr>
</table>
<br>
<br>
<h4><a name="VALIDKEYS_UPDATE">Valid Keys - Update</a></h4>
<p>Use the following keys to specify the fields to be updated when using the
<a href="#STIU0100Format">STIU0100 Input Format</a>.
Each key can only be specified once. See <a href=
"#FieldDescriptions">Field Descriptions</a> for details of the fields
listed.</p>
<table border width="80%">
<tr>
<th align="center" valign="top">Key</th>
<th align="left" valign="top">Type</th>
<th align="left" valign="top">Description</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">45</td>
<td align="left" valign="top" width="20%">CHAR(12)</td>
<td align="left" valign="top" width="70%">Statistics data (key value is the
collection mode)</td>
</tr>
<tr>
<td align="center" valign="top">18</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Aging mode</td>
</tr>
<tr>
<td align="center" valign="top">46</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Statistics collection name</td>
</tr>
<tr>
<td align="center" valign="top">47</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Block system statistics collections option</td>
</tr>
</table>
<br>
<br>
<h4><a name="VALIDKEYS_FEEDBACK">Valid Keys - Feedback</a></h4>
<p>Use the following keys to specify the fields to be returned in the feedback
area. Each key can only be specified once.
See <a href="#FieldDescriptions">Field Descriptions</a> for details of
the fields listed.</p>
<table border width="80%">
<tr>
<th align="center" valign="top">Key</th>
<th align="left" valign="top">Type</th>
<th align="left" valign="top">Description</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">1</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="70%">ASP device name used</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">File library name used</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">File member name used</td>
</tr>
<tr>
<td align="center" valign="top">6</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Internal request ID</td>
</tr>
<tr>
<td align="center" valign="top">18</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Previous aging mode</td>
</tr>
<tr>
<td align="center" valign="top">46</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Previous statistics collection name</td>
</tr>
<tr>
<td align="center" valign="top">47</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Previous block system statistics collections
option</td>
</tr>
</table>
<br>
<br>
<h4><a name="FeedbackFormat">Feedback Area Format</a></h4>
<p>The fields returned in the feedback area are returned in the order
requested. See <a href="#FieldDescriptions">Field Descriptions</a> for details
of the fields listed.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Number of 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">Number of 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 key fields returned</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">Number of key fields available</td>
</tr>
<tr>
<td align="left" valign="top" rowspan="5" colspan="2">These fields repeat, in
the order listed, for each key selected.</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of field information returned</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Key identifier</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved (padding to the next 4 bytes
boundary)</td>
</tr>
</table>
<br>
<br>
<h4><a name="FieldDescriptions">Field Descriptions</a></h4>
<p><strong>Aging mode.</strong> Whether the system is allowed to
age or remove the statistics collection. The possible values to change to
are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SYS</em></td>
<td align="left" valign="top">Refresh or removal of the statistics collections
will be performed automatically by the system.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*USER</em></td>
<td align="left" valign="top">Refresh or removal will only occur when a user
requests it.</td>
</tr>
</table>
<p><strong>ASP device name.</strong> The name of one auxiliary storage pool
(ASP) device in the ASP group in which the library and file are located.
The ASP device must have a status of 'Available'. The documented authority
is required for the given ASP and the primary of the corresponding ASP group.
The name can be a specific ASP device name
(for an ASP with a number greater than 32), or one of the
following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*</em></td>
<td align="left" valign="top">Locate the library and file in the name space
for the current thread.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*SYSBAS</em></td>
<td align="left" valign="top">Locate the library and file in the system ASP
(ASP number 1) and all basic ASPs (ASP numbers 2 through 32).</td>
</tr>
</table>
<p><strong>ASP device name used.</strong> The actual auxiliary
storage pool device name used, after possible resolution of special values.</p>
<p><strong>Block system statistics collections option.</strong>
Whether future system initiated (automatic) statistics collection create or update requests
will be allowed for this database file member. The possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">Do not block system initiated statistics
collection requests.
<p><strong>Note:</strong> This is the system default.</p>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">Block system initiated statistics collection
requests.</td>
</tr>
</table>
<br>
<br>
<p><strong>Note:</strong> The internal statistics ID is ignored for this
option, which operates at file member level, but the ID has to be a valid
statistics ID, if any other update option besides the block option is
specified.</p>
<p><strong>Note:</strong> Currently active system requests will not be affected
by changing this option. See <a href=
"qdbstcancelrequestedstatistics.htm">Cancel requested statistics collections
(QDBSTCRS, QdbstCancelRequestedStatistics) API</a>.</p>
<p><strong>Data (in feedback area format).</strong> The data
returned for the key identifier.</p>
<p><strong>Data (in STIU0100 input format).</strong> The data
with which the field is to be updated.</p>
<p><strong>File library name.</strong> Where the file for which
statistics collection attributes are to be updated is located. You can use
these special values for the library name,
if the <em>ASP Device Name</em> is <em>*</em>:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*CURLIB</em></td>
<td align="left" valign="top">The job's current library or QGPL if the current
library is not set.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LIBL</em></td>
<td align="left" valign="top">The library list.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*USRLIBL</em></td>
<td align="left" valign="top">Libraries listed in the user portion of the
library list.</td>
</tr>
</table>
<p><strong>File library name used.</strong> The actual file library
name used, after possible resolution of special values.</p>
<p><strong>File member name.</strong> The name of the file member
to be used for the statistics collection update request.</p>
<p>This value can be a specific file member name or one of the following
special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*FIRST</em></td>
<td align="left" valign="top">The first member (in the order created) in the
specified file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LAST</em></td>
<td align="left" valign="top">The last member (in the order created) in the
specified file.</td>
</tr>
</table>
<p><strong>File member name used.</strong> The actual file member
name used, after possible resolution of special values.</p>
<p><strong>File name.</strong> The name of the file for which
statistics collection attributes are to be updated. The file has to be an
existing local, single format, physical file.</p>
<p><strong>Internal request ID.</strong>
If the update key <em>Statistics Data</em> is specified and its value
is <em>*BACKGROUND</em>,
this field is an unique ID for the statistics data update requested here.
The request ID stays valid until the statistics data update is completed
and the ID can be used on the <a href=
"qdbstcancelrequestedstatistics.htm">Cancel Requested Statistics
Collections</a> (QDBSTCRS, QdbstCancelRequestedStatistics) API.</p>
<p><strong>Note:</strong> The ID is stored in binary, non printable form in the
character array.</p>
<p><strong>Internal statistics ID.</strong> Together with the
qualified file name and member name, this represents a unique ID for the
statistics collection to be updated. See <a href=
"qdbstliststatistics.htm">List statistics collections (OPM, QDBSTLS; ILE
QdbstListStatistics) API</a> and
<a href= "qdbstrequeststatistics.htm">Request statistics collections
(OPM, QDBSTRS; ILE QdbstRequestStatistics) API</a>.</p>
<p><strong>Note:</strong> The ID is stored in binary, non printable form in the
character array.</p>
<p><strong>Key identifier (in the STIU0100 input format).</strong>
The field to be updated. For a list of valid keys see <a href=
"#VALIDKEYS_UPDATE">Valid Keys - Update</a>.</p>
<p><strong>Key identifier (in the feedback area format).</strong>
The field returned. For a list of valid keys see <a href="#VALIDKEYS_FEEDBACK">
Valid Keys - Feedback</a>.</p>
<p><strong>Keys of fields to update.</strong> The list of fields to
update per list entry. For a list of valid keys see <a href=
"#VALIDKEYS_UPDATE">Valid Keys - Update</a>.</p>
<p><strong>Length of data (in feedback area format).</strong> The
length of the data returned for the field.</p>
<p><strong>Length of data (in STIU0100 input format).</strong> The
length of the data the field is to be updated with.</p>
<p><strong>Length of field information.</strong> Total number of
bytes being passed for the field to be updated.</p>
<p><strong>Length of field information returned.</strong> Total
number of bytes returned for this field in the feedback area.</p>
<p><strong>Number of bytes available.</strong> Number of bytes that
could be returned in the feedback area.</p>
<p><strong>Number of bytes returned.</strong> Number of bytes
returned in the feedback area.</p>
<p><strong>Number of key fields available.</strong> Number of
fields that could be returned in the feedback area.</p>
<p><strong>Number of key fields returned.</strong> Number of fields
returned in the feedback area.</p>
<p><strong>Number of fields to update.</strong> The number of
fields to update.</p>
<p><strong>Offset to fields to update.</strong> Offset to the start
of the array of fields to update.</p>
<p><strong>Previous aging mode.</strong> The aging mode in effect
before the update.</p>
<p><strong>Note:</strong> If the aging mode was not requested to be updated,
the aging mode returned will be blank.</p>
<p><strong>Previous block system statistics collections
option.</strong> The block option in effect before the update.</p>
<p><strong>Note:</strong> If the block option was not requested to be updated,
the block option returned will be blank.</p>
<p><strong>Previous statistics collection name.</strong> The name
in effect before the update.</p>
<p><strong>Note:</strong> If the statistics collection name was not requested
to be updated, the statistics collection name returned will have a length of
0.</p>
<p><strong>Reserved.</strong> Reserved for future use. If this field is input,
the field must be set to hexadecimal zeros.</p>
<p><strong>Reserved (in feedback area format).</strong> Structure
padding to guarantee alignment to the next four bytes boundary.</p>
<p><strong>Reserved (in STIU0100 input format).</strong> Structure
padding to guarantee alignment to the next four bytes boundary.</p>
<p><strong>Statistics collection name.</strong> A name unique
amongst all statistics collections for the file member.</p>
<p><strong>Statistics data.</strong> The statistics data is to be
refreshed. The key value is the collection mode (see also the <a href=
"qdbstrequeststatistics.htm">Request statistics collections (OPM, QDBSTRS; ILE
QdbstRequestStatistics) API</a>), under which the refresh should take place.
The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*IMMEDIATE</em></td>
<td align="left" valign="top">Execute the refresh immediately. The statistics
collection will run in the user's process. Control will not return to the API
invoker until the refresh is complete.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*BACKGROUND</em></td>
<td align="left" valign="top">The refresh will be scheduled for
execution in system job QDBFSTCCOL. Control will return to the API invoker
immediately.
<p><strong>Note:</strong> If the current setting of the system value QDBFSTCCOL
does not allow user requested background collections,
then the refresh request will be queued until the system value is changed to a level
allowing the execution of the refresh.</p>
</td>
</tr>
</table>
<br>
<br>
<h3><a name="ErrorMsgs">Error Messages</a></h3>
<table width="100%" cellpadding="5">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="top" nowrap>Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td align="left" valign="top">CPF0623 E</td>
<td align="left" valign="top">Field &amp;1 not found in record format &amp;2.</td>
</tr>
<tr>
<td align="left" valign="top">CPF1866 E</td>
<td align="left" valign="top">Value &amp;1 for number of fields to return not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF2105 E</td>
<td align="left" valign="top">Object &amp;1 in &amp;2 type *&amp;3 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF2113 E</td>
<td align="left" valign="top">Cannot allocate library &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF2173 E</td>
<td align="left" valign="top">Value for ASPDEV not valid with special value for library.</td>
</tr>
<tr>
<td align="left" valign="top">CPF218C E</td>
<td align="left" valign="top">&amp;1 not a primary or secondary ASP.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3141 E</td>
<td align="left" valign="top">Member &amp;2 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF34C0 E</td>
<td align="left" valign="top">Value &amp;1 for number of fields to return parameter not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C07 E</td>
<td align="left" valign="top">Error occurred while retrieving information from object &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C1D E</td>
<td align="left" valign="top">Length specified in parameter &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C21 E</td>
<td align="left" valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C29 E</td>
<td align="left" valign="top">Object name &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C36 E</td>
<td align="left" valign="top">Number of parameters, &amp;1, entered for this API was not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C39 E</td>
<td align="left" valign="top">Value for reserved field not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C3B E</td>
<td align="left" valign="top">Value for parameter &amp;2 for API &amp;1 not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C82 E</td>
<td align="left" valign="top">Key &amp;1 not valid for API &amp;2.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C89 E</td>
<td align="left" valign="top">Key &amp;1 specified more than once.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3CF1 E</td>
<td align="left" valign="top">Error code parameter not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3CF2 E</td>
<td align="left" valign="top">Error(s) occurred during running of &amp;1 API.</td>
</tr>
<tr>
<td align="left" valign="top">CPF4268 E</td>
<td align="left" valign="top">Object &amp;1 in &amp;2 type *&amp;3 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9802 E</td>
<td align="left" valign="top">Not authorized to object &amp;2 in &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9803 E</td>
<td align="left" valign="top">Cannot allocate object &amp;2 in library &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9804 E</td>
<td align="left" valign="top">Object &amp;2 in library &amp;3 damaged.</td>
</tr>
<tr>
<td align="left" valign="top">CPF980B E</td>
<td align="left" valign="top">Object &amp;1 in library &amp;2 not available.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9810 E</td>
<td align="left" valign="top">Library &amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9812 E</td>
<td align="left" valign="top">File &amp;1 in library &amp;2 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9814 E</td>
<td align="left" valign="top">Device &amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9820 E</td>
<td align="left" valign="top">Not authorized to use library &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9822 E</td>
<td align="left" valign="top">Not authorized to file &amp;1 in library &amp;2.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9825 E</td>
<td align="left" valign="top">Not authorized to device &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9826 E</td>
<td align="left" valign="top">Cannot allocate file &amp;2.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9830 E</td>
<td align="left" valign="top">Cannot assign library &amp;1</td>
</tr>
<tr>
<td align="left" valign="top">CPF9872 E</td>
<td align="left" valign="top">Program or service program &amp;1 in library &amp;2 ended. Reason code &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPFB401 E</td>
<td align="left" valign="top">API &amp;3 failed with reason code &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPFB8ED E</td>
<td align="left" valign="top">Device description &amp;1 not correct for operation.</td>
</tr>
</table>
<br>
<br>
<h3><a name="RelInfo">Related Information</a></h3>
<ul>
<li>the &lt;<strong>qdbst.h</strong>&gt; include file in library QSYSINC, for
API-related structure declarations and special value declarations.<br>
<br>
</li>
<li>the &lt;<strong>qdbstmgr.h</strong>&gt; include file in library QSYSINC,
for the QdbstUpdateStatistics API prototype.<br>
<br>
</li>
<li>the &lt;<strong>qdbstus.h</strong>&gt; include file in library QSYSINC,
for the QDBSTUS API prototype.<br>
<br>
</li>
<li>the system value QDBFSTCCOL.<br>
<br>
</li>
<li><a href="qdbstcancelrequestedstatistics.htm">Cancel Requested Statistics
Collections</a> (QDBSTCRS, QdbstCancelRequestedStatistics) API<br>
<br>
</li>
<li><a href="qdbstdeletestatistics.htm">Delete Statistics Collections</a>
(QDBSTDS, QdbstDeleteStatistics) API<br>
<br>
</li>
<li><a href="qdbstlistrequestedstatistics.htm">List Requested Statistics
Collections</a> (QDBSTLRS, QdbstListRequestedStatistics) API<br>
<br>
</li>
<li><a href="qdbstlistdetailstatistics.htm">List Statistics Collection
Details</a> (QDBSTLDS, QdbstListDetailStatistics) API<br>
<br>
</li>
<li><a href="qdbstliststatistics.htm">List Statistics Collections</a> (QDBSTLS,
QdbstListStatistics) API<br>
<br>
</li>
<li><a href="qdbstrequeststatistics.htm">Request Statistics Collections</a>
(QDBSTRS, QdbstRequestStatistics) API<br>
<br>
</li>
</ul>
<br>
<hr>
API introduced: V5R2
<hr>
<table align="center" cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"file1.htm">Database and File APIs</a> | <a href="aplist.htm">APIs by
category</a></td>
</tr>
</table>
</body>
</html>