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

194 lines
6.6 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Dump Document Library Object (DMPDLO)</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="DMPDLO.Top_Of_Page"></a>
<h2>Dump Document Library Object (DMPDLO)</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="#DMPDLO.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DMPDLO.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DMPDLO.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DMPDLO"></a>
<p>The Dump Document Library Object (DMPDLO) command is used primarily for problem analysis. It copies the contents and attributes of folders, documents, or internal document library system objects to a spooled printer file named QPSRVDMP. If the printed output is not spooled and the printer is not available, the printer file (QPSRVDMP) is overridden.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>This command is shipped with public exclude (*EXCLUDE) authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.
</li>
<li>The user must have read (*R) authority to a document or folder to dump it.
</li>
<li>The user must have all object (*ALLOBJ) special authority to dump internal system objects.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPDLO.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DMPDLO.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="#DMPDLO.DLO"><b>DLO</b></a></td>
<td valign="top">Document library object</td>
<td valign="top"><i>Character value</i>, *SYSOBJNAM, *INT</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DMPDLO.FLR"><b>FLR</b></a></td>
<td valign="top">In 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="#DMPDLO.SYSOBJNAM"><b>SYSOBJNAM</b></a></td>
<td valign="top">System object name</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DMPDLO.SYSOBJATR"><b>SYSOBJATR</b></a></td>
<td valign="top">System object attributes</td>
<td valign="top"><b><u>*NONE</u></b>, *INTDOC, *DST</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DMPDLO.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DMPDLO.DLO"></a>
<h3>Document library object (DLO)</h3>
<p>Specifies the document library object that is dumped.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*SYSOBJNAM</b></dt>
<dd>The system object name of the document or folder specified on the <b>System object name (SYSOBJNAM)</b> parameter is used to identify the folder or document that is dumped. This value must be used to dump an internal or distribution document, or a document that is not in a folder.
</dd>
<dt><b>*INT</b></dt>
<dd>Internal document library system objects are dumped.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the document or folder that is dumped.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPDLO.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DMPDLO.FLR"></a>
<h3>In folder (FLR)</h3>
<p>Specifies the folder that contains the documents or folders. If the document or folder does not exist in a folder, *NONE is specified.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The object is not in a folder.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the qualified name of the folder containing the folder or document that is dumped.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPDLO.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DMPDLO.SYSOBJNAM"></a>
<h3>System object name (SYSOBJNAM)</h3>
<p>Specifies the system object name of the document that is dumped. A system object name must be entered on this parameter if *SYSOBJNAM is specified on the <b>Document library object (DLO)</b> parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The object dumped is not identified by its system object name.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the system object name of the folder or document that is dumped.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPDLO.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DMPDLO.SYSOBJATR"></a>
<h3>System object attributes (SYSOBJATR)</h3>
<p>Specifies the attributes of the object that is dumped. A value other than *NONE may be entered on this parameter only if *SYSOBJNAM is specified on the <b>Document library object (DLO)</b> parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No attributes are specified for the object.
</dd>
<dt><b>*INTDOC</b></dt>
<dd>The object dumped is an internal document.
</dd>
<dt><b>*DST</b></dt>
<dd>The object dumped is a distribution document.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPDLO.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DMPDLO.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Dumping a Document</b>
</p>
<p>
<pre>
DMPDLO DLO(KAREN) FLR(PEGGY)
</pre>
</p>
<p>This command dumps a document or a folder named KAREN which is located in the folder named PEGGY.
</p>
<p><b>Example 2: Specifying a System Object Name</b>
</p>
<p>
<pre>
DMPDLO DLO(*SYSOBJNAM) SYSOBJNAM(BHZM052634)
</pre>
</p>
<p>This command dumps the document library object identified by the system object name BHZM052634.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPDLO.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DMPDLO.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF8A43</b></dt>
<dd>Dump failed or partially failed for &amp;2 of type &amp;4 in folder path &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPDLO.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>