The p4 jobspec command presents the Perforce administrator with a form in which job fields can be edited, created, deleted, and refined.
Do not confuse the names of the fields in the p4 jobspec form with the names of the fields within a job. The fields in the
p4 jobspec form are used to store information
about the fields in the
p4 jobs form.
|
|
|
•
|
code: a unique integer that identifies the field internally to Perforce. The code must be between 106 and 199. Codes 101 to 105 are reserved for Perforce use; see the Usage Notes below for more details.
|
•
|
name: the name of the field. This can be changed at any time, while the code should not change once jobs have been created.
|
•
|
datatype: the datatype of the field. Possible values are:
|
•
|
word: a single arbitrary word (a string with no spaces)
|
•
|
select: one of a fixed set of words
|
•
|
text: a block of text, starting on the line underneath the fieldname.
|
•
|
bulk: like text, but not indexed for searching with p4 jobs -e.
|
|
|
•
|
length: recommended length for display boxes in GUI clients accessing this field. Use a value of 0 to let a Perforce client program choose its own value.
|
•
|
persistence: does the field have a default value? Is it required? Is it read-only? Possible values are:
|
•
|
optional: field can take any value or be erased.
|
•
|
default: a default value is provided; it can be changed or erased.
|
•
|
required: a default value is provided; it can be changed but the user must enter a value.
|
•
|
once: read-only; the field value is set once to a default value and is never changed.
|
•
|
always: read-only; the field's value is set to a new default when the job is edited. This is useful only with the $now and $user variables; it allows you to change the date a job was modified and the name of the modifying user.
|
|
|
Enter one line for each field of datatype select. Each line must contain the fieldname, a space, and the list of acceptable values separated by slashes. For example:
|
|
•
|
$user: the user who created the job
|
•
|
$blank: the phrase <enter description here>
|
See the Usage Notes below for special considerations for field 102.
|
|
Textual comments that appear at the top of each p4 job form. Each line must begin with the comment character #.
See the Usage Notes below for special considerations for these comments if your users need to enter jobs through P4V, the Perforce Visual Client.
|
Fields 102 through 105 are reserved for use by Perforce client programs. Although it is possible to rename or delete these fields, it is highly undesirable to do so. Perforce client programs may continue to set the value of field 102 (the
Status: field) to
closed (or some other value defined in the
Presets: for field 102) upon changelist submission, even if the administrator has redefined field 102 to for use as a field that does not contain
closed as a permissible value, leading to unpredictable and confusing results.