iinamu Command--Administer the Name Server
Permission required: Privileged user.
The Name Server Maintenance Utility (iinamu) allows a system administrator or other privileged user to display server information and administer the Name Server.
The iinamu command has the following format:
iinamu
At the IINAMU prompt, enter one of the following commands:
show [svr_type]
Shows the list of registered servers. The svr_type can be:
SERVERS
Shows all servers registered with the Name Server.
INGRES
(Default) Shows DBMS Server process
COMSVR
Shows GCC Communications Server process
IINMSVR
Shows Name Server process
DASVR
Shows Data Access Server process
STAR
Shows Star Server process
RMCMD
Shows Remote Command Server process
BRIDGE
Shows Protocol Bridge Server process
IUSVR
Shows Recovery Server process
gateway
Shows Enterprise Access Server (gateway) process. Gateway can be: MSSQL, ORACLE, DB2UDB, INFORMIX, SYBASE, RDB, or RMS.
user-defined DBMS
Shows user-defined DBMS server process, as defined in the server_class parameter for the DBMS Server in Configuration-By-Forms or Configuration Manager, for example BATCH, ONLINE, ACCOUNTS.
add svr_type obj_name gcf_address [flag]
Adds a server to the list of registered servers. Only a privileged user can run this command. Adding entries is not recommended and should be unnecessary as the information is automatically obtained from the servers during registration (at startup) and is based on the configured server_classes.
obj_name
Specifies the names of the objects that each server can service. Valid values are:
* (asterisk)—Is the default for DBMS Servers, which indicates that all databases can be accessed. All other servers do not register specific objects.
Database list—Is a single database or a comma separated list of databases that the DBMS Server can connect to.
flag can be one or more of the following values:
sole—Adds a sole server.
merge—Does not delete existing entries for the server at gcf_address when the new entry is added. Use this flag to add a new object to be serviced by an existing server.
delete svr_type obj_name gcf_address
Deletes a server from the list of registered servers. Only a privileged user can run this command. The svr_type and obj_name must associate with the information for the gcf_address.
stop
Stops the Name Server. This command is the correct way to stop the Name Server process. If the Name Server is stopped while servers are running, users cannot connect to those servers. Connected users will not be affected until they need to connect to a server. Only a privileged user can run this command.
help
Displays command information.
quit
Closes iinamu.
Note: The exit command is a synonym for quit.
Note: At times, you may want to start DBMS servers that are not publicly registered with the Name Server. You can do this by setting the configuration parameter name_service to off. If this option is used, the server is not registered with the Name Server when it starts and is therefore invisible to iinamu. The GCF address can still be found and the server manually registered with the Name Server. If the server is a DBMS Server, connection can still be made by defining II_DBMS_SERVER to the server address.