VSAM Path         (Environment)

DESCRIPTION
"VSAM Path" displays the full pathname 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 Path" is a full system directory pathname.


INTERPRETATION
Sun MTP system searches a defined order of directories to find the VSAM Server, 
unikixvsam, to execute. "VSAM Path" 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. 
