HP SNADS/iX Configuration

This section describes the AS/400 configuration parameters that must be specified in order for the AS/400 to communicate with HP SNADS/iX.

To enable HP Desk users and SNA/DS users on an AS/400 (such as AS/400 Office users) to exchange documents and messages, two parallel configurations must occur:

The HP Desk users on the HP 3000 (referred to as "HP Desk resident users" in this document) must be defined in the AS/400 system directory. The system directory defines each user's location or address in the network and other information, such as mailing address, telephone number, etc.
The SNA/DS users in the AS/400 network (referred to as "SNA/DS resident users" in this document) must be defined in the HP Desk foreign address alias table.

Two worksheets are provided to facilitate these configurations. The filled-in worksheets provide the information necessary to define HP Desk users in the AS/400 system directory or to define SNA/DS users in the HP Desk foreign address alias table. The worksheets are described in the following sections.

Configuring HP Desk Resident Users in the AS/400 System Directory

The Worksheet for HP Desk Resident Users provides information that the AS/400 administrator needs to configure HP Desk users into the AS/400 system directory. This worksheet is also used by the HP SNADS/iX gateway administrator to configure the foreign address alias table within HP Desk.

Figure 6-1 shows the HP SNADS/iX configuration worksheet HP Desk resident users worksheet for HP Desk resident users.

The fields correspond to the numbers on the worksheet. Fields 1, 2, and 3 should be completed by the HP SNADS/iX gateway administrator. Fields 4, 5, and 6 should be completed by the IBM system administrator.




	NOTE: DEN, DGN, REN, and RGN are generic IBM SNA/DS terms that describe a user's fully-qualified IBM name in the SNA/DS network. In the AS/400 configuration, DEN is referred to as "user ID," DGN is "user address," REN is "system name," and RGN is "system group."

Figure 6-1 HP Desk Resident User Worksheet

Field 1: HP Desk User Name: Specifies the name of each HP Desk user. Allows the HP SNADS/iX gateway administrator to generate the DEN component of an SNA/DS address.
Field 2: Loc/Sub: Specifies the location and sublocation of each HP Desk user. Allows the HP SNADS/iX gateway administrator to use regional groupings when generating the DGN component of an SNA/DS address.
Field 3: Comment: Specifies additional information that may be required when generating the DGN component of an SNA/DS address. This information may be required if a DGN is associated with the division or department of a user. This field has been provided to communicate this information to the IBM system administrator.




	NOTE: After the HP SNADS/iX gateway administrator has completed the above fields, the AS/400 system administrator should complete fields 4, 5, and 6 of the worksheet. After each field has been completed for each user specified on the worksheet, the AS/400 system administrator should have the information necessary to configure the HP Desk users into the system directory and routing table of the AS/400.

Field 4: HP DEN DGN: Specifies a gateway user for the distribution of non-delivery reports and handling IBM to HP explicit addresses. A DEN (user ID) and DGN (user address) must be chosen for HP SNADS/iX.
Field 5: HP REN RGN: Specifies the IBM SNA/DS address of the HP node in the SNA/DS network. All messages being sent to the HP node will have this REN and RGN in their destination address. A REN (system name) and RGN (system group) must be chosen for HP SNADS/iX.
Field 6: User DEN DGN: Specifies a DEN (user ID) and DGN (user address) for each user specified in the table. The information that the HP SNADS/iX gateway administrator provided in the Comment field should be used to determine the DEN and DGN for each user.

A copy of the completed worksheet should be given to the HP SNADS/iX gateway administrator to configure all HP Desk resident users into the HP Desk foreign address alias table.

AS/400 System Directory Entries

The AS/400 system directory identifies each AS/400 user. Each user on each system may be fully defined or generic definitions may be made for groups of users.

The following fields are used with the Add New Directory Entry screen (WRKDIR command).

