Integrated Link Service Configuration and Reconfiguration

In SNA Server 2.x, the .INF script created a Windows NT service to run your link service DLL, installed the device driver, and prompted the user for initial configuration information, in addition to supporting subsequent reconfiguration. In SNA Server 3.0 and later, the initial configuration functions are performed by your configuration DLL running in the context of SNA Explorer.

After your link service has been created, SNA Explorer must be able to locate its configuration DLL when the operator wishes to reconfigure the link service. To support this feature, when your configuration DLL initially creates the link service, it must put a new value in the registry of the target server as follows:

SYSTEM\CurrentControlSet\Services\<yourLinkService>\Parameters

DLLName: REG_SZ: <configDllName>

where:

<configDllName> is the file name and extension of the configuration DLL, for example, IBMSDCFG.DLL. No path is specified in the value.

This value replaces InfName, which was used in SNA Server 2.x to name the path to the .INF file.

Since SNA Explorer can be running on a management workstation remote from the target server, the configuration DLL must be able to create configuration information on the target server. The sample configuration DLL included with the SNA SDK sample files illustrates the utility functions available to perform these functions across a network connection on the target server. Also, since the management workstation may be of any CPU type supported by Windows NT, you must provide versions of the configuration DLL for each CPU type. SNA Explorer loads the appropriate CPU-type version of the configuration DLL over the network from \<snaRoot>\SYSTEM\HWSETUP\<cpu> on the target server as needed.

Note There is an alternate way of locating the Link Service Configuration DLL if the link services from the vendor were not included with the released SNA Server CD-ROM. Depending on the setup tool used by the vendor, the vendor's setup software may not be able to read the registry and locate the directory where link services should be installed. To resolve this problem, the SNA Manager scans the LinkServicesInstalled key prior to making the call to the Link Service Configuration DLL. The SNA Manager checks for a % character in the configDllName and if it exists configDllName will be interpreted differently than just the name of the configuration DLL. The following example illustrates this case:

Under the SYSTEM\CurrentControlSet\Services\<yourLinkService>\Parameters key

DLLName: REG_SZ: "share\%s\<relative path and DLL Name>

If a %s string is found, then \\ServerName will be prepended and the CPU architecture string (i386 or Alpha) will be substituted for %s.