Accessing a terminal device from ts-shell

If you are a ts-shell user, use the shell commands to access a terminal device.

About this task

This task applies to users who log in to ts-shell on the terminal server.

Tip: If you have Perl ReadLine installed, you can press the Tab key to complete command names, terminal IDs, and z/VM® guest IDs.

Procedure

Perform the following steps to access a terminal device:

Log in to ts-shell on the terminal server.
Optional: Confirm that you are authorized to connect to the intended target system by entering the list command. The command lists all target systems for which you are authorized with a pager. Close the pager to return to ts-shell.
Example:
```
alice@ts-shell> list
LXGUEST1
LXGUEST3
LXGUEST5
LXGUEST7
LXGUEST9
```
Connect to the target system and access the terminal device by entering a command of this form:
```
alice@ts-shell> connect <vm_guest> <terminal_id>
```
where:
<vm_guest>

specifies the z/VM user ID where the target Linux instance runs.

<terminal_id>
optionally identifies the terminal device.
For HVC terminal devices, the terminal IDs are lnxhvc<n>, where <n> is an integer in the range 0 - 7. As of kernel 3.14, you can specify the generic terminal ID lnxhvc to automatically match the ID of any free HVC terminal device.

The terminal ID for an iucvtty instance is set with the iucvtty command that starts the instance.
If omitted, a default terminal ID is used. Initially, the default is lnxhvc0. You can change the default for the duration of the ts-shell session by entering a command of this form:
```
alice@ts-shell> terminal <terminal_id>
```
where <terminal_id> is the new default. To display the current default, enter:
```
alice@ts-shell> terminal
```
Example:
```
alice@ts-shell> connect lxguest1 lnxterm1
```

Results

Depending on how the terminal device on the target system setup, you are prompted to log in to the terminal. You might have to press Enter to obtain the prompt.

Hint: Output that is written by Linux while the terminal window is closed is not displayed. Therefore, a newly opened terminal window is always blank. For most applications, like login or shell prompts, it is sufficient to press Enter to obtain a new prompt.