Instruction manual

SECTION 3. REPORT: SPLIT
PC208W, Version 3.0, Instruction Manual 3-27
from the command line and closes the
application when the specified files have been
processed.
NOTE: There should be no space before
the /R switch. If there is a space, an error
will be returned.
SPLITR allows the user to select different input
and/or output files for an existing parameter file
by entering them on the command line after the
parameter filename. For example:
“SPLITR LOGAN/R TEST.DAT TEST.PRN”
Replaces the Input and Output filenames in
LOGAN.PAR, with TEST.DAT and TEST.PRN,
respectively.
A space must be used to separate parameters.
SPLITR uses as many entries as exist on the
command line. However, the command line is
limited to 255 characters for Windows 95 and
127 characters for Windows NT. The
parameters must be in the following sequence:
Input Filename, Output Filename, Start
Condition, Stop Condition, and Select.
If a parameter is to be left as it is in the
parameter file, space comma space ( , ) may be
entered in the command line. For instance, if
the parameter file LOGAN.PAR contained
TEST1.DAT as an input filename, the following
command line would leave the input file
TEST1.DAT and change the output file to
TEST.PRN.
“SPLITR LOGAN/R , TEST.PRN”
More than one .PAR file can be executed with a
single SPLITR command line. Each .PAR file
and its associated parameters are separated
from the next .PAR file by a semicolon with one
space on each side ( ; ). For example:
“SPLITR LOGAN/R TEST.DAT TEST.PRN ;
SINKS/R TEST1.DAT TEST2.DAT 1[189]”
executes the LOGAN.PAR file on TEST.DAT
and outputs the results to TEST.PRN, then
executes the SINKS.PAR file on TEST1.DAT
and outputs the results to TEST2.DAT.
Execution of SINKS.PAR starts when the first
element in TEST1.DAT is 189.
Batch files containing one or more SPLITR
command lines can be useful for automating
data processing. Batch files can be executed
manually or by setting them up as a Task in
PC208W's Setup window.
Batch files process each command in
succession, without waiting for execution of a
command to be completed before proceeding to
the next unless they are configured to do so. If
multiple parameter files are being processed
using SPLITR in a batch file, there are no
conflicts because only one copy of SPLITR can
be active at any one time. However, if other
commands are used along with SPLITR (such
as opening the file in a spreadsheet, copying it
to an archive directory, or appending it to an
existing file) these commands might be
executed before SPLITR finishes processing
data.
The Windows 95/NT Start /w (wait) parameter
is added to a batch file command line to delay
execution of the next command until the first
command has finished. The syntax for this type
of command line is:
Start /w SPLITR LOGAN/R
By adding the Start /w parameter to the
command line that initiates SPLITR, no further
commands will be processed until the
LOGAN.PAR file has finished execution.
Multiple copies of SplitR can be run at one time
by using the /M switch. This switch must
appear immediately after SplitR. For instance,
a batch file or PC208W task containing the
lines:
SplitR /M Logan/R
SplitR /M Sinks/R
will open two copies of SplitR and process the
two files simultaneously.