1 03/26/85 dump_mpc
 2 
 3 Syntax as a command:  dump_mpc mpc_name {-control_args}
 4 
 5 
 6 Function:  performs a dump of the read/write memory of a MPC and
 7 selectively edits the dump, the trace table, and MPC and device
 8 statistics.
 9 
10 
11 Arguments:
12 mpc_name
13    is the name of the MPC to be dumped.  This name must appear on an
14    mpc card in the config deck.  If this argument is omitted, -channel
15    must be given.
16 
17 
18 Control arguments:
19 -dump
20    displays a hexadecimal dump.
21 -trace
22    displays an interpreted trace of the MPC.
23 -extend, -ext
24    extends the output file if it exists.  The default is to overwrite
25    the file.
26 -stat
27    displays the MPC and device statistics.
28 -mpc
29    displays MPC error data only.
30 
31 
32 -channel channel_name, -chn channel_name
33    specifies a channel name, where channel_name is of the form
34    [iomtag][channel_no] (i.e., a14).  The iomtag field must be a tag of
35    a configured IOM and the channel_no must be a decimal channel
36    number.  If this control argument is used, the mpc_name argument is
37    optional.  If both are used, the channel must be connected to the
38    MPC specified.
39 -output_file {path}, -of {path}
40    directs dump output to the segment specified by path.  If path is
41    not given, a default segment name of [mpc_name].list is used.  If
42    this control argument is not given, the default is to direct output
43    to your terminal.
44 
45 
46 -long
47    formats output for devices with 132 columns or more.  The default is
48    based on output type and can be used to override the file output
49    default.
50 -short
51    formats output for devices with fewer than 132 colums.  The default
52    is based on output file type and can be used to override the file
53    output default.
54 
55 
56 Access required:  You must have re access to rcp_priv_ to use the
57 dump_mpc command.
58 
59 
60 Notes:  If neither the -stat, -dump, -mpc, nor -trace control arguments
61 are specified, only the MPC and device statistics are displayed.
62 
63 Switch 4 on the MPC maintenance panel is used to control tracing in the
64 MPC.  Tracing is only done if this switch is in the down position.  If
65 the trace table is being dumped to see the events leading up to a
66 particular error condition, it may be useful to place switch 4 in the
67 up position as soon as possible after the error occurs.  This inhibits
68 further tracing of I/O in the MPC and reduces the chances of losing
69 trace data caused by the table wrapping around before the dump can be
70 taken.