Reserved OSC Variables

• Table 24.3 lists the reserved OSC variables and a description of what each one does. Some variables can be useful for you to use within your own custom screens and answer files. Some of the values do not have defined defaults. Some are only generated when the variable was not previously set and is required for the installation process to continue. In these cases, the RIS server generates the variables prior to starting the installation (they are only available in the Install.osc screen and in the answer file).

  Table 24.3 Reserved OSC Variables

  Variable	Description
  Language	The only OSC variable that can be set prior to the user successfully logging on. This variable controls which folders are used to obtain Client Installation Wizard screens, to generate the list of available operating system images, and when performing any ENUM actions. The default value of this variable matches the default language of the server. For more information about language support, see "Multilanguage RIS Servers" later in this chapter.
  SubError	The server sets this variable internally for any errors it encounters. This can be added to an error screen to help administrators diagnose internal server failures.
  MachineOU	Indicates to the server where the new computer account is to be generated. If this variable is not set prior to installation, the setting specified in the properties of the RIS server is used.
  MachineName	Indicates to the server the name of the new computer. If this variable is not set prior to installation, a name is generated based on the computer naming policy specified in the properties of the RIS server. By default, this variable is used to set the ComputerName value in the answer file.
  ServerName	Set to the name of the server to which the Client Installation Wizard is connected. By default, this variable is used to set the OriSrc value in the answer file.
  ServerDomain	Set to the domain name of the server to which the Client Installation Wizard is connected.
  BootFile	Set when a tool is about to be opened.
  NetBiosName	The generated NetBIOS name of the new computer.
  Siffile	The path of the answer file (.sif) for the operating system image that the user selects, in the form of X:\RemoteInstall\Setup\English\Images\Win2000.pro\i386 \Templates\Ristndrd.sif
  Options	This variable is filled with the results of an ENUM action performed by the RIS server. It contains OSCML and is typically placed between a <SELECT> tag and a </SELECT> tag. (See Tools.osc for an example.)
  CheckDomain	Used internally. Set to 1 or 0 to indicate verification that the user domain has been processed.
  MachineDomain	The domain that the new computer attempts to join during setup. By default this variable is used to set the JoinDomain value in the answer file.
  SysPrepPath	Used for RIPrep images to indicate the path to the image source files. Example: Setup\English\Images\Win2000.prep\i386
  InstallPath	The TFTP relative path to the installation image. Example: Setup\English\Images\win2000.pro. By default, this value is used to set the OriSrc, SetupSourceDevice, LaunchFile, and InstallFilesPath values in the answer file.
  SysPrepDrivers	The path used to find Plug and Play drivers, determined by the RIS server as the best fit for a RIPrep image. If the RIS server cannot make a determination, it is set to blank.
  MAC	Sent by the Client Installation Wizard to indicate the media access control (MAC) address of the client. This is sent right after the user logs on and before the next screen is viewed.
  GUID	Sent by the Client Installation Wizard to indicate the GUID address of the client. This is sent right after the user logs on and before the next screen is viewed.
  MachineType	Sent by the Client Installation Wizard to indicate the type of hardware on which OSChooser is running. This is sent right after the user logs on and before the next screen is viewed. By default, this variable is used to set the OriSrc, LaunchFile, and InstallFilesPath values in the answer file.
  UserName, Password, UserDomain	The values entered by the user in Login.osc. These values are used by the RIS server when performing functions specific to the logged-on user, such as determining Group Policy settings and available operating system images. Password is not available to OSC or SIF files.
  UserFullName	Name generated by the BINL service that is the user's first name followed by the user's last name. By default, this variable is used to set the FullName value in the answer file.
  UserFirstName	The first name of the user who has entered their credentials.
  UserLastName	The last name of the user who has entered their credentials.
  TimeZone	Set by the server to the server's time zone setting. By default, this variable is used to set the Timezone value in the answer file.
  OrgName	Defaults to the organization name set on the RIS server. By default, this variable is used to set the OrgName value in the answer file.

© 1985-2000 Microsoft Corporation. All rights reserved.