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

209 lines
7.5 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 Object (DMPOBJ)</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="DMPOBJ.Top_Of_Page"></a>
<h2>Dump Object (DMPOBJ)</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="#DMPOBJ.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DMPOBJ.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DMPOBJ.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DMPOBJ"></a>
<p>The Dump Object (DMPOBJ) command dumps the contents or attributes of the specified operating system object to a spooled printer file named QPSRVDMP. Whether the contents or attributes <b>can</b> be dumped depends on the object type. If the user had specified SPOOL(*NO) on either the CHGPRTF command or the OVRPRTF command, then the output is not spooled but printed directly; and, if the printer is not available, then this command overrides the print job and spools the output. When the user specifies SPOOL(*NO) on one of the two commands above, the user must specify QPSRVDMP as the printer file. Any library or object that is stored in a library can be dumped, but only one object can be specified at a time on this command.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>To use this command, you must be signed on as QPGMR, QSYSOPR, QSRV, or QSRVBAS, or have all object (*ALLOBJ) special authority.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DMPOBJ.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" rowspan="3"><a href="#DMPOBJ.OBJ"><b>OBJ</b></a></td>
<td valign="top">Object</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Object</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB, QTEMP</td>
</tr><tr>
<td valign="top"><a href="#DMPOBJ.OBJTYPE"><b>OBJTYPE</b></a></td>
<td valign="top">Object type</td>
<td valign="top">*ALRTBL, *AUTL, *BNDDIR, *CFGL, *CHTFMT, *CLD, *CLS, *CMD, *CNNL, *COSD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *CTLD, *DEVD, *DIR, *DOC, *DTAARA, *DTADCT, *DTAQ, *EDTD, *EXITRG, *FCT, *FILE, *FLR, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *IMGCLG, *IPXD, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LIB, *LIND, *LOCALE, *MEDDFN, *MENU, *MODD, *MGTCOL, *MODULE, *MSGF, *MSGQ, *M36, *M36CFG, *NODL, *NTBD, *NWID, *NWSCFG, *NWSD, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *SVRSTG, *S36, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *WSCST</td>
<td valign="top">Required, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DMPOBJ.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DMPOBJ.OBJ"></a>
<h3>Object (OBJ)</h3>
<p>Specifies the object to be dumped. Only objects that are stored in libraries can be dumped. The DMP command can be used to dump objects stored in directories.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Object</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the object to be dumped.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the library list for the current thread are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the object. If no current library entry exists in the library list, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the object is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DMPOBJ.OBJTYPE"></a>
<h3>Object type (OBJTYPE)</h3>
<p>Specifies the object type of the operating system object being dumped. Any one of the object types can be specified.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>object-type</i></b></dt>
<dd>Specify the object type of the object to be dumped.
<p>To see a complete list of object types when prompting this command, position the cursor on the field for this parameter and press F4 (Prompt). For a description of the object types, see "Object types" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DMPOBJ.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Dumping File Contents</b>
</p>
<p>
<pre>
DMPOBJ OBJ(ORDENT/ORDERIN) OBJTYPE(*FILE)
</pre>
</p>
<p>This command dumps the contents of the file named ORDERIN that is stored in the ORDENT library.
</p>
<p><b>Example 2: Dumping a Program</b>
</p>
<p>
<pre>
DMPOBJ OBJ(MYPROG) OBJTYPE(*PGM)
</pre>
</p>
<p>This command dumps the first copy of the program MYPROG that is found in the library list. The dump is spooled to the printer output file QPSRVDMP.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DMPOBJ.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF3560</b></dt>
<dd>Job being serviced not running.
</dd>
<dt><b>CPF3561</b></dt>
<dd>Context &amp;8 &amp;9 &amp;7 not found.
</dd>
<dt><b>CPF3562</b></dt>
<dd>Object &amp;7 not found.
</dd>
<dt><b>CPF3673</b></dt>
<dd>Not authorized to library &amp;7.
</dd>
<dt><b>CPF3909</b></dt>
<dd>Service command will not be processed.
</dd>
<dt><b>CPF3918</b></dt>
<dd>Service request canceled.
</dd>
<dt><b>CPF3925</b></dt>
<dd>Cannot open file &amp;1.
</dd>
<dt><b>CPF3935</b></dt>
<dd>Job being serviced ended during dump.
</dd>
<dt><b>CPF3946</b></dt>
<dd>Context damaged.
</dd>
<dt><b>CPF3947</b></dt>
<dd>Library &amp;7 not available.
</dd>
<dt><b>CPF3948</b></dt>
<dd>Library &amp;3 previously deleted.
</dd>
<dt><b>CPF3949</b></dt>
<dd>Library &amp;7 damaged.
</dd>
<dt><b>CPF3950</b></dt>
<dd>Error message &amp;2 received for file &amp;1. Request ended.
</dd>
<dt><b>CPF3951</b></dt>
<dd>File &amp;1 cannot be overridden by file name &amp;2.
</dd>
<dt><b>CPF3967</b></dt>
<dd>Dump not started because serviced job not running.
</dd>
<dt><b>CPF3968</b></dt>
<dd>Dump not started because serviced job completed running.
</dd>
<dt><b>CPF3969</b></dt>
<dd>Error during close of file &amp;1. Output may not be complete.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPOBJ.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>