Change Link List (CHGLNKLBRM)

The Change Link List (CHGLNKLBRM) allows you to change a list of object to be used in backup or archive processing. You can include the fully qualified object name and whether you want to include or exclude the object from the list.

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

Restrictions:

The CHGLNKLBRM command uses the i5/OS Save Object (SAV) and Restore Object (RST) commands to process the lists that you enter into the CHGLNKLBRM command. These restrictions can be reviewed in the SAV and RST command help information.
You cannot save QDLS or QSYS.LIB using the Save Object using BRM (SAVBRM) command.

Parameters

Keyword	Description	Choices	Notes
LIST	List	Character value	Optional, Positional 1
TYPE	Usage type	BKU, ARC	Optional
OBJ	Objects	Values (up to 300 repetitions): Element list	Optional
	Element 1: Name	Path name
	Element 2: Include or omit	INCLUDE, OMIT
SUBTREE	Directory subtree	ALL, DIR, NONE, OBJ	Optional
TEXT	Text	Character value	Optional

Top

Usage type (TYPE)

Specifies the intended usage type of the items that you are grouping together for processing.

*BKU: The list is used in backup processing.
*ARC: The list is used in archive processing.
Note: The BRMS Advanced feature (Option 2) is required to use this value.

Objects (OBJ)

Specifies the objects that you want to include or exclude from a list of objects you want to save. A maximum of 300 object name patterns can be specified.

This is a required parameter.

Element 1: Name

'*'

The objects in the current directory are saved.

'object-path-name-pattern'

Specify an object path name or a pattern that can match many names.

Restriction:

You cannot list QDLS or QSYS.LIB objects in a link list. Use the appropriate *OBJ or *FLR list for objects in these file systems. To create lists of objects in these file systems, use the Work with Lists using BRMS (WRKLBRM) command.

Element 2: Include or omit

The second part specifies whether names that match the pattern should be included or omitted from the operation. Note that in determining whether a name matches a pattern, relative name patterns are always treated as relative to the current working directory. The Directory subtree (SUBTREE) parameter determines whether the subtrees are included or omitted.

*INCLUDE: Objects that match the object name pattern are to be saved, unless overridden by an *OMIT specification.
*OMIT: Objects matching the object name pattern are not to be saved. This overrides a *INCLUDE specification and is intended to be used to omit a subset of a previously selected pattern.

Directory subtree (SUBTREE)

Specifies whether directory subtrees should be processed.

*ALL: The entire subtree for each directory that matches the object name pattern will be processed.
*DIR: Objects in the first level of each directory that matches the object name pattern will be processed.
*NONE: No subtrees are included in the save operation. If a directory matches the object name pattern specified, the objects in the directory are included. If the directory has subdirectories, neither the subdirectories nor the objects in the subdirectories are included.
*OBJ: Only the objects that exactly match the object name pattern will be processed. If the object name pattern specifies a directory, objects in the directory are not included.

Examples

Example 1: Changing a Link List

CHGLNKLBRM LIST(MYLIST) USE(*BKU)
           OBJ(('/*' *INCLUDE) ('/QSYS.LIB/' *OMIT)
               ('/QDLS/' *OMIT) ('/NOTES/DATA/' *OMIT))

In this example a list of integrated file system objects includes the entire system except the QSYS.LIB and QDLS file systems, and the /NOTES/DATA directories.