Jiscond
- Organization of this page
Function
The Jiscond command eliminates unnecessary area from the specified data files to compress them. This command also reorganizes the key file.
Updating records in data files or deleting records from data files increases the area size of the data files. This command eliminates unnecessary data from the data files to reduce the area for the data files. Also, this command extracts keys to reorganize the key file, based on the key information in the key definition file. If no keys are defined in the key file, this command does not reorganize the key file.
Format
- In Windows:
-
Jiscond [-r] [-d dir work-folder-name] [-k | -q] file-name
- In UNIX:
-
Jiscond [-T dir work-directory-name] [-k | -q] file-name
Required execution permission
In Windows: Administrators (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)
In UNIX: Superuser or JP1/Base administrator permission
Command directory
- In Windows:
-
installation-folder\bin\
- In UNIX:
-
/opt/jp1base/bin/
Arguments
-r
Specify this option to display the compression rate of the data file and key file. When you specify this option, the file compression utility command outputs the execution result including the ratio (percentage) of the compressed file size to the uncompressed file size.
-d dir work-folder-name
The work files is used to sort key entries during file compression. This means that you must specify the directory for the work files. If you omit this option, the directory specified in the TEMP environment variable, the tmp directory, or the current directory is used. This option can only be specified in Windows.
-T dir work-directory-name
The work files is used to sort key entries during file compression. This means that you must specify the directory for the work files. If you omit this option, the /tmp or /usr/tmp directory is used. This option is available for UNIX only.
-k
Specify the -k option to reorganize the ISAM file while preventing it from becoming too large. If JP1 is operating for a long time, the size of the key file, which provides indexes for the ISAM database, increases without limit. You must reorganize the ISAM file periodically. This argument prevents the key file from becoming too large.
-q
Specify the -k option to reorganize the ISAM file but cancel the setting for preventing it from becoming too large. If you want to use a previous version of JP1, you must disable any functionality not supported by that version. This argument enables previous versions of JP1 to access the ISAM file.
file-name
Specify one or more files you want to check. If you do not specify the full path name of a file, the command assumes that the file is located in the current directory at the current drive. In Windows, if you want to specify more than one file, use at least one space to separate each file name. If you want to specify a file name that includes spaces, enclose the file name in double quotation marks ("). You can also use the wildcard character (*) to specify files.
- Example:
-
The following shows examples in Windows.
-
Specify all the files in the c:\data directory.
Jiscond c:\data\*
-
Specify the file names beginning with SAMPLE in the c:\data directory.
Jiscond c:\data\SAMPLE*
-
Notes
-
This command creates work files for compressing files. Be careful when you compress a large file because this command creates a copy of the data file and then creates a key file.
-
In Windows, the command immediately stops if an I/O error occurs or a specified file does not exist even when the command has already processed some files.
-
In Windows, the command takes some time to display the result if you specify the -r option.
-
Your system might contain an ISAM file created on a shared disk for the primary and secondary nodes that have version 06-71 or earlier of JP1/Base. If you want to specify the option that prevents the ISAM file from becoming too large, upgrade to JP1/Base Version 7 or later on both the primary and secondary nodes. Then, set this option for the ISAM file on the shared disk.
-
In the system containing an ISAM file created on a shared disk for the primary and secondary nodes, you can set the option that prevents the ISAM file from becoming too large. If you want to change the version of JP1/Base back to 06-71 or earlier in such a system, first cancel this option. Then, change the version of JP1/Base on the primary node and then on the secondary node.
Return values
0 |
Normal end |
1 |
Abnormal end |