9.3 npconvertoplog command (rename operation log files)

Description

This command renames operation log files according to the numbering method for the Navigation Platform version.

The numbering method for operation log files is either of the following:

1. Method of numbering in chronological order of the update dates/times of the operation log files

   The following example renames operation log files with this numbering method:

   The names of operation log files before change are as follows:

   operation3.log (update date/time: 2015/6/18:15:00)

   operation2.log (update date/time: 2015/6/19:14:00)

   operation1.log (update date/time: 2015/6/22:13:00)

   When these operation log files are renamed by this numbering method, their new names are as follows:

   operation1.log (update date/time: 2015/6/18:15:00)

   operation2.log (update date/time: 2015/6/19:14:00)

   operation3.log (update date/time: 2015/6/22:13:00)

   The operation log files are renamed by this numbering method during version upgrade processing. For details, see 3.6 Upgrading Navigation Platform.

2. Method of numbering sequentially starting with the most recent update date/time of the operation log files

   The following example renames operation log files with this numbering method:

   The names of operation log files before change are as follows:

   operation1.log (update date/time: 2015/6/18:15:00)

   operation2.log (update date/time: 2015/6/19:14:00)

   operation3.log (update date/time: 2015/6/22:13:00)

   When these operation log files are renamed by this numbering method, their new names are as follows:

   operation3.log (update date/time: 2015/6/18:15:00)

   operation2.log (update date/time: 2015/6/19:14:00)

   operation1.log (update date/time: 2015/6/22:13:00)

   Use this method if you have been using operation logs with Hitachi Navigation Platform 10-00 and JP1/Integrated Management - Navigation Platform 10-50 or earlier and you want to continue to perform user-specific analyses on the operation logs with JP1/Navigation Platform 11-00 or later.

Format

npconvertoplogΔ[-r]Δpath-of-operation-log-storage-directory

Specify the path of the directory that stores the operation logs to be renamed. This cannot be the directory path specified in the ucnp.base.server.operationlog.path property.

Options

-r

Renames the operation log files using the method of numbering sequentially starting with the most recent update date/time of the operation log files. If this option is omitted, the operation log files are renamed using the method of numbering in chronological order of the update date/time of the operation log files.

Notes:

• Specify the path of an existing directory for the path of the operation log storage directory.

• Make sure that the specified path of the operation log storage directory does not contain any character that is not permitted for Windows file names and directory names.

• Do not specify the path of a network drive in the path of the operation log storage directory.

• Do not specify a short name for the path of the operation log storage directory.

• If single-byte double quotation marks (") are used in the path of the operation log storage directory, use them correctly.

• Do not include any single-byte character other than those listed below in the path of the operation log storage directory:

  • Single-byte space ( )

  • Single-byte yen sign (\)

  • Single-byte colon (:)

  • Single-byte period (.)

• Do not access the operation logs while this command is executing.

• Do not change the date/time of the most recent updating of the operation log files.

• If this command terminates abnormally, re-execute it before performing any other operation.

Return value

Return value	Description
0	Renaming of operation log files was successful.
1	Renaming of operation log files failed.
2	A lock error occurred on the command.
9	An execution permission error occurred.

Example

This example assumes that the operation log storage directory is C:\temp\oplog:

> Navigation-Platform-installation-directory\bin\npconvertoplog C:\temp\oplog

To Page Top