Base Configuration

This chapter describes configuration items required for OpenFrame/Base operation.

1. Overview

For operation of OpenFrame/Base (hereafter Base), set KEYs of each SECTION in the openframe_base.conf file, and then save the system settings by using the ofconfig tool.

Certain KEYs have no default value (NONE). Refer to the Remark for their behaviors when they are not set.

The following are descriptions of each subject’s sections. For further details about setting values of each section’s keys, refer to the corresponding section.

  • acs

    Configures the assignment rules for three SMS classes (data, management and storage) used in OpenFrame Storage Management System.

    Section Description

    DSNAME

    Data set name containing wildcard characters (%, *) and the unit name described in JCL DD statements. Allows the user to specify an SMS class.

    PREFIX

    Prefix of the data set name containing wildcard characters (%, *) and the unit name described in JCL DD statements. Allows the user to specify an SMS class.

    SUFFIX

    Suffix of the data set name containing wildcard characters (%, *) and the unit name described in JCL DD statements. Allows the user to specify an SMS class.

  • api3270

    Configures the general functionalities for 3270 stream conversion in OpenFrame.

    Section Description

    CPM

    CPM file to use during 3270 stream conversion.

    CPM_FLAG

    How to configure SOSI codes to identify double-byte characters during 3280 stream conversion.

  • console

    Configures console and command settings in OpenFrame.

    Section Description

    CONSOLE

    Console server and client settings.

    COMMAND

    Command server and command processing interfaces.

  • cpm

    Configures settings for code page conversion in OpenFrame.

    Section Description

    DEFAULT_CODEPAGE

    CPM data file to be used by default.

  • ds

    Configures the general settings for data sets used in OpenFrame.

    Section Description

    DATASET_DIRECTORY

    Data set directories.

    DATASET_RESOURCE

    Data set resources.

    DATASET_DEFAULT

    Default settings for data sets.

    DATASET_LOCK

    Information about lock clients.

    AMS_DEFAULT

    Basic information about access method service.

    ICF_CATALOG

    Basic information about integrated catalogs.

    FILE_HANDLER

    Basic information about the external file handler.

    TSAM_RDB

    TSAM usage information for business-purpose VSAM data sets.

    TSAM_BACKUP

    Backup connection information used when TSAM fails to connect to business-purpose VSAM data sets.

  • dstool

    Configures settings for data set related tools.

    Section Description

    COBGENSCH

    Settings for the cobgensch tool.

    COMMON

    Common settings for dataset tools.

    DSCREATE

    Settings for the dscreate tool.

    DSLOAD

    Settings for the dsload and dssave tools.

    DSMIGIN

    Settings for the dsmigin and dsmigout tools.

    DSVIEW

    Settings for the dsview and dsedit tools.

    OFRDMSVR

    Basic settings for the ofrdmsvr server.

    OFRDSEDT

    Basic settings for ofrdsedt server.

    OFRUISVR

    Basic settings for the ofruisvr server.

    SPFEDIT

    Settings for the spfedit tool.

  • keyseq

    Configures the sorting order of the key sequence (in EBCDIC or ASCII) of index data sets (VSAM KSDS or ISAM) used in OpenFrame.

    Section Description

    DSNAME

    User-defined key sequence to select with a data set name containing wildcard characters (%, *) and the UNIT name described in a JCL DD statement.

    PREFIX

    User-defined key sequence to select with the prefix of a data set name containing wildcard characters (%, *) and the UNIT name described in a JCL DD statement.

    SUFFIX

    User-defined key sequence to select with the suffix of a data set name containing wildcard characters (%, *) and the UNIT name described in a JCL DD statement.

  • ofsys

    Configures the overall settings of OpenFrame, especially for the directory structure.

    Section Description

    DIRECTORY

    OpenFrame system directory information.

    EXTENSION

    File extensions used in OpenFrame.

    COMPILER

    COBOL and PL/I compiler options.

    LOG

    Settings about log files generated by OpenFrame.

    WEBDE

    WEBDE-related settings used in OpenFrame.

    WEBDE_CPY_LIB

    WEBDE Copybook-related settings used in OpenFrame.

    SYSTEM_INFO

    System-specific values used in OpenFrame.

  • saf

    Configures settings for access control in OpenFrame.

    Section Description

    SAF_DEFAULT

    Basic information required for SAF operations.

    AUTH_METHOD

    Authentication method used in SAF.

    OFRSASVR

    Settings required for the ofrsasvr server.

    ERRCODE

    Messages for user-defined error codes in saf_exit.

    TACF_DUMMY

    Settings for TACF dummy.

  • smf

    Configures settings for SMF.

    Section Description

    DATASET

    Data sets and nodes to be used for SMF.

  • sms

    Configures settings for three SMS classes (data, management, and storage classes) used in OpenFrame Storage Management System.

    Section Description

    DATACLAS

    User-specified data class.

    MGMTCLAS

    User-specified management class.

    STORCLAS

    User-specified storage class.

  • sort

    Configures settings for OpenFrame SORT utility.

    Section Description

    WORKSPACE

    Location of the workspace used for SORT operations.

    OPTION

    Options for the SORT utility.

    PATH

    Binary path.

    SEQUENCE

    Location of the file that defines user-defined collating sequence.

    TEXTSM_DEFAULT

    Options for TEXTSM.

2. acs

Configures the assignment rules for three SMS classes (data, management and storage) used in OpenFrame Storage Management System.

The following three rules apply to assign the SMS classes to a data set:

  • Use the data set name.

  • Use the prefix of the data set name.

  • Use the suffix of the data set name.

If a data set name satisfies all three rules, the data set name is given the highest priority for assigning an SMS class and the suffix of the data set name, the lowest. If a data set name meets multiple criteria of one rule, the one with greater number of matching characters is selected. The names of SMS classes must be predefined.

If too many rules are set for this configuration item, the operation of data set allocation may be performed at lower speeds.

2.1. DSNAME

Data set name containing wildcard characters (%, *) and the unit name described in JCL DD statements. Allows the user to specify an SMS class. The user can customize and add keys and values according to the purpose.

The following is the description of an example specified in the openframe_base.conf file.

Item Description

'%'

Corresponds precisely to one alphabet letter or a number.

'*'

Corresponds to one or more letters in one qualifier.

2.1.1. SAMPLE.NV*.%%DS01

Assigns an SMS class with the data set name and unit name. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

Range

Remark

  • Format

    DsName[+Unit]=[DataClas],[MgmtClas],[StorClas]
  • Example

    The following example specifies the data, management and storage classes to DCLAS001,MCLAS001 and SCLAS001 respectively when the dataset name rule matches the key. These classes must be predefined in the SMS configuration.

    DCLAS001,MCLAS001,SCLAS001

2.2. PREFIX

Prefix of the data set name containing wildcard characters (%, *) and the unit name described in JCL DD statements. Allows the user to specify an SMS class. The user can customize and add keys and values according to the purpose.

The following is the description of an example specified in the openframe_base.conf file.

Item Description

'%'

Corresponds precisely to one alphabet letter or a number.

'*'

Corresponds to one or more letters in one qualifier.

2.2.1. SAMPLE.NVSM.

Assigns an SMS class with the prefix of the data set name and unit name. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

Range

Remark

  • Format

    Prefix[+Unit]=[DataClas],[MgmtClas],[StorClas]
  • Example

    The following example specifies the data, management and storage classes to DCLAS001,MCLAS001 and SCLAS001 respectively when the dataset name rule matches the key. These classes must be predefined in the SMS configuration.

    DCLAS001,MCLAS001,SCLAS001

2.3. SUFFIX

Suffix of the data set name containing wildcard characters (%, *) and the unit name described in JCL DD statements. Allows the user to specify an SMS class. The user can customize and add keys and values according to the purpose.

The following is the description of an example specified in the openframe_base.conf file.

Item Description

'%'

Corresponds precisely to one alphabet letter or a number.

'*'

Corresponds to one or more letters in one qualifier.

2.3.1. .NVSM.DS01

Assigns an SMS class with the suffix of the data set name and unit name. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

Range

