[SetupVariation Setup]

For the setup variations specified in the SetupVariation entry in the [Package Definition] key, the PDF must have a key that defines each variation. For SMS, the setup variations specify the package commands that will be defined for the package’s Workstations property.

CommandName (required)

The name used for this package command. When the PDF is imported into SMS, this string is used as the Command Name for this package command. This text must be localized.

Example:

CommandName = Automated Minimum Installation
 

CommandLine (required)

The command line used for this package command. When the PDF is imported into SMS, this string is used as the Command Line for this package command.

Example:

CommandLine = setup.exe
 

UserInputRequired (required)

The value for this entry specifies whether this package command requires interaction with the user to complete the command. You can specify TRUE or FALSE.

Example:

UserInputRequired = FALSE
 

SynchronousSystemExitRequired (required)

On Windows clients, by default, once SMS starts executing a job, it intervenes if it receives a request to exit the Windows environment. SMS does this by returning zero if it receives a WM_QUERY_END_SESSION. SMS then presents a dialog box asking the user to confirm when it is okay to restart the computer. For programs simply attempting to restart the system, this does not cause a problem. However, it does cause a problem for jobs attempting to run MS-DOS programs using ExitWindowsExec. Setting SynchronousSystemExitRequired to TRUE disables the default SMS behavior so that the job can run an MS-DOS program.

On MS-DOS clients, setting SynchronousSystemExitRequired to TRUE indicates to SMS that the job will cause the client to restart. This tells SMS to use overlay mode when executing the job, freeing up the memory used by SMS so it can be made available to the program being executed. By default, SMS executes programs synchronously and remains in memory when a job command line is executed.

Note that setting this value to TRUE is not necessary just to exit the environment at the end of the package setup program.

The possible values are TRUE and FALSE, and the default is FALSE.

Example:

SynchronousSystemExitRequired = FALSE
 

SupportedPlatforms (required)

The value for this entry specifies the operating systems where the package can be installed and run. Each operating system name must be separated by a comma and a space.

Example:

SupportedPlatforms = Windows, Windows NT (Alpha), Macintosh

Note that a version number is no longer needed and should not be used with Windows and Windows NT. Old PDFs that specified Windows 3.1 or Windows NT 3.1 will still work with SMS, but PDFs that specify any other versions of these platforms will not work. Particular versions of an operating system can still be uniquely targeted for package installation by using the SMS database query feature.