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

827 lines
22 KiB
HTML
Raw Permalink Blame History

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>List Objects That Adopt Owner Authority (QSYLOBJP) 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. -->
<!-- Sec SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- Edited by Kersten Jan 02 -->
<!--End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!-- Java sync-link -->
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
</script>
<h2>List Objects That Adopt Owner Authority (QSYLOBJP) API</h2>
<div class="box" style="width: 70%;">
<br>
&nbsp;&nbsp;Required Parameter Group:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">1</td>
<td align="left" valign="top" width="50%">Qualified user space name</td>
<td align="left" valign="top" width="20%">Input</td>
<td align="left" valign="top" width="20%">Char(20)</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">Format name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">User profile name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(10)</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>
<tr>
<td align="center" valign="top">5</td>
<td align="left" valign="top">Continuation handle</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(20)</td>
</tr>
<tr>
<td align="center" valign="top">6</td>
<td align="left" valign="top">Error code</td>
<td align="left" valign="top">I/O</td>
<td align="left" valign="top">Char(*)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: Yes<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The List Objects That Adopt Owner Authority (QSYLOBJP) API puts a list of
objects that adopt an object owner's authority into a user space.</p>
<p>This API provides information similar to that provided by the Display
Program Adopt (DSPPGMADP) command.</p>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>User Space Authority</em></dt>
<dd>*CHANGE</dd>
<dt><em>Authority to Library Containing User Space</em></dt>
<dd>*EXECUTE</dd>
<dt><em>User Profile Authority</em></dt>
<dd>*OBJMGT</dd>
</dl>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Qualified user space name</strong></dt>
<dd>INPUT; CHAR(20)
<p>The name of the existing user space to which the list of objects that adopt
a user's authority is returned. The first 10 characters specify the user space
name, and the second 10 characters specify the library.</p>
<p>You can use these special values for the library name:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*CURLIB</em></td>
<td align="left" valign="top">The current library is used to locate the user
space. If there is no current library, QGPL (general purpose library) is
used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LIBL</em></td>
<td align="left" valign="top">The library list is used to locate the user
space.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Format name</strong></dt>
<dd>INPUT; CHAR(8)
<p>The name of the format that returns information on the objects that adopt a
user's authority.</p>
<p>You can specify these formats:</p>
<table cellpadding="5">
<!-- cols="30 70" -->
<tr>
<td align="left" valign="top"><em><a href="#HDRLOBJP2">OBJP0100</a></em></td>
<td align="left" valign="top">Each entry contains the object name, library, type, object in
use indicator, auxiliary storage pool (ASP) device name of library, and ASP
device name of object.</td>
</tr>
<tr>
<td align="left" valign="top"><a href="#HDRLOBJP10">OBJP0110</a></td>
<td align="left" valign="top">This format only returns path names for objects in
directories. Each entry contains the offset to the path name, the length of the
path name, ASP device name of object, and the path name value.</td>
</tr>
<tr>
<td align="left" valign="top"><a href="#HDRLOBJP9">OBJP0200</a></td>
<td align="left" valign="top">Each entry contains the same information as
format OBJP0100 plus the object attribute and descriptive text.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>User profile name</strong></dt>
<dd>INPUT; CHAR(10)
<p>The user name for which the list of objects that adopt the user's authority
is returned.</p>
<p>You can specify the following special value:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*CURRENT</em></td>
<td align="left" valign="top">The list of objects that adopt the authority of
the user currently running is returned. If *CURRENT is used, the name of the
current user is returned in the list header section of the user space.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Object type</strong></dt>
<dd>INPUT; CHAR(10)
<p>The type of object for which the list of objects that adopt the user's
authority is returned.</p>
<p>You can specify only the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*ALL</em></td>
<td align="left" valign="top">Return entries for all object types that adopt
authority that is supported by the requested format name.</td>
</tr>
<tr>
<td align="left" valign="top">*PGM</td>
<td align="left" valign="top">Return entries for programs that adopt
authority.</td>
</tr>
<tr>
<td align="left" valign="top">*SQLPKG</td>
<td align="left" valign="top">Return entries for SQL packages that adopt
authority.</td>
</tr>
<tr>
<td align="left" valign="top">*SRVPGM</td>
<td align="left" valign="top">Return entries for service programs that adopt
authority.</td>
</tr>
<tr>
<td align="left" valign="top">*JVAPGM</td>
<td align="left" valign="top">Return entries for stream files that have
attached JAVA programs that adopt authority.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Continuation handle</strong></dt>
<dd>INPUT; CHAR(20)
<p>The handle used to continue from a previous call to this API that resulted
in partially complete information. You can determine if a previous call
resulted in partially complete information by checking the Information Status
variable in the generic user space header following the API call.</p>
<p>If the API is not attempting to continue from a previous call, this
parameter must be set to blanks. Otherwise, a valid continuation value must be
supplied. The value may be obtained from the list header section of the user
space used in the previous call. When continuing, the first entry in the
returned list is the entry that immediately follows the last entry returned in
the previous call.</p>
</dd>
<dt><strong>Error code</strong></dt>
<dd>I/O; CHAR(*)
<p>The structure in which to return error information. For the format of the
structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p>
</dd>
</dl>
<br>
<h3><a name="HDRLOBJP1A">User Space Variables</a></h3>
<p>The following tables describe the order and format of the data returned in
the user space. For detailed descriptions of the fields in the tables, see <a
href="#HDRLOBJP5">Field Descriptions</a>.</p>
<br>
<h4><a name="HDRLOBJP1">Input Parameter Section</a></h4>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="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 specified</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">0A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User space library name specified</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">User 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 type</td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Continuation handle</td>
</tr>
</table>
<br>
<br>
<h4><a name="HDRLOBJP3">Header Section</a></h4>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="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 name</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">0A</td>
<td align="left" valign="top">CHAR(20)</td>
<td align="left" valign="top">Continuation handle</td>
</tr>
</table>
<br>
<br>
<h4><a name="HDRLOBJP2">OBJP0100 Format</a></h4>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="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</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">0A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">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(10)</td>
<td align="left" valign="top">Object type</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">Object in use</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">ASP device name of library</td>
</tr>
<tr>
<td align="center" valign="top">41</td>
<td align="center" valign="top">29</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">ASP device name of object</td>
</tr>
</table>
<br>
<br>
<h4><a name="HDRLOBJP10">OBJP0110 Format</a></h4>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="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%">Offset to path name</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">Length of path name</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">ASP device name of object</td>
</tr>
<tr>
<td align="center" valign="top">&nbsp;</td>
<td align="center" valign="top">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Path name</td>
</tr>
</table>
<br>
<br>
<h4><a name="HDRLOBJP9">OBJP0200 Format</a></h4>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="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</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">0A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">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(10)</td>
<td align="left" valign="top">Object type</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">Object in use</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">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">ASP device name of library</td>
</tr>
<tr>
<td align="center" valign="top">101</td>
<td align="center" valign="top">65</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">ASP device name of object</td>
</tr>
</table>
<br>
<br>
<h4><a name="HDRLOBJP5">Field Descriptions</a></h4>
<p><strong>ASP device name of
library.</strong> The auxiliary storage pool (ASP) device name where the
object's library is stored. If the object's library is in the system ASP or one
of the basic user ASPs, this field contains *SYSBAS.</p>
<p><strong>ASP device name of object.</strong> The auxiliary storage pool (ASP)
device name where the object is stored. If the object is in the system ASP or
one of the basic user ASPs, this field contains *SYSBAS.</p>
<p><strong>Attribute.</strong> The object attribute.</p>
<p><strong>Continuation handle (header section).</strong> A continuation point
for the API. This value is set based on the contents of the Information Status
variable in the generic header for the user space. The following situations can
occur:</p>
<ul>
<li>Information status-C. The information returned in the user space is valid
and complete. No continuation is necessary and the continuation handle is set
to blanks.</li>
<li>Information status-P. The information returned in the user space is valid
but incomplete. The user may call the API again, starting where the last call
left off. The continuation handle contains a value which may be supplied as an
input parameter in later calls.</li>
<li>Information status-I. The information returned in the user space is not
valid and incomplete. The content of the continuation handle is
unpredictable.</li>
</ul>
<p><strong>Continuation handle (input section).</strong> Used to continue from
a previous call to this API which resulted in partially complete
information.</p>
<p><strong>Format name.</strong> The name of the format used to return
information on the objects that adopt authority.</p>
<p><strong>Length of path name.</strong> The length, in bytes, of the path
name.</p>
<p><strong>Library name.</strong> The name of the library containing the user
space or object.</p>
<p><strong>Object name.</strong> The name of the object that adopts the user's
authority.</p>
<p><strong>Object in use.</strong> Whether the object is in use when the API
tries to access it. If the object is in use, the API is not able to determine
if the object adopts the user's authority. If the object is in use, this field
is Y. If not, this field is N.</p>
<p><strong>Object type.</strong></p>
<ul>
<li>Input Section: The type of object for which the list of objects adopting
the user's authority is returned.</li>
<li>List Section: The type of object which adopts the user's authority.</li>
</ul>
<p><strong>Offset to path name.</strong> The offset in the user space to the
start of the path name.</p>
<p><strong>Path name.</strong> The path name of the object that adopts the
user's authority.</p>
<p>The structure of the path name returned is:</p>
<table cellpadding="5">
<!-- cols="30 70" -->
<tr>
<th align="left" valign="top">Description</th>
<th align="left" valign="top">Type</th>
</tr>
<tr>
<td align="left" valign="top">CCSID of the returned path name</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="left" valign="top">Country or region ID</td>
<td align="left" valign="top">Char(2)</td>
</tr>
<tr>
<td align="left" valign="top">Language ID</td>
<td align="left" valign="top">Char(3)</td>
</tr>
<tr>
<td align="left" valign="top">Reserved field</td>
<td align="left" valign="top">Char(3)</td>
</tr>
<tr>
<td align="left" valign="top">Path type</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="left" valign="top">Number of bytes in the path name</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="left" valign="top">Path delimiter</td>
<td align="left" valign="top">Char(2)</td>
</tr>
<tr>
<td align="left" valign="top">Reserved field</td>
<td align="left" valign="top">Char(10)</td>
</tr>
<tr>
<td align="left" valign="top">Path name value</td>
<td align="left" valign="top">Char(*)</td>
</tr>
</table>
<br>
<p><strong>Text description.</strong> The text description of the object.</p>
<p><strong>User name.</strong> The name of the owner of the object.</p>
<p><strong>User name specified.</strong> The name of the user for which the
list of objects that adopt the user's authority is returned.</p>
<p><strong>User space library name specified.</strong> The name of the library
that contains the user space.</p>
<p><strong>User space name specified.</strong> The name of the user space to
which the list of objects that adopt the users authority is returned.</p>
<br>
<h3>Error Messages</h3>
<table width="100%" cellpadding="5">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="top">Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td width="15%" valign="top">CPF22FD E</td>
<td width="85%" valign="top">Continuation handle not valid for API &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF2204 E</td>
<td align="left" valign="top">User profile &amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF2213 E</td>
<td align="left" valign="top">Not able to allocate user profile &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF2217 E</td>
<td align="left" valign="top">Not authorized to user profile &amp;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">CPF3C21 E</td>
<td align="left" valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C31 E</td>
<td align="left" valign="top">Object type &amp;1 is 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">CPF811A E</td>
<td align="left" valign="top">User space &amp;4 in &amp;9 damaged.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9801 E</td>
<td align="left" valign="top">Object &amp;2 in library &amp;3 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9802 E</td>
<td align="left" valign="top">Not authorized to object &amp;2 in &amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9803 E</td>
<td align="left" valign="top">Cannot allocate object &amp;2 in library
&amp;3.</td>
</tr>
<tr>
<td align="left" valign="top">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 &amp;1 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9820 E</td>
<td align="left" valign="top">Not authorized to use library &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9830 E</td>
<td align="left" valign="top">Cannot assign library &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9872 E</td>
<td align="left" valign="top">Program or service program &amp;1 in library
&amp;2 ended. Reason code &amp;3.</td>
</tr>
</table>
<br>
<hr>
API introduced: V2R2
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"sec.htm">Security APIs</a> | <a href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</center>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink