Pg. of GC20-1819-2 Rev March 30, 1979 by Supp. SD23-9024-1 for 5748-X18 For further information on DOS/VSE and C!S/DOS tape label processing,
refer to the following IB! publications: DOS/VSE Tape Labels DOS/VSE Macro User's Guide DOS/VSE LIOCS Vol 2 CMS TAPESL MACRO The TAPESL macro is provided for use in C!S programs that do not use as
and DOS simulation features. You can use the C!S TIPESL macro to
process IBM standard HDR1 and EOF1 labels without using DOS or OS OPEN and CLOSE macros. You will probably use TAPESL with the RDTIPE, WRTIPE, and TAPECTL macros. TAPESL processes only HDR1 and EOF1 labels. It does not perform any
functions of opening a tape file other than label checking or writing.
The TAPESL macro generates linkage to the C!S tape label processing
routine that actually processes the label. The macro generates a block
of data (32 bytes long) in order to communicate with the tape label
processing routines. TAPESL is used both to check and to write tape
labels. A LABELDEF command must be issued prior to running the program
that contains this macro. The LABID parameter of the TIPESL macro is
used to specify the name of the LABELDEF to be used. For example, if
you use the macro: TAPESL HOUT,181,LABID=GOODLAB in your assembly language program, you must supply a LIBELDEF command for GOODLAB: labedef good lab fid file10 fseq 4 exdte 78235
The tape must be positioned correctly (at the label to be checked or at
the place where the label is to be written), before you issue the macro. TAPECTL may be used to position the tape. TAPESL reads or writes only
one tape record unless you specify SPACE=YES for input. Then it spaces
the tape to beyond the tape mark that ends the label file. TIPESL reads
and checks a tape VOLl label provided the tape is positioned at load
point and the user has specified a volid in his LABELDEF command. TAPE LABEL PROCESSING BY CMS COMMANDS There are three types of CMS commands that do some type of tape label
processing. They are: • TAPEMAC and TIPPDS commands • TAPE command • MOVEFILE command TAPEMAC and TAPPDS have operands where you can indicate the type of
label processing you want. The tape must be positioned properly (at the
data file or label file you before you issue the command. The TAPE command may be used for positioning. A separate LABELDEF command 122.10 IBM VM/370 eMS User's Guide

Pg. of GC20-1819-2 Rev March 30, 1979 by Supp. SD23-9024-1 for 5748-XX8 is required for these commands if IBM standard latel checking is
desired. If SL label type is specified without a labdefid, standard
header labels are displayed on the terminal but not checked by the label processing routines. The command:
tapemac macfile SL (tap2
displays any standard labels that exist on your terminal while the
series of commands:
labeldef mac lab fid macro vol seq 2 crdte 77102 tape mac macfile sl mac lab (tap2
invokes the eMS tape label processing routines. These routines check to
see that your tape has a HDR1 label that has a file identifier of macro,
a volume sequence number 2, and a creation date of 77102. VOL1 labels
are not checked during label processing by TAPEMAC and TAPPDS unless the
tape is positioned at load point and you have specified a volid on your
LABELDEF command. The DVOL1 function of the TAPE command can be used
for volume verification before positioning the tape if the user does not
want to start at the first file. These commands process only HDR1
labels; they skip HDR2, UHL, and all trailer labels without processing
them.
To process nonstandard tape labels with TAPE MAC and TAPPDS, you use
the same interface described in the section "NSL Processing under OS Simulation." The only difference is that instead of putting the CMSCB and DCB addresses in the parameter list, the ID parameter you placed in
the command line is passed to your NSL routine.
tappds pdsfile cmsut1 * nsl superck id
passes the EBCDIC identifier XYZ12345 to your nonstandard label checking
routine called SUPERCK. This identifier may be up to eight characters
long and is left justified in bytes 8-15 of the parameter list. You can
use the identifier to inform your NSL routine of what file you are
processing. Use the DVOL1 function of the CMSTAPE command to display the VOL1 label
of a tape on your terminal. You may use this command to ensure the
system operator has mounted the correct tape before you begin processing
the tape. If the tape does not have a VOL1 label and you issue the CMSTAPE command, you are informed that the VOL1 label is missing. Do
not use TAPE DVOL1 if you have a blank tape. If TAPE DVOL1 is issued
and a blank tape is used, CMS will search the entire tape to find the
label record; since the tape is void of any records, the tape will run
off the end of the reel. Use the WVOL1 function on the TAPE command to write a VOL1 label on a
tape. You can specify a one-to six-character volume serial number
(volid) through this command and also a one-to eight-character owner
field. You can use the MOVEFILE command to move labelled tape files if these
files are defined as labelled by the FILEDEF command. The MOVEFILE command supports only SL, NSL, BLP, NL, and LABOFF processing. SUL files are processed as SL files and no user exits are taken.
Section 7. Using Real Printers, Punches, Readers, and Tapes 122.11