SP.ASSIGN
SP.ASSIGN |
|
|
The SP.ASSIGN command uses a form queue number to set the destination and other options for printer output.
Format
SP.ASSIGN {options} {, setptr.options}
where options are chosen from:
The SP.ASSIGN command references the $FORMS file (set up using SET.QUEUE) to relate Pick style form queue numbers to the corresponding SETPTR options. The options to SP.ASSIGN can be used to override the settings in the form queue definition.
The Fqno or Qqno options specify the form queue to be used. This defaults to zero if omitted.
The queue number is used to read the corresponding print unit details from the $FORMS file. The remaining options can be used to override settings in the $FORMS entry.
Use of both the H and S options selects mode 3 printing, directing output to the hold file. When the H option is used without the S option, print mode 6 is selected causing the output to be written to a file and also printed.
SP.ASSIGN sets the characteristics of print unit zero, the default printer, unless the Runit option is given.
If no options are given, the SP.ASSIGN command shows the form queue number associated with the default print unit and the settings of this printer. This is equivalent to the SP-ASSIGN ? command in Pick style systems.
If the $SETPTR.DEFAULTS record exists (see SETPTR), the default options are applied at the point when the SP.ASSIGN command is used.
The setptr.options clause can be used to specify additional SETPTR options that are to be applied to the selected form queue. A comma is required before this clause and between each SETPTR option.
Note: SP.ASSIGN is provided to ease migration of applications from Pick style environments. It is strongly recommended that new applications should make direct use of SETPTR.
Examples
SP.ASSIGN F3 This command uses the definition of form queue 3 to process output sent to the default printer (print unit 0).
SP.ASSIGN HSF3 This command uses the definition of form queue 3 but forces use of print mode 3 to send the data to a file.
SP.ASSIGN HF3 This is similar to the previous example except that the data is saved to a file and also printed.
SP.ASSIGN 2R4F6 This command uses the definition of form queue 6 to process output sent to print unit 4 but forces the number of copies to be 2.
SP.ASSIGN F3,BANNER "Sales" This command uses the definition of form queue 3 but also includes the BANNER option to set the banner page text.
See also: |