NonStop SQL/MP Reference Manual

Table Of Contents
NonStop SQL/MP Reference Manual142115
Z-17
Considerations—=_SQL_MSG_node
msg-file
is the name of the alternate message file.
Considerations—=_SQL_MSG_node
The SQL message file
The SQL message file is a key-sequenced file that contains the text of most of the
messages displayed by SQL. SQL retrieves messages from the file as needed.
The standard SQL message file (the one Tandem releases with NonStop SQL/MP) is
placed in $SYSTEM.SYSTEM.SQLMSG when NonStop SQL/MP is installed on a
node. All the messages in the file are in English.
The =_SQL_MSG_node DEFINE allows you to designate a different file as the
SQL message file for SQL if an appropriate file is available on your network.
(Tandem does not supply alternate SQL message files as a standard part of NonStop
SQL/MP. You should check at your site to determine what alternate message files, if
any, are available to you.)
When SQL needs to open the SQL message file, SQL determines whether a
=_SQL_MSG_node DEFINE is in effect for the node for the process running SQL.
If the DEFINE is in effect, SQL uses the message file specified in the DEFINE. If
there is no =_SQL_MSG_node DEFINE in effect, or if the file specified in the
DEFINE does not exist, is invalid, or is incompatible with the SQL software that
attempted to open it, then SQL opens the message file in
$SYSTEM.SYSTEM.SQLMSG.
Using an alternate message file from SQLCI
To use an alternate message file from SQLCI, you must specify an
=_SQL_MSG_node DEFINE in TACL before you start the SQLCI session. SQL
opens the message file at the beginning of an SQLCI session and leaves the file
open throughout the session. As a result, changing DEFINEs during the session has
no effect on the SQL message file used for that session.
If you regularly use an alternate message file from SQLCI, you might want to place
an =_SQL_MSG_node DEFINE in your TACLCSTM file so that it is in effect
whenever you log on. (See the TACL Reference Manual for information about
TACLCSTM.)
Using an alternate message file from a program
To use an alternate message file from a program, specify an =_SQL_MSG_node
DEFINE in TACL before you execute the program, or specify the DEFINE at the
beginning of the program. SQL will use the file you specify for all SQL messages
from the program.
If you plan to switch message files within a program by changing the
=_SQL_MSG_node DEFINE in the body of the program, be aware that SQL opens
the message file the first time you call any one of these procedures:
°
SQLCADISPLAY