syacdb(1M) DG/UX 5.4R3.00 syacdb(1M)
NAME
syacdb - syac debugger utility program
SYNOPSIS
syacdb [device] ...
where:
device Name of systech controller to use
DESCRIPTION
The syacdb command is a set of utilities than can be used to provide
information about the hardware, software,and configuration of the
Systech controllers. If no device is specified then the program will
attempt to use the default syac device which is
/dev/async/syac@60(60000000). An altername device may be specified
on the command line.
EXAMPLES
syacdb /dev/async/syac@62(60040000)
COMMANDS
!
The ! command can be used to issue commands to the parent shell.
?
The ? command is the same as the help command. This command will
print out a list of valid commands.
cch [channel-id]
The cch command is used to look at the cluster channel data
structure. Two pages of output are produced information of the
receive structure, the transmit structure and general information.
If a channel id is specified then the system attempts to gain
information about that channel. Otherwise the program uses the
current channel id.
cdump [ channel_id ] [ starting_addr ]
The cdump command is used to dump memory from a cluster controller.
The channel id and starting addresses are mandatory parameters the
first time the command is used. Once the user has specified a
channel id, the program will continue to use the same channel until
a new channel is specified. The command will dump out channel
memory in 128 byte blocks. If the address is not given then the
program will use the current memory location +1 as the starting
address. Sample output is shown below.
100080: 00 10 03 c0 00 20 04 04 00 10 04 0a 00 00 0f da ................
100090: 00 00 0f da 00 00 15 b0 00 10 43 90 00 10 66 98 ..........C...f.
1000a0: 00 00 0f da 00 00 0f da 00 00 0f da 00 00 0f da ................
1000b0: 00 00 0f da 00 00 0f da 00 00 0f da 00 00 0f da ................
1000c0: 00 00 0f da 00 00 0f da 00 00 0f da 00 00 0f da ................
1000d0: 00 00 0f da 00 00 0f da 00 00 0f da 00 00 0f da ................
Licensed material--property of copyright holder(s) 1
syacdb(1M) DG/UX 5.4R3.00 syacdb(1M)
1000e0: 00 00 0f da 00 00 0f da 00 00 0f da 00 00 0f da ................
clog [ cluster_id ] [ device ]
The clog command is used to get general logging information about
the cluster controller. The cluster id is a mandatory parameter
the first time the command is invoked. From then on the program
will use the id of the last invocation of the program. If not
specified, the program uses the device specified when the program
was invoked. The following is an example of a call to clog:
Model HPS-7082-030
Firmware 90-070371-7-01A
Running 90-070434-7-01C+SEQ
Device type 69
Station ID 01
Real-time clock ticks 120049
Idle task counter 120049
Out of memory errors 0
Miscellaneous errors 0
Network packets send 2208
Network packets received 2224
No response errors 0
Bad response errors 0
Offline errors 0
Network reconfigurations 1
ROM size 65536
ROM checksum 0x0714
End of RAM 1179648
Failed ports none
dloop [cdlnrstq] [device] [limit] [bcount] [bsize] [time]
The dloop command performs DMA loopback testing between the host
computer and the Systech host adapter. A block of data is sent to
the board, read back into the host and verified.
options
One or more of the options must be selected.
c This option will disable the verification part of the test.
The blocks will be transmitted and received but no check will be
made that the data is the same.
d This option allows the user to override the default device
which is /dev/async/syac@60(60000000).
l This option allows the user to set a limit on the characters
per second sent by the test. If this option is used the user
must specify a limit on the command line.
n This option allows a maximum block count to be set. If this
option is used the user must specify a block count on the
command line. The default is to send an unlimited number of
blocks with the test bounded by time.
r This option enables sending random size blocks from 1 to 512
bytes in length. The default is to send fixed size blocks.
s This option specifies that fixed block lengths are to be used.
The maximum block size allowed is 512 bytes. If this option is
Licensed material--property of copyright holder(s) 2
syacdb(1M) DG/UX 5.4R3.00 syacdb(1M)
used then the user must specify a block size on the command
line.
t This option sets the running time for the test. The default
time is 30 seconds. If this option is used then the user must
specify the time in seconds on the command line.
q This option tells the program not to send results to standard
output unless there is an error.
If two or more conflicting options are specified then the first
option on the command line takes effect.
Examples
Run the loopback test for 60 seconds using random size blocks.
dloop rt 60
Run the test sending 200 blocks that are 256 bytes long.
dloop ns 200 256
dump [ starting_addr ] [ dump_size ]
The dump command allows the user to display portions of the syac
memory. If no starting address is specified then the dump will be
started at either the start of syac memory if memory had not been
dumped previously or the next location after the last location
dumped. The default dump size is 128 bytes. The maximum size of
memory to be dumped at one time is 512 bytes. The format of the
dump is the same as for the cdump command.
exit
The exit command terminates the program.
help
The help command prints a list of valid commands for the syacdb
program
log
The log command command is used to get general logging information
about the host adapter. Sample output from the log command is
shown below.
Model HPS-6945
Firmware 90-070154-6-05B Board assy XX-XXXXXX-X-XXX
Device type 4
Station ID ff Option switches 0xfc
Real-time clock ticks 370819 Idle task counter 411888196
Bytes DMAed to HPS 128822 Bytes DMAed from HPS 1097777
DMA XACK timeouts 0 IOCB processed 2872
DMA bus req. timeouts 0 Response queue full 0
No memory errors 0 Response queue full 0
Network queue full 0 Miscellaneous errors 0
Packets sent 6502 Packets received 6410
Licensed material--property of copyright holder(s) 3
syacdb(1M) DG/UX 5.4R3.00 syacdb(1M)
No response errors 0 Bad response errors 0
Offline errors 0 Reconfigurations 8
reserved 0 ROM size 32768
ROM checksum 0x6d87 End of RAM 0x180000
Real time clock (HZ) 20 reserved 0
Set ram start to 0x100000 and ram_end to 0x17ffff
netc
The netc program prints out the configuration of syac controllers
and cluster controllers that exist on the network. For each
controller the program will print out the device type, network
address along with the state of lines if appropriate. The following
gives sample output from the netc program.
NET ADDR STATE DEV TYPE FW RE HOST ID
________ _________ ________ _____ _______
1 Normal Online HPS 7082-030 01A n/a
ff Normal Online HPS 6945 05B 0
partitions
The partitions command prints a table showing the breakup of on-
board memory into certain sizes pieces. The program will show the
number of the pieces, the size and current location of the memory
chunks. An sample output from the partitions command is shown
below.
# Curr
Part Size Name Max Entries Start End
____ ____ ____ ___ _______ __________ __________
1 512 MEM_512 506 328 0x00140b94 0x0017ff94
3 32 MEM_32 183 172 0x0012f834 0x00130f14
4 16 MEM_16 60 10 0x0012f474 0x0012f834
2 32 MEM_32 183 172 0x0012f834 0x00130f14
16 16 0x001005ec 0x001009ec
queues
The queues command provides information about the state of the on-
board queues. Information such as number of entries and number of
tasks waiting are provided. An example of output from the queues
command is shown command.
# Cur # Tasks
Queue Entries Waiting Name Max Entries
_____ _______ _______ ____ ___________
244 0 1 DIAG NET Q 16
243 0 1 DIAG IOCB Q 16
54 175 - MEM 512 Q 175
41 0 1 ASYNC IOCB Q 26
rloop a[cdlnrstq] addr [device][limit][bcount][bsize][time]
The rloop command performs DMA loopback testing between the host
computer and the remote cluster controller. A block of data is
Licensed material--property of copyright holder(s) 4
syacdb(1M) DG/UX 5.4R3.00 syacdb(1M)
sent to the controller, read back into the host and verified.
options
One or more of the options must be selected.
a This option is used to tell the program which cluster
controller to run the loopback test through.
c This option will disable the verification part of the
test. The blocks will be transmitted and received but no
check will be made that the data is the same.
d This option allows the user to override the default
device which is /dev/async/syac@60(60000000).
l This option allows the user to set a limit on the
characters per second sent by the test. If this option is
used the user must specify a limit on the command line.
n This option allows a maximum block count to be set. If
this option is used the user must specify a block count on
the command line. The default is to send an unlimited
number of blocks with the test bounded by time.
r This option enables the sending of random size blocks
from 1 to 512 bytes in length. The default is to send
fixed size blocks.
s This option specifies that fixed block lengths are to be
used. The maximum block size allowed is 512 bytes. If
this option is used then the user must specify a block size
on the command line.
t This option sets the running time for the test. The
default time is 30 seconds. If this option is used then
the user must specify the time in seconds on the command
line.
q This option tells the program not to send results to
standard output unless there is an error.
If two or more conflicting options are specified then the
first option on the command line takes effect.
Examples
Run the remote loopback test on cluster controller 2 for
60 seconds using random size blocks.
rloop art 2 60
Run the remote test on cluster controller 1 sending 200
blocks that are 256 bytes long.
rloop ans 1 200 256
search [ pattern ] [ starting_addr ] [ ending_addr ]
The search command is used to search through host adapter
memory to locate a pattern. The search pattern is initialized
to 00. The initial starting and ending addresses to search
are set to the top and bottom of memory. The starting address
is set to the next location after a successful search. If a
Licensed material--property of copyright holder(s) 5
syacdb(1M) DG/UX 5.4R3.00 syacdb(1M)
search was not successful then the starting address is not
modified. A pattern may be between 1 and 4 bytes in length
and leading zeroes must be specified.
setcch [ addr ]
The setcch command is used to get or set the cluster channel
address.
setl [ length ]
The setl command is used to get or set the channel length
field.
settcb
The settcb command is used to get or set the task control
block address.
show
The show command is used to print out internal variables used
by the program. Information like the starting search address
and the board type will be printed out. A number of the
variables are initialized to zero and not set until the
appropriate command has been called first to set the variable.
For example prior to the first invocation of the queue command
the queue addr field is set to 0x0. A sample output from the
show command is given below.
Global variables:
hps_intel = 0x0
board_type = 0x4
os_type = 0x0
ram_start = 0x100000
ran_end = 0x17ffff
tcb_addr = 0x127dae
tcb_len = 0x50
config_tasks = 0x11
ch_addr = 0x0
ch_len = 0x390
cch_addr = 0x0
queue_addr = 0x0
part_addr = 0x0
Other current variables:
remaddr = 0x0
station = 0x800
dumpaddr = 0x0;
dumplen = 0x0
search data = 0x0
search size = 0x0
search chart = 0x0
search start = 0x0
search end = 0x0
hpsstat [ dcpfioexsta ] [ device ] channel_number
The hpsstat command is used to retrieve channel parameters for
an open channel from the host adapter. The default host
Licensed material--property of copyright holder(s) 6
syacdb(1M) DG/UX 5.4R3.00 syacdb(1M)
adapter is /dev/async/syac@60(60000000)).
options
One or more options must be selected:
t This option must be used with either the i or o option.
This will cause the appropriate translate table to be
printed.
c This option is used to display system configuration.
This option concerns the entire host adapter and not just
an open channel.
p This option causes the current baud rate, number of bits,
parity and stop bits to be printed out.
f This option causes the display flow control parameters to
be printed.
i This will cause the input parameters to be printed.
o This will cause the output parameters to be printed.
e This will cause echo parameters to be printed.
x This option is to display extra parameters which have not
been implemented in the current release of the Systech
firmware.
s This will print out the display channel status.
d This allows the user to set the device name and override
the default device.
a This allows all options to be set.
Sample output from the stat program is listed below.
ASYNCH PROTOCOL
Baud Char Len Parity Stop bits
Receive: 300 8 none 1 stop bit
Transmit: 300 8 none 1 stop bit
tasks [ task-id ]
The tasks command is used to get information about an
individual task or about all of the tasks on the host adapter.
If the task id is specified the information includes the
contents of the registers. Sample output from the command is
given below.
Task TCB Pri State
____ ___ ___ _____
4 (loader task) (00127e4e) 11 RDY
12 (netman ) (00127e9e) 14 SUS QUE: 10. (NETW Q)
5 (hst_Rsp_task) (00127eee) 100 SUS QUE: 5. (RESP Q)
255 (idle task ) (001282ae) 255 RDY
usage
The usage command is used to measure the load on the host
adapter. The program will report the percentage of time the
board is idle.
ver
The ver program is used to get the version of the terminal
Licensed material--property of copyright holder(s) 7
syacdb(1M) DG/UX 5.4R3.00 syacdb(1M)
control software (TCS) that is running on the host adapter.
When this program is invoked, a small menu appears which
allows the user to get the version information, change the
host adapter to allow getting version information on a
different adapter and to quit the program. The user makes a
choice by entering the menu number and pressing the return
key. Sample version information and the user menu are shown
below.
==TCS VERSION INFORMATION==
Title: HPS-TCS-VME
Version: 04H
Part Number: 90-070054-5
Creation Date: Mon Oct 8 09:22:44 PDT 1990
Description: HPS-6945 TCS and Diag Apps, Net Man
Which version information do you want to display?
0 - Quit
1 - TCS
2 - Change host adapter (currently /dev/async/syac@60(60000000))
Your choice (enter a number)
FILES
/usr/sbin/syacdb Executable file for utility
/usr/lib/tcload/models/syac/dloop Executable file for the dloop
command
/usr/lib/tcload/models/syac/rloop Executable file for the rloop
command
/usr/lib/tcload/models/syac/hpsver Executable file for the ver
command
/usr/lib/tcload/models/syac/stat Executable file for the stat
command
SEE ALSO
syac(7).
NOTES
Certain commands such as clog cannot be run until the netc command
has been run.
The netc command has no meaning on a VAC16 and will cause the program
to exit.
Licensed material--property of copyright holder(s) 8