Preparing the SM2U1 session

Prior to calling SM2U1, the program must be provided with the input and output files, together with the corresponding link names. In the case of input files, SM2U1 checks whether a user-specific file is assigned to the file link name. If it is, only the MERGE-FILES statement is provided. In all other cases (including errors on opening the first input file), SM2U1 assumes that the file is a system-global SM2 output file and makes all SM2U1 statements available.

Depending on the SM2U1 function required, three different applications are possible:

1. Merge files function

   Statements: MERGE-FILES (for user-specific and system-global files), SELECT-MEASUREMENT GROUPS, END

   SM2U1 processes as many input files as there are link names, in ascending order. The input files are specified using the ADD-FILE-LINK command. The corresponding file names are: SM2UI1, SM2UI2, .. , SM2UI99. Up to 99 files can be merged; they can be either PAM or SAM type files. The output file is likewise assigned via a ADD-FILE-LINK command using the link name SM2UO.

   /ADD-FILE-LINK LINK-NAME=SM2UI1,FILE-NAME=SM2-output-file1
   /ADD-FILE-LINK LINK-NAME=SM2UI2,FILE-NAME=SM2-output-file2
          .
          .
          .
   /CREATE-FILE FILE-NAME=SM2-output-file,
                SUPPORT=...(VOLUME=...,DEVICE-TYP=...,SPACE=...)
   /ADD-FILE-LINK LINK-NAME=SM2UO,FILE-NAME=SM2-output-file,
                OPEN-MODE=...
   

2. Information output function

   Statement: SHOW-INFORMATION

   SM2U1 processes as many input files as there are link names, in ascending order. The ADD-FILE-LINK command is used to specify the input files. The link names of the files are then SM2UI1, SM2UI2, ..., SM2UI99 (i.e. up to another 99 input files).

   /ADD-FILE-LINK LINK-NAME=SM2UI1,FILE-NAME=SM2-output-file1
   /ADD-FILE-LINK LINK-NAME=SM2UI2,FILE-NAME=SM2-output-file2
                  .
                  .
                  .
   

3. Separate files function

   Statement: SEPARATE-FILES

   SM2U1 processes an input file with the link name SM2UI. Up to 99 output files can be specified using the link names SM2UO1... SM2UO99.

   /ADD-FILE-LINK LINK-NAME=SM2UI,FILE-NAME=SM2-output-file
   /CREATE-FILE FILE-NAME=SM2-output-file1,
                SUPPORT=...(VOLUME=...,DEVICE-TYP=...,SPACE=...)
   /CREATE-FILE FILE-NAME=SM2-output-file2,
                SUPPORT=...(VOLUME=...,DEVICE-TYP=...,SPACE=...)
          .
          .
          .
   /ADD-FILE-LINK LINK-NAME=SM2UO1,FILE-NAME=SM2-output-file1,
                OPEN-MODE=...
   /ADD-FILE-LINK LINK-NAME=SM2UO2,FILE-NAME=SM2-output-file2,
                OPEN-MODE=...
          .
          .
          .
   

Following successful processing of the statement, file names SM2UI1 through SM2UI99 of the input file(s) or SM2UO1 through SM2UO99 of the output files are released by the program. SM2U1 outputs the following message for each output file: NUMBER OF RECORDS WRITTEN: number