GOTOSS - execute a TSS command, never to return.

Alternate Entry Name: .GOTOS

Usage:

B:
   gotoss([subsys,] format, a1, a2, a3, ... );

C:
   void gotoss([const char *subsys,] const char *format, ...);

Where:

subsys

is the optional name of the TSS subsystem to be invoked. If not supplied, the first four characters of the command line are used.

format, a1, a2, a3, ...

are a format string and a list of arguments which will be sent to PRINTF to prepare the command line for the TSS command.

Description:

GOTOSS operates in a manner similar to SYSTEM, causing a command line to be executed by TSS. Unlike the SYSTEM function however, there is no return from GOTOSS.

Before executing the command line, GOTOSS invokes the user-specified wrapup routine .WRAP and closes all open files.

Examples:

The sequence

name = "/blat";
maxsize = 20;
gotoss("access cf,%s,mode/random/,b/1,%d/*n",
     name, maxsize);

has the same effect as if the user had typed the system command

access cf,/blat,mode/random/,b/1,20/

See Also:

expl b lib extern .wrap

for a description of the use of .WRAP.

expl b lib system

for a way to execute a TSS command without terminating your program, and for some more notes about calling subsystems.

Copyright © 1996, Thinkage Ltd.