Defines a formqueue, spooler options and number of copies to be used by subsequent print reports.



SP-ASSIGN {{n}=formqueue} {options} {copies}



n defines the print report channel to be assigned in the range 0 to 127. The default value for n is zero. If a print report channel is specified a formqueue must also be specified.

0 is the default print report channel number. jBASE processors like jQL and jCL produce print reports on print channel zero. The default PRINT statement will also direct output to print report channel zero.

Print report channels 1-127 can be assigned by the SP-ASSIGN command and used within jBASE programs to direct output to separate print reports simultaneously by using the PRINT ON statement.

Print report channels 128-254 are reserved. Print report channel 255 is reserved for log reporting by the jBASE Background Task Processor, jBTP.

formqueue defines the name of the formqueue to which print jobs are queued. The default formqueue is STANDARD.

options define the spooler assignment options which will be assigned to the subsequent print jobs when queued to the formqueue:

? displays current assignment.
A Align. Suspends despooling from the formqueue, so that the print job can be aligned for special forms. For example, printing checks. Each subsequent print job will exhibit the ALIGN status. Use the SP-ALIGN command or the align option on the SP-JOBS menu.
C Choke. For LPTR and TAPE type formqueues only. Limits the amount of buffered data created before output to the device. The I option is automatically invoked.
Fn assigns specific form queue number n. Only valid if an equals sign (=), is not present in the command line.
H  Hold. The H option retains a copy of the spooled print job, which can be re-output later. This option can be used with the S option to produce a report for output when demand for a printing resource is not so high. Use SP-EDIT with the SP or the SPA commands, or the edit option on the SP-JOBS menu to output the hold file.
I Instant. For LPTR and TAPE type formqueues only. The print job will be despooled without waiting for the print job to be closed first. The SP-SUSPEND command can be used to suspend despooling of a job which was invoked with the I option but will not be able to recover any previously output data.
M Suppresses the "Entry #" message when a Hold job is generated.
O Open a global print job. Keeps the print job open when exiting to the shell or jCL. This option enables several print reports to be grouped as one print job.
P Protected (default). The P option protects the print job from being moved, edited, deleted or cleared, except by root or a user with the same user id as the user who created the print job. Once assigned this option cannot be changed.
Rn assigns specific report number n. Only valid if an equals sign (=), is not present in the command line.
S Suppress. Defeats automatic output when the job is closed. If you only specify the S option, no print job is created.
U Unprotected. Allows print jobs to be moved, edited, deleted or cleared by any user. Once assigned this option cannot be changed.

copies defines to number of copies of the print report data are required to be output.



The following combinations of spooler options are incompatible.

Option Incompatible with
C H and S
F "=" modifier
I S and copies
R "=" modifier
S I and C
copies I

Options I or C cannot be assigned to logical PROG device type formqueues.

This error message will be displayed if any illegal combinations are attempted:




The default spooler assignment takes effect if the SP-ASSIGN command is executed without parameters. The default assignment is print report channel zero, formqueue STANDARD, spooler options P and number of copies set to one. This is also the default spooler assignment after log on.

The options assigned using the SP-ASSIGN command remain in effect until the SP-ASSIGN command is re-executed for the same print report channel or the user logs off.

Assignment information about each print report channel is held in the spooler assignment table and can be displayed by using the SP-LOOK command.

jBASE provides the ability to produce a banner page at the start of the print job with the SETPTR command. The implementation of the SETPTR command on jBASE is limited to providing the functionality of:

SETPTR {channel},,,,,,BANNER 'Some user text'

SP-ASSIGN will close any previously open global print jobs as well as clear any banner text assigned with the SETPTR command.