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:

  1. To use this command, you must have:
    • job control (*JOBCTL) special authority.
    • use (*USE) authority to the subsystem description.
    • execute (*EXECUTE) authority to the library that contains the program.
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.
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