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:
- 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.
- 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 IBM-supplied object QSYSSBSD is not valid on this parameter.
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 |