Hitachi

JP1 Version 12 JP1/Base User's Guide


Jisext

Organization of this page

Function

The Jisext command extracts as many valid records as possible from an ISAM data file where an error occurred and then restores the extracted records to a sequential file. In UNIX, this command also outputs the key definitions for the ISAM file.

This command verifies the records in a data file from the file's beginning until the command encounters an error, and outputs the verified records to a sequential file. Then, this command verifies the records in the data file from the file's end until the command encounters an error, and outputs the verified records to the sequential file.

When this command extracts records, it determines the record type and record length from the definitions in the key definition file. Therefore, if the key definition file is damaged, you must specify the record type and record length as command options. If this command outputs a message notifying you of an error in a definition file, the key definition file is damaged. You can specify the record type and record length even when the key definition file is not damaged. In this case, this command extracts records by using the specified record type and length.

Format

In Windows:

Jisext [-f record-type:record-length] file-name-1 file-name-2

In UNIX:

Jisext { -p | -f record-type:record-length } file-name-1 [file-name-2]

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

-p

Specify this option to output the key definition parameters to the standard output. You can only specify this option when the -f option is not specified. This option can only be specified in UNIX.

-f record-type:record-length

You can use this option to explicitly specify the record type and record length for the ISAM file. The specification of this option prevails over the specification in the key definition file. In UNIX, you can only specify this option when the -p option is not specified.

record-type

Specify either of the following keywords to specify the record type:

f: Fixed length

v: Variable length

record-length

Specify the record length (in bytes) in the range from 1 to 65,503.

When the record type is variable-length, specify the maximum record length. When the record type is variable-length, the command assumes that the minimum record length is 1.

file-name-1

Specify the name of the source file (ISAM file) from which you want to extract records. 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 a file name that includes spaces, enclose the file name in double quotation marks (").

file-name-2

Specify the name of the destination file (sequential file) to which you want to output the extracted records. 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. If you specify the name of an existing file, the file specified in this argument replaces the existing one.

In Windows, if you want to specify a file name that includes spaces, enclose the file name in double quotation marks (").

In HP-UX or Solaris, you must not omit this argument.

Return values

0

Normal end

1

Abnormal end