home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / snapdump / snapdump.inf (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1994-02-04  |  17.6 KB  |  161 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introducing SnapDump/2 ΓòÉΓòÉΓòÉ
  3.  
  4.                                  IBM SnapDump/2
  5.  
  6. This tool is an IBM RAS (Reliability, Availability, and Serviceability) tool 
  7. developed by IBM United States Software Services.  You will typically use this 
  8. tool to automatically collect information about your workstation.  Analysis of 
  9. this information will help speed problem determination by your service 
  10. representative. 
  11.  
  12.  
  13. ΓòÉΓòÉΓòÉ 2. Special Notices ΓòÉΓòÉΓòÉ
  14.  
  15. References in this information to IBM products, programs, or services do not 
  16. imply that IBM intends to make these available in all countries in which IBM 
  17. operates.  Any reference to an IBM product, program, or service is not intended 
  18. to state or imply that only IBM's product, program, or service may be used. 
  19. Any functionally equivalent product, program, or service that does not infringe 
  20. any of IBM's intellectual property rights or other legally protectible rights 
  21. may be used instead of the IBM product, program, or service.  Evaluation and 
  22. verification of operation in conjunction with other products, programs, or 
  23. services, except those expressly designated by IBM, are the user's 
  24. responsibility. 
  25.  
  26. IBM may have patents or pending patent applications covering subject matter in 
  27. this information.  The furnishing of this information does not give you any 
  28. license to these patents.  You can send license inquiries, in writing, to the 
  29. IBM Director of Commercial Relations, IBM Corporation, Purchase, NY 10577. 
  30.  
  31. The following terms, denoted by an asterisk (*) in this information, are 
  32. trademarks of the IBM Corporation in the United States and/or other countries: 
  33.  
  34.  FASTService
  35.  First Failure Support Technology/2
  36.  FFST/2
  37.  IBM
  38.  Operating System/2
  39.  OS/2
  40.  Personal System/2
  41.  Presentation Manager
  42.  PS/2
  43.  SAA
  44.  SnapDump/2
  45.  Systems Application Architecture.
  46.  
  47. The following paragraph does not apply to the United Kingdom or any country 
  48. where such provisions are inconsistent with local law. 
  49.  
  50. INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS INFORMATION "AS IS" 
  51. WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT 
  52. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A 
  53. PARTICULAR PURPOSE. 
  54.  
  55. Some states do not allow disclaimer of express or implied warranties in certain 
  56. transactions; therefore, this statement may not apply to you. 
  57.  
  58. This information could include technical inaccuracies or typographical errors. 
  59. Changes are periodically made to the information herein; these changes will be 
  60. incorporated in new editions of the information.  IBM may make improvements 
  61. and/or changes in the product(s) and/or the program(s) described in this 
  62. information at any time. 
  63.  
  64. It is possible that this information may contain reference to, or information 
  65. about, IBM products (machines and programs), programming, or services that are 
  66. not announced in your country.  Such references or information must not be 
  67. construed to mean that IBM intends to announce such IBM products, programming, 
  68. or services in your country. 
  69.  
  70. Requests for copies of this information and for technical information about IBM 
  71. products should be made to your IBM Authorized Dealer or your IBM Marketing 
  72. Representative. 
  73.  
  74. (C) Copyright International Business Machines Corporation 1991.  All rights 
  75. reserved. 
  76.  
  77. Note to US Government Users :  Documentation and programs related to restricted 
  78. rights.  Use, duplication or disclosure is subject to restrictions set forth in 
  79. GSA ADP Schedule Contract with IBM Corp . 
  80.  
  81.  
  82. ΓòÉΓòÉΓòÉ 3. Command Syntax ΓòÉΓòÉΓòÉ
  83.  
  84. The syntax of the SnapDump/2 interface is: 
  85.  
  86.                 SNAPDUMP [input_command_file] [output_dump_file]
  87.  
  88. where: 
  89.  
  90.  o input_command_file is the optional name of an input command file that will 
  91.    be read to determine what data should be collected. 
  92.  
  93.  o output_dump_file is the optional name of the output dump file. 
  94.  
  95.  
  96. ΓòÉΓòÉΓòÉ 3.1. Input command file format ΓòÉΓòÉΓòÉ
  97.  
  98. The actions of SnapDump/2 are governed by a command file. Here is a sample 
  99. command file: 
  100.  
  101. f/config.sys
  102. f/syslevel.*
  103. f/startup.cmd
  104. f/*.ini
  105. f/log0001.dat
  106. f/os2mlog.dat
  107. f/acs.pro
  108. f/*.hst
  109. f/*.log
  110. m/\SHAREMEM\ACS\RAS_SEG
  111. f/NET.ERR
  112. p/NET STATISTICS REQUESTER
  113. p/NET STATISTICS SERVER
  114. p/NET STATUS
  115. p/NET ERROR
  116. p/NET TIME
  117. p/NET VIEW
  118. p/NET WHO
  119. p/pstat.exe
  120. p/dir c:\
  121. p/dir c:\os2\system
  122.  
  123. where -- 
  124.  
  125.  o A 'p' in column 1 indicates that the named program is to be executed and any 
  126.    output to the standard output handle (1) and standard error handle (2) are 
  127.    to be captured. Any programs (including .CMD files) that can be run from the 
  128.    OS/2 command prompt and that write to standard output and/or standard error 
  129.    may be specified.  The output of programs that use other techniques of 
  130.    writing to the screen, such as Presentation Manager "Win" calls or "VIO" 
  131.    calls, cannot be captured. 
  132.  
  133.  o A 'f' in column 1 indicates that a files are to be captured. Standard 
  134.    wildcards may be specified, but be aware that the SnapDump may become too 
  135.    large if too broad a file specification is given. 
  136.  
  137.  o A 'm' in column 1 indicates that a named shared memory "file" 
  138.    ("\SHAREMEM\...") is to be captured.  Wildcards are not allowed. Certain 
  139.    named shared memory segments are protected and cannot be dumped. The names 
  140.    of the named shared memory files in your system may be obtained by issuing 
  141.    the command "PSTAT /M" at the OS/2 command prompt. 
  142.  
  143.  o Any other byte in column one causes the line to be treated as a comment. 
  144.  
  145.  
  146. ΓòÉΓòÉΓòÉ 4. Output dump file ΓòÉΓòÉΓòÉ
  147.  
  148. At the completion of a SnapDump, the file name of the SnapDump will be 
  149. displayed. 
  150.  
  151. SnapDumps should be directed to a drive with enough free disk space. The drive 
  152. may be a network drive, a local fixed disk drive, a floppy drive, or a virtual 
  153. disk drive. 
  154.  
  155.  
  156. ΓòÉΓòÉΓòÉ 5. Formatting the SnapDump ΓòÉΓòÉΓòÉ
  157.  
  158. The SnapDump Dump Formatter, SNAPDF.EXE , is used to view the SnapDump. This 
  159. formatter is a Presentation Manager application that allows you to display, 
  160. print, and save to a file selected portions of the SnapDump. You may also enter 
  161. the name of the dump file on the command line, i.e. SNAPDF XXX.DMP.