How to use the LINKCFG command line utility to remove Link Services (268844)


The information in this article applies to:

  • Microsoft SNA Server 4.0
  • Microsoft SNA Server 4.0 SP4
  • Microsoft Host Integration Server 2000
  • Microsoft Host Integration Server 2000 SP1
  • Microsoft Host Integration Server 2004
This article was previously published under Q268844

SUMMARY

LINKCFG is a command-line utility that lets you install the Microsoft SNA Server and Microsoft Host Integration Server Link Services, such as the DLC 802.2 Link Service, the Distributed Link Service (DLS), and the DEMO Link Service, and other services. You can use Linkcfg.exe to remove an existing link service. This feature is included in SNA Server 3.0 Service Pack 2 (SP2) and later, in SNA Server 4.0 and later, and in Host Integration Server. Currently, the LINKCFG command-line Help does not document the /DELETE switch.

Note Before you use the LINKCFG delete switch, use the Snacfg.exe command line utility to remove the existing link service entry from the SNA or Host Integration Server Configuration (Com.cfg) file, and then proceed to delete the link service with LINKCFG.

MORE INFORMATION

For example, to delete an existing SNA or Host Integration Server Link Service, such as the DLC 802.2 Link Service, use the following command line syntax at the command prompt:

SNACFG #[path to configuration file] LINK [Server Name]:SnaDlc1 /DELETE

When you have successfully removed the link service entry from the configuration, proceed to the next command as follows:

LINKCFG LINKSVC "DLC 802.2 Link Service #1" /SERVER:[Server Name] /LSTYPE:"DLC 802.2 Link Service" /DELETE

You can use combinations of SNACFG and LINKCFG in a command line batch file to remove an existing link service, create a new link service, and then re-assign the existing connection to the new link service. For example: 

REM ----Delete the previous link service------
SNACFG #[path to configuration file] link "Server Name":SnaDlc1 /DELETE (without the quotation marks)

LINKCFG LINKSVC "DLC 802.2 Link Service #1" /SERVER:[Server Name] /LSTYPE:"DLC 802.2 Link Service" /DELETE

REM ----Add the new link service------
LINKCFG LINKSVC "Created by Linkcnfg.exe" /SERVER:[Server Name] /LSTYPE:"DLC 802.2 Link Service" /ADAPTERTYPE:EL901X /DISTRIBUTABLE:NO /USEFIXEDSAP:NO

REM ----Configure the link service for the existing connection------
SNACFG #[path to configuration file] link "Server Name":SnaDlc1 /ADD /LINKTYPE:Ether (without the quotation marks)
SNACFG #[path to configuration file] connection "Connection Name" /LINKSERVICE:SnaDlc1 (without the quotation marks)

REFERENCES

For more information about adding a link service by using Linkcfg.exe, click the following article number to view the article in the Microsoft Knowledge Base:

171625 Command-line installation of SNA Server 3.0 and 4.0 Link Service

Modification Type:MajorLast Reviewed:5/9/2005
Keywords:KB268844
©2004 Microsoft Corporation. All rights reserved.