OPEN-PARAMETER-FILE Create or open parameter file

The OPEN-PARAMETER-FILE statement is used to open an existing parameter file or to create a new one. The format of the parameter file is defined at the time it is created.

Format *V2 is the format which is currently supported for parameter files. Parameter files in format *V1 cannot be used in the current SDF versions. Consequently only format *V2 makes sense when creating a parameter file.

The names of syntax files can also be entered at the time of creating the parameter file. A parameter file in *V2 format is created by default, and the name '$.SYS.SDF.SYSTEM.SYNTAX' is entered in it as the basic system syntax file.

OPEN-PARAMETER-FILE

NAME = <filename 1..54 without-gen-vers>

,MODE = *READ / *UPDATE / *CREATE(...)

*CREATE(...)

VERSION = *V2 / *V1

,SYSTEM-SYNTAX-FILE = *STD / <filename 1..54 without-gen-vers>

,GROUP-SYNTAX-FILE = *NONE / *STD(...) / <filename 1..54 without-gen-vers>(...)

*STD(...)

PROFILE-ID = SYS-TSOS / <structured-name 1..30>

,HIERARCHY = *YES / *NO

<filename 1..54 without-gen-vers>(...)

PROFILE-ID = SYS-TSOS / <structured-name 1..30>

,HIERARCHY = *YES / *NO

NAME = <filename 1..54 without-gen-vers>
Name of the parameter file to be opened or created.

MODE =
Specifies whether the parameter file is to be opened as a read-only file, as a file to be updated, or as a file to be created.

MODE = *READ
The existing parameter file is opened for read access only.

MODE = *UPDATE
The existing parameter file is opened in read/write mode.

MODE = *CREATE(...)
The parameter file is created and opened in read/write mode. If a parameter file with the specified name already exists, the statement is rejected.

VERSION =
Defines the format of the parameter file.

VERSION = *V2
The parameter file is created in the currently supported *V2 format.

VERSION = *V1
The operand value is supported for compatibility reasons only.
Parameter files with *V1 format can not be used in the current SDF version.

SYSTEM-SYNTAX-FILE =
Determines the entry for the basic system syntax file.

SYSTEM-SYNTAX-FILE = *STD
The name '$.SYS.SDF.SYSTEM.SYNTAX' is entered in the parameter file as the basic system syntax file.

SYSTEM-SYNTAX-FILE = <filename 1..54 without-gen-vers>
Name of the basic syntax file to be entered in the parameter file.

GROUP-SYNTAX-FILE =
Determines the group syntax file entry for the default user ID.

GROUP-SYNTAX-FILE = *NONE
No group syntax file is entered for the default user ID.

GROUP-SYNTAX-FILE = *STD
The group syntax file '$.SYS.SDF.GROUP.SYNTAX' is entered for the default user ID.

PROFILE-ID = SYS-TSOS / <structured-name 1..30>
Defines the profile ID to which the group syntax file is assigned. The default value is SYS-TSOS, since SDF also uses this value for the user ID TSOS.

HIERARCHY =
Specifies whether the SDF file hierarchy is to be retained for the syntax analysis of commands/statements of a user task with the specified profile ID, i.e. whether the system syntax files are to be used for syntax analysis.

HIERARCHY = *YES
The system syntax files are activated by default on creating the user task. The SDF file hierarchy is retained.

HIERARCHY = *NO
The system syntax files are deactivated immediately after LOGON processing. The definitions in the system syntax files are therefore irrelevant for users with the specified profile ID; only the definitions stored in the associated group syntax file apply. Group syntax files defined with HIERARCHY=*NO must contain at least the EXIT-JOB (or LOGOFF) command in addition to global information, since this is the only way to terminate a user task to which the defined profile ID is assigned.

GROUP-SYNTAX-FILE = <filename 1..54 without-gen-vers>
The group syntax file with the specified name is entered for the default user ID.

PROFILE-ID = SYS-TSOS / <structured-name 1..30>
Defines the profile ID to which the group syntax file is assigned. The default value is SYS-TSOS, since SDF also uses this value for the user ID TSOS.

HIERARCHY =
Specifies whether the SDF file hierarchy is to be retained for the syntax analysis of commands/statements of a user task with the specified profile ID, i.e. whether the system syntax files are to be used for syntax analysis.

HIERARCHY = *YES
The system syntax files are activated by default on creating the user task. The SDF file hierarchy is retained.

HIERARCHY = *NO
The system syntax files are deactivated immediately after LOGON processing. The definitions in the system syntax file are therefore irrelevant for users with the specified profile ID; only the definitions stored in the associated group syntax file apply. Group syntax files defined with HIERARCHY=*NO must contain at least the EXIT-JOB (or LOGOFF) command in addition to global information, since this is the only way to terminate a user task to which the defined profile ID is assigned.