DSPLNK (Display Object Links) Command Description

DSPLNK Command syntax diagram

Purpose

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 topic in the File systems and management category of the Information Center.

Restriction: The user must have *R authority to the directory containing the object links and *X to the other directories in the path. Object authority is not required when displaying the object name only.

Optional Parameters

OBJ
Specifies which objects are displayed.

*: All objects in the current directory are displayed.

object-name-pattern: 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 path names.

OUTPUT
Specifies whether the output from the command is shown at the requesting workstation or printed with the job's spooled output. More information on this parameter is in commonly used parameters.

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

*PRINT: The output is printed with the job's spooled output.

OBJTYPE
Specifies the object type you want displayed. For a list of the OS/400 object types that are valid for this parameter, refer to commonly used parameters.

*ALL: All objects whose name matches the pattern specified in the OBJ parameter are displayed.

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

object-type: Specify the object type you want displayed.

DETAIL
Specifies the information you want to see on the Display Object Links display.

*PRV: The same information that was displayed when you ran this command previously is shown. The value *BASIC is used if you have 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.

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.

Example for DSPLNK

DSPLNK   OBJ('X/PAY')

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

Error messages for DSPLNK

*ESCAPE Messages

CPF9899
Error occurred during processing of command.
CPFA085
Home directory not found for user &1.
CPFA0A7
Path name too long.

CPFA0A9

Object not found. Object is &1.>