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

2846 lines
79 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>List Spooled File AFPDS Resources (QGSLRSC) 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. -->
<!-- Print SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!--File Edited by Kersten Oct 2001 -->
<!-- RJOHNSON 2/28/03 Additional information regarding TT fonts -->
<!--End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!--Java sync-link-->
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<h2>List Spooled File AFPDS Resources (QGSLRSC) API</h2>
<div class="box" style="width: 85%;">
<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">Qualified job name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(26)</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">Internal job identifier</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(16)</td>
</tr>
<tr>
<td align="center" valign="top">5</td>
<td align="left" valign="top">Internal spooled file identifier</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(16)</td>
</tr>
<tr>
<td align="center" valign="top">6</td>
<td align="left" valign="top">Spooled file name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(10)</td>
</tr>
<tr>
<td align="center" valign="top">7</td>
<td align="left" valign="top">Spooled file number</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="left" valign="top">Resource name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">9</td>
<td align="left" valign="top">Resource 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">10</td>
<td align="left" valign="top">Pel density</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(1)</td>
</tr>
<tr>
<td align="center" valign="top">11</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;Optional Parameter Group 1:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">12</td>
<td align="left" valign="top" width="50%">Job system name</td>
<td align="left" valign="top" width="20%">Input</td>
<td align="left" valign="top" width="20%">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">13</td>
<td align="left" valign="top">Spooled file create date</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(7)</td>
</tr>
<tr>
<td align="center" valign="top">14</td>
<td align="left" valign="top">Spooled file create time</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(6)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Optional Parameter Group 2:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">15</td>
<td align="left" valign="top" width="50%">Length of resource name</td>
<td align="left" valign="top" width="20%">Input</td>
<td align="left" valign="top" width="20%">Binary(4)</td>
</tr>
<tr>
<td align="center" valign="top">16</td>
<td align="left" valign="top">CCSID of resource name</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Binary(4)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: No<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The List Spooled File AFPDS Resources (QGSLRSC) API generates a list of the
AFPDS resources found in the specified spooled file or returns the location of a specified AFPDS resource. Either option returns the information in a
user space.</p>
<br>
<h3>How QGSLRSC Resolves to the AFPDS Resource Libraries</h3>
<p>If a spooled file is specified, the spooled file attribute, user resource
library list, is used to resolve the location of the AFPDS resources. The
following is a list of supported values of the user resource library list and
how QGSLRSC uses them:</p>
<ul>
<li>*JOBLIBL. The library list of the job that created the spooled file is
searched.</li>
<li>*NONE. No libraries associated with the spooled file are searched.</li>
<li>*CURLIB. The current library of the job that created the spooled file is
searched.</li>
<li>*DEVD. Same as *JOBLIBL.</li>
<li>1-4 libraries. The specified libraries are searched.</li>
</ul>
<p>If the AFPDS resource is not found at this point, then the font libraries
QFNTCPL, QFNT01-QFNT19, and QFNT61-QFNT69 are searched.</p>
<p>If *NONE was specified for the spooled file, then only the font libraries
QFNTCPL, QFNT01-QFNT19, and QFNT61-QFNT69 are searched.</p>
<br>
<h3>How QGSLRSC resolves to integrated file system imbedded object resources</h3>
<p>When an imbedded object resource is specified or encountered within the data stream of the spooled file, the following method is used to resolve to the resource.
</p>
<ul>
<li>If the resource is qualified with a path name, that path is searched.
</li>
<li>If the resource was not found in a specified path, and the path was the current working directory or the resource was not path qualified, the paths specified in the system-level environment variable QIBM_AFP_RESOURCES_PATH is searched.
</li>
<li>If the resource is not found, and the spooled file resides on an independent disk pool, the /<em>independent-disk -pool-name</em>/QIBM/UserData/OS400/AFPresources directory on the independent disk pool is searched.
</li>
<li>If the resource is not found, or the spooled file resides on *SYSBAS, the /QIBM/UserData/OS400/AFPresources directory on the system ASP is searched.
</li>
</ul>
<br>
<h3>How QGSLRSC Resolves to integrated file system font resources</h3>
<p>When a font is specified or encountered within the data stream of the spooled file, the Resource Access Table in following directories are searched first. If the font is not found in one of the Resource Access Tables or if there are no Resource access Tables, then the files in the directories are searched.
</p>
<ul>
<li>/QIBM/UserData/OS400/Fonts/TTFonts
</li>
<li>/QIBM/ProdData/OS400/Fonts/TTFonts
</li>
</ul>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>User Space Authority</em></dt>
<dd>*CHANGE</dd>
<dt><em>Library Authority</em></dt>
<dd>*EXECUTE</dd>
<dt><em>Output Queue Authority</em></dt>
<dd>*USE</dd>
<dt><em>Resource Authority</em></dt>
<dd>*READ/*R</dd>
<dt><em>Directory Authority</em></dt>
<dd>*X</dd>
</dl>
<p><strong>Spooled File Authority</strong></p>
<p>The requester is authorized to the spooled file if one or more of the
following conditions are met:</p>
<ul>
<li>The requester is the owner of the spooled file.</li>
<li>The requester has *READ authority to the queue on which the spooled file
resides, and the queue is specified as DSPDTA(*YES).</li>
<li>The requester has *SPLCTL authority.</li>
<li>The requester has *JOBCTL authority, and the output queue on which the
spooled file resides is specified as OPRCTL(*YES).</li>
<li>The requester has ownership of the queue on which the spooled file resides,
and the queue is specified as AUTCHK(*OWNER).</li>
<li>The requester has read, add, and delete authorities to the output queue on
which the spooled files resides, and the output queue is specified as
AUTCHK(*DTAAUT).</li>
</ul>
<dl>
<dt><em>Spooled File Lock</em></dt>
<dd>*LSRD</dd>
<dt><em>User Space Lock</em></dt>
<dd>*EXCLRD</dd>
</dl>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Qualified user space name</strong></dt>
<dd>INPUT; CHAR(20)
<p>The user space that receives the generated list and the library in which it
is located. The first 10 characters contain the user space name and the second
10 characters contain the library name.</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 job's current library</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LIBL</em></td>
<td align="left" valign="top">The library list</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Format name</strong></dt>
<dd>INPUT; CHAR(8)
<p>The format of the AFPDS resource list being returned. You must specify one
of the following:</p>
<table cellpadding="5">
<!-- cols="25 75" -->
<tr>
<td align="left" valign="top"><em><a href="#HDRLRSC1A">LRSC0100</a></em></td>
<td align="left" valign="top">Contains the name, object type, and location of
the AFPDS resource.</td>
</tr>
<tr>
<td align="left" valign="top"><em><a href="#HDRLRSC2A">LRSC0200</a></em></td>
<td align="left" valign="top">Contains the library list of the specified
spooled file where the AFPDS resources can be found.</td>
</tr>
<tr>
<td align="left" valign="top"><em><a href="#HDRLRSC3A">LRSC0300</a></em></td>
<td align="left" valign="top">Searches the library list for the specified
resource using the spooled file library list and the font libraries.</td>
</tr>
<tr>
<td align="left" valign="top"><em><a href="#HDRLRSC4A">LRSC0400</a></em></td>
<td align="left" valign="top">Contains the name, object type, and location of
the AFPDS resource if the resource is a library based object. Contains the file name and path if the resource is not a library based object and is in the integrated file system.</td>
</tr>
<tr>
<td align="left" valign="top"><em><a href="#HDRLRSC5A">LRSC0500</a></em></td>
<td align="left" valign="top">Searches the integrated file system directories for the specified resource.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Qualified job name</strong></dt>
<dd>INPUT; CHAR(26)
<p>The qualified job name of the job that owns the spooled file.</p>
<p>The qualified job name has three parts:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>job name</em></td>
<td align="left" valign="top">CHAR(10)</td>
</tr>
<tr>
<td align="left" valign="top"></td>
<td align="left" valign="top">A specific job name, or one of the following
special values:<br>
<br>
<table cellpadding="5">
<tr>
<td align="left" valign="top"><em><strong>*</strong></em></td>
<td align="left" valign="top">Only the job in which this program is running.
The rest of the job name parameter must be blank.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*INT</em></td>
<td align="left" valign="top">The internal job identifier used to locate the
job. The user name and job number must be set to blank.</td>
</tr>
</table>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>user name</em></td>
<td align="left" valign="top">CHAR(10)</td>
</tr>
<tr>
<td align="left" valign="top"></td>
<td align="left" valign="top">A specific user profile name, or blank when the
job name is asterisk (*) or *INT.</td>
</tr>
<tr>
<td align="left" valign="top"><em>job number</em></td>
<td align="left" valign="top">CHAR(6)</td>
</tr>
<tr>
<td align="left" valign="top"></td>
<td align="left" valign="top">A specific job number, or blank when the job name
is asterisk (*) or *INT.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Internal job identifier</strong></dt>
<dd>INPUT; CHAR(16)
<p>The internal job identifier for the job that owns the spooled file whose
AFPDS resources are to be listed, or blank when job name is not *INT. See the <a href="QUSRSPLA.htm">Retrieve Spooled File Attributes</a> (QUSRSPLA) API for valid combinations of parameters for selecting the spooled file. </p>
</dd>
<dt><strong>Internal spooled file identifier</strong></dt>
<dd>INPUT; CHAR(16)
<p>The internal spooled file identifier for the spooled file whose AFPDS
resources are to be listed, or blank when the spooled file name is not
*INT. See the <a href="QUSRSPLA.htm">Retrieve Spooled File Attributes</a> (QUSRSPLA) API for valid combinations of parameters for selecting the spooled file.</p>
</dd>
<dt><strong>Spooled file name</strong></dt>
<dd>INPUT; CHAR(10)
<p>The name of the spooled file for which the list of AFPDS resources is
returned. You can use these special values for the name:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*INT</em></td>
<td align="left" valign="top">The internal spooled file identifier is used to
locate the spooled file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">Search the font libraries for the specified
resource. When this is specified, the input parameters qualified job name,
internal job identifier, internal spooled file identifier, spooled file number, job system name,
spooled file create date, and spooled file create time are ignored. This value is only valid
with format LRSC0300 or LRSC0500.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Spooled file number</strong></dt>
<dd>INPUT; BINARY(4)
<p>The unique number of the spooled file. The valid range is 1 through
999999.</p>
<p>The following special values are supported for this parameter:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Only one spooled file from the job has the
specified file name, so the number of the spooled file is not necessary.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-1</em></td>
<td align="left" valign="top">This uses the highest-numbered spooled file with
the specified file name.</td>
</tr>
<tr>
<td align="left" valign="top"><em>-2</em></td>
<td align="left" valign="top">The spooled file number is not used to determine
which spooled file to process. Use this value when you want the Job system name
parameter or the Spooled file create date and Spooled file create time
parameters to take precedence over the spooled file number when selecting a
spooled file. </td>
</tr>
<tr>
<td align="left" valign="top"></td>
<td align="left" valign="top">This parameter must contain a valid value even if
the value for the spooled file name parameter is *INT.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Resource name</strong></dt>
<dd>INPUT; CHAR(*)
<p>The name of the AFPDS resource to be returned in the list of AFPDS
resources.</p>
<p>You must specify one of the following:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*ALL</em></td>
<td align="left" valign="top">Returns a list of all AFPDS resources found in
the specified spooled file. This is valid only for format LRSC0100 or LRSC0400.</td>
</tr>
<tr>
<td align="left" valign="top"><em>resource name</em></td>
<td align="left" valign="top">Returns information for the specified AFPDS
resource if it is found in the specified spooled file.
The resource name must be one of the following:</td>
</tr>
</table>
<ul>
<li>An i5/OS object name.</li>
<li>An integrated file system file name. The file name must include the proper extension. The file name must not include a path name.</li>
<li>An external descriptive font name. An example of an external descriptive font name would be <em>Times New Roman</em>. An external descriptive font name can only be specified for format LRSC0500.</li>
</ul>
<p>For format LRSC0300, the library information is returned for the specified
resource.</p>
<p>For format LRSC0500, the path information is returned for the specified resource.</p>
<p>This parameter is ignored when using format
LRSC0200.</p>
<br>
</dd>
<dt><strong>Resource object type</strong></dt>
<dd>INPUT; CHAR(10)
<p>The type of resource object. When the resource object type is *PATH, optional parameters Length of resource name and CCSID of resource name must be specified.</p>
<p>The valid values for this parameter are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*ALL</em></td>
<td align="left" valign="top">Search for all AFPDS resources in the spooled
file. This value is valid for format LRSC0100 and LRSC0400 only.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FNTRSC</em></td>
<td align="left" valign="top">Font resource</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FORMDF</em></td>
<td align="left" valign="top">Form definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OVL</em></td>
<td align="left" valign="top">Overlay</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PAGSEG</em></td>
<td align="left" valign="top">Page segment</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PAGDFN</em></td>
<td align="left" valign="top">Page definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PATH</em></td>
<td align="left" valign="top">The resource resides in the integrated file system. This value is valid for formats LRSC0400 and LRSC0500 only.</td>
</tr>
<tr>
<td align="left" valign="top"></td>
<td align="left" valign="top">This parameter is ignored when using format
LRSC0200.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Pel density</strong></dt>
<dd>INPUT; CHAR(1)
<p>The pel density of the font resources that are to be returned in the list of
AFPDS resources. This parameter is only used for AFPDS resources of type *FNTRSC with the attribute FNTCHRSET.</p>
<p>The valid values for this parameter:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">240 pel density.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">300 pel density.</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Adobe Type 1 outline font.</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Adobe Type 0 composite outline font.</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">600 pel density.</td>
</tr>
</table>
<br>
</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>Optional Parameter
Group 1</h3>
<dl>
<dt><strong>Job system name</strong></dt>
<dd>INPUT; CHAR(8)
<p>The name of the system where the job that created the spooled file ran or
blank when the spooled file name is *INT. This parameter is considered after
the job name, user name, job number, spooled file name, and spooled file number
parameter requirements have been met.</p>
<p>The following special values are supported for this parameter:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*ONLY</em></td>
<td align="left" valign="top">There is one job with the specified job name,
user name, job number, spooled file name, spooled file number, spooled file
create date, and spooled file create time.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*CURRENT</em></td>
<td align="left" valign="top">The job on the current system with the specified
job name, user name, job number, spooled file name, spooled file number,
spooled file create date, and spooled file create time is used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*ANY</em></td>
<td align="left" valign="top">The job system name is not considered when
selecting a spooled file. Use this value when you want the Spooled file create
date and Spooled file create time parameters to take precedence over the job
system name when selecting a spooled file.</td>
</tr>
<tr>
<td align="left" valign="top"></td>
<td align="left" valign="top">If this parameter is omitted, the API assumes
blanks when the spooled file name is *INT. When spooled file name is not *INT,
the API assumes *ONLY.</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Spooled file create date</strong></dt>
<dd>INPUT; CHAR(7)
<p>The date the spooled file was created on the system or blank when the
spooled file name is *INT. This parameter is considered after the job name,
user name, job number, spooled file name, spooled file number, and job system
name parameter requirements have been met. The date must be in the CYYMMDD
format or one of the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td width="15%" valign="top"><em>*ONLY</em></td>
<td width="85%" valign="top">There is only one spooled file with the specified
job name, user name, job number, spooled file name, spooled file number, and
job system name.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LAST</em></td>
<td align="left" valign="top">The spooled file with the latest date and time
which also has the specified job name, user name, job number, spooled file
name, spooled file number, and job system name is used.</td>
</tr>
</table>
<br>
<p>The date format CYYMMDD is defined as follows:</p>
<table width="100%">
<tr>
<td width="10%"><em>C</em></td>
<td width="90%">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>
</table>
<br>
<p>If this parameter is omitted, the API assumes blanks when the spooled file
name is *INT. When spooled file name is not *INT, the API assumes *ONLY.</p>
</dd>
<dt><strong>Spooled file create time</strong></dt>
<dd>INPUT; CHAR(6)
<p>The time the spooled file was created on the system or blank when the
spooled file name is *INT. This parameter must be set to blanks when special
values *LAST or *ONLY are used for parameter Spooled file create date. This
parameter must have a value set if a date is specified for parameter Spooled
file create date. This parameter is considered after the job name, user name,
job number, spooled file name, spooled file number, job system name, and
spooled file create date parameter requirements have been met. The time must be
in the HHMMSS format or one of the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td width="15%" valign="top"><em>*ONLY</em></td>
<td width="85%" valign="top">There is only one spooled file with the specified
job name, user name, job number, spooled file name, spooled file number, job
system name, and create date.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*LAST</em></td>
<td align="left" valign="top">The spooled file with the latest time which also
has the specified job name, user name, job number, spooled file name, spooled
file number, job system name, and create date is used.</td>
</tr>
</table>
<br>
<p>The time format HHMMSS is defined as follows:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<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">Minutes</td>
</tr>
<tr>
<td align="left" valign="top"><em>SS</em></td>
<td align="left" valign="top">Seconds</td>
</tr>
</table>
<br>
<p>If this parameter is omitted, the API assumes blanks.</p>
</dd>
</dl>
<br>
<h3>Optional Parameter Group 2</h3>
<dl>
<dt><strong>Length of resource name</strong></dt>
<dd>INPUT; Binary(4)</dd>
<dd>The length of the resource name in number of bytes. Valid values range from 1 to 250.
A value larger than 250 will result in an error.</dd>
<dd>If this parameter is omitted, the API assumes a fixed length
of 10 and that the resource name is left justified and blank padded.</dd>
<dt><strong>CCSID of resource name</strong></dt>
<dd>INPUT; Binary(4)</dd>
</dl>
<p>The CCSID that the resource name specified in the resource name
parameter is encoded in. The CCSID or the following special value:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td valign="top"><em>0</em></td>
<td valign="top">The current job's default CCSID is used.</td>
</tr>
</table>
<br>
<p>If this parameter is omitted, the API assumes CCSID 65535.</p>
<br>
<h3><a name="HDRLRSCLIS">Format of the Generated List</a></h3>
<p>The spooled file AFPDS resource list consists of:</p>
<ul>
<li>A user area</li>
<li>A generic header</li>
<li>An input parameter section</li>
<li>A header section</li>
<li>A list data section</li>
</ul>
<p>When you retrieve list entry information from a user space, you must use the
entry size returned in the generic header as a displacement to the next list
entry. The size of each entry may be padded at the end. If you do not use the
entry size, the result may not be valid. For examples of how to process lists,
see <a href="../apiref/apiexmp.htm">Examples</a>.</p>
<p><strong>Note:</strong> When the entry size returned in the generic header is set to -1, the entries vary in length. To get to the next entry, the entry length field of the LRSC0400 or LRSC0500 formats must be used to determine the displacement to the next list entry.</p>
<br>
<h3><a name="HDRLRSCIP1">Input Parameter Section</a></h3>
<p>For more information about the fields in the following table, see <a href=
"#HDRFD1X">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="top">Dec</th>
<th align="center" valign="top">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">A</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(26)</td>
<td align="left" valign="top">Qualified job name specified</td>
</tr>
<tr>
<td align="center" valign="top">54</td>
<td align="center" valign="top">36</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Internal job identifier</td>
</tr>
<tr>
<td align="center" valign="top">70</td>
<td align="center" valign="top">46</td>
<td align="left" valign="top">CHAR(16)</td>
<td align="left" valign="top">Internal spooled file identifier</td>
</tr>
<tr>
<td align="center" valign="top">86</td>
<td align="center" valign="top">56</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Spooled file name specified</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">Spooled file number specified</td>
</tr>
<tr>
<td align="center" valign="top">100</td>
<td align="center" valign="top">64</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Resource name specified</td>
</tr>
<tr>
<td align="center" valign="top">110</td>
<td align="center" valign="top">6E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Resource object type specified</td>
</tr>
<tr>
<td align="center" valign="top">120</td>
<td align="center" valign="top">78</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Pel density specified</td>
</tr>
<tr>
<td align="center" valign="top">121</td>
<td align="center" valign="top">79</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Job system name specified</td>
</tr>
<tr>
<td align="center" valign="top">129</td>
<td align="center" valign="top">81</td>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Spooled file create date specified</td>
</tr>
<tr>
<td align="center" valign="top">136</td>
<td align="center" valign="top">88</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Spooled file create time specified</td>
</tr>
<tr>
<td align="center" valign="top">142</td>
<td align="center" valign="top">8E</td>
<td align="left" valign="top">Char(2)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">144</td>
<td align="center" valign="top">90</td>
<td align="left" valign="top">Binary(4)</td>
<td align="left" valign="top">Displacement to resource name specified</td>
</tr>
<tr>
<td align="center" valign="top">148</td>
<td align="center" valign="top">94</td>
<td align="left" valign="top">Binary(4)</td>
<td align="left" valign="top">Length of resource name specified</td>
</tr>
<tr>
<td align="center" valign="top">152</td>
<td align="center" valign="top">98</td>
<td align="left" valign="top">Binary(4)</td>
<td align="left" valign="top">CCSID of resource name specified</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">Long resource name specified</td>
</tr>
</table>
<br>
<h3><a name="HDRFD1X">Field Descriptions</a></h3>
<p><strong>CCSID of resource name specified.</strong> The CCSID of the resource name parameter value specified on the
call to the API. This field is set to 65535 when the CCSID of the resource name parameter is not specified.</p>
<p><strong>Displacement to resource name specified.</strong> The displacement, in number of bytes, from the beginning of the Input parameter section to the long resource name specified. This resource name is the one that was specified in the call to the API. This field is set to 0 if the resource object type specified is not *PATH.</p>
<p><strong>Format name.</strong> The name of the format used to list the AFPDS
resources in the user space.</p>
<p><strong>Internal job identifier.</strong> The internal identifier for the
job. Only the i5/OS APIs use this identifier, not any other interface on the
system. The identifier is not valid following an initial program load (IPL). If
you attempt to use it after an IPL, an exception occurs.</p>
<p><strong>Internal spooled file identifier.</strong> The input value that
other programs use to improve the performance of locating the spooled file on
the system. Only the spooled file APIs use this identifier, not any other
interface on the system. The identifier is not valid following an initial
program load (IPL). If you attempt to use it after an IPL, an exception
occurs.</p>
<p><strong>Job system name
specified.</strong> The name of the system, specified on the call to the API,
where the job specified by the qualified job name ran. </p>
<p><strong>Length of resource name specified.</strong> The length of the resource name parameter value specified on the
call to the API. This field is set to 10 when the length of resource name parameter is not specified.</p>
<p><strong>Long resource name specified.</strong> The name of the AFPDS resource
specified in the call to the API.</p>
<p><strong>Pel density specified.</strong> The pel density specified on the
call to the API.</p>
<p>The valid values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">240 pel density</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">300 pel density</td>
</tr>
<tr>
<td align="left" valign="top"><em>3</em></td>
<td align="left" valign="top">Adobe Type 1 outline font.</td>
</tr>
<tr>
<td align="left" valign="top"><em>4</em></td>
<td align="left" valign="top">Adobe Type 0 composite outline font.</td>
</tr>
<tr>
<td align="left" valign="top"><em>5</em></td>
<td align="left" valign="top">600 pel density.</td>
</tr>
</table>
<br>
<p><strong>Qualified job name specified.</strong> The qualified name of the job
specified in the call to the API.</p>
<p><strong>Resource name specified.</strong> The name of the AFPDS resource
specified in the call to the API. This field is blank when the resource object type specified is *PATH.</p>
<p><strong>Resource object type specified.</strong> The type of the AFPDS
resource specified in the call to the API.</p>
<p><strong>Spooled file create
date specified.</strong> The creation date of the spooled file specified on the
call to the API.</p>
<p><strong>Spooled file create time specified.</strong> The creation time of
the spooled file specified on the call to the API. </p>
<p><strong>Spooled file name specified.</strong> The name of the spooled file
specified in the call to the API.</p>
<p><strong>Spooled file number specified.</strong> The number of the spooled
file specified in the call to the API.</p>
<p><strong>User space library name specified.</strong> The library name of the
user space specified in the call to the API.</p>
<p><strong>User space name specified.</strong> The name of the user space
specified in the call to the API.</p>
<br>
<h3><a name="HDRLRSCHD1">Header Section</a></h3>
<p>For more information about the fields in the following table, see <a href=
"#HDRFD2">Field Descriptions</a>.</p>
<br>
<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(26)</td>
<td align="left" valign="top">Qualified job name</td>
</tr>
<tr>
<td align="center" valign="top">46</td>
<td align="center" valign="top">2E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Spooled file name</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Spooled file number</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Job system name</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Spooled file create date</td>
</tr>
<tr>
<td align="center" valign="top">75</td>
<td align="center" valign="top">4B</td>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Spooled file create time</td>
</tr>
<tr>
<td align="center" valign="top">81</td>
<td align="center" valign="top">51</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</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">CCSID of resource names returned</td>
</tr>
</table>
<br>
<h3><a name="HDRFD2">Field Descriptions</a></h3>
<p><strong>CCSID of resource names returned.</strong> The CCSID of the resource names and path names returned for resources located in the integrated file system. </p>
<p><strong>Job system
name.</strong> The name of the system where the job that created the spooled
file ran. </p>
<p><strong>Qualified job name.</strong> The qualified name of the job that
owns the spooled files.</p>
<p>The qualified job name has three parts:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>job name</em></td>
<td align="left" valign="top">CHAR(10)</td>
</tr>
<tr>
<td align="left" valign="top">&nbsp;</td>
<td align="left" valign="top">The name of the job that owns the spooled
file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>user name</em></td>
<td align="left" valign="top">CHAR(10)</td>
</tr>
<tr>
<td align="left" valign="top"></td>
<td align="left" valign="top">The name of the user of the job.</td>
</tr>
<tr>
<td align="left" valign="top"><em>job number</em></td>
<td align="left" valign="top">CHAR(6)</td>
</tr>
<tr>
<td align="left" valign="top">&nbsp;</td>
<td align="left" valign="top">The number of the job that owns the spooled
file.</td>
</tr>
</table>
<br>
<p><strong>Spooled file create
date.</strong> The date the spooled file was created on the system.</p>
<p><strong>Spooled file create time.</strong> The time the spooled file was
created on the system. </p>
<p><strong>Spooled file name.</strong> The name of the spooled file that the
AFPDS resources are to be listed for.</p>
<p><strong>Spooled file number.</strong> The number of the spooled file that
the AFPDS resources are to be listed for.</p>
<p><strong>User space library name.</strong> The library containing the user
space.</p>
<p><strong>User space name.</strong> The name of the user space that contains
the format returned.</p>
<br>
<h3><a name="HDRLRSC1A">Format LRSC0100</a></h3>
<p>For more information about the fields in the following table, see <a href=
"#HDRFD3X">Field Descriptions</a>.</p>
<br>
<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%">Resource 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">Resource 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">Resource 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">Where resource was referenced</td>
</tr>
<tr>
<td align="center" valign="top">31</td>
<td align="center" valign="top">1F</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Resource availability</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Source object</td>
</tr>
<tr>
<td align="center" valign="top">42</td>
<td align="center" valign="top">2A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Source object library</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Source object type</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRFD3X">Field Descriptions</a></h3>
<p><strong>Resource availability.</strong> Whether the resource was found, not
found, or the owner of the spooled file was not authorized to the
resource or to the resource library.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The resource was not available for one of the
following reasons:<br>
<ul>
<li>The resource could not be found on the system.</li>
<li>The user who created the spooled file was not authorized to the resource or
to the resource library.</li>
</ul>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The resource was found on the system.</td>
</tr>
</table>
<br>
<p><strong>Resource library name.</strong> The name of the library that
contains the AFPDS resource. The</p>
<p>possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*INLINE</em></td>
<td align="left" valign="top">The resource is defined within the data stream of
the spooled file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>library_name</em></td>
<td align="left" valign="top">The name of the library that the AFPDS resource
was found in.</td>
</tr>
</table>
<br>
<p><strong>Resource name.</strong> The name of the AFPDS resource used in the
spooled file.</p>
<p><strong>Resource object type.</strong> The type of AFPDS resource.</p>
<p>The valid values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*PAGSEG</em></td>
<td align="left" valign="top">Page segment</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PAGDFN</em></td>
<td align="left" valign="top">Page definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OVL</em></td>
<td align="left" valign="top">Overlay</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FORMDF</em></td>
<td align="left" valign="top">Form definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FNTRSC</em></td>
<td align="left" valign="top">Font resource</td>
</tr>
</table>
<br>
<p><strong>Source object.</strong> The name of the object that the resource was
found in.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SPLF</em></td>
<td align="left" valign="top">The resource is found within the data stream of
the spooled file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>object_name</em></td>
<td align="left" valign="top">The name of the AFPDS resource that the resource
object is found in.</td>
</tr>
</table>
<br>
<p><strong>Source object library.</strong> The library that contains the source
AFPDS resource object. This field is blank when the source object is *SPLF.</p>
<p><strong>Source object type.</strong> The object type of the source AFPDS
resource object. This field is blank when the source object is *SPLF or is one of
the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*PAGSEG</em></td>
<td align="left" valign="top">Page segment</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PAGDFN</em></td>
<td align="left" valign="top">Page definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OVL</em></td>
<td align="left" valign="top">Overlay</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FORMDF</em></td>
<td align="left" valign="top">Form definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FNTRSC</em></td>
<td align="left" valign="top">Font resource</td>
</tr>
</table>
<br>
<p><strong>Where resource was referenced.</strong> Where the resource was
located.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The resource was found within the spooled file or
another AFPDS resource.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The resource was found within the spooled file
attributes.</td>
</tr>
</table>
<br>
<h3><a name="HDRLRSC2A">Format LRSC0200</a></h3>
<p>For more information about the fields in the following table, see <a href=
"#HDRFD4X">Field Descriptions</a>.</p>
<br>
<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%">Resource library</td>
</tr>
</table>
<br>
<h3><a name="HDRFD4X">Field Descriptions</a></h3>
<p><strong>Resource library.</strong> A library, from the library list of the
specified spooled file, where AFPDS resources can be found.</p>
<br>
<h3><a name="HDRLRSC3A">Format LRSC0300</a></h3>
<p>For more information about the fields in the following table, see <a href=
"#HDRFD3X2">Field Descriptions</a>.</p>
<br>
<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%">Resource 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">Resource 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">Resource 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">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">31</td>
<td align="center" valign="top">1F</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Resource availability</td>
</tr>
</table>
<h3><a name="HDRFD3X2">Field Descriptions</a></h3>
<p><strong>Resource availability.</strong> Whether the resource was found, not
found, or the caller or the owner of the spooled file was not authorized to the
resource or to the resource library.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The resource was not available for one of the
following reasons:<br>
<ul>
<li>The resource could not be found on the system.</li>
<li>The user who created the spooled file was not authorized to the resource or
to the resource library.</li>
<li>If *NONE was specified for the spooled file name, the caller of the API was
not authorized to the resource or to the resource library.</li>
</ul>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The resource was found on the system.</td>
</tr>
</table>
<br>
<p><strong>Resource library name.</strong> The name of the library that
contains the AFPDS resource. The</p>
<p>possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>library_name</em></td>
<td align="left" valign="top">The name of the library that the AFPDS resource
was found in.</td>
</tr>
</table>
<br>
<p><strong>Resource name.</strong> The name of the AFPDS resource used in the
spooled file.</p>
<p><strong>Resource object type.</strong> The type of AFPDS resource.</p>
<p>The valid values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*PAGSEG</em></td>
<td align="left" valign="top">Page segment</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PAGDFN</em></td>
<td align="left" valign="top">Page definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OVL</em></td>
<td align="left" valign="top">Overlay</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FORMDF</em></td>
<td align="left" valign="top">Form definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FNTRSC</em></td>
<td align="left" valign="top">Font resource</td>
</tr>
</table>
<br>
<h3><a name="HDRLRSC4A">Format LRSC0400</a></h3>
<p>For more information about the fields in the following table, see <a href=
"#HDRFD4X2">Field Descriptions</a>.</p>
<br>
<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 entry</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">Displacement to name</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">Length of name</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">0C</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Format of name</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">Name entry</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRFD4X2">Field Descriptions</a></h3>
<p><strong>Displacement to name.</strong>The displacement, in number of bytes, from the beginning of the entry to the name. </p>
<p><strong>Format of name.</strong> The format of the name. The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>LRSE0100</em></td>
<td align="left" valign="top">Name entry is returned in the entry format LRSE0100.</td>
</tr>
<tr>
<td align="left" valign="top"><em>LRSE0200</em></td>
<td align="left" valign="top">Name entry is returned in the entry format LRSE0200</td>
</tr>
</table>
<br>
<p><strong>Length of name.</strong>The length of the name in number of bytes. </p>
<p><strong>Length of entry.</strong> Length of the entry in number of bytes.</p>
<p><strong>Name entry.</strong> The resource returned in the format specified in the field Format of name.</p>
<h3><a name="HDRLRSE1A">Format LRSE0100</a></h3>
<p>For more information about the fields in the following table, see <a href=
"#HDRFD5X">Field Descriptions</a>.</p>
<br>
<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%">Resource 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">Resource 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">Resource 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">Where resource was referenced</td>
</tr>
<tr>
<td align="center" valign="top">31</td>
<td align="center" valign="top">1F</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Resource availability</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Source object</td>
</tr>
<tr>
<td align="center" valign="top">42</td>
<td align="center" valign="top">2A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Source object library</td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Source object type</td>
</tr>
</table>
<br>
<h3><a name="HDRFD5X">Field Descriptions</a></h3>
<p><strong>Resource availability.</strong> Whether the resource was found, not
found, or the owner of the spooled file was not authorized to the
resource or to the resource library.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The resource was not available for one of the
following reasons:<br>
<ul>
<li>The resource could not be found on the system.</li>
<li>The user who created the spooled file was not authorized to the resource or
to the resource library.</li>
</ul>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The resource was found on the system.</td>
</tr>
</table>
<br>
<p><strong>Resource library name.</strong> The name of the library that
contains the AFPDS resource. The</p>
<p>possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*INLINE</em></td>
<td align="left" valign="top">The resource is defined within the data stream of
the spooled file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>library_name</em></td>
<td align="left" valign="top">The name of the library that the AFPDS resource
was found in.</td>
</tr>
</table>
<br>
<p><strong>Resource name.</strong> The name of the AFPDS resource used in the
spooled file.</p>
<p><strong>Resource object type.</strong> The type of AFPDS resource.</p>
<p>The valid values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*PAGSEG</em></td>
<td align="left" valign="top">Page segment</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PAGDFN</em></td>
<td align="left" valign="top">Page definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OVL</em></td>
<td align="left" valign="top">Overlay</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FORMDF</em></td>
<td align="left" valign="top">Form definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FNTRSC</em></td>
<td align="left" valign="top">Font resource</td>
</tr>
</table>
<br>
<p><strong>Source object.</strong> The name of the object that the resource was
found in.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SPLF</em></td>
<td align="left" valign="top">The resource is found within the data stream of
the spooled file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>object_name</em></td>
<td align="left" valign="top">The name of the AFPDS resource that the resource
object is found in.</td>
</tr>
</table>
<br>
<p><strong>Source object library.</strong> The library that contains the source
AFPDS resource object. This field is blank when the source object is *SPLF.</p>
<p><strong>Source object type.</strong> The object type of the source AFPDS
resource object. This field is blank when the source object is *SPLF or is one of
the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*PAGSEG</em></td>
<td align="left" valign="top">Page segment</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PAGDFN</em></td>
<td align="left" valign="top">Page definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OVL</em></td>
<td align="left" valign="top">Overlay</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FORMDF</em></td>
<td align="left" valign="top">Form definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FNTRSC</em></td>
<td align="left" valign="top">Font resource</td>
</tr>
</table>
<br>
<p><strong>Where resource was referenced.</strong> Where the resource was
located.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The resource was found within the spooled file or
another AFPDS resource.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The resource was found within the spooled file
attributes.</td>
</tr>
</table>
<br>
<h3><a name="HDRLRSE2A">Format LRSE0200</a></h3>
<p>For more information about the fields in the following table, see <a href=
"#HDRFD6X">Field Descriptions</a>.</p>
<br>
<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(1)</td>
<td align="left" valign="top" width="60%">Resource availability</td>
</tr>
<tr>
<td align="center" valign="top">1</td>
<td align="center" valign="top">1</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">4</td>
<td align="center" valign="top" width="10%">4</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Displacement to resource name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">8</td>
<td align="center" valign="top" width="10%">8</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length of resource name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">12</td>
<td align="center" valign="top" width="10%">0C</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Displacement to path name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">16</td>
<td align="center" valign="top" width="10%">10</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length of path name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">20</td>
<td align="center" valign="top" width="10%">14</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Displacement to source object data</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">24</td>
<td align="center" valign="top" width="10%">18</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length of source object data</td>
</tr>
<tr>
<td align="center" valign="top">28</td>
<td align="center" valign="top">1C</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Format of source object data</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">Resource name</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>
<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">Source object data</td>
</tr>
</table>
<br>
<h3><a name="HDRFD6X">Field Descriptions</a></h3>
<p><strong>Displacement to path name</strong> The displacement, in number of bytes, from the beginning of the structure to the path name. This field will be set to zero if the resource name contains the descriptive name of a True Type font.</p>
<p><strong>Displacement to resource name</strong> The displacement, in number of bytes, from the beginning of the structure to the resource name.</p>
<p><strong>Displacement to source object data</strong> The displacement, in number of bytes, from the beginning of the structure to the source object data.</p>
<p><strong>Length of path name.</strong> The length of the path name in number of bytes.</p>
<p><strong>Length of resource name.</strong> The length of the resource name in number of bytes.</p>
<p><strong>Length of source object data.</strong> The length of the source object data in number of bytes.</p>
<p><strong>Path name.</strong> The name of the integrated file system path where the resource resided.</p>
<p><strong>Resource availability.</strong> Whether the resource was found, not
found, or the owner of the spooled file was not authorized to the
resource, the resource library, or the resource directory.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The resource was not available for one of the
following reasons:<br>
<ul>
<li>The resource could not be found on the system.</li>
<li>The user who created the spooled file was not authorized to the resource, the resource library, or the resource directory.</li>
</ul>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The resource was found on the system.</td>
</tr>
</table>
<br>
<p><strong>Resource name.</strong> The name of the AFPDS resource used in the
spooled file. For a True Type font, the resource name can be the font's descriptive name.</p>
<p><strong>Source object data.</strong> The identity of the source object in the format
specified in the source object format field.</p>
<p><strong>Source object format</strong> The format of the source object. The</p>
<p>possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>LRSS0100</em></td>
<td align="left" valign="top">Source object data is returned in the format LRSS0100.</td>
</tr>
<tr>
<td align="left" valign="top"><em>LRSS0200</em></td>
<td align="left" valign="top">Source object data is returned in the format LRSS0200</td>
</tr>
</table>
<h3><a name="HDRLRSS1A">Format LRSS0100</a></h3>
<p>For more information about the fields in the following table, see <a href=
"#HDRFD7X">Field Descriptions</a>.</p>
<br>
<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%">Source object</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">Source object library</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">Source object type</td>
</tr>
</table>
<br>
<h3><a name="HDRFD7X">Field Descriptions</a></h3>
<p><strong>Source object.</strong> The name of the object that the resource was
found in.</p>
<p>The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SPLF</em></td>
<td align="left" valign="top">The resource is found within the data stream of
the spooled file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>object_name</em></td>
<td align="left" valign="top">The name of the AFPDS resource that the resource
object is found in.</td>
</tr>
</table>
<br>
<p><strong>Source object library.</strong> The library that contains the source
AFPDS resource object. This field is blank when the source object is *SPLF.</p>
<p><strong>Source object type.</strong> The object type of the source AFPDS
resource object. This field is blank when the source object is *SPLF or one of
the following special values:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*PAGSEG</em></td>
<td align="left" valign="top">Page segment</td>
</tr>
<tr>
<td align="left" valign="top"><em>*PAGDFN</em></td>
<td align="left" valign="top">Page definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*OVL</em></td>
<td align="left" valign="top">Overlay</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FORMDF</em></td>
<td align="left" valign="top">Form definition</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FNTRSC</em></td>
<td align="left" valign="top">Font resource</td>
</tr>
</table>
<br>
<h3><a name="HDRLRSS2A">Format LRSS0200</a></h3>
<p>For more information about the fields in the following table, see <a href=
"#HDRFD8X">Field Descriptions</a>.</p>
<br>
<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%">Displacement to source object name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">4</td>
<td align="center" valign="top" width="10%">4</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length of source object name</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 source object path name</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">0C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of source object path name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">&nbsp;</td>
<td align="center" valign="top" width="10%">&nbsp;</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Source object name</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">Source object path name</td>
</tr>
</table>
<br>
<h3><a name="HDRFD8X">Field Descriptions</a></h3>
<p><strong>Displacement to source object name.</strong> The displacement, in number of bytes, from the beginning of the structure to the source object name.</p>
<p><strong>Displacement to source object path name.</strong> The displacement, in number of bytes, from the beginning of the structure to the source object path name. This field will be set to zero if the source object name contains the descriptive name of a True Type font.</p>
<p><strong>Length of source object name.</strong> The length of the source object name in number of bytes.</p>
<p><strong>Length of source object path name.</strong> The length of the path name in number of bytes.</p>
<p><strong>Source object name.</strong> The name of the object that the resource was found in. For a True Type font, the source object name can be the font's descriptive name.</p>
<br>
<p><strong>Source object path name.</strong>The name of the integrated file system path where the source object resides.</p>
<br>
<h3><a name="HDRLRSC5A">Format LRSC0500</a></h3>
<p>For more information about the fields in the following table, see <a href=
"#HDRFD9X">Field Descriptions</a>.</p>
<br>
<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 entry</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Resource availability</td>
</tr>
<tr>
<td align="center" valign="top">5</td>
<td align="center" valign="top">5</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved</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 resource name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">12</td>
<td align="center" valign="top" width="10%">0C</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length of resource name</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 path name</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">Length of path name</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">Resource name</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>
<h3><a name="HDRFD9X">Field Descriptions</a></h3>
<p><strong>Displacement to path name</strong> The displacement, in number of bytes, from the beginning of the entry to the path name.</p>
<p><strong>Displacement to resource name</strong> The displacement, in number of bytes, from the beginning of the entry to the resource name.</p>
<p><strong>Length of entry.</strong> Length of the entry in number of bytes.</p>
<p><strong>Length of path name.</strong> The length of the path name in number of bytes.</p>
<p><strong>Length of resource name.</strong> The length of the resource name in number of bytes.</p>
<p><strong>Path name.</strong> The name of the integrated file system path where the resource resides.</p>
<p><strong>Resource availability.</strong> Whether the resource was found, not
found, or the caller or the owner of the spooled file was not authorized to the
resource, the resource library, or the resource directory.</p>
<p>Possible values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">The resource was not available for one of the
following reasons:<br>
<ul>
<li>The resource could not be found on the system.</li>
<li>The user who created the spooled file was not authorized to the resource, the resource library, or the resource directory.</li>
<li>If *NONE was specified for the spooled file name, the caller of the API was
not authorized to the resource, the resource library, or the resource directory.</li>
</ul>
</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The resource was found on the system.</td>
</tr>
</table>
<br>
<p><strong>Resource name.</strong> The name of the AFPDS resource used in the
spooled file.</p>
<br>
<br>
<h3>Error Messages</h3>
<table cellpadding="5">
<tr>
<th align="left" valign="top">Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td width="15%" align="left" valign="top">CPF247E E</td>
<td width="85%" align="left" valign="top">CCSID &amp;1 is 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">CPF3CF1 E</td>
<td align="left" valign="top">Error code parameter not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C20 E</td>
<td align="left" valign="top">Error found by program &amp;1.</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">CPF3C33 E</td>
<td align="left" valign="top">Spooled file number &amp;1 is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C40 E</td>
<td align="left" valign="top">Spooled file &amp;4 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C41 E</td>
<td align="left" valign="top">More than one spooled file with same name.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C42 E</td>
<td align="left" valign="top">User name or job number is not blank.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C43 E</td>
<td align="left" valign="top">Internal job identifier is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C44 E</td>
<td align="left" valign="top">Internal spooled file identifier is not
valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3C58 E</td>
<td align="left" valign="top">Job name specified is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33C9 E</td>
<td align="left" valign="top">Spooled file name parameter cannot be blank.</td>
</tr>
<tr>
<td align="left" valign="top">CPF33CE E</td>
<td align="left" valign="top">Pel density specified is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3330 E</td>
<td align="left" valign="top">Necessary resource not available.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3336 E</td>
<td align="left" valign="top">Job &amp;5/&amp;4/&amp;3 no longer in the
system.</td>
</tr>
<tr>
<td align="left" valign="top">CPF333B E</td>
<td align="left" valign="top">Job system name is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF333C E</td>
<td align="left" valign="top">Spooled file create date is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF333D E</td>
<td align="left" valign="top">Spooled file create time is not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF333E E</td>
<td align="left" valign="top">Spooled file create time is not blank.</td>
</tr>
<tr>
<td align="left" valign="top">CPF333F E</td>
<td align="left" valign="top">Job system name is not blank.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3342 E</td>
<td align="left" valign="top">Job &amp;5/&amp;4/&amp;3 not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3343 E</td>
<td align="left" valign="top">Duplicate job names found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3350 E</td>
<td align="left" valign="top">Job &amp;5/&amp;4/&amp;3 no longer in the
system.</td>
</tr>
<tr>
<td align="left" valign="top">CPF335B E</td>
<td align="left" valign="top">Spooled file create date is not blank.</td>
</tr>
<tr>
<td align="left" valign="top">CPF34C4 E</td>
<td align="left" valign="top">List is too large for user space &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF34CA E</td>
<td align="left" valign="top">File &amp;1 number &amp;2 not available.</td>
</tr>
<tr>
<td align="left" valign="top">CPF34CC E</td>
<td align="left" valign="top">Resources cannot be retrieved from diskette
files.</td>
</tr>
<tr>
<td align="left" valign="top">CPF34CD E</td>
<td align="left" valign="top">Value for resource name parameter not valid.</td>
</tr>
<tr>
<td align="left" valign="top">CPF34CE E</td>
<td align="left" valign="top">Value &amp;1 not valid for resource object
type.</td>
</tr>
<tr>
<td align="left" valign="top">CPF34CF E</td>
<td align="left" valign="top">User profile of the spooled file owner &amp;1
damaged or not found.</td>
</tr>
<tr>
<td align="left" valign="top">CPF34DB E</td>
<td align="left" valign="top">File *NONE not valid with format &amp;1.</td>
</tr>
<tr>
<td align="left" valign="top">CPF3492 E</td>
<td align="left" valign="top">Not authorized to spooled file.</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">CPF9838 E</td>
<td align="left" valign="top">User profile storage limit exceeded.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9846 E</td>
<td align="left" valign="top">Error while processing file &amp;1 in library
&amp;2.</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: V3R7
<hr>
<table cellpadding="2" cellspacing="2" align="center">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"print1.htm">Print APIs</a> | <a href="aplist.htm">APIs by
category</a></td>
</tr>
</table>
</body>
</html>