SP.ASSIGN

SP.ASSIGN

Top  Previous  Next

 

The SP.ASSIGN command uses a form queue number to set the destination and other options for printer output.

 

 

Format

 

SP.ASSIGN {options}

 

where options are chosen from:

 

nis the number of copies to print.

 

Fqnospecifies the form queue number in the range 0 to 999.

 

Hdirects output to the hold file.

 

Okeeps the print unit open until the PRINTER CLOSE command is used.

 

QqnoSame as Fqno.

 

Runituses the specified print unit, zero if omitted.

 

SSuppresses printing.

 

 

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.

 

If then $SETPTR.DEFAULTS record exists (see SETPTR), the default options are applied at the point when the SP.ASSIGN command is used.

 

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.

 

 

See also:

Printing, SETPTR, SET.QUEUE