SMS: Using Dosetup to Create Registry Entries for PGC

 Last reviewed: March 26, 1997
Article ID: Q152861

The information in this article applies to:

  • Microsoft Systems Management Server versions 1.1 and 1.2

SUMMARY

If distributing a Shared Application without a package definition file (PDF), the administrator will need to specify the Registry Entry name and a Configuration Command Line, in order for SMS to correctly configure the application and record that in its registry. Use the "Dosetup.exe" executable file to complete this task.

MORE INFORMATION

DOSETUP.EXE can be used to run a user-specified setup program under Program Group Control (PGC). This program would normally be specified as the 'ConfigurationScript' entry within the [Program Item Properties i] section of a PDF file. The command-line syntax is: 

   DOSETUP <RegName> <CommandLine>
where RegName has the same value as the 'RegistryName' entry in the same section of the PDF, and CommandLine is any valid command line.

For example, the following command will run the setup program for the Microsoft Access 2.0 Service Pack: 

   DOSETUP acs2pak setup.exe
This program does not handle all of the complexities of making an arbitrary shared application fully SMS-compliant. It merely provides a mechanism for running a setup program and for setting certain SMS registry status flags required by PGC.

DOSETUP runs the specified command line and manages the status entry under the program item's registry key 

   (HKEY_CLASSES_ROOT\SMS\APPLICATIONS\<regName>\Configuration\Status)
The status entry must be set to UNFINISHED, FAIL or SUCCESS.

DOSETUP operates like SMSSETUP in most respects; it displays the SMS blue setup screen, reports errors, and does postprocessing following any system restart. The postprocessing sets an application's status flag to SUCCESS. DOSETUP initially sets an application's status to FAIL, in case anything goes wrong during its processing. To handle a possible system restart by an installation program, DOSETUP sets the status to UNFINISHED immediately before running the user's command line. When the installation program terminates, or when PGC Start reruns DOSETUP following a system restart, the status is reset to SUCCESS. There is currently no mechanism for an installation program to pass an error message to DOSETUP.

DOSETUP will be installed into the MSTEST directory on the logon server so that it will be available to users from any PDF.

Additional query words: prodsms 1.10 1.20
Keywords : kbnetwork smspgc kbnetwork
Version : 1.10 1.20
Platform : WINDOWS

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: March 26, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.