The Display Object Links (DSPLNK) command shows a list of names of specified objects in directories and options to display information about the objects.

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.

Restrictions:

Note: 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.

Parameters

Keyword	Description	Choices	Notes
OBJ	Object	Path name, *	Optional, Positional 1
OUTPUT	Output	*, *PRINT	Optional, Positional 2
OBJTYPE	Object type	*ALL, *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	Optional
DETAIL	Detail	*PRV, *NAME, *BASIC, *EXTENDED	Optional
DSPOPT	Display option	*PRV, *USER, *ALL	Optional

Top

Object (OBJ)

Specifies which objects are displayed.

*

All objects in the current directory are displayed.

object-path-name

Specify the path name of the object or a pattern to match the name of the object 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.

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.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*

The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.

*PRINT

The output is printed with the job's spooled output.

Object type (OBJTYPE)

Specifies the object type to be displayed.

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.

*ALL

All objects whose name matches the pattern specified in the Object (OBJ) parameter are displayed.

*ALLDIR

All directory types (DIR, LIB, FLR, database FILE) are displayed.

object-type

Specifies the object type to be displayed.

Detail (DETAIL)

Specifies the information to be displayed on the Display Object Links (DSPLNK) list.

*PRV

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 Work with Object Links (WRKLNK) command before.

*NAME

Only the name is displayed.

*BASIC

The name is displayed along with the type, type attribute, and text.

*EXTENDED

In addition to the basic information noted above, the type field is extended to display more information about symbolic links and an additional option is available to display hard or symbolic links.

Display option (DSPOPT)

Specifies whether to show PC system and hidden objects.

*PRV

The same value is used for this parameter as the previous time the command was run by this user. If this command has not been used before, *USER is used.

*USER

The PC system and hidden objects are not shown. Objects beginning with a period (.) are not displayed unless the specified pattern begins with a period (.).

*ALL

All objects are shown, including the PC system and hidden objects. Objects beginning with a period (.) are displayed (with asterisk (*) specified for the pattern) including the directory (.) and the parent directory (..) entries.

Examples

Example 1: Displaying an Object Link

DSPLNK   OBJ('X/PAY')

This command displays the object PAY located in directory X in the current directory.

Error messages

*ESCAPE Messages

CPF9899

Error occurred during processing of command.

CPFA085

Home directory not found for user &1.

CPFA09C

Not authorized to object. Object is &1.

CPFA0A7

Path name too long.

CPFA0A9

Object not found. Object is &1.