RMTSYN

Purpose

The RMTSYN statement specifies the protocol used for communications by the PIPE ROUTE stage and by the RMTCMD and LABEL commands.

Syntax

Syntax for the RMTSYN statement:

RMTSYN

where:

netid: Specifies the 1 - 8 character name of the real network containing the domain or an identifier used to associate an RMTALIAS definition with the RMTSYN statement. An RMTALIAS statement is associated with this RMTSYN statement when the second position in the RMTALIAS value matches this identifier.
domain: Specifies the 1 - 5 character name of the remote NetView® domain.
IP_host: Specifies a standard IP host name or address for the remote NetView domain. When communicating using an IP transport, the IP host can be followed by a port number. IP host names are resolved to IP addresses after the main part of initialization.
port_number: Specifies the port number. A slash (/) separates the port_number from IP_host. The default port number is 4022.
IPV4: Specifies to use the IPV4 protocol to communicate with the specified domain. Use the IPV4 keyword with IP_host when it is a host name.
IPV6: Specifies to use the IPV6 protocol to communicate with the specified domain. Use the IPV6 keyword with IP_host when it is a host name.
ON netid: Specifies the 1 - 8 character name of the network containing the domain. Use the ON netid specification when an RMTSYN statement is associated with an RMTALIAS statement.
SNA: Specifies to use SNA LU 6.2 to communicate with the specified domain. This is the default.

Usage notes

If the IPV4 or IPV6 keyword is coded in an RMTSYN value and if the target host is identified by an IP address, then the IPV4 or IPV6 keyword (whichever is coded) is ignored by RMTCMD command processing.
The network ID that is specified with the ON keyword is used as the network ID for a target NetView domain under the following conditions:
- NETID=* is specified or set as the default value for a RMTCMD SEND command.
- RMTSYN statement is part of a RMTALIAS/RMTSYN statement pair that is defining an alias for a target NetView domain.

If the RMTSYN definition is part of a RMTALIAS/RMTSYN statement pair used to define an alias, the RMTSYN statement cannot be used to resolve the value of the DOMAIN keyword of RMTCMD unless the pseudo-network-ID portion of the RMTALIAS and RMTSYN statements matches the real network ID of the NetView domain to be targeted. Consider this example:

Define an alias, NTVGGV6, for remote domain NTVGG, specifying an IPv6 network transport, a host name, port number 40220, and real network ID USIBMNT

RMTALIAS.NTVGGV6 = XXV6.NTVGG

            |        |    |
            |        |    |
          Alias  Pseudo   Real
                 network  domain
                 ID       ID

RMTSYN.XXV6.NTVGG = your.host.com/40220 IPV6 ON USIBMNT

        |     |                                     |
        |     |                                     |
     Pseudo  Real                                 Real
     network domain                               network
     ID      ID                                   ID

With these definitions, the NTVGGV6 alias may be used to send a command to NetView domain NTVGG in network USIBMNT like this:

RMTCMD SEND DOMAIN=NTVGGV6 OPERID=OPER1 AUTOTBL STATUS

If you attempt to send a command from the current NetView domain, presumed to also be in network USIBMNT in this example, to NetView domain NTVGG like this:

RMTCMD SEND DOMAIN=NTVGG OPERID=OPER1 AUTOTBL STATUS

The RMTSYN statement cannot be used to resolve NetView domain NTVGG in network USIBMNT to the applicable IP address, port, and network transport, because the network ID portion of the RMTSYN statement, XXV6, does not match the real network ID, USIBMNT.

Examples

An example RMTSYN statement follows using an IP host name:
```
RMTSYN.NETA.CNM01 = host6.company.com/4022 // resolve later
```
Because this RMTSYN statement does not include a transport keyword, the IP (IPv4 or IPv6) address is determined based on the setting of the IPv6Env statement:
- NONE: IPv4 address is used, if available
- ONLY: IPv6 address is used, if available
- MIXED: first address returned is used (either IPv4 or IPv6)
An example RMTSYN statement follows using an IP address and a default port:
```
RMTSYN.NETB.CNM03 = 10.67.50.22 // IP address & default port
```
An example RMTSYN statement follows for a session using LU 6.2:
```
RMTSYN.NETX.NTVAA = SNA           // use LU6.2 for this domain
```
An example RMTSYN statement follows for a session using IPv6:
```
RMTSYN.NETX.NTVXX = 2002:92A:111:501:10:10:163:7/4022 
```

For additional examples, see the RMTALIAS statement.