Procedure for Creating the Sample PDF

This section explains how to create the PDF shown in the previous section. This PDF creates a package and two programs for the NT Event to SNMP Trap Configuration Modification Tool. To ensure that the processing of this sample PDF completes correctly, do not type anything into the file that is not included in the instructions, except blank lines.

Procedure Bullet  To create the [PDF] section

  1. In any text editor, open a new file.
  2. Type [PDF] as the only entry on the first line of the file.
  3. On the second line of the file, type VERSION=2.0 to create the required single entry for this section. Do not type anything else on this line.

Procedure Bullet  To create the [Package Definition] section

  1. Open the PDF that you created in the last procedure, if it is not already open.
  2. Below the [PDF] section, type [Package Definition] to create the [Package Definition] section. Do not type anything else on this line. You can insert additional blank lines for readability, as you see in the example; they do not affect the processing.
  3. Type LANGUAGE=English as the entire content of the next line. This key is used when versions of a package exist in different languages, and it allows you to differentiate between definitions for the same package in multiple languages.
  4. Type VERSION=2.0 as the next line. The version you enter should be the version of the program you are installing, not the version of the PDF. This entry is optional but gives you information that can be used to identify the package if a PDF exists for a different version.
  5. Type PUBLISHER=Microsoft in the next line. PUBLISHER is a required key.
  6. Type NAME=NT Event to SNMP Trap Configuration Modification Tool as the next line. This entry identifies this PDF when you import it using the Distribute Software Wizard or the Create Package from Definition Wizard. NAME is a required key.
  7. Type PROGRAMS=alpha, x86 as the next line. PROGRAMS specifies processor families that can use this package definition.

Procedure Bullet  To create the [ALPHA] section

  1. Open the PDF you created in the previous procedure, if it is not already open.
  2. Create a new section by typing [ALPHA]. You can add blank lines for readability wherever they are appropriate; they do not affect the processing.
  3. Type SUPPORTEDCLIENTS=Win NT(alpha) as the next line. SUPPORTEDCLIENTS specifies the computing platforms that can use this package definition.
  4. Type ADMINRIGHTSREQUIRED=True as the next line. ADMINRIGHTSREQUIRED specifies whether a user needs administrative rights to use the package. If the program requires administrative rights, and you do not specify this key, the program might fail if it is run by a user who has no administrative rights. If the program must access any resource on a computer other than the client or the distribution point, you must use a Windows NT Client Software Installation account. These programs cannot run on any computer other than a Windows NT client.
  5. Type USERINPUTREQUIRED=False as the next line. USERINPUTREQUIRED specifies whether input is required from the user for the program to complete its processing. This is not a required key, but you must specify it as True if you want to require user input.
  6. Type ESTIMATEDRUNTIME=2 as the next line. ESTIMATEDRUNTIME specifies the time in minutes that will be required for the program to complete its processing. This key is used by software distribution to determine whether the program is within a normal time frame or has failed to complete because of an error. For monitoring to take place, you must specify ESTIMATEDRUNTIMEMONITORING = True; otherwise, the estimated run time is for display purposes only.
  7. Type ESTIMATEDDISKSPACE=1MB as the next line. ESTIMATEDDISKSPACE specifies the estimated disk space required for the program to complete its processing. This key is displayed to the user when the program is advertised.
  8. Type COMMANDLINE=eventcmt.exe ..\\events.cnf /nolog /setcustom as the next line. COMMANDLINE specifies the command-line text necessary to run the program on the destination computer, so type this line exactly as you would type it on the destination computer. Include only flags and specifiers as you would to run the program normally.
  9. Type STARTIN=alpha as the next line. STARTIN indicates the directory where you want the program to run by specifying a relative path to the package folder on the distribution point. This example causes the program’s command line to run in the alpha directory. The specified directory must exist, or the program might fail.
  10. Type NAME=Alpha systems as the next line.
  11. Type CANRUNWHEN=AnyUserStatus as the next line. CANRUNWHEN specifies whether the program requires a user to be logged on, logged off, or that there is no requirement. AnyUserStatus indicates that the program runs regardless of whether a user is logged on.

Procedure Bullet  To create the [X86] section

  1. Open the PDF that you created in the last procedure.
  2. Create a new section for the x86 program by typing this line: [X86].
  3. Refer to the steps in the previous procedure to complete the following fields:
    4. SUPPORTEDCLIENTS=Win NT (i386)ADMINRIGHTSREQUIRED=TrueUSERINPUTREQUIRED=FalseESTIMATEDRUNTIME=2ESTIMATEDDISKSPACE=1MBCOMMANDLINE=eventcmt.exe ..\\events.cnf /nolog /setcustomSTARTIN=i386NAME=x86 systemsCANRUNWHEN=AnyUserStatus

When you finish creating your PDF, save it with an .sms extension. Then, in the SMS Administrator console, start the Distribute Software Wizard or the Create Package from Definition Wizard. Select Create a new package from a definition, and then click Browse to specify the location of the new .sms file. After the file is imported, it appears in the list of PDFs for the site.