<HTML><HEAD><TITLE>P4Web User Guide - Working with Jobs</TITLE></HEAD><BODY><FONT SIZE=-1><B>P4Web Release 2012.1 User Guide</B></FONT><BR> A <i>job</i> is a description of a task. Jobs provide a method of keeping track
<FONT SIZE=-1><B><A HREF="quickstart.html">[Getting Started]</A> <A HREF="howto.html">[How To...]</A> <A HREF="tips.html">[Browser Tips]</A> <A HREF="defs.html">[Glossary]</A> <A HREF="roadmap.html">[Road Map]</A> </B></FONT><BR>
<H3>Working with Jobs</H3> A <i>job</i> is a description of a task. Jobs provide a method of keeping track
of information, such as what changes to the source are needed, which user is responsible
for implementing the job, and which file revisions contain the implementation
of the job.
<p> The type of information tracked by the jobs system can be customized, using
the <A HREF=
"jobfields.html">jobspec</a>. Fields in the jobspec form can be added, changed,
and deleted by Perforce superusers, using the Perforce command-line client.
<p> Using <A HREF="editpending.html">changelists</a>, you can associate files
with jobs, so that you can see which files were revised while working on a particular
job. For instance, if a job involves fixing a bug, and several files were changed
during that fix, you can refer to that job later to see which files were changed.
<p>
See <A HREF="editjob.html">Creating and Editing Jobs</a> for additional information.
<P>
<b>Accessing jobs</b>
<P> Click the <b>Jobs</b> tab to access jobs by name. Click on any job in the
list to see more information about that job. While you are viewing a specific
job, the <b>Action</b> menu at the top of the page has these additional options:
<ul>
<li><b>View fixes for job:</b> Lists any changelists that contain <i>fixes</i>
for this job. A "fix" means that the job has been completed.
<li><b>View field descriptions:</b> Displays details about the individual fields
in the Jobs list. For more information, see <A
HREF="jobfields.html">Job Field Descriptions</A>.
</ul>
<p><b>Fixing jobs</b>
<p>To fix a job (that is, change its status), you attach it to a changelist, to
indicate that the files submitted in the changelist contain the changes required
to complete the work required by the job. If you attach a job to a pending changelist,
the job is fixed when you submit the changelist. If you attach a job to a submitted
changelist, the job status is changed immediately.
<p>To fix a job:</p>
<ul>
<ol type=1>
<li>Browse to the pending or submitted changelist page.</li>
<li>Click the link to the changelist that fixes the job. The changelist is
displayed.</li>
<li>From the dropdown list, choose <b>Add Job to Changelist...</b> A list
of open jobs is displayed.</li>
<li>Click the job you want to fix. The changelist is redisplayed, listing
the selected job.</li>
<li>Click <b>Add Jobs</b>. </li>
<li>Optional: select the desired job status from the dropdown list below the
job list.</li>
</ol>
</ul>
<p><b>Customizing the Jobs view</b>
<p>
You can customize your view of the Jobs page by using the constraints listed at the top of the
page next to the <b>Filter</b> button. You
can customize the following options:
<ul>
<li> The list is sorted alphabetically. To choose the sort order, click <b>
highest</b> or <b>lowest</b>.
<p>
<li>To specify the number of jobs that you see in the Jobs list, enter the desired
number in the <b> jobs</b> text box.
<p>
<li>To see only the jobs that are fixed by edits to files in a specified path:
<ol type=1>
<li>Navigate to the desired path. <br>
<li>Click the <b>Jobs</b> tab. <br>
<li>On the Jobs list, check the <b>if fixed in this path</b> checkbox. <p>
</ol>
<li>To include jobs whose files have been integrated into files in this path,
check the <b>including integrated files</b> checkbox.
<p>
<li>You can limit your view of jobs to those that match particular criteria
using <b>Jobview</b>.
<p>
<li>To specify the fields displayed in the list of jobs, click the triangle at the top left corner of the table and check the desired fields. If Javascript is disabled,
select the
desired fields from the <b>Visible Fields</b> list. To select more than one field in this list, hold down the Ctrl key while
selecting the desired fields. To select several fields concurrently, hold down the Shift key while
selecting.
</ul>
<p> To save your preferences, <A HREF=
"tips.html#bookmarks">bookmark</A> the page.
<P>
<HR>
<FONT SIZE=-1><I>
Copyright 2012 <A HREF="http://www.perforce.com">Perforce Software</A>.
All rights reserved.
</I></FONT>
</BODY></HTML>