Remove Job Queue Entry (RMVJOBQE)

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

The Remove Job Queue Entry (RMVJOBQE) command removes a job queue entry from the specified subsystem description. Jobs on the job queue remain on the queue when the job queue entry is removed from the subsystem description.

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. A job queue entry cannot be removed if any currently active jobs were started from the job queue.
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
JOBQ Job queue Qualified object name Required, Positional 2
Qualifier 1: Job queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
Top

Subsystem description (SBSD)

Specifies the name and library of the subsystem description from which the job queue entry is removed.

This is a required parameter.

Qualifier 1: Subsystem description

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

Note: The following IBM-supplied objects are not valid on this parameter:

  • QSYSSBSD

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 where the subsystem description is located.
Top

Job queue entry job queue (JOBQ)

Specifies the name and library of the job queue that has its job queue entry removed from the subsystem description.

This is a required parameter.

Qualifier 1: Job queue

name
Specifies the name of the job queue for the entry that 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 library where the job queue is located.
Top

Examples 

RMVJOBQE   SBSD(MYLIB/NIGHTRUN)  JOBQ(MYLIB/BATCH2)

This command removes the job queue entry that refers to the BATCH2 job queue in MYLIB from the NIGHTRUN subsystem description stored in library MYLIB.

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