Remark

  • Format

    Suffix[+Unit]=[DataClas],[MgmtClas],[StorClas]
  • Example

    The following example specifies the data, management and storage classes to DCLAS001,MCLAS001 and SCLAS001 respectively when the dataset name rule matches the key. These classes must be predefined in the SMS configuration.

    DCLAS001,MCLAS001,SCLAS001

3. api3270

Configures the general functionalities for 3270 stream conversion in OpenFrame.

3.1. CPM

Sets the CPM file to be used during 3270 stream conversion.

3.1.1. EBCDIC_TO_ASCII

CPM file to use for converting the mainframe’s EBCDIC code to OpenFrame’s ASCII during 3270 stream conversion.

Item Description

Parameter Type

String

Default Value

EBCASCJP.cpm

Range

Remark

3.1.2. ASCII_TO_EBCDIC

CPM file to use for converting the OpenFrame’s ASCII code to mainframe’s EBCDIC during 3270 stream conversion.

Item Description

Parameter Type

String

Default Value

ASCEBCJP.cpm

Range

Remark

3.2. CPM_FLAG

Sets the configuration methods of SOSI codes to identify double-byte characters during 3270 stream conversion.

3.2.1. EBCDIC_TO_ASCII

Configuration methods of SOSI codes to use for converting the mainframe’s EBCDIC code to OpenFrame’s ASCII during 3270 stream conversion.

Item Description

Parameter Type

String

Default Value

CPM_CONVERT_SOSI_TO_SPACE

Range

Remark

  • CPM_CONVERT_SOSI_TO_SPACE: Converts SOSI to spaces.

  • CPM_CONVERT_SOSI_TO_NULL: Converts SOSI to null values.

  • CPM_CONVERT_ADD_SOSI: Adds SOSI when a double-byte character is identified.

3.2.2. ASCII_TO_EBCDIC

Configuration methods of SOSI codes to use for converting the OpenFrame’s ASCII code to mainframe’s EBCDIC during 3270 stream conversion.

Item Description

Parameter Type

String

Default Value

CPM_CONVERT_SPACE_TO_SOSI

Range

Remark

  • CPM_CONVERT_SPACE_TO_SOSI: Converts spaces to SOSI.

  • CPM_CONVERT_NULL_TO_SOSI: Converts null values to SOSI.

  • CPM_CONVERT_ADD_SOSI: Adds SOSI when a double-byte character is identified.

4. console

Configures console and command settings in OpenFrame.

4.1. CONSOLE

Sets the console server and client settings.

4.1.1. RETRY_COUNT

Number of attempts to reconnect when the ofrcmsvr server is down.

Item Description

Parameter Type

Number

Default Value

3

Range

0 to (2^31 - 1)

Remark

4.1.2. RETRY_INTERVAL

Time interval between attempts to reconnect when the ofrcmsvr server is down.

Item Description

Parameter Type

Number

Default Value

5 (Unit: seconds)

Range

0 to (2^31 - 1)

Remark

4.1.3. ALIVE_INTERVAL

Time interval between server startup checks in tconmgr.

Item Description

Parameter Type

Number

Default Value

10 (Unit: seconds)

Range

0 to (2^31-1) / 10

Remark

4.1.4. CHECK_AUTH

Option to check the authority for data set operations.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Checks the authority.

  • NO: Does not check the authority.

4.1.5. CONSOLE_MSG_TO_SCREEN

Processing of the DISPLAY UPON CONSOLE command in COBOL applications running in TSO CLIST.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Displays on TSO.

  • NO: Displays on console (tconmgr).

4.1.6. EXTENDED_JOB_INFO

Option to display job information on the beginning part of the message sent to the console.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Displays user name, JOBID and JOBNAME of the source of the message.

  • NO: Displays JOBID of the source of the message. If no JOBID, user name.

4.1.7. CRITICAL_MSG_MAX_COUNT

Maximum number of the EXEC CICS WRITE OPERATOR CRITICAL commands to be processed in COBOL applications running in OpenFrame/OSC.

Item Description

Parameter Type

Number

Default Value

1024

Range

0 to (2^31 - 1)

Remark

4.1.8. EXPANDED_CONSOLE

Option to extend the width of the console window.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Extends the width to 133 bytes.

  • NO: Does not extend the width. (80 bytes)

4.1.9. CLEAR_TERMINATED_REQUEST

Option to delete client’s accept request messages remaining after the client has been terminated.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Deletes accept request messages.

  • NO: Does not delete accept request messages.

4.1.10. IGNORE_DEFAULT_MSG

Option to display the default message on the console window.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Does not display any messages during a command or request operation (except the display message).

  • NO: Displays the default message ('Accept request received!!!' and 'Process has been terminated').

4.1.11. DISPLAY_CONSOLE_MSG_TO_SYSMSG

Option to display a message of a DISPLAY UPON CONSOLE statement in a COBOL application or a message with WTO ROUTCDE=11 in an ASM application in SYSMSG of JOB SPOOL as well as a console.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Displays in the console (tconmgr) and SYSMSG.

  • NO: Displays in the console (tconmgr).

4.1.12. PRINT_REPLY_USER

Option to display the name of the user operating the program on a reply message to send from a console program such as tconmgr.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Displays the name of the user who operates the program.

  • NO: Does not display the user name.

4.2. COMMAND

Sets interfaces for the command server and processing.

4.2.1. {COMMAND_NAME}

Name of a command to use for processing commands and defines an interface for it.

Item Description

Parameter Type

String

Default Value

Range

Remark

The value varies depending on the command processing interface.

As in the following example, COMMAND has four command processing interfaces with its values: SERVICE, PGM, PARAM, NOTSUPPORT. The syntax varies with each interface.

[COMMAND]
      SERVICE, <service-name>[, <userinfo-opt>][, <service-opt1>]
                [, <service-opt2>][, ... <service-opt7>]
      PGM, <program-name>[, <userinfo-opt>][, <program-argument1>]
                [, <program-argument2>][, ... <program-argument7>]
      PARAM
      NOTSUPPORT
  • SERVICE

    Invokes a Tmax service. Descriptions of each item are as follows:

    Item Description

    service-name

    Name of the Tmax service to call.

    userinfo-opt

    Set to one of the following:

    • TOKEN: Passes the user information to the token when service is invoked.

    • SACEE: Passes the user information to SACEE when service is invoked.

    • NONE: Does not pass the user information when service is invoked.

    service-opt

    Set to one of the following:

    • FIELD: Saves the command’s parameters in the FB_COMMAND field before passing them when service is invoked.

    • STRING: Passes the command’s parameters in strings when service is invoked.

  • PGM

    Executes a program. The default user information is set by exporting COMMAND_USERID=<userid> to the environment variables. Description of each item are as follows:

    Item Description

    program-name

    Program to be executed.

    userinfo-opt

    Set to one of the following:

    • TOKEN: Exports COMMAND_TOKEN=<tacf-token> to environment variables.

    • SACEE: Exports COMMAND_SACEE=<tacf-sacee> to the environment variables.

    • NONE: No export to the environment variables.

    program-argument

    Argument of the program to be executed.

  • PARAM

    Processes a command depending on the first parameter value of the command. Describes additional clauses with the name of the command that described PARAM, and then decides to process depending on the command’s parameter value.

    The following example processes a command 'F' by its first parameter 'DTS'.

    [COMMAND]
        F=PARAM
    [F]
        DTS=PGM,dts_program
  • NOTSUPPORT

    Displays a log message without processing commands.

5. cpm

Configures settings for code page conversion in OpenFrame.

5.1. DEFAULT_CODEPAGE

Spets the CPM data file to be used by default.

5.1.1. EBC2ASC

UNIX path to the default CPM data file to be used for converting EBCDIC to ASCII.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/cpm/EBCASCUS.cpm

Range

Remark

5.1.2. ASC2EBC

UNIX path to the default CPM data file to be used for converting ASCII to EBCDIC.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/cpm/ASCEBCUS.cpm

Range

Remark

5.1.3. SO

Hexa code of SO for processing double-byte characters in IMS Message Format Service. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

0A42

Range

Remark

5.1.4. SI

Hexa code of SI for processing double-byte characters in IMS Message Format Service. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

0A41

Range

Remark

6. ds

Configures the general settings for data sets used in OpenFrame.

6.1. DATASET_DIRECTORY

Sets data set directories.

