Privileges: TSOS
The OPEN statement assigns an input syntax file and an output syntax file. The input syntax file is merged with the new syntax files (MERGE statement). SDF-I stores the result of this process in the output syntax file. SDF-I does not modify the input syntax file.
This statement is mandatory for both merging and unmerging.
The input syntax file must be a system or group syntax file. The output syntax file automatically receives the same type as the input syntax file.
A version number may optionally be specified for the output file. If the output file was activated with SDF (e.g. via MODIFY-SDF-OPTIONS), the SHOW-SDF-OPTIONS command can be used to display this version number..
OPEN |
INPUT-FILE = <filename 1..54> ,OUTPUT-FILE = <filename 1..54> ,VERSION = 'UNDEFINED' / <c-string 1..12> / <alphanum-name 1..12> ,FORMAT = *STD / *OLD / *NEW ,BLKCTRL = *STD / *PAMKEY / *DATA ,WRITE-MODE = *NEW / *REPLACE |
INPUT-FILE = <filename 1..54>
Name of the syntax file to be used as input file. This file is merged with the file specified in the MERGE statement.
SDF-I does not check the logical structure of input syntax files but assumes that they have been correctly generated using SDF-A.
As a rule, the input file is an INSF either supplied by Fujitsu or created in a previous SDF-I run. If such an INSF is not available, the SUSF of SDF should be specified as the input file.
OUTPUT-FILE = <filename 1..54>
Name of the output file after completion of all MERGE and REMOVE statements. It is given the same type (system or group syntax file) as the input file.
An output file under a foreign user ID can only be created by system administration.
VERSION = 'UNDEFINED' / <c-string 1..12> / <alphanum-name 1..12>
Version number stored in the global information of the output file and displayed (following activation of this syntax file) as a result of the SHOW-SDF-OPTIONS command. If no value is explicitly specified, ’UNDEFINED’ is stored in the global information.
FORMAT =
Defines the format with which the output syntax file is to be created. The SHOW-SYNTAX-FILE statement (see "SHOW-SYNTAX-FILE Output information on syntax file ") shows the format entry for a syntax file as V1, V2, V3, V4 or V4.1. The current format is V4.1. The other formats are historical and can only occur in older syntax files.
FORMAT = *STD
Creates an old-format output syntax file if at least one of the syntax files that were processed for it has the new structure. If only syntax files with the old format are present, *STD functions in the same way as FORMAT=*OLD.
FORMAT = *NEW
Expicitly creates a new-format output syntax file. The input syntax files may have any structure.
FORMAT=*NEW is effective only if followed by at least one successful MERGE statement. Any subsequent REMOVE statement does not convert the entire syntax file but only the file contents affected by the REMOVE statement (e.g. global information, command lists, program lists, ...).
FORMAT = *OLD
The operand value is supported for compatibility reasons only.
Syntax files with the old structure (format V1) should not be created any more. Furthermore in this case SDF-I only processes input syntax files with this old structure.
BLKCTRL =
Defines whether the output syntax file and SDF-I files are created with or without PAM keys.
BLKCTRL = *STD
The block control setting of the current task is taken over.
BLKCTRL = *DATA
The output syntax file and SDF-I files are created without PAM keys.
BLKCTRL = *PAMKEY
The output syntax file and SDF-I files are created with PAM keys. The files can only be saved to disks that support PAM keys.
WRITE-MODE =
Defines whether or not the output syntax file exists.
SDF-I works faster if an output file of roughly the required size exists. For example, the user can create a file with the necessary file attributes (primary/secondary allocation) using the CREATE-FILE command, before executing SDF-I.
WRITE-MODE = *NEW
An error message is output if the output syntax file already exists. SDF-I calculates the output syntax file size from the size of the input syntax files.
WRITE-MODE = *REPLACE
The output syntax file must already exist, otherwise an error message is output. SDF-I uses the cataloged file attribute (primary/secondary allocation) for the output syntax file and SDF-I files. The existing output file is overwritten.
Note
If an error occurs during OPEN processing, all subsequent MERGE statements until a new OPEN statement are rejected.