NAME
mbsmerg - Combine n Datasets into one according to 5
schemes
SYNOPSIS
mbsmerg [ -N0,-N1,...,-N9ntap(i) ] [ -Ootap ] [ -m ] [ -b ]
[ -B ] [ -S ] [ -Y ] [ -V ] [ -? ]
DESCRIPTION
mbsmerg combines n data sets into one (n=10). The input
traces may be multiplexed record-by-record or input records
may themselves be placed back-to-back either in separate
blocks or in one super block. Note: all input data sets
must have the same traces/record and records/line except
when requesting option -B described below. You cannot pipe
into this program except when running inside IKP but you can
pipe out.
mbsmerg gets both its data and its parameters from command
line arguments. These arguments specify the inputs, output,
multiplexing traces and verbose printout, if desired.
Command line arguments
-N0,-N1,...,-N9 ntap(i)
Enter the input data set name or file immediately after
typing -Ni (i=0,9). This input file should include the
complete path name if the file resides in a different
directory. Example -N0/b/vsp/dummy tells the program
to look for file 'dummy' in directory 'vsp' stored on
the 'b' disk.
-O otap
Enter the output data set name or file immediately
after typing -O. This output file is not required when
piping the output to another process. The output data
set also requires the full path name (see above).
-m If present each output record is composed of traces
from each of the input records interleaved, i.e. multi-
plexed. The input records may have an unequal number
of traces per record. The output record trace count
equals the sum of all the input traces per record. The
program reads a trace from every unit until it com-
pletes an output record and then it starts over with
the first input unit. mpx = true is meant for mul-
ticomponent trace pipelining. This option assumes that
each input record has the same number of traces per
record but it can tolerate some of the last units in
the series having one fewer traces per record.
-b If present the input records are sequenced back-to-back
and the total output record count is n*nrec, where n is
the number of input data sets and nrec is the record
count per input data set. The number of traces/record
on all the input data sets must be the same
-B If present the input records are sequenced as above but
are collected into one super block. The output record
count is therefore nrec. The output number of
traces/record is the sum of each of the input
traces/record values. Each input data set may have
different traces/record values.
-S If present the input data sets are output in sequence,
i.e. all of dataset1 is output followed by all of
dataset2, followed by all of dataset3, etc. The res-
triction here is that all data sets must have the same
number of trace per record.
-Y If present the input data sets are assumed to have been
generated using the -Y option in umerg which outputs
identical data streams trace-by-trace in each stream:
trace1 in each stream, followed by trace2 in each
stream, .... Therefore when gathered up all trace 1's
for streams will be put together, followed by all trace
2's for the streams, .... The user will have to use an
editt to reconfigure this multiplexed data set into
contiguous back-to-back data sets.
-V Enter the command line argument '-V' to get additional
printout.
-? Enter the command line argument '-?' to get online
help. The program terminates after the help screen is
printed.
See Also
umerg mergn
COPYRIGHT
copyright 2001, Amoco Production Company
All Rights Reserved
an affiliate of BP America Inc.
Man(1) output converted with
man2html