Remove Prestart Job Entry (RMVPJE)

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

The Remove Prestart Job Entry (RMVPJE) command removes a prestart job entry from the specified subsystem description.

When removing an entry where *LIBL is specified for the library name, the library list is searched for a program with the specified name. If a program is found in the library list but an entry exists with a different library name (which is found later in the library list), no entry is removed. If a program is not found in the library list but an entry exists, no entry is removed.

Restrictions:

  1. To use this command, you must have:
    • object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the specified subsystem description and execute (*EXECUTE) authority to the library containing the subsystem description.
  2. If the prestart job is active, the End Prestart Jobs (ENDPJ) command must be run before this command can be run.
Top

Parameters

Keyword Description Choices Notes
SBSD Subsystem description Qualified object name Required, Positional 1
Qualifier 1: Subsystem description Name
Qualifier 2: Library Name, *LIBL, *CURLIB
PGM Program Qualified object name Required, Positional 2
Qualifier 1: Program Name
Qualifier 2: Library Name, *LIBL, *CURLIB
Top

Subsystem description (SBSD)

Specifies the name and library of the subsystem description that contains the prestart job entry that is removed.

This is a required parameter.

Qualifier 1: Subsystem description

name
Specify the name of the subsystem description from which the prestart job entry is being removed.

Qualifier 2: Library

*LIBL
All libraries in the thread's library list are searched until a match is found.
*CURLIB
The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
name
Specify the subsystem description's library from which the prestart job entry is being removed.
Top

Program (PGM)

Specifies the name and library of the program for the prestart job entry that is removed. Two entries with the same program name can exist in a single subsystem description but they must have different library names.

This is a required parameter.

Qualifier 1: Program

name
Specify the name of the program run by the prestart job.

Qualifier 2: Library

*LIBL
All libraries in the thread's library list are searched until a match is found.
*CURLIB
The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
name
Specify the library of the program run by the prestart job.
Top

Examples 

RMVPJE   SBSD(QGPL/PJE)  PGM(QGPL/PGM1)

This command removes the prestart job entry for the PGM1 program (in the QGPL library) from the PJE subsystem description contained in the QGPL library.

Top

Error messages

*ESCAPE Messages

CPF1619
Subsystem description &1 in library &2 damaged.
CPF1691
Active subsystem description may or may not have changed.
CPF1697
Subsystem description &1 not changed.
Top