RMVPJE (Remove Prestart Job Entry)

RMVPJE Command syntax diagram

 

Purpose

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

When removing an entry in which *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. This command is restricted to a user with *USE and object management authorities for 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.

 

Required Parameters

SBSD

Specifies the qualified name of the subsystem description that contains the prestart job entry being removed.

The name of the subsystem description can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

subsystem-description-name: Specify the name of the subsystem description.

 

Optional Parameters

PGM

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

The name of the program can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

program-name: Specify the name of the program.

Example for RMVPJE

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.

Error messages for RMVPJE

*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.