SNADS/iX to DISOSS Configuration

This section describes the configuration parameters necessary for a successful connection between HP SNADS/iX to DISOSS

Since SNA/DS is a store and forward network, the entries necessary for a connection between HP SNADS/iX to DISOSS are only needed in the routing table and directory.

To enable HP Desk and SNA/DS 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 DISOSS Host User Profile (HUP) data set. The HUP data set defines the types of users and their locations or addresses in the network, as well as qualified user names and passwords.
The SNA/DS users in the DISOSS network (referred to as "SNA/DS resident users" in this document) must be defined in the HP Desk foreign address alias table.

Two blank worksheets are provided at the end of the chapter to facilitate these configurations. The filled-in worksheets provide the information necessary to define HP Desk users in the DISOSS HUP 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 DISOSS HUP

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

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

Figure 5-1 HP Desk Resident User Worksheet

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 programmer.

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 programmer.




	NOTE: After the HP SNADS/iX gateway administrator has completed the above fields, the DISOSS 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 DISOSS administrator should have the information necessary to configure the HP Desk users into the directory (HUP) and routing tables of DISOSS.

Title not available (Configuring HP Desk Resident Users in the DISOSS HUP)

Field 4: HP DEN DGN: Specifies a gateway user for the distribution of nondelivery reports and handling IBM to HP explicit addresses. A DEN and DGN 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 and RGN must be chosen for HP SNADS/iX.
Field 6: User DEN DGN: Specifies a DEN and DGN 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.

ADD Control Statement Parameter Definitions

The HUP Create and Maintenance Utility uses the ADD control statement to add a new user definition to the HUP. With the ADD control statement, there are keywords that are specified to define a user in the HUP. This chapter lists the keywords that must be specified and presents guidelines for setting values for these keywords in defining the routing table and directory for HP SNADS/iX users.

The DELETE and UPDATE control statements can be used to change existing HUP data set entries. These control statements and their keywords are described in the IBM publication, DISOSS Installation and Administration Reference.

The following section defines the parameters that are used for the connection between HP SNADS/iX to DISOSS. Keywords and values as shown, must be specified in the ADD control statement. Other keywords described are allowed with restrictions where indicated.

The ADD control statement and parameters for the routing table and the directory must be specified. The ADD control statement parameters specified for the routing table are different than the parameters specified for the directory (HUP).




	WARNING! Any keywords not listed are not allowed for definition of a user on the HP 3000 and therefore are not supported by HP.

Routing Table Parameters

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

The following parameters are used with the ADD control statement for the routing table.

RGN=Routing Group Name: Groups SNA/DS nodes for routing purposes. The RGN value can be one to eight characters, an asterisk, or blank. All capital letters must be used when specifying the RGN.
REN=Routing Element Name: Identifies a single node for routing purposes. The REN value can be one to eight characters or an asterisk. All capital letters must be used when specifying the REN.
SSL=service level: Sets the SNA/DS services level to different distribution priorities for the various queues. An asterisk can be specified for the service level.
QUEUE=luname: Points to the correct TCT entry for remote distributions. The luname equates to the CICS/VS TCT SYSIDENT value.
TRANSID=transaction: Specifies the DISOSS transaction ID that will be started if a distribution is to be sent to this particular user/system.




	NOTE: If both the REN and RGN contain an asterisk, then all messages that have no matching REN.RGN are routed here.

Directory (HUP) Parameters

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

The following parameters are used with the ADDcontrol statement for the directory.

USERTYPE=device: Identifies the type of device a user normally logs on to.
DDN=Document Distribution: Identifies the second part of the user name. The DDN can be one to eight characters or an asterisk. All capital letters must be used when specifying the DDN.
SA=Source Address: Specifies the first part of the user name. The SA can be one to eight characters. All capital letters must be used when specifying the SA.
RGN=Routing Group Name: Groups SNA/DS nodes for routing purposes. The RGN specified here is routed to using the RGN specified in the routing table. The RGN value can be blank. All capital letters must be used when specifying the RGN.
REN=Routing Element Name: Identifies a single node for routing purposes. The REN specified here is routed to using the REN specified in the routing table. All capital letters must be used when specifying the REN.




	NOTE: If you specify an asterisk for both the `DDN` and `SA` parameters, and a user cannot be matched to a specific node, the user will be matched to the node that contains an asterisk in the `DDN` and `SA` fields.

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 SNA/DS users into the HP Desk foreign address table.

Figure 5-2 shows the configuration worksheet for IBM SNA/DS resident users.

Figure 5-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 DISOSS administrator. Field 4 should be completed by the HP SNADS/iX gateway administrator.

Field 1: User Name: Specifies the IBM SNA/DS 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 and RGN 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 IBM SNA/DS user, the DISOSS 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.

SNADS/iX to DISOSS Configuration

Technical documentation

» Table of Contents

» Index

Configuring HP Desk Resident Users in the DISOSS HUP

ADD Control Statement Parameter Definitions

Routing Table Parameters

Directory (HUP) Parameters

Configuring SNA/DS Resident Users into HP Desk