Work with Link Information (WRKLNKBRM)

The Work with Link Information (WRKLNKBRM) command allows you to work with all or selected directories that contain integrated file systems object link information. You are taken to the Work with Link Information display where you can work with integrated file system object link information or remove integrated file system object link information. Output can be a display or printed report.

To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.

Parameters

Keyword	Description	Choices	Notes
DIR	Directory	Path name, *	Optional
SAVTYPE	Save type	Single values: ALL Other values (up to 3 repetitions): ARC, CUML, FILE, FULL, INCR, NONE, QBRM	Optional
SLTDATE	Select dates	Element list	Optional
	Element 1: From date	Character value, BEGIN, CURRENT
	Element 2: To date	Character value, END, CURRENT
FROMSYS	From system	Character value, *LCL	Optional
OUTPUT	Output	, PRINT	Optional

Top

Directory (DIR)

Specifies the path for the directories that you want to work with in a display or report.

*: Include all directories in the display or report.
object-name-pattern: 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.

Save type (SAVTYPE)

Specifies the type of save items that you want to work with. You can specify all types of items, a specific type or a mix of types.

You can enter multiple values for this parameter. If you are on an entry display and you need additional entry fields to enter these multiple values, type a plus sign (+) in the entry field opposite the phrase "+ for more" and press the Enter key.

Single values

*ALL: Work with all types of save items.

Other values (up to 3 repetitions)

*ARC: Only work with save items that were a result of an archive process.
Note: The BRMS Advanced feature (Option 2) is required for this value.
*CUML: Only work with save items that were a result of an incremental (save changed objects) save. *CUML indicates that the incremental save includes all objects that have been changed since the last full save.
*FILE: Only work with save items that were a result of native i5/OS save commands.
*FULL: Only work with save items that were a result of a full save.
*INCR: Only work with save items that were a result of an incremental (save changed objects) save. *INCR indicates that the incremental save includes all objects that have been changed since the last incremental save.
*NONE: Only work with save items that have never been saved.
*QBRM: Work with BRMS media information items that have been saved.

Select date (SLTDATE)

Specifies a range of dates that you want to use when selecting entries to include in the display or report. The From date is the beginning point in the date range and the To date is the end of the date range.

Note: Using this parameter, it is possible to enter a date with no separator, or a number of days which can be up to 5 digits in length. For instance, if you are using month/day/year format, the number 12904 would be formatted as January 29, 2004. If on the other hand, you entered a number 13904, BRMS assume that this is not a date, but rather is a number. BRMS always tries to calculate a calendar date first when a number is entered and then if the date it calculates is not valid, assumes that it is a number of days. If the number that is entered is over 5 digits and the date that it calculates is not valid, you receive an error message.

Element 1: From date

*BEGIN: The date of the earliest entry is the beginning date of the date range.
*CURRENT: The current date is the starting point of the range of dates to select for the display or report.
from-date: Specify the date entered in job date format with or without date separators that you want to be the beginning date of the date range.
number-of-days: Specify the number of days before the current day that is the beginning date of the date range.

Element 2: To date

*END: The last date is the ending date of the date range.
*CURRENT: The current date is the ending date of the date range.
to-date: Specify the date in job date format with or without date separators that you want to be the ending date of the date range.
number-of-days: Specify the number of days before the current day that is the ending date of the date range.

From system (FROMSYS)

Specifies the location and network identification of the system whose integrated file system information that you want to display or print.

Note: Use the Display Network Attributes (DSPNETA) command to view the system network attributes.

Note: The BRMS Network feature (Option 1) is required to use this value if a value other than *LCL is specified.

*LCL: Specifies that the from-system is the local system. BRMS uses the Default local location name (LCLLOCNAME) network attribute and not the System name (SYSNAME) network attribute to determine the current system name. In most cases, the systems have the same value specified for LCLLOCNAME as for SYSNAME.
location-name: Specifies the Default local location name (LCLLOCNAME) network attribute of the remote system for the network operation. The current system Local network ID (LCLNETID) network attribute is used to connect with the remote system.
network-id.location-name: Specifies the Local network ID (LCLNETID) and the Default local location name (LCLLOCNAME) network attributes of the remote system for the network operation. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the LCLNETID and cccccccc is the LCLLOCNAME.

Examples

WRKLNKBRM SLTDATE(*CURRENT *CURRENT)

This command displays the Work with Link Information panel where all integrated file system information for the current date is displayed.

Error messages

*ESCAPE Messages

BRM1177: Cannot establish connection with remote system.
BRM1867: Error writing file &1.
BRM1868: File &1 not opened successfully.
BRM1917: Feature not installed.
BRM1921: Feature not licensed.
BRM4040: Access denied for user &1.
BRM4041: Access denied for user &1.
BRM40A2: BRMS product initialization required.
BRM4117: Recovery of first media file required.