VSAM Name         (Environment)

DESCRIPTION
"VSAM Name" displays the file of the VSAM Server executable run by a Sun MTP 
system. This Server processes batch requests. Sun MTP allows a customer to use a
site-specific VSAM Server. For example, you must use a custom VSAM Server to 
access a database from a 3rd party database package. Sun MTP not only allows you
to customize the functionality of a Server, but also allows for, if so desired,
changing the name of the Server to enable you to distinguish processes between 
Sun MTP systems running custom Servers.


VALUES
The value of "VSAM Name" is a name of a system file. The filename is the 
rightmost portion of a full pathname (refer to "VSAM Path" for the full pathname
of the "VSAM Name"), often referred to as the 'basename'.


INTERPRETATION
Sun MTP system searches a defined order of directories to find a VSAM Server, 
unikixvsam, to execute. "VSAM Name" allows you to confirm that the Sun MTP 
system is actually using the intended binary. A problem with using the wrong 
file is easily rectified by using the correct command line option(s) to 
unikixmain.


CONCLUSIONS
By default, Sun MTP searches for unikixvsam in $UNIKIX/local/bin and if it is 
not there, looks to $UNIKIX/bin for the default binary. Sun MTP uses the first 
binary it finds. Multiple Sun MTP systems running on the same machine may share 
the default Sun MTP binaries located in $UNIKIX/bin. A locally configured Server 
that is shared by all Sun MTP systems running on a machine should be placed in 
$UNIKIX/local/bin. 

A Server that is unique to a particular Sun MTP system should be placed in a 
directory specific to that Sun MTP system. That directory should be made the 
"Local Path" with the -l option to unikixmain. The "Local Path" directory takes 
precedence over $UNIKIX/local/bin.

If you desire a VSAM Server to have a name other than unikixvsam, you may call 
your Server whatever you like and specify that name to unikixmain with the -v 
command line option. For example, if you named your VSAM Server myvsam, and 
invoke Sun MTP as follows:

$ kixstart -v /unikix/myvsam 

Sun MTP uses myvsam instead of unikixvsam. 
