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 IBM i licensed program installed.

Restrictions:

1. The CHGLNKLBRM command uses the operating system 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.
2. You cannot save QDLS or QSYS.LIB using the Save Object using BRM (SAVBRM) command.

Parameters

List (LIST)

The name of the list being changed to contain integrated file system objects. The list must be an existing BRMS link list.

This is a required parameter.

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.

Text (TEXT)

Specifies the text that describes the integrated file system object list.

text

Specify the text that describes the integrated file system object list.

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.

Error messages

*ESCAPE Messages

BRM1917

Feature not installed.

BRM1921

Feature not licensed.

BRM40A2

BRMS product initialization required.

CPF9800

All CPF98xx messages could be signaled. xx is from 01 to FF.