934 lines
25 KiB
HTML
934 lines
25 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>List Database File Members (QUSLMBR) 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. -->
|
|
<!-- File SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
|
|
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
|
|
<!-- Change History: -->
|
|
<!-- YYMMDD USERID Change description -->
|
|
<!--File Edited March 2001 -->
|
|
<!-- This file has undergone html cleanup on 9/20/01 by JET -->
|
|
<!-- 041130 45HRLN Updates for APAR SA95596 to document what -->
|
|
<!-- happens if the member description information -->
|
|
<!-- cannot be retrieved. -->
|
|
<!--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 language="Javascript" src="../rzahg/synch.js" type="text/javascript">
|
|
</script>
|
|
|
|
<h2>List Database File Members (QUSLMBR) API</h2>
|
|
|
|
<div class="box" style="width: 80%;">
|
|
<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%">Qualified user space name</td>
|
|
<td align="left" valign="top" width="20%">Input</td>
|
|
<td align="left" valign="top" width="20%">Char(20)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">2</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">3</td>
|
|
<td align="left" valign="top">Qualified database file name</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(20)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">Member name</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">Override processing</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(1)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Optional Parameter:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
|
|
|
|
<table width="100%">
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">6</td>
|
|
<td align="left" valign="top" width="50%">Error code</td>
|
|
<td align="left" valign="top" width="20%">I/O</td>
|
|
<td align="left" valign="top" width="20%">Char(*)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Service Program Name: QUSLMBR<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Default Public Authority: *USE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: Conditional; see <a href="#usage_notes">Usage
|
|
Notes</a>.<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The List Database File Members (QUSLMBR) API generates a list of database
|
|
file members and places the list in a specified user space. When you specify a
|
|
generic member name, you can generate a subset of the member list. You can use
|
|
the QUSLMBR API with database file types *PF, *LF, and *DDMF. The generated
|
|
list replaces any existing information in the user space. The file members
|
|
listed in the user space are not in any predictable order. To retrieve
|
|
additional information about each member in the list, see the <a href=
|
|
"qusrmbrd.htm">Retrieve Member Description (QUSRMBRD) API</a>.</p>
|
|
|
|
<p>You can use the QUSLMBR API to:</p>
|
|
|
|
<ul>
|
|
<li>List members more quickly than by using the *MBRLIST value on the TYPE
|
|
parameter of the Display File Description (DSPFD) command.</li>
|
|
|
|
<li>Retrieve information for all of the members of a database file more quickly
|
|
and easily than by multiple calls to the Retrieve Member Description (QUSRMBRD)
|
|
API. It is your discretion to decide which API best suits the needs of your
|
|
application. For example, if you want to selectively retrieve member
|
|
descriptions for a subset of the member list, you might want to use both the
|
|
QUSLMBR and QUSRMBRD APIs.</li>
|
|
|
|
<li>Ensure that the last date the source was changed matches the date of the
|
|
source used to create the object.</li>
|
|
</ul>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<dl compact>
|
|
<dt><em>User Space Authority</em></dt>
|
|
|
|
<dd>*CHANGE</dd>
|
|
|
|
<dt><em>User Space Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
|
|
<dt><em>File Authority</em></dt>
|
|
|
|
<dd>*OBJOPR</dd>
|
|
|
|
<dt><em>User Space Lock</em></dt>
|
|
|
|
<dd>*EXCLRD</dd>
|
|
|
|
<dt><em>File Lock</em></dt>
|
|
|
|
<dd>*SHRRD</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
<h3>Required Parameter Group</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Qualified user space name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(20)
|
|
|
|
<p>The user space that is to receive the created list. The first 10 characters
|
|
contain the user space name, and the second 10 characters contain the name of
|
|
the library where the user space is located. You can use these special values
|
|
for the library name:</p>
|
|
|
|
<table width="80%">
|
|
<tr>
|
|
<td width="15%" valign="top"><em>*CURLIB</em></td>
|
|
<td width="85%" valign="top">The job's current library</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*LIBL</em></td>
|
|
<td valign="top">The library list</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Format name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The content and format of the information returned for each member. The
|
|
possible format names are:</p>
|
|
|
|
<table width="80%">
|
|
<tr>
|
|
<td width="15%" valign="top"><em>MBRL0100</em></td>
|
|
<td width="85%" valign="top">Member name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>MBRL0200</em></td>
|
|
<td valign="top">Member name and source information This format requires more
|
|
processing than the MBRL0100 format.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>MBRL0310</em></td>
|
|
<td valign="top">Member name and basic description. The member information is
|
|
the same as that generated by the Retrieve Member Description (QUSRMBRD) API
|
|
using format MBRD0100. This format requires more system processing and takes
|
|
longer to produce than the MBRL0200 format.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>MBRL0320</em></td>
|
|
<td valign="top">Member name and expanded description. The member information
|
|
is the same as that generated by the Retrieve Member Description (QUSRMBRD) API
|
|
using format MBRD0200. The additional information requires more system
|
|
processing and takes longer to produce than the MBRL0310 format.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>MBRL0330</em></td>
|
|
<td valign="top">Member name and full description. The member information is
|
|
the same as that generated by the Retrieve Member Description (QUSRMBRD) API
|
|
using format MBRD0300. The additional information requires more system
|
|
processing and takes longer to produce than the MBRL0320 format.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top" colspan="2">For more information, see <a href="#HDRMBRL1">
|
|
MBRL0100 List Data Section</a>, <a href="#HDRMBRL2">MBRL0200 List Data
|
|
Section</a>, or <a href="#HDRMBRL3">MBRL0300 List Data Section</a>.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Qualified database file name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(20)
|
|
|
|
<p>The name of the database file whose member names are to be placed in the
|
|
list. The first 10 characters contain the database file name, and the second 10
|
|
characters contain the name of the library where the file is located. You can
|
|
use these special values for the library name:</p>
|
|
|
|
<table width="80%">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td valign="top"><em>*CURLIB</em></td>
|
|
<td valign="top">The job's current library</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*LIBL</em></td>
|
|
<td valign="top">The library list</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Member name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(10)
|
|
|
|
<p>A specific member name, a generic member name, or this special value:</p>
|
|
|
|
<table width="80%">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td valign="top"><em>*ALL</em></td>
|
|
<td valign="top">All members</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Override processing</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(1)
|
|
|
|
<p>Whether overrides are to be processed. The following character values are
|
|
used:</p>
|
|
|
|
<table width="100%">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td valign="top"><em>0</em></td>
|
|
<td valign="top">No override processing</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>1</em></td>
|
|
<td valign="top">Override processing</td>
|
|
</tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Optional Parameter</h3>
|
|
|
|
<dl>
|
|
<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>. If this
|
|
parameter is omitted, diagnostic and escape messages are issued to the
|
|
application.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
<h3><a name="HDRMBRLIST">Format of the Generated Lists</a></h3>
|
|
|
|
<p>The file member list consists of:</p>
|
|
|
|
<ul>
|
|
<li>A user area</li>
|
|
|
|
<li>A generic header</li>
|
|
|
|
<li>An input parameter section</li>
|
|
|
|
<li>A header section</li>
|
|
|
|
<li>A list data section:
|
|
|
|
<ul>
|
|
<li>MBRL0100 format</li>
|
|
|
|
<li>MBRL0200 format</li>
|
|
|
|
<li>MBRL0300 format</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<p>The MBRL0300 list data section is generated if MBRL0310, MBRL0320, or
|
|
MBRL0330 is specified as the format name parameter.</p>
|
|
|
|
<p>For details about the user area and generic header, see <a href="../apiref/usf.htm">
|
|
User Space Format for List APIs</a>. For details about the remaining items, see
|
|
the following sections. For detailed descriptions of the fields in the list
|
|
returned, see <a href="#HDRLMBRDE">Field Descriptions</a>.</p>
|
|
|
|
<p>When you retrieve list entry information from a user space, you must use the
|
|
entry size returned in the generic header as a displacement to the next list
|
|
entry. The size of each entry may be padded at the end. If you do not use the
|
|
entry size, the result may not be valid.
|
|
For examples of how to process lists, see <a href="../apiref/apiexmp.htm">Examples</a>.</p>
|
|
|
|
<br>
|
|
<h3><a name="HDRMBRLXP1">Input Parameter Section</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%">User space 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">User space library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Format name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">28</td>
|
|
<td align="center" valign="top">1C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">File name specified</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">38</td>
|
|
<td align="center" valign="top">26</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">File library name specified</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">48</td>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Member name specified</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">58</td>
|
|
<td align="center" valign="top">3A</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Override processing</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
<h3><a name="HDRMBRLLX1">Header Section</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%">File name used</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 library name used</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 attribute</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="center" valign="top">1E</td>
|
|
<td align="left" valign="top">CHAR(50)</td>
|
|
<td align="left" valign="top">File text description</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">80</td>
|
|
<td align="center" valign="top">50</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Total number of members in file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">84</td>
|
|
<td align="center" valign="top">54</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Source file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">85</td>
|
|
<td align="center" valign="top">55</td>
|
|
<td align="left" valign="top">CHAR(3)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">88</td>
|
|
<td align="center" valign="top">58</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">File text description CCSID</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
<h3><a name="HDRMBRL1">MBRL0100 List Data Section</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%">Member name used</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
<h3><a name="HDRMBRL2">MBRL0200 List Data Section</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%">Member name used</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">Source type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="left" valign="top">CHAR(13)</td>
|
|
<td align="left" valign="top">Creation date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">33</td>
|
|
<td align="center" valign="top">21</td>
|
|
<td align="left" valign="top">CHAR(13)</td>
|
|
<td align="left" valign="top">Last source change or table refresh date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">46</td>
|
|
<td align="center" valign="top">2E</td>
|
|
<td align="left" valign="top">CHAR(50)</td>
|
|
<td align="left" valign="top">Member text description</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">96</td>
|
|
<td align="center" valign="top">60</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Member text description CCSID</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRMBRL3">MBRL0300 List Data Section</a></h3>
|
|
|
|
<p>The MBRL0300 format provides an offset to a retrieved member description.
|
|
<img src="delta.gif" alt="Start of Change">
|
|
When the member description information cannot be retrieved, the Offset to
|
|
member description information will be returned as an offset of zero and the
|
|
message indicating why the information could not be currently retrieved will
|
|
be left in the Job Log. Also, no
|
|
<a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>, or escape messages
|
|
will be issued to the application when the member description information
|
|
cannot be retrieved.
|
|
<img src="deltaend.gif" alt="End of Change">
|
|
The member descriptions have the same format as those generated by the Retrieve
|
|
Member Description (QUSRMBRD) API. The following relationship exists between
|
|
the QUSLMBR format name and the QUSRMBRD member descriptions:</p>
|
|
|
|
<ul>
|
|
<li>MBRL0310 generates an MBRD0100 description.</li>
|
|
|
|
<li>MBRL0320 generates an MBRD0200 description.</li>
|
|
|
|
<li>MBRL0330 generates an MBRD0300 description.</li>
|
|
</ul>
|
|
|
|
<p>For more information about the member description formats, see <a href=
|
|
"qusrmbrd.htm">Retrieve Member Description (QUSRMBRD) API</a>.</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%">Member name used</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="center" valign="top">A</td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top">Reserved</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">Offset to member description information
|
|
<img src="delta.gif" alt="Start of Change">
|
|
(an offset of zero indicates that no information was retrieved)
|
|
<img src="deltaend.gif" alt="End of Change">
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">16</td>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="left" valign="top">CHAR(16)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
<h3><a name="HDRLMBRDE">Field Descriptions</a></h3>
|
|
|
|
<p><strong>Creation date and time.</strong> The date and time the member was
|
|
created. The format of this field is in the CYYMMDDHHMMSS as follows:</p>
|
|
|
|
<table width="100%">
|
|
<tr>
|
|
<td width="10%" valign="top"><em>C</em></td>
|
|
<td width="90%" valign="top">Century, where 0 indicates years 19<em>xx</em> and
|
|
1 indicates years 20<em>xx</em>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>YY</em></td>
|
|
<td valign="top">Year</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>MM</em></td>
|
|
<td valign="top">Month</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>DD</em></td>
|
|
<td valign="top">Day</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>HH</em></td>
|
|
<td valign="top">Hour</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>MM</em></td>
|
|
<td valign="top">Minute</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>SS</em></td>
|
|
<td valign="top">Second</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
|
|
<p><strong>File attribute.</strong> The type of file found:</p>
|
|
|
|
<table width="100%">
|
|
<tr>
|
|
<td width="10%" valign="top"><em>PF</em></td>
|
|
<td width="90%" valign="top">Physical file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>LF</em></td>
|
|
<td valign="top">Logical file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>DDMF</em></td>
|
|
<td valign="top">Distributed data management file</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
|
|
<p><strong>File library name specified.</strong> The name of the library
|
|
containing the file whose member names are to be placed in the list.</p>
|
|
|
|
<p><strong>File library name used.</strong> The name of the library containing
|
|
the file whose member names are placed in the list.</p>
|
|
|
|
<p><strong>File name specified.</strong> The name of the file specified in the
|
|
call to the API.</p>
|
|
|
|
<p><strong>File name used.</strong> The name of the file whose member names are
|
|
placed in the list.</p>
|
|
|
|
<p><strong>File text description.</strong> The description of the file.</p>
|
|
|
|
<p><strong>File text description CCSID.</strong> The CCSID for the file text
|
|
description. The job default CCSID of the current process will be used to
|
|
translate the text. For more information about CCSID, see the <a href=
|
|
"../nls/rbagsglobalmain.htm">Globalization</a> topic.</p>
|
|
|
|
<p><strong>Format name.</strong> The content and format of the information
|
|
returned for each member.</p>
|
|
|
|
<p><strong>Last source change or table refresh date and time.</strong> For source files, the date and time that
|
|
this source member was last changed. For SQL materialized query tables, the date and time that the last SQL Refresh Table statement refreshed this member. If the member has never been refreshed, this field will contain hexadecimal zeroes. This field is in the CYYMMDDHHMMSS format
|
|
where the format is the same as for the creation date and time field.</p>
|
|
|
|
<p><strong>Member name specified.</strong> The name of the member specified in
|
|
the call to the API.</p>
|
|
|
|
<p><strong>Member name used.</strong> The name of a member found in the
|
|
file.</p>
|
|
|
|
<p><strong>Member text description.</strong> Description of the member found in
|
|
the file.</p>
|
|
|
|
<p><strong>Member text description CCSID.</strong> The CCSID for the member
|
|
text description. The job default CCSID of the current process will be used to
|
|
translate the text. For more information about CCSID, see the <a href=
|
|
"../nls/rbagsglobalmain.htm">Globalization</a> topic.</p>
|
|
|
|
<p><strong>Offset to member description information.</strong> The number of
|
|
bytes from the beginning of the user space to the beginning of the retrieved
|
|
member description.</p>
|
|
|
|
<p><strong>Override processing.</strong> Whether overrides are to be processed.
|
|
The possible values are:</p>
|
|
|
|
<table width="100%">
|
|
<tr>
|
|
<td width="5%" valign="top"><em>0</em></td>
|
|
<td width="95%" valign="top">No override processing</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>1</em></td>
|
|
<td valign="top">Override processing</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
|
|
<p><strong>Reserved.</strong> An ignored field.</p>
|
|
|
|
<p><strong>Source file.</strong> Whether the file is a source file or a data
|
|
file. The possible values are:</p>
|
|
|
|
<table width="100%">
|
|
<tr>
|
|
<td width="5%" valign="top"><em>0</em></td>
|
|
<td width="95%" valign="top">Data file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>1</em></td>
|
|
<td valign="top">Source file</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
|
|
<p><strong>Source type.</strong> The type of source member if this is a source
|
|
file. Some possible values are:</p>
|
|
|
|
<ul>
|
|
<li>CL</li>
|
|
|
|
<li>COBOL</li>
|
|
|
|
<li>RPG</li>
|
|
|
|
<li>TXT</li>
|
|
</ul>
|
|
|
|
<p><strong>Total number of members in file.</strong> The total number of
|
|
members in the file specified.</p>
|
|
|
|
<p><strong>User space library name.</strong> The name of the library that
|
|
contains the user space that is to receive the generated list.</p>
|
|
|
|
<p><strong>User space name.</strong> The name of the user space that is to
|
|
receive the generated list.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="usage_notes">Usage Notes</a></h3>
|
|
|
|
<p>In multithreaded jobs, this API is not threadsafe and fails for distributed
|
|
data management (DDM) files of type *SNA.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Error Messages</h3>
|
|
|
|
<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">CPF24B4 E</td>
|
|
<td width="85%" valign="top">Severe error while addressing parameter list.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3CF1 E</td>
|
|
<td valign="top">Error code parameter not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C20 E</td>
|
|
<td valign="top">Error found by program &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C21 E</td>
|
|
<td valign="top">Format name &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C22 E</td>
|
|
<td valign="top">Cannot get information about file &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C23 E</td>
|
|
<td valign="top">Object &1 is not a database file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C25 E</td>
|
|
<td valign="top">Value &1 for file override parameter is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C27 E</td>
|
|
<td valign="top">Cannot get information about member &3 from file
|
|
&1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C36 E</td>
|
|
<td valign="top">Number of parameters, &1, entered for this API was not
|
|
valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF3C90 E</td>
|
|
<td valign="top">Literal value cannot be changed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF8100 E</td>
|
|
<td valign="top">All CPF81xx messages could be returned. xx is from 01 to
|
|
FF.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9800 E</td>
|
|
<td valign="top">All CPF98xx messages could be signaled. xx is from 01 to
|
|
FF.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
|
|
<hr>
|
|
API introduced: V1R3
|
|
|
|
<hr>
|
|
<center>
|
|
<table 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>
|
|
</center>
|
|
|
|
<br>
|
|
</body>
|
|
</html>
|
|
|