The SMS logon script calls the SETLS program to connect to an SMS logon server. SETLS uses information in the SMSLS.INI file to select an SMS logon server from which to run the SMS Client Setup and Inventory Agent programs for a client. SETLS builds a UNC name corresponding to the platform.BIN directory on the SMS logon server (\\servername\SMS_SHR\platform.BIN) and makes the connection. (SETLS will, when necessary, use a path.) Then the client is added to the computer inventory for the SMS logon server's domain. If no SMSLS.INI file is present, SETLS runs SMS programs from the SMS logon server where the SMSLS batch file was run.
SMS uses the Windows NT Directory Replicator service to place SMSLS.BAT, SMSLS.INI, and SETLS on the NETLOGON share of all SMS logon servers running Windows NT and LAN Manager.
To support computers running Windows NT, Windows version 3.1, Windows for Workgroups, Windows 95, MS-DOS, and OS/2, there are three versions of SETLS.
Client operating system | SETLS program | Directory |
Windows NT | SETLS32.EXE | LOGON.SRV\platform.BIN |
MS-DOS, Windows version 3.1, Windows for Workgroups, and Windows 95 | SETLS16.EXE | LOGON.SRV\X86.BIN |
OS/2 | SETLSOS2.EXE | LOGON.SRV\X86.BIN |
When you select the Automatically Configure Workstation Logon Scripts option in the Clients dialog box in Site Properties, the Site Configuration Manager copies the SETLS programs (and other SMS components) to the SCRIPTS directory in the REPL$ share on the primary domain controllers in LAN Manager and Windows NT domains. Depending on the microprocessor types supported in the site, the SETLS programs for the specific microprocessor types are copied to the corresponding directory: X86.BIN (x86 microprocessors), ALPHA.BIN (Alpha microprocessors), and MIPS.BIN (MIPS microprocessors).
SETLS includes command line options for connecting a logical drive to a network server, deleting an SMS logon server connection, and running a program file located on a network server.
The SETLS command line options are:
{setls16 | setls32 | setlsos2} [/m:C] [/d:drive] [/dr:driverange] [/sh:sharename] [/i[:inifile]] [/v[:on]]
{setls16 | setls32 | setlsos2} [/m:D] [/d:drive] [/v[:on]]
{setls16 | setls32 | setlsos2} [/m:E] [/sh:sharename] [/p:programfile] [/pa:argument [...]] [/sn] [/v[:on]] [/i[:inifile]]
/m:C
Makes a network connection using a logical drive letter.
/m:D
Deletes a network connection that uses a logical drive letter.
/m:E
Runs a program file located on a remote server without making a logical drive network connection (the default is to connect).
/d:drive
Specifies a particular drive letter (the default is the next available drive letter).
/dr:driverange
Limits the search for the next available drive.
/sh:sharename
Specifies the share to connect to. The default is SMS_SHR.
/i:[:inifile]
Names the initialization file to use. The default is SMSLS.INI.
/v[:on]
Specifies verbose mode for output messages. The default is off.
/p:programfile
Is a file name or relative path to an .EXE or a .COM file.
/pa:argument
Passes an argument to the program when it runs. If you want to pass the UNC path of the SMS logon server, specify %%SMS_unc%% as the value for this argument. The SETLS program replaces this with the UNC path to the SMS_SHR share of the SMS logon server.
/sn
Indicates that the specified program should not be run on a slow network.