6.1.1. SCHEMA_DIR

Directory path for storing the data set schema information to be used for migrating data sets. Used by the dsmigout and dsmigout tools.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/schema

Range

Remark

6.2. DATASET_RESOURCE

Sets data set resources.

6.2.1. DATASET_SHMKEY

Shared memory key used for allocating data sets.

Item Description

Parameter Type

String

Default Value

0x805

Range

Remark

Set to decimal or hexadecimal numbers. Append '0x' before hexadecimal numbers.

6.3. DATASET_DEFAULT

Sets the default settings for data sets.

6.3.1. DEFAULT_VOLSER

Name of the default volume serial. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

DEFVOL

Range

Remark

Maximum allowable length is 6 bytes.

6.3.2. DEFAULT_MGMTCLAS

Name of the class to be used by default among the user-specified management classes. All nodes in a multi-mode environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

Range

Remark

Example) MCLAS001

6.3.3. DEFAULT_STORCLAS

Name of the class to be used by default among the user-specified storage classes. All nodes in a multi-mode environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

Range

Remark

Example) SCLAS001

6.3.4. SPOOL_VOLSER

Name of the SPOOL volume serial. All nodes in a multi-mode environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

VSPOOL

Range

Remark

6.3.5. NVSM_BUFFER_SIZE

Buffer size of non-VSAM data sets. All nodes in a multi-mode environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

32 (Unit: Kbyte)

Range

0 to (2^31 - 1) / 1024

Remark

Setting several dozens times bigger than the data set block size only leads to an excessive memory consumption without any significant improvement in performance. In general, the default value is used. If there is sufficient memory available, a slightly bigger value can be used.

6.3.6. NVSM_EXTENT_LIMIT

Maximum number of extents for non-VSAM data sets. All nodes in a multi-mode environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

15

Range

0 to (2^31 - 1)

Remark

Use the default value. If the size of the non-VSAM data set in use exceeds the limit with the default value, then use a slightly higher value.

6.3.7. DISP_KEEP_IMPLIES

Whether to catalog the data set whose disposition is KEEP. All nodes in a multi-mode environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

KEEP

Range

CATLG, KEEP

Remark

  • CATLG: Catalogs the data set disposed as KEEP. In other words, all data sets are cataloged.

  • KEEP: Does not forcefully catalog data sets disposed as KEEP.

6.3.8. IGNORE_DS_DUPLICATE

Whether to raise an error when a file with the same name already exists in the volume directory of the data set allocated as NEW. All nodes in a multi-mode environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Does not raise an error when there exists a file with the same name.

  • NO: Raises an error when there exists a file with the same name.

6.3.9. VOLUME_SELECT_METHOD

Method of selecting a volume to allocate a new data set among multiple other volumes. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

AMPLE

Range

AMPLE, FIRST

Remark

  • AMPLE: Selects the volume with the largest free space.

  • FIRST: Selects the volume with the earliest number.

6.3.10. UNIT_VOLUME_MISMATCH

Whether to raise an error when there is a mismatch between the specified unit information and volume information. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

IGNORE

Range

IGNORE, STRICT

Remark

  • IGNORE: Does not raise an error when there is a mismatch between the unit and volume information.

  • STRICT: Raises an error when there is a mismatch between the unit and volume information.

6.3.11. GUARANTEED_DS_SPACE

Whether to specify a volume or unit in an explicit way when creating a new data set. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Raises an error when there is no volume or unit information.

  • NO: Does not raise an error when there is no volume or unit information, and uses the SMS storage class or the default volume information.

6.3.12. DS_OLDSHR_UNIT_METHOD

Whether to use a new allocation method specifying the unit when allocating a data set whose disposition is OLD or SHR. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

OLD

Range

OLD, NEW

Remark

  • OLD: If only the unit is specified and the volume is not, and if the data set cannot be found in the catalog, then the volume included in the unit is explored. If only the volume is specified and the unit is not, the volume is explored.

  • NEW: If only the unit is specified and the volume is not, and if the data set cannot be found in the catalog, then an error is raised. If only the volume is specified and the unit is not, an error is raised as well.

6.3.13. DSALC_SLOT_COUNT

Maximum number of slots to allocate data sets. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

8192

Range

256 to 65535

Remark

The slot number 0 is reserved for internal use in the system, therefore not used for actual data set allocation. Hence, the maximum number of data sets you can allocate is (specified value - 1).

6.3.14. DATASET_SIZE_LIMIT

Maximum allowable size of a non-VSAM data set. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

0 (Unit: Kbyte)

Range

0 to 2147483647

Remark

Take into account the maximum size of a non-VSAM data set that can be allowed by the system. If set to 0, no limit on the size of a data set.

6.3.15. CHECK_DSAUTH_V2

Whether to perform authority check when allocating a data set.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Performs authority check.

  • NO: Does not perform authority check.

6.3.16. USE_PDS_DIRECTORY

Whether to use the directory function of partitioned data set (PDS).

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

PDS directory contains the owner information.

  • YES: Uses the PDS directory function.

  • NO: Does not use the PDS directory function.

6.3.17. USE_PDSE_SHARING

Whether to apply the sharing method used for partitioned data sets extended (PDSE) to partitioned data sets (PDS). All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Uses the sharing functionality of PDSE. Using DISP=SHR on a PDS guarantees a secure sharing between members. You can use dscreate, dsdelete, dsedit and spfedit to allocate data sets with DISP=SHR.

  • NO: Does not use the sharing functionality of PDSE. If multiple jobs share one member when using DISP=SHR on a PDS, the integrity of data sets cannot be ensured. You can use dscreate, dsdelete, dsedit and spfedit to allocate data sets with DISP=OLD to ensure security.

6.3.18. USE_PDSE_SHARING_DBMSLOCK

Whether to use DBMS LOCK for PDSE sharing function. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

YES

Default Value

NO

Range

YES, NO

Remark

Runs only if USE_PDSE_SHARING=YES. Cannot be used along with the RELAX_MEMBER_NAME_LIMIT option.

  • YES: Uses DBMS LOCK for PDSE sharing function.

  • NO: Uses FILE LOCK for PDSE sharing function.

6.3.19. CHECK_BROKEN_RECORD

Whether to raise an error when a data set of record format type 'F' is broken, because of which records in the data set cannot be organized with the specified LRECL. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

  • YES: Raises an error when records in the data set are broken.

  • NO: Displays a warning message without raising an error when records in the data set are broken.

6.3.20. VSAM_REPRO_USE_DPL

Whether to use DPL when executing REPRO on VSAM data sets. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Uses DPL.

  • NO: Does not use DPL.

6.3.21. USE_BDAM_AS_TSAM

Whether to use TSAM as BDAM. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Uses TSAM as BDAM.

  • NO: Uses Unix file as BDAM.

6.3.22. CREATE_OLD_TEMPORARYDS

Whether to create a new temporary data set if there exists none when configuring OLD DISPOSITION. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Creates a new temporary data set.

  • NO: Raises an error without creating a new temporary data set.

6.3.23. RELAX_MEMBER_NAME_LIMIT

Establishes a limit on the length of PDS member name and the use of certain special characters. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Does not set a limit on the length of 63 bytes and the use of a period (.), hyphen (-), underscore (_) and tilde (~).

  • NO: Sets a limit on the length and use of special characters.

Whether to seek forward when searching PASSED data sets (from the data set allocated earlier). All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Searches from the earliest data set.

  • NO: Searches from the latest data set.

6.3.25. UNCATLG_DS_WITH_VOL

Whether to uncatalog a data set when using VOL=SER in JCL DD statements with UNCATLG DISPOSITION. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Uncatalogs a data set.

  • NO: Does not uncatalog a data set.

6.3.26. UPDATE_NVSM_ATTR_AFTER_CREATION

Whether to modify the catalog or VTOC information by using the specified attribute when setting the DCB parameter on a non-VSAM data set that has been specified to DISP=OLD or DISP=SHR. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

  • YES: Modifies the catalog or VTOC information with the DCB parameter attribute.

  • NO: Does not modify the existing catalog or VTOC information.

6.3.27. SET_PDS_SIZE_TOTAL

