Display Active Prestart Jobs (DSPACTPJ)
Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
The QSYS2.PRESTART_JOB_STATISTICS table function returns similar information.
Restrictions:
- 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.
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 | ||
OUTPUT | Output | Optional |
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 active prestart job entry.
Top |
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.
Top |
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.
- The output is printed with the job's spooled output.
Top |
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.
Top |
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.
Top |