The Change Filter (CHGFTR) command allows you to change the text description of a filter object.

Parameters

Keyword	Description	Choices	Notes
FILTER	Filter	Qualified object name	Required, Key, Positional 1
	Qualifier 1: Filter	Name
	Qualifier 2: Library	Name, *LIBL, *CURLIB
TEXT	Text 'description'	Character value, *SAME, *BLANK	Optional

Top

Filter (FILTER)

Specifies the qualified name of the filter whose description is being changed.

The possible library values are:

*LIBL

All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB

The current library for the job is used to locate the filter. If no library is specified as the current library for the job, the QGPL library is used.

library-name

Specify the name of the library where the filter is located.

filter-name

Specify the name of the filter that is to be changed.

Text 'description' (TEXT)

Specifies text that briefly describes the object. More information on this parameter is in "Appendix A, Expanded Parameter Descriptions" of the CL Reference manual.

*SAME

The value does not change.

*BLANK

Text is not specified.

character-value

Specify no more than 50 characters of text, enclosed in apostrophes.

Examples

CHGFTR   FILTER(MYLIB/MYFILTER)  TEXT('New text here')

This command changes the description of the filter called MYFILTER in the library MYLIB.

Error messages

*ESCAPE Messages

CPF812D

&8 damage on filter &4.

CPF9802

Not authorized to object &2 in &3.

CPF9803

Cannot allocate object &2 in library &3.

CPF9807

One or more libraries in library list deleted.

CPF9808

Cannot allocate one or more libraries on library list.

CPF9830

Cannot assign library &1.