Creates a virtual log or virtual log device.
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]
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.
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. |
Return code | Description |
---|---|
0 | All files were written successfully. |
>0 | An error occurred. |
mkvlog -name syslog -client lpar-01
The
system displays the output as follows: Virtual log 00000000000000005b3f6b7cfcec4c67 created
mkvlog -uuid 00000000000000005b3f6b7cfcec4c67 -vadapter vhost0
The system displays the output as follows: vtlog0 Available
mkvlog -name audit -vadapter vhost1
The system displays the output as follows: Virtual log 0000000000000000d96e956aa842d5f4 created
vtlog0 Available