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.