POWER7 information

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://pic.dhe.ibm.com/infocenter/powersys/v3r1m5/index.jsp?topic=/iphb9_p5/virtualterminal.htm.

For additional information on HMC command, refer http://pic.dhe.ibm.com/infocenter/powersys/v3r1m5/topic/p7edm/mkvterm.html.

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
```

Related Information

The rmvt command.

Send feedback Rate this page

Last updated: Wed, June 03, 2015