home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / c / conct302.zip / CONCAT.DOC < prev    next >
Text File  |  1993-02-01  |  5KB  |  121 lines
  1. CONCAT.DOC
  2. 02/01/93
  3.  
  4. The CONCAT.EXE program is designed to make concatenating data sets together
  5. easier.  The routine creates a single output file from one or more input files;
  6. it is a file concatenator instead of a file copier.
  7.  
  8. It also allows you to create fixed-length records for uploading to mainframe on
  9. tape.
  10.  
  11.  
  12. CONCAT supports a number of neat concatenation features:
  13.  
  14. * It allows you to copy multiple data sets together as a single file.  DOS's
  15. COPY command can do this as well.
  16.  
  17. * It allows you to store the files to be copied in an external file.  This
  18. insures that the files are copied in the desired order without requiring you to
  19. create lots of intermediate data sets.
  20.  
  21. * It allows you to copy datasets from multiple floppy diskettes.  After it's
  22. copied the desired file(s) from the diskette, it allows you to change the
  23. diskette and resume copying from the new diskette.
  24.  
  25. * It handles SPLTFILE-created files (MYFILE.001 MYFILE.002 etc) from multiple
  26. diskettes without having to copy them to your hard disk before concatenating
  27. them.
  28.  
  29. * In TEXT mode, it allows you to specify that the end of each file is to have
  30. a carriage return/line feed added to it.  This makes sure that each new file
  31. starts at the start of a line.
  32.  
  33. Invoking the program:
  34.  
  35. The program can be invoked with the following options:
  36.  
  37.     CONCAT [ filespec | @filespec | [drive:]filespec+ ] outfile
  38.       [ /OVERWRITE | /APPEND ] [ /BINARY | /TEXT [ /CRLF ] ]
  39.       [ /LRECL=nnn [ /BLKSIZE=nnnn ] ] [ /NAMED ] [ /BEEP | /-BEEP ]
  40.       [ /Q ] [ /? ]
  41.  
  42. where:
  43.  
  44. "filespec" says to concatenate any file(s) with the specified filespec.  For
  45. example, "CONCAT *.PUB NEWFILE.TXT".  The filespec can include a drive and
  46. path designation if desired.
  47.  
  48. "@filespec" says the files to copy are contained in an external file called
  49. "filespec".  The routine will read this file one line at a time and process the
  50. requests sequentially.  Any record which is blank or begins with a semi-colon is
  51. ignored.  Otherwise, the record is presumed to be a valid filespec (with
  52. wildcards if desired). The filespec can include a drive and path designation if
  53. desired.
  54.  
  55.  
  56. "filespec+" says to start with "filespec" (which presumably has an extension of
  57. ".001") and then grab .002, .003 etc.  For example, "CONCAT A:MYFILE.001+
  58. NEWFILE.ZIP".  As with the other filespec inputs, the filespec can include a
  59. drive and path designation if desired.  In most cases, you'll be using the
  60. incrementation feature with a floppy drive like "A:" which is why the drive
  61. designation is specifically shown here.
  62.  
  63. "outfile" is the name of the output file to create.  The filespec can include a
  64. drive and path designation if desired.
  65.  
  66. "/OVERWRITE" says to write over any output file that's already there.  "/APPEND"
  67. says to add the new records at the end of any output file that's already there.
  68. If the output file already exists and neither of these options are specified,
  69. you'll be prompted for the desired action.
  70.  
  71. "/BINARY" says to copy the file in BINARY mode.  This means that the entire file
  72. will be copied based on its designated DOS size designation.  If you copy a text
  73. file with this option, you'll typically have end-of-file (Ctrl-Z) markers within
  74. your text.  These make the file unreadable in many text editors.  BINARY is
  75. required for any binary file; ZIP, COM, EXE, etc.  The default mode is "/TEXT".
  76.  
  77. "/TEXT" says to copy the file in TEXT mode.  The file is copied until the
  78. program reaches an end-of-file (Ctrl-Z) marker and then it stops copying that
  79. file.  TEXT mode is desirable for straight ASCII text documents but it can't be
  80. used with binary files which might contain a Ctrl-Z in them.  The default mode
  81. is "/TEXT".
  82.  
  83. "/CRLF" makes sure that a carriage return/line feed character is written at the
  84. end of each concatenated file.  This insures that each new file will start at
  85. the beginning of a line.
  86.  
  87. "/LRECL=nnn" allows you to say you want to copy the file in TEXT mode (which is
  88. presumed) and you want each record padded to a length of "nnn" characters.  So
  89. "CONCAT VARIABLE.TXT FIXED.TXT /LRECL=100" will take each record in the file
  90. VARIABLE.TXT and pad each record to be 100 characters in length.  Specifying an
  91. LRECL is done for files that have to be copied for a mainframe computer.  When
  92. padding is done, lines do not end with a carriage return/line feed.
  93.  
  94. "/BLKSIZE=nnnn" is mainly an informational parameter.  The routine checks to
  95. make sure your specified BLKSIZE is an even multiple of your LRECL.  If no
  96. BLKSIZE parameter is specified, the routine will tell you what the blocksize
  97. should be; giving you the highest blocksize under the CD Publisher's default
  98. blocksize of 8192 bytes.
  99.  
  100.  
  101. "/NAMED" adds a couple of lines within the concatenated file telling you the
  102. name of the original file.  These lines show up before each block from the
  103. original file in a manner similar to that seen with DOS' FIND command.
  104.  
  105. "/BEEP" gives you a beep when the program finishes.
  106.  
  107. "/-BEEP" reverses /BEEP and is the default.
  108.  
  109. "/Q" says to go into Quiet mode.  You will not get the normal block-by-block
  110. play that normally shows up.
  111.  
  112. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  113.  
  114.  
  115. Program written by Bruce Guthrie.  Comments and suggestions can be sent to:
  116.  
  117.                 Bruce Guthrie
  118.                 Wayne Software
  119.                 113 Sheffield St.
  120.                 Silver Spring, MD 20910
  121.