Operating System BS2000 OS DX V1.0 (en)

&pagelevel(3)&pagelevel

Assign tape devices for spoolout jobs

Component:	SPOOL
Functional area:	Controlling spoolout job
Domain:	SPOOL-PRINT-ADMINISTRATION
Privileges:	OPERATING PRINT-SERVICE-ADMINISTRATION
Routing code:	S

Function

The START-TAPE-OUTPUT command assigns tape devices for spoolout jobs.

Notes

SPOOL uses the first volume label to form the name of a directory file (SR.vsn). This file contains all the jobs needed to process the replay tape. When the replay tape has been generated the directory file is copied to the tape so that the tape can be exported to another computer center. Once the replay tape has been exported, the directory file can be deleted from the disk.
While a replay tape is being generated, systems support staff can use the MODIFY-TAPE-OUTPUT-STATUS command to change the selection criteria for the spoolout jobs to be output. The volume labels must not be modified.
During the generation of a replay tape, a catalog entry is created for the TP.tsn file (tsn = task sequence number of the spoolout job). This entry is temporary and is deleted when the STOP-TAPE-OUTPUT command has been processed. Systems support staff should check before processing starts that no file with this name already exists.
Replay tapes can only be processed in other computer centers if these computer centers have implemented the same version of SPOOL.
To execute a spoolout request for a tape, all the scheduling operands must apply to the device. If this is not the case, the spoolout request remains in the queue.
If no scheduling operands are specified, any spoolout for a specified device can be executed. If, however, scheduling operands are specified, only spoolout requests which match all the specifications can be executed.
The hierarchy of operands for controlling spoolout is described in the section on scheduling in the “Spool & Print - Commands” manual [42].

Format

START-TAPE-OUTPUT

UNIT = list-poss(8): <alphanum-name 2..2> / <alphanum-name 4..4>
,DEVICE-TYPE = *TAPE / <structured-name 1..8>
,DESTINATION = NONE / list-poss(16): CENTRAL / <alphanum-name 1..8>
,FORM-NAME = ALL / STD / *EXCEPT(...) / list-poss(16): <alphanum-name 1..6>
	*EXCEPT(...)
		\|	FORMS-LIST = list-poss(16): <alphanum-name 1..6>
,USER-IDENTIFICATION = ALL / EXCEPT(...) / list-poss(16): <name 1..8>
	*EXCEPT(...)
		\|	USER-IDENT-LIST = list-poss(16): <name 1..8>
,SPOOLOUT-CLASS = ALL / EXCEPT(...) / list-poss(16): <integer 1..255>
	*EXCEPT(...)
		\|	SPOOLOUT-CLASS-LIST = list-poss(16): <integer 1..255>
,SPOOLOUT-NAME = ALL / EXCEPT(...) / list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
	*EXCEPT(...)
		\|	SPOOLOUT-NAME-LIST = list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
,ACCOUNT = ALL / EXCEPT(...) / list-poss(16): <alphanum-name 1..8>
	*EXCEPT(...)
		\|	ACCOUNT-LIST = list-poss(16): <alphanum-name 1..8>
,FORMS-OVERLAY = ALL / NONE / ONLY / EXCEPT(...) / list-poss(16): <alphanum-name 2..2>
	*EXCEPT(...)
		\|	FORMS-OVERLAY-LIST = list-poss(16): <alphanum-name 2..2>
,FORMS-OVERLAY-BUFFER = ANY / ONLY / NO / RANGE(...)
	*RANGE(...)
		\|	LOW = 0 / <integer 0..32767>
		\|	,HIGH = 4032 / <integer 0..32767>
,PRIORITY = *ALL / *RANGE(...)
	*RANGE(...)
		\|	FROM = 30 / <integer 30..255>
		\|	,TO = 255 / <integer 30..255>
,CHARACTER-SET-NUMBER = ALL / ONE / *RANGE(...)
	*RANGE(...)
		\|	LOW = 1 / <integer 1..32767>
		\|	,HIGH = 64 / <integer 1..32767>
,SPOOLOUT-TYPE = ALL / HP-PRINTER / PRINTER / PAGE-PRINTER /
BUFFER-LINE-PRINTER / LIST(...)
	*LIST(...)
		\|	SELECTION-TYPE = MAY / MUST
		\|	,DEVICE-TYPE = list-poss(8): HP-PRINTER / LP-PRINTER / *LP48-PRINTER /
		\|	PCL-PRINTER / LP65-PRINTER / *HP90-PRINTER /
		\|	LP-EMULATED-PRINTER / 2050-APA-PRINTER /
		\|	2090-APA-PRINTER / 2090-TWIN-PRINTER
,VOLUME = *ANY / list-poss(16): <alphanum-name 1..6>
,RETENTION-PERIOD = 10 / <integer 0..999>
,ROTATION = ANY / YES / NO
,TWO-UP-PROCESSING = ANY / YES / NO / MODE-1 / *MODE-2

