The MAKETAPE utility reads binary or ASCII line sequential files and builds either a Standard Labeled or unlabeled .AWS tape output file.
You can specify the blocking factor to be used for the output datasets, the logical record length of the input and output files, and whether all input files should be placed into a single logical output file or whether the data from each input file should be written to a separate unique logical output file.
maketape ARG: value [ARG: value] [OPTION] ...
There do not appear to be any positional arguments. All arguments are keyword based, with the INPUT: and OUTPUT: arguments always being required, and the other arguments and/or options being either optional or possibly required based on the values chosen for the other arguments/options.
For example, if the NLTAPE option is specified, then the VOLSER: and DATASET: arguments are obviously not required. Similarly, if the BINARY option is specified then the CODEPAGE: argument is ignored.
ANSI
Specifying the ANSI option causes ANSI format Standard Labels to be written to your output tape file.
Choosing this option also causes your chosen input data to not be translated to EBCDIC before writing it to the output tape file.
BINARY
Specify the BINARY option to prevent any ASCII to EBCDIC translation from occurring when writing the chosen input file
to the tape output file.
When this option is specified the input data will be written exactly as-is to the
output file. That is to say, any records shorter than the specified LRECL: are not padded with blanks nor translated.
If this option is not specified however, then each input record is considered to be a text record and will first be
padded with blanks to reach the specified LRECL: and then translated from ASCII to EBCDIC using the Code Page specified
by the CODEPAGE: option before being written to the output tape.
NOTE: When a "meta-file" is used as input (refer to the INPUT: option further below),
the BINARY option is applied by default to all files listed in your meta-file.
If you wish to be able to have some files processed as binary files and other files
processed as text files, then do not specify the BINARY option, and use the 'BIN'
meta-file keyword instead.
BLOCK:
Specifies the desired Blocking Factor to be used in determining how large each tape output block will be. The blocking factor is used to calculate the size of the tape output blocks. The logical record length (LRECL:) multiplied by the blocking factor (BLOCK:) is how many bytes large each output tape block will be.
CODEPAGE:
Specifies which ASCII to EBCDIC translation Code Page you wish to use in translating your ASCII input data to EBCDIC before being written to the output tape file. Ignored when the BINARY option is specified.
Refer to Hercules documentation for the CODEPAGE configuration file option for a list of valid code pages.
DATASET:
Specifies the 1-17 character dataset name to be used in the HDR1 Standard Label written to the tape output file. Ignored when the NLTAPE option is specified.
INPUT:
Specifies the full path filename of your desired input file. Enclose the value within double quotes if it contains any blanks.
If the first character of the filename begins with an "@" ('at' sign)], then the specified file is actually a "meta-file" containing the actual list files to be used for input.
If the use of a "meta-file" is specified, each statement of the meta-file is the name
of the actual input file to be used, optionally preceded with the keyword 'BIN' and separated
from the filename with a single blank. This allows you to create a tape with a mixture of
both BINARY and text files. Text file meta-file statements consist of only the filename.
Binary file meta-file statements begin with the keyword 'BIN' followed by a single blank
and then the name of the input file. The maximum number of files that may be specified in
a meta-file is 50. Any excess is ignored with a warning message.
LRECL:
Specifies the Logical Record Length that each input and output data record is expected to be. Input records which are
longer than this value will be truncated. Records shorter than this value will be padded with blanks unless the BINARY
option is specified. (When the BINARY option is specified, records shorter than this value are not padded at
all and are instead written out exactly as-is to the output file.)
NLTAPE
Specifying the NLTAPE option will cause the output tape to be created without any Standard Labels. When specified, the output tape will begin immediately with data, and each file will be separated from the other with a single tapemark, with two consecutive tapemarks being written at the end of the tape.
OUTPUT:
Specifies the full path filename of your desired .AWS tape output file. Enclose the value within double quotes if it contains any blanks.
UNIQUE
Specifies that each input file is to be placed into a separate dataset on the output tape. For normal Standard Labeled output, each file will be wrapped in its own set of HDR/EOF1 Standard Labels. For non-labeled output each dataset will be separated from the others with a single tapemark.
VOLSER:
Specify the 1-6 character volume serial number to be used in the VOL1 and HDR1 Standard Labels written to the tape output file. Ignored when the NLTAPE option is specified.
Bug reports (together with your diagnosis of the fault, please!) should be either entered into our Github issue tracker (preferred), or else reported via message to the main hercules-390 discussion group.