home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / snapdump / snapdump.doc < prev    next >
Encoding:
Text File  |  1994-02-04  |  37.0 KB  |  1,180 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                    IBM SNAPDUMP/2
  8.                    Data Collector and
  9.                    Formatter
  10.  
  11.  
  12.                    C. W. (Bill) Rogers
  13.                    Austin, Texas
  14.  
  15.                    February 06, 1991
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71. ττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ
  72. Introduction
  73.  
  74.     SnapDump is a set of tools which assists with problem determination
  75.     in the OS/2 environment.  SnapDump provides the ability to capture
  76.     a wide variety of system data into a single, easily transportable file.
  77.     The collection of data is controlled by the contents of a tailorable
  78.     flat ASCII file.  Although a sample version of this file is shipped
  79.     with SnapDump (SNAPDUMP.DAT), this ASCII file can be easily modified
  80.     by support personnel to customize the collection of data.
  81.  
  82.     In addition, SnapDump provides an easy-to-use menu interface for
  83.     displaying the contents of the output file that contains the
  84.     system data collected by SnapDump.
  85.  
  86. Data Collection
  87.     SnapDump includes a program (SNAPDUMP.EXE) that provides the ability
  88.     to collect many types of data.  The data collected falls into four
  89.     categories:
  90.  
  91.     * Files (binary and ASCII)
  92.  
  93.     * Data areas contained in named shared segments
  94.  
  95.     * Standard output and standard error from programs invoked by SnapDump
  96.  
  97.     * Environmental information automatically collected by the
  98.       SnapDump data collection program.
  99.  
  100.     * The system trace buffer (if the system trace is active)
  101.  
  102. Formatting the Data
  103.     SnapDump includes a program (SNAPDF.EXE) which provides a PM interface
  104.     useful for viewing and formatting the contents of a file that contains
  105.     the data collected by SnapDump.
  106.  
  107.     The formatting program provides three views of the data:
  108.        * Hexadecimal plus ASCII
  109.        * Hexadecimal plus EBCDIC
  110.        * ASCII only
  111.     The view of the data is toggled with the PF12 key.
  112.  
  113.     The SnapDump formatter can also be used to extract data from the
  114.     SnapDump output file, returning it to its original binary format.
  115.     This is particularly useful for binary files that require specialized
  116.     tools or programs to view them in a meaningful way (for example, the
  117.     Communications Manager configuration file).
  118.  
  119.  Utilities
  120.     A set of utility programs are provided with SnapDump, to assist in
  121.     the collection of data helpful when performing problem determination.
  122.  
  123.          QMC.EXE      Provides hardware specific information
  124.          FINDSEG.EXE  Displays segment information
  125.          NETSESS2.EXE Local LAN session information
  126.          DIRSTAT.EXE  Exhibits adapter information
  127.          NCBSTAT.EXE  Displays Netbios information
  128.  
  129.    Page 1
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.     See SnapDump Utility Prgrams on page 12 for more information on
  140.     the utilities.
  141.  
  142. τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ
  143. Operating Environment
  144.  
  145.     There are no special requirements, other than OS/2.  SnapDump will
  146.     operate in the following environments:
  147.        * SE 1.2 through SE 2.0
  148.        * EE 1.2 through EE 1.30.2
  149.        * SE 1.30.1 (including Extended Services)
  150.        * SE 1.30.2 (including Extended Services and LAN Server 2.0)
  151.  
  152. τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ
  153. The SnapDump Package
  154.     SnapDump consists of the following files:
  155.  
  156.       SNAPDUMP.EXE   The data collection program
  157.       SNAPDF.EXE     The data formatter program
  158.       SNAPDUMP.DAT   Sample ASCII input file for the collection program
  159.       SNAPDUMP.INF   On-line documentation for SnapDump
  160.       SNPNL001.HLP   Help file for SnapDump
  161.       QMC.EXE        Qsystem program to display hardware information
  162.       FINDSEG.EXE    Program to display segment information
  163.       NETSESS2.EXE   Local LAN session statistical and status
  164.       DIRSTAT.EXE    802.2 adapter level information
  165.       NCBSTAT.EXE    Netbios status information
  166.  
  167. τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ
  168. Installing SnapDump
  169.     These installation instructions assume that you are familiar with using
  170.     the OS/2 full screen session command line and that you wish to create a
  171.     separate directory on the C drive for SnapDump. You may substitute a
  172.     different drive letter and directory name and/or omit steps where
  173.     appropriate.
  174.  
  175.       1 Download the SNAPDRIV EXEBIN file.
  176.       2 Create a directory for SNAPDUMP (e.g. 'mkdir SNAPDUMP).
  177.       3 Execute the following: 'SNAPDRIV -d -o c:\XXXXXXXX',
  178.         this will place executable into directory 'XXXXXXXX'.
  179.  
  180. τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ
  181. Collecting Data with SnapDump
  182.     The SnapDump data collection program (:hp2.SNAPDUMP.EXE:ehp2.)
  183.     utilizes a flat ASCII file as input.  This file contains the
  184.     instructions that specify what data is to be collected (e.g. files,
  185.     memory areas), and what data gathering programs are to be invoked.
  186.     This flat file approach makes data collection with SnapDump very
  187.     flexible in that it can be easily tailored to add or remove
  188.     items to be collected.  When run, SnapDump will produce a single
  189.     output file that contains all collected data.
  190.  
  191.     SnapDump is invoked from the command line.  There are three forms
  192.     of the command:
  193.  
  194.        SNAPDUMP
  195.  
  196.     Page 2
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.     This form of the command assumes that the input file, snapdump.dat,
  207.     exists, and that it contains a list of files, data and programs to
  208.     be processed by SnapDump.  The output file defaults to, snapdump.dmp.
  209.  
  210.          SNAPDUMP {input-fname}
  211.  
  212.     The {input-fname} parameter is the name of the flat ASCII file that
  213.     contains the list of items to be captured.  The output file defaults
  214.     to snapdump.dmp.
  215.  
  216.          SNAPDUMP {input-fname dump-fname}
  217.  
  218.     The {input-fname} parameter is the name of the
  219.     flat ASCII file that contains the list of items to be captured.
  220.  
  221.     The {dump-fname} parameter is the name of the file into which
  222.     SnapDump will write all the captured data.  In this document,
  223.     it is also called the SnapDump output file.
  224.  
  225. SnapDump Input File
  226.     The SnapDump input file controls the information to be captured in
  227.     the SnapDump output file.  The SnapDump input file may be edited with
  228.     any ASCII editor, including the OS/2 system editor.  The following
  229.     describes the types of information that can be captured and how it
  230.     is to be specified in the flat file.
  231.  
  232.  
  233.         * A 'f/' in column 1 indicates that a file is to be captured.
  234.           For example:
  235.  
  236.               f/config.sys
  237.  
  238.           When a file is captured, the contents of the file are appended to
  239.           the SnapDump output file.  Wildcards may be specified, but be
  240.           aware that the SnapDump output file may become very large
  241.           if the wildcard specification is too broad.  Note that files
  242.           that are "in-use", such as the Communications Manager
  243.           'MESSAGE.DAT' and 'ERROR.DAT' files are collected by SnapDump.
  244.  
  245.         * A 'p/' in column 1 indicates that the specified program is to
  246.           be invoked.  For example:
  247.  
  248.               p/c:\qmc.exe -d
  249.  
  250.           Any programs (including .CMD files) that can be run from the
  251.           OS/2 command prompt and that write to standard output and/or
  252.           standard error may be specified.  The standard output and/or
  253.           standard error output of the program is appended to the
  254.           SnapDump output file.  The output of programs that use other
  255.           techniques of writing to the screen, such as Presentation
  256.           Manager "Win" calls or "VIO" calls, cannot be captured by
  257.           SnapDump.
  258.  
  259.  
  260.    Page 3
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.         * A 'm/' in column 1 indicates that a named shared memory
  271.           segment ("\SHAREMEM\...") is to be captured.  For example:
  272.  
  273.               m/\SHAREMEM\ACS\RAS_SEG
  274.  
  275.           The contents of the named shared segment are appended to the
  276.           SnapDump output file.  Wildcards for named shared memory are
  277.           not allowed. Certain named shared memory segments are protected
  278.           and cannot be dumped. The names of the named shared memory files
  279.           in the system may be obtained by issuing the following
  280.           command at the command prompt:
  281.  
  282.               pstat /m
  283.  
  284.         * Any other value in column one causes the line to be treated
  285.           as a comment.
  286.  
  287.     If the system trace is active, the system trace buffer is automatically
  288.     captured by SnapDump and appended to the SnapDump output file.
  289.  
  290. Searching for Files
  291.     When SnapDump scans for files, it will search all accessible drives,
  292.     including shared drives on servers and diskette drives.  Multiple
  293.     instances of a file will be collected, if they exist.
  294.  
  295. Sample SnapDump Input File
  296.     The following SnapDump input file is shipped with SnapDump, and can
  297.     be modified as required:
  298.  
  299.  
  300. *  OS/2 information
  301. f/config.*
  302. f/syslevel.*
  303. f/startup.cmd
  304. f/*.ini
  305. f/os20001.dat
  306. f/log0001.dat
  307. *
  308. *  FFST/2 files
  309. *
  310. f/epw.ini
  311. f/snapdump.dat
  312. f/os2mlog.dat
  313. p/dir c:\os2\system\*.dmp
  314. *
  315.    (continued...)
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.    Page 4
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336. *  Communication Manager
  337. *
  338. p/display.exe
  339. f/*.cfg
  340. f/*.ndf
  341. f/*.sec
  342. f/*.cf2
  343. f/error.dat
  344. f/message.dat
  345. f/esinst.hst
  346. f/acs.pro
  347. f/acslan.log
  348. f/c2instal.log
  349. f/install.log
  350. f/message.log
  351. f/custbld.hst
  352. f/cmfeater.dat
  353. m/\sharemem\acs\ras_seg
  354. *
  355. * Database Manager
  356. *
  357. f/sqldbdir
  358. f/sqlsystm
  359. f/sqldbcon
  360. f/sqluif.*
  361. f/sqlnodir
  362. f/sqlgwdir
  363. f/sqlogctl.lfh
  364. f/dbdrqlib.cfg
  365. *
  366. * LAN Server 2.0
  367. *
  368. f/net.err
  369. f/net.acc
  370. f/net.aud
  371. *
  372. * LAN status command
  373. *
  374. *p/net statistics requester
  375. *p/net statistics server
  376. *p/net config requester
  377. *p/net config server
  378. *p/net files
  379. *p/net sessions
  380. *p/net share
  381. *p/net status
  382. *p/net view
  383. *p/net who
  384. *
  385. * Workstation Status Programs
  386. *
  387. *p/netsess2.exe
  388. *p/ncbstat.exe 0 *
  389. *p/dirstat.exe
  390. p/findseg -S C:\
  391. p/qmc.exe -d
  392. p/pstat.exe
  393.  
  394.  
  395.    Page 5
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406. τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ
  407. Formatting Data Collected with SnapDump
  408.     The SnapDump Format Utility provides an easy to use menu interface
  409.     to select and display the contents of the SnapDump output file.
  410.     Because each data item collected in the dump file is tagged with an
  411.     "entry title", it is very easy to select a specific data item for
  412.     display.  It is not necessary to display the entire dump file.
  413.  
  414.     In addition, the SnapDump Format Utility can be used to extract
  415.     a specified data item, returning it to its original binary format.
  416.     This is particular useful for binary files that require specialized
  417.     formatters. The binary file can be extracted from the dump file
  418.     and stored as an individual file in its original binary format.
  419.  
  420.     The SnapDump Format utility can be accessed directly from
  421.     the command line by entering the following command:
  422.  
  423.       SNAPDF {dump-fname}
  424.  
  425.     The {dump-fname} parameter is the name of the dump file containing
  426.     data previously captured with an invocation of SNAPDUMP.
  427.  
  428.     If the {dump-fname} parameter is supplied, or 'snapdump.dmp' exists,
  429.     the 'Dump Formatter' window will be displayed.
  430.  
  431.     If no dump file name is specified and a file named 'snapdump.dmp'
  432.     does not exist, the following standard file 'Open' dialog box will
  433.     appear to assist the user in selecting a dump file name.
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.    Page 6
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.     The file 'open' dialog will appear as follows:
  471.  
  472.   ╘ττ¢τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττΣ
  473.   ·==·                      OPEN                                 ·
  474.   Äττ₧τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττà
  475.   ·                                                              ·
  476.   ·  ╘τττττττττττ¢ττττττττττττττττττττττττττττττττττττττΣ        ·
  477.   ·  ·File name: · *.dmp                                ·        ·
  478.   ·  ╙τττττττττττ₧ττττττττττττττττττττττττττττττττττττττπ        ·
  479.   ·                                                              ·
  480.   ·  ╘ττττττττττττττ¢ττττττττττττττττττττττττττττττΣ             ·
  481.   ·  ·Directory is: · C:\SNAPDUMP\                 ·             ·
  482.   ·  ╙ττττττττττττττ₧ττττττττττττττττττττττττττττττπ             ·
  483.   ·     ╘ττττττττττττττΣ                 ╘ττττττττττττττΣ        ·
  484.   ·     ·    Files:    ·                 · Directories: ·        ·
  485.   ·     ╙ττττττττττττττπ                 ╙ττττττττττττττπ        ·
  486.   ·  ╘ττττττττττττττττττττ¢ττΣ       ╘ττττττττττττττττττττ¢ττΣ   ·
  487.   ·  ·   SNAPDUMP.DMP     ·  ·       · ..                 ·  ·   ·
  488.   ·  ·                    Äττà       · ╒A:σ               Äττà   ·
  489.   ·  ·                    ·  ·       · ╒C:σ               ·  ·   ·
  490.   ·  ·                    ·  ·       ·                    ·  ·   ·
  491.   ·  ·                    ·  ·       ·                    ·  ·   ·
  492.   ·  ·                    ·  ·       ·                    ·  ·   ·
  493.   ·  ·                    ·  ·       ·                    ·  ·   ·
  494.   ·  ·                    ·  ·       ·                    ·  ·   ·
  495.   ·  Äττ¢τττττττττττττττττ╔ττà       Äττ¢τττττττττττττττττ╔ττà   ·
  496.   ·  ·<-·                 ·->·       ·  ·                 ·  ·   ·
  497.   ·  ╙ττ₧τττττττττττττττττ₧ττπ       ╙ττ₧τττττττττττττττττ₧ττπ   ·
  498.   ·                                                              ·
  499.   ·    ╘ττττττττΣ           ╘ττττττττΣ           ╘ττττττττΣ      ·
  500.   ·    ·  Open  ·           · Cancel ·           ·  Help  ·      ·
  501.   ·    ╙ττττττττπ           ╙ττττττττπ           ╙ττττττττπ      ·
  502.   ·                                                              ·
  503.   ╙ττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττπ
  504.  
  505.     The Tab and Shift+Tab keys, as well as the mouse, may
  506.     be used to move between controls in the dialog box. The Left Arrow
  507.     and Right Arrow keys may be used to move between the 'Open', 'Cancel',
  508.     and 'Help' buttons.  The user may press the F1 key, or click on the
  509.     'Help' button to obtain context-sensitive help on the current
  510.     (focus) control of the dialog box. The 'Directory is:' field is
  511.     read-only; it allows the user to see long subdirectory names.
  512.  
  513.     Only files identified as SnapDump or First Failure Support Technology/2
  514.     (FFST/2) dump files will appear in the 'Files:' listbox.  The user may
  515.     enter any file name in the 'File Name:' entry field.  The dump
  516.     formatter  will ensure the file is a SnapDump or FFST/2 dump file.
  517.  
  518.     Once a dump file and the 'Open' button are selected: the
  519.     'Dump Formatter' window will display the formatted SnapDump
  520.     data as well as a list of the data items captured by Snapdump.
  521.     SnapDump Dump Format on page 10 illustrates what this display
  522.     may look like ('after maximizing the window'):
  523.  
  524.    Page 7
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  ╘ττ¢ττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ¢τττ¢τττΣ
  537.  ·==·                                Dump Formatter                  ·   ·   ·
  538.  Äττ₧ττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ₧τττ₧τττà
  539.  ·  File   Options   Help                                                    ·
  540.  Äτττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττà
  541.  ·                            SNAPDUMP.DMP ╒1σ                               ·
  542.  ·    ╘τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ¢τττΣ  ·
  543.  ·    ·IBM SNAPDUMP/2 ╒2σ                                             · V ·  ·
  544.  ·    ╙τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ₧τττπ  ·
  545.  ·                                                                           ·
  546.  ·  ╒3σ 09-04-1991      16:10:36.75                SNAPDUMP                  ·
  547.  ·                                                                           ·
  548.  ·    ╘τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ¢τττΣ  ·
  549.  ·    ·Process Environment ╒4σ                                     ╒5σ· V ·  ·
  550.  ·    ╙τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ₧τττπ  ·
  551.  ·                                                                           ·
  552.  Äτττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττà
  553.  ·                                                                           ·
  554.  Äτττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ¢τà
  555.  ·COMSPEC=C:\OS2\CMD.EXE                                                   · ·
  556.  ·PATH=C:\OS2;C:\MUGLIB;C:\OS2\SYSTEM;C:\CMLIB;C:\CMLIB\APPN;C:\OS2\INSTALLÄτà
  557.  ·DPATH=C:\OS2;C:\MUGLIB\DLL;C:\CMLIB;C:\CMLIB\APPN;C:\OS2\SYSTEM;C:\OS2\IN· ·
  558.  ·PROMPT=$i╒$pσ                                                            · ·
  559.  ·KEYS=ON                  ╒6σ                                             · ·
  560.  ·BOOKSHELF=C:\OS2\BOOK;                                                   · ·
  561.  ·HELP=C:\OS2\HELP;                                                        · ·
  562.  ·                                                                         · ·
  563.  ·C:\snapdump\SNAPDUMP.EXE                                                 · ·
  564.  ·snapdump                                                                 · ·
  565.  · snapdump.dat                                                            · ·
  566.  ·                                                                         · ·
  567.  ·                                                                         · ·
  568.  ·                                                                         · ·
  569.  ·                                                                         · ·
  570.  ·                                                                         Äτà
  571.  ·                                                                         · ·
  572.  ╙τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ₧τπ
  573.                   Initial SnapDump Format Screen
  574.  
  575.     The SnapDump Dump Formatter screen needs to be maximized to
  576.     view all the data.
  577.  
  578.     The first field in the window (see ╒1σ) is the dump
  579.     file currently being displayed (for example:  SNAPDUMP.DMP).
  580.  
  581.     The second field in the window (see ╒2σ) contains a unique
  582.     dump segment identifier.  If the SnapDump file contains a
  583.     large number of data entries (where a data entry represents
  584.     a capture file, output from a program, or a shared segment),
  585.     the dump file will be segmented.  Each segment is identified
  586.     in this field, which can be scrolled by using the down-arrow
  587.     on the right.  Use the down-arrow at the right of this
  588.     field to see the complete list of segments, and to select the
  589.     desired segment.  Segmentation only occurs after approximately
  590.     300 data entries are collected.
  591.  
  592.    Page 8
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.     The third field in the window (see ╒3σ) is the date and time of
  605.     the dump as well as an the identifier of the of the program
  606.     that created the dump file (in this case, the originator is "SNAPDUMP").
  607.  
  608.     The fourth field in the window (see ╒4σ) contains the currently
  609.     selected data item.  When the Dump Formatter window is initially
  610.     displayed, 'Process Environment' is pre-selected and is displayed
  611.     in ╒6σ.  The environment information collected by SnapDump includes
  612.     'PATH:', 'DPATH:', etc..
  613.     The down arrow button (see ╒5σ) can be clicked-on (or press ╒Enter:σ)
  614.     to get a complete list of data items captured in the SnapDump output
  615.     file.  See SnapDump Dump Format on page 10 for an example of a list of
  616.     data items.  ╒7σ in SnapDump Dump Format on page 10 represents the
  617.     list of data items.
  618.  
  619.     When the Dump Formatter window is first displayed, the sixth
  620.     field in the window (see ╒6σ) contains an ASCII representation
  621.     of the 'Process Environment'.  The data can be displayed in
  622.     three formats:
  623.  
  624.        * Hexadecimal plus ASCII
  625.        * Hexadecimal plus EBCDIC
  626.        * ASCII only
  627.  
  628.    PF12 is used to change views of the data.
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.    Page 9
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  ╘ττ¢ττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ¢ττ¢ττΣ
  666.  ·==·                                Dump Formatter                      ·  ·  ·
  667.  Äττ₧ττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ₧ττ₧ττà
  668.  ·  File   Options   Help                                                      ·
  669.  Äτττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττà
  670.  ·                            SNAPDUMP.DMP ╒1σ                                 ·
  671.  ·    ╘ττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ¢ττΣ  ·
  672.  ·    ·IBM SNAPDUMP/2 ╒2σ                                                ·V ·  ·
  673.  ·    ╙ττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ₧ττπ  ·
  674.  ·                                                                             ·
  675.  ·  ╒3σ 09-04-1991      16:10:36.75                SNAPDUMP                    ·
  676.  ·                                                                             ·
  677.  ·    ╘ττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ¢ττΣ  ·
  678.  ·    ·Process Environment ╒4σ                                        ╒5σ·V ·  ·
  679.  ·    ╙ττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ₧ττπ  ·
  680.  ·                                                                             ·
  681.  Äτττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ¢τττà
  682.  ·                                                                         · V ·
  683.  Äτττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ╔τττà
  684.  ·Process Environment                                                      ·   ·
  685.  ·C:\CONFIG.SYS                                                            ·   ·
  686.  ·C:\OS2\INSTALL\CONFIG.SYS                                                ·   ·
  687.  ·C:\CMLIB\SYSLEVEL.ACS                                                    ·   ·
  688.  ·C:\OS2\SYSLEVEL.EPW      ╒7σ                                             ·   ·
  689.  ·C:\MUGLIB\SYSLEVEL.MUG                                                   ·   ·
  690.  ·\SHAREMEM\ACS\RAS_SEG                                                    ·   ·
  691.  ·'NET STATISTICS REQUESTER'                                               ·   ·
  692.  ·'PSTAT.EXE'                                                              ·   ·
  693.  ·'QMC.EXE                                                                 ·   ·
  694.  ·C:\OS2\EPW.INI                                                           ·   ·
  695.  ·                                                                         ·   ·
  696.  ·                                                                         Äτττà
  697.  ·                                                                         · A ·
  698.  ╙τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ₧τττπ
  699.             SnapDump Dump Format screen after dump file name selected
  700.  
  701.     In this example, the portion of the window with the list of collected
  702.     data items (see ╒7σ) is used to select a data item for display.
  703.     To select an item for display, single click on the data item and then
  704.     press 'Enter:' (or then double click on the item in ╒4σ).
  705.     The data can be displayed in three formats:
  706.  
  707.       * Hexadecimal plus ASCII
  708.       * Hexadecimal plus EBCDIC
  709.       * ASCII only
  710.  
  711.     PF12 is used to change views of the data.
  712.  
  713.     The F4 key may be used to toggle the visibility of the list box
  714.     part of the prompted entry fields whenever the entry field (see
  715.     ╒4σ) has the keyboard focus keyboard focus (clicking on the
  716.     down-arrow button (see ╒5σ) is the equivalent).  To actually
  717.     select an item from the dump list or the entry list, use the
  718.     up- and down-arrow keys (or the mouse if the list box control
  719.     of the upper entry area is visible) and then either press Enter
  720.     or double-click on the entry field portion of ╒4σ to complete the
  721.     selection. If a new entry is selected, it will be formatted
  722.     and displayed.
  723.  
  724.  
  725.  
  726.    Page 10
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.     Items in the list that are in quotes (for example, 'PSTAT.EXE', see
  737.     ╒7σ) represent programs that were invoked by SnapDump.  Output
  738.     from these programs is selected for viewing in the same manner as files.
  739.  
  740.     Files that were captured in a SnapDump output file may be copied to
  741.     disk with the 'SAVE AS...' found under 'FILE:' from the action bar.
  742.     Select the data item, go to the action bar and select 'FILE:',
  743.     then select 'SAVE AS'.  On the 'SAVE AS' dialog box
  744.     set 'Select output type' to binary data and double click on
  745.     'SAVE'.  For example, files such as OS2.INI should be saved
  746.     as binary data to preserve their binary format.
  747.     The captured file will then be written to disk.  This function will
  748.     not write OS/2 Extended Attributes.
  749.  
  750.     A new SnapDump output file can be opened by selecting 'Open' found
  751.     under 'FILE' from the action bar.  This is useful when multiple
  752.     SnapDump output files are to be viewed.
  753.  
  754.  
  755. τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ
  756. Transporting SnapDump Output Files
  757.     If the SnapDump output file is too large to fit on a single diskette
  758.     (even after packing it), the 'Backup' function provided with OS/2
  759.     can be used to store a very large file on multiple diskettes.
  760.     Conversely, the 'Restore' function provided with OS/2 can be used to
  761.     restore the diskette-spanning information into a single file.
  762.  
  763. τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ
  764. Support for SnapDump
  765.  
  766. Usage Support
  767.     Usage support, for Customers  and SEs, will be provided through
  768.     EQUAL/ASKQ.  Keyword for entries should be "SNAPDUMP".
  769.  
  770. Defect Support
  771.     Defect support for SnapDump will be handled through SNAPDUMP FORUM
  772.     on IBMPC which will be monitored.  Defect will be answered with in 2
  773.     weeks.
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.    Page 11
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801. τττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττττ
  802. SnapDump Utility Programs
  803.     Any programs that provide useful problem determination information,
  804.     or status, are candidates for use with SnapDump.  The following
  805.     programs may be of use to you, and are installed with SnapDump:
  806.  
  807.         QMC.EXE       Displays hardware information
  808.         FINDSEG.EXE   Displays segments
  809.         NETSESS2.EXE  Displays session statistical and status
  810.         DIRSTAT.EXE  Exhibits adapter information
  811.         NCBSTAT.EXE  Displays Netbios information
  812.  
  813.     The following program is provided with Extended Services for OS/2.
  814.     To install this program, you must install the Communications Manager
  815.     Utilities found on the Additional Features panel during initial
  816.     installation (ESINST) or re-install (REINST).  See the Extended
  817.     Services Communications Manager Command Reference for more information
  818.     about using this program.
  819.  
  820.         DISPLAY.EXE   Displays the active SNA configuration
  821.  
  822.     The following program is provided with the base operating system.
  823.  
  824.         PSTAT.EXE     Displays system information
  825.  
  826. QMC
  827.     The QMC program returns a wealth of useful information about the
  828.     the hardware installed on the machine on which it is run.
  829.     You must have the IOPL=YES in your CONFIG.SYS for QMC to function.
  830.     The following options are available when invoking QMC:
  831.  
  832.   Options
  833.   -------
  834.   -? or ?      lists options (help)
  835.  
  836.   -A           list all supported Microchannel adapters supported by QMC
  837.                (can be used with the -O option to redirect to file)
  838.  
  839.   -D           list more detailed QMC information
  840.                includes : adapter configuration for Microchannel
  841.                           model, submodel
  842.                           fixed disk sectors/heads/cylinders.
  843.  
  844.   -O           redirect output to QSYSTEM.OUT
  845.  
  846.   -Ofilename   redirect output to file
  847.  
  848.                For example:
  849.  
  850.                QMC -Ops2data.fil
  851.  
  852.                would redirect the output of QCONFIG to ps2data.fil.
  853.  
  854.  
  855.  
  856.    Page 12
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.   key=value    define key with value for machine information output
  868.                There is a limit of 10 keys.
  869.  
  870.                For example:
  871.  
  872.                QMC User="Jeff Muir" "Location Site"=Boca
  873.  
  874.                Output would include:
  875.  
  876.                User            : Jeff Muir
  877.                Location Site   : Boca
  878.  
  879.     There are a couple of methods to handle data scrolling off the screen:
  880.  
  881.       QMC ] MORE   (pipes information from QMC into the MORE command)
  882.  
  883.       QMC -O       (re-directs the output to QSYSTEM.DAT)
  884.  
  885.     The first technique is good if you just want to view the info
  886.     one screen at a time.  The second technique works best for
  887.     keeping a permanent copy and being able to browse/edit the results.
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894. Findseg
  895.     This program searches for the specified segments within executable
  896.     files.  This version of Findseg operates only on 16-bit OS/2
  897.     operating systems.
  898.     The key word for this search is the length of a segment.  There
  899.     are two basic forms of the findseg command:
  900.  
  901.       Usage: findseg ╒switchσ ╒drive:σ╒pathσ
  902.       Usage: findseg ╒switchσ ╒UNC nameσ
  903.  
  904.    switch:
  905.         1.Segment type
  906.             -c : Report code segments only.
  907.             -d : Report data segments only.
  908.             -b : Report code and data segments (default).
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.    Page 13
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.         2.Segment length
  932.             -l : The string after this switch is the length of the target
  933.                  segment. If the length is specified as HEX format, it must
  934.                  start with X (or x). Spaces aren't allowed between -l and
  935.                  the string. If the string is 0 (or x0) the length is 65536.
  936.                  If this switch isn't set, all segments will be reported.
  937.             -r : Report the segments whose length are between LENGTH - DELTA
  938.                  and LENGTH + DELTA. (LENGTH is the specified length by -l
  939.                  and DELTA is the specified length by this switch.)
  940.                  Default is -r1.
  941.  
  942.          3.File type
  943.             -E : Search EXE files only.
  944.             -D : Search DLL files only.
  945.             -S : Search SYS files only.
  946.             -B : Search EXE and DLL files.
  947.                  One or more switches may be set.  The default is -E -D -S.
  948.  
  949.         4.Access rights byte
  950.             -A : The string after this switch is the access right byte of
  951.                  the target segment. If it is specified as HEX format, it must
  952.                  start with X (or x). Spaces aren't allowed between -A and
  953.                  the string.  PRESENT, ACCESSED and EXPANSION DIRECTION (data
  954.                  segment) bits will not be tested.  This access rights byte is
  955.                  displayed as **ACC=?? in the TRAP-D popup panel.
  956.                  (**:CS, DS, SS, ES, ER, ??:Access rights byte)
  957.  
  958.         5.Disassemble
  959.             -I : Output disassembled code. The string after this switch is the
  960.                  IP value. If it is specified as HEX format, it must start with
  961.                  X (or x). Spaces aren't allowed between -I and the string.
  962.                  This switch is valid for CODE segments.  In the disassembled
  963.                  code, the relocation information is not resolved.
  964.                  resolved.
  965.  
  966.         6.Miscellaneous
  967.             -p : Pause after a screen is full. This switch is ignored when
  968.                  OUTPUT is redirected to a file.
  969.             -s : Search from sub-directories.
  970.  
  971.    drive    : Drive name. Default is the current drive.
  972.    path     : Path name. Default is the current path.
  973.    UNC name : Universal naming convention name. \\server name\net work
  974.               name╒\pathσ
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.    Page 14
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.    Example: findseg -lx6000 -rx1000 -s -D -Ix400 C:\
  1000.             This searches DLL files from a root and its all sub-directories in
  1001.             drive C. And it reports file names and length and attribute of
  1002.             segments whose size are between 0x5000 and 0x7000 bytes.
  1003.             They are output in the following format.
  1004.  
  1005.         Search path  : C:\ and its sub-directories
  1006.         Search file  : *.DLL
  1007.         Search range : 0x05000(20480)-0x07000(28672) bytes
  1008.         Access rights: not specified
  1009.  
  1010.         C:\MYDLL\TEST.DLL
  1011.             12610bytes    90-05-10    15:25:00
  1012.         004 05200 DATA FIXED   NONSHARED PRELOAD   R-O NORELOC PL3 DISCARDABLE
  1013.  
  1014.         C:\OS2\DLL\PMGPI.DLL
  1015.            265110bytes    90-03-30    01:20:00
  1016.         002 05FCC CODE MOVABLE NONSHARED LOADONCALL E/R RELOC PL2 NONDISCARDABLE
  1017.           Instruction: push     es:╒bx+siσ
  1018.  
  1019.         C:\OS2\DLL\OS2SM.DLL
  1020.              64512bytes    90-03-30    01:20:00
  1021.         001 05789 CODE MOVABLE NONSHARED PRELOAD  E/R RELOC   PL3 NONDISCARDABLE
  1022.           IP is invalid value.
  1023.  
  1024.         C:\OS2\DLL\DISPLAY.DLL
  1025.             342016bytes    90-03-30    01:20:00
  1026.         002 067DE CODE MOVABLE SHARED  PRELOAD   E/R RELOC   PL2 NONDISCARDABLE
  1027.           IP is invalid value.
  1028.         00A 050BE DATA MOVABLE SHARED  PRELOAD    R/W NORELOC PL2 NONDISCARDABLE
  1029.  
  1030.         5 segments in 4 files
  1031.  
  1032.    Note : The meaning of each value is as follows:
  1033.  
  1034.        C:\OS2\DLL\PMGPI.DLL <--- File name
  1035.           265110bytes    90-03-30    01:20:00   <--- File size and update time
  1036.        001 05FCC CODE MOVABLE NONSHARED LOADONCALL E/R RELOC PL2 NONDISCARDABLE
  1037.        (1)  (2)   (3)   (4)     (5)       (6)      (7)   (8) (9)       (10)
  1038.          Instruction: push     es:╒bx+siσ  <-- Disassembled code at IP=0x400
  1039.  
  1040.        (1) : Entry id in segment table
  1041.        (2) : Minimum allocation size for the segment
  1042.        (3) : Segment type (CODE/DATA)
  1043.        (4) : Fixed or Movable segment
  1044.        (5) : Shared or Nonshared segment
  1045.        (6) : Preload or Load on call segment
  1046.        (7) : Execute/read or Execute-only if code,
  1047.              Read/Write or Read-only if data
  1048.        (8) : Relocation table present or not
  1049.        (9) : Privilege level
  1050.        (10): Discardable or Nondiscardable segment
  1051.  
  1052.  
  1053.  
  1054.    Page 15
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.   3. Hints to determine TRAP-D module
  1064.  
  1065.    To find the TRAP-D module, set the CSLIM value found in the TRAP-D
  1066.    panel to segment length (-l switch), instead of DSLIM, ESLIM or SSLIM
  1067.    since the data segments (DS, ES and SS) may have been allocated or
  1068.    reallocated after the process started.
  1069.    process started.
  1070.  
  1071.    You had better set IP value(by -I switch). When two or more modules are found,
  1072.    you can determine TRAP-D module from disassembled code. For example, TRAP-D
  1073.    may not occur on the following instructions
  1074.          mov   ax, 0
  1075.          inc   cx
  1076.             :
  1077.          etc.
  1078.    and the following instructions have potential of TRAP-D (or TRAP-C).
  1079.                                       TRAP-D occurs on the following condition.
  1080.          pop   ax                <--- sp exceeds SSLIM (In this case TRAP-C
  1081.                                       will occur).
  1082.          les   bx, es:╒bx+siσ    <--- bx+si exceeds ESLIM or ES is invalid
  1083.          rep   movs              <--- si exceeds DSLIM or di exceeds ESLIM
  1084.             :
  1085.          etc.
  1086.  
  1087.  
  1088. NETSESS2 program operation
  1089.     The NETSESS2 program obtains and prints session statistics which
  1090.     are kept by the LAN adapter card (or NETBEUI in the case of the
  1091.     Token Ring).  The session statistics may be obtained for the
  1092.     local station only.
  1093.  
  1094.     The syntax of the NETSESS2 command line is as follows:
  1095.  
  1096.       netsess2 ╒-<lana>σ ╒<session_name>σ
  1097.  
  1098.     The optional flag -<lana> indicates use of the alternative LAN adapter
  1099.     specified instead of the default which is LAN adapter 0.  Possible
  1100.     values for <lana> are 1, 2, and 3.
  1101.  
  1102.     If the optional <session_name> is specified, only the statistics for
  1103.     sessions with that local name will be printed.  Otherwise statistics
  1104.     for all sessions will be printed.
  1105.  
  1106.     The session statistics printed appear as follows:
  1107.  
  1108. Session statistics for local station
  1109.  
  1110. Number of Sessions in progress = 03
  1111.  
  1112. LSN Status  Local Name       Remote Name      Rcv Send
  1113. --- ------- ---------------- ---------------- --- ----
  1114. 003 Session morbius          YKTLAN1          001 000
  1115. 004 Session jeffat           robbi            001 001
  1116. 005 Session morbius          altair           001 000
  1117.  
  1118.  
  1119.    Page 16
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127. Receive Datagram commands outstanding 000
  1128. Receive Any      commands outstanding 004
  1129.  
  1130.  
  1131.     The column labeled 'LSN' contains the Local Session Numbers which
  1132.     are assigned to each session by the LAN adapter.
  1133.  
  1134.     The column labeled 'Status' contains keywords indicating the
  1135.     status of the session. See the Tech. Ref. Manual for explanations
  1136.     of these status conditions.
  1137.  
  1138.     The column labeled 'Local Name' contains the LAN adapter name
  1139.     used at the local adapter in the CALL or LISTEN command that
  1140.     established the session.
  1141.  
  1142.     The column labeled 'Remote Name' contains the LAN adapter name
  1143.     used at the remote adapter in the CALL or LISTEN command that
  1144.     established the session.
  1145.  
  1146.     The column labeled 'Rcv' contains the number of outstanding
  1147.     RECEIVE commands for this session.
  1148.  
  1149.     The column labeled 'Send' contains the number of outstanding
  1150.     SEND commands for this session.
  1151.  
  1152.     The two lines following the tabular information contain the
  1153.     number of outstanding RECEIVE DATAGRAM commands, and the number
  1154.     of outstanding RECEIVE ANY commands, respectively.
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.    Page 17
  1179.  
  1180.