Change Filter (CHGFTR)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
| Top |
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.
| Top |
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.
| Top |
Examples
CHGFTR FILTER(MYLIB/MYFILTER) TEXT('New text here')
This command changes the description of the filter called MYFILTER in the library MYLIB.
| Top |
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.
| Top |