Work with User Jobs (WRKUSRJOB)

The Work with User Jobs (WRKUSRJOB) command allows you to work with a list of selected user jobs.

Depending on the values you specify on the STATUS, ASTLVL, and JOBTYPE parameters, you can use this command to perform the following tasks:

From the Work with Signed-On Users display, you can select options to send messages to or sign off users who are signed on the system. You can also select options to display messages or display details about signed-on users. To show the Work with Signed-On Users display, specify STATUS(*ACTIVE), ASTLVL(*BASIC), and JOBTYPE(*INTERACT).
From the Work with Jobs display, you can show the status of all batch jobs on the system. You can select options to hold, end, or release the jobs shown. You can also select options to work with printer output or display messages. To show the Work with Jobs display, specify any value for the STATUS parameter, ASTLVL(*BASIC), and JOBTYPE(*BATCH).
From the Work with User Jobs display, you can show the status of user jobs running on the system and of user jobs that are on job queues or output queues. You can select options to change, hold, end, work with, release, or disconnect the jobs shown. You can also select options to work with spooled files and display messages. To show the Work with User Jobs display, specify one of the following:
- ASTLVL(*INTERMED) and any value for the STATUS and JOBTYPE parameters
- ASTLVL(*BASIC), JOBTYPE(*INTERACT), and either STATUS(*ALL), STATUS(*JOBQ), or STATUS(*OUTQ)
- ASTLVL(*BASIC), JOBTYPE(*ALL), and any value for the STATUS parameter

Parameters

Keyword	Description	Choices	Notes
USER	User whose jobs to display	Name, , ALL	Optional, Positional 1
STATUS	Status of user jobs	ALL, ACTIVE, JOBQ, OUTQ	Optional, Positional 2
OUTPUT	Output	, PRINT	Optional, Positional 3
JOBTYPE	Job type	ALL, INTERACT, *BATCH	Optional
ASTLVL	Assistance level	PRV, USRPRF, BASIC, INTERMED	Optional

Top

User whose jobs to display (USER)

This parameter allows you to work with user jobs defined by the user profile which initiated the job. User jobs include interactive jobs, submitted batch jobs, communications-evoked batch jobs, MRT batch jobs, and autostart jobs. User jobs do not include system jobs, subsystem monitor jobs, spooling readers, or spooling writers.

*: User jobs with the current user profile are displayed.
*ALL: User jobs with all user profiles are displayed.
user-profile name: Specify the name of a user profile. User jobs with the specified user profile are shown.

Status of user jobs (STATUS)

Specifies the status of the user jobs being worked with.

*ALL: User jobs of any status are displayed, including jobs on job queues, active jobs, and jobs on output queues.
*JOBQ: Only user jobs that are on job queues are displayed.
*ACTIVE: Only user jobs that are active are displayed, including all group jobs and system request jobs. You must specify STATUS(*ACTIVE) to show the Work with Signed-On Users display.
*OUTQ: Only user jobs that have completed running but still have output on an output queue, are displayed.

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.

Job type (JOBTYPE)

Specifies the type of the user jobs shown.

*ALL: All types of user jobs are shown, including interactive jobs and batch jobs. If JOBTYPE(*ALL) is specified, the ASTLVL parameter is ignored.
*INTERACT: Only interactive user jobs are shown. You must specify JOBTYPE(*INTERACT) to show the Work with Signed-On Users display. If you also specify ASTLVL(*BASIC), interactive jobs shown include suspended group jobs and signed-off users with printer output waiting to print.
*BATCH: Only batch user jobs are shown, including prestart jobs, batch immediate jobs, and 36EE MRT jobs. You must specify JOBTYPE(*BATCH) to show the Work with Jobs display.

Assistance level (ASTLVL)

Specifies which user interface to use.

*PRV: The previous user interface is used.
*USRPRF: The user interface specified for the Assistance level (ASTLVL) parameter of your user profile is used. If *ADVANCED is specified in the user profile, *INTERMED is used.
*BASIC: The Operational Assistant user interface is used.
*INTERMED: The system user interface is used.

Examples

Example 1: Working with a List of Selected Jobs

WRKUSRJOB   USER(PGMR12)

This command allows you to work with a list of jobs that are running with the user profile name PGMR12.

Example 2: Working with a List of All Jobs

WRKUSRJOB   USER(*ALL)  STATUS(*JOBQ)

This command allows you to work with a list of all the jobs on job queues.

Example 3: Working with a List of Interactive Jobs

WRKUSRJOB   USER(*ALL)  STATUS(*ACTIVE)
            JOBTYPE(*INTERACT)  ASTLVL(*BASIC)

This command allows you to work with a list of signed-on users that includes signed-off users with printer output and suspended interactive group jobs.

Error messages

*ESCAPE Messages

CPF1E50: Not all jobs displayed.
CPF1E51: Job queue &1 in library &2 not found.
CPF1E99: Unexpected error occurred.
CPF1003: Subsystem &1 not active.
CPF9845: Error occurred while opening file &1.
CPF9846: Error while processing file &1 in library &2.
CPF9847: Error occurred while closing file &1 in library &2.
CPF9850: Override of printer file &1 not allowed.
CPF9851: Overflow value for file &1 in &2 too small.
CPF9871: Error occurred while processing.