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

User Commands (g - j) gtacl(1)
Guardian PARAMs and passed to the child process in a Guardian-environment
PARAM system message. Underscores in an OSS environment variable name
are converted to circumflex (ˆ) characters in the equivalent Guardian PARAM
name.
A single PARAM name and value can contain up to 255 bytes of character infor-
mation for one environment variable. If the length of an OSS environment vari-
able name plus the value for that variable exceeds 254 bytes, the variable is not
converted and an error message is sent to the standard output file for gtacl.
Up to 1024 bytes of PARAM names and values are supported. PARAM names
and values are accumulated from the current shell environment variables by
default, in the order defined. If more OSS environment variables need to be con-
verted and passed than fit within the 1024-byte limit, only those that fit are
passed. The remaining OSS environment variables are ignored and gtacl issues
a warning message.
If the 1024-byte limit does not allow needed environment variables to be passed,
the -f flag can be used to specify a specific set to be passed. When the -f flag is
used, no accumulated environment variables are passed. Instead, each environ-
ment variable specified in the text file associated with the -f flag is converted to a
separate Guardian PARAM. The converted PARAMs from the file must still fit
within the 1024-byte limit.
Guardian Environment Variables
The following Guardian environment variables affect the execution of the gtacl command.
DEFINEs
=_DEFAULTS Provides the default values for the current Guar-
dian volume and subvolume names.
If the -defmode on option is used, all Guardian DEFINEs inher-
ited by gtacl are inherited by the child process. Up to 256K
bytes of DEFINEs can be inherited. The actual maximum
depends on the size of the PFS for the child process.
If the -defmode off option is used, only the Guardian
=_DEFAULTS DEFINE values inherited by gtacl are inherited
by the child process.
DIAGNOSTICS
Error diagnostics are written to the OSS environment standard error file of the gtacl process. All
gtacl error messages are prefixed with gtacl[n]:, where n is a unique message number. The
following messages can appear:
gtacl[1]: unrecognized option option_name
You specified an option that gtacl does not recognize.
Check for typographical errors and reenter a corrected command
line.
gtacl[2]: unable to open $RECEIVE, error n stre rror(n)
Guardian file-system error n was returned when gtacl attempted
to open its own Guardian $RECEIVE file. The meaning of that
error number as returned by the strerror() function is displayed.
The recovery action depends on the Guardian file-system error
527188-021 Hewlett-Packard Company 4−43