Operands

UNIT = list-poss(8): <alphanum-name 2..2> / <alphanum-name 4..4>
Mnemonic device names of the tape devices to be assigned for the output of spoolout jobs.

DEVICE-TYPE = *TAPE / <structured-name 1..8>
Device type of the tape.

DESTINATION = *NONE / list-poss(16): *CENTRAL / <alphanum-name 1..8>
Jobs for the specified local device pools can be processed on the specified tape devices.

FORM-NAME =
Forms with which spoolout jobs can be processed on the specified tape devices.

FORM-NAME = *ALL
Spoolout jobs can be processed on the specified tape devices irrespective of the form required.

FORM-NAME = *STD
Only jobs for which FORM=STD has been specified can be processed on the specified tape devices.

FORM-NAME = *EXCEPT(...)
Forms with which spoolout jobs cannot be processed on the specified tape devices.

FORMS-LIST = list-poss(16): <alphanum-name 1..6>
List of excluded forms.

FORM-NAME = list-poss(16): <alphanum-name 1..6>
List of forms with which spoolout jobs can be processed on the specified tape devices.

USER-IDENTIFICATION =
User IDs under which spoolout jobs can be processed on the specified tape devices.

USER-IDENTIFICATION = *ALL
Spoolout jobs can be processed on the specified tape devices irrespective of the user ID.

USER-IDENTIFICATION = *EXCEPT(...)
User IDs under which spoolout jobs cannot be processed on the specified tape devices.

USER-IDENT-LIST = list-poss(16): <name 1..8>
List of excluded user IDs.

USER-IDENTIFICATION = list-poss(16): <name 1..8>
List of user IDs under which spoolout jobs can be processed on the specified tape devices.

SPOOLOUT-CLASS =
Spoolout classes from which spoolout jobs can be processed on the specified tape devices.

SPOOLOUT-CLASS = *ALL
Spoolout jobs from all spoolout classes can be processed on the specified tape devices.

SPOOLOUT-CLASS = *EXCEPT(...)
Spoolout classes from which spoolout jobs cannot be processed on the tape devices.

SPOOLOUT-CLASS-LIST = list-poss(16): <integer 1..255>
List of excluded spoolout classes.

SPOOLOUT-CLASS = list-poss(16): <integer 1..255>
List of spoolout classes from which spoolout jobs can be processed on the tape devices.

SPOOLOUT-NAME =
Job names under which spoolout jobs can be processed on the specified tape devices.

SPOOLOUT-NAME = *ALL
Spoolout jobs can be processed on the specified tape devices irrespective of the job name.

SPOOLOUT-NAME = *EXCEPT(...)
Job names under which spoolout jobs cannot be processed on the specified tape devices.

SPOOLOUT-NAME-LIST = list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
List of excluded job names.

SPOOLOUT-NAME = list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
List of job names under which spoolout jobs can be processed on the tape devices.

ACCOUNT =
Account numbers with which spoolout jobs can be processed on the specified tape devices.

ACCOUNT = *ALL
Spoolout jobs with any account number can be processed on the specified tape devices.

ACCOUNT = *EXCEPT(...)
Account numbers with which spoolout jobs cannot be processed on the specified tape devices.

ACCOUNT-LIST = list-poss(16): <alphanum-name 1..8>
List of excluded account numbers.

ACCOUNT = list-poss(16): <alphanum-name 1..8>
List of account numbers with which spoolout jobs can be processed on the specified tape devices.

FORMS-OVERLAY =
Names of the film overlays with which spoolout jobs can be processed on the specified tape devices.

FORMS-OVERLAY = *ALL
Spoolout jobs can be processed on the specified tape devices with any film overlay.

FORMS-OVERLAY = *NONE
Only spoolout jobs which do not use film overlays can be processed on the specified tape devices.

FORMS-OVERLAY = *ONLY
Only spoolout jobs which use (any) film overlays can be processed on the specified tape devices.

FORMS-OVERLAY = *EXCEPT(...)
Spoolout jobs which use one of the specified film overlays cannot be processed on the specified tape devices.

FORMS-OVERLAY-LIST = list-poss(16): <alphanum-name 2..2>
List of excluded film overlays.

FORMS-OVERLAY = list-poss(16): <alphanum-name 2..2>
List of film overlays with which spoolout jobs can be processed on the specified tape devices.

FORMS-OVERLAY-BUFFER =
Determines whether spoolout jobs which require an FOB data overlay can be processed on the specified tape devices.

FORMS-OVERLAY-BUFFER = *ANY
Spoolout jobs can be processed on the specified tape devices, regardless of whether or not they require an FOB data overlay.

FORMS-OVERLAY-BUFFER = *ONLY
Only spoolout jobs which use an FOB data overlay can be processed on the specified tape devices.

