This appendix describes the format of a listen address when the protocol between two machines is SNA LU62. It also gives you the protocol- and platform-specific information to set up connection data entries.
|
|
|
A listen address is a unique identifier used for interprocess communications. A Communications Server has two kinds of listen addresses. It uses one to receive messages from local processes and the other to receive messages from remote Communications Servers.
This section describes the format of the listen address used to receive messages from remote processes when the network protocol is SNA LU62.
For the SNA LU62 protocol, the format of the listen address is platform specific.
Note: To view or change your instance's listen addresses, use the Configuration-By-Forms (cbf) utility or Configuration Manager (vcbf).
When you install Ingres Net on an MVS system, the listen address is determined by the IGWFPSVR macro:
INSTALL=xx
TYPE=sna_lu62
ACB=acb_name
where:
Is the installation ID, found in II_INSTALLATION
Is the ACB name defined for the Net LU6.2 application in the VTAM APPL statement
In the APPL statement, you can specify the ACB name by using the ACBNAME parameter or by omitting ACBNAME. If you omit ACBNAME, the label on the APPL statement is used as the ACB name.
Connection Data Entry Information:
Protocol: sna_lu62
Network address: lu_name[.mode_name]
where:
Is the name of the LU on the remote instance that supports the Net SNA_LU62 protocol driver.
If the remote instance is on an MVS system, the lu_name is the minor node name for the target Net LU6.2 application. This is usually, but not always, the ACB name.
If the remote instance is on a Sun-4 system, the lu_name is any LU defined for the SunLink SNA Peer-to-Peer Gateway.
Default: None.
Is the SNA logon mode name to be used for sessions with the remote instance.
Default: The mode name specified in the LOGMODE parameter of the IGWFPSVR macro.
Listen Address: tp_name
where:
Is the transaction program name that is used by the Net SNA_LU62 protocol driver on the server node. If the remote instance is on an MVS system, there is no transaction program name. Enter "x". For all other systems, the tp_name must be the transaction program name specified in the remote instance. This is generally found in the remote instance's listen address.
When you install Ingres Net on a Solaris system that is using the SNA LU62 protocol, the listen address has the format:
gateway_name.tp_name
where:
Is the name of the SunLink SNA Peer-to-Peer Gateway
This name must match a gateway_name contained in the /etc/appcs file or NIS database, as described in the SunLink SNA Peer-to-Peer Administrator's Guide.
Is the transaction program name used by the listening process. The name is an arbitrary string of up to 16 characters.
The rate at which Ingres Net polls for incoming connection requests can be controlled through the Ingres configuration variable (in config.dat file) ii.<host>.gcc.*.sna_lu62.poll (xx is the installation ID.) This specifies the polling rate in milliseconds. The polling rate defaults to 4000 (4 seconds); values smaller than this are not recommended. If there are no incoming connection requests, you can inhibit polling by setting the environment variable to the special value of -1.
Connection Data Entry Information:
Protocol: sna_lu62
Network address: session_name
where:
Is the unique session name defined to the SunLink SNA Peer-to-Peer Gateway for sessions between the Sun-4 client and the remote server instance. Default: None
Listen Address: tp_name
where:
Is the transaction program name that is used by the Net SNA_LU62 protocol driver on the server node. If the remote instance is on an MVS system, there is no transaction program name. Enter x. For all other systems, the tp_name must match the transaction program name specified in the remote server instance. This is generally found in the remote server instance's listen address for SNA_LU62.
When you install Ingres Net on an HP-UX system using the HP-UX SNAplus product, the listen address has the format:
tp_name
where:
Is the transaction program name used by the listening process.
Unless you inhibit polling for incoming connections, the name must be configured as an Invocable TP name in the SNAplusAPI configuration file. For more information, see the appendix Netu Procedures.
The rate at which Ingres Net polls for incoming connection requests can be controlled through the configuration variable (in config.dat file) ii.<host>.gcc.*.sna_lu62.poll (xx is the installation ID.) This specifies the polling rate in milliseconds. The polling rate defaults to 4000 (4 seconds); values smaller than this are not recommended. If there are no incoming connection requests, you can inhibit polling by setting the environment variable to the special value of -1.
Connection Data Entry Information:
Protocol: sna_lu62
Network address: [lu_alias].plu_alias[.mode_name]
where:
Is the alias for the Local LU to be used by the connection.
The alias must match the name of a Local LU alias established during configuration. If an LU from the pool of default Local LUs is to be used, the alias is omitted.
Is the alias by which the Partner LU for the remote instance is known.
The alias must match the name of a Remote LU alias established during configuration. Additionally, the alias must have been configured as a Partner LU for the specified local LU.
Is the name of a set of networking characteristics defined during configuration.
The name must match the name of a mode assigned during configuration with the pair of the specified Local LU and Partner LU. If a blank mode name has been configured, the name (and the preceding ".") is omitted.
Listen Address: tp_name
where:
Is the transaction program name that is used by the Net SNA_LU62 protocol driver on the server node. If the remote instance is on an MVS system, there is no transaction program name. Enter x. For all other systems, the tp_name must be the transaction program name specified in the remote instance. This is generally found in the remote instance's listen address.
When you install Ingres Net on a RS/6000 that is using the SNA LU62 protocol, the listen address has the format:
[/pathname/] connection_profile.tp_profile.tp_name
where:
Is the name of the SNA device driver.
Default: dev/sna
Refers to the names of configuration profiles that must be defined before running Ingres Net.
For information on how to define these profiles, see Using AIX SNA Services/6000 and AIX SNA Services/6000 Reference.
The AIX SNA Services/6000 Configuration Profiles appendix contains samples of connection and tp profiles suitable for Ingres Net.
Is the transaction program name used by the listening process
Connection Data Entry Information:
Protocol: sna_lu62
Network address: connection_profile
The connection_profile is a profile defined by AIX SNA Services/6000 configuration utilities for sessions between the AIX client and the remote instance. There is no default for the connection_profile.
Listen Address: tp_name
where:
Is the transaction program name that is used by the Net SNA_LU62 protocol driver on the server node. If the remote instance is on an MVS system, there is no transaction program name. Enter x. For all other systems, the tp_name must be the transaction program name specified in the remote instance. This is generally found in the remote instance's listen address.