Specify Job Initial Priority for E-Mail Items

$email_priority tosend [tosends [tosendm]]
$email_priority tosend [tosendf [tosendn]]

This command is used to specify the priority for the e-mail items 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 the priorities for e-mail items in a mixed-type broadcast.  To use the second and third parameters a $priority command is required in the same UJP file to define the threshold values.

In an e-mail only broadcast (broadcast type EB) you must use the $priority command, not this command.

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 on an accompanying $priority command, 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.
tosendsThe TOSEND number for jobs of size equal to or below the smallthresh value (specified on a $priority command in the same file).
tosendmThe TOSEND number for jobs of size greater than the smallthresh value and equal to or below the mediumthresh value (thresholds specified on a $priority command in the same file).
tosendfThe TOSEND priority number for the first firstthresh items in the job (specified on a $priority command in the same file).
tosendnThe TOSEND priority number for the next nextthresh items in the job (specified on a $priority command in the same file).

In a job instance UJP, the second parameter on this command will be automatically created from the SMALL_JOB_EMAIL_PRIORITY defined in an System, Owner or Jobtype UJP file which does not contain an $email_priority command with more than one parameter.  The variable is ignored when an $email_priority command with more than one parameter is present in the same file.  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.

The LISTPOS keyword (as for $priority) may be specified on the second form of the command, but will be ignored.

This command is accepted (and ignored) by CopiaFacts build 8.1, starting at build 8.1.0.139.

Default: if not specified, the e-mail items in the job will be processed as specified by $priority.

Example:

$email_priority 3