Remove PEX Definition (RMVPEXDFN)

Where allowed to run: All environments (*ALL)
Threadsafe: Conditional 		Parameters
Examples
Error messages

The Remove Performance Explorer Definition (RMVPEXDFN) command removes one or more Performance Explorer definitions from the system. Each definition is stored as a member in the QAPEXDFN file in library QUSRSYS. The member name is the same as the definition 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 RMVPEXDFN at the same time. The thread that issued RMVPEXDFN first will run the command to completion while the second RMVPEXDFN waits.
Top

Parameters

Keyword Description Choices Notes
DFN Definition Generic name, name, *ALL Required, Positional 1
Top

Definition (DFN)

Specifies the name of the Performance Explorer definition being removed. A specific or generic definition name, or *ALL, can be specified.

*ALL
All Performance Explorer definitions are removed.
definition-name
Specify the name of the Performance Explorer definition to be removed.
generic*-definition-name
Specify the generic name of the Performance Explorer definition 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.
Top

Examples

Example 1: Removing a Single Definition 

RMVPEXDFN   DFN(SAMPLE)

This command removes the member named SAMPLE from file QAPEXDFN in library QUSRSYS that contains the performance explorer definition named SAMPLE.

Example 2: Removing All Definitions that Start with SAM 

RMVPEXDFN   DFN(SAM*)

This command removes all definitions with names that start with SAM by removing all members that start with SAM from file QAPEXDFN 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