ts-shell: connect - establish a terminal session

Edit online

Runs within ts-shell on the terminal server to connect to a target system and accesses a terminal device on the target system.

Format

Figure 1. connect syntax

where:

<vm_guest>

specifies the target system.

<terminal_id>

specifies the terminal ID of the terminal to be accessed.

The terminal ID for an iucvtty instance is set in the start command for the instance.

For HVC terminal devices, the terminal IDs are lnxhvc<n>, where <n> is an integer in the range 0 - 7. If you do not need a specific HVC terminal device or if you are not sure which device is free, you can omit the trailing integer.

As of kernel 3.14, you can specify the generic terminal ID lnxhvc to automatically assign the next free terminal device.

If omitted, a default terminal ID is used. Initially, the default is lnxhvc0. You can change the default with the ts-shell terminal command. The modified default applies for the duration of the ts-shell session.

Examples

To connect to an iucvtty terminal with terminal ID lxterm1 on LXGUEST1:

alice@ts-shell> connect lxguest1 lxterm1

To connect to HVC terminal device with terminal ID lnxhvc0 on LXGUEST1:

alice@ts-shell> connect lxguest1 lnxhvc0

Unless the default terminal has been changed, this command is equivalent to:

alice@ts-shell> connect lxguest1

To connect to any free HVC terminal device on LXGUEST1:

alice@ts-shell> connect lxguest1 lnxhvc