OSI/TS Management Programming Manual

Running a TSP Process
Communicating with OSI/TS (TSP) Processes
2–2 056786 Tandem Computers Incorporated
Running TSP Interactively
With a RUN Command
The TSP process code is contained in an object file called TSPOBJ. To run this process
interactively, enter a RUN command from either TACL or SCF. For the syntax of the
RUN command, refer to the TACL Reference Manual.
You must be logged on as a member of the Guardian 90 super group (group ID 255)
when you enter the RUN command to run the TSP process. Otherwise, requests from
the TSP process to an underlying X25AM or TLAM I/O process will fail with a
security error.
Special considerations apply to some of the TACL run options and other parameters
when you run TSPOBJ.
First, you must specify the NAME option; the Guardian 90 operating system will not
start a TSP process unless a name is specified. The TSP process name can be up to 6
characters (the $ sign followed by 5 characters). For example:
$TSP10
$TSP12
If two or more TSP processes share the same X25AM line, the first 4 characters after
the $ sign are used by TSP to build the SU name and must be unique. For example:
$TSP10
$TSP20
$TSP30
TSP processes on D-series systems that communicate with applications on remote C-
series systems can have names up to 5 characters (the $ sign followed by 4 characters).
For example:
$TSP1
$TSP2
If your application uses a large amount of stack space, the SWAP option can be useful.
This option allows you to move the swap file to a disk volume other than the volume
on which the program file resides.
For D-series systems, by default the process will be run at a low PIN. If you want the
process to run at a high PIN, you must specify HIGHPIN ON in the command line.
You should always specify a primary and a backup CPU, so that the TSP process will
run as a NonStop process pair. Otherwise, if the CPU in which the process is running
fails, you will be unable to establish a new connection.
You can use an implicit RUN command (that is, omit the word RUN) if your TSPOBJ
file resides on the subvolume $SYSTEM.SYSTEM or $SYSTEM.SYSnn.
Examples:
TSPOBJ /NAME $TSP1, NOWAIT, PRI 170, HIGHPIN ON, CPU 4/5
(D-series systems only)
RUN TSPOBJ /NAME $TSP1, NOWAIT, PRI 170, SWAP $SPARE, CPU 7/8