Snacfg Link

Note   This command has been superceded by Linkcfg. See Linkcfg at the end of this chapter.

Important     If you specify adapter properties with snacfg link, these properties must match existing properties in your installation, or a nonfunctioning configuration may result. To protect against errors with snacfg link, use SNA Server Manager instead.

Before configuring link services, you must use SNA Server Manager to add the server on which the link services will be located. For more information, see "Task Order" earlier in this chapter. Syntax snacfg [#configpath] link /list Recommended Syntax snacfg [#configpath] link servername:linkname
snacfg [#configpath] link servername:linkname /add [options]
snacfg [#configpath] link servername:linkname [options]
snacfg [#configpath] link servername:linkname /delete Other Available Syntax snacfg [#configpath] link linkname
snacfg [#configpath] link linkname /add [options]
snacfg [#configpath] link linkname [options]
snacfg [#configpath] link linkname /delete

where
 

#configpath

Specifies the path of the configuration file to view or change. If the configuration path is omitted, SNA Server will attempt to access the configuration file on the local system, using the path \SNAServerRoot\SYSTEM\CONFIG\COM.CFG, where SNAServerRoot is the SNA Server root directory.

/list

Generates a list of configured link services.

servername

Specifies the name of the server on which to view or change link services. Separate the name of the server from the name of the link service with a colon (:). It is recommended that servername be included in every snacfg link command that includes linkname. Without servername, if there is more than one link service called linkname in the installation, it is difficult to predict which link service called linkname will be affected by the command. The snacfg link command does not necessarily default to the local server if servername is omitted.

linkname

Specifies the name of the link service to view, modify, or delete. Link services names can contain from one through eight alphanumeric characters.

For adding link services, the recommended method is to use SNA Server Manager, not snacfg link.

If no options are specified after linkname, the result is a list of the configuration settings for the specified link.

/add

Adds a link service called linkname. To configure the link service, either specify other options after /add, or specify configuration options in additional snacfg link commands (using the same servername:linkname combination).

For adding link services, the recommended method is to use SNA Server Manager, not snacfg link.

/delete

Deletes linkname.

options

Are as shown in the following list.

/server:servername

Specifies the server on which to install the link service.

/linktype: { token | ether | sdlc | x25 | dft }

Specifies the type of adapter with which linkname works. The types are as follows: token corresponds to token ring, ether corresponds to Ethernet, sdlc corresponds to SDLC, x25 corresponds to X.25, and dft corresponds to DFT.

/linetype: { leased | softdial | manual } (for SDLC lines only)

Specifies the type of SDLC line (and, where applicable, the modem) that the link service will use:

• A leased line is a telecommunications line committed solely to SDLC communications with a particular remote system.
• A softdial line is a switched SDLC line on which the modem is dialed automatically by SNA Server. Such a modem must be attached to an SDLC adapter with a built-in serial (COM) port. Otherwise it is considered a manual modem.
• A manual line is a switched SDLC line on which the modem stores a phone number, or on which the modem is dialed manually.

/carrier: { on | off }(for SDLC lines only)

Specifies whether the constant carrier option for an SDLC line is on or off.