User ID: Specifies the first part of the user name. The user ID can be one to eight characters. All capital letters must be used when specifying the user ID. Note that in IBM SNA/DS terminology, this is referred to as the DEN.
User Address: Identifies the second part of the user name. The user address can be one to eight characters or an asterisk. All capital letters must be used when specifying the user address. Note that in IBM SNA/DS terminology, this is referred to as the DGN.
System Name: Identifies a single node for routing purposes. The system name specified here is routed to the system name specified in the routing table. All capital letters must be used when specifying the system name. Note that in IBM SNA/DS terminology, this is referred to as the REN.
System Group: Groups SNA/DS nodes for routing purposes. The system group name specified here is routed to the system group name specified in the routing table. This value can be blank. All capital letters must be used when specifying the system group name. Note that in IBM SNA/DS terminology, this is referred to as the RGN.




	NOTE: If you specify an asterisk for both the user ID and the user address fields of a system directory entry, this becomes a default directory entry. Any mail messages sent to a user who is not configured elsewhere in the directory will be matched to the system name and group specified by the default entry and will be sent via that route.

Configuring a Distribution Queue

In order for AS/400 Office users to send messages to HP Desk users, HP SNADS/iX must have at least one distribution queue configured on the AS/400. A distribution queue serves to map a remote system address (in this case, the REN and RGN of the HP 3000 gateway system) to a specific APPC device. This allows messages destined for HP Desk to be directed to the proper connection and link.

The following fields must be configured in the Add Distribution Queue screen (CFGDSTSRV command) of the AS/400:

Queue Name: Identifies a connection to APPC. A distribution queue is used by one or more routing table entries for distributing mail to remote systems (in this case, the HP 3000).
Queue Type: Specifies the type of distribution queue. Enter *SNADS.
Remote Location Name: Must match the field of the same name configured for an APPC device.
Mode Name: Must match the field of the same name configured for an APPC device.
Remote Net ID: Must match the field of the same name configured for an APPC device.
Local Location Name: Must match the field of the same name configured for an APPC device.

Configuring the Routing Table

The routing table determines the communication route that is used to distribute documents to particular users at particular systems.

The following fields are used on the Add Routing Table Entry screen (CFGDSTSRV command).

System Group: Groups SNA/DS nodes for routing purposes. The system group name can be one to eight characters, an asterisk, or blank. All capital letters must be used when specifying the system group name.
System Name: Identifies a single node for routing purposes. The system name can be one to eight characters or an asterisk. All capital letters must be used when specifying the system name.
Queue names: Points to a particular distribution queue for each service level (that is, distribution priority). Each queue name must match a configured distribution queue name.




	NOTE: If both the system name and group contain an asterisk, then all messages that have no matching system/group name combination are routed here.

Configuring SNA/DS Resident Users into HP Desk

The Worksheet for IBM SNA/DS Resident Users provides information that the HP SNADS/iX gateway administrator needs to configure AS/400 Office users into the HP Desk foreign address table.

Figure 6-2 shows an example of the configuration worksheet for IBM SNA/DS resident users.




	NOTE: DEN, DGN, REN, and RGN are generic IBM SNA/DS terms that describe a user's fully-qualified IBM name in the SNA/DS network. In the AS/400 configuration, DEN is referred to as "user ID," DGN is "user address," REN is "system name," and RGN is "system group."

Figure 6-2 IBM SNA/DS Resident User Worksheet

The fields correspond to the numbers on the worksheet. Fields 1, 2, and 3 should be completed by the AS/400 system administrator. Field 4 should be completed by the HP SNADS/iX gateway administrator.

Field 1: User Name

Specifies the AS/400 user's name. This name should be obtained from a company wide directory or phone book.

Field 2: DEN DGN

Specifies the IBM SNA/DS address for the user name in field 1. The DEN and DGN must be in all uppercase letters.

Field 3: REN RGN

Specifies the REN (system name) and RGN (system group) for the DEN.DGN in field 2 or the REN.RGN for an IBM machine that supports SNA/DS redirection. All messages sent from HP SNADS/iX to the DEN and DGN for a user will be sent to the REN and RGN specified for that user. The REN and RGN specified for a user must have the capability of forwarding a message to its final destination. The REN and RGN must be in all uppercase letters.




	NOTE: After completing the above fields for each AS/400 Office user, the AS/400 system administrator should give the worksheet to the HP SNADS/iX gateway administrator to complete the remaining field.

Field 4: Loc/Sub

Specifies the location and sublocation for each IBM SNA/DS resident user who will be addressed transparently.

The completed worksheet will provide all the information necessary for the HP SNADS/iX gateway administrator to configure the IBM SNA/DS resident users.

AS/400 Worksheets

At the end of this chapter are blank versions of the worksheets described previously in this chapter. Use copies of these worksheets to facilitate your configurations.