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.
-
Configures the assignment rules for three SMS classes (data, management and storage) used in OpenFrame Storage Management System.
Section Description Data set name containing wildcard characters (%, *) and the unit name described in JCL DD statements. Allows the user to specify an SMS class.
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 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.
-
Configures the general functionalities for 3270 stream conversion in OpenFrame.
Section Description CPM file to use during 3270 stream conversion.
How to configure SOSI codes to identify double-byte characters during 3280 stream conversion.
-
Configures console and command settings in OpenFrame.
Section Description Console server and client settings.
Command server and command processing interfaces.
-
Configures settings for code page conversion in OpenFrame.
Section Description CPM data file to be used by default.
-
Configures the general settings for data sets used in OpenFrame.
Section Description Data set directories.
Data set resources.
Default settings for data sets.
Information about lock clients.
Basic information about access method service.
Basic information about integrated catalogs.
Basic information about the external file handler.
TSAM usage information for business-purpose VSAM data sets.
Backup connection information used when TSAM fails to connect to business-purpose VSAM data sets.
-
Configures settings for data set related tools.
Section Description Settings for the cobgensch tool.
Common settings for dataset tools.
Settings for the dscreate tool.
Settings for the dsload and dssave tools.
Settings for the dsmigin and dsmigout tools.
Settings for the dsview and dsedit tools.
Basic settings for the ofrdmsvr server.
Basic settings for ofrdsedt server.
Basic settings for the ofruisvr server.
Settings for the spfedit tool.
-
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 User-defined key sequence to select with a data set name containing wildcard characters (%, *) and the UNIT name described in a JCL DD statement.
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.
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.
-
Configures the overall settings of OpenFrame, especially for the directory structure.
Section Description OpenFrame system directory information.
File extensions used in OpenFrame.
COBOL and PL/I compiler options.
Settings about log files generated by OpenFrame.
WEBDE-related settings used in OpenFrame.
WEBDE Copybook-related settings used in OpenFrame.
System-specific values used in OpenFrame.
-
Configures settings for access control in OpenFrame.
Section Description Basic information required for SAF operations.
Authentication method used in SAF.
Settings required for the ofrsasvr server.
Messages for user-defined error codes in saf_exit.
Settings for TACF dummy.
-
Configures settings for SMF.
Section Description Data sets and nodes to be used for SMF.
-
Configures settings for three SMS classes (data, management, and storage classes) used in OpenFrame Storage Management System.
Section Description User-specified data class.
User-specified management class.
User-specified storage class.
-
Configures settings for OpenFrame SORT utility.
Section Description Location of the workspace used for SORT operations.
Options for the SORT utility.
Binary path.
Location of the file that defines user-defined collating sequence.
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 |
|
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 |
|
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 |
|
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.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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
6. ds
Configures the general settings for data sets used in OpenFrame.
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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.
|
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 |
|
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.
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
6.3.24. PASSED_DS_FORWARD_SEARCH
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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.
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
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 |
Valid only when USE_TAPE_FILESEQ is set to NO. Otherwise, it works as if this key is set to YES. |
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 |
|
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.
|
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 |
|
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 |
|
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 |
|
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 |
|
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.
|
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.
|
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.
|
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 |
|
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.
|
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.
|
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 |
|
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 |
|
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.
|
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.
|
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 |
|
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 |
|
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 |
|
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 |
|
6.9. TSAM_BACKUP
Sets backup connection information used when TSAM fails to connect to business-purpose VSAM data sets.
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 |
|
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 |
|
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 |
|
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 |
|
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.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 |
|
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 |
|
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:
|
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.
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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.
|
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.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.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 |
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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.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 ===================================================================================