SNAX Connection Manager (SNAX/CM) Manual

APPLNAME Command
SNAX/CM Commands
3–2 097842 Tandem Computers Incorporated
APPLNAME Command The SNAX/CM APPLNAME command is used to specify the APPL name added
during configuration using the SCF APPL command. The APPLNAME command
must precede all commands except HELP, LOG, and TRACE.
You can issue this command only once: when you start up SNAX/CM. You cannot
reissue the APPLNAME command without stopping and restarting SNAX/CM. Once
specified, applname remains the same for the duration of the SNAX/CM session.
The syntax of the APPLNAME command is as follows:
APPL[NAME] applname [, PASSWORD " password " ]
return : (OUTFILE)
{ APPLNAME COMMAND COMPLETED |
ERROR MESSAGES }
return : ($RECEIVE)
STRUCT Reply^Receive;
INT Return^Code;
INT Ferror; !file-system error code
applname
is the name of the APPL object used to access SNAX/XF in the form #appl or
$mgr.#appl. If the first form is used, $mgr defaults to the SNAX/XF service
manager process. If applname has not been defined to the SNAX/XF service
manager by using an SCF ADD APPL command with APPLTYPE set to CMAPPL,
SNAX/CM rejects the command and issues an error message.
PASSWORD password
is a password that may be required to establish access to SNAX/XF. If the
optional attribute PASSWORD is specified in the SCF ADD APPL command for
the application, password must be specified; otherwise, SNAX/CM rejects the
command and issues error messages. The password must not exceed eight
characters and is case-sensitive.
return : (OUTFILE)
if received from the IN file, specifies the text message to be returned to the OUT
file. See Appendix B for detailed descriptions of error messages.
return : ($RECEIVE)
if received from the $RECEIVE file, returns a structured buffer that includes any
SNAX/CM return codes (described in Appendix B) and file-system error
messages.