---

HMC Manual Reference Pages  - VIOSVRCMD (1)

---

viosvrcmd - run Virtual I/O Server command

CONTENTS

Synopsis
Description
Options
Examples
Environment
Bugs
Author

viosvrcmd -m managed-system {-p partition-name | --id partition-ID}
-c "command" [-t timeout] [--admin] [--help]

viosvrcmd runs an I/O server command line interface (ioscli) command on a Virtual I/O Server (VIOS).

The ioscli commands are passed from the Hardware Management Console (HMC) to the VIOS over an RMC session. RMC does not allow interactive execution of ioscli commands.

-m	The name of the managed system which has the VIOS on which to run the command. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name.
-p	The name of the VIOS partition on which to run the command. You must either use this option to specify the name of the partition, or use the --id option to specify the partition’s ID. The -p and the --id options are mutually exclusive.
--id	The ID of the VIOS partition on which to run the command. You must either use this option to specify the ID of the partition, or use the -p option to specify the partition’s name. The --id and the -p options are mutually exclusive.
-c	The I/O server command line interface (ioscli) command to run on the VIOS. command must be enclosed in double quotes.
-t	The maximum time, in minutes, to wait for the VIOS command to complete. The following timeout values are supported: 1, 3, 5, 8, 10, 20, 30, 40, 50, 60, and 120 minutes. If any other value less than 120 is specified, the value is rounded up to the next supported value. If a value greater than 120 is specified, the command will fail with an error. If this option is not specified, the timeout value defaults to 10 minutes.
--admin	Specify this option to run the command as root on the VIOS. The HMC will run oem_setup_env immediately before running command. Only HMC users with the ViosAdminOp task in their task roles are authorized to specify the --admin option. Either the mkaccfg or the chaccfg command must be used to add the ViosAdminOp task to a task role. The ViosAdminOp task can only be added to custom task roles that are based on the hmcoperator or hmcsuperadmin task role. None of the pre-defined task roles, including the hmcoperator and hmcsuperadmin task roles, contain the ViosAdminOp task.
--help	Display the help text for this command and exit.

Run the ioslevel command on VIOS vios_lpar:

viosvrcmd -m mySystem -p vios_lpar -c "ioslevel"

Run the lsdev -virtual command on the VIOS that has a partition ID of 4:

viosvrcmd -m 9406-570*A0001234 --id 4 -c "lsdev -virtual"

None

None

IBM Austin