job.html #1

<TITLE>Working with Jobs</TITLE> 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?help">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?help">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?help">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?help">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?help#bookmarks">bookmark</A> the page.