KnowledgeBase Archive

An Archive of Early Microsoft KnowledgeBase Articles

View on GitHub

Q123499: PCMDUMP and Package Command Manager Instruction Files

Article: Q123499
Product(s): Microsoft Systems Management Server
Version(s): winnt:1.0,1.1
Operating System(s): 
Keyword(s): kbtool kbAudit kbPCM smshowto smsaudit smspcm
Last Modified: 31-JUL-2001

-------------------------------------------------------------------------------
The information in this article applies to:

- Microsoft Systems Management Server versions 1.0, 1.1 
-------------------------------------------------------------------------------

SUMMARY
=======

This article describes how to use the PCMDMP utility, explains the output
generated, and shows how to interpret the information within the Systems
Management Server system.

MORE INFORMATION
================

When the client's Package Command Manager (PCM) polls a logon server during its
designated interval, it will look in the \\<logon
server>\SMS_SHR\PCMINS.BOX directory for a file name that has the same SMS ID
as itself. When the file is located, PCM will then parse this file and determine
what actions need to be taken, if any.

PCMDUMP displays binary PCM instruction files in text format for review. These
files reside in the \SMS\LOGON.SRV\PCMINS.BOX directories, named with the unique
SMS ID of the destination system, appended with a .INS extension.

Some package installation problems can be resolved by examining the contents of
the clients PCM instruction file. The instruction file can contain multiple
records, one for each package to install. Below is a description of the record
structure:

SiteID:             Three character SMS site code.
RequestID:          A unique package distribution ID.
PackageID:          Identifies actual package to distribute.
JobID:              ID of job used to distribute this package.
Install Flag:       0-1   Install regardless of network speed.
                   2     Do not install over a slow network link.
Install By Date:    Package will become mandatory after this date and time.
Install By Full:    0   Optional Install.
                   1   Mandatory Install.
Display Date:       Make available for installation after this date.
Display Full:       Display this package in PCM.
Expiration Date:    Package expires after this date.
Expiration Full:    0   Never expires.
                   1   Expires after expiration date.
User Input Flags:   0   Doesn't require user input.
                   1   Require user input.
Operating System:   Bit mask of which operating system to install on.
                   Supported operating systems and bit masks:
                      WIN16         0x00000001
                      WIN32_X86     0x00000002
                      WIN32_MIPS    0x00000004
                      WIN32_ALPHA   0x00000008
                      DOS5          0x00000010
                      DOS6          0x00000020
                      MACINTOSH     0x00000040
Disk Usage:         Not used.
Run Command:        Command line to be run.
WCL Name:           Descriptive text, displayed in PCM under Command Name.
Server(s):          The full universal naming convention (UNC) path to
                   available package directories, and server types. Server
                   types:
                      UNKNOWN    1
                      WINNT3     2
                      LANMAN1    3
                      LANMAN2    4
                      NETWARE2   5
                      NETWARE3   6
                      NETWARE4   7
Package Name:       Name of package.
Comments:           Text comments that are included with the package.
Domain Name:        Not used.
Reserved:           Internal information used by SMS.

