p4 job

Synopsis

Syntax

Description

Jobs are similar to changelist descriptions in that they both describe changes to the system as arbitrary text, but whereas changelist descriptions describe completed work, jobs tell developers what work needs to be done.

Jobs are created and edited in forms displayed by p4 job. The user enters the textual description of the job into the form, along with information such as the severity of the bug, the developer to whom the bug is assigned, and so on. Since the Perforce superuser can change the fields in the job form with p4 jobspec, the fields that make up a job may vary from one Perforce server to another.

When p4 job is called with no arguments, a new job named jobNNNNNN is created, where NNNNNN is a sequential six-digit number. You can change the job's name within the form before quitting the editor. If p4 job is called with a jobname argument, a job of that name is created; if that job already exists, it is edited.

Once a job has been created, you can link the job to the changelist(s) that fix the job with p4 fix, p4 change, or p4 submit. When a job is linked to a changelist, under most circumstances the job's status is set to closed. (See the Usage Notes below for more information).

Form Fields

Options

-d jobname	Delete job jobname.
-f	Force flag. Allows Perforce administrators to edit read-only fields.
-i	Read the job form from standard input without invoking an editor.
-o	Write the job form to standard output without invoking an editor.
g-opts	See the Global Options section.

Usage Notes

Can File Arguments Use Revision Specifier?	Can File Arguments Use Revision Range?	Minimal Access Level Required
N/A	N/A	open

• If the Perforce superuser has eliminated field ID# 102 (the Status: field) with p4 jobspec, Perforce is unable to close jobs when the changelists to which they are linked are submitted. Please see the p4 jobspec page and the Perforce System Administrator's Guide for more information.

• After a job has been created or changed, Perforce indexes the job so that p4 jobs -e can locate the job quickly. The index keys are word, fieldname where word is a case-insensitive alphanumeric word. Values in date fields are stored as the number of seconds since January 1, 1970, 00:00:00.

Examples

p4 job	Create a new job; by default, its name is of the form jobNNNNNN.
p4 job job000135	Edit job job000135.

Related Commands

To list all jobs, or a subset of jobs	p4 jobs
To attach a job to an existing changelist	p4 fix
To view a list of connections between jobs and changelists	p4 fixes
To add or delete a job from a pending changelist	p4 change
To change the format of jobs at your site (superuser only)	p4 jobspec
To read information about the format of jobs at your site	p4 jobspec -o