Guardian C Library Calls Reference Manual

Reference to Library Calls
Guardian TNS C Library Calls Reference Manual—128833 3-217
system
system
The system function sends a string of characters to the TACL command process for
execution.
string
points to an array of characters.
Return Value
is 0 if the system function sends a string and no error occurs. A non-zero return
value other than 1 indicates that a Guardian error occurred.
If the system function is called with string being a null pointer, the return value is 1,
which indicates that the system function is implemented.
Usage Guidelines
•
The first time the system function is invoked, a TACL process is started with a null
OUT file and the current default volume and subvolume names. The current default
volume and subvolume names are used by the C run-time library to expand all
partial file names. This default can be changed with the chvol function.
The TACL process continues to service calls to the system function. Thus, by
making successive calls to the system function, you can establish a context for the
TACL command processor.
#include <stdlib.h>
int system(const char *string);