Calling a tape reader *CALL,TR

Function

Use the *CALL,TR command to invoke tape reading. A pause follows this command, allowing you to mount tapes on an allocated device. A message is issued specifying which tape unit to use. When the proper tape is mounted and the device is ready, you must use an *START command to begin reading. If the K parameter is specified on the *CALL or *START command, the tape reader remains active when an EOF condition is reached and reading resumes each time an *START command is entered.

Syntax


                     .-,--IN--=--TA9----------------------.   
>>-+-*CALL-+--,--TR--+------------------------------------+----->
   '-*X----'         '-,--IN--=--+-devname--------------+-'   
                                 +-+---+--devnum--------+     
                                 | '-/-'                |     
                                 +-(--type--)-----------+     
                                 +-(--type--,--group--)-+     
                                 '-(--,--group--)-------'     

   .-,--B--=--10--.                       
>--+--------------+--+----------------+------------------------->
   '-,--B--=--nnn-'  '-,--DEN--=--den-'   

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

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

             .-,--NAV--=--R-.  .-,--P--=--15-.   
>--+------+--+--------------+--+-------------+------------------>
   '-,--L-'  '-,--NAV--=--C-'  '-,--P--=--nn-'   

   .-,--PARMID--=--01-.  .-,--TBLK--=--1--.   
>--+------------------+--+----------------+--------------------->
   '-,--PARMID--=--xx-'  '-,--TBLK--=--nn-'   

   .-,--TM--=--0---.   
>--+---------------+-------------------------------------------><
   '-,--TM--=--nnn-'

Parameters

IN =devname or devnum or ([type] [,group])

Specifies the source from which the job input is to be read. TA9 is assumed.

devname or devnum or /devnum

Specifies the device, by name or by 3-digit or 4-digit hexadecimal number, from which the input jobs are to be read. 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.

type

Specifies the type entry: TA7 for any 7-track tape drive, TA9 for any 9-track tape drive. TA9 (or 7) 2400 and TA9 (or 7) 3400 are valid entries when jobs are to be entered through a tape drive. If the group entry is omitted, the comma preceding it can also be omitted. The type and group entries must always be enclosed in parentheses.

group

Specifies the specific group of devices to which the tape drive has been assigned, and typically refers to its physical location (for example, FLOOR1 or LOCAL). If the type entry is omitted, you must use a comma before the group entry. The type and group entries must be enclosed in parentheses.

B=10 or nnn

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 default is 10. Valid values are 1 through 255.

DEN=den

Specifies the density at which the tape was written: 2 (200 bpi), 5 (556 bpi), 8 (800 bpi), 16 (1600 bpi), or 62 (6250 bpi). JES3 accepts tapes written in either density from a dual-density 9-track drive; no DEN= specification need be made. If the IN= parameter specifies a 7-track tape drive, the density default is 8. If this default is satisfactory, no DEN= parameter need be specified.

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. The default is RW.

H or HN

Specifies whether the JES3 control-card processor is to be put in hold state (H) or allowed to process the jobs after the batch has been created (HN). The default is 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. Valid values are 1 through 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. The default is KN.

L

Specifies that the tape is labeled.

NAV=R or C

Specifies the action to be taken if the designated input device is in use or otherwise unavailable. R specifies that JES3 is to reschedule the tape reader (TR) when the device becomes available. C specifies that the tape reader is to be canceled if the device is not currently available. The default is R.

P=15 or nn

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

PARMID=01 or xx

Specifies the set of C/I options to be used for all jobs read in through this reader. The value must be the same as the PARMID associated with a CIPARM statement. The default is 01.

TBLK=1 or nn

Specifies the blocking factor of the card images on the tape to be read. Valid values are 1 through 40. The default is 1.

TM=0 or 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 00 through 127. The default is 0.

Examples

Call a tape reader from device 181, 20 card images per tape block. After the jobs have been read, rewind and unload the tape. Schedule control-card processor jobs at priority 10, and skip all jobs on tape until JOB7 is found. When JOB7 is found, read it in along with the next 13 jobs.

*X,TR,IN=181,TBLK=20,END=RU,P=10,J=JOB7,JOBS=14

Call a tape reader from among the TA7-type tape drives on FLOOR1. There are to be 10 card images per tape block. The tape density is 556 bpi.

*X,TR,IN=(TA7,FLOOR1),TBLK=10,DEN=5