Work with User Jobs (WRKUSRJOB)

Where allowed to run: All environments (*ALL) Threadsafe: No

Parameters Examples Error messages

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

Top

---

 

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.

Top

 

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.

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.

*PRINT

The output is printed with the job's spooled output.

Top

 

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.

Top

 

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.

Top

---

 

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.

Top

---

 

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.

Top