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 Specs>New>Job and fill in the Job form. Note that 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 Specs pane to the Jobs field of the changelist.The job is closed when you submit the changelist with which it is associated.
To limit the jobs that are visible to you, click Set JobView and enter the expressions specifying how you want the list to be filtered.
To filter the list of jobs displayed, enter a filter expression in the field above the list of jobs. To make the filter part of your Perforce user definition (so that you never view jobs that do not fulfill the filter criteria), click Set JobView. (To clear the job view from your user definition, clear the filter window and click Set Jobview, or edit the user specification.)
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. |