ntbtail [-i update-check-interval] -t p
ntbtail [-i update-check-interval] redirect-file-name

This command reads a specified file at a specified interval and outputs the updated contents to the console. If the specified file has managed generations, the command reads the contents of the file with generation number 1 or 2 at the end of the file name and then outputs those contents to the console.

-i update-check-interval ~<unsigned integer>((1 to 60))<<1>>(seconds)

Specifies the interval at which the file is to be checked for updated contents.

-t p

Specifies that the contents of the standard output redirect file are to be read and output to the console. This option provides the same functionality as the tp1console command. For details about the tp1console command, see tp1console (outputs the standard output redirect file to the console).

redirect-file-name ~<path name consisting of 1 to 260 characters>

Specifies the name of the file whose updated file contents are to be output.

Generations of the specified file must be managed according to the following conditions:

• The file name does not have an extension.
• The name of a file that has two managed generations must end with generation number 1 or 2.
• Neither the current file nor the standby file is deleted during generation swapping.

A file with managed generations that is output by this command cannot be deleted until this command has terminated.

For the file name, specify the name without the generation number at the end. The following example outputs the files %DCDIR%\spool\prclog1 and %DCDIR%\spool\prclog2:

ntbtail %DCDIR%\spool\prclog

• Make sure that this command has terminated before you set up OpenTP1 (install or uninstall OpenTP1 or set up a multiOpenTP1).
• The dc_adm_call_command function cannot be used to execute this command from a UAP. This command cannot be specified in the user_command or the user_command_online operand in the system environment definition.
• This command determines the file generation to be output on the basis of the modification dates of the file specified in the argument. If you update data in the current file specified in the argument, use the _commit() or FlushFileBuffers() function or close the file to write data to disk and set the most recent file modification date. If the current file's modification date is not up-to-date, the correct current file cannot be selected, in which case the command might not function as intended.
• The contents of the specified file before this command was executed are not output to the console. The command outputs sequentially to the console the contents written after command execution has begun.
• If the file specified in redirect-file-name has managed generations and the file generations are swapped, the file containing the most recent generation after swapping is the one that is subject to output by this command.
• If you use a multiOpenTP1 system, execute this command from a command prompt at the console created by the dcmakecon command. For details, see dcmakecon (creates a multiOpenTP1 console).
• To terminate this command, press the Ctrl and C keys simultaneously at the console or perform console close processing.