Available: from 1.9.2.0 (V10R1M1010)

The command “hmc lsviosbk” can be used to display the backups of virtual I/O servers stored on an HMC:

   hmc lsviosbk [-o <format>] [{-f|-j|-y}] [-F <fields>] [-s <selections>] [-v] <hmc> [<name>|<vios_name>|<sys_name>|<type>|<last_modified>|<selection> ...]

Backups of the virtual I/O servers can be stored on the HMCs. These are saved on the HMC hard disk in the /data/viosbackup directory. The backups stored on an HMC can be displayed with “hmc lsviosbk”:

$ hmc lsviosbk hmc01
NAME              TYPE          SIZE      SYS_NAME  VIOS_NAME  LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.006     ms03      ms03-vio1  05/10/2024 08:57:24
cfgbackup.tar.gz  viosioconfig  0.007     ms03      ms03-vio2  05/10/2024 08:57:41
cfgbackup.tar.gz  viosioconfig  0.007     ms04      ms04-vio2  05/10/2024 08:58:19
cfgbackup.tar.gz  viosioconfig  0.007     ms04      ms04-vio1  05/10/2024 08:58:00
fullbackup.tar    vios          3558.838  ms03      ms03-vio1  04/30/2024 12:05:00
fullbackup.tar    vios          6255.049  ms03      ms03-vio2  05/02/2024 08:56:55
fullbackup.tar    vios          5728.691  ms04      ms04-vio2  05/02/2024 09:47:55
fullbackup.tar    vios          5615.410  ms04      ms04-vio1  05/02/2024 09:47:14
$ 

If there are a large number of backups stored, the output can become relatively long. However, by specifying additional arguments, the output can be easily restricted to the “interesting” backups. The desired value can be specified for any attribute (attribute=value), or a match can be specified using a regular expression (attribute~regex). This means, for example, that only the backups for virtual I/O servers whose name matches “vio1” can be displayed:

$ hmc lsviosbk hmc01 vios_name~vio1
NAME              TYPE          SIZE      SYS_NAME  VIOS_NAME  LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.006     ms03      ms03-vio1  05/10/2024 08:57:24
cfgbackup.tar.gz  viosioconfig  0.007     ms04      ms04-vio1  05/10/2024 08:58:00
fullbackup.tar    vios          3558.838  ms03      ms03-vio1  04/30/2024 12:05:00
fullbackup.tar    vios          5615.410  ms04      ms04-vio1  05/02/2024 09:47:14
$  

Multiple conditions can be specified separated by a comma (logical AND). The following command lists backups for virtual I/O servers whose name matches “vio1” and are also of type “viosioconfig“:

$ hmc lsviosbk hmc01 vios_name~vio1,type=viosioconfig
NAME              TYPE          SIZE   SYS_NAME  VIOS_NAME  LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.006  ms03      ms03-vio1  05/10/2024 08:57:24
cfgbackup.tar.gz  viosioconfig  0.007  ms04      ms04-vio1  05/10/2024 08:58:00
$ 

For an exact match for the attributes name, type, sys_name and vios_name, you can also specify the desired value more briefly. This means that instead of type=viosioconfig, you can also specify just viosioconfig. This means that the previous example can also be called like this:

$ hmc lsviosbk hmc01 vios_name~vio1,viosioconfig
NAME              TYPE          SIZE   SYS_NAME  VIOS_NAME  LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.006  ms03      ms03-vio1  05/10/2024 08:57:24
cfgbackup.tar.gz  viosioconfig  0.007  ms04      ms04-vio1  05/10/2024 08:58:00
$ 

Further such arguments can be specified. A space (new argument) is interpreted as a logical OR.

If you are interested in backups for a specific virtual I/O server, it is a good idea to use the analogous command “vios ​​lsviosbk” for virtual I/O servers. This shows the backups on both HMCs in a dual HMC configuration.