Whether to set the sum of all members as the PDS size. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: The sum of all members is the size of PDS.

  • NO: The size of PDS is set to 0.

6.3.28. VOLSER_OVERRIDE_STORCLAS

Whether to override the volume information with the specified VOL=SER when VOL=SER is used in JCL DD statements and the data set meets the registered ACS routines. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Overrides the volume information with the VOLUME specified using VOL=SER in JCL DD statements.

  • NO: Uses the VOLUME specified in the storage class.

6.3.29. UPDATE_GENERATION_AT_END_OF_STEP

Whether to update the generation number information of GDG at the end of STEP or at the end of JOB. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Updates the GDG generation number information at the end of STEP.

  • NO: Updates the GDG generation number information at the end of JOB.

6.3.30. SAME_RELATIVE_GDSNUM_IN_JOB

Whether to reference the GDS of the same absolute generation number when allocating a GDS with the relative generation number of the GDG in a certain STEP of JCL, and then with the same relative generation number of the GDG in the subsequent STEP. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

Available only if UPDATE_GENERATION_AT_END_OF_STEP is set to YES.

  • YES: References the GDS of the same absolute generation number as the previous STEP.

  • NO: References the GDS of the updated absolute generation number from the previous STEP.

6.3.31. PASSED_NEW_DATASET_DISP

Whether to DELETE or KEEP when using DISP=SHR without specifying DISPOSITION to NORMAL/ABNORMAL for a data set created using DISP=(NEW,PASS) during a previous STEP in JCL. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

KEEP

Range

DELETE, KEEP

Remark

  • DELETE: Executes DISPOSE as DELETE.

  • KEEP: Executes DISPOSE as KEEP.

6.3.32. VSAM_REPRO_NULL_PADDING

Whether to use NULL PADDING for the other parts if the OUTPUT data set is set to AVRLRECL=MAXLRECL and the length of INPUT RECORD is shorter than LRECL of OUTPUT, when executing REPRO on a VSAM data set. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Uses NULL PADDING.

  • NO: Executes WRITE only as much as the length of INPUT RECORD.

6.3.33. SET_OUTPUT_DCB_TO_SMS

Whether a utility such as SORT or IEBGENER uses the DCB information of the OUTPUT data set defined by the SMS class according to ACS routines or the same DCB information of the INPUT data set. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Defines the DCB information of the OUTPUT data set by the SMS class according to ACS routines.

  • NO: Uses the DCB information of the INPUT data set as that of the OUTPUT data set.

6.3.34. DELETE_GDS_AT_END_OF_STEP

Whether to delete a GDS at the end of STEP or at the end of JOB. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Deletes a GDS at the end of STEP.

  • NO: Deletes a GDS at the end of JOB.

6.3.35. USE_EXPDT_TYPE_NEW

Date range for EXPDT to 1~366 or 0~366. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: 1 to 366.

  • NO: 0 to 366.

6.3.36. VSAM_REPRO_ZERO_RECORD_ERROR

Whether to raise an error if the number of INPUT RECORD is 0 when using REPRO for a VSAM data set. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Raises an error if INPUT RECORD is 0. However, no error when using REPRO for a non-VSAM data set.

  • NO: Does not raise an error even if INPUT RECORD is 0.

6.3.37. SET_GDG_DATASET_SORT_TYPE

GDS order for allocating GDG. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

FIFO

Range

LIFO, FIFO

Remark

  • LIFO: The newest GDS first.

  • FIFO: The oldest GDS first.

6.3.38. GDG_SCRATCH_DEFAULT

Default option to be used for creating a GDG without setting SCRATCH/NOSCRATCH options. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

NOSCRATCH

Range

SCRATCH, NOSCRATCH

Remark

  • SCRATCH: Set SCRATCH as the default option.

  • NOSCRATCH: Set NOSCRATCH as the default option.

6.3.39. GDG_LOCK_METHOD

Method of requesting LOCK for the associated GDG when requesting LOCK for a GDS.

Item Description

Parameter Type

String

Default Value

OLD

Range

NEW, OLD

Remark

  • NEW: Requests LOCK for a GDG only when the data set name is specified with the GDS relative number.

  • OLD: Requests LOCK for a GDG when the GDS relative number and absolute number are both specified as the data set name.

6.3.40. ALLOW_FIELD_DUP

Whether to allow duplication of names in fields in Copybook. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Allows duplication of names in fields in Copybook.

  • NO: Does not allow duplication of names in fields in Copybook.

6.3.41. USE_PDS_REMOVE

Whether to delete PDS members only or PDS as well when normal disposition is set to DELETE in JCL DD statements. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Deletes PDS as well.

  • NO: Deletes PDS members only.

6.3.42. USE_TAPE_FILESEQ

Option to use sequence numbers for data sets when using a tape volume. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Uses sequence numbers for data sets only when using a tape volume.

  • NO: Does not use sequence numbers for data sets regardless of volumes.

6.3.43. IGNORE_TAPEDS_DUPLICATE

Option to ignore that a data set already exists when using NEW disposition for a tape volume. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Does not raise an error, and displays a warning message in SPOOL.

  • NO: Raises an error.

6.3.44. CREATE_OLD_TAPEDS

Option to create a data set if a data set does not exist when using OLD disposition for the data set in a tape volume. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Creates a data set and continues the process.

  • NO: Does not create a data set and raises an error.

Valid only when USE_TAPE_FILESEQ is set to NO. Otherwise, it works as if this key is set to YES.

6.3.45. KEEP_TAPE_DATASET

Option to keep a data set when specifying PASS or DELETE disposition for the data set in a tape volume. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Keeps the data set.

  • NO: Deletes the data set.

Valid only when USE_TAPE_FILESEQ is set to NO. Otherwise, it works as if this key is set to YES.

6.3.46. VSAM_REPRO_IMPORT_DIR

Directory path for storing related files when executing REPRO on a VSAM data set using TBLOADER. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/impor_dir/repro

Range

Remark

6.4. DATASET_LOCK

Sets information about lock clients.

6.4.1. LOCK_FLAG

Whether for lock clients to send lock-related requests such as LOCK, UNLOCK, LOCK CLEAR, and LOCK LIST to a lock server. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

LOCK

Range

LOCK, NOLOCK

Remark

  • LOCK: Sends lock-related requests to a lock server.

  • NOLOCK: Does not send a lock-related request to a lock server.

6.4.2. REQUEST_RETRYINTERVAL

Interval at which a lock client resends a lock-related request because the request failed due to network instability or pause of a lock server. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

5 (Unit: seconds)

Range

0 to (2^31 - 1)

Remark

6.4.3. LOCK_WAIT_TIMEOUT

Waiting time for the previous lock to be released to lock a data set. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

0

Range

Remark

Only integer values are allowed.

  • Value less than or equal to 0: Waits indefinitely.

  • Value from 1 to 59: Waits for 60 seconds (the minimum time).

  • Value from 86400: Waits for 86400 seconds (1 day).

6.5. AMS_DEFAULT

Sets basic information about access method service.

6.5.1. ERROR_LEVEL

Action to take when an error occurs during data set deletion. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

IGNORE

Range

IGNORE, STRICT

Remark

  • IGNORE: Ignores the error and continues the job.

  • STRICT: Aborts the job when the error occurs.

6.5.2. AMS_CHECK_CATAUTH

Option to check a user’s TACF permission when adding a data set to a catalog. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Checks a user’s TACF permission.

  • NO: Does not check a user’s TACF permission.

6.5.3. AMS_CHECK_INVALID_CATALOG_IN_ADVANCE

Option to check the validity of a catalog first when creating a data set by describing the catalog in JCL JOBCAT or STEPCAT or specifying the catalog with an option such as TOOL. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Checks the validity of the catalog first.

  • NO: Creates a data set first and then checks the validity of the catalog when adding it to the catalog.

6.6. ICF_CATALOG

Sets basic information about integrated catalogs.

6.6.1. MASCAT_VSER

Volume where a master catalog is created. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

DEFVOL

Range

Remark

6.6.2. MASCAT_NAME

Name of a master catalog. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

SYS1.MASTER.ICFCAT

Range

Remark

6.6.3. ALIAS_LEVEL

Data set’s alias level. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

1

Range

1 to 4

Remark

6.6.4. ERROR_LEVEL

