1 02/01/84  display_ioi_data
 2 
 3 Syntax:  display_ioi_data {-control_args}
 4 
 5 
 6 Function: displays control blocks in the ring-0 database ioi_data.  It
 7 can be used on a running system, an fdump, or a copy of ioi_data made
 8 with the copy_out command (see the System Dump Analysis PLM, Order
 9 No. AN53).
10 
11 
12 Control arguments:
13 -all, -a
14    causes all the channel table entries and device table entries
15    associated with the group(s) selected to be displayed.  It can be
16    used with -group or -gte.
17 -force, -fc
18    forces the display of certain control block and/or fields that the
19    command might not otherwise display.
20 -header, -he
21    causes the ioi_data header to be displayed.  This is the default if
22    no control blocks are selected.
23 -no_header, -nhe
24    suppresses the display of the ioi_header.  This is the default when
25    a control block is selected.
26 
27 
28 Control arguments for selecting: The following select where ioi_data is
29    to be found.  Only one control argument can be selected from this
30    list.  If none are specified, ioi_data is copied from ring-0 of the
31    running system.
32 -erf erfno
33    specifies the number of the fdump to be analyzed.
34 -segment path, -sm path
35    specifies the pathname of the segment containing ioi_data.
36    Normally, this segment is obtained from the running system using the
37    copy_out command or from an fdump using the extract command.
38 
39 
40 Control arguments for displaying: The following specify which control
41    blocks in ioi_data are to be displayed.  Only one control argument
42    can be selected from the following list.  If none are specified,
43    all control blocks are displayed.
44 -channel {channel_name}, -chn {channel_name}
45    displays the channel table entry (cte) for the channel specified.
46    If channel name is ommitted, all cte's are displayed.  The channel
47    name argument is in the form {tag}number, where tag is an IOM tag
48    (a thru h) and number is an octal channel number.  If tag is
49    omitted, IOM a is assumed.
50 -cte {octal_offset}
51    displays the cte at iom_data|octal_offset.  If offset is omitted,
52    all cte's are displayed.
53 
54 
55 -device {device_name}, -dv {device_name}
56    displays the device table entry (dte) for the device specified.  If
57    device_name is omitted, all dte's are displayed.
58 -dte {octal_offset}
59    displays the dte at iom_data|octal_offset.  If offset is omitted,
60    all dte's are displayed.
61 -group {device_name}, -gp {device_name}
62    displays the group table entry (gte) for the device specified.  If
63    device_name is omitted, all gte's are displayed.
64 -gte {octal_offset}
65    displays the gte at iom_data|octal_offset.  If offset is omitted,
66    all gte's are displayed.
67 -user {Person_id.Project_id}
68    displays the dte's of all devices assigned to the specified user.
69    If Person_id.Project_id is omitted, your Person_id is assumed.
70    Either Person_id or Project_id can be omitted or an asterisk (*)
71    can be used in their place.
72 
73 
74 Access required: To use this command on a running system, access to the
75 phcs_ gate is required.
76 
77 
78 Notes: The default action of this command when invoked with no
79 arguments is:
80 
81    display_ioi_data -group -all -header