ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/dspdlonam.htm

292 lines
9.9 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Display DLO Name (DSPDLONAM)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="DSPDLONAM.Top_Of_Page"></a>
<h2>Display DLO Name (DSPDLONAM)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#DSPDLONAM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPDLONAM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPDLONAM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPDLONAM"></a>
<p>The Display Document Library Object Name (DSPDLONAM) command is used to display or print alternate forms of a filed document, folder, or distribution document name.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>A user must have use (*USE) authority to the filed document or folder to display the various forms of the name.
</li>
<li>Users must have all object (*ALLOBJ) special authority to display the various forms of the name for a distribution document.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLONAM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPDLONAM.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#DSPDLONAM.DLO"><b>DLO</b></a></td>
<td valign="top">Document library object</td>
<td valign="top"><i>Character value</i>, *DOCID, *LADNTSP, *SYSOBJNAM</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDLONAM.FLR"><b>FLR</b></a></td>
<td valign="top">Folder</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDLONAM.DOCID"><b>DOCID</b></a></td>
<td valign="top">Document identifier</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDLONAM.LADNTSP"><b>LADNTSP</b></a></td>
<td valign="top">LADN timestamp</td>
<td valign="top">0000000000000001-FFFFFFFFFFFFFFFF, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDLONAM.SYSOBJNAM"><b>SYSOBJNAM</b></a></td>
<td valign="top">System object name</td>
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDLONAM.OBJCLS"><b>OBJCLS</b></a></td>
<td valign="top">Object class</td>
<td valign="top"><b><u>*DOC</u></b>, *FLR, *DST</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDLONAM.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPDLONAM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPDLONAM.DLO"></a>
<h3>Document library object (DLO)</h3>
<p>Specifies the document or folder for which alternate names are to be displayed or printed.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*DOCID</b></dt>
<dd>The document or folder is identified using its library-assigned document name specified in the DOCID parameter. The <b>Folder (FLR)</b> parameter must be *NONE.
</dd>
<dt><b>*LADNTSP</b></dt>
<dd>The document or folder is identified using its library-assigned document name (LADN) timestamp specified in the LADNTSP parameter. The FLR parameter must be *NONE.
</dd>
<dt><b>*SYSOBJNAM</b></dt>
<dd>The document or folder is identified using its system object name specified in the SYSOBJNAM parameter. The FLR parameter must be *NONE.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-assigned name of the document or folder. The folder containing the specified document or folder is specified in the FLR parameter.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLONAM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDLONAM.FLR"></a>
<h3>Folder (FLR)</h3>
<p>Specifies the folder path that contains the document or folder specified in the <b>Document library object (DLO)</b> parameter. The FLR parameter must be *NONE if the DLO parameter is *DOCID, *LADNTSP, or *SYSOBJNAM.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The document or folder is not contained in a folder, or is identified using the <b>DOCID</b>, <b>LADNTSP</b>, or <b>SYSOBJNAM</b> parameter.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the folder that contains the document or folder named in the DLO parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLONAM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDLONAM.DOCID"></a>
<h3>Document identifier (DOCID)</h3>
<p>Specifies the library-assigned name of the document. This is the name assigned to the document by the system when it was created. Documents filed outside the local system have only library-assigned document names. The library-assigned document names can be determined by using the Query Document Library (QRYDOCLIB) command or by the message returned from the File Document (FILDOC) command.
</p>
<p>Library-assigned document names are 24 characters in length with the following format:
</p>
<p>
<pre>
YYYYMMDDHHMNSSHSSNSNSNSN
</pre>
</p>
<p>where:
</p>
<p>
<pre>
YYYY = year
MM = month
DD = day
HH = hour
MN = minute
SS = second
HS = hundredths of a second
SNSNSNSN = system name
</pre>
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>A library-assigned document name is not specified for the object.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the library-assigned name of the document or folder object. The library-assigned document name can be determined by using the Query Document Library (QRYDOCLIB) command or by the message returned from the File Document (FILDOC) or other command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLONAM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDLONAM.LADNTSP"></a>
<h3>LADN timestamp (LADNTSP)</h3>
<p>Specifies the library assigned document name (LADN) timestamp of the document or folder object. A LADN timestamp is specified only if *LADNTSP is specified on the <b>Document library object (DLO)</b> parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>A LADN timestamp is not specified for the object.
</dd>
<dt><b><i>timestamp</i></b></dt>
<dd>Specify the LADN timestamp of the document library object.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLONAM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDLONAM.SYSOBJNAM"></a>
<h3>System object name (SYSOBJNAM)</h3>
<p>Specifies the system object name of the document or folder object. A system object name is specified only if *SYSOBJNAM is specified on the <b>Document library object (DLO)</b> parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>A system object name is not specified for the object.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the system object name of the document library object.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLONAM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDLONAM.OBJCLS"></a>
<h3>Object class (OBJCLS)</h3>
<p>Specifies the class of the object to locate.
</p>
<dl>
<dt><b><u>*DOC</u></b></dt>
<dd>The specified DLO is a filed document.
</dd>
<dt><b>*FLR</b></dt>
<dd>The specified DLO is a folder.
</dd>
<dt><b>*DST</b></dt>
<dd>The specified DLO is a distribution document.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLONAM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDLONAM.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.
</dd>
</dl>
<dl>
<dt><b>*PRINT</b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
</dl>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLONAM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDLONAM.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
DSPDLONAM DLO(MYDOC) FLR(MYFLR) OBJCLS(*DOC)
</pre>
</p>
<p>This command finds the document MYDOC in folder MYFLR and displays all forms of the document's name. If the job is running in batch mode, the information is printed and not displayed.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLONAM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDLONAM.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF8AC0</b></dt>
<dd>&amp;1 command failed.
</dd>
<dt><b>CPF8AC1</b></dt>
<dd>Not authorized to distribution documents.
</dd>
<dt><b>CPF8A75</b></dt>
<dd>Not authorized to access folder &amp;1.
</dd>
<dt><b>CPF8A77</b></dt>
<dd>Folder &amp;1 not found.
</dd>
<dt><b>CPF8A82</b></dt>
<dd>Document &amp;2 not found in folder &amp;1.
</dd>
<dt><b>CPF8A83</b></dt>
<dd>Not authorized to access document &amp;2 in folder &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDLONAM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>