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

203 lines
8.7 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>Work with Object Links (WRKLNK)</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="WRKLNK.Top_Of_Page"></a>
<h2>Work with Object Links (WRKLNK)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#WRKLNK.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKLNK.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKLNK.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKLNK"></a>
<p>The Work with Object Links (WRKLNK) command shows a list of names of specified objects in directories and options to work with the objects.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>To perform operations on the objects, the user must have use (*USE) authority to the command used by the operation, and the appropriate authority to the objects on which the operation is to be performed.
</li>
</ol>
<p>
<b>Note: </b>The authority requirements for this command are complex with respect to file systems, object types, requested operations etc.. Therefore, see the iSeries Security Reference, SC41-5302 book for information about the required authorities for this command.
</p>
<p>For more information about integrated file system commands, see the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKLNK.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKLNK.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="#WRKLNK.OBJ"><b>OBJ</b></a></td>
<td valign="top">Object</td>
<td valign="top"><i>Path name</i>, <b><u>*</u></b></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#WRKLNK.OBJTYPE"><b>OBJTYPE</b></a></td>
<td valign="top">Object type</td>
<td valign="top"><b><u>*ALL</u></b>, *ALLDIR, *ALRTBL, *AUTL, *BLKSF, *BNDDIR, *CFGL, *CHTFMT, *CHRSF, *CLD, *CLS, *CMD, *CNNL, *COSD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *CTLD, *DDIR, *DEVD, *DIR, *DOC, *DSTMF, *DTAARA, *DTADCT, *DTAQ, *EDTD, *EXITRG, *FCT, *FIFO, *FILE, *FLR, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *IMGCLG, *IPXD, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LIB, *LIND, *LOCALE, *MBR, *MEDDFN, *MENU, *MGTCOL, *MODD, *MODULE, *MSGF, *MSGQ, *M36, *M36CFG, *NODGRP, *NODL, *NTBD, *NWID, *NWSD, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SOCKET, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *STMF, *SVRSTG, *SYMLNK, *S36, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *VLDL, *WSCST</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKLNK.DETAIL"><b>DETAIL</b></a></td>
<td valign="top">Detail</td>
<td valign="top"><b><u>*PRV</u></b>, *NAME, *BASIC, *EXTENDED</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKLNK.DSPOPT"><b>DSPOPT</b></a></td>
<td valign="top">Display option</td>
<td valign="top"><b><u>*PRV</u></b>, *USER, *ALL</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#WRKLNK.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKLNK.OBJ"></a>
<h3>Object (OBJ)</h3>
<p>Specifies which objects are shown.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>All objects in the current directory are displayed.
</dd>
<dt><b><i>object-path-name</i></b></dt>
<dd>Specify the name of the object or a pattern to match the name(s) of the object(s) to be shown. The object path name can be either a simple name or a name that is qualified with the name of the directory in which the object is located. A pattern can be specified in the last part of the path name. An asterisk (*) matches any number of characters and a question mark (?) matches a single character. If the path name is qualified or contains a pattern, it must be enclosed in apostrophes.
<p>For more information on specifying path names, refer to "Object naming rules" 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="#WRKLNK.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKLNK.OBJTYPE"></a>
<h3>Object type (OBJTYPE)</h3>
<p>Specifies the type of objects to display.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All objects whose name matches the pattern specified in the <b>Object (OBJ)</b> parameter are displayed.
</dd>
<dt><b>*ALLDIR</b></dt>
<dd>All directory types (DIR, LIB, FLR, database FILE) are displayed.
</dd>
<dt><b><i>object-type</i></b></dt>
<dd>Specify the type of object matching the name pattern that is to be displayed.
<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="#WRKLNK.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKLNK.DETAIL"></a>
<h3>Detail (DETAIL)</h3>
<p>Specifies how much information is to be displayed on the Work with Object Links (WRKLNK) list.
</p>
<dl>
<dt><b><u>*PRV</u></b></dt>
<dd>The same information that was displayed when the user ran this command previously is shown. The value *BASIC is used if the user has not used this command or the Display Object Links (DSPLNK) command.
</dd>
<dt><b>*NAME</b></dt>
<dd>Only the name is displayed.
</dd>
<dt><b>*BASIC</b></dt>
<dd>The name is displayed along with the type, type attribute, and text.
</dd>
<dt><b>*EXTENDED</b></dt>
<dd>In addition to the basic information noted above, the type field is extended to show more information about symbolic links and an additional option is displayed to work with hard or symbolic links.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKLNK.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKLNK.DSPOPT"></a>
<h3>Display option (DSPOPT)</h3>
<p>Specifies whether to display PC system and hidden objects.
</p>
<dl>
<dt><b><u>*PRV</u></b></dt>
<dd>The same value is used for this parameter as the previous time the user ran this command. If this command has not been used before, *USER is used.
</dd>
<dt><b>*USER</b></dt>
<dd>The PC system and the hidden objects are not displayed. Objects beginning with a period (.) are not shown unless the specified pattern begins with a period (.).
</dd>
<dt><b>*ALL</b></dt>
<dd>All objects, including the PC system and hidden objects, are displayed. Objects beginning with a period (.) are shown (with asterisk (*) specified for the pattern) including the directory (.) and parent directory (..) entries.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKLNK.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKLNK.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Working with an Object Link</b>
</p>
<p>
<pre>
WRKLNK OBJ('X/PAY')
</pre>
</p>
<p>This command displays the Work with Object Links panel. This panel shows a list of names of objects in a directory and provides options for performing operations on those objects. In this example, the object's name is PAY and is located in directory X in the current directory.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKLNK.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKLNK.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF9899</b></dt>
<dd>Error occurred during processing of command.
</dd>
<dt><b>CPFA085</b></dt>
<dd>Home directory not found for user &amp;1.
</dd>
<dt><b>CPFA0A7</b></dt>
<dd>Path name too long.
</dd>
<dt><b>CPFA0A9</b></dt>
<dd>Object not found. Object is &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKLNK.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>