CHGFTR (Change Filter)

CHGFTR Command syntax diagram

 

Purpose

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

 

Required Parameters

FILTER

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

The name of the filter can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

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

 

Optional Parameters

TEXT

Specifies the text that briefly describes the filter. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

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

Example for CHGFTR

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

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

Error messages for CHGFTR

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