Starting a tape reader *START,TR

Function

Use the *START,TR command to restart a hot tape reader when it has reached an EOF condition or to alter or add to the parameters specified when the last *CALL, *START, or *CANCEL command was entered.

If an optional parameter is not specified, the value for that parameter defaults to the value specified on the *CALL command or on the most recent *START or *CANCEL command that modified that parameter.

Syntax

                                     .-,--B--=--10--.   
>>-+-*START-+--+-,--TR------------+--+--------------+----------->
   '-*S-----'  +-,--devname-------+  '-,--B--=--nnn-'   
               '-,--+---+--devnum-'                     
                    '-/-'                               

>--+-------------------+--+-------+----------------------------->
   '-,--END--=--+-NO-+-'  +-,--HN-+   
                +-RW-+    '-,--H--'   
                '-RU-'                

>--+-------------------------------------------+--+-------+----->
   |                   .-,--JOBS--=--1-------. |  +-,--KN-+   
   +-,--J--=--jobname--+---------------------+-+  '-,--K--'   
   |                   '-,--JOBS--=--+-nnn-+-' |              
   |                                 '-ALL-'   |              
   '-,--JOBS--=--+-nnn-+-----------------------'              
                 '-ALL-'                                      

                    .-,--PARMID--=--01-.                      
>--+-------------+--+------------------+--+---------------+----><
   '-,--P--=--nn-'  '-,--PARMID--=--xx-'  '-,--TM--=--nnn-'   

Parameters

TR or devname or devnum or /devnum

Specifies the source from which the job input is to be read. If more than one reader of the same type is currently active, use devname, devnum or /devnum to ensure that the proper reader is affected. The device number can be a 3-digit or 4-digit hexadecimal number. A slash (/) preceding the device number is not required. Device numbers can be specified by any of the following formats:

ddd
dddd
/ddd
/dddd

where ddd and dddd represent the device numbers.

B=nnn | 10

Specifies the size of the job batches created by this reader; that is, the number of jobs to be read from the tape and placed on the spool device. The maximum is 255. Valid values are 1-255.

END=RW or RU or NO

Specifies the action to be taken by the tape unit when it reaches the EOF: RW (rewind), RU (rewind and unload), or NO (no tape repositioning). JES3 does not support multiple reel input.

H or HN

Specifies whether the JES3 control-card processor is to be put in hold state (H) or be allowed to process the jobs after the batch has been created (HN).

J=jobname

Specifies the name of the job with which input is to begin.

JOBS=nnn or ALL

Specifies the number of jobs to be read from the input device and placed onto spool devices. ALL permits reading until a physical EOF is reached. When you specify J=jobname in addition to this parameter, the default for JOBS= is 1. The maximum is 254; the default is ALL.

K or KN

Specifies whether the designated reader is to be kept active (K) when an EOF condition occurs or is to be allowed to purge (KN). Reading is resumed when you enter an *START command.

P=nn

Specifies the scheduling priority of the control-card processor job (without affecting the priorities of the individual jobs being read in). Valid values are 00 to 15.

TM=nnn

Specifies the number of files the tape is to be spaced forward before reading begins. For unlabeled tapes, this is the number of tape marks bypassed; for labeled tapes, this is the number of logical files, each including its header and trailer labels. Valid values are 0 to 127.

PARMID=xx

Specifies the set of C/I options to be used for all jobs read in through this reader. PARMID=01 is the default.

Example

*S,TR,B=10