SNAX/XF LU Network Services Manual

Modifying ESS Tables Dynamically
Using LUNS
2–16 097841 Tandem Computers Incorporated
Modifying ESS Tables
Dynamically
SNAXUTL allows you to modify a currently active ESS table dynamically: that is, you
can modify the table after LUNS has already allocated it.
For this purpose, SNAXUTL provides a SELECTFILE command operand called
DEACTIVATE. In the command file you submit to the utility, the SELECTFILE
command specify DEACTIVATE Y (yes). Your subsequent ADD and DELETE
commands modify the table. Once the table has been updated, LUNS reactivates it.
The example below shows a command file that adds a logon record for a Pathway
application:
BEGIN
SELECTFILE $SYSTEM.TABLES.ESS1,TYPE ESS,DEACTIVATE Y
ADD ESSCMD CRED, &
CMDTYPE LOGON CHAR, &
PLUNAME #CREATE, &
PROTOCOL ITI, &
CONCDATA "PATHWAY NAME $PATHX,PROGRAM CREDIT"
END
Deactivation and reactivation of ESS tables does not affect currently active LU-LU
sessions. Thus, the table can be deactivated and activated while such sessions exist.
However, when a terminal attempts a logon or logoff by means of a deactivated ESS
table, it receives an error message and must wait until the table is once again activated.
You can also use the DEACTIVATE operand of the SELECTFILE command when you
wish to delete the table.
To modify ESS tables dynamically, SNAXUTL must establish a connection with LUNS.
Your SCF configuration file must therefore include an ADD APPL command that
defines SNAXUTL to LUNS. In the ADD APPL command, always specify SNAXUTL
both as the object and as the password. Note that the password value for this
command must be a quoted string of up to eight characters. If eight characters are not
used, the string must be blank-filled to the right. The example below shows the SCF
ADD APPL command for defining SNAXUTL:
ADD APPL $SSCP.#SNAXUTL, APPLTYPE LUNSAPPL, &
PASSWORD "SNAXUTL "
If you specify DEACTIVATE Y in a SNAXUTL SELECTFILE command without
having added SNAXUTL as an SCF APPL, SNAXUTL returns Error 6420 (see
Appendix E for a list and explanation of all SNAXUTL error messages).