Action to take when an error occurs during data set deletion. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

IGNORE

Range

IGNORE, STRICT

Remark

  • IGNORE: Ignores the error and continues the job.

  • STRICT: Aborts the job when the error occurs.

6.6.5. USE_SYSCAT

Option to use a system catalog. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Uses a system catalog. The SYSCAT_NAME key must be set.

  • NO: Does not use a system catalog.

6.6.6. SYSCAT_NAME

System catalog name. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

SYS1.SYSCAT

Range

Remark

Must be set to use a system catalog.

6.7. FILE_HANDLER

Sets basic information about the external file handler.

6.7.1. CHECK_DSAUTH

Option to check the permission for data sets. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

Applied to all the COBOL, PL/I, and C applications.

  • YES: Checks the permission.

  • NO: Does not check the permission.

6.7.2. ADD_ASA_CODE

Option to add an 1-byte ASA control character to the beginning of a record before writing the record to a data set in applications. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

Applied to all the COBOL, PL/I, and C applications. Valid only when there is the WRITE ADVANCING phrase.

  • YES: Adds an 1-byte ASA control character to the beginning of a record to be written to a data set.

  • NO: Does not add an 1-byte ASA control character. An application handles this.

6.7.3. REPLACE_ASA_CODE

Option to replace the first 1-byte of a record with an ASA control character before writing the record to a data set of the "A" type. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

Applied to all the COBOL, PL/I, and C applications. In the case of COBOL applications, the textfh module must be used during compilation. Valid only when there is the WRITE ADVANCING phrase and ADD_ASA_CODE is set to NO.

  • YES: Replace the first 1-byte of a record with an ASA control character.

  • NO: Does not replace the first 1-byte of a record. An application handles this.

6.7.4. CHECK_VBLENGTH_CONFLICT

Option to raise an error if the length of an application does not match that specified in the data set setting for variable-length data sets in COBOL applications. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

  • YES: Raises an error.

  • NO: Does not raise an error. An application handles this.

6.7.5. CHECK_BOUNDARY_VIOLATION

Option to raise an error if the length of a record that is read from a COBOL application exceeds the range of the minimum and maximum values. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

Valid only for COBOL applications that use the tcobfh module during compilation.

  • YES: Raises an error.

  • NO: Does not raise an error. An application handles this.

6.7.6. CHECK_OUTPUT_RECFM_CONFLICT

Option to raise an error if the record format of an application does not match that specified in the data set setting for data sets used as output in COBOL applications. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

Valid only for COBOL applications that use the textfh module during compilation.

  • YES: Raises an error.

  • NO: Does not raise an error. An application handles this.

6.7.7. OVERRIDE_NEW_OUTPUT_DSATTR

Option to override DCB data with an application’s data set data for a new data set used as output in COBOL applications. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Overrides DCB data with an application’s data set data.

  • NO: Does not override DCB data with an application’s data set data.

6.7.8. OVERRIDE_DSATTR

How to override DCB data with an application’s data set data for data sets that perform OPEN in COBOL applications for each OPEN mode. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

NO

Range

INPUT, OUTPUT, INOUT, NO

Remark

  • INPUT: Overrides DCB data with an application’s data set data only for data sets used as INPUT.

  • OUTPUT: Overrides DCB data with an application’s data set data only for data sets used as OUTPUT.

  • INOUT: Overrides DCB data with an application’s data set data for data sets used as INPUT or OUTPUT.

  • NO: Does not override DCB data with an application’s data set data.

6.7.9. VSAM_APPEND_SPACE

Character used to pad a remaining part when reading data with the length less than the maximum length of a record. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

NO

Range

SPACE, NULL, NO

Remark

Valid only for COBOL applications that use the textfh module during compilation.

  • SPACE: Pads the remaining part with spaces (0x20).

  • NULL: Pads the remaining part with NULLs (0x00).

  • NO: Does not pad the remaining part.

6.7.10. SET_INDICATOR_START_INVALID_KEY

How to handle the case that there is no record that corresponds to KEY specified in a START statement. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

Valid only for COBOL applications and ISAM data sets that use the tcobfh module during compilation.

  • YES: Reads records larger than the specified KEY on subsequent READ and then returns the END OF FILE error if there is no corresponding record.

  • NO: Returns the INVALID KEY error.

6.8. TSAM_RDB

Sets TSAM usage information for business-purpose VSAM data sets.

6.8.1. DSNAME_USE_COMMENT

Table naming rule used when defining TSAM. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Arbitrarily shortens a table name and adds a comment.

  • NO: Does not arbitrarily shortens a table name and replaces a period (.) in the name with an underscore (_).

6.8.2. TEMP_PATH

Temporary path to a source file generated when defining TSAM.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/tsam/temp

Range

Remark

6.8.3. LIBRARY_PATH

Path to a library (.so) generated when defining TSAM.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/tsam/lib

Range

Remark

6.8.4. COPYBOOK_PATH

Path to a copybook file used to define TSAM.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/tsam/copybook

Range

Remark

6.8.5. FETCH_COL_DEFAULT_VALUE

Character used to pad a remaining part when if there is data shorter than fields segmented during serialization when performing READ on TSAM records in applications. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

20

Range

00 to 99

Remark

Hexadecimal value without the 0x.

Example) 20 (space), 00 (NULL)

6.8.6. MASSINSERT_COUNT

Number of records to insert to a table at a time when performing REPRO on VSAM data sets. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

100

Range

50 to 250

Remark

6.8.7. PRINT_DEBUG_MSG_ON

Option to print debugging message when performing I/O on VSAM data sets. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Prints debugging messages.

  • NO: Does not print debugging messages.

6.8.8. USE_AUDIT_COLS

Whether to add AUDIT information to a VSAM data set. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Adds AUDIT information to a VSAM data set.

  • NO: Does not add AUDIT information to a VSAM data set.

  • In the version 7.1, only the modification date is added.

6.8.9. USE_LOADER_FOR_REPRO

Whether to use TBLOADER when executing REPRO on a VSAM data set. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Uses TBLOADER when executing REPRO.

  • NO: Does not use TBLOADER when executing REPRO but uses MASSINSERT, the default operation.

6.9. TSAM_BACKUP

Sets backup connection information used when TSAM fails to connect to business-purpose VSAM data sets.

6.9.1. RETRY_COUNT

Maximum number of retries for connection. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

10

Range

0 to (2^31 - 1)

Remark

6.9.2. RETRY_INTERVAL

Interval at which making a connection is retired. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

10 (Unit: seconds)

Range

0 to (2^31 - 1)

Remark

7. dstool

Configures settings for data set related tools.

7.1. COBGENSCH

Sets information for the cobgensch tool.

7.1.1. ODO_MIN_ZERO_AVAILABLE

How to handle if a minimum value is not specified in an OCCURS DEPENDING ON statement in COBOL. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Outputs 1 for the minimum value of the occurs output part in a schema file.

  • NO: Outputs 0 for the minimum value of the occurs output part in a schema file.

7.1.2. COBCOPY

Path from which the library directory specified in a COPY OF statement in COBOL is searched.

Item Description

Parameter Type

Y_N

Default Value

${OPENFRAME_HOME}/temp

Range

Remark

7.2. COMMON

Sets common information for dataset tools.

7.2.1. CHECK_DSAUTH

Option to check the permission when allocating a data set. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

Remark

  • YES: Checks the permission.

  • NO: Does not check the permission.

7.3. DSCREATE

Set information for the dscreate tool.

7.3.1. DUPLICATE_CATALOG_ERROR

Option to raise an error if a data set already exists in a catalog. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Raises an error.

  • NO: Creates the data set and does not add it to the catalog.

7.3.2. RECAT_UPDATE_DSATTR

Option to update data set properties when using the RECATALOG option. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Updates data set properties.

  • NO: Updates only report data of the data set.

7.3.3. DUPLICATE_MEMBER_ERROR

Option to raise an error if a PDS member to create already exists. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Raises an error.

  • NO: Creates a duplicate member and does not raise an error.

7.4. DSLOAD

Sets information for the dsload and dssave tools.

7.4.1. SIZE_LIMIT

Maximum size of a data set to load. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

1000000 (Unit: bytes)

Range

