Add an entry for SNA usage

The Add RDB Directory Entry (ADDRDBDIRE) display is shown here. You can use the prompts in this display or the Add Relational Database Directory Entry (ADDRDBDIRE) command to add an entry to the relational database directory.

Add RDB Directory Entry (ADDRDBDIRE)
 
Type choices, press Enter.
 
Relational database  . . . . . .  MP311         Name
Relational database alias . . .   *NONE
Remote location:
  Name or address  . . . . . . .  MP311         Name, *LOCAL, *ARDPGM
  Type . . . . . . . . . . . . .  *SNA          *SNA, *IP
Text . . . . . . . . . . . . . .  'Oak Street Dealership'

In this example, an entry is made to add a relational database named MP311 for a server with a remote location name of MP311 to the relational database directory on the local server. For SNA connections, the relational database alias field must be left with its *NONE default value. The remote location name does not have to be defined before a relational database directory entry using it is created. However, the remote location name must be defined before the relational database directory entry is used in an application. The relational database name (RDB) parameter and the remote location name (RMTLOCNAME) parameter are required for the Add Relational Database Directory Entry (ADDRDBDIRE) command. The second element of the RMTLOCNAME parameter defaults to *SNA. The descriptive text (TEXT) parameter is optional. As shown in this example, it is a good idea to make the relational database name the same as the server name or location name specified for this server in your network configuration. This can help you identify a database name and correlate it to a particular server in your distributed relational database network, especially if your network is complex.

To see the other optional parameters on this command, press F10 on the Add RDB Directory Entry (ADDRDBDIRE) display. These optional parameters are shown here.

Add RDB Directory Entry (ADDRDBDIRE)
 
Type choices, press Enter.
 
Relational database  . . . . . .  MP311
Relational database alias . . .   *NONE
Remote location
  Name or address  . . . . . . .  MP311
  Type . . . . . . . . . . . . .  *SNA         *SNA, *IP
Text . . . . . . . . . . . . . .  'Oak Street Dealership'
 
Device:
  APPC device description  . . .  *LOC          Name, *LOC
Local location . . . . . . . . .  *LOC          Name, *LOC, *NETATR
Remote network identifier  . . .  *LOC          Name, *LOC, *NETATR, *NONE
Mode . . . . . . . . . . . . . .  *NETATR       Name, *NETATR
Transaction program  . . . . . .  *DRDA         Character value, *DRDA

The server provides default *SNA values for the additional Add Relational Database Directory Entry (ADDRDBDIRE) command parameters:

Device (DEV)
Local location (LCLLOCNAME)
Remote network identifier (RMTNETID)
Mode (MODE)
Transaction program (TNSPGM)

Notes:

For SNA connections, the relational database alias field must be left with its *NONE default value.
The transaction program name parameter in the iSeries™ server is TNSPGM. In SNA, it is TPN.
If you use the defaults with Advanced Program-to-Program Communication (APPC), the server determines the device, the local location, and the remote network identifier that will be used. The mode name defined in the network attributes is used and the transaction program name for Distributed Relational Database Architecture™ (DRDA^®) support is used. If you use the defaults with Advanced Peer-to-Peer Networking^® (APPN), the server ignores the device (DEV) parameter, and uses the local location name, remote network identifier, and mode name defined in the network attributes.

You can change any of these default values on the Add Relational Database Directory Entry (ADDRDBDIRE) command. For example, you might have to change the TNSPGM parameter to communicate with an DB2 Universal Database™ for VM server. By default for DB2 Universal Database for VM support, the TNSPGM is the name of the DB2 Universal Database for VM database to which you want to connect. The default TNSPGM parameter value for DRDA (*DRDA) is X'07F6C4C2'. QCNTEDDM and DB2DRDA also map to X'07F6C4C2'. For more information about transaction program name, see the related topics.