FORMS-OVERLAY-BUFFER = *NO
Spoolout jobs which use an FOB data overlay cannot be processed on the specified tape devices.

FORMS-OVERLAY-BUFFER = *RANGE(...)
Only spoolout jobs which use an FOB data overlay the size of which falls within the specified range can be processed on the specified tape devices.

LOW = 0 / <integer 0..32767>
Lower range limit.

HIGH = 4032 / <integer 0..32767>
Upper range limit for HP90 printers: 4032 sublines. Upper range limit for HP printers: 672 sublines.

PRIORITY =
Priorities of the spoolout jobs which can be processed on the specified tape devices.

PRIORITY = *ALL
Spoolout jobs with any priority can be processed on the specified tape devices.

PRIORITY = *RANGE(...)
Spoolout jobs with priorities within the specified range can be processed on the specified tape devices.

FROM = 30 / <integer 30..255>
Lower range limit.

TO = 255 / <integer 30..255>
Upper range limit.

CHARACTER-SET-NUMBER =
Number of character sets required with which spoolout jobs can be processed on the specified tape devices.

CHARACTER-SET-NUMBER = *ALL
Spoolout jobs can be processed on the specified tape devices irrespective of the number of character sets required.

CHARACTER-SET-NUMBER = *ONE
Spoolout jobs which require no more than one character set can be processed on the specified tape devices.

CHARACTER-SET-NUMBER = *RANGE(...)
Spoolout jobs which require a number of character sets which falls within the specified range can be processed on the specified tape devices.

LOW = 1 / <integer 1..32767>
Lower range limit.

HIGH = 64 / <integer 1..32767>
Upper range limit.

SPOOLOUT-TYPE =
Spoolout jobs for certain types of output device can be processed on the specified tape devices.

SPOOLOUT-TYPE = *ALL
Spoolout jobs for all device types can be processed on the specified tape devices.

SPOOLOUT-TYPE = *HP-PRINTER
Only spoolout jobs for HP printers (3351, 3353) can be processed on the specified tape devices.

SPOOLOUT-TYPE = *PRINTER
Only spoolout jobs for printers can be processed on the specified tape devices.

SPOOLOUT-TYPE = *PAGE-PRINTER
Only spoolout jobs for laser printers can be processed on the specified tape devices.

SPOOLOUT-TYPE = *BUFFER-LINE-PRINTER
Spoolout jobs for line printers with loadable VFBs (3337, 3338, 3339, 3348, 3349) can be processed on the specified tape devices.

SPOOLOUT-TYPE = *LIST(...)
Spoolout jobs for the specified list of device types can be processed on the specified tape devices.

SELECTION-TYPE = *MAY / *MUST
Selection of spoolout jobs is restricted to those which at least may be output on one of the specified device types (*MAY) or to those which must be output on one of the specified device types, i.e. on no other device type than the ones specified (*MUST).

DEVICE-TYPE = list-poss(8): *HP-PRINTER / *LP-PRINTER / *LP48-PRINTER / *LP65-PRINTER /
*PCL-PRINTER / *HP90-PRINTER / *LP-EMULATED-PRINTER / *2050-APA-PRINTER /
*2090-APA-PRINTER / *2090-TWIN-PRINTER
List of device types. For the symbolic names see the “Spool & Print - Commands” manual [42].

VOLUME =
Volume labels of the tapes which are to be assigned for spoolout jobs for output to tape (WRITE-SPOOL-TAPE) (see "Notes").

VOLUME = *ANY
Accepts the volume label of the mounted tape.

VOLUME = list-poss(16): <alphanum-name 1..6>
Volume labels of the tapes to be used.

RETENTION-PERIOD = 10 / <integer 0..999>
Period in days during which the files are to be stored on tape.

ROTATION =
Determines whether spoolout jobs which require the page rotation module can be processed on the specified tape devices.

ROTATION = *ANY
Spoolout jobs can be processed on the specified tape devices, regardless of whether or not they require the page rotation module.

ROTATION = *NO
Only spoolout jobs which do not require the page rotation module can be processed on the specified tape devices.

ROTATION = *YES
Only spoolout jobs which require the page rotation module can be processed on the specified tape devices.

TWO-UP-PROCESSING = *ANY / *YES / *NO / *MODE-1 / *MODE-2
Only SPOOLOUT jobs with the specified value TWO-UP-PROCESSING can be processed on the specified tape devices.

Return codes

SC1	Maincode	Meaning
0	CMD0001	No error
1	CMD0202	Syntax error
1	SCP0973	Semantic error
32	SCP0974	System error. Command rejected
64	SCP0975	No authorization for command
64	SCP0976	Invalid operand value

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

START-TAPE-OUTPUT

Function

Notes

Format

Operands

Return codes