sdptplput (reloads tuples)

Format

sdptplput {-file tuple-log-file[ tuple-log-file...]
          [-time [start-time][,end-time]] [-interval loading-interval]
          [-count number-of-tuples-to-be-loaded]|-help}

Function

This command reloads tuples collected in tuple log files into the input stream queue.

Execution permissions

Administrator user

Prerequisites for command execution

To execute this command, you need the following files:

Storage directory

working-directory\bin\

Arguments

-file tuple-log-file[ tuple-log-file...]

Specifies the paths of the tuple log files to be reloaded.

If you specify multiple tuple log files, delimit the files with a single-byte space.

If you specify multiple files, note the following:

-time [start-time][,end-time]

Specifies in the following format a start time and end time for the tuples that are to be reloaded:

hhmmsslll[MMDD[YYYY]]
hh: Hour (00[Figure] hh[Figure] 23)
mm: Minute (00[Figure] mm[Figure] 59)
ss: Second (00[Figure] ss[Figure] 59)
lll: Millisecond (000[Figure] lll[Figure] 999)
MM: Month (01[Figure] MM[Figure] 12)
DD: Day (01[Figure] DD[Figure] 31)
YYYY: Year (4-digit calendar year)
  • Specify this argument in single-byte numeric characters.
  • If the year is omitted from the start or end time, the command assumes the specified month, day, and time in the current year.
  • If you omit specification of year, month, and day, the command assumes the specified time on the current day, in the current month, in the current year.
  • You cannot omit only the month and day, or only the month, or only the day. If this rule is violated, an option error results.
  • If you want to omit the month or day, omit all of year, month, and day.

The start-time and end-time values are the start and end times of tuple collection. You can use the sdptplls command to check the tuple collection times.

Specify start-time and end-time delimited with a comma and without any spaces.

The following describes the tuples that are reloaded according to the specified time:

-interval loading-interval (1 to 600000)

Specifies in milliseconds an interval value for tuple reloading. If this argument is omitted, the command assumes 100 milliseconds.

The command reloads as many tuples as specified in the -count option and then resumes reloading tuples after the interval specified here. If an overflow occurs in the input stream queue, the command reloads after the specified interval the tuples whose reloading failed.

If the -count option is omitted, the loading interval specified in the -interval option is applicable only when an overflow occurs in the input stream queue.

-count number-of-tuples-to-be-loaded (1 to 1048576)

Specifies the number of tuples to be reloaded at one time.

The command reloads as many tuples as specified in this argument and then waits for the interval specified in the -interval option before resuming reloading of tuples.

If this argument is omitted, the command reloads all tuples at once without pause.

-help

Displays how to use the command.

If this option is specified, the command terminates without reloading tuples or checking the options for errors.

Notes

Return value

ValueMeaning
0The command terminated normally.
1The command resulted in an error.