HP 3000 Manuals HP 3000 Manuals
SNADS/iX to DISOSS Configuration
This section describes the configuration parameters necessary for a
successful connection between HP SNADS/iX to DISOSS.
Since SNA/DSis a store and forward network, the entries necessary for a
connection between HP SNADS/iX to DISOSS are only needed in the routing
tableand 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 worksheetfor HP Desk
resident users.
![[]](../../pic3k/M014418/FFN43c50.gif)
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 Specifies the name of each HP Desk user.
Name 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.
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 ADDcontrol 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 DELETEand UPDATEcontrol 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 Identifies the second part of the user name.
Distribution Node 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 worksheetfor IBM SNA/DS resident
users.
![[]](../../pic3k/M014418/FFN53c50.gif)
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.