Open System Services Shell and Utilities Reference Manual (G06.29+, H06.08+, J06.03+)

gtacl(1) OSS Shell and Utilities Reference Manual
• Execute a single Guardian environment command (gtacl -c command or
gtacl -cv command)
• Run a Guardian environment program (gtacl -p prog args)
Using the -c or -cv option to run a Guardian process has the following advan-
tages:
• You can use Guardian environment user defaults and macros set up in a
TACLCSTM file.
• You need not distinguish among TACL built-in functions, TACL macros,
or programs external to TACL.
• You can use TACL RUN option syntax to direct input or output to Guar-
dian files (such as spooler locations) that are not available through shell
redirection.
Using the -c or -cv option to run a Guardian process has the following disadvan-
tages:
• You cannot redirect standard input using the shell.
• If you do not need TACL facilities, these options add the unnecessary
overhead of TACL process creation.
Using the -p option to run a Guardian process has the following advantages:
• It runs the program without the overhead of TACL process creation.
• There are no restrictions on redirection of OSS files using the shell.
Using the -p option to run a Guardian process has the following disadvantages:
• TACL facilities (such as built-in functions or macros) cannot be used.
Redirecting Input or Output
The gtacl process does not have its own run options for redirecting output. Instead, standard
/bin/sh redirection operators can be used to redirect the input or output of the gtacl process for
any file that can be opened using the OSS-environment open() function.
You cannot use the OSS shell to redirect input or output for files that can be opened only using
the Guardian file system (with the FILE_OPEN_ procedure call). For such files, the gtacl -c
command or -cv command option must be used with TACL file redirection. For example, the fol-
lowing command fails because the OSS shell cannot directly open the Guardian spooler process:
gtacl -p tgal < /G/vol/subvol/file > /G/S/#TITAN
Instead, the following command must be used:
gtacl -c ’tgal /IN $vol.subvol.file, OUT $S.#TITAN/’
Many Guardian processes allow input or output from a process file. The gtacl process uses this
feature by running as a named process and passing its own name in place of the OSS standard
files that cannot be opened by the Guardian FILE_OPEN_ procedure call. For example, if gtacl
is invoked with the following command and runs with a system-generated process name of
$X123:
4−40 Hewlett-Packard Company 527188-021