SP-ASSIGN - Assigning Print Report Characteristics

Assigns the following parameters to a particular print report number:

• Formqueue to schedule print jobs.
• Job file to hold the print data.
• Name used to form the job-id.
• Spooler characteristics (options) for the specified formqueue.
• Number of copies to be printed.

Syntax

SP-ASSIGN {{report-no} =form-queue-name} {FILE=job-file} {NAME=job-name} {spooler-options} {copies}

Syntax elements

Print Job Id - job-name seq-no

Restrictions on options

The following combinations of Spooler options are incompatible and therefore cannot be assigned together.

In addition, the I and N options cannot be assigned to SYS type formqueues.

Any attempt to enter one of the above combinations returns the error message:

INCOMPATIBLE OPTIONS: N A/H/S/O, I S, C NOT I, COPIES N/I

If you enter SP-ASSIGN without specifying the report number, all assigned report numbers, including '0' are unassigned; all open print jobs are closed; all report numbers, now unassigned, use the default assignment parameters.

Initial default assignment

When you first log on, the following system reset parameters are assigned to all print reports.

This is the initial default assignment used by all unassigned report numbers. System reset assignments are discussed further in Overview of Spooler Operation.

Changing the default assignment

If you enter SP-ASSIGN without a report number, but with one or more other parameters specified, then the values given to SP-ASSIGN are applied to the default assignment parameters. You can also redefine the default job file assignment from the FORM.QUEUES File Maintenance menu. See Spooling System Maintenance. All unassigned print report numbers will use the revised default assignment.

Changing assignments

The assignment set by SP-ASSIGN for a specified report number remains in effect until another SP-ASSIGN for that particular report number is executed, or until you log off.

Displaying current assignments

Assignment information for each print report number is held in a process's Spooler assignment table. This can be displayed using the SP-LOOK command.

Example 1

To assign the system reset parameters as the default assignment for all print report numbers, enter:

SP-ASSIGN

This also closes any print jobs that are currently open.

Example 2

To assign print jobs for all print report numbers to the formqueue "LASER" with all other parameters set to their system reset values, enter:

SP-ASSIGN =LASER

Example 3

To assign print jobs for print report number 10 to the formqueue "LASER" with all other parameters set to their system reset values, enter:

SP-ASSIGN 10 =LASER

Example 4

To assign print jobs for all print report numbers to the formqueue "LASER" and specify options to suppress printing, but keeping jobs on hold, enter:

SP-ASSIGN =LASER NAME=DAVE HS

Job-ids will be of the form DAVE, DAVE0001, DAVE0002, and so on. Print data is stored in the default job file SPOOL.JOBS and the number of copies of each job printed will be '1'.

When you initiate a print report,

LIST DEPT 'NAMES' (P

an entry number for the report is displayed, similar to the following:

Print Job Id - DAVE

The next print report:

CP MD MD

will display the message:

Print Job Id - DAVE0001

 You can output jobs held in LASER using SP-JOBS Action Code 8 or SP-EDIT.

Example 5

To set up your default formqueue and two specific print report assignments, enter:

SP-ASSIGN =INVOICE

followed by

SP-ASSIGN 4 =CHECK H

then

SP-ASSIGN 7 =STANDARD 2

The first SP-ASSIGN statement assigns the formqueue named INVOICE, with no special options, as the default for all print report numbers. The Spooler will output one copy of any print job generated without a specific report number.

The second SP-ASSIGN statement assigns the formqueue named CHECK with the H option to print report number 4. The Spooler will output one copy of each print job with report number 4 and hold a copy in the formqueue.

The third SP-ASSIGN statement assigns the STANDARD formqueue with no special options to print report number 7. The Spooler will output two copies of any print job with report number 7.

Note that the order in which the SP-ASSIGN statements are entered is important. For example if you enter them in the order:

SP-ASSIGN 4 =CHECK H
SP-ASSIGN 7 =STANDARD 2
SP-ASSIGN   =INVOICE

The first two statements set up the assignments as before, but the third statement unassigns all report numbers, nullifying the effect of the first two statements.

Example 6

To assign print jobs for print report 0 to the formqueue "MEMOS", with options set to suppress printing, with print jobs on hold and also, to store print data in the MEMO.JOBS file with job-ids starting with job name MEMO, enter:

SP-ASSIGN 0 =MEMOS FILE=MEMO.JOBS NAME=MEMO HS