Managing jobs

Jobs enable you to record requests for work. You can associate jobs with changelists, to track the work done to fulfill the request; when the changelist is submitted, the job can be closed. Jobs are displayed on the Jobs tab of the Specs window.

To create a job, choose File>New>Job and fill in the Job form. You can customize the job form. See the Perforce System Administrator's Guide for details.

To add a fix to a pending changelist: drag the job from the Jobs tab of the right pane to the Jobs field of the changelist. You can also use the Link jobs to changelist field in the Submit dialog. Specify the job status upon submitting the changelist.

To specify the columns displayed in the Jobs list view: context-click in the column heading and enable or disable the desired columns. To change the order in which columns are displayed, drag the column headings right or left to the desired position.

To filter the list of jobs displayed, enter a filter expression in the field above the list of jobs.

Valid job filtering expressions are as follows:

Syntax Description Example
word word word Words separated by spaces indicate that the job must contain all the words in the string in any of the job fields to be included in the filter.

filter file mailbox

Displays jobs containing all the words "filter", "file" and "mailbox" in any of the job fields.

word | word | word Displays jobs that contain any of the specified words.

filter|file|mailbox

Displays jobs containing the words "filter", "file" or "mailbox.

^word Displays jobs that do not contain the specified word. The 'not' (^) operator cannot be used alone or with the 'or' operator (|), only with the 'and' operator (& or space).

filter ^file

Displays jobs that contain "filter" and do not contain "file".

fieldname=value Displays jobs that include the specified value in the specified field.

status=openowner=edk

Displays open jobs owned by edk.

^fieldname=value Displays jobs that do not include the specified value in the specified field. The 'not' (^) operator cannot be used alone or with the 'or' operator (|), only with the 'and' operator (& or space).

^status=closed& subsystem=parser

Displays unclosed jobs affecting the parser subsystem.

fieldname = value+* Displays jobs that contain the specified value in the specified field, including any combination of characters in the position of the asterisk wildcard.

owner=**ed*

Displays jobs in which the value of field "owner" contains the substring "ed," including such values as "Ted," "Edk," and "Fred".

yyyy/mm/dd[:hh:mm:ss] Displays jobs that contain the specified date, where "yyyy" is the year expressed in four-digit format and "mm", "dd", "hh", "mm" and "ss" are the month, day, hour, minute and second, respectively, expressed in two-digit format. .

2000/02/12:08:30:00

Displays jobs that contain the date February 12, 2000, 8:30 am.