NonStop SQL/MP Reference Manual

Table Of Contents
NonStop SQL/MP Reference Manual142115
Z-18
Examples—=_SQL_MSG_node
°
SQLCAFSCODE
°
SQLCATOBUFFER
°
SQLSADISPLAY
°
SQLSA_DISPLAY2
°
SQLCA_TOBUFFER2
Whether SQL closes the message file when it returns from the procedure depends on
the parameters you supply in the procedure call.
If the message file is left open, SQL uses the same message file the next time you
call one of the procedures. If the file is closed, SQL opens the message file (possibly
a different one) again the next time you call one of the procedures listed previously.
Each time SQL opens the message file, it selects the file specified in the current
=_SQL_MSG_node DEFINE, if any. Changes you make to the
=_SQL_MSG_node DEFINE have no effect on a message file that is already open.
Absence of a valid SQL message file
If SQL attempts to open $SYSTEM.SYSTEM.SQLMSG and finds that it does not
exist, is invalid, or is incompatible with the NonStop SQL/MP software, SQL will
be unable to issue error, warning, or help messages. Only a few English
informational messages that are coded in the software will be available. This
situation should never occur, however, if SQL is installed properly and the standard
SQL message file is always left in $SYSTEM.SYSTEM.SQLMSG.
Examples—=_SQL_MSG_node
The following TACL command designates an alternate message file for NonStop
SQL/MP software running on system \HQ. (This command would not work if a
DEFINE named =_SQL_MSG_HQ was already in effect.)
ADD DEFINE =_SQL_MSG_HQ, CLASS MAP, FILE \HQ.$SQL.MSG.SPANISH
The following TACL command specifies a different SQL message file for node
\XYZ if a DEFINE named =_SQL_MSG_XYZ already exists.
ALTER DEFINE =_SQL_MSG_XYZ, FILE \HQ.$SQL.MSG.FRENCH
=_SQL_RECGEN_node DEFINE
=_SQL_RECGEN_node is a system DEFINE that allows a user with super ID
authority to specify an alternate location for the FastSort record generator program.
node
is the name of the node (without the usual leading backslash “\”) running the SQL
software that is to use the alternate FastSort record generator program.
ADD DEFINE =_SQL_RECGEN_node, CLASS MAP, FILE prog-file