Available: from 1.9.2.0 (V10R1M1010)

The command “vios ​​lsviosbk” can be used to display backups of a virtual I/O server:

   vios lsviosbk [-o <format>] [{-f|-j|-y}] [-F <fields>] [-s <selections>] [-v] <vios> [<backup_specifier>[,<backup_specifier>...] ...] ...]

The backups of a Virtual I/O Server are stored on the HMCs under /data/viosbackup/'<mtms>’/<vios_uuid>. Where <mtms> is the machine type, the model and serial number in the form MMMM-TTT*SSSSSSS and <vios_uuid> is the UUID of the Virtual I/O Server.

Note: The two apostrophes are part of the directory name!

In the simplest case, only the name of the virtual I/O server is specified as an argument. All backups of this virtual I/O server are then displayed:

$ vios lsviosbk vio1
NAME               TYPE          SIZE      HMC    LAST_MODIFIED
cfgbackup.tar.gz   viosioconfig  0.003     hmc01  05/10/2024 08:55:43
nim_resources.tar  vios          3742.695  hmc01  04/08/2024 18:27:18
fullbackup.tar     vios          3743.613  hmc01  04/09/2024 07:14:33
backup2.tar        vios          3745.957  hmc02  04/09/2024 11:59:07
$

However, the backups to be displayed can be restricted using additional arguments. All attributes of the backups can be used as follows:

<attribute-name>=<value>   <value> must equal attribute value
<attribute-name>~<regex>   regular expression must match value of attribute

For example, to only display backups whose names match the regular expression ‘backup‘, the following specifier can be used:

$ vios lsviosbk vio1 name~backup
NAME              TYPE          SIZE      HMC    LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.003     hmc01  05/10/2024 08:55:43
fullbackup.tar    vios          3743.613  hmc01  04/09/2024 07:14:33
backup2.tar       vios          3745.957  hmc02  04/09/2024 11:59:07
$

It is possible to specify additional specifiers that must be fulfilled simultaneously (logical AND). For example, in the example above, you could also require that the backup is stored on the HMC hmc02. To do this, the additional specifier is simply added separated by a comma:

$ vios lsviosbk vio1 name~backup,hmc=hmc02
NAME              TYPE          SIZE      HMC    LAST_MODIFIED
backup2.tar       vios          3745.957  hmc02  04/09/2024 11:59:07
$

The following specifiers can be abbreviated:

name=<value>   identical to <value>
type=<value>   identical to <value>
hmc=<value>    identical to <value>

This means that in the example above, “hmc=hmc02” can be written more briefly as just “hmc02“:

$ vios lsviosbk vio1 name~backup,hmc02
NAME         TYPE  SIZE      HMC    LAST_MODIFIED
backup2.tar  vios  3745.957  hmc02  04/09/2024 11:59:07
$

If specifiers are separated by spaces, this is interpreted as a logical OR. This allows, for example, to display all backups of type viosioconfig in addition to the backups whose names match ‘backup‘ and are stored on hmc02:

$ vios lsviosbk vio1 name~backup,hmc02 viosioconfig
NAME              TYPE          SIZE      HMC    LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.003     hmc01  05/10/2024 08:55:43
backup2.tar       vios          3745.957  hmc02  04/09/2024 11:59:07
$

If you want to display backups of all virtual I/O servers on an HMC, you can use the similar command “hmc lsviosbk“.