Function

When the source database uses SAM files (PDM2 E2 or RDB1 R2), the hdssamqin command accumulates the update information transferred in a SAM file into the import information queue file. Datareplicator imports the accumulated update information to HiRDB during import processing.

Format

hdssamqin -d data-linkage-identifier -f input-SAM-filename
          -n update-information-definition-filename
        [ -l update-information-editing-buffer-size ]
        [ -c ][ -o ]

Options

-d data-linkage-identifier

Specify the data linkage identifier. This data linkage identifier must be unique among all update information input processes and reception processes that are executed concurrently. Specifying ** for the data linkage identifier will result in an invalid-argument error.

-f input-SAM-filename

~ <absolute-pathname>

Specify the input SAM file. This is the SAM file transferred from the source database in binary mode. If you specify only the filename, Datareplicator assumes that the file is located in the current directory where the command was executed.

-n update-information-definition-filename

~ <absolute-pathname>

Specify the name of the file that contains the update information definition for data extraction. If you specify only the filename, Datareplicator assumes that the file is located in the current directory where the command was executed.

The -n option is applicable only to PDM2 E2; you cannot specify the -n option for RDB1 E2 because there is no need to create an update information definition file.

-l update-information-editing-buffer-size

~ <unsigned integer> ((1-2097151)) <<300>> (KB)

Specify the size of the buffer used to edit update information extracted from PDM2 E2. The -l option is applicable only to a SAM file extracted from PDM2 E2; it is not applicable to a SAM file extracted from RDB1 E2.

-c

Specify this operand to ignore the SAM file information that was processed during the previous execution of the command. Datareplicator will ignore the specified SAM file regardless of whether the previous hdssamqin command terminated normally or abnormally.

-o

If an error occurred during the previous command execution, specify this option to resume the previous processing.

Rules

If the hdssamqin command terminates normally, it returns 0. If it terminates abnormally, it returns 1.

Notes

If the SAM file input processing terminates abnormally and input file processing is not completed, do not execute the Datareplicator's initial startup command (hdsstart -i). If hdsstart -i is executed, Datareplicator will not be able to establish data linkage correctly, because information about the SAM file input synchronization point is lost. If you have executed initial startup, re-create the target HiRDB table, and then execute the hdssamqin command.