Neoview Command Interface (NCI) Guide (R2.5)

SQL>
• NCI does not prompt you to reenter the login values in these cases:
— If the login fails with an error stating the data source was not started
— When you include the -q or -version parameter on the command line (The -s
parameter permits login retries.)
— For a session started using redirected or piped input
In these cases, NCI returns an error message and closes the session. You must re-launch the
NCI session to connect to the Neoview platform.
Using Optional Launch Parameters
To customize how you launch and log in to NCI, use the optional parameters described in
Table 3-1 on the command line:
hpnci{.sh | .cmd} [optional-parameter]...
optional-parameter
is one of the launch or login parameters. For details, see Table 3-1.
Table 3-1 Launch and Login Parameters
DescriptionLaunch or Login Parameter
Specifies the host name or IP address of the database
platform to which you want the client to connect. The
host-name should include the domain name of the
database platform if it is different from the domain of the
client workstation. If you do not specify a port number,
NCI uses the default port number, which is 18650. For an
example, see “Using Login Parameters” (page 36).
{-h | -host} host-name[:port-number]
{-h | -host} IP-address[:port-number]
Specifies the user name for logging in to the database
platform. The user-name is case-insensitive. For an
example, see “Using Login Parameters” (page 36).
{-u | -user} user-name
Specifies the Neoview role to be applied to the NCI
session. Each user is associated with a Neoview role,
which has privileges defined for it, and some users are
assigned to multiple roles. Using this parameter, you can
apply a specific role to the session.
role-name is the role name, including the prefix
“ROLE,” such as ROLE.DBA. role-name is
case-insensitive.
If you omit role-name when specifying the -r or -role
parameter, NCI prompts you to enter the role name. Enter
a role name, or press Enter to use your default role.
If you omit the -r or -role parameter, NCI uses your
default role and does not prompt you for a role name.
NOTE: If you launch NCI from within HPDM, the NCI
session inherits the connection attributes of the HPDM
session, including the role.
For an example of the -r parameter, see “Using Login
Parameters” (page 36).
{-r| -role} role-name
38 Launching NCI