0 to (2^63 - 1)

Remark

As the size of a data set increases, it takes more time to load and save it. This key is used to limit the size to decrease system load.

7.4.2. LOAD_DIR

Unix path to the directory where a temporary file is saved when a data set is loaded.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/temp

Range

Remark

7.4.3. DELIMITER

Delimiter used to identify records when a data set is loaded. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

\r\n (Unit: bytes)

Range

Remark

7.5. DSMIGIN

Sets information for the dsmigin and dsmigout tools.

7.5.1. IGNORE_MAPPING_ERROR

Option to ignore that a conversion code for a code is not specified during code page conversion for records and continue the conversion. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Ignores a missing conversion code and continue the conversion.

  • NO: Ends the conversion. However, if the -i option is specified, the conversion continues.

7.6. DSVIEW

Sets information for the dsview and dsedit tools.

7.6.1. NOCATALOG_VIEW

Option to support a viewer or editor for uncataloged data sets. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

  • YES: Supports a viewer or editor for uncataloged data sets.

  • NO: Does not support a viewer or editor for uncataloged data sets.

7.6.2. CPM_PATH

Path to a CPM file used to convert double-byte character sets.

Item Description

Parameter Type

String

Default Value

(NONE)

Range

Remark

If not set, the default value is as follows:

  • When the LANG environment variable is defined as ko_KR

    ${OPENFRAME_HOME}/cpm/EBCASCKR.cpm
  • When the LANG environment variable is defined as ja_JP

    ${OPENFRAME_HOME}/cpm/EBCASCJP.cpm
  • For other cases

    ${OPENFRAME_HOME}/cpm/EBCASCUS.cpm

7.6.3. LOCALE

LOCALE for dsview. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

(NONE)

Range

Remark

If not set, the value defined in a LOCALE-related system environment variable is used.

  • Example

    To use the Windows-31J character set, set as follows:

    ja_JP.windows31j

7.7. OFRDMSVR

Sets basic information for the ofrdmsvr server.

7.7.1. CHECK_EXPIRE_DATE

Option to delete expired data sets by checking their expiration date. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

  • YES: Deletes the data sets.

  • NO: Does not delete the data sets.

7.7.2. APPLY_GDG_MEMBER

Option to delete expired GDS data sets by checking their expiration date. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

  • YES: Deletes the data sets.

  • NO: Does not delete the data sets.

7.7.3. CALL_SERVICE_INTERVAL

Interval at which the service of the ofrdmsvr server is called. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

180 (Unit: minutes)

Range

0 to (2^31 - 1) / 60

Remark

7.8. OFRDSEDT

Sets basic information for the ofrdsedt server.

7.8.1. CHECK_DSAUTH

Option to check the permission for data sets when performing data set operations by using the ofrdsedt server’s service. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Checks the permission.

  • NO: Does not check the permission.

7.8.2. CLIENT_ALIVE_INTERVAL

Interval at which it is checked that a client that uses the ofrdsedt server’s servic is currently connected. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

0

Range

0 to 2147483647

Remark

7.9. OFRUISVR

Sets basic information for the ofruisvr server.

7.9.1. DSCREOWNER

Whether to change the OWNER of a data set created with a TACF token when creating a data set by using the ofruisvr server’s service. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

MASTER

Range

MASTER, USER

Remark

  • MASTER: Does not change the OWNER of a data set. The OWNER is defined as the ID of a user who starts the ofruisvr server.

  • USER: Changes the OWNER of a data set to the ID of a TACF token user. For information about TACF token users, refer to OpenFrame TACF Administrator’s Guide.

7.9.2. CHECK_DSAUTH

Option to check the permission for data sets when performing data set operations by using the ofruisvr server’s service. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Checks the permission.

  • NO: Does not check the permission.

7.9.3. COMMAND_LIST

Commands (such as dslist, dscreate, and dsdelet) that can be executed with the ofruisvr server’s OFRUISVRCOMMAND service. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

dslist,dscreate,dsdelete,offile

Range

Remark

If not set, no command can be executed.

7.10. SPFEDIT

Sets information for the spfedit tool.

7.10.1. RECORD_READ_COUNT

Number of records to load to memory whenever spfedit reads a data set. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

1024

Range

1024 to (2^63 - 1)

Remark

To rapidly open a large data set, its records are partially read and displayed. To retrieve the next content that is not loaded to memory, the data set is additionally read and loaded to memory.

7.10.2. END_KEY_FUNC_DEL_EOL

Option to delete from the character at the cursor to the end of the record when pressing <End> in the data set edit screen. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Deletes from the character at the cursor to the end of the record.

  • NO: Does not take any action.

7.10.3. F12_KEY_FUNC_RETRIEVE

Option to retrieve commands that are recently entered in the primary command line when pressing <F12> in the data set edit or browse screen. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Retrieves the commands in the primary command line.

  • NO: Does not take any action.

7.10.4. REPLACE_CREATE_NEEDED

Option to create a new data set if a data set to replace by using the REPLACE command does not exist. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Creates a new data set.

  • NO: Raises an error.

7.10.5. EDIT_SIZE_LIMIT

Maximum size of a data set that can be edited in spfedit. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

0 (Unit: MB)

Range

0 to (2^31 - 1)

Remark

If set to 0, there is no limit to the size of a data set in spfedit.

7.10.6. DEFAULT_CURSOR_ON_LINE_COMMAND

Option to move the cursor to the line command field when pressing <Enter> if the cursor is in a primary command area. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Moves the cursor to the line command field.

  • NO: Does move the cursor.

7.10.7. CURSOR_KEY_FUNC_SCROLL

Option to scroll the screen for a data set that is not all displayed when moving the cursor by using the arrow keys in the data set edit or browse screen. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

  • YES: Scrolls the screen.

  • NO: Does not scroll the screen and moves the cursor to the other side of the screen.

7.10.8. CPM_PATH

Path to a CMP file used to convert double-byte character codes such as Japanese.

Item Description

Parameter Type

String

Default Value

(NONE)

Range

Remark

If not set, double-byte character codes are converted based on local information of the current system.

7.10.9. LOCALE

LOCALE to apply to spfedit.

Item Description

Parameter Type

String

Default Value

(NONE)

Range

YES, NO

Remark

If not set, LOCALE-related system environment variable is used.

For example, set the Windows-31J character set as follows:

ja_JP.windows31j

8. keyseq

Configures the sorting order of the key sequence (in EBCDIC or ASCII) of index data sets (VSAM KSDS or ISAM) used in OpenFrame.

The following three rules apply to select a key sequence for each data set.

  • Use the data set name.

  • Use the prefix of the data set name.

  • Use the suffix of the data set name.

If a data set name satisfies all three rules, the data set name is given the highest priority for specify a key sequence and the suffix of the data set name, the lowest. If a data set name meets multiple criteria of one rule, the one with greater number of matching characters is selected.

If too many rules are set for this subject, the performance of opening data sets may decrease. In addition, the I/O speed is lower when sorting in EBCDIC than when sorting in ASCII. To change the settings, you must recreate the index data set.

8.1. DSNAME

User-defined key sequence to select with a data set name containing wildcard characters (%, *) and the UNIT name described in a JCL DD statement.

Wildcard Character Description

'%'

Corresponds precisely to one alphabet letter or a number.

'*'

Corresponds to one or more letters in one qualifier.

8.1.1. SAMPLE.NV*.%%DS01

Key sequence to select with a data set name and a UNIT name. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

Example) ASCII

Range

Remark

  • Format

    DsName=ASCII|EBCDIC|EBCDIC(length,offset)[,(length,offset)...]
    • ASCII: Sorts records in ASCII order.

    • EBCDIC: Sorts records in EBCDIC order.

    • length: Length of a key that uses the EBCDIC sequence.

    • offset: Location of a key that uses the EBCDIC sequence.

8.2. PREFIX

User-defined key sequence to select with the prefix of a data set name containing wildcard characters (%, *) and the UNIT name described in a JCL DD statement.

Wildcard Character Description

'%'

Corresponds precisely to one alphabet letter or a number.

'*'

Corresponds to one or more letters in one qualifier.

8.2.1. SAMPLE.NVSM.

Key sequence to select with the prefix of a data set name and a UNIT name. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

