|
|
This chapter describes the function and displays the syntax for Cisco Database Connection commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Bridging and IBM Networking Command Reference.
Use the clear dbconn connection privileged EXEC command to break a client connection.
clear dbconn connection connection-id
connection-id | Client connection identification number. |
Use the dbconn license privileged EXEC command to configure the Database Connection license for StarSQL clients. Use the no form of this command to remove the license.
dbconn license license-key
license-key | License key obtained from StarQuest Software Inc. The license determines the maximum number of StarSQL connections to a Cisco router configured with Connection Database. The license key is a 32-character hexadecimal string and it is not case sensitive. |
Use the dbconn ping EXEC command to check whether or not the Database Connection servers are connecting to the relational databases on the IBM systems.
dbconn ping server-name [user user-id] [password password] [rdbname rdbname]
server-name | Name of the Database Connection server. |
user user-id | (Optional) Userid used to connect to the IBM system. If no userid is specified, the ping connection is made without APPC security. The IBM system's security settings determine whether or not the ping can succeed. |
password password | (Optional) Password used to connect to the IBM system. |
rbdname rdbname | (Optional) The name of the relational database. If RDB name is not specified, the RDB name configured for the server is used. |
Use the dbconn server Privileged EXEC mode command to configure a Database Connection server in a Cisco router. Use the no form of this command to unconfigure and disable the server.
dbconn server server-name [ipaddress ip-address] [port port-number] [rdbname rdb-name] [rlu remote-lu] [mode mode] [tpname tp-name] [idle-timeout minutes]
server-name | Name of the Database Connection server. Server names are user-defined strings up to 16 characters. |
ipaddress ip-address | (Optional) IP address used by the Database Connection server to receive a connection. When a connection arrives, this IP address is used for matching and selecting the server from multiple configured servers. |
port port-number | (Optional) The port used to listen for connections. If no port is specified, the default is 446. |
rdbname rdb-name | (Optional) The remote database name on host. When a connection arrives, this name is used to identify and select the appropriate server from multiple configured servers. The string is used to match the RDB name sent by the client in the DRDA data stream at connect time. The default RDB name is an asterisk (*) which indicates that this Database Connection server serves any remote database. |
rlu remote-lu | (Optional) APPC remote LU used to allocate the connection to the IBM system. An example is NETA.S103B345. If no remote LU is specified, the default is the configured server name which is set to uppercase and truncated to eight characters. An RLU need not be qualified with a NETID. If you omit the NET ID, the NET ID of the router's APPN control point is used to fully qualify the LU name. |
mode mode | (Optional) APPC mode used to allocate the conversation to the IBM system. If no mode is specified, the default is #INTER. |
tpname tp-name | (Optional) APPC remote transaction program name used to allocate the conversation to the IBM system. If no TP name is specified the default is the architected DRDA TP name \x076DB. |
idle-timeout minutes | (Optional) Time in minutes to wait for an idle client. If there is no activity from the client for this amount of time, the connection is forcibly broken. The time spent in waiting for a response from the IBM system is not counted, only idle time in between client requests is counted. The maximum is |
window-size bytes | (Optional) This value is used for the TCP receive window size. If no window size is specified, the default is |
Use the show dbconn connection EXEC command to display the status of connections made to Database Connection servers.
show dbconn connection [connection-id] [server server-name] [user user-id]
connection-id | (Optional) Display status for specified connection. |
server server-name | (Optional) Display connection information for specified server. |
user user-id | (Optional) Display connections for specified user ID. |
rdbname rdb-name | (Optional) Display connections for specified RDB name. |
Use the show dbconn license EXEC command to display the status of licensed StarSQL connections made to Database Connection servers.
show dbconn licenseUse the show dbconn ports EXEC command to display information on all ports that are being used by Database Connection to receive connections.
show dbconn portsUse the show dbconn server EXEC command to display the status of Database Connection servers.
show dbconn server [server-name]
server-name | (Optional) Specific server for which status should be displayed. |
Posted: Mon Feb 8 13:46:01 PST 1999
Copyright 1989-1999©Cisco Systems Inc.