Specify Job Initial Priority

$priority tosend [smallthresh>tosends [mediumthresh>tosendm]]
$priority tosend [firstthresh>tosendf [nextthresh>tosendn]] LISTPOS

This command is used to specify the priority of a job, and optional override priorities either for jobs of different sizes or as the job is launched. It causes the FS files created when the job is launched to be written in the matching TOSEND directory.  The TOSEND folders selected must be members of the Job TOSEND Folder Set.  This set defaults to TOSEND1 up to the smaller of 15 and the number specified on the $request_dir configuration command.  To use higher-numbered TOSEND folders you must first define a $job_tosend_set using this UJP command.

This command is used to specify priorities for all types of job items, unless $email_priority is specified in the job instance.

The first form of the command specifies the priority for all job items, based on the size of the job.  The second form of the command, when the keyword LISTPOS is present, varies the priority of job items, based on their position in the job list(s).

The parameters on this command are used as follows:

tosend The default TOSEND number.
 
smallthreshA job size threshold: jobs of this size or smaller will use the tosends priority value, not  the default.
tosendsThe TOSEND number for jobs of size equal to or below the smallthresh value.
mediumthreshA job size threshold: jobs of this size or smaller, but larger than the smallthresh value, will use the tosendm priority value, not the default.  If this number is smaller than the smallthresh value, it will have no effect.
tosendmThe TOSEND number for jobs of size greater than the smallthresh value and equal to or below the mediumthresh value.
 
firstthreshA job position threshold: for the first items of the job, up to an including this number, the tosendf priority value will be used, not the default.
tosendfThe TOSEND priority number for the first firstthresh items in the job.
nextthreshA job position threshold: for the next items of the job, up to an including this number, the tosendn priority value will be used, not the default.
tosendnThe TOSEND priority number for the next nextthresh items in the job.

In a job instance UJP, the second parameters on this command will be automatically created from the SMALL_JOB_THRESHOLD and SMALL_JOB_PRIORITY defined in an System, Owner or Jobtype UJP file which does not contain a $priority command with more than one parameter.  These variables are ignored when a $priority command with more than one parameter is present in the same file.  JOBADMIN will delete the variables on updating such a UJP and replace them with an enhanced $priority command.  In System, Owner and Jobtype UJP files, the entire $priority command from jobtype properties overrides that from owner propeties, which overrides that from system properties.

A value of 0 in the tosendx parameter indicates that there is to be no special priority.  The corresponding threshold value may be set for use by $email_priority.

The parameters on this command after the first are accepted (and ignored) by CopiaFacts build 8.1, starting at build 8.1.0.139.

Default: none (required command)

Example:

$priority 3

$priority 3 100>4 LISTPOS

$priority 3 20>4 500>5