Running tsremote

When tsremote attaches to a Basic session the tsremote screen will look just like the basic terminal; and the tsremote keyboard is also attached.

1. Execute tsremote.

   ./tsremote

2. The system displays a version banner followed by a prompt for the remote user login. Your user login will be shown inside brackets and will be used by default. Enter the user login, for example:

   Enter user login [asmith]: bsmith

3. tsremote searches the process list for Basic (b or basic) and Web Basic (tbredserv). Any matches will be displayed. For example:

   5688 bsmith pts/7 /usr/lib/basic/basic iplds
   5718 bsmith pts/8 /usr/lib/basic/basic

4. tsremote then prompts you for the process-id to connect to. If any matches were displayed, the last process-id will be shown in brackets as the default. For example:

   Enter process-id to talk to [5718]: 5688

   tsremote sends a signal to that process indicating it wants to connect to it.

5. If tsremote is running as root or the same user-id as the Basic process-id entered in step 4, the Basic screen will automatically be displayed.

Note

If the Basic session is running with a non-windowed device in the IPLINPUT file, there is no initial display.

If tsremote is not running as root and not the same user-id as the Basic process in step 4, a message similar to the following will be displayed:

*** WAITING FOR USER TO ENTER CTL/B OR
*** OPERATOR TO SEND SIGQUIT TO 5688

To complete the connection, the Basic user must press Ctrl-B, or a UNIX command must be used to send the Basic process a SIGQUIT signal. For example:

kill -SIGQUIT process-id

The second option is typically used for connecting to a background process where there is no keyboard.

Command Line Options

You can specify any of the following values from the command line:

-b

passes the name of the basic executable. To include more than one name use ; as a separation character.

./tsremote -b /b;/basic;/tbredserv

-c

alternate process argument; overrides –ef

./tsremote -c ‘fU mark’

-h

displays help for command line arguments

-l

passes login name as argument

./tsremote -l sam

-p

passes the process id as an argument

./tsremote -p 12304

-u

passes user name as argument (see -l)

Security

tsremote uses UNIX signals to communicate with a Basic process. If tsremote is executed by a different user than the Basic user (and not root), then tsremote will not be able to automatically connect. The Basic task user will have to grant permission.

It is best to have the Basic session grant access to the tsremote user by pressing Ctrl-B. If the Basic session is a background task, then pressing Ctrl-B is not an option. Your only choice is using kill –SIGQUIT or kill -SIGUSR2 to signal the process.

From the T-RemoteControl Installation, version 8.9.1. Open this page in the PDF