Remove PEX Filter (RMVPEXFTR)
| Where allowed to run: All environments (*ALL) Threadsafe: Conditional |
Parameters Examples Error messages |
The Remove Performance Explorer Filter (RMVPEXFTR) command removes one or more Performance Explorer filters from the system. Each filter is stored as a member in the QAPEXFTR file in library QUSRSYS. The member name is the same as the filter name.
Restrictions:
- This command is shipped with public *EXCLUDE authority.
- To use this command you must have *SERVICE special authority, or be authorized to the Service Trace function of the operating system. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can be used to change the list of users that are allowed to perform trace operations.
- The following user profiles have private authorities to use the command:
- QPGMR
- QSRV
- Two threads within the same job will not be allowed to run RMVPEXFTR at the same time. The thread that issued RMVPEXFTR first will run the command to completion while the second RMVPEXFTR waits.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FTR | Filter | Generic name, name, *ALL | Required, Positional 1 |
| Top |
Filter (FTR)
Specifies the name of the Performance Explorer filter being removed. A specific or generic filter name, or *ALL, can be specified.
- *ALL
- All Performance Explorer filters are removed.
- generic-name
- Specify the generic name of the Performance Explorer filter to be removed. A generic name is a character string of one or more characters followed by an asterisk (*). A generic name specifies all items that have names with the same prefix as the generic name.
- name
- Specify the name of the Performance Explorer filter to be removed.
| Top |
Examples
Example 1: Removing a Single Filter
RMVPEXFTR FTR(SAMPLE)
This command removes the member named SAMPLE from file QAPEXFTR in library QUSRSYS that contains the performance explorer filter named SAMPLE.
Example 2: Removing All Filters that Start with SAM
RMVPEXFTR FTR(SAM*)
This command removes all filters with names that start with SAM by removing all members that start with SAM from file QAPEXFTR in library QUSRSYS.
| Top |
Error messages
*ESCAPE Messages
- CPF3203
- Cannot allocate object for file &1 in &2.
- CPF3220
- Cannot do operation on file &1 in &2.
- CPF7301
- &5 members not removed from file &2 in &3.
- CPF7310
- Member &1 not removed from file &2 in &3.
| Top |