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:

  1. This command is shipped with public *EXCLUDE authority.
  2. To use this command you must have *SERVICE special authority, or be authorized to the Service Trace function of i5/OS through iSeries Navigator's Application Administration support. The Change Function Usage Information (QSYCHFUI) API, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
  3. The following user profiles have private authorities to use the command:
    • QPGMR
    • QSRV
  4. 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*-filter-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 (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. For more information about generic object names, see the i5/OS objects topic under Programming->CL in the iSeries Information Center at the Web site: http://www.ibm.com/eserver/iseries/infocenter
filter-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