WRKLNK (Work with Object Links)

WRKLNK Command syntax diagram

 

Purpose

The Work with Object Links (WRKLNK) command shows a list of names of specified objects in directories and options to work with the objects.

 

Restrictions

1. To perform operations on the objects, the user must have *USE authority to the command used by the operation, and the appropriate authority to the objects on which the operation is to be performed.
2. 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.

   Note:

   If the object link being shown is a symbolic link and the type of the object it points to is being shown, the user must have *R authority to the symbolic link and *X authority to the directories in the path to the resolved object.

For more information about required authorities for performing operations on objects see the iSeries Security Reference book.

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.

 

Optional Parameters

OBJ

Specifies which objects are shown.

*: All objects in the current directory are shown.

'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.

OBJTYPE

Specifies the type of objects to display.

*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 type of object matching the name pattern that you want displayed.

DETAIL

Specifies how much information you want to see on the work with object links list.

*PRV: The same information that was displayed when you ran this command previously. Use the *BASIC value if you have not used this command or the Display Link (DSPLNK) 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 show more information about symbolic links and an additional option is displayed to work with hard or symbolic links.

Note:

Audit values for QDLS objects are not displayed.

DSPOPT

Specifies whether to display PC system and hidden objects.

*PRV: The same value is used for this parameter as was used the previous time you ran this command. If this command has not been used before, *USER is used.

*USER: 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 (.).

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

Example for WRKLNK

WRKLNK  OBJ('X/PAY')

With this command you can work with the object for which you have authority. The object's name is PAY and is located in directory X in the current directory.

Error messages for WRKLNK

*ESCAPE Messages

CPFA085

Home directory not found for user &1.

CPF9899

Error occurred during processing of command.

CPFA0A7

Path name too long.

CPFA0A9

Object not found. Object is &1.>