home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / tapeutils.zip / tuiraohlp.txt < prev    next >
Text File  |  1991-04-18  |  13KB  |  233 lines
  1. .cs 1 on
  2. The SPROSC  command  copies  a file or files from tape to disk.  By default,  a
  3. tape is read  from the current  position,  but the user may instead  request  a
  4. specific   file  number.   SPROSC  will  also  do  limited  label-checking   on
  5. standard-label  tapes - the user may request that the tape and/or data set name
  6. be verified before copying.   Any validation  failure aborts the command.  When
  7. multiple files are to be read, only the first one's name can be verified.
  8.  
  9. SPROSC is  most convenient for  labeled volumes, but it  may be used  even with
  10. unlabeled tapes, provided that the user knows the relevant DCB information (see
  11. the O/S JCL  Reference Manual for a  full description of DCB  parameters if you
  12. dare).  Most DCB information can usually be omitted anyway because defaults are
  13. supplied or  because the information is  irrelevant under CMS.  SPROSC  has the
  14. option of deblocking or reblocking files in the process of copying.
  15.  
  16. Input data from  an ASCII source will  be translated to EBCDIC  by default (the
  17. source can be declared "ASCII" either  explicitly in the command or implicitly,
  18. by  the presence  of  ANSI  standard labels).   In  addition,  files from  ANSI
  19. standard-label tapes  are automatically  converted from  VAX-style VFC  to ANSI
  20. carriage control if necessary.
  21.  
  22. Normally, SPROSC will overwrite  any existing CMS file of the  chosen name, but
  23. when the tape file is the continuation of a multi-reel dataset (as indicated by
  24. a volume  SEQUENCE number  greater than  1 in  the header  label), SPROSC  will
  25. append the file to an existing file of the same name, if any.
  26.  
  27. Optionally, before  copying from  tape, SPROSC  will position  the tape  to the
  28. requested file.  A labeled tape is positioned by reading the labels and spacing
  29. forward or  backward as needed.   An unlabeled tape  is first rewound  and then
  30. spaced forward to the correct file.  When the command has finished copying, the
  31. tape is normally positioned at the next file, that is, after the file mark that
  32. ends the trailer labels (on a labeled tape) or the data (on an unlabeled tape).
  33.  
  34. If the disk file-id is omitted from  the command, SPROSC will just position the
  35. tape to the correct file.  If the tape  is labeled, SPROSC will display the DSN
  36. and leave  the tape positioned  at the beginning of  the header file.
  37.  
  38. Examples:
  39.  
  40. 1. Copy 4  files from a labeled tape,  beginning with file 7,  keeping the same
  41.    file names, deblocking if necessary.
  42.  
  43.        SPROSC TAP1 = (SL 7 EOF 4
  44.  
  45. 2.  Copy file  12 from  a non-labeled  tape,  using file-id  "fn ft",  assuming
  46.    OS-style varying-length record format (VBS).
  47.  
  48.        SPROSC TAP1 fn ft A4 (NL 12
  49.  
  50. 3. Copy the current file from a non-labeled tape, assuming fixed-length 80-byte
  51.    records, deblocking if necessary.
  52.  
  53.        SPROSC TAP1 fn ft (RECFM F
  54.  
  55. 4. Copy  a two-reel file from  labeled tapes, starting  at file 3 of  the first
  56.    tape.
  57.  
  58.        SPROSC TAP1 = (SL 3
  59.        SPROSC TAP2 = (SL 1
  60.  
  61. 5. Copy all files  with names  beginning with  the string "IK0"  from the whole
  62.    tape.
  63.  
  64.        SPROSC TAP1 = = A1 (SL 1 EOT PREFIX IK0
  65.  
  66. Problems/bugs should be reported to the author:
  67.   J.F. Chandler    <PEPMNT@CFAAMP>              (BITNET)
  68.                    <PEPMNT@CFAAMP.HARVARD.EDU>  (Internet)
  69.  
  70. .cs 1 off
  71. .cs 2 on
  72. +---------+-------------------------------------------------------------------+
  73. |         |                                                                   |
  74. |         |              --        --  -- --  --         --                   |
  75. | SPROSC  |    TAPN      | fn  ft  | fm |  |  | ( options |                   |
  76. |         |              |  =   =  --  --  |  --         --                   |
  77. |         |              --               --                                  |
  78. |         |    ?                                                              |
  79. |         |                                                                   |
  80. |         |                                                                   |
  81. |         |    Options:                                                       |
  82. |         |             RECFM   ccc        LRECL  nnnnn                       |
  83. |         |                                                                   |
  84. |         |             ( BLKSIze nnn )    ( NL   --   -- )                   |
  85. |         |             ( BLock   nnn )    ( SL   | nnn | )                   |
  86. |         |                                ( FILE --   -- )                   |
  87. |         |             ( VOLume volid )                                      |
  88. |         |             ( VOLID  volid )   DSName dsn                         |
  89. |         |                                                                   |
  90. |         |             ( EBCdic )         ( EOF  n )                         |
  91. |         |             ( ASCii  )         ( EOT    )                         |
  92. |         |                                                                   |
  93. |         |             REBlock nnn        PREfix sss                         |
  94. |         |                                                                   |
  95. +---------+-------------------------------------------------------------------+
  96.  
  97. .cs 2 off
  98. .cs 3 on
  99. Parameters:
  100.  
  101. TAPn      is the device name for a tape drive (n may be 0-9) preferably already
  102.           positioned to the correct file (beginning of header label if SL tape,
  103.           beginning of data if NL tape)
  104.  
  105. ?         causes SPROSC to display its version number.
  106.  
  107. fn ft fm   gives the file-id of the  output CMS copy.  The  default filemode is
  108.           "A1", except that files of type VS or VBS are forced  to filemode  4.
  109.           If multiple  files are to be read,  only the first one receives  this
  110.           file-id,  and subsequent  files  are named  from  the input  data set
  111.           labels, just as if "=" had been specified.   The filemode is retained
  112.           for subsequent files.
  113.  
  114. =         specifies  that the  output CMS  file is  to be  given a  default CMS
  115.           file-id  formed from  the input  data set  label, which  must have  a
  116.           non-empty name.  This form  (=) is valid only for input  from labeled
  117.           tape.  The last two qualifiers  of a multi-level  DSNAME  become  the
  118.           filename  and filetype  of the output  file with one exception:  when
  119.           there are at least three qualifiers,  and the last one consists  of a
  120.           letter  plus a digit  (0-6),  the digit  is taken  to be the filemode
  121.           number  of the output file, and the previous  two tokens are used for
  122.           the filename and filetype.  If the name has only one qualifier,  that
  123.           is used as the filename,  and the filetype is TAPEFILE.  For example,
  124.           a  DSN  of  "WWW.X.Y.Z"  would  yield  a file-id  of  "Y  Z A1",  but
  125.           "WWW.X2.Y2.Z2" would yield "X2 Y2 A2".
  126. .cs 3 off
  127. .cs 4 on
  128.  
  129. Options:
  130.  
  131. Note: the options RECFM, LRECL, and BLKSIZE are used only in copying files from
  132. an unlabeled tape or if tape label processing is bypassed (by positioning  to a
  133. data file).   Whenever  SPROSC  reads data set labels,  the encoded  attributes
  134. supersede the command options.
  135.  
  136. RECFM     gives the record format for the input data set.  The default is U.
  137.  
  138. LRECL     gives the logical record length for  the input data set.  This option
  139.           is  ignored  for all  data  sets  with varying-length  records.   The
  140.           default is 80.
  141.  
  142. BLKSIZE   (or BLOCK) gives the block size  for the input data set.  This option
  143.           defaults to  32756 and is, therefore,  unnecessary for VBS  tape data
  144.           sets.   It is  also unnecessary  for  files being  deblocked, but  it
  145.           should be specified for any F or  FB data set destined for filemode 4
  146.           from an unlabeled tape.
  147.  
  148. REBLOCK    gives the  block size  for the  output file,  assuming it  is to  be
  149.           filemode number 4 and converted from VBS or VS to VB.  The value must
  150.           be at least 4 more than the LRECL of the input data set but should be
  151.           less than 32768.  If the value is  too small, the copy operation will
  152.           halt.
  153.  
  154. SL        signifies a  standard-label tape and optionally gives  the input file
  155.           number.  If  no number is  given, SPROSC  will read from  the current
  156.           tape  file.  If  a  number is  given, SPROSC  will  space forward  or
  157.           backward as  needed to find the  requested file before  reading data,
  158.           even  if the  tape is  currently positioned  at a  data (rather  than
  159.           label) file.
  160.  
  161. NL        signifies a  non-labeled tape (the default) and  optionally gives the
  162.           input file number.  If no number is  given, SPROSC will read from the
  163.           current tape file.  If a number is given, SPROSC will rewind and then
  164.           space forward  to find the  requested file.   If the tape  is labeled
  165.           after all, and the requested file is  a label, SPROSC will still read
  166.           the file as data.
  167.  
  168. FILE      gives the  file number on tape.  By default SPROSC reads  the current
  169.           file.  The label status should be specified separately by the "SL" or
  170.           "NL" option (or by default to NL).
  171.  
  172. VOLUME     gives the  expected volume  name of  a SL  tape.  When  the name  is
  173.           specified, it will be checked against  the name encoded in the volume
  174.           and/or  data set  header labels.   SPROSC will  halt if  they do  not
  175.           match.  Note  that the  volume name  is never  checked in  the header
  176.           label of  the second  or subsequent  part of  a multi-reel  data set,
  177.           since the label encodes the name of the first volume.
  178.  
  179. DSN       gives the expected data set name of a SL tape file.  This option must
  180.           be specified  last in  the command, since  all subsequent  tokens are
  181.           concatenated with  "." separators to form  the DSN.  The  result must
  182.           not be more than 44 characters.  Only the last 17 characters are used
  183.           in the comparison, but the entire name  will be used if necessary for
  184.           supplying  a  default CMS  file-id  (see  above).  For  example,  the
  185.           specification "DSN AAA1234  INPUT STREAM CNTRL" would yield  a DSN of
  186.           "AAA1234.INPUT.STREAM.CNTRL", but  only "NPUT.STREAM.CNTRL"  would be
  187.           significant in the comparison.
  188.  
  189. ASCII      specifies that  the input  tape is  encoded  in ASCII  and that  the
  190.           labels, if  any, are ANSI standard.   The data will be  translated to
  191.           EBCDIC.   This   option  is   the  default   when  reading   an  ANSI
  192.           standard-label tape.
  193.  
  194. EBCDIC    specifies that the input tape is encoded in EBCDIC (or is binary) and
  195.           that the labels, if any, are  presumably IBM standard.  The data will
  196.           not be translated, even if the labels turn out to be ANSI labels.
  197.  
  198. EOF       gives the number of consecutive files to be read from the input tape.
  199.           This option may be specified only for a labeled tape.  If fewer files
  200.           exist than are requested, this is equivalent to the EOT option.
  201.  
  202. EOT       specifies that consecutive  files are to be read from  the input tape
  203.           up to the end.  This option may be specified only for a labeled tape.
  204. .cs 4 off
  205. .cs 6 on
  206.  
  207. Error messages:
  208.  
  209. SPROSC071E UNKNOWN OPTION '........'
  210. SPROSC083E MISSING FILEID
  211. SPROSC095E NO VALUE SUPPLIED FOR '........' OPTION
  212. SPROSC098E ILLEGAL PARAMETER '........'
  213. SPROSC283E INSUFFICIENT STORAGE FOR BUFFERS
  214. SPROSC308E ILLEGAL ........ VALUE '........'
  215. SPROSC340E INCONSISTENT OPTION '........'
  216. SPROSC770I '........' (.... BLOCKS) COPIED TO '.....'
  217. SPROSC771E MISSING TAPE ID
  218. SPROSC772I REACHED EOT ON ....
  219. SPROSC773E REBLOCK SIZE TOO SMALL
  220. SPROSC775E ERROR WHILE OPENING DDNAME '........' - BAD DCB
  221. SPROSC779E INVALID TAPE LABELS
  222. SPROSC780I TAPE VOLUME: ......
  223. SPROSC781I TAPE ...... DSN: . . . ................. FILE ....
  224. SPROSC782I EXECUTING .... ........ ON .... ...
  225. SPROSC783I ONE OR MORE TAPE BLOCKS WERE OF IMPROPER LENGTH
  226. SPROSC784E MISSING OR EMPTY FILE ON INPUT TAPE
  227. SPROSC785E VOLUME LABEL '......' DOES NOT MATCH 'VOLID ......' OPTION
  228. SPROSC786E DSNAME '....' DOES NOT MATCH 'DSN .....' OPTION
  229. SPROSC787E DSNAME VALUE LONGER THAN 44 BYTES
  230. SPROSC788E SPANNED OR INVALID RECORD FOUND IN INPUT FILE
  231. SPROSC789E NO DSN/FID AVAILABLE FOR INPUT FILE
  232. .cs 6 off
  233.