Example) ASCII

Range

Remark

  • Format

    Prefix=ASCII|EBCDIC|EBCDIC(length,offset)[,(length,offset)...]
    • ASCII: Sorts records in ASCII order.

    • EBCDIC: Sorts records in EBCDIC order.

    • length: Length of a key that uses the EBCDIC sequence.

    • offset: Location of a key that uses the EBCDIC sequence.

8.3. SUFFIX

User-defined key sequence to select with the suffix of a data set name containing wildcard characters (%, *) and the UNIT name described in a JCL DD statement.

Wildcard Character Description

'%'

Corresponds precisely to one alphabet letter or a number.

'*'

Corresponds to one or more letters in one qualifier.

8.3.1. .NVSM.DS01

Key sequence to select with the suffix of a data set name and a UNIT name. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

Example) ASCII

Range

Remark

  • Format

    Suffix=ASCII|EBCDIC|EBCDIC(length,offset)[,(length,offset)...]
    • ASCII: Sorts records in ASCII order.

    • EBCDIC: Sorts records in EBCDIC order.

    • length: Length of a key that uses the EBCDIC sequence.

    • offset: Location of a key that uses the EBCDIC sequence.

9. ofsys

Configures the overall settings of OpenFrame, especially for the directory structure.

9.1. DIRECTORY

Sets OpenFrame system directory information.

9.1.1. HOME_DIR

Home directory in OpenFrame.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}

Range

Remark

It is recommended to set to ${OPENFRAME_HOME} because a configuration file may use the environment variable.

9.1.2. BIN_DIR

Binary directory in OpenFrame.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/bin

Range

Remark

This directory contains OpenFrame binaries that can be executed in a Unix shell. Typically, this binary directory is additionally added to the $PATH environment variable.

9.1.3. LIB_DIR

Library directory in OpenFrame.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/lib

Range

Remark

Typically, this library directory is additionally added to the environment variable from which a shared library is searched for in a Unix system.

For Linux systems, the environment variable is $LD_LIBRARY_PATH.

9.1.4. UTIL_DIR

Utility directory in OpenFrame.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/util

Range

Remark

This directory contains utilities that can be executed with JCL. Typically, this utility directory is additionally added to the $PATH environment variable.

9.1.5. TEMP_DIR

Temporary directory in OpenFrame.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/temp

Range

Remark

This directory contains data that is used for a short time and then deleted. If a large amount of data is not deleted for a long time, contact TmaxSoft Technical Support.

9.1.6. DATA_DIR

Data directory in OpenFrame.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/data

Range

Remark

This directory contains small size data that is not required to be shared between nodes in a multi-node environment.

9.1.7. LOG_DIR

Directory for log data generated by OpenFrame.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/log

Range

Remark

A system administrator must check this directory periodically and delete log files that are no longer used.

9.1.8. LICENSE_DIR

Directory for license files required to operate OpenFrame.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/license

Range

Remark

9.1.9. INCLUDE_DIR

Directory for user interface C header files provided along with OpenFrame.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/include

Range

Remark

9.1.10. SHARED_DIR

Directory that can be accessed by all nodes when OpenFrame is configured in a multi-node environment.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/shared

Range

Remark

This directory contains data to be shared by all nodes of OpenFrame. If the OpenFrame system needs to process a large amount of data, set to a directory in a shared disk.

9.1.11. PROFILE_DIR

User profile directory in OpenFrame.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/profile

Range

Remark

This directory contains profiles for each OpenFrame user. The profile file name must be the same as the user’s account name.

When a user logs in, OpenFrame Manager or tjesmgr reads user profile information located in this directory and sets the user’s default catalog.

The following is the format of content defined in the user profile.

  • Format

    UCAT=<user-catalog>

The following creates and sets the profile of a user named USER01. If the catalog set in the file exists in a system, the "Current catalog is SYS1.USR001" message is displayed and the catalog is set as the default catalog when the user executes tjesmgr.

$ cat ${OPENFRAME_HOME}/profile/USER01
UCAT=SYS1.USR001

9.1.12. SCRIPT_DIR

Script file directory in OpenFrame.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/script

Range

Remark

9.2. EXTENSION

Sets file extensions used in OpenFrame.

9.2.1. SHARED_OBJECT

Extension of shared object files. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

.so

Range

Remark

If an executable module is not found in an OpenFrame/Batch system, the module is searched for once again along with the specified extension.

Typically, .so is used as a standard extension in Unix systems.

9.3. COMPILER

Sets COBOL and PL/I compiler options required to compile applications in OpenFrame.

9.3.1. COBOL_COMPILER

COBOL compiler type. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

OFCOBOL

Range

OFCOBOL, MFCOBOL, NETCOBOL

Remark

9.3.2. PLI_COMPILER

PL/I compiler type. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

OFPLI

Range

IBMPLI, OPENPLI, OFPLI

Remark

9.4. LOG

Sets information about log files generated by OpenFrame.

9.4.1. LOG_FILE_CREAT_MODE

Permission to create a log file. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

0644

Range

Remark

The value must be in octal form.

9.5. WEBDE

Sets WEBDE-related settings used in OpenFrame.

9.5.1. BINARY_PATH

Binary directory used for the View function in the [Dataset] menu of OpenFrame Manager.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/webde/bin

Range

Remark

9.6. WEBDE_CPY_LIB

Sets WEBDE Copybook-related settings used in OpenFrame.

9.6.1. COPYBOOK

Copybook directory used for the View function in the [Dataset] menu of OpenFrame Manager.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/webde/copybook

Range

Remark

9.7. SYSTEM_INFO

Sets system-specific values used in OpenFrame.

9.7.1. BATCH_OS_TYPE

OS that is compatible when executing JCL in an OpenFrame/Batch system. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

MVS

Range

MVS, MSP, VOS3

Remark

9.7.2. SYSTEM_NAME

Value of OF_CVT_SYSTEM_NAME, which is a CVT environment variable used in OpenFrame/Batch and OpenFrame/Online systems. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

OFRAME

Range

Remark

9.7.3. LPAR_NAME

Value of OF_CVT_LPAR_NAME, which is a CVT environment variable used in OpenFrame/Batch and OpenFrame/Online systems. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

OFRAME1

Range

Remark

10. saf

Configures settings for access control in OpenFrame.

10.1. SAF_DEFAULT

Sets basic information required for SAF operations.

10.1.1. AUDIT_ALL_ACCESS

Option to record all logs regardless of the audit level defined for resources. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Records all logs regardless of the audit level defined for resources.

  • NO: Records log depending on the audit level defined for each resource.

10.1.2. ASKGRPNM

Option to enter a group name when logging in from a terminal. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Enters a group name.

  • NO: Does not enter a group name.

10.2. AUTH_METHOD

Sets the authentication method used in SAF.

In OpenFrame, TACF authentication must be performed, which means that the TACF_AUTH key must be set to YES.

10.2.1. TACF_AUTH

Option to use TACF authentication. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

  • YES: Performs the authentication.

  • NO: Does not perform the authentication.

10.2.2. OS_AUTH

Option to use OS authentication. The OS authentication cannot be used independently, and it must be used along with TACF authentication. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Performs the authentication.

  • NO: Does not perform the authentication.

10.2.3. PAM_AUTH

Option to use PAM authentication. The PAM authentication cannot be used independently, and it must be used along with TACF authentication. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Performs the authentication.

  • NO: Does not perform the authentication.

10.3. OFRSASVR

Sets information required for the ofrsasvr server.

10.3.1. TOKEN_INTERVAL

Interval at which expired tokens are deleted to prevent that too many tokens that are expired due to issues such as abnormal termination of SASVR are accumulated in memory. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

0 (Unit: days)

Range

0 to (2^31 - 1)

Remark

0 or integers. 0 means that expired tokens in memory are not deleted.

10.4. ERRCODE

Sets output messages for each predefined error code when checking a password in the user-written function (saf_exit).

10.4.1. INVALID_PASSWORDn

User-defined message to display if the user-written function (saf_exit) returns a password check error during SAF authentication.

Up to 10 error codes can be defined as INVALID_PASSWORD and from INVALID_PASSWORD1 to INVALID_PASSWORD9 in errcode_saf_exit.h. If an error occurs, an output message corresponding to the error code is displayed. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

