mkvt command
Purpose
Create a virtual terminal connection to a partition.
Syntax
mkvt { -id lparID }
Description
The mkvt command opens a virtual terminal connection to the target partition. You can terminate the virtual terminal connection in one of the following ways:
- The virtual terminal contains an escape sequence that allows you to break out of the command. The escape sequence is <cr>~., or more explicitly: the Enter key, the tilde (~), and the period (.).
- You can use the rmvt command to force the session to be closed.
A partition can only have one open virtual terminal session.
For additional information on HMC environment, refer http://www.ibm.com/support/knowledgecenter/POWER8/p8ha1/p8ha1_kickoff.htm.
For additional information on HMC command, refer http://www.ibm.com/support/knowledgecenter/POWER8/p8edm/p8edm_kickoff.htm.
Flags
| Flag name | Description |
|---|---|
| -id lparID | The ID of the partition for which to open the virtual terminal session. |
Exit Status
| Return code | Description |
|---|---|
| 27 | Unexpected error |
| 28 | Virtual terminal is already connected |
| 29 | Virtual terminal device is not found |
| 30 | Permission denied |
| 31 | Specified device does not exist |
Security
This command is not accessible by users with the ViewOnly role.
Examples
- Create a virtual terminal connection to the partition with ID
3:
mkvt -id 3