12.2.1 Explanation of the specification format and options
- Organization of this subsection
(1) Specification format
adbconvertaudittrailfile -u authorization-identifier [-p password] --common -d output-directory-path-for-common-format-audit-trail audit-trail-file-path
(2) Explanation of options
- ● -u authorization-identifier
-
~<character string>((1 to 100 bytes))
Specifies the authorization identifier of the HADB user who executes the adbconvertaudittrailfile command. To execute the adbconvertaudittrailfile command, the user must have the following two privileges:
-
CONNECT privilege
-
Audit viewer privilege
For this option, specify an authorization identifier in the range from 1 to 100 bytes. Note that the byte count (1 to 100 bytes) does not include the double quotation marks used to enclose the authorization identifier.
- Important
-
If the character string used as the authorization identifier includes any lowercase letter or a backslash (\), make sure that you check the rules for specifying authorization identifiers. For rules about specifying authorization identifiers, see 1.4.2 Rules for specifying authorization identifiers and passwords.
-
- ● -p password
-
~<character string>((1 to 255 bytes))
Specifies the password for the authorization identifier specified in the -u option.
- Important
-
If the password includes a character that has a special meaning in the OS or shell, such as a double quotation mark (") or vertical bar (|), make sure that you check the rules for specifying passwords. For the rules for specifying passwords, see 1.4.2 Rules for specifying authorization identifiers and passwords.
If the adbconvertaudittrailfile command is executed with this option omitted, a message prompting the user to enter a password will be displayed. In an environment in which a password cannot be entered from the standard input, such as when the command is executed in the background, make sure that you do not omit this option.
- ● --common
-
Specify this option when you want to convert an audit trail file into a common format audit trail file.
- ● -d output-directory-path-for-common-format-audit-trail
-
~<path name>((2 to 510 bytes))
Specifies the absolute path for the output-directory for common format audit trails.
Create the output-directory for common format audit trails before executing the adbconvertaudittrailfile command. For details, see Environment settings for the HADB server in Environment settings for linking the audit trail facility with JP1/Audit in the HADB Setup and Operation Guide.
- ● audit-trail-file-path
-
~<character string>((2 to 1,024 bytes))
Specifies the absolute path for the audit trail file to be converted.
However, the current audit trail file cannot be converted. If you want to convert the current audit trail file, execute the adbaudittrail --swap command to swap the current audit trail file. After that, for this option specify the absolute path of the renamed audit trail file.
Note that you can also convert audit trail files that are compressed in GZIP format.