Below is an example of PCMDUMP output. Note that there are two extra items at the
top of the PCMDUMP output that are not part of the normal record structure. The
first item, reported only once, is the filename that PCMDUMP is parsing. The
second item, repeated for every record, is the version of the record. "Beta 455"
translates to "version 6" which is the correct version for SMS 1.0.

  D:\SMS\LOGON.SRV\PCMINS.BOX>PCMDUMP MDM00005.INS

  PCM Instruction File Dump Utility v1.0
  Copyright 1993, 1994 Microsoft Corporation

  File Name       : mdm00005.ins
  PCM Version     : Beta 455
  SiteID          : BPC
  RequestID       : BPC001M
  PackageID       : BPC0000A
  JobID           : BPC000AA
  Install Flag    : 0
  Install By Date : 00/00/00 00:00:00
  Install By Full : 0
  Display Date    : 09/21/94 17:56:00
  Display Full    : 1
  Expiration Date : 03/07/95 17:56:00
  Expiration Full : 1
  User Input Flags: 0
  Operating System: 15
  Disk Usage      :
  Run Command     : acmewkst.exe smsproxy\complete.stf /I:C
  WCL Name        : Complete
  Server(s)       : \\CNS-SMS\SMS_PKGD\BPC0000A\ Type: 2
                    Zone: \\CNS-SMS\SMS_PKGD\BPC0000A\ 
                  : \\CNSAPPS1\SMS_PKGD\BPC0000A\ Type: 2
  Package Name    : Microsoft Office Professional 4
  Comments        : Microsoft Office Professional 4.3
  Domain Name     :
  Reserved        : 00 E6 F8 77 60 82 F9 77 FF FF FF FF 94 FF 03 00 FE 5F
                    40 00 00 00 05 00 08 00 00 00 0F 00 00 00
  PCM Version     : Beta 455
  SiteID          : BPC
  RequestID       : GBL00B9
  PackageID       : GBL00015
  JobID           : GBL0015B
  Install Flag    : 0
  Install By Date : 00/00/00 00:00:00
  Install By Full : 0
  Display Date    : 09/24/94 07:00:00
  Display Full    : 1
  Expiration Date : 11/31/94 07:00:00
  Expiration Full : 1
  User Input Flags: 0
  Operating System: 51
  Disk Usage      :
  Run Command     : audit.bat
  WCL Name        : Find Microsoft Software
  Server(s)       : \\CNS-SMS\SMS_PKGD\GBL00015\ Type: 2
                    Zone: \\CNS-SMS\SMS_PKGD\GBL00015\ 
                  : \\CNSAPPS1\SMS_PKGD\GBL00015\ Type: 2
  Package Name    : MS Software Audit (16 Packages)
  Comments        : This package will search your hard disk drives looking
                    for Microsoft software. It will report only which
                    Microsoft programs you have installed on this
                    computer. This will be used to offer you software
                    upgrades as they become available.
  Domain Name     :
  Reserved        : 00 E6 F8 77 60 82 F9 77 FF FF FF FF 94 FF 03 00 FE 5F
                    40 00 00 00 05 00 08 00 00 00 0F 00 00 00
  PCM Version     : Beta 455
  SiteID          : BPC
  RequestID       : BPC003F
  PackageID       : BPC00010
  JobID           : BPC00112
  Install Flag    : 0
  Install By Date : 00/00/00 00:00:00
  Install By Full : 0
  Display Date    : 09/25/94 13:14:00
  Display Full    : 1
  Expiration Date : 03/11/95 13:14:00
  Expiration Full : 1
  User Input Flags: 1
  Operating System: 64
  Disk Usage      :
  Run Command     : "Flight Simulator Program"
  WCL Name        : Install Flight Simulator on your system
  Server(s)       : \\CNS-SMS\SMS_PKGD\BPC00010\ Type: 2
                    Zone: \\CNS-SMS\SMS_PKGD\BPC00010\ 
                  : \\CNSAPPS1\SMS_PKGD\BPC00010\ Type: 2
  Package Name    : MS Flight Simulator
  Comments        : This is for Macintosh Only
  Domain Name     :
  Reserved        : 00 E6 F8 77 60 82 F9 77 FF FF FF FF 94 FF 03 00 FE 5F
                    40 00 00 00 05 00 08 00 00 00 0F 00 00 00
  PCM Version     : Beta 455
  SiteID          : BPC
  RequestID       : BPC005Q
  PackageID       : BPC00012
  JobID           : BPC001F9
  Install Flag    : 0
  Install By Date : 11/01/94 23:59:00
  Install By Full : 1
  Display Date    : 09/27/94 18:37:00
  Display Full    : 1
  Expiration Date : 03/13/95 18:37:00
  Expiration Full : 1
  User Input Flags: 0
  Operating System: 1
  Disk Usage      :
  Run Command     : patch.exe
  WCL Name        : Patch of NW Redirector
  Server(s)       : \\CNS-SMS\SMS_PKGD\BPC00012\ Type: 2
                    Zone: \\CNS-SMS\SMS_PKGD\BPC00012\ 
                  : \\CNSAPPS1\SMS_PKGD\BPC00012\ Type: 2
  Package Name    : WFW VREDIR.386 Patch
  Comments        : Patch Utility for new WFW Redirector
  Domain Name     :
  Reserved        : 00 E6 F8 77 60 82 F9 77 FF FF FF FF 94 FF 03 00 FE 5F
                    40 00 00 00 05 00 08 00 00 00 0F 00 00 00

Additional query words: sms prodsms

======================================================================
Keywords          : kbtool kbAudit kbPCM smshowto smsaudit smspcm 
Technology        : kbSMSSearch kbSMS100 kbSMS110
Version           : winnt:1.0,1.1

=============================================================================

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.

Copyright Microsoft Corporation 1986-2002.