HP Integrity NonStop J-Series - Manual (Page 48)

behavior in the new project wizard or in the Tool Locations property page by either leaving the
Cygwin/Msys location combo empty (to disable this behavior) or by setting it to either a Cygwin
or Msys bin directory.
Deploy.jar and NSDEE_POSIX_BIN
Deploy.jar is a program that transfers files from Windows to NonStop. It is typically invoked
by a deploy makefile target. Deploy.jar uses NSDEE_POSIX_BIN to workaround a limitation
of launching a Java application with the Msys bin directory first in PATH. The limitation is that
Msys prepends the root of the Msys location to UNIX-style pathnames in Deploy.jar arguments.
Deploy.jar
checks NSDEE_POSIX_BIN to see if it has been prepended to remote OSS paths
and, if so, Deploy.jar removes it from the path.
NOTE: If you add Msys bin to the beginning of PATH outside of NSDEE (instead of having
NSDEE do this), you must define NSDEE_POSIX_BIN yourself in order for Deploy.jar to remove
it from OSS paths.
NSDEE_CONN_PORT, nsdee-auth, and Deploy.jar
NSDEE_CONN_PORT is an environment variable that is set to a port number that NSDEE listens to
for file transfer and password requests.
Deploy.jar checks if NSDEE_CONN_PORT is set. If it is, Deploy.jar forwards the file transfer
request to NSDEE.
Deploy.jar is a program that transfers files from Windows to NonStop. It is typically invoked
by a deploy makefile target. Deploy.jar checks if NSDEE_CONN_PORT is set. If it is,
Deploy.jar
forwards the file transfer request to NSDEE.
If NSDEE_CONN_PORT is not set (as when you invoke make outside of NSDEE), Deploy.jar
checks if $HOST_PASS pass is set. If it is, Deploy.jar uses its own copy of FTP or SFTP to transfer
a file and uses $HOST_PASS as the password.
nsdee-auth is a small program that also checks if NSDEE_CONN_PORT is set. If it is, it requests
passwords from NSDEE via that port. If NSDEE already has the password, it is returned on the
port. Otherwise, NSDEE prompts for a password.
If NSDEE_CONN_PORT is not set, nsdee-auth checks $HOST_PASS and returns its value if set
(just as Deploy.jar does when make is invoked outside of NSDEE is not set), nsdee-auth
checks $HOST_PASS and returns the value if set (just as Deploy.jar does when make is invoked
outside of NSDEE).
nsdee-auth is invoked on compiler command lines via back-ticks to provide a password to the
-Wsqluser option. For example:
c89 -Wsqlhost=pelican -Wsqluser=swdev.chloe,`nsdee-auth invoke pelican swdev.chloe` ...
To view the usage massage, invoke nsdee-auth with the -h option.
$ ./nsdee-auth -h
Usage: C:\e3.7\eclipse\plugins\com.hp.nsdee_1.0.0\Tools\nsdee-auth.exe deploy|invoke|mpcomp host user
However, you are not required to use nsdee-auth directly. NSDEE writes it to makefiles so the
make
program can invoke it.
The deploy, invoke, and mpcomp arguments to nsdee-auth are only meaningful when you
invoke make outside of NSDEE. When you invoke make outside of NSDEE, you must set your
password as the value of one of the following environment variables (which make nsdee-auth
pass your password to tools):
SQLMX_PASS — checked by nsdee-auth for SQL/MX compiles which occur when you invoke
make deploy (nsdee-auth is passed deploy option in this case).
SQLMX_INVOKE_PASS — used when SQL/MX preprocessor is invoked (nsdee-auth is passed
the invoke argument).
48 Concepts