DOCUMENT:Q123499 31-JUL-2001 [sms] TITLE :PCMDUMP and Package Command Manager Instruction Files PRODUCT :Microsoft Systems Management Server PROD/VER:winnt:1.0,1.1 OPER/SYS: KEYWORDS:kbtool kbAudit kbPCM smshowto smsaudit smspcm ====================================================================== ------------------------------------------------------------------------------- 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 \\\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 2001.