3395 lines
108 KiB
HTML
3395 lines
108 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 Objects (QUSLOBJ) 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 -->
|
|
<!-- QUSLOBJ SCRIPT A converted by B2H R4.1 (346) (CMS) by PMHALL at -->
|
|
<!-- RCHVMW2 on 7 Oct 1998 at 22:52:50 -->
|
|
<!-- File cleanup completed Feb 2002 by v2cdijab -->
|
|
<!-- Change history - the revision tagging used for changes relating -->
|
|
<!-- to DCR 98416 is v5r2delta LAW -->
|
|
<!-- Change history - the revision tagging used for changes relating -->
|
|
<!-- to Information Status description is v5r3delta LAW 06/03/2002 -->
|
|
<!-- Updates from System API Programming book phase-out, July 2002 by JET -->
|
|
<!-- Change history - the revision tagging used for changes relating -->
|
|
<!-- to DCR 99834 is v5r4delta LAW 12/26/2003 -->
|
|
<!-- Change history - Editorial changes for renaming the operating -->
|
|
<!-- system do not have revision tags LAW 01/09/2005 -->
|
|
<!-- End Header Records -->
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body>
|
|
<!-- Java sync-link -->
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
|
|
</script>
|
|
|
|
<a name="Top_Of_Page"></a>
|
|
|
|
<h2>List Objects (QUSLOBJ) API</h2>
|
|
|
|
<div class="box" style="width: 70%;">
|
|
<br>
|
|
Required Parameter Group:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">1</td>
|
|
<td align="left" valign="top" width="50%">Qualified user space object</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">Object and library 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">Object type</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(10)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Optional Parameter Group 1:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">5</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>
|
|
Optional Parameter Group 2:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">6</td>
|
|
<td align="left" valign="top" width="50%">Authority control</td>
|
|
<td align="left" valign="top" width="20%">Input</td>
|
|
<td align="left" valign="top" width="20%">Char(*)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">7</td>
|
|
<td align="left" valign="top">Selection control</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(*)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Optional Parameter Group 3:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">8</td>
|
|
<td align="left" valign="top" width="50%">Auxiliary storage pool (ASP)
|
|
control</td>
|
|
<td align="left" valign="top" width="20%">Input</td>
|
|
<td align="left" valign="top" width="20%">Char(*)<br>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Default Public Authority: *USE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: Yes<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The List Objects (QUSLOBJ) API lets you generate a list of object names and
|
|
descriptive information based on specified selection parameters.
|
|
This API returns information similar to the Display Object Description (DSPOBJD)
|
|
command. An advantage over the DSPOBJD command is that you can perform authority
|
|
checking on the objects and libraries. You can get a list of objects with only a
|
|
certain status, which you cannot do with the DSPOBJD command. The QUSLOBJ API places
|
|
the list in the specified user space. The generated list replaces any existing list
|
|
in the user space.</p>
|
|
|
|
<p>You can use the QUSLOBJ API to:</p>
|
|
|
|
<ul>
|
|
<li>List objects in a library</li>
|
|
|
|
<li>List objects of only one type</li>
|
|
|
|
<li>Write an application program to move programs from the QRPLOBJ library
|
|
(or the QRPLxxxxx library where 'xxxxx' is the number of a primary auxiliary
|
|
storage pool) back to where they were originally located</li>
|
|
|
|
<li>Provide backup analysis based on when the object was last saved or last
|
|
updated</li>
|
|
|
|
<li>Provide source member and object analysis from source member information to
|
|
verify that the current source was used to create the specified object</li>
|
|
</ul>
|
|
|
|
<p>The QUSLOBJ API returns information in several formats. All formats except
|
|
OBJL0100 include an information status field that describes the completeness
|
|
and validity of the information. Be sure to check the information status field
|
|
before using any other information returned.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<p>If you are authorized to the library, some object information is always
|
|
returned for the objects meeting the search criteria identified in the required
|
|
parameter group. To return any detailed object information in format OBJL0200
|
|
and above, the user must be authorized to the objects. The information status
|
|
field in format OBJL0200 is set to 'A' when the user is not authorized to the
|
|
objects. <img src="delta.gif" alt="Start of change">A value of *NOTAVL will
|
|
be returned for the object auditing information unless you have either all
|
|
object (*ALLOBJ) or audit (*AUDIT) special authority.
|
|
<img src="deltaend.gif" alt="End of change"></p>
|
|
|
|
<dl>
|
|
<dt><em>Auxiliary Storage Pool (ASP) Device Authority</em></dt>
|
|
|
|
<dd>*EXECUTE when a specific auxiliary storage pool (ASP) device name is
|
|
specified for the auxiliary storage pool (ASP) control parameter.<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><em>Object Authority</em></dt>
|
|
|
|
<dd>To return detailed object information, some authority other than *EXCLUDE is
|
|
needed when optional parameter group 2 is not specified.<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><em>Object Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE when optional parameter group 2 is not specified.<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><em>User Space Authority</em></dt>
|
|
|
|
<dd>*CHANGE<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><em>User Space Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><em>User Space Lock</em></dt>
|
|
|
|
<dd>*EXCLRD</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Required Parameter Group</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Qualified user space object</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(20)
|
|
|
|
<p>The name of the *USRSPC object that is to receive the generated list. The
|
|
first 10 characters contain the user space object name, and the second 10
|
|
characters contain the name of the library where the user space is located. The
|
|
special values supported for the library name are *LIBL and *CURLIB.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Format name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The format of the information returned on each object that is requested. You
|
|
must use one of the following format names:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>OBJL0100</em></td>
|
|
<td align="left" valign="top">Object names (fastest)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>OBJL0200</em></td>
|
|
<td align="left" valign="top">Text description and extended attribute</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>OBJL0300</em></td>
|
|
<td align="left" valign="top">Basic object information</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>OBJL0400</em></td>
|
|
<td align="left" valign="top">Creation information</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>OBJL0500</em></td>
|
|
<td align="left" valign="top">Save and restore information; journal
|
|
information</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>OBJL0600</em></td>
|
|
<td align="left" valign="top">Usage information</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>OBJL0700</em></td>
|
|
<td align="left" valign="top">All object information (slowest)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>For details about the formats, see <a href="#HDROBJLF">Format of the
|
|
Generated Lists</a>. For performance reasons, you should choose the format that
|
|
returns only as much information as you need. The higher the number of the
|
|
format name, the more information is returned and the more time it takes to
|
|
process.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Object and library name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(20)
|
|
|
|
<p>The object and library names to place in the *USRSPC object. The first 10
|
|
characters contain the object name, which may be a simple name, a generic name,
|
|
or the special values of *ALL, *ALLUSR, or *IBM. If *ALLUSR or *IBM is used, the
|
|
library name must be *LIBL or QSYS and the object type parameter must be *LIB.</p>
|
|
|
|
<ol>
|
|
<li>When *ALLUSR is specified with a library name of *LIBL and an object type
|
|
parameter of *LIB, a list of all user libraries in the thread's library name
|
|
space is returned. When *LIBL is specified, the auxiliary storage pool (ASP)
|
|
device name must be an asterisk (*) if the auxiliary storage pool (ASP) control
|
|
parameter is specified. Refer to *ALLUSR in the description of the second 10
|
|
characters of this parameter for a definition of user libraries.<br>
|
|
<br>
|
|
</li>
|
|
|
|
<li>When *ALLUSR is specified with a library name of QSYS and an object type
|
|
parameter of *LIB, a list of all user libraries in the auxiliary storage pools
|
|
defined by the auxiliary storage pool (ASP) control parameter is returned.
|
|
Refer to *ALLUSR in the description of the second 10 characters of this
|
|
parameter for a definition of user libraries.<br>
|
|
<br>
|
|
</li>
|
|
|
|
<li>When *IBM is specified with a library name of *LIBL and an object type of
|
|
*LIB, a list of libraries in the thread's library name space that are saved or
|
|
restored on the Save Library (SAVLIB) or Restore Library (RSTLIB) CL command
|
|
with LIB(*IBM) is returned. When *LIBL is specified, the auxiliary storage pool
|
|
(ASP) device name must be an asterisk (*) if the auxiliary storage pool (ASP)
|
|
control parameter is specified.<br>
|
|
<br>
|
|
</li>
|
|
|
|
<li>When *IBM is specified with a library name of QSYS and an object type of
|
|
*LIB, a list of libraries in the auxiliary storage pools specified by the
|
|
auxiliary storage pool (ASP) control parameter that are saved or restored on
|
|
the Save Library (SAVLIB) or Restore Library (RSTLIB) CL command with LIB(*IBM)
|
|
is returned.</li>
|
|
</ol>
|
|
|
|
<p>Library name errors are reported with escape messages when a single library
|
|
is specified. When searching a set of libraries (library specified as *ALL,
|
|
*ALLUSR, *LIBL, or *USRLIBL or auxiliary storage pool (ASP) device name
|
|
specified as *ALLAVL), library errors are reported with diagnostic messages and
|
|
processing continues. Library authority error messages are not sent when
|
|
searching a set of libraries. Escape messages are not sent for object name
|
|
errors. To determine if errors occurred on the object, use the number of list
|
|
entries field returned in the generic header and the information status field
|
|
in format OBJL0200.</p>
|
|
|
|
<p>The second 10 characters identify the name of the library or libraries to
|
|
search for the specified objects. The following special values are allowed:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All libraries in the auxiliary storage pools
|
|
defined by the auxiliary storage pool (ASP) control parameter are
|
|
searched.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALLUSR</em></td>
|
|
<td align="left" valign="top">All user libraries in the auxiliary storage pools
|
|
(ASPs) defined by the auxiliary storage pool (ASP) control parameter are
|
|
searched. User libraries are all libraries with names that do not begin with
|
|
the letter Q. For information on the
|
|
libraries included, see <a href="../apiref/genericlibname.htm#allusr">*ALLUSR</a> in
|
|
Generic library names.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*CURLIB</em></td>
|
|
<td valign="top">The thread's current library is searched. When this value is
|
|
used, the auxiliary storage pool (ASP) device name in the auxiliary storage
|
|
pool (ASP) control parameter must be an asterisk (*), if specified.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*LIBL</em></td>
|
|
<td valign="top">All libraries in the thread's library list are searched. When
|
|
this value is used, the auxiliary storage pool (ASP) device name in the
|
|
auxiliary storage pool (ASP) control parameter must be an asterisk (*), if
|
|
specified.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>*USRLIBL</em></td>
|
|
<td valign="top">All libraries in the user portion of the thread's library list
|
|
are searched. When this value is used, the auxiliary storage pool (ASP) device
|
|
name in the auxiliary storage pool (ASP) control parameter must be an asterisk
|
|
(*), if specified.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Object type</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(10)
|
|
|
|
<p>The types of objects to search for. You may either enter a specific object
|
|
type, or a special value of *ALL. For a complete list of the available object
|
|
types, see the <img src="delta.gif" alt="Start of change">
|
|
<a href="../rbam6/rbam6objecttypes.htm">External object
|
|
types</a><img src="deltaend.gif" alt="End of change">
|
|
information.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Optional Parameter Group 1</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>Optional Parameter Group 2</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Authority control</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(*)
|
|
|
|
<p>This parameter is used to specify the authority check that should be done
|
|
for objects and libraries. Detailed object information will only be returned
|
|
for an object when you have the specified authority to the object. If this
|
|
parameter is omitted, the following occurs:</p>
|
|
|
|
<ul>
|
|
<li>*EXECUTE authority is checked for on the libraries</li>
|
|
|
|
<li>Object name and object type information are always returned for each
|
|
object. *ANY authority (some authority other than *EXCLUDE) is checked for on
|
|
the objects to return any detailed information about the objects.</li>
|
|
|
|
<li>Call level 0 is used</li>
|
|
</ul>
|
|
|
|
<p>This parameter is useful to select objects to which you are authorized. To
|
|
accomplish this, specify a select or omit status value in the selection control
|
|
parameter. The object name information in format OBJL0100 is always returned
|
|
for objects meeting the search criteria identified in the required parameter
|
|
group. (This assumes the thread has the required authority to the library.) The
|
|
information status field is set to an 'A' when the thread does not have the
|
|
object authority specified.</p>
|
|
|
|
<p>The following example shows what you would specify to obtain a subset of all
|
|
objects that you have object management authority to.</p>
|
|
|
|
<p>The authority control parameter would contain:</p>
|
|
|
|
<dl>
|
|
<dd>Length of authority control format: 48</dd>
|
|
|
|
<dd>Call level: 1</dd>
|
|
|
|
<dd>Displacement to object authorities: 28</dd>
|
|
|
|
<dd>Number of object authorities: 1</dd>
|
|
|
|
<dd>Displacement to library authorities: 38</dd>
|
|
|
|
<dd>Number of library authorities: 1</dd>
|
|
|
|
<dd>Object authorities: '*OBJMGT '</dd>
|
|
|
|
<dd>Library authorities: '*USE '</dd>
|
|
</dl>
|
|
|
|
<p>The selection control parameter would contain:</p>
|
|
|
|
<dl>
|
|
<dd>Length of selection control format: 21</dd>
|
|
|
|
<dd>Select or omit status value: 1</dd>
|
|
|
|
<dd>Displacement to statuses: 20</dd>
|
|
|
|
<dd>Number of statuses: 1</dd>
|
|
|
|
<dd>Statuses: 'A'</dd>
|
|
</dl>
|
|
|
|
<p>Because the program that calls the QUSLOBJ API adopts authority, the
|
|
authority check should be done at the call level previous to the current level
|
|
(thus call level 1). With call level 1, the list would not include any objects
|
|
for which you have adopted authority by the current program.</p>
|
|
|
|
<p>The select or omit status value of 1 indicates that the returned list will
|
|
omit the objects you do not have object management authority to. This authority
|
|
is specified in the object authorities field.</p>
|
|
|
|
<p>The format of this parameter is described in <a href="#HDRAUTHCTL">Authority
|
|
Control Format</a>.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Selection control</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(*)
|
|
|
|
<p>The criteria used to select or filter objects from the list based on
|
|
specified information status values.</p>
|
|
|
|
<p>This parameter is useful to reduce the total number of objects returned in
|
|
the list. The list of objects can be generated with only the specific status
|
|
that you are interested in. For example, this might be all damaged objects or
|
|
all objects that the caller of the API is not authorized to. The list of
|
|
objects also can be generated with all objects except objects of a specific
|
|
status.</p>
|
|
|
|
<p>The following example shows what you would specify to select all damaged
|
|
objects:</p>
|
|
|
|
<dl>
|
|
<dd>Length of selection control format: 22</dd>
|
|
|
|
<dd>Select or omit status value: 0</dd>
|
|
|
|
<dd>Displacement to statuses: 20</dd>
|
|
|
|
<dd>Number of statuses: 2</dd>
|
|
|
|
<dd>Statuses: DP</dd>
|
|
</dl>
|
|
|
|
<p>The format of this parameter is described in <a href="#HDRSELTCTL">Selection
|
|
Control Format</a>.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Optional Parameter Group 3</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Auxiliary storage pool (ASP) control</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(*)
|
|
|
|
<p>The information used to define the auxiliary storage pool (ASP) to search.
|
|
See <a href="#HDRXASPF">Auxiliary Storage Pool (ASP) Control
|
|
Format</a> for details.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRAUTHCTL">Authority Control Format</a></h3>
|
|
|
|
<p>The following shows the format of the authority control parameter. For
|
|
detailed descriptions of the fields in the table, see <a href="#HDRADDINF">
|
|
Field Descriptions</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%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Length of authority control
|
|
format</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">Call level</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">Displacement to object authorities</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 object authorities</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">Displacement to library authorities</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">Number of library authorities</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">Reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">ARRAY(*) of CHAR(10)</td>
|
|
<td align="left" valign="top">Object authorities</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">ARRAY(*) of CHAR(10)</td>
|
|
<td align="left" valign="top">Library authorities</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSELTCTL">Selection Control Format</a></h3>
|
|
|
|
<p>The following shows the format of the selection control parameter. For
|
|
detailed descriptions of the fields in the table, see <a href="#HDRADDINF">
|
|
Field Descriptions</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%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Length of selection control
|
|
format</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">Select or omit status value</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">Displacement to statuses</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 statuses</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">Reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">ARRAY(*) of CHAR(1)</td>
|
|
<td align="left" valign="top">Statuses</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
<h3><a name="HDRXASPF">Auxiliary Storage Pool (ASP) Control Format</a></h3>
|
|
|
|
<p>The following shows the format of the auxiliary storage pool (ASP) control
|
|
parameter. This parameter is used to define the auxiliary storage pools (ASPs)
|
|
to search. For detailed descriptions of the fields in the table, see <a href=
|
|
"#HDRADDINF">Field Descriptions</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%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Length of auxiliary storage pool
|
|
(ASP) control format</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">Auxiliary storage pool (ASP) device name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="center" valign="top">E</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Auxiliary storage pool (ASP) search type</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRADDINF">Field Descriptions</a></h3>
|
|
|
|
<p><strong>Auxiliary storage pool (ASP) device name.</strong> The name of an
|
|
auxiliary storage pool (ASP) device in which storage is allocated for the library
|
|
that contains the object. The ASP device must have a status of 'Available'. This
|
|
field must be an asterisk (*) if optional parameter group 3 is specified when
|
|
*CURLIB, *LIBL, or *USRLIBL is specified as the library name in the object and
|
|
library name parameter. If optional parameter group 3 is omitted in cases where
|
|
it is valid for the ASP device name to have a value other than an asterisk (*),
|
|
the thread's library name space will be used. One of the following special values
|
|
may be specified:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*</em></td>
|
|
<td align="left" valign="top">The ASPs in the thread's library name space.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SYSBAS</em></td>
|
|
<td align="left" valign="top">The system ASP (ASP 1) and defined basic user
|
|
ASPs (ASPs 2-32).</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURASPGRP</em></td>
|
|
<td align="left" valign="top">The ASPs in the current thread's ASP group.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALLAVL</em></td>
|
|
<td align="left" valign="top">All available ASPs. This includes the system ASP
|
|
(ASP 1), all defined basic user ASPs (ASPs 2-32), and all available primary and
|
|
secondary ASPs (ASPs 33-255 with a status of 'Available').
|
|
<img src="delta.gif" alt="Start of change">The ASP groups are searched
|
|
in ascending alphabetical order by the primary ASP name. The system ASP and
|
|
all defined basic user ASPs are searched after the ASP groups. ASPs and libraries
|
|
to which you are not authorized are bypassed and no authority error messages
|
|
are sent.<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Auxiliary storage pool (ASP) search type.</strong> The type of the
|
|
search when a specific auxiliary storage pool (ASP) device name is specified
|
|
for the ASP device name field. This field must be blanks when a special value
|
|
is specified for the auxiliary storage pool (ASP) device name field. One of the
|
|
following values may be specified:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ASP</em></td>
|
|
<td align="left" valign="top">Only the single ASP named in the auxiliary
|
|
storage pool (ASP) device name field will be searched.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ASPGRP</em></td>
|
|
<td align="left" valign="top">All ASPs in the auxiliary storage pool (ASP)
|
|
group named in the auxiliary storage pool (ASP) device name field will be
|
|
searched. The device name must be the name of the primary auxiliary storage
|
|
pool (ASP) in the group.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Call level.</strong> The number of call levels to go back in the
|
|
call stack to do the authority check. If optional parameter group 2 is omitted,
|
|
a call level of 0 is used.</p>
|
|
|
|
<p>For example, if the program that calls this API adopts authority, you
|
|
probably would not want the authority check to use the adopted authority.
|
|
Therefore, the authority check should be done at the call level previous to the
|
|
current level. This field should then contain a 1. You can check the authority
|
|
at various call levels by specifying a number equivalent to the call level. For
|
|
example, to check the authority at the current call level, specify a 0. To
|
|
check the authority at the previous call level, specify a 1.</p>
|
|
|
|
<p>This field must be greater than or equal to 0 and less than the number of
|
|
programs in the call stack.</p>
|
|
|
|
<p><strong>Displacement to library authorities.</strong> The displacement, in
|
|
bytes, from the beginning of the authority control format to the list of
|
|
library authorities. The displacement value must be at least 28, which is past
|
|
the reserved portion of the format.</p>
|
|
|
|
<p><strong>Displacement to object authorities.</strong> The displacement, in
|
|
bytes, from the beginning of the authority control format to the list of object
|
|
authorities. The displacement value must be at least 28, which is past the
|
|
reserved portion of the format.</p>
|
|
|
|
<p><strong>Displacement to statuses.</strong> The displacement, in bytes, from
|
|
the beginning of the selection control format to the list of statuses
|
|
requested. The displacement value must be at least 20, which is past the
|
|
reserved portion of the format.</p>
|
|
|
|
<p><strong>Length of authority control format.</strong> The total length of the
|
|
authority control format. The length can be 0 bytes to indicate that no authority
|
|
control information is provided. Otherwise, the minimum size is 48 bytes, which
|
|
allows for one object and one library authority. An error is returned if the length
|
|
specified is less than the minimum and not 0.</p>
|
|
|
|
<p><strong>Length of auxiliary storage pool (ASP) control format.</strong> The
|
|
total length of the auxiliary storage pool (ASP) control format. The length
|
|
can be 0 bytes to indicate that no auxiliary storage pool (ASP) control
|
|
information is provided. Otherwise, the length must be 24 bytes. An error is
|
|
returned if the length specified is not 24 or 0.</p>
|
|
|
|
<p><strong>Length of selection control format.</strong> The total length of
|
|
the selection control format. The length can be 0 bytes to indicate that no
|
|
selection control information is provided. Otherwise, the minimum size is 21
|
|
bytes, which allows for one status value. An error is returned if the length
|
|
specified is less than the minimum and not 0.</p>
|
|
|
|
<p><strong>Library authorities.</strong> The authority to check for libraries.
|
|
The array can contain up to ten 10-character fields. If optional parameter
|
|
group 2 is omitted, *EXECUTE authority is checked for on the libraries.</p>
|
|
|
|
<p>The authority values can be specified in any combination. If *ALL, *CHANGE,
|
|
or *USE is specified with any of the other authority values, the authority
|
|
checked is the cumulative authority value.</p>
|
|
|
|
<p>The maximum number of authorities that can be specified is 10. This equals
|
|
all of the specific object and data authorities that can be listed
|
|
separately.</p>
|
|
|
|
<p>The following identifies the type of authority you have to the
|
|
library:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CHANGE</em></td>
|
|
<td align="left" valign="top">Change authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USE</em></td>
|
|
<td align="left" valign="top">Use authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJOPR</em></td>
|
|
<td align="left" valign="top">Object operational authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJMGT</em></td>
|
|
<td align="left" valign="top">Object management authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJEXIST</em></td>
|
|
<td align="left" valign="top">Object existence authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJALTER</em></td>
|
|
<td align="left" valign="top">Alter authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJREF</em></td>
|
|
<td align="left" valign="top">Reference authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*READ</em></td>
|
|
<td align="left" valign="top">Read authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ADD</em></td>
|
|
<td align="left" valign="top">Add authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*UPD</em></td>
|
|
<td align="left" valign="top">Update authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*DLT</em></td>
|
|
<td align="left" valign="top">Delete authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*EXECUTE</em></td>
|
|
<td align="left" valign="top">Execute authority</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Number of library authorities.</strong> The number of authorities
|
|
specified in the library authorities array. You can specify 1 through 10
|
|
authorities.</p>
|
|
|
|
<p><strong>Number of object authorities.</strong> The number of authorities
|
|
specified in the object authorities array. You can specify 1 through 11
|
|
authorities.</p>
|
|
|
|
<p><strong>Number of statuses.</strong> The number of statuses specified in the
|
|
statuses array. You can specify 1 through 5 statuses.</p>
|
|
|
|
<p><strong>Object authorities.</strong> The authority to check for objects. The
|
|
array can contain up to eleven 10-character fields. If optional parameter group
|
|
2 is omitted, *ANY authority is checked for on the objects.</p>
|
|
|
|
<p>The authority values can be specified in any combination with the exception
|
|
of the special value *ANY. This must be specified as the only value. If *ALL,
|
|
*CHANGE, *USE, or *AUTLMGT is specified with any of the other authority values,
|
|
the authority checked is the cumulative authority value.</p>
|
|
|
|
<p>The maximum number of authorities that can be specified is 11, which equals
|
|
all the specific object and data authorities and *AUTLMGT authority.</p>
|
|
|
|
<p>The following identifies the type of authority you have to the
|
|
object:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CHANGE</em></td>
|
|
<td align="left" valign="top">Change authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USE</em></td>
|
|
<td align="left" valign="top">Use authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*AUTLMGT</em></td>
|
|
<td align="left" valign="top">Authorization list management authority. (This
|
|
value is valid only if the object type is *AUTL. It will be ignored for other
|
|
object types.)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJOPR</em></td>
|
|
<td align="left" valign="top">Object operational authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJMGT</em></td>
|
|
<td align="left" valign="top">Object management authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJEXIST</em></td>
|
|
<td align="left" valign="top">Object existence authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJALTER</em></td>
|
|
<td align="left" valign="top">Alter authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJREF</em></td>
|
|
<td align="left" valign="top">Reference authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*READ</em></td>
|
|
<td align="left" valign="top">Read authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ADD</em></td>
|
|
<td align="left" valign="top">Add authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*UPD</em></td>
|
|
<td align="left" valign="top">Update authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*DLT</em></td>
|
|
<td align="left" valign="top">Delete authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*EXECUTE</em></td>
|
|
<td align="left" valign="top">Execute authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ANY</em></td>
|
|
<td align="left" valign="top">Some authority other than *EXCLUDE. (If this value
|
|
is specified, no other values can be specified.)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Reserved.</strong> This field is reserved. It must be set to
|
|
hexadecimal zeros.</p>
|
|
|
|
<p><strong>Select or omit status value.</strong> An indicator that determines
|
|
whether objects are selected or omitted from the list based on the statuses
|
|
specified.</p>
|
|
|
|
<p>This field is useful in generating a list of objects with a certain
|
|
information status, such as damaged or partially damaged objects. It can also
|
|
be used to generate a list of all objects except objects with a certain
|
|
information status, such as unauthorized objects.</p>
|
|
|
|
<p>Valid values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Select on status value</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Omit on status value</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Statuses.</strong> The status of objects to select or omit from the
|
|
list of objects generated. Valid values are all of the possible values listed
|
|
under the information status field (format OBJL0200). The special value * can
|
|
be used to select all objects with any information status field. If optional
|
|
parameter group 2 is omitted, all objects with any information status are
|
|
selected.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROBJLF">Format of the Generated Lists</a></h3>
|
|
|
|
<p>The object list consists of:</p>
|
|
|
|
<ul>
|
|
<li>A user area</li>
|
|
|
|
<li>A generic header</li>
|
|
|
|
<li>An input parameter section</li>
|
|
|
|
<li>A list data section</li>
|
|
</ul>
|
|
|
|
<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 other items, see the
|
|
following sections. For a detailed description of each field in the information
|
|
returned, see <a href="#HDRADDINFO">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. 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 API <a href="../apiref/apiexmp.htm">
|
|
Examples</a>.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROBIP1">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">Object 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">Object 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">Object type specified</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">58</td>
|
|
<td align="center" valign="top">3A</td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top">Reserved</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">Error code bytes provided</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">64</td>
|
|
<td align="center" valign="top">40</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of authority control format</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">68</td>
|
|
<td align="center" valign="top">44</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Call level</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">72</td>
|
|
<td align="center" valign="top">48</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Displacement to object authorities</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">76</td>
|
|
<td align="center" valign="top">4C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Number of object authorities</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">Displacement to library authorities</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">84</td>
|
|
<td align="center" valign="top">54</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Number of library authorities</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">Length of selection control format</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">92</td>
|
|
<td align="center" valign="top">5C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Select or omit status value</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">Displacement to statuses</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">100</td>
|
|
<td align="center" valign="top">64</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Number of statuses</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">104</td>
|
|
<td align="center" valign="top">68</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of auxiliary storage pool (ASP) control
|
|
format</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">108</td>
|
|
<td align="center" valign="top">6C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Auxiliary storage pool (ASP) device name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">118</td>
|
|
<td align="center" valign="top">76</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Auxiliary storage pool (ASP) search type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">ARRAY(*) of CHAR(10)</td>
|
|
<td align="left" valign="top">Object authorities</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">ARRAY(*) of CHAR(10)</td>
|
|
<td align="left" valign="top">Library authorities</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">ARRAY(*) of CHAR(1)</td>
|
|
<td align="left" valign="top">Statuses</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROBJL1">OBJL0100 List Data Section</a></h3>
|
|
|
|
<p>The following information is returned in the list data section of the
|
|
OBJL0100 format. For detailed descriptions of the fields in the table, see <a
|
|
href="#HDRADDINFO">Field Descriptions</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%">Object 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">Object 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">Object type used</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROBJL2">OBJL0200 List Data Section</a></h3>
|
|
|
|
<p>The following information is returned in the list data section of the
|
|
OBJL0200 format. For detailed descriptions of the fields in the table, see <a
|
|
href="#HDRADDINFO">Field Descriptions</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%"> </td>
|
|
<td align="left" valign="top" width="60%">Everything from the OBJL0100
|
|
format</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="center" valign="top">1E</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Information status</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">31</td>
|
|
<td align="center" valign="top">1F</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Extended object attribute</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">41</td>
|
|
<td align="center" valign="top">29</td>
|
|
<td align="left" valign="top">CHAR(50)</td>
|
|
<td align="left" valign="top">Text description</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">91</td>
|
|
<td align="center" valign="top">5B</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">User-defined attribute</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">101</td>
|
|
<td align="center" valign="top">65</td>
|
|
<td align="left" valign="top">CHAR(7)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROBJL3">OBJL0300 List Data Section</a></h3>
|
|
|
|
<p>The following information is returned in the list data section of the
|
|
OBJL0300 format. For detailed descriptions of the fields in the table, see <a
|
|
href="#HDRADDINFO">Field Descriptions</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%"> </td>
|
|
<td align="left" valign="top" width="60%">Everything from the OBJL0200
|
|
format</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">108</td>
|
|
<td align="center" valign="top">6C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Object auxiliary storage pool (ASP) number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">112</td>
|
|
<td align="center" valign="top">70</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Object owner</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">122</td>
|
|
<td align="center" valign="top">7A</td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top">Object domain</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">124</td>
|
|
<td align="center" valign="top">7C</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Creation date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">132</td>
|
|
<td align="center" valign="top">84</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Change date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">140</td>
|
|
<td align="center" valign="top">8C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Storage</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">150</td>
|
|
<td align="center" valign="top">96</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Object compression status</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">151</td>
|
|
<td align="center" valign="top">97</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Allow change by program</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">152</td>
|
|
<td align="center" valign="top">98</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Changed by program</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">153</td>
|
|
<td align="center" valign="top">99</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Object auditing value</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">163</td>
|
|
<td align="center" valign="top">A3</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Digitally signed</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">164</td>
|
|
<td align="center" valign="top">A4</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Digitally signed by system-trusted source</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">165</td>
|
|
<td align="center" valign="top">A5</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Digitally signed more than once</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">166</td>
|
|
<td align="center" valign="top">A6</td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">168</td>
|
|
<td align="center" valign="top">A8</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Library auxiliary storage pool (ASP) number</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROBJL4">OBJL0400 List Data Section</a></h3>
|
|
|
|
<p>The following information is returned in the list data section of the
|
|
OBJL0400 format. For detailed descriptions of the fields in the table, see <a
|
|
href="#HDRADDINFO">Field Descriptions</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%"> </td>
|
|
<td align="left" valign="top" width="60%">Everything from the OBJL0300
|
|
format</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">172</td>
|
|
<td align="center" valign="top">AC</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Source file name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">182</td>
|
|
<td align="center" valign="top">B6</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Source file library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">192</td>
|
|
<td align="center" valign="top">C0</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Source file member name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">202</td>
|
|
<td align="center" valign="top">CA</td>
|
|
<td align="left" valign="top">CHAR(13)</td>
|
|
<td align="left" valign="top">Source file updated date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">215</td>
|
|
<td align="center" valign="top">D7</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Creator's user profile</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">225</td>
|
|
<td align="center" valign="top">E1</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">System where object was created</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">233</td>
|
|
<td align="center" valign="top">E9</td>
|
|
<td align="left" valign="top">CHAR(9)</td>
|
|
<td align="left" valign="top">System level</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">242</td>
|
|
<td align="center" valign="top">F2</td>
|
|
<td align="left" valign="top">CHAR(16)</td>
|
|
<td align="left" valign="top">Compiler</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">258</td>
|
|
<td align="center" valign="top">102</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Object level</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">266</td>
|
|
<td align="center" valign="top">10A</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">User changed</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">267</td>
|
|
<td align="center" valign="top">10B</td>
|
|
<td align="left" valign="top">CHAR(16)</td>
|
|
<td align="left" valign="top">Licensed program</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">283</td>
|
|
<td align="center" valign="top">11B</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Program temporary fix (PTF)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">293</td>
|
|
<td align="center" valign="top">125</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Authorized program analysis report (APAR)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">303</td>
|
|
<td align="center" valign="top">12F</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Primary group</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">313</td>
|
|
<td align="center" valign="top">139</td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">315</td>
|
|
<td align="center" valign="top">13B</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Optimum space alignment</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">316</td>
|
|
<td align="center" valign="top">13C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">
|
|
<img src="delta.gif" alt="Start of change">Primary associated space size
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">320</td>
|
|
<td align="center" valign="top">140</td>
|
|
<td align="left" valign="top">CHAR(4)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROBJL5">OBJL0500 List Data Section</a></h3>
|
|
|
|
<p>The following information is returned in the list data section of the
|
|
OBJL0500 format. For detailed descriptions of the fields in the table, see <a
|
|
href="#HDRADDINFO">Field Descriptions</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%"> </td>
|
|
<td align="left" valign="top" width="60%">Everything from the OBJL0400
|
|
format</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">324</td>
|
|
<td align="center" valign="top">144</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Object saved date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">332</td>
|
|
<td align="center" valign="top">14C</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Object restored date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">340</td>
|
|
<td align="center" valign="top">154</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Saved size</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">344</td>
|
|
<td align="center" valign="top">158</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Saved size multiplier</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">348</td>
|
|
<td align="center" valign="top">15C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Save sequence number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">352</td>
|
|
<td align="center" valign="top">160</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Save command</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">362</td>
|
|
<td align="center" valign="top">16A</td>
|
|
<td align="left" valign="top">CHAR(71)</td>
|
|
<td align="left" valign="top">Save volume ID</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">433</td>
|
|
<td align="center" valign="top">1B1</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Save device</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">443</td>
|
|
<td align="center" valign="top">1BB</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Save file name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">453</td>
|
|
<td align="center" valign="top">1C5</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Save file library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">463</td>
|
|
<td align="center" valign="top">1CF</td>
|
|
<td align="left" valign="top">CHAR(17)</td>
|
|
<td align="left" valign="top">Save label</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">480</td>
|
|
<td align="center" valign="top">1E0</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Save active date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">488</td>
|
|
<td align="center" valign="top">1E8</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Journal status</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">489</td>
|
|
<td align="center" valign="top">1E9</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Journal name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">499</td>
|
|
<td align="center" valign="top">1F3</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Journal library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">509</td>
|
|
<td align="center" valign="top">1FD</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Journal images</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">510</td>
|
|
<td align="center" valign="top">1FE</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Journal entries to be omitted</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">511</td>
|
|
<td align="center" valign="top">1FF</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Journal start date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">519</td>
|
|
<td align="center" valign="top">207</td>
|
|
<td align="left" valign="top">CHAR(13)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROBJL6">OBJL0600 List Data Section</a></h3>
|
|
|
|
<p>The following information is returned in the list data section of the
|
|
OBJL0600 format. For detailed descriptions of the fields in the table, see <a
|
|
href="#HDRADDINFO">Field Descriptions</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%"> </td>
|
|
<td align="left" valign="top" width="60%">Everything from the OBJL0500
|
|
format</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">532</td>
|
|
<td align="center" valign="top">214</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Last-used date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">540</td>
|
|
<td align="center" valign="top">21C</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Reset date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">548</td>
|
|
<td align="center" valign="top">224</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Days-used count</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">552</td>
|
|
<td align="center" valign="top">228</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Usage information updated</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">553</td>
|
|
<td align="center" valign="top">229</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Object auxiliary storage pool (ASP) device
|
|
name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">563</td>
|
|
<td align="center" valign="top">233</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Library auxiliary storage pool (ASP) device
|
|
name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">573</td>
|
|
<td align="center" valign="top">23D</td>
|
|
<td align="left" valign="top">CHAR(3)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROBJL7">OBJL0700 List Data Section</a></h3>
|
|
|
|
<p>The following information is returned in the list data section of the
|
|
OBJL0700 format. For detailed descriptions of the fields in the table, see <a
|
|
href="#HDRADDINFO">Field Descriptions</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%"> </td>
|
|
<td align="left" valign="top" width="60%">Everything from the OBJL0600
|
|
format</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">576</td>
|
|
<td align="center" valign="top">240</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Object size</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">580</td>
|
|
<td align="center" valign="top">244</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Object size multiplier</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">584</td>
|
|
<td align="center" valign="top">248</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">
|
|
<img src="delta.gif" alt="Start of change">Object overflowed
|
|
auxiliary storage pool (ASP) indicator
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">
|
|
<img src="delta.gif" alt="Start of change">585</td>
|
|
<td align="center" valign="top">249</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Object auxiliary storage pool (ASP)
|
|
group name<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">
|
|
<img src="delta.gif" alt="Start of change">595</td>
|
|
<td align="center" valign="top">253</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Library auxiliary storage pool (ASP)
|
|
group name<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">
|
|
<img src="delta.gif" alt="Start of change">605</td>
|
|
<td align="center" valign="top">25D</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Starting journal receiver name for apply
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">
|
|
<img src="delta.gif" alt="Start of change">615</td>
|
|
<td align="center" valign="top">267</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Starting journal receiver library name
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">
|
|
<img src="delta.gif" alt="Start of change">625</td>
|
|
<td align="center" valign="top">271</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Starting journal receiver
|
|
library auxiliary storage pool (ASP) device name
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">
|
|
<img src="delta.gif" alt="Start of change">635</td>
|
|
<td align="center" valign="top">27B</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Starting journal receiver
|
|
library auxiliary storage pool (ASP) group name
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">
|
|
<img src="delta.gif" alt="Start of change">645</td>
|
|
<td align="center" valign="top">285</td>
|
|
<td align="left" valign="top">CHAR(3)</td>
|
|
<td align="left" valign="top">Reserved
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRADDINFO">Field Descriptions</a></h3>
|
|
|
|
<p><strong>Allow change by program.</strong> A 1-character variable that is
|
|
used to return the allow change by program flag. A 1 is returned if the object
|
|
can be changed with the Change Object Description (QLICOBJD) API. A 0 is
|
|
returned if the object cannot be changed with the API.</p>
|
|
|
|
<p><strong>Authorized program analysis report (APAR).</strong> The identifier
|
|
of the authorized program analysis report (APAR) that caused this object to be
|
|
replaced. The field is blank if the object did not change because of an
|
|
APAR.</p>
|
|
|
|
<p><strong>Auxiliary storage pool (ASP) device name.</strong> The name of the
|
|
auxiliary storage pool (ASP) device to be searched for the library, as specified
|
|
in the call to the API.</p>
|
|
|
|
<p><strong>Auxiliary storage pool (ASP) search type.</strong> The type of the
|
|
auxiliary storage pool (ASP) search, as specified in the call to the API.</p>
|
|
|
|
<p><strong>Call level.</strong> The number of call levels to go back in the
|
|
call stack to do the authority check. If optional parameter group 2 is omitted,
|
|
a call level of 0 is used.</p>
|
|
|
|
<p>For example, if the program that calls this API adopts authority, you would
|
|
probably not want the authority check to use the adopted authority. Therefore,
|
|
the authority check should be done at the call level previous to the current
|
|
level. This field should then contain a 1. You can check the authority at
|
|
various call levels by specifying a number equivalent to the call level. For
|
|
example, to check the authority at the current call level, specify a 0. To
|
|
check the authority at the previous call level, specify a 1.</p>
|
|
|
|
<p>This field must be greater than or equal to 0 and less than the number of
|
|
programs in the call stack.</p>
|
|
|
|
<p><strong>Changed by program.</strong> A 1-character variable that is used to
|
|
return the changed by program flag. A 1 is returned if the object has been
|
|
changed with the QLICOBJD API. A 0 is returned if the object has not been
|
|
changed by the API.</p>
|
|
|
|
<p><strong>Change date and time.</strong> The time at which the object was last
|
|
changed, in system time-stamp format.</p>
|
|
|
|
<p><strong>Compiler.</strong> The licensed program identifier, version number,
|
|
release level, and modification level of the compiler. The field has a
|
|
pppppppVvvRrrMmm format where:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>ppppppp</em></td>
|
|
<td align="left" valign="top">The licensed program identifier.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Vvv</em></td>
|
|
<td align="left" valign="top">The character V is followed by a 2-character
|
|
version number.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Rrr</em></td>
|
|
<td align="left" valign="top">The character R is followed by a 2-character
|
|
release level.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><em>Mmm</em></td>
|
|
<td>The character M is followed by a 2-character modification level.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>The field is blank if you do not compile the program.</p>
|
|
|
|
<p><strong>Creation date and time.</strong> The time at which the object was
|
|
created, in system time-stamp format. See the <a href="qwccvtdt.htm">Convert
|
|
Date and Time Format</a> (QWCCVTDT) API for more information about using this
|
|
time-stamp format.</p>
|
|
|
|
<p><strong>Creator's user profile.</strong> The name of the user that created
|
|
the object.</p>
|
|
|
|
<p><strong>Days-used count.</strong> The number of days the object was used. If
|
|
the object does not have a last-used date, the count is 0.</p>
|
|
|
|
<p><strong>Digitally signed.</strong> A 1-character variable that indicates whether
|
|
the object has a digital signature.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The object does not have a digital signature.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The object has a digital signature.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Digitally signed by system-trusted source.</strong> A 1-character
|
|
variable indicates whether the object is signed by a source that is trusted by
|
|
the system.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">None of the object signatures came from a source
|
|
that is trusted by the system.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The object is signed by a source that is trusted
|
|
by the system. If the object has multiple signatures, at least one of the
|
|
signatures came from a source that is trusted by the system.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Digitally signed more than once.</strong> A 1-character variable
|
|
that indicates whether the object has more than one digital signature.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The object has only one digital signature
|
|
or does not have a digital signature. Refer to the digitally signed
|
|
variable to determine whether the object has a digital signature.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The object has more than one digital
|
|
signature. Refer to the digitally signed by system-trusted source variable to
|
|
determine whether the object has a digital signature from a source
|
|
trusted by the system.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Displacement to library authorities.</strong> The displacement, in
|
|
bytes, from the beginning of this input parameter structure to the list of
|
|
library authorities, as specified in the call to the API.</p>
|
|
|
|
<p><strong>Displacement to object authorities.</strong> The displacement, in
|
|
bytes, from the beginning of this input parameter structure to the list of
|
|
object authorities, as specified in the call to the API.</p>
|
|
|
|
<p><strong>Displacement to statuses.</strong> The displacement, in bytes, from
|
|
the beginning of this input parameter structure to the list of statuses
|
|
requested, as specified in the call to the API.</p>
|
|
|
|
<p><strong>Error code bytes provided.</strong> The length of the area that the
|
|
calling application provides for the error code, in bytes.</p>
|
|
|
|
<p><strong>Extended object attribute.</strong> The extended attribute of the
|
|
object, such as a program or file type. Extended attributes further describe
|
|
the object. For example, an object type of *PGM may have a value of RPG (RPG
|
|
program) or CLP (CL program), and an object type of *FILE may have a value of
|
|
PF (physical file), LF (logical file), DSPF (display file), SAVF (save file),
|
|
and so on.</p>
|
|
|
|
<p><strong>Format name.</strong> The format of the returned output.</p>
|
|
|
|
<p><strong>Information status.</strong> Whether or not the QUSLOBJ API returns
|
|
the requested information for this object. Possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>blank</em></td>
|
|
<td align="left" valign="top">The requested information is returned. No errors
|
|
occurred.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>A</em></td>
|
|
<td align="left" valign="top">No information is returned. The thread that
|
|
called this API needs either the authority specified in the object authorities
|
|
field or *ANY authority (the default) to the object.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>D</em></td>
|
|
<td align="left" valign="top">The requested information is returned but may be
|
|
incomplete. The object is damaged and should be deleted and created again as soon
|
|
as possible.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>L</em></td>
|
|
<td align="left" valign="top">No information is returned because the object is
|
|
locked.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>P</em></td>
|
|
<td align="left" valign="top">The requested information is returned. However,
|
|
the object is partially damaged. In most instances, to recover from partial
|
|
object damage, you delete the damaged object and either restore a saved copy or
|
|
create the object again. For some damaged objects, special recovery procedures
|
|
are possible. Refer to the <a href="../books/sc415304.pdf" target="_blank">
|
|
Backup and Recovery</a><img src="wbpdf.gif" alt="Link to PDF"> book for more
|
|
information on damaged objects.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>If two or more conditions occur that include no authorization (A) to the
|
|
object, the status is set to <samp>A</samp>. If the object is damaged (D) and
|
|
locked (L), or if the object is partially damaged (P) and locked, the status is
|
|
set to <samp>L</samp>.</p>
|
|
|
|
<p>If the value of this field is A or L, your application should not use the
|
|
other fields for the object. Only the object name, library, and type fields
|
|
contain accurate data.</p>
|
|
|
|
<p><strong>Journal entries to be omitted.</strong> The journal entries to be
|
|
omitted. The field is 1 if <em>open</em> and <em>close</em> operations do not
|
|
generate <em>open</em> and <em>close</em> journal entries. The field is 0 if no
|
|
entries are omitted. This field is blank if the object has never been
|
|
journaled.</p>
|
|
|
|
<p><strong>Journal images.</strong> The type of images that are written to the
|
|
journal receiver for updates to the object. The field is 0 if only <em>
|
|
after</em> images are generated for changes to the object. The field is 1 if
|
|
both <em>before</em> and <em>after</em> images are generated for changes to the
|
|
object. This field is blank if the object has never been journaled.</p>
|
|
|
|
<p><strong>Journal library name.</strong> The name of the library that contains
|
|
the journal. This field is blank if the object has never been journaled.</p>
|
|
|
|
<p><strong>Journal name.</strong> The name of the current or last journal. This
|
|
field is blank if the object has never been journaled.</p>
|
|
|
|
<p><strong>Journal start date and time.</strong> The time at which journaling
|
|
for the object was last started, in system time-stamp format. This field
|
|
contains hexadecimal zeros if the object has never been journaled.</p>
|
|
|
|
<p><strong>Journal status.</strong> The 1-character variable that returns the
|
|
current journaling status of an object. The value is 1 if the object currently
|
|
is being journaled; the value is 0 if the object currently is not being
|
|
journaled.</p>
|
|
|
|
<p><strong>Last-used date and time.</strong> The date and time at which the
|
|
object was last used, in system time-stamp format. If the object has no
|
|
last-used date, the field contains hexadecimal zeros.</p>
|
|
|
|
<p><strong>Length of authority control format.</strong> The total length of the
|
|
authority control format, as specified in the call to the API.</p>
|
|
|
|
<p><strong>Length of auxiliary storage pool (ASP) control format.</strong> The total
|
|
length of the auxiliary storage pool (ASP) control format, as specified in the call
|
|
to the API.</p>
|
|
|
|
<p><strong>Length of selection control format.</strong> The total length of the
|
|
selection control format, as specified in the call to the API.</p>
|
|
|
|
<p><strong>Library authorities.</strong> The authority to check for libraries.
|
|
The array can contain up to ten 10-character fields. If optional parameter
|
|
group 2 is omitted, *EXECUTE authority is checked for on the libraries.</p>
|
|
|
|
<p>The authority values can be specified in any combination. If *ALL, *CHANGE,
|
|
or *USE is specified with any of the other authority values, the authority
|
|
checked is the cumulative authority value.</p>
|
|
|
|
<p>The maximum number of authorities that can be specified is 11. This equals
|
|
all of the specific object and data authorities that can be listed
|
|
separately.</p>
|
|
|
|
<p>The following identifies the type of authority you have to the
|
|
library:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CHANGE</em></td>
|
|
<td align="left" valign="top">Change authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USE</em></td>
|
|
<td align="left" valign="top">Use authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJOPR</em></td>
|
|
<td align="left" valign="top">Object operational authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJMGT</em></td>
|
|
<td align="left" valign="top">Object management authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJEXIST</em></td>
|
|
<td align="left" valign="top">Object existence authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJALTER</em></td>
|
|
<td align="left" valign="top">Alter authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJREF</em></td>
|
|
<td align="left" valign="top">Reference authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*READ</em></td>
|
|
<td align="left" valign="top">Read authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ADD</em></td>
|
|
<td align="left" valign="top">Add authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*UPD</em></td>
|
|
<td align="left" valign="top">Update authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*DLT</em></td>
|
|
<td align="left" valign="top">Delete authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*EXECUTE</em></td>
|
|
<td align="left" valign="top">Execute authority</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Library auxiliary storage pool (ASP) device name.</strong> The name of
|
|
the auxiliary storage pool (ASP) device where storage is allocated for the library
|
|
that contains the object. <img src="delta.gif" alt="Start of change">The
|
|
following special values may be returned:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*N</em></td>
|
|
<td align="left" valign="top">The name of the ASP device cannot be
|
|
determined.<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SYSBAS</em></td>
|
|
<td align="left" valign="top">System ASP (ASP 1) or basic user ASPs (ASPs
|
|
2-32)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><img src="delta.gif" alt="Start of change"><strong>Library
|
|
auxiliary storage pool (ASP) group name.</strong> The name of the auxiliary
|
|
storage pool (ASP) group where storage is allocated for the library that
|
|
contains the object. The name of the ASP group is the name of the primary ASP
|
|
within the ASP group. The value returned may be the same as the value returned
|
|
for the library auxiliary storage pool (ASP) device name field. The following
|
|
special values may be returned:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*N</em></td>
|
|
<td align="left" valign="top">The name of the ASP group cannot be determined.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SYSBAS</em></td>
|
|
<td align="left" valign="top">System ASP (ASP 1) or basic user ASPs (ASPs
|
|
2-32)<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
</table>
|
|
|
|
|
|
<p><strong>Library auxiliary storage pool (ASP) number.</strong> The number of
|
|
the auxiliary storage pool (ASP) where storage is allocated for the library
|
|
that contains the object. Valid values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">System ASP</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2-32</em></td>
|
|
<td align="left" valign="top">Basic user ASP</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>33-255</em></td>
|
|
<td align="left" valign="top">Primary or secondary ASP</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Licensed program.</strong> The name, release level, and modification
|
|
level of the licensed program if the retrieved object is part of a licensed
|
|
program. The 7-character name starts in character position 1, the version
|
|
number starts in position 8, the release level starts in position 11, and the
|
|
modification level starts in position 14. The field is blank if the retrieved
|
|
object is not a part of a licensed program.</p>
|
|
|
|
<p><strong>Number of library authorities.</strong> The number of authorities
|
|
specified in the library authorities array. You can specify 1 through 10
|
|
authorities.</p>
|
|
|
|
<p><strong>Number of object authorities.</strong> The number of authorities
|
|
specified in the object authorities array. You can specify 1 through 11
|
|
authorities.</p>
|
|
|
|
<p><strong>Number of statuses.</strong> The number of statuses specified in the
|
|
statuses array. You can specify 1 through 5 statuses.</p>
|
|
|
|
<p><strong>Object auditing value.</strong> A 10-character variable that is used
|
|
to return the type of auditing for an object. The valid values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">No auditing occurs for this object when it is
|
|
read or changed regardless of the user who is accessing the object.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USRPRF</em></td>
|
|
<td align="left" valign="top">Audit this object only if the user accessing the
|
|
object is being audited. The user profile for the thread is tested to determine
|
|
if auditing should be done for this object. The user profile can specify if
|
|
only change access is audited or if both read and change accesses are audited
|
|
for this object.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CHANGE</em></td>
|
|
<td align="left" valign="top">Audit all change access to this object by all
|
|
users on the system.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Audit all access to this object by all users on
|
|
the system. All access is defined as a read or change operation.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">
|
|
<img src="delta.gif" alt="Start of change"><em>*NOTAVL</em></td>
|
|
<td align="left" valign="top">The auditing value is not available because you
|
|
do not have either all object (*ALLOBJ) or audit (*AUDIT) special authority.
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Object authorities.</strong> The authority to check for objects. The
|
|
array can contain up to eleven 10-character fields. If optional parameter group
|
|
2 is omitted, *ANY authority is checked for on the objects.</p>
|
|
|
|
<p>The authority values can be specified in any combination with the exception
|
|
of the special value *ANY. This must be specified as the only value. If *ALL,
|
|
*CHANGE, *USE, or *AUTLMGT is specified with any of the other authority values,
|
|
the authority checked is the cumulative authority value.</p>
|
|
|
|
<p>The maximum number of authorities that can be specified is 11, which equals
|
|
all the specific object and data authorities and *AUTLMGT authority.</p>
|
|
|
|
<p>The following identifies the type of authority you have to the
|
|
object:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CHANGE</em></td>
|
|
<td align="left" valign="top">Change authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USE</em></td>
|
|
<td align="left" valign="top">Use authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*AUTLMGT</em></td>
|
|
<td align="left" valign="top">Authorization list management authority. (This
|
|
value is valid only if the object type is *AUTL. It will be ignored for other
|
|
object types.)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJOPR</em></td>
|
|
<td align="left" valign="top">Object operational authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJMGT</em></td>
|
|
<td align="left" valign="top">Object management authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJEXIST</em></td>
|
|
<td align="left" valign="top">Object existence authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJALTER</em></td>
|
|
<td align="left" valign="top">Alter authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*OBJREF</em></td>
|
|
<td align="left" valign="top">Reference authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*READ</em></td>
|
|
<td align="left" valign="top">Read authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ADD</em></td>
|
|
<td align="left" valign="top">Add authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*UPD</em></td>
|
|
<td align="left" valign="top">Update authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*DLT</em></td>
|
|
<td align="left" valign="top">Delete authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*EXECUTE</em></td>
|
|
<td align="left" valign="top">Execute authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ANY</em></td>
|
|
<td align="left" valign="top">Any authority other than *EXCLUDE. (If this value
|
|
is specified, no other values can be specified.)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Object auxiliary storage pool (ASP) device name.</strong> The name of the
|
|
auxiliary storage pool (ASP) device where storage is allocated for the object.
|
|
<img src="delta.gif" alt="Start of change">The following special values
|
|
may be returned:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*N</em></td>
|
|
<td align="left" valign="top">The name of the ASP device cannot be
|
|
determined.<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SYSBAS</em></td>
|
|
<td align="left" valign="top">System ASP (ASP 1) or defined basic
|
|
user ASPs (ASPs 2-32)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><img src="delta.gif" alt="Start of change"><strong>Object
|
|
auxiliary storage pool (ASP) group name.</strong> The name of the auxiliary
|
|
storage pool (ASP) group where storage is allocated for the object. The name
|
|
of the ASP group is the name of the primary ASP within the ASP group. The
|
|
value returned may be the same as the value returned for the object auxiliary
|
|
storage pool (ASP) device name field. The following special values may be
|
|
returned:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*N</em></td>
|
|
<td align="left" valign="top">The name of the ASP group cannot be determined.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SYSBAS</em></td>
|
|
<td align="left" valign="top">System ASP (ASP 1) or basic user ASPs (ASPs
|
|
2-32)<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Object auxiliary storage pool (ASP) number.</strong> The number of
|
|
the auxiliary storage pool (ASP) where storage is allocated for the object.
|
|
Valid values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">System ASP</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2-32</em></td>
|
|
<td align="left" valign="top">Basic user ASP</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>33-255</em></td>
|
|
<td align="left" valign="top">Primary or secondary ASP</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Object compression status.</strong> Whether the object is compressed
|
|
or decompressed. The status is returned in a 1-character variable with one of
|
|
these values:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>Y</em></td>
|
|
<td align="left" valign="top">Compressed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>N</em></td>
|
|
<td align="left" valign="top">Permanently decompressed and compressible.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>X</em></td>
|
|
<td align="left" valign="top">Permanently decompressed and <em>not</em>
|
|
compressible.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>T</em></td>
|
|
<td align="left" valign="top">Temporarily decompressed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>F</em></td>
|
|
<td align="left" valign="top">Saved with storage freed; compression status
|
|
cannot be determined.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><em>Temporarily</em> decompressed objects exist in both decompressed and
|
|
compressed form. <em>Permanently</em> decompressed objects exist in
|
|
decompressed form only. The system handles some decompression automatically,
|
|
depending on the type of object, the operation performed on it, and its
|
|
frequency of use. For an overview of object compression and decompression, see
|
|
the <img src="delta.gif" alt="Start of change"><a href="../rbam6/cmpdmp.htm">Compress
|
|
or decompress objects</a><img src="deltaend.gif" alt="End of change"> topic. For
|
|
details about how to explicitly compress and decompress objects, see the online help
|
|
for these commands: Compress Object (CPROBJ), Decompress Object (DCPOBJ), and
|
|
Reclaim Temporary Storage (RCLTMPSTG).</p>
|
|
|
|
<p><strong>Object domain.</strong> The domain that contains the object. The
|
|
value is *U if the object is in the user domain, or *S if the object is in the
|
|
system domain.</p>
|
|
|
|
<p><strong>Object level.</strong> The object control level for the created
|
|
object.</p>
|
|
|
|
<p><strong>Object library name specified.</strong> The name of the object
|
|
library, as specified in the call to the API.</p>
|
|
|
|
<p><strong>Object library name used.</strong> The name of the library
|
|
that contains the object.</p>
|
|
|
|
<p><strong>Object name specified.</strong> The name of the object, as specified
|
|
in the call to the API.</p>
|
|
|
|
<p><strong>Object name used.</strong> The name of the object.</p>
|
|
|
|
<p><img src="delta.gif" alt="Start of change"><strong>Object
|
|
overflowed auxiliary storage pool (ASP) indicator.</strong>
|
|
<img src="deltaend.gif" alt="End of change">The 1-character variable
|
|
that returns the object overflowed auxiliary storage pool (ASP) indicator. The
|
|
value is 1 if the object overflowed the ASP in which it resides; the value is 0
|
|
if the object has not overflowed the ASP. For objects in the system ASP (ASP 1)
|
|
or in a primary or secondary ASP (ASPs 33-255), a 0 is always returned because
|
|
it is not possible for an object that resides in the system ASP or in a primary
|
|
or secondary ASP to overflow its ASP.</p>
|
|
|
|
<p><strong>Object owner.</strong> The name of the object owner's user
|
|
profile.</p>
|
|
|
|
<p><strong>Object restored date and time.</strong> The time at which the object
|
|
was restored, in system time-stamp format. If the object has never been
|
|
restored, the field contains hexadecimal zeros.</p>
|
|
|
|
<p><strong>Object saved date and time.</strong> The time at which the object
|
|
was saved, in system time-stamp format. If the object has never been saved, the
|
|
field contains hexadecimal zeros.</p>
|
|
|
|
<p><strong>Object size.</strong> The size of the object in units of the object size
|
|
multiplier. The object size in bytes is equal to or smaller than the object size in
|
|
units multiplied by the object size multiplier.
|
|
<img src="delta.gif" alt="Start of change">The object size includes the
|
|
size returned in the primary associated space
|
|
size field (format OBJL0400).<img src="deltaend.gif" alt="End of change"></p>
|
|
|
|
<p><strong>Object size multiplier.</strong> The value to multiply the object
|
|
size by to get the object size in bytes.</p>
|
|
|
|
<p>The following values can be returned:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The object size is smaller than
|
|
1 000 000 000 bytes.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1024</em></td>
|
|
<td align="left" valign="top">The object size is between 1 000 000 000
|
|
and 1 023 999 998 976 bytes.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1048576</em></td>
|
|
<td align="left" valign="top">The object size is larger than
|
|
1 023 999 998 976
|
|
bytes.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Object type specified.</strong> The type of the object, as specified
|
|
in the call to the API.</p>
|
|
|
|
<p><strong>Object type used.</strong> The type of the object. For a list of all
|
|
the available object types, see the <img src="delta.gif" alt="Start of change">
|
|
<a href="../rbam6/rbam6objecttypes.htm">External object
|
|
types</a><img src="deltaend.gif" alt="End of change"> information.</p>
|
|
|
|
<p><strong>Optimum space alignment.</strong> A 1-character variable
|
|
that indicates whether the space associated with the object has been
|
|
optimally aligned. Optimum alignment may allow for better performance
|
|
of applications that use the object. The possible values are as
|
|
follows:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The space associated with the object has not
|
|
been optimally aligned.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The space associated with the object has
|
|
been optimally aligned.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">There is not a space associated with the object.
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><img src="delta.gif" alt="Start of change"><strong>Primary associated
|
|
space size.</strong> The size, in bytes, of the primary associated space used by the
|
|
object. If the object does not have an associated space, the size is 0.
|
|
<img src="deltaend.gif" alt="End of change"></p>
|
|
|
|
<p><strong>Primary group.</strong> The name of the user who is the primary
|
|
group for the object. If no primary group exists for the object, this field
|
|
contains a value of *NONE.</p>
|
|
|
|
<p><strong>Program temporary fix (PTF).</strong> The number of the program
|
|
temporary fix (PTF) number that caused this object to be replaced. This field
|
|
is blank if the object was not changed because of a PTF.</p>
|
|
|
|
<p><strong>Reserved.</strong> An unused field. It contains hexadecimal
|
|
zeros.</p>
|
|
|
|
<p><strong>Reset date and time.</strong> The date the days-used count was last
|
|
reset to zero, in system time-stamp format. If the days-used count has never
|
|
been reset, the field contains hexadecimal zeros.</p>
|
|
|
|
<p><strong>Save active date and time.</strong> The date and time the object was
|
|
last saved when the SAVACT(*LIB, *SYSDFN, or *YES) save operation was
|
|
specified, in system time-stamp format. This parameter is found on the Save
|
|
Library (SAVLIB), Save Object (SAVOBJ), Save Changed Object (SAVCHGOBJ), and
|
|
Save Document Library Object (SAVDLO) CL commands. If the object has never been
|
|
saved or if SAVACT(*NO) was specified on the last save operation for the
|
|
object, the field contains hexadecimal zeros.</p>
|
|
|
|
<p><strong>Save command.</strong> The command used to save the object. The
|
|
field is blank if the object was not saved.</p>
|
|
|
|
<p><strong>Save device.</strong> The type of device to which the object was
|
|
last saved. The field is *SAVF if the last save operation was to a save file.
|
|
The field is *DKT if the last save operation was to diskette. The field is *TAP
|
|
if the last save operation was to tape. The field is *OPT if the last save
|
|
operation was to optical. The field is blank if the object was not saved.</p>
|
|
|
|
<p><strong>Save file library name.</strong> The name of the library that
|
|
contains the save file if the object was saved to a save file. The field is
|
|
blank if the object was not saved to a save file.</p>
|
|
|
|
<p><strong>Save file name.</strong> The name of the save file if the object was
|
|
saved to a save file. The field is blank if the object was not saved to a save
|
|
file.</p>
|
|
|
|
<p><strong>Save label.</strong> The file label used when the object was saved.
|
|
The variable is blank if the object was not saved to tape, diskette, or
|
|
optical. The value of the variable corresponds to the value specified for the
|
|
LABEL of OPTFILE parameter on the command used to save the object.</p>
|
|
|
|
<p><strong>Save sequence number.</strong> The tape sequence number assigned
|
|
when the object was saved on tape. If the object was not saved to tape, the
|
|
field contains zeros.</p>
|
|
|
|
<p><strong>Save volume ID.</strong> The tape, diskette, or optical volumes that
|
|
are used for saving the object. The variable returns a maximum of 10
|
|
six-character volumes. The volume IDs begin in character positions 1, 8, 15,
|
|
22, 29, 36, 43, 50, 57, and 64. Each volume ID entry is separated by a single
|
|
character. If the object was saved in parallel format, the separator character
|
|
contains a 2 before the first volume in the second media file, a 3 before the
|
|
third media file, and so on, up to a 0 before the tenth media file. Otherwise,
|
|
the separator characters are blank. If more than 10 volumes are used and the
|
|
object was saved in serial format, 1 is returned in the 71st character of the
|
|
variable. If the object was saved in parallel format, a 2 is returned in the
|
|
71st character of the variable. Otherwise, the 71st character is blank. The
|
|
field is blank if the object was last saved to a save file or if it was never
|
|
saved.</p>
|
|
|
|
<p><strong>Saved size.</strong> The
|
|
size of the object in units of the saved size multiplier at the time of the last
|
|
save operation. The saved size in bytes is equal to or smaller than the saved size
|
|
in units multiplied by the saved size multiplier. The saved size includes the size
|
|
of the primary associated space, if one existed. The field contains zeros if the
|
|
object was not saved.</p>
|
|
|
|
<p><img src="delta.gif" alt="Start of change"><strong>Saved size
|
|
multiplier.</strong> The value to multiply the saved size by to get the saved
|
|
size in bytes.</p>
|
|
|
|
<p>The following values can be returned:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The saved size is smaller than
|
|
1 000 000 000 bytes.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1024</em></td>
|
|
<td align="left" valign="top">The saved size is between 1 000 000 000
|
|
and 1 023 999 998 976 bytes.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1048576</em></td>
|
|
<td align="left" valign="top">The saved size is larger than
|
|
1 023 999 998 976 bytes.
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Select or omit status value.</strong> An indicator that determines
|
|
whether objects are selected or omitted from the list based on the statuses
|
|
specified.</p>
|
|
|
|
<p>This field is useful in generating a list of objects with a certain
|
|
information status, such as damaged or partially damaged objects. It can also
|
|
be used to generate a list of all objects except objects with a certain
|
|
information status, such as unauthorized objects.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Select on status value</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Omit on status value</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Source file library name.</strong> The name of the library that
|
|
contains the source file used to create the object. The field is blank if no
|
|
source file created the object.</p>
|
|
|
|
<p><strong>Source file member name.</strong> The name of the member in the
|
|
source file. The field is blank if no source file created the object.</p>
|
|
|
|
<p><strong>Source file name.</strong> The name of the source file used to
|
|
create the object. The field is blank if no source file created the object.</p>
|
|
|
|
<p><strong>Source file updated date and time.</strong> The date and time the
|
|
member in the source file was last updated. This field is in the CYYMMDDHHMMSS
|
|
format where:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>C</em></td>
|
|
<td align="left" valign="top">Century, where 0 indicates years 19<em>xx</em>
|
|
and 1 indicates years 20<em>xx</em>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>YY</em></td>
|
|
<td align="left" valign="top">Year</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Month</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>DD</em></td>
|
|
<td align="left" valign="top">Day</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>HH</em></td>
|
|
<td align="left" valign="top">Hour</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Minute</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SS</em></td>
|
|
<td align="left" valign="top">Second</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>The field is blank if no source file created the object.</p>
|
|
|
|
<p><img src="delta.gif" alt="Start of change"><strong>Starting journal receiver
|
|
library name.</strong> The name of the library that contains the starting journal
|
|
receiver for apply. This field is blank if the object has never been journaled.
|
|
<img src="deltaend.gif" alt="End of change"></p>
|
|
|
|
<p><img src="delta.gif" alt="Start of change"><strong>Starting journal receiver
|
|
library auxiliary storage pool (ASP) device name.</strong> The name of the
|
|
auxiliary storage pool (ASP) device where storage is allocated for the library
|
|
that contains the starting journal receiver for apply. This field is blank if the
|
|
object has never been journaled. The following special values may be returned:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*N</em></td>
|
|
<td align="left" valign="top">The name of the ASP device cannot be determined.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td align="left" valign="top"><em>*SYSBAS</em></td>
|
|
<td align="left" valign="top">System ASP (ASP 1) or defined basic
|
|
user ASPs (ASPs 2-32)<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><img src="delta.gif" alt="Start of change"><strong>Starting journal
|
|
receiver library auxiliary storage pool (ASP) group name.</strong> The name
|
|
of the auxiliary storage pool (ASP) group where storage is allocated for the
|
|
library that contains the starting journal receiver. The name of the ASP group
|
|
is the name of the primary ASP within the ASP group. The value returned may be
|
|
the same as the value returned for the journal receiver library auxiliary storage
|
|
pool (ASP) device name field. This field is blank if the object has never been
|
|
journaled. The following special values may be returned:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*N</em></td>
|
|
<td align="left" valign="top">The name of the ASP group cannot be determined.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SYSBAS</em></td>
|
|
<td align="left" valign="top">System ASP (ASP 1) or defined basic
|
|
user ASPs (ASPs 2-32)<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><img src="delta.gif" alt="Start of change"><strong>Starting journal
|
|
receiver name for apply.</strong> The name of the oldest journal receiver
|
|
needed to successfully use the Apply Journaled Changes (APYJRNCHG) or Remove
|
|
Journaled Changes (RMVJRNCHG) command. This field is blank if the object has
|
|
never been journaled.</p>
|
|
|
|
<p>For a file object, the journal receiver will contain the entry representing
|
|
the start-of-the-save operation. However, if there are members within the
|
|
file that contain partial transactions, then those members may require an
|
|
earlier journal receiver. Use the Display File Description (DSPFD) command
|
|
to determine the partial transaction state of the members of the file.
|
|
<img src="deltaend.gif" alt="End of change"></p>
|
|
|
|
<p><strong>Statuses.</strong> The status of objects to select or omit from the
|
|
list of objects generated. Valid values are all of the possible values listed
|
|
under the information status field (format OBJL0200). The special value * can
|
|
be used to select all objects with any information status field. If optional
|
|
parameter group 2 is omitted, all objects with any information status are
|
|
selected.</p>
|
|
|
|
<p><strong>Storage.</strong> The storage status of the object data. *FREE
|
|
indicates the object data is freed and the object is suspended. *KEEP indicates
|
|
the object data is not freed and the object is not suspended.</p>
|
|
|
|
<p><strong>System level.</strong> The level of the operating system when the
|
|
object was created. The field has a VvvRrrMmm format where:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>Vvv</em></td>
|
|
<td align="left" valign="top">The character V is followed by a 2-character
|
|
version number.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Rrr</em></td>
|
|
<td align="left" valign="top">The character R is followed by a 2-character
|
|
release level.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Mmm</em></td>
|
|
<td align="left" valign="top">The character M is followed by a 2-character
|
|
modification level.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>System where object was created.</strong> The name of the system on
|
|
which the object was created.</p>
|
|
|
|
<p><strong>Text description.</strong> The text description of the object. The
|
|
field is blank if no text description is specified.</p>
|
|
|
|
<p><strong>Usage information updated.</strong> Whether the object usage
|
|
information is updated for this object type. The indicator is returned as Y
|
|
(Yes) or N (No).</p>
|
|
|
|
<p><strong>User changed.</strong> Whether the user program was changed. A
|
|
character 1 is returned if the user changed the object. If the object was not
|
|
changed by the user, the field is character 0.</p>
|
|
|
|
<p><strong>User-defined attribute.</strong> Further defines an object type.
|
|
This field is set by the user while using the QLICOBJD API.</p>
|
|
|
|
<p><strong>User space library name.</strong> The library that contains the user
|
|
space, as specified in the call to the API.</p>
|
|
|
|
<p><strong>User space name.</strong> The name of the user space.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Error Messages</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">CPFB8ED E</td>
|
|
<td align="left" valign="top">Device description &1 not correct for
|
|
operation.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF21AA E</td>
|
|
<td align="left" valign="top">Number of statuses must be between 1 and 5.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF21AB E</td>
|
|
<td align="left" valign="top">Status value &1 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF21AC E</td>
|
|
<td align="left" valign="top">Length or displacement value &1 not
|
|
valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF21A7 E</td>
|
|
<td align="left" valign="top">Authority value &1 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF21A8 E</td>
|
|
<td align="left" valign="top">Must specify *ANY as only authority value.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF21A9 E</td>
|
|
<td align="left" valign="top">Select or omit value &1 not valid.</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">&1 not a primary or secondary ASP.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF218D E</td>
|
|
<td align="left" valign="top">&1 not a primary ASP when *ASPGRP
|
|
specified.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF22F7 E</td>
|
|
<td align="left" valign="top">Number of authorities must be between 1 and
|
|
&1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF22F9 E</td>
|
|
<td align="left" valign="top">Call level &1 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF24B4 E</td>
|
|
<td align="left" valign="top">Severe error while addressing parameter
|
|
list.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3CAA E</td>
|
|
<td align="left" valign="top">List is too large for user space &1.</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 &1
|
|
API.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C20 E</td>
|
|
<td align="left" valign="top">Error found by program &1. </td>
|
|
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C21 E</td>
|
|
<td align="left" valign="top">Format name &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C3B E</td>
|
|
<td align="left" valign="top">Value for parameter &2 for API &1 not
|
|
valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C31 E</td>
|
|
<td align="left" valign="top">Object type &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C36 E</td>
|
|
<td align="left" valign="top">Number of parameters, &1, entered for this
|
|
API was not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C90 E</td>
|
|
<td align="left" valign="top">Literal value cannot be changed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF8100 E</td>
|
|
<td align="left" valign="top">All CPF81xx messages could be returned. xx is
|
|
from 01 to FF.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF980B E</td>
|
|
<td align="left" valign="top">Object &1 in library &2 not
|
|
available.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9801 E</td>
|
|
<td align="left" valign="top">Object &2 in library &3 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9802 E</td>
|
|
<td align="left" valign="top">Not authorized to object &2 in &3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9803 E</td>
|
|
<td align="left" valign="top">Cannot allocate object &2 in library
|
|
&3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9804 E</td>
|
|
<td align="left" valign="top">Object &2 in library &3 damaged.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9807 E</td>
|
|
<td align="left" valign="top">One or more libraries in library list
|
|
deleted.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9808 E</td>
|
|
<td align="left" valign="top">Cannot allocate one or more libraries on library
|
|
list.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9810 E</td>
|
|
<td align="left" valign="top">Library &1 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9814 E</td>
|
|
<td align="left" valign="top">Device &1 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9820 E</td>
|
|
<td align="left" valign="top">Not authorized to use library &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9825 E</td>
|
|
<td align="left" valign="top">Not authorized to device &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9830 E</td>
|
|
<td align="left" valign="top">Cannot assign library &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9833 E</td>
|
|
<td align="left" valign="top">*CURASPGRP or *ASPGRPPRI specified and thread has
|
|
no ASP group.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9838 E</td>
|
|
<td align="left" valign="top">User profile storage limit exceeded.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9872 E</td>
|
|
<td align="left" valign="top">Program or service program &1 in library
|
|
&2 ended. Reason code &3.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<hr>
|
|
API introduced: V1R3
|
|
|
|
<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=
|
|
"obj1.htm">Object APIs</a> | <a href="aplist.htm">APIs by category</a></td>
|
|
</tr>
|
|
</table>
|
|
</body>
|
|
</html>
|
|
|