ts-shell: list - list authorized target systems

Runs within ts-shell on the terminal server to list all target systems for which a ts-shell user is authorized.

Lists are displayed with a pager. Close the pager to return to ts-shell.

The default pager is less in secure mode (set with the LESSSECURE environment variable).

You can use the PAGER environment variable to specify the full path to an alternative pager. Because ts-shell is a login shell, you might have to use a security module to set environment variables. For example, you might have to use the pam_env module.

Format

Figure 1. list syntax

Examples

Listing authorizations that are defined in list format:

alice@ts-shell> list
LXGUEST1
LXGUEST3
LXGUEST5
LXGUEST7
LXGUEST9

Listing authorizations that are defined as regular expressions:

bob@ts-shell> list
Regular expressions for your authorization:
(?i-xsm:lxguest[02468])
(?i-xsm:^linux[0-9]{2}$)

Listing authorizations that are defined as regular expressions if further restrictions exist for ts-shell. Those IDs in /etc/iucvterm/ts-systems.conf that match one of the regular expressions is appended to the user authorizations.
If /etc/iucvterm/ts-systems.conf reads:
```
LXGUEST1
LXGUEST2
LXGUEST3
LXGUEST5
LINUX07
LINUX11
LINUX13
```
the previous example becomes:
```
bob@ts-shell> list
Regular expressions for your authorization:
(?i-xsm:lxguest[02468])
(?i-xsm:^linux[0-9]{2}$)
You are authorized to connect to these z/VM guest virtual machines:
LXGUEST2
LINUX07
LINUX11
LINUX13
```