home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Professional
/
OS2PRO194.ISO
/
os2
/
sysutils
/
snapdump
/
snapdump.inf
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1994-02-04
|
18KB
|
161 lines
ΓòÉΓòÉΓòÉ 1. Introducing SnapDump/2 ΓòÉΓòÉΓòÉ
IBM SnapDump/2
This tool is an IBM RAS (Reliability, Availability, and Serviceability) tool
developed by IBM United States Software Services. You will typically use this
tool to automatically collect information about your workstation. Analysis of
this information will help speed problem determination by your service
representative.
ΓòÉΓòÉΓòÉ 2. Special Notices ΓòÉΓòÉΓòÉ
References in this information to IBM products, programs, or services do not
imply that IBM intends to make these available in all countries in which IBM
operates. Any reference to an IBM product, program, or service is not intended
to state or imply that only IBM's product, program, or service may be used.
Any functionally equivalent product, program, or service that does not infringe
any of IBM's intellectual property rights or other legally protectible rights
may be used instead of the IBM product, program, or service. Evaluation and
verification of operation in conjunction with other products, programs, or
services, except those expressly designated by IBM, are the user's
responsibility.
IBM may have patents or pending patent applications covering subject matter in
this information. The furnishing of this information does not give you any
license to these patents. You can send license inquiries, in writing, to the
IBM Director of Commercial Relations, IBM Corporation, Purchase, NY 10577.
The following terms, denoted by an asterisk (*) in this information, are
trademarks of the IBM Corporation in the United States and/or other countries:
FASTService
First Failure Support Technology/2
FFST/2
IBM
Operating System/2
OS/2
Personal System/2
Presentation Manager
PS/2
SAA
SnapDump/2
Systems Application Architecture.
The following paragraph does not apply to the United Kingdom or any country
where such provisions are inconsistent with local law.
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS INFORMATION "AS IS"
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or implied warranties in certain
transactions; therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors.
Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the information. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
information at any time.
It is possible that this information may contain reference to, or information
about, IBM products (machines and programs), programming, or services that are
not announced in your country. Such references or information must not be
construed to mean that IBM intends to announce such IBM products, programming,
or services in your country.
Requests for copies of this information and for technical information about IBM
products should be made to your IBM Authorized Dealer or your IBM Marketing
Representative.
(C) Copyright International Business Machines Corporation 1991. All rights
reserved.
Note to US Government Users : Documentation and programs related to restricted
rights. Use, duplication or disclosure is subject to restrictions set forth in
GSA ADP Schedule Contract with IBM Corp .
ΓòÉΓòÉΓòÉ 3. Command Syntax ΓòÉΓòÉΓòÉ
The syntax of the SnapDump/2 interface is:
SNAPDUMP [input_command_file] [output_dump_file]
where:
o input_command_file is the optional name of an input command file that will
be read to determine what data should be collected.
o output_dump_file is the optional name of the output dump file.
ΓòÉΓòÉΓòÉ 3.1. Input command file format ΓòÉΓòÉΓòÉ
The actions of SnapDump/2 are governed by a command file. Here is a sample
command file:
f/config.sys
f/syslevel.*
f/startup.cmd
f/*.ini
f/log0001.dat
f/os2mlog.dat
f/acs.pro
f/*.hst
f/*.log
m/\SHAREMEM\ACS\RAS_SEG
f/NET.ERR
p/NET STATISTICS REQUESTER
p/NET STATISTICS SERVER
p/NET STATUS
p/NET ERROR
p/NET TIME
p/NET VIEW
p/NET WHO
p/pstat.exe
p/dir c:\
p/dir c:\os2\system
where --
o A 'p' in column 1 indicates that the named program is to be executed and any
output to the standard output handle (1) and standard error handle (2) are
to be captured. Any programs (including .CMD files) that can be run from the
OS/2 command prompt and that write to standard output and/or standard error
may be specified. The output of programs that use other techniques of
writing to the screen, such as Presentation Manager "Win" calls or "VIO"
calls, cannot be captured.
o A 'f' in column 1 indicates that a files are to be captured. Standard
wildcards may be specified, but be aware that the SnapDump may become too
large if too broad a file specification is given.
o A 'm' in column 1 indicates that a named shared memory "file"
("\SHAREMEM\...") is to be captured. Wildcards are not allowed. Certain
named shared memory segments are protected and cannot be dumped. The names
of the named shared memory files in your system may be obtained by issuing
the command "PSTAT /M" at the OS/2 command prompt.
o Any other byte in column one causes the line to be treated as a comment.
ΓòÉΓòÉΓòÉ 4. Output dump file ΓòÉΓòÉΓòÉ
At the completion of a SnapDump, the file name of the SnapDump will be
displayed.
SnapDumps should be directed to a drive with enough free disk space. The drive
may be a network drive, a local fixed disk drive, a floppy drive, or a virtual
disk drive.
ΓòÉΓòÉΓòÉ 5. Formatting the SnapDump ΓòÉΓòÉΓòÉ
The SnapDump Dump Formatter, SNAPDF.EXE , is used to view the SnapDump. This
formatter is a Presentation Manager application that allows you to display,
print, and save to a file selected portions of the SnapDump. You may also enter
the name of the dump file on the command line, i.e. SNAPDF XXX.DMP.