The SMS.INI file is installed on all computers when they are added to the SMS system. This file stores system information about the client and the SMS site in which it is contained. SMS Client Setup creates the SMS.INI file, however the file is maintained and used by all of the SMS client components. The SMS.INI file is located in the root of the first (alphabetical) local hard drive (usually drive C).
SMS.INI is created from a master template file named DOMAIN.INI, which is located in the LOGON.SRV directory (SMS_SHR) on all SMS logon servers. The DOMAIN.INI file contains a subset of SMS.INI entries that are valid in the domain. When SMS Client Setup creates the SMS.INI file on a client, some of the values in the SMS.INI file are derived from the DOMAIN.INI file; other values are based on the specific configuration of the client.
The following sections and entries are in the SMS.INI file:
These sections and entries are described in the following sections. In addition, a sample SMS.INI file is included in "Sample SMS.INI File" later in this chapter.
Information used by the Package Command Manager to locate its instruction files, results directory, and local status file.
InstructionSharePoint
The location of the Package Command Manager instruction files on the SMS logon server. The location is a subdirectory of the SMS logon server share.
ResultSharePoint
The location where the Inventory Agent places results of Package Command Manager actions.
LocalRegistryLocation
The location of the registry file (PCMHIST.REG) used by the Package Command Manager to store package information.
PollingInterval
Specifies how often (in minutes) the Package Command Manager checks for new packages. This value is the polling interval that is set in the Site Properties window of the SMS Administrator. If a value for PollingInterval is set in the [Local] section of SMS.INI, it overrides this value.
The servers available to the client components. These servers are SMS logon servers in the client domain. The client components use the entries in this section to determine where to read instructions or configuration information. In addition, these entries are used to determine where to send inventory and status information. Each server is listed as a separate entry in this section.
Domain
The name of the domain that processed the current user's logon request.
CurrentLogonServer
The name of the server that processed the current user's logon request.
Servernumber
The name of a server that acts as a collection point for the current client. The number identifies each server entry (for example, Server1, Server2, and so on).
The shares to be used by the SMS client components. Each entry corresponds to an entry in the [Servers] section.
CurrentLogonServer
The share name on the current SMS logon server. On servers running Windows NT Server, LAN Manager, and LAN Server, this share is named SMS_SHR. On servers running NetWare, this entry specifies the volume name.
Servernumber
The share name for the corresponding server listed in the [Servers] section.
The location of the files that store the configuration information for SMS network applications. Program Group Control reads configuration information from the files and uses it to configure and run SMS network applications.
Directory
The name of the directory containing the SMS network application files. The directory is relative to a server specified in the [Servers] section and the corresponding share name specified in the [Share] section.
The location of the initialization files required by SMS network application configuration scripts. If an application requires a local copy of an initialization file, the configuration script can copy the file from this location to the local client.
Directory
The name of the directory containing the initialization files. The directory is relative to a server specified in the [Servers] section and the corresponding share name specified in the [Share] section.
The location of the SMS network application configuration scripts. If an application requires a configuration script, the Application Control program looks for its configuration script at this location and runs it.
Directory
The name of the directory containing the configuration scripts. The directory is relative to a server specified in the [Servers] section and the corresponding share name specified in the [Share] section.
The location of the Package Command Manager installation scripts and SMS network application configuration scripts that are provided with SMS. This directory contains all default script processors.
Directory
The name of the directory containing the default script processors. The directory is relative to a server specified in the [Servers] section and the corresponding share name specified in the [Share] section.
Indicates the client status.
SysFilesNotModified
Lists files, such as AUTOEXEC.BAT and WIN.INI, that SMS Client Setup could not modify. This indicates an error condition.
FilesNotDownloaded
Lists files that SMS Client Setup could not download. This indicates an error condition.
InstalledComponents
Indicates components installed on the client.
AutoStartComponents
Indicates components that are automatically started on the client.
StandaloneWorkstation
Reserved. Should be set to NO.
FailedHardwareChecks
Lists any hardware failures encountered during the inventory process. These failures are also listed in the SMSSAFE.TMP file. For more information about SMSSAFE, see Chapter 2, "Client Reference."
The information that identifies the client and maintains its inventory.
BuildNo
The SMS product build number. This number is compared to the build number in the DOMAIN.INI file on the SMS logon server. If the build numbers differ, the client software is automatically upgraded.
SPNumber
The SMS Service Pack number.
INIFileVersion
The version reference of the INI file. The higher 16 bits are the actual INI file version; the lower 16 bits are the build number.
CopyListVersion
The version reference of the copy-list file.
SiteCode
The three-character code identifying the site that maintains the current client's inventory.
SMS Unique ID
The client's system identifier, which is included in RAW files sent to the SMS logon server. The ID consists of a three-character site code followed by a five-digit number, such as TTT00003.
SMSPath
The client directory that contains SMS files and directories. Package Command Manager, Program Group Control, Program Group Control Start, SMSRUN, and the Inventory Agent read this path from SMS.INI.
SMSBinPath
The client directory that contains the SMS binaries.
StandaloneISVMIFPath
The directory path containing standalone MIF files. Objects defined by standalone MIF files have a custom architecture and are not included in the client's inventory (displayed in the Inventory window and the Personal Computer Properties - [computername] window). Instead, these standalone MIF objects are added to the SMS system database using their own architecture. They are stored and handled separately from the computer inventory. The Inventory Agent uses this path to locate the MIF files.
MachineISVMIFPath
The path to the directory containing client MIF files. These MIF files add new types of objects (such as new types of hardware) to the client's inventory. The objects are appended to the client architecture as a new group. These objects are included in the client's inventory and can be viewed in the Personal Computer Properties - [computername] window for the client. The Inventory Agent uses this path to locate the MIF files.
LocalWindowsPath
The path to the directory that contains the WIN.INI and SYSTEM.INI files (if found).
SharedWindowsPath
The path to the directory that contains Windows operating system files.
SMSLogPath
The path to the directory that contains the SMS client log files.
SMSDataPath
The path to the directory that contains data files used by the SMS binaries.
SMSInvDataPath
The path to the directory that is used to store inventory data files (Windows NT-based clients only).
SMSTempPath
Reserved.
SMSLocalTempPath
Reserved.
SharedWindowsBinaries
Reserved.
SharedSMSBinaries
Reserved.
ModifyAutoexecBat
Reserved.
LogonRoot
The path on a NetWare server between the volume name and the LOGON.SRV directory (including LOGON.SRV).
LastLogonServerPath
Indicates the relative path (\\servername\sharename) of the SMS logon server that last ran SMS Client Setup.
UniqueIdPath
The path to the unique ID file. This file is used to generate unique IDs.
LastSoftwareScan
The actual date and time that the software inventory was scanned.
LastHardwareScan
The actual date and time that the hardware inventory was scanned.
SoftwareScanInterval
By default, this setting is equivalent to the Software Inventory Frequency setting in the Inventory dialog box of Site Properties. A zero (0) indicates the software is scanned each time the Inventory Agent runs.
HardwareScanInterval
By default, this setting is equivalent to the Hardware Inventory Frequency setting in the Inventory dialog box of Site Properties. A zero (0) indicates the hardware is scanned each time the Inventory Agent runs.
InvAgtFalseLogonCount
The number of times it takes to log on to another site/domain before inventory is taken.
InventoryCollectionPoint (client only)
The path to the directory on the logon server where the Inventory Agent places inventory files.
SlowNetFlag
Determines when a slow network link, such as a RAS link, exists between the SMS logon server and the client. If a slow link is present, the Package Command Manager prompts the user to make selective decisions regarding software installation.
OS
The operating system that the client uses. If SMS Client Setup finds that this key is different from the operating system currently running, it prints a message and exits. The following values are possible:
Number | Meaning |
1 | MS-DOS |
2 | Windows 3.x |
3 | OS/2 |
4 | Windows NT |
5 | Windows 95 |
InventoryConfigurationPath
Path (relative to the LOGON.SRV directory) to the resync files on a Windows NT-based computer.
ConfigurationRequestPath
Path (relative to the LOGON.SRV directory) to the client configuration request files on a Windows NT-based computer.
ISVMIFCollectionPoint
For OS/2 and Macintosh clients, the directory where the Inventory Agent places inventory MIF files. By default, the directory is ISVMIF.BOX.
InvAgtServiceWakeupInterval
Specifies how often the Inventory Agent services for Windows NT and OS/2 wake up and check to see if the inventory frequency interval has elapsed. By default, the InvAgtServiceWakeupInterval value is 24 hours (1440 minutes).
CompanyName
The company name entered when SMS was installed at the local site.
NetworkType
Refers to the type of network software used by the SMS logon server. The following values are possible:
Number | Meaning |
1 | Unknown |
2 | Windows NT |
3 | LAN Manager version 1.x |
4 | LAN Manager version 2.x (includes WFWNET) |
5 | NetWare 2.x |
6 | NetWare 3.x |
7 | NetWare 4.x |
Added by SETLS when domain mapping of clients is enabled.
ValidatingServer
The name of the current SMS logon server.
FileName
The name of the file that contains the domain mappings. By default, this file is named SMSLS.INI.
FileTime
The time stamp of the domain mapping file. This time stamp is used to determine if any domain mapping changes have been made.
SectionMatch
The section in the mapping file that was used to map the client.
KeyMatch
The value of the section in the mapping file that was used to map the client.
Domain
The SMS domain that the client was mapped to as a result of the mapping file.
Specifies the local Package Command Manager configuration. These settings are modified in the Package Command Manager Options dialog box.
SetupPhase
Indicates the present state of SMS (INSTALLED, UPGRADE, VERIFY_FILES, COMPONENT_DEINSTALL, DEINSTALL) on the client. SMS Client Setup writes this entry and checks it the next time it runs. SMSRUN uses this entry to maintain clients.
LanguageCode
Identifies the language version of the SMS client. This entry is written by SMS Client Setup.
NetCardID
The network card ID number as obtained by the Inventory Agent.
MachineName
The network computer name as obtained by the Inventory Agent.
SystemRole
The SMS system role. For example, server.
SystemType
The SMS system type. For example, x86-based personal computer.
LastPCMFileTime
Shows the most recent instruction file date used by Package Command Manager. The Package Command Manager checks this date to see if a new instruction file has arrived.
ShowPCMIntroDialog
Indicates whether the introductory message box should be displayed when Package Command Manager starts.
PollingInterval
A value set by the user to specify the Package Command Manager polling interval. If set, this value overrides the PollingInterval value specified in the [Package Command Manager] section.
UserName
Allows the user to enter a default name to be used by the Package Command Manager installation scripts.
CompanyName
Allows the user to override the default company name through which Package Command Manager installation scripts specify a company name when installing software.
NextAvailableSiteSMSUniqueID
This entry resides on the site server only. It is only written when a site is removed. This entry indicates the next available SMS unique ID that can safely be used. If the site is installed again with the same site code, this number is used as the starting point for all future SMS unique IDs.
Contains settings for remote control options. Some of these settings can be modified in the Help Desk Options dialog box.
Allow Takeover
Allows the computer running the SMS Administrator to take remote control of the client.
Allow Reboot
Allows the computer running the SMS Administrator to remotely restart the client.
Allow File Transfer
Allows file transfer to and from the client.
Allow Chat
Allows the Remote Chat utility to run.
Allow Remote Execute
Allows the computer running the SMS Administrator to remotely run programs on the client.
Visible Signal
Provides a visible signal to the user to indicate that the client is being controlled remotely.
Audible Signal
Provides an audible signal to the user to indicate that the client is being controlled remotely.
Allow Ping Test
Allows the computer running the SMS Administrator to remotely ping the client.
Allow DOS Diagnostics
Allows the computer running the SMS Administrator to remotely run the MS-DOS diagnostics utilities on the client.
Allow Windows Diagnostics
Allows the computer running the SMS Administrator to remotely run the Windows-based diagnostics utilities on the client.
Permission Required
Specifies whether the administrator running the SMS Administrator needs permission to remotely control the client.
Force Name
When set to yes, the computer name used between SMS and the client can be different from the LAN Manager computer name. If Force Name is set to yes, a MachineName entry must also be listed in the [Local] section.
Default Protocol
Default network protocol to be used for remote control. Valid protocols are NetBIOS, IP, and IPX.
LANANUM
Default Lana number to be used for remote control. Only valid for remote control over a NetBIOS protocol.
InstallWin16RCTSR
Indicates whether the remote control TSR (USERTSR / USERIPX) should be installed. Applies only to clients running Windows 3.1 (any network) or Windows for Workgroups (NetWare).
Keeps track of logon attempts to another site or SMS domain. This information is used to determine if and when a computer's inventory should be reported to a new site or domain.
LastLoggedUser
The user name of the last user to log on to the network at the client.
Entry
When a user attempts to log on to a different site or SMS domain, this entry is used to store the last site or SMS domain where the client logged on. When the number of logon attempts reaches the number specified for InvAgtFalseLogonCount (in the [SMS] section), this entry is cleared.
Counter
Keeps track of the number of logon attempts to a different site or SMS domain. When the counter reaches the number specified for InvAgtFalseLogonCount, inventory is taken, and the computer is added to the new site/domain.
InventoryEntity
Specifies whether the Inventory Agent runs as a service or as an executable. Applies only to computers running Windows NT.
This user logon information is used for two purposes:
The following keys are possible:
Current
The name of the user currently logged on at the client.
LastLoggedUser
The name of the previous user that logged on at the client.
Counter
The number of times that the current user has logged on at the client.
The servers available for Macintosh clients.
CurrentLogonServer
The name of the zone and server that processed the current user's logon request.
Servernumber
The name of the zone and server that acts as a collection point for the current client. The number identifies each server entry (for example, Server1, Server2, and so on).