mkvlog command
Purpose
Creates a virtual log or virtual log device.
Syntax
To create a virtual log without attaching it to a virtual SCSI (VSCSI) host adapter:
mkvlog -name LogName -client ClientName [-sp StoragePool] [-f UUID] [-state VirtualLogState] [-lf FileCount] [-lfs FileSize] [-sf FileCount] [-sfs FileSize]
To attach an existing virtual log to a VSCSI host adapter:
mkvlog -uuid UUID {-vadapter Adapter | -aplc PhysicalLocationCode}[-dev DeviceName]
To create a virtual log and attach it to a VSCSI host adapter:
mkvlog -name LogName [-client ClientName] [-sp StoragePool] {-vadapter Adapter | -aplc PhysicalLocationCode} [-f UUID] [-dev DeviceName] [-lf FileCount] [-lfs FileSize] [-sf FileCount] [-sfs FileSize]
Description
By using the mkvlog command, you can create virtual logs and also attach them to specified VSCSI host adapters that are ready to use. You can specify the properties of the new virtual log by using the command parameters. If you do not specify the command parameters, the repository default values are used.
If you do not specify the client name by using the -client flag when you create a virtual log and attach it to the VSCSI host adapter, an attempt is made to communicate with the attached logical partition to produce a value for the client name. However, this attempt cannot be made if the client logical partition is not running or the operating system on the client logical partition does not support this feature. In such cases, you must specify the -client flag when you create the virtual log.
When you create a virtual log and specify the connecting VSCSI host adapter by using the -vadapter or -aplc flags, the -state flag of the new virtual log is enabled and it is not valid to force a value by using the -state flag.
Flags
| Flag name | Description |
|---|---|
| -aplc | Specifies the adapter to which the virtual log is attached. |
| -client | Specifies the client name of the new virtual log and can be 1 - 96 characters. |
| -dev | Specifies the name of the new virtual log device. |
| -f | Forces the UUID of the new virtual log to the specified value. |
| -lf | Specifies the maximum number of log files and can be 1 - 1000. |
| -lfs | Specifies the maximum size of each log file and can be specified in bytes, or suffixed with K, M, or G. |
| -name | Specifies the log name of the new virtual log and can be 1 - 12 characters. |
| -sf | Specifies the maximum number of state files and can be 1 - 1000. |
| -sfs | Specifies the maximum size of each state file and can be specified in bytes, or suffixed with K, M, or G. |
| -sp | Specifies the name of the shared storage pool to use. |
| -state | Sets the virtual log to one of the specified
states as follows:
|
| -uuid | Specifies the UUID of an existing virtual log to create a device for. |
| -vadapter | Specifies the adapter to which the virtual log is attached. |
Exit Status
| Return code | Description |
|---|---|
| 0 | All files were written successfully. |
| >0 | An error occurred. |
Examples
- To create a new virtual log with the log name syslog and
the client name lpar-01, type the command as follows:
The system displays the output as follows:mkvlog -name syslog -client lpar-01Virtual log 00000000000000005b3f6b7cfcec4c67 created - To attach the virtual log with a UUID 00000000000000005b3f6b7cfcec4c67 to
the VSCSI host adapter vhost0, type the command
as follows:
The system displays the output as follows:mkvlog -uuid 00000000000000005b3f6b7cfcec4c67 -vadapter vhost0vtlog0 Available - To create a new virtual log with the log name audit and
attach it to the VSCSI host adapter vhost1, type
the command as follows:
The system displays the output as follows:mkvlog -name audit -vadapter vhost1Virtual log 0000000000000000d96e956aa842d5f4 created vtlog0 Available
