READCARD
READCARD Use the READCARD command to read data records from your rea1er to create eMS disk files containing the data
format of the READCARD command is:
virtual card
records. The
r -, , READcard
\ r , , I fn ft I fm , I I I ! , I I L J I 1 r r " , I ( . , * , fm II , - , I I ! , I , I L L JJ , L -J fn is the filename you want to assign to the file being read.
ft
* [*]
fm
is the filetype you want to assign to the file being read.
indicates that file identifiers are to be assigned according
to READ control cards in the input deck.
is the filemode of the disk onto which the file is to be read.
If this field is omitted or specified as an asterisk (*), the
A-disk is assumed. Whenever a mode number is specified on the
command line, it is used; otherwise, the mode number on the
READ control card is used to create the disk file.
1. Data records read by the READCARD command must be fixed-length
records, and may be a minimum of 80 and a maximum of 151 characters
long.
2. disk file identifiers are assigned according to READ control
cards in the input deck (the PUNCH command header card is a valid
READ control card). When you enter the command:
readcard * reads the first spool reader file in the queue and if there are
READ control cards in the input stream, it names the files as
indicated on the control cards.
If the first card in the deck is not a READ control card, CMS writes a file named READCARD CMSUT1 A1 to contain the data, until a
READ control. card is encountered or until the end-of-file is
reached. 3. If you s?ecify a filename and filetype on the READCARD command, for
example:
readcard recent memo CMS does not check the input stream for READ control cards, but rea1s the entire spool file onto disk and it the specified
filename and filetype.
Section 2. :ommands 155

READCARD
If there were anv READ control cards in the deck, they
removed; you must delete them using the CMS Editor if you
want them in vour file. If the file is too large, you can
increase the size of your virtual storage (using the CP command), or use the COPYFILE command to copy all records
the READ control cards (using the FROM and FOR options,.
are not
do not
either
DEFINE
except
4. To read a file onto a disk other than your A-disk, you can specify filemode letter when you enter the filename and filetype; for eX:lmple: 5.
readcard recent memo c if you want READ control card to determine the filenames and
filetypes, you can enter:
readcard * * c When vou read a file th:lt of an existing
replaced.
that has the
file on the
same filename and filetype as
same disk, the old file is
6. If vou are preparing real or virtual card decks to send to your own
or another user's virtual card reader, you may insert READ control
cards to designate filenames, filetypes, and filemode
numbers, to be assigned to the disk file(st. A READ control card must begin in column 1 and has the format:
:READ filename filetype filemode Ea=h field must be separated by at least one blank; the second
character of the filemode field, if specified, must be a valid
filemode number (0 through 5). The filemode letter is ignored when
this file is read, since the mode letter is determined by
specifications on the READCARD command line. 7. To send a real card deck to your own or another user's virtual card re:lder, you must punch a CP ID card to precede the deck. The ID cacd has the keyword ID or USERID in column 1, followed by the
userid you want to receive the file and optionally, spool file
class and name designations; for example: 1D NEWYOFK CLASS A NAME BIG APPLE Ea=h field must be separated from the others by at least one blank. 8. When a file in the reader has a filemode letter of "A", the
readcard command uses the filemode number of the read control card.
The default value is only true for a filemode of "A". Any other
filemode letter (B, C, etc.) specified without a filemode number in
the readcard command, defaults to a filemode number of one. 156 CMS Command and Macro Reference