(NONE)

Range

Remark

A message can be up to 1024 bytes.

The following shows the INVALID_PASSWORDn settings by using the ofconfig tool.

$ ofconfig list -s saf -sec ERRCODE

===================================================================================
   SUBJECT |     SECTION     |         KEY       |             VALUE
===================================================================================
    saf    |     ERRCODE     | INVALID_PASSWORD  | password length is wrong.
    saf    |     ERRCODE     | INVALID_PASSWORD1 | password length is wrong.
    saf    |     ERRCODE     | INVALID_PASSWORD2 | password is same as userid.
    saf    |     ERRCODE     | INVALID_PASSWORD3 | password was used before.
===================================================================================

10.5. TACF_DUMMY

Sets information about TACF dummy.

10.5.1. PRINT_LOG

Option to print debugging messages when SAF and TACF modules are not integrated but TACF dummy is used. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

  • YES: Prints debugging messages.

  • NO: Does not print debugging messages.

11. smf

Configures settings for SMF.

11.1. DATASET

Sets data sets and nodes to be used for SMF.

11.1.1. {Dataset Name}

Set the data set name of SMF as the key name and available nodes as the value of the key. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

NODE1

Range

Remark

The following shows the {Dataset Name} key settings by using the ofconfig tool.

$ ofconfig list -s smf -sec DATASET

====================================================================================
   SUBJECT   |      SECTION      |           KEY            |          VALUE
====================================================================================
     smf     |      DATASET      |       NODE1.SMLOG1       |          ALL
             |                   |       NODE1.SMLOG2       |          ALL
             |                   |       NODE2.SMLOG1       |          ALL
             |                   |       NODE2.SMLOG2       |          ALL
             |                   |       SMLOG1.NODE1       |          ALL
             |                   |       SMLOG2.NODE2       |          ALL
             |                   |       SMLOG3.NODE3       |          ALL
             |                   |       SMLOG4.NODE4       |          ALL
====================================================================================

12. sms

Configures settings for three SMS classes (data, management, and storage classes) used in OpenFrame Storage Management System.

Set SMS classes are directly used as JCL parameters or used according to ACS rules.

12.1. DATACLAS

Sets user-specified data class.

12.1.1. DCLAS001

Information about a data class to add. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

Range

Remark

  • Format

    Keyword1=Value1,Keyword2=Value2,...
    • RECFM: Record format

    • LRECL: Logical record length

    • AVGREC: Space scaling factor (U/K/M)

    • AVGVAL: Average record length

    • PRIMARY: Primary allocation quantity

    • SECONDARY: Secondary allocation quantity

    • DIRECTORY: Number of directory blocks in PDS.

    • EXPDT: Data set expiration date (YYYYMMDD)

    • RETPD: Data set retention period (from the creation date)

    • VOLCNT: Volume count

    • DSNTYPE: Data set name type (EXT/HFS/LIB/PDS)

    • COMPACT: Option for compress data (Y/N/T/G)

    • SPANNED: Option to allow data to span across control intervals (S/N)

    • RECORG: VSAM data set type (KS/ES/RR/LS)

    • KEYLEN: Key length (in bytes)

    • KEYOFF: Key offset (for KSDS)

    • CISIZE: CISIZE of data component (not actually used)

    • FRSPAC[0]: CI %Free Space for CI

    • FRSPAC[1]: CA %Free Space for CA

    • SHOPTS[0]: Region share option

    • SHOPTS[1]: System share option

  • Example

    RECFM=FB,LRECL=80

12.2. MGMTCLAS

Sets user-specified management class.

12.2.1. MCLAS001

Information about a management class to add. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

Range

Remark

  • Format

    Keyword1=Value1,Keyword2=Value2,...
    • EXPDT: Data set expiration date (YYYYMMDD)

    • RETPD: Data set retention period (from the creation date)

    • RETPD_NOUSE: Data set retention period (from last referenced date)

    • RETPD_LIMIT: Maximum data set retention period.

  • Example

    EXPDT=99991231,RETPD=NOLIMIT

12.3. STORCLAS

Sets user-specified storage class.

12.3.1. SCLAS001

Information about a storage class to add. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

Range

Remark

  • Format

    Volume serial numbers.

    VolumeSerial1,VolumeSerial2-VolumeSerial3,...
  • Example

    DEFVOL
    200000-300000
    DEFVOL,400000-700000

13. sort

Configures settings for OpenFrame SORT utility.

13.1. WORKSPACE

Sets the location of the workspace used for SORT operations.

13.1.1. USE

Option to use the workspace configuration. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

13.1.2. COUNT

How many workspaces to use. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

3

Range

1 to 10

Remark

Valid only when USE is set to YES.

13.1.3. WORKSPACE{n}

Path to a workspace to be used by the SORT utility. Up to 9 workspaces can be configured from WORKSPACE0 to WORKSPACE9, but the maximum number of configurable workspaces is determined by the value set in the COUNT key.

Item Description

Parameter Type

String

Default Value

WORKSPACE0=${OPENFRAME_HOME}/temp/sort0

Range

Remark

Valid only when USE is set to YES.

13.2. OPTION

Sets options for the SORT utility.

13.2.1. STABLE_SORT

Option to perform stable sort. When using ProSort, use ProSort’s tip file or set EQUALS or NOEQUALS in the SORT script. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

13.2.2. MEMORY_LIMIT

Memory limit for the SORT utility. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Number

Default Value

512 (Unit: MB)

Range

0 to (2^31 -1)

Remark

0 means unlimited.

The maximum size of available memory is 2 GB in a 32-bit environment. If the size exceeds 2 GB, memory cannot be allocated normally.

The recommended memory size for ProSort is 64 MB to 512 MB.

13.2.3. SEQUENCE

Sorting sequence used for SORT operations. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

String

Default Value

ASCII

Range

ASCII, EBCDIC

Remark

13.2.4. SOLRF

Option to use SOLRF. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

YES

Range

YES, NO

Remark

13.2.5. FSZEST

Option to match FILSZ=n and SIZE=n in the SORT script with the actual file size. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

13.2.6. NULL_PADDING

When SORTOUT is FB and the length of the written record is shorter than LRECL of SORTOUT, you can specify whether to fill the remaining space using NULL instead of SPACE. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark

13.3. PATH

Sets a binary path.

13.3.1. EXITLIB

Path to a user exit library.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/shared/exitlib

Range

Remark

13.4. SEQUENCE

Sets the location of the file that defines user-defined collating sequence.

13.4.1. CQ{n}

Path to the file that includes the CQ{n} format of a COLSEQ statement.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/config/sort/cqn.seq

Range

Remark

The following shows the CQ{n} key settings by using the ofconfig tool.

$ ofconfig list -s sort -sec SEQUENCE

===================================================================================
   SUBJECT |     SECTION     |     KEY     |                VALUE
===================================================================================
    sort   |    SEQUENCE     |     CQ1     | ${OPENFRAME_HOME}/config/sort/cq1.seq
    sort   |    SEQUENCE     |     CQ2     | ${OPENFRAME_HOME}/config/sort/cq2.seq
===================================================================================

13.4.2. UC{n}

Path to the file that includes the UC{n} format of a /COLLATINGSEQUENCE statement in SyncSort.

Item Description

Parameter Type

String

Default Value

${OPENFRAME_HOME}/config/sort/ucn.seq

Range

Remark

The following shows the UC{n} key settings by using the ofconfig tool.

$ ofconfig list -s sort -sec SEQUENCE

===================================================================================
   SUBJECT |     SECTION     |     KEY     |                VALUE
===================================================================================
    sort   |    SEQUENCE     |     UC1     | ${OPENFRAME_HOME}/config/sort/uc1.seq
    sort   |    SEQUENCE     |     UC2     | ${OPENFRAME_HOME}/config/sort/cq2.seq
===================================================================================

13.5. TEXTSM_DEFAULT

Sets options for TEXTSM.

13.5.1. SHOW_SORT_SCRIPT

Option to show the SORT script created by TEXTSM. All nodes in a multi-node environment must use the same configuration.

Item Description

Parameter Type

Y_N

Default Value

NO

Range

YES, NO

Remark