READCARD CMS Transient command
Use the READCARD command to read data records from your virtual reader and to
create CMS disk files containing the data records. The format of the READCARD
command is:
+----------+------------------------------------------------------------------+
| READcard | fn ft [A|fm] |
| | * [* [A|fm]] |
+----------+------------------------------------------------------------------+
where:
fn is the filename you want to assign to the file being read.
ft 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.
fm is the filemode letter of the disk onto which the file is to be read
and the filemode number of the file. A filemode of A1 is assumed if
this field is omitted or specified as an asterisk (*). However, if a
filemode number is on the control card, that number is used with A.
When a filemode letter is specified on the command, the default
filemode number is 1, unless the filemode number is on the control
card. Specifying a filemode letter and number on the command ignores
the filemode letter and number on the control card and assigns that
filemode to the file.
Usage notes:
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.
2. CMS 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 *
CMS 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.
The first card in the deck may not be a READ control card. If not, 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 specify a filename and filetype on the READCARD command, for
example:
readcard junk file
CMS does not check the input stream for READ control cards, but reads the
entire spool file onto the disk and assigns it the specified filename and
filetype.
If there were any READ control cards in the deck, they are not removed.
Delete them using the editor if you do not want them in your file. If the
file is too large, you can either increase the size of your virtual storage
(using the CP DEFINE command), or use the COPYFILE command to copy all
records except the READ control cards (using the FROM and FOR options).
4. READCARD loads a file from the reader into a temporary work file
called "READCARD CMSUT2". The existing file with the same name as
the one being loaded from the reader is then erased. The name of
the temporary work file just created is changed to the name of the
file just received. However, if the file you are loading has the
name "READCARD CMSUT2", it will be changed to "READCARD CMSUT3."
"READCARD CMSUT2" is a reserved work filename of the READCARD
command.
5. To read a file onto a disk other than your A-disk, specify the filemode
letter when you specify the filename and filetype; for example:
readcard junk file c
Or, if you want the READ control card to determine the filenames and
filetypes, you can enter:
readcard * * c
6. If you 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 optionally, filemode numbers, to be
assigned to the disk file(s).
A READ control card must begin in column 1 and has the format:
:READ filename filetype filemode
Each 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 6). 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 reader,
punch a CP ID card to precede the deck. The ID card 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:
ID MARY CLASS A NAME LITTLE LAMB
Each field must be separated from the others by at least one blank.
8. If the reader file being processed contains carriage control characters,
the READCARD command returns the records with the carriage control
characters stripped off.
9. If any errors are encountered while attempting to read a spool file, the
file will not be purged by the READCARD command and will remain in the
reader. This will occur regardless of whether the reader has been spooled
HOLD or NOHOLD. This is to protect you from losing reader spool files when
an error is encountered. If this occurs the reader spool file should be
examined. If the file is empty or unwanted, purge the file from your
reader.
Responses:
When the command READCARD * is issued, control cards encountered in the input
card stream are displayed at the terminal to indicate the names assigned to
each file.
DMSRDC701I NULL FILE
The spooled card reader contains no records after the control card.
DMSRDC702I :READ filename filetype fm (other information)
A READ control card has been processed; the designated file is being written
to the disk.
DMSRDC702I READ CONTROL CARD MISSING. FOLLOWING ASSUMED:
DMSRDC702I :READ READCARD CMSUT1 A1
The first card in the deckis not a READ control card. Therefore, READCARD
CMSUT1 A1 is created.
DMSRDC738I Record length is nnn bytes
The records being read are not 80 bytes long; this message gives the
length.