Your Browser is not longer supported

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

{{viewport.spaceProperty.prod}}

START-TAPE-REPLAY

&pagelevel(3)&pagelevel

Assign tape devices for replay

Component:

SPOOL

Functional area:

Controlling spoolout job

Domain:

SPOOL-PRINT-ADMINISTRATION

Privileges:

OPERATING
PRINT-SERVICE-ADMINISTRATION

Routing code:

S

Function

The START-TAPE-REPLAY command assigns tape devices for replay jobs. The files read in are either entered in the queue or output directly (OUTPUT-MODE operand).

Notes

  • OUTPUT-MODE=*FROM-DISK-COPY is used in the following cases, even if OUTPUT-MODE=*DIRECT has been specified:

    • if one of the following operands has been specified in the PRINT-DOCUMENT command:

      • REPEAT = ...

      • FILE-PART = *LAST(...)

      • CONTROL-CHARACTERS = *APA

    • the file can only be printed on an APA printer

    • the file extends over several tapes

  • During output of a replay tape the selection of jobs must not be changed by issuing further START-TAPE-REPLAY commands. The only option is to disconnect the tape device from SPOOL using the STOP-TAPE-REPLAY command and then assign the terminal for spoolout by means of a new START-TAPE-REPLAY command and other selection operands.

  • To execute a spoolout request for a tape device, all of 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” manual [43]. 

Format

START-TAPE-REPLAY

UNIT = list-poss(8): <alphanum-name 2..2> / <alphanum-name 4..4>

,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>

,ROTATION = *ANY / *YES / *NO

,TWO-UP-PROCESSING = *ANY / *YES / *NO / *MODE-1 / *MODE-2

,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 / *LP65-PRINTER / 



|


*PCL-PRINTER / *HP90-PRINTER /*LP48-PRINTER / LP-EMULATED-PRINTER /



|


*2050-APA-PRINTER / *2090-APA-PRINTER / *2090-TWIN-PRINTER

,VOLUME = list-poss(16): <alphanum-name 1..6>

,OUTPUT-MODE = *FROM-DISK-COPY / *DIRECT

,DIRECTORY-VOLUME = *STD / <alphanum-name 1..6>

Operands

UNIT = <alphanum-name 2..2> / <alphanum-name 4..4>
Mnemonic device name of the tape device from which spoolout jobs are to be processed.

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

FORM-NAME =
Only the spoolout jobs on the specified tape device for which these forms have been specified can be processed.

FORM-NAME = *ALL
All the spoolout jobs on the replay tape can be processed.

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

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

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 on the specified tape device can be processed.

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

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

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

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

USER-IDENTIFICATION = list-poss(16): <name 1..8>
Spoolout jobs on the specified tape device with the specified user IDs cannot be processed.

SPOOLOUT-CLASS =
Spoolout jobs on the specified tape device can be processed according to the spoolout classes specified here.

SPOOLOUT-CLASS = *ALL
Spoolout jobs on the specified tape device can be processed irrespective of the spoolout class.

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

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 with which spoolout jobs on the specified tape device can be processed.

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

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

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

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 with which spoolout jobs on the specified tape device can be processed.

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

ACCOUNT = *ALL
Spoolout jobs on the specified tape device can be processed with all account numbers.

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

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 on the specified tape device can be processed.

FORMS-OVERLAY =
Spoolout jobs on the specified tape device can be processed according to the film overlays they require.

FORMS-OVERLAY = *ALL
Spoolout jobs on the specified tape device can be processed irrespective of the film overlays they require for output.

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

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

FORMS-OVERLAY = *EXCEPT(...)
Spoolout jobs on the specified tape device which require the specified film overlays cannot be processed.

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 on the specified tape device can be processed.

FORMS-OVERLAY-BUFFER =
The spoolout jobs on the specified tape device can be processed according to the FOB data overlays they require for output.

FORMS-OVERLAY-BUFFER = *ANY
Spoolout jobs on the specified tape device can be processed irrespective of the FOB data overlays they require for output.

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

FORMS-OVERLAY-BUFFER = *NO
The spoolout jobs on the specified tape device which use an FOB data overlay can be processed.

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

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 device.

PRIORITY = *ALL
Spoolout jobs on the specified tape device can be processed irrespective of their priority.

PRIORITY = *RANGE(...)
Only spoolout jobs on the tape device with priorities within the specified range can be processed.

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

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

ROTATION =
Determines whether spoolout jobs on the tape device can be processed if they need the page rotation module function.

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

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

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

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

CHARACTER-SET-NUMBER =
Spoolout jobs on the specified tape device can be processed according to the number of character sets required.

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

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

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

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

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

SPOOLOUT-TYPE =
Only spoolout jobs on the specified tape device for the specified type of output device can be processed.

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

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

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

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

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

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

SELECTION-TYPE = *MAY / *MUST
Selection of spoolout jobs is restricted to those either 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” manual [43].

VOLUME = list-poss(16): <alphanum-name 1..6> 
VSN of the replay tape which is assigned to process (i.e. output) the files stored on it.

OUTPUT-MODE =
Specifies whether the files read in from the replay tape are to be entered in the queue (*FROM-DISK-COPY) or output directly (*DIRECT).

OUTPUT-MODE = *FROM-DISK-COPY
The files are first copied from tape to disk. The jobs are then entered in the normal spoolout queue (type 4).

OUTPUT-MODE = *DIRECT
The jobs are entered in the “replay queue”, i.e. the printer task reads the data direct from the tape. This saves disk memory space but takes longer.

DIRECTORY-VOLUME = *STD / <alphanum-name 1..6>
Specifies the volume containing the catalog of replay jobs.
If the specified tape is to be processed on another computer the directory of the replay tape must first be imported into the file catalog of the appropriate computer. 

Return codes

(SC2)

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

Powered by Atlassian Confluence and Scroll Viewport.