Using the relational database directory

The IBM® i operating system uses the relational database directory to define the relational database names that can be accessed by system applications and to associate these relational database names with their corresponding network parameters. The system also uses the directory to specify if the connection uses Systems Network Architecture (SNA) or IP.

The relational database directory allows a client to accept a relational database name from the application and translate this name into the appropriate Internet Protocol (IP) address or host name and port, or the appropriate Systems Network Architecture network identifier and logical unit (LU) name values for communications processing. As of V5R2, the RDB directory is also used to specify the user's preferred outbound connection security mechanism. The relational database directory also allows associating an ARD program with a relational database name.

Each IBM i operating system in the distributed relational database network must have a relational database directory configured. There is only one relational database directory on a system. Each client in the distributed relational database network must have an entry in its relational database directory for its local relational database and one for each remote and local user relational database that the client accesses. Any system in the distributed relational database network that acts only as a server does not need to include the relational database names of other remote relational databases in its directory.

The relational database name assigned to the local relational database must be unique. That is, it should be different from any other relational database in the network. Names assigned to other relational databases in the directory identify remote relational databases, or local user databases. The names of remote RDBs must match the name an server uses to identify its local system database or one of its user databases, if configured. If the local system RDB name entry at an server does not exist when it is needed, one will be created automatically in the directory. The name used will be the current system name displayed by the Display Network Attributes (DSPNETA) command.