Download User Manual

Linking MPE and KSAM Files
Suprlink's input or link files can come from datasets, MPE files or KSAM files.
Before linking either an MPE or KSAM file, you must convert the file into a selfdescribing file. Because MPE and KSAM files have no implied structure, you must
use Suprtool's Define and Extract commands to define the structure of the file.
Suprlink's only requirement is that the file contain a sort field and some optional data
fields. The sort field does not have to be the first field in the record. The following
example demonstrates how to convert an MPE file into a self-describing file:
:run suprtool.pub.robelle
>input mpecust
>def first-fields,1,10
>def sort-field,11,6
>def last-fields,17,20
>extract first-fields
>extract sort-field
>extract last-fields
>sort sort-field
>output sdfile,link
>xeq
{regular MPE file}
{fields before the sort field}
{sort field for this file}
{fields after the sort field}
{remember to extract all of the}
{ fields in the correct order}
{must also remember the sort}
{use the Link option}
This example would sort the entire MPE file. To select a subset, you would define
more fields and use the If command. Treat KSAM files exactly the same way.
Suprtool does not read KSAM files in sorted order, so you must remember to specify
the sort explicitly when converting the KSAM file to a self-describing file.
Suprlink cannot create nor write to KSAM files. You can use Suprtool to load a
KSAM file with the output from Suprlink.
CI Variable Substitution
Suprlink is able to substitute any CI variables from any command line source,
whether thru interactive, use file or batch input.
In order to use this feature, first issue the following Set command:
set varsub on
Variable Substitution is not on by default for backward compatibility.
Batch
Since the Streams facility (under default setups) will replace any "!" found in the first
column of a job stream. Anytime you want to specify an entire line thru Variable
Substitution you will need to leave a space before the variable is specified.
!setvar input "i dfile by message-no"
!run suprlink.pub.robelle
+set varsub on
+ !input
Notes
For MPE commands some variables will be resolved twice when passed off to MPE,
which will give different values for a variable.
Setting variables at the CI level:
342 • Introduction to Suprlink
Suprtool 4.4 for HP e3000: Suprlink