Start Prestart Jobs (STRPJ)
| Where allowed to run: All environments (*ALL) Threadsafe: Yes |
Parameters Examples Error messages |
The Start Prestart Jobs (STRPJ) command starts jobs for a prestart job entry in an active subsystem when there are no currently active prestart jobs for the prestart job entry.
This command is valid after an ENDPJ command is complete, or when all prestart jobs have been ended by the system due to an error or were never started during subsystem start up due to STRJOBS (*NO) on the ADDPJE command. The number of jobs started is determined by the INLJOBS value on the prestart job entry.
Restrictions:
- To use this command, you must have:
- job control (*JOBCTL) special authority.
- use (*USE) authority to the subsystem description.
- use (*USE) authority to the program and execute (*EXECUTE) authority to the library that contains the program.
- use (*USE) authority to all auxiliary storage pool (ASP) device descriptions in the ASP group if the subsystem description specifies an ASP group.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SBS | Subsystem | Name | Required, Positional 1 |
| PGM | Program | Qualified object name | Required, Positional 2 |
| Qualifier 1: Program | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB |
| Top |
Subsystem (SBS)
Specifies the name of the active subsystem that contains the prestart job entry.
This is a required parameter.
- name
- Specify the name of the active subsystem that contains the prestart job entry.
| Top |
Program (PGM)
Specifies the name of the program that identifies the prestart job entry. This program name is used to match an incoming request.
This is a required parameter.
Qualifier 1: Program
- name
- Specify the name of the program that identifies the prestart job entry.
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 name of the program's library.
| Top |
Examples
STRPJ SBS(SBS1) PGM(PJLIB/PJPGM)
This command starts prestart jobs for prestart job entry PJPGM in subsystem SBS1. Subsystem SBS1 must be active when this command is issued. The number of jobs started is the number specified in the INLJOBS value of prestart job entry PJPGM. The subsystem starts program PJPGM in library PJLIB.
| Top |
Error messages
*ESCAPE Messages
- CPF0921
- Start Prestart Jobs command not allowed now.
- CPF101C
- Not authorized to device &1.
- CPF1226
- Start prestart jobs failed.
- CPF1227
- No authority has been granted to use command.
- CPF1317
- No response from subsystem for job &3/&2/&1.
- CPF1351
- Function check occurred in subsystem for job &3/&2/&1.
- CPF1834
- Prestart job entry for program &1 in &2 does not exist.
- CPF1835
- Not authorized to subsystem description.
- CPF9810
- Library &1 not found.
- CPF9811
- Program &1 in library &2 not found.
- CPF9820
- Not authorized to use library &1.
- CPF9821
- Not authorized to program &1 in library &2.
| Top |