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

  1. Create a virtual terminal connection to the partition with ID 3:
    mkvt -id 3



Last updated: Wed, November 18, 2020