A startup file is a file that defines the default value of PowerBSORT.
Copy the model in user's home directory by the file name of ".bsortrc". The model of a startup file is installed in the following places.
/opt/FJSVXbsrt/config/BSORTRC
The startup file is in text format. Use the general text editor to change file contents. If the startup file contains identical features, the last entered specification is in effect. "#" indicates a comment line. In a model of startup file, all the definition values are the comment lines.
The following variables can be defined in the startup file.
Definition value | Meaning |
|---|---|
Checking level | |
Definition of file system | |
FIFO (first-in, first-out) option | |
Work area size | |
Message output file name | |
Message output level | |
Output form of message | |
Specify whether to issue fsync, before closing the output files of standard file system | |
Whether or not +0 and -0 are treated as the same value | |
Define the command termination status when a character other than numeric, signs, blank, or tab is found in text records summation field | |
Define the command termination status when an overflow occurs at the summation process | |
Whether or not record summation continues after an overflow occurs | |
Define the command termination status when the input records do not include the summation field during text input or variable-length records | |
syslog output | |
Temporary file directory name | |
Defining the beginning year for data form of "two digit years" | |
Unicode UCS-2 format byte order | |
Unicode UTF-32 format byte order | |
Whether or not BOM is skipped |
BSORT_CHKLEVEL={0 | 1}
The check option within PowerBSORT is specified.
Level | Meaning |
|---|---|
0 | Nothing checked (Default value) |
1 | Interface check with BSORT function is performed. |
BSORT_FILESYS_fs=bslibname[:fslibname]
Defines the file system.
fs
Specify the identifier of the file system.
The identifier of the file system that can be specified is shown below.
COB1, COB2, COB3
Information
Specify the identifier of the file system as follows.
I/O file system option (-F) in bsort command
filesys operand of -input option or -output option in bsortex command
BSRTFILE structure in bsrtopen function
There is no difference in the identifier of the file system, and specify it arbitrarily.
bslibname
Specifies the PowerBSORT file access library.
The following file access libraries are available.
File access library name | Meaning |
|---|---|
libbscblrt64.so | Library for NetCOBOL sequential files |
libbscblps64.so | Library for NetCOBOL physical sequential files |
libbscblrl64.so | Library for NetCOBOL relative files |
libbscblidx64.so | Library for NetCOBOL indexed files |
fslibname
Specifies the file system library.
The path name can be specified with an absolute path or a relative path. The following file system library can be specified.
File system library name | Meaning |
|---|---|
libcobflm64.so | NetCOBOL file system library (Large file) |
BSORT_FIFO={ON | OFF}
The FIFO (first-in, first-out) option is specified.
Specified value | Meaning |
|---|---|
ON | When the value of the specified key field is the same, those records are output in input order. This is effective for the sort function. The specification of the fifo (first-in, first-out) option is disregarded when combined with the merge function, the copy function, the record summation option, and the suppression option. |
OFF | The order of records with the same key may be different in the output file compared to the input file. (Default value) |
BSORT_MEMSIZE=n
The size of the work area that PowerBSORT uses is specified in kilobytes.
The work area is specified within the range from 64 to 2097151 kilobytes. When 0 is specified, or specifying BSORT_MEMSIZE is omitted, the work area is automatically set. When the value of 2097152 or more is specified, 2097151 are assumed.
To run PowerBSORT efficiently, specify the memory size of 1/50 or more of the amount of input data. However, when the calculation value (1/50 of the amounts of input data) falls below 8192 kilobytes, 8192 kilobytes is recommended.
BSORT_MSGFILE=Message output file name
This specifies the file path name in which the message output by PowerBSORT is stored.
When a file name contains a blank, the file name need not be enclosed with double quotation (").
BSORT_MSGLEVEL={N | E | W | I | 0 | 1 | 2}
This specifies the level of messages output by PowerBSORT.
Level | Meaning |
|---|---|
N | Nothing output. |
E | Error messages are output. |
W | Error messages and warning messages are output. (Default value) |
I | Error messages, warning messages and information messages are output. |
The following level can be specified for use with previous versions.
Level | Meaning |
|---|---|
0 | Nothing is output. |
1 | Error messages and warning messages are output. (Default value) |
2 | Error messages, warning messages and information messages are output. |
BSORT_MSGSTYLE={1 | 2}
The output form of the message is specified.
Specified value | Meaning |
|---|---|
1 | Output the header, and the message text. This is the form output by the version before V5. |
2 | Output the header, the message type, the date, the message number, and the message text. (Default value) |
BSORT_OUTFILE_FSYNC={ON | OFF}
Specify whether to issue fsync, before closing the output files of standard file system.
Specified value | Meaning |
|---|---|
ON | fsync(2) is issued. |
OFF | fsync(2) is not issued. (Default value) |
BSORT_SIGNEDZERO={EFFECT | IGNORE}
For data that can be expressed as "+0" and "-0", specify whether "+0" and "-0" are to be treated as equivalent.
Specified value | Meaning |
|---|---|
EFFECT | "+0" and "-0" are treated as different. |
IGNORE | "+0" and "-0" are treated as equivalent. (Default value) |
Information
The following data forms can be expressed as “+0” and “-0”:
Packed decimal number
External decimal number
Leading separate signed number
Trailing separate signed number
Leading overpunch signed number
Trailing overpunch signed number
When n(BSOPT_NUMERIC) is specified for an operation of the key field and the selection field at the text file.
When N(BSOPT_CHARNUM) is specified for an operation of the key field at the text file.
When EFFECT is specified, "+0" and "-0" becomes "+0">"-0".
The version before V5 operate as if EFFECT was selected.
BSORT_SUMFILD=n
Define the bsortex command or bsort command termination status when a character other than numeric, signs, blank, or tab is found in text records summation field.
An arbitrary integer value from 0 to 9 can be specified in n. When specification is omitted, 0 is assumed.
BSORT_SUMOVER=n
Define the bsortex command or bsort command termination status when an overflow occurs at the summation process.
An arbitrary integer value from 0 to 9 can be specified in n. When specification is omitted, 0 is assumed.
BSORT_SUMOVERCONT={ON | OFF}
Specify whether or not record summation continues after an overflow occurs.
Specified value | Meaning |
|---|---|
ON | The record summated immediately before the overflow occurred is output and subsequent records with the same key field are summated as separate records. This is repeated whenever an overflow occurs. |
OFF | The record summated immediately before the overflow occurred is output. Subsequent records with the same key field are not summated. (Default value) |
BSORT_SUMSHRT=n
Define the bsortex command or bsort command termination status when the input records do not include the summation field during text input or variable-length records.
An arbitrary integer value from 0 to 9 can be specified in n. When specification is omitted, 0 is assumed.
BSORT_SYSLOG={N | E | W | I}
Specifies the level of messages output to the syslog by PowerBSORT.
Level | Meaning |
|---|---|
N | Nothing output. (Default value) |
E | Error messages are output. |
W | Error messages and warning messages are output. |
I | Error messages, warning messages and information messages are output. |
BSORT_TMPDIR=Temporary file directory name[:Temporary file directory name...]
A directory name specifying where PowerBSORT temporary files are created.
When you process to sort the file of the amount that cannot be processed within the memory alone, a temporary file is created in a directory specified by BSORT_TMPDIR. When the specified directory name does not exist, it is an error. You can also specify two or more directory names by delimiting the directories by colon (:). Specifying two or more directory names in different file systems could prevent the error due to free space shortage. Do not put an unnecessary character string such as a blank before and behind the colon (:) when you specify two or more directory names.
The directory that makes the temporary file observes the order of precedence and is decided. Refer to "Priority level of the directory that creates the temporary file" for the priority level.
BSORT_TOPYY=yy
Define the beginning year for data form of "two digit years".
For instance, if BSORT_TOPYY=50 is specified, the effective range is from 1950 to 2049. The default value for yy is 60. BSORT_TOPYY is used when a data form of "two digit years" field is specified.
BSORT_UCS2TYPE={BIG_ENDIAN | LITTLE_ENDIAN}
Specify the Unicode UCS-2 format byte order.
Valid when the data format is set to UCS-2 using the PowerBSORT command line interface.
Specified value | Meaning |
|---|---|
BIG_ENDIAN | Sets Big Endian. |
LITTLE_ENDIAN | Sets Little Endian. (Default value) |
BSORT_UTF32TYPE={LITTLE_ENDIAN | BIG_ENDIAN}
Specify the Unicode UTF-32 format byte order.
Valid when the data format is set to UTF-32 using the PowerBSORT command line interface.
Specified value | Meaning |
|---|---|
BIG_ENDIAN | Sets Big Endian. |
LITTLE_ENDIAN | Sets Little Endian. (Default value) |
BSORT_UNICODEBOM={ON | OFF}
Specify whether or not the Unicode byte order marker, BOM, is skipped.
Valid when the input file is a text file and the code set of that file is Unicode (UCS-2, UTF-32, or UTF-8).
If a BOM exists in the input file and is skipped, a BOM is still inserted in the output file. If multiple input files are specified, a BOM exists in the first input file specified, and the BOM was skipped, a BOM is inserted in the output file.
Specified value | Meaning |
|---|---|
ON | Skips the BOM. Note that, if the head of the file is anything other than a BOM, it is not skipped. (Default value) |
OFF | Does not skip the BOM. |
