Display Active Prestart Jobs (DSPACTPJ)

The Display Active Prestart Jobs (DSPACTPJ) command displays statistics and performance information for active prestart jobs associated with a prestart job entry in an active subsystem.

Information on the display is collected from the time the reset key is pressed or from the time the prestart job entry is started. The prestart job entry is either started when the subsystem starts or when the Start Prestart Jobs (STRPJ) command is used. Values that are averages are based on calculations involving time intervals and become inaccurate if the system clock is changed.

Start of change

The QSYS2.PRESTART_JOB_STATISTICS table function returns similar information.

End of change

Restrictions:

  1. To use this command, you must have:
    • 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.

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
OUTPUT Output *, *PRINT Optional

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 active prestart job entry.

Program (PGM)

Specifies the program that identifies the active prestart job entry.

This is a required parameter.

Qualifier 1: Program

name
Specify the name of the program.

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 program is located.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*
The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.
*PRINT
The output is printed with the job's spooled output.

Examples

Example 1: Displaying Job Information

DSPACTPJ   SBS(PJSBS)  PGM(QGPL/PGM1)

This command displays information for the prestart job entry in subsystem PJSBS with program PGM1 in the QGPL library.

Example 2: Printing Job Information

DSPACTPJ   SBS(PJSBS)  PGM(QGPL/PGM2)  OUTPUT(*PRINT)

This command prints active prestart job information for the prestart job entry in the active subsystem PJSBS with program PGM2 in the QGPL library.

Error messages

*ESCAPE Messages

CPF101C
Not authorized to device &1.
CPF1317
No response from subsystem for job &3/&2/&1.
CPF1351
Function check occurred in subsystem for job &3/&2/&1.
CPF1833
Display Active Prestart Job command is not currently allowed.
CPF1834
Prestart job entry for program &1 in &2 does not exist.
CPF9801
Object &2 in library &3 not found.
CPF9810
Library &1 not found.
CPF9820
Not authorized to use library &1.
CPF9871
Error occurred while processing.