lsvlrepo command

Purpose

Lists the virtual log repositories.

Syntax

To display the properties of all virtual log repositories:

lsvlrepo [-detail | -field FieldList]

To display the properties of the local virtual log repository:

lsvlrepo -local [-detail | -field FieldList]

To display the properties of the virtual log repository in the specified shared storage pool:

lsvlrepo -sp StoragePool [-detail | -field FieldList]

To display the properties of the virtual log repositories in the specified state:

lsvlrepo -state RepositoryState [-detail | -field FieldList]

Description

The lsvlrepo command lists and displays the configuration of virtual log repositories. You can use the -local and -sp flags to view a specific virtual log repository. Several output formats are available. The default output format displays one row for every virtual log repository and consists of columns as follows:

Shared storage pool name
Repository state
Root directory of the repository

You can view the detailed format by using the -detail flag. In this format, the virtual log repositories are displayed with each of the following properties:

Shared storage pool name
Repository state
Root directory of the repository
Maximum number of log files
Maximum size of each log file
Maximum number of state files
Maximum size of each state file

You can view the field format by using the -field flag. In this format, the virtual log repositories are displayed based on the fields that you specify. Each field can be separated by a character that is not alphanumeric. You can specify the fields as follows:

Field name	Description
lf	Maximum size of each log file
lfs	Maximum number of log files
path	Root directory of the repository
sf	Maximum size of each state file
sfs	Maximum number of state files
sp	Shared storage pool name
state	Repository state

Flags

Flag name	Description
-detail	Displays the extended output for the virtual log repository.
-field	Displays the output with the specified list of fields.
-local	Displays the properties of the local virtual log repository.
-state	Displays the properties of the virtual log repositories in the specified state.
-sp	Displays the properties of the virtual log repository in the specified shared storage pool.

Exit Status

Table 1. Command-specific return codes
Return code	Description
0	All files were written successfully.
>0	An error occurred.

Examples

To view the properties of all virtual log repositories, type the command as follows:

lsvlrepo

The system displays the output as follows:

Local Virtual Log Repository:
  Repository State:             enabled
  Path:                         /var/vio/vlogs
  Maximum Log Files:            2
  Maximum Log File Size:        1048576
  Maximum State Files:          2
  Maximum State File Size:      1048576

Virtual Log Repository for Shared Storage Pool spool1:
  Repository State:             enabled
  Path:                         /var/vio/SSP/cluster1/D_E_F_A_U_L_T_061310/vlogs/
  Maximum Log Files:            2
  Maximum Log File Size:        1048576
  Maximum State Files:          2
  Maximum State File Size:      1048576

To view the properties of the local virtual log repository, type the command as follows:

lsvlrepo -local

The system displays the output as follows:

Local Virtual Log Repository:
  Repository State:             enabled
  Path:                         /var/vio/vlogs
  Maximum Log Files:            2
  Maximum Log File Size:        1048576
  Maximum State Files:          2
  Maximum State File Size:      1048576

To view the properties of the virtual log repository in the sspool1 shared storage pool, type the command as follows:

lsvlrepo -sp sspool1

The system displays the output as follows:

Virtual Log Repository for Shared Storage Pool spool1:
  Repository State:             enabled
  Path:                         /var/vio/SSP/cluster1/D_E_F_A_U_L_T_061310/vlogs/
  Maximum Log Files:            2
  Maximum Log File Size:        1048576
  Maximum State Files:          2
  Maximum State File Size:      1048576

To view the properties of all virtual log repositories by using a custom field string, type the command as follows:
```
lsvlrepo -field "state-path lf"
```
The system displays the output as follows:
```
enabled-/var/vio/vlogs 2
enabled-/var/vio/SSP/cTA1/D_E_F_A_U_L_T_061310/vlogs/ 2
```

Related Information

The chvlog command, the chvlrepo command, the lsvlog command, the mkvlog command, and the rmvlog command.

Last updated: Wed, November 18, 2020