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