jive5ab Command/Query Summary (by category)
In the tables below, each command’s availability per system is listed. “5A”, “5C” etc. mean the command is available on the indicated Mark5 system. “5I” = Mark5B / DIM, “5O” = Mark5B / DOM. The “G” category means availability on a generic, non Mark5 platform, including Mark6/FlexBuff. This includes jive5ab compiled for a Mark5 system without Mark5 support, and all non-default runtimes (see Section 6) on all systems.
General
Availa bility: |
5 A |
5 I |
5 O |
5 C |
G |
|
|---|---|---|---|---|---|---|
dis k_state |
Y |
Y |
Y |
Y |
Set/get Disk Module Status (DMS): last significant disk operation |
|
d isk_sta te_mask |
Y |
Y |
Y |
Y |
Set mask to enable changes in DMS |
|
DTS_id? |
Y |
Y |
Y |
Y |
Y |
Get system information (query only) |
O S_rev1? |
Y |
Get details of operating system (query only) |
||||
O S_rev2? |
Y |
Get details of operating system (query only) |
||||
OS_rev? |
Y |
Y |
Y |
Y |
Y |
Get details of operating system (query only) |
mount |
Y |
Y |
Y |
Y |
Power bank on as if keyed on (command only, jive5ab > 2.8.1, see unmount) |
|
protect |
Y |
Y |
Y |
Y |
Set/remove erase protection for active module |
|
recover |
Y |
Y |
Y |
Y |
Recover record pointer which was reset abnormally during recording |
|
reset |
Y |
Y |
Y |
Y |
Reset Mark5 unit (command only) |
|
runtime |
Y |
Y |
Y |
Y |
Y |
Control multiple simultaneous transfer environments |
S S_rev1? |
Y |
Get StreamStor firmware/software revision levels (query only) |
||||
S S_rev2? |
Y |
Get StreamStor firmware/software revision levels (query only) |
||||
SS_rev? |
Y |
Y |
Y |
Y |
Get StreamStor firmware/software revision levels (query only) |
|
task_id |
Y |
Y |
Set task ID (primarily for correlator use) |
|||
unmount |
Y |
Y |
Y |
Y |
Power bank off as if keyed off (command only, jive5ab > 2.8.1) |
|
v ersion? |
Y |
Y |
Y |
Y |
Y |
Get detailed version information of this jive5ab (query only) |
Network Setup and monitoring
Avail ability: |
5 A |
5 I |
5 O |
5 C |
G |
|
|---|---|---|---|---|---|---|
ack |
Y |
Y |
Y |
Y |
Y |
Set UDP backtraffic acknowledge period (jive5ab > 2.7.3) |
evlbi |
Y |
Y |
Y |
Y |
Y |
Query e-VLBI UDP/UDT statistics (query only) |
ipd |
Y |
Y |
Y |
Y |
Y |
Set packet spacing/inter-packet delay |
net_port |
Y |
Y |
Y |
Y |
Y |
Set IPv4 port number for the data channel |
net_ protocol |
Y |
Y |
Y |
Y |
Y |
Set network data-transfer protocol |
mtu |
Y |
Y |
Y |
Y |
Y |
Set network Maximum Transmission Unit (packet) size |
Data Checking
A vailab ility: |
5 A |
5 I |
5 O |
5 C |
G |
|
|---|---|---|---|---|---|---|
data_ check? |
Y |
Y |
Y |
Y |
Check data starting at position of start-scan pointer (query only) |
|
file_ check? |
Y |
Y |
Y |
Y |
Y |
Check data between start and end of file (query only) |
scan_ check? |
Y |
Y |
Y |
Y |
Y |
Check data between start-scan and stop-scan pointers (query only) (G ≥ 2.6.2) |
sc an_set |
Y |
Y |
Y |
Y |
Y |
Set start- and stop-scan pointers for scan/data check and disk2* (G ≥ 2.7.0) |
track_ check? |
Y |
Check data on selected track (query only) |
||||
tra ck_set |
Y |
Select tracks for monitoring with DQA or ‘track_check’ |
System Setup and Monitoring
Availa bility: |
5 A |
5 I |
5 O |
5 C |
G |
|
|---|---|---|---|---|---|---|
1pps _source |
Y |
Select source of 1pps synchronization tick |
||||
cl ock_set |
Y |
Y |
Specify frequency and source of the CLOCK driving the DIM |
|||
disk_ serial? |
Y |
Y |
Y |
Y |
Return serial #s of all currently active disks (query only) |
|
dis k_size? |
Y |
Y |
Y |
Y |
Return individual size of all currently active disks (query only) |
|
DOT? |
Y |
Get DOT (Data Observe Time) clock information (query only) |
||||
DOT_inc |
Y |
Increment DOT clock |
||||
DOT_set |
Y |
Set DOT clock on next external 1pps tick |
||||
error? |
Y |
Y |
Y |
Y |
Y |
Get error number/message (query only) |
get _stats? |
Y |
Y |
Y |
Y |
Get disk performance statistics (query only) |
|
gr oup_def |
Y |
Manage aliases for groups of disks for use in set_disks= (jive5ab ≥ 2.7.0) |
||||
layout? |
Y |
Y |
Y |
Y |
Get current User Directory format (query only) |
|
mode |
Y |
Set data recording/readback mode/format (Mark5A) |
||||
mode |
Y |
Set data recording/readback mode/format (Mark5B/DIM) |
||||
mode |
Y |
Y |
Y |
Set data recording/readback mode/format (Mark5B/DOM, Mark5C, generic) |
||
packet |
Y |
Set/get packet acceptance criteria |
||||
pers onality |
Y |
Y |
Y |
Y |
Set/get personality (available on 5A, 5B since jive5ab ≥ 2.8) |
|
pl ay_rate |
Y |
Y |
Set playback data rate; set tvg rate |
|||
po inters? |
Y |
Y |
Y |
Get current value of record, start- and stop-scan pointers (query only) |
||
po sition? |
Y |
Y |
Get current value of record and play pointers (query only) |
|||
replace d_blks? |
Y |
Y |
Y |
Get number of replaced blocks on playback (query only) |
||
reset |
Y |
Y |
Y |
Y |
Reset Mark5 unit (command only) |
|
rtime |
Y |
Get remaining record time on current disk set (Mark5A) |
||||
rtime |
Y |
Y |
Get remaining record time on current disk set (Mark5B/DIM, Mark5C) |
|||
rtime |
Y |
Get remaining record time on current disk set (generic) (jive5ab ≥ 2.7.0) |
||||
se t_disks |
Y |
Select mount points to record on (FlexBuff/Mark6) (jive5ab ≥ 2.7.0) |
||||
star t_stats |
Y |
Y |
Y |
Y |
Start gathering disk-performance statistics |
|
status? |
Y |
Y |
Y |
Y |
Y |
Get system status (query only) |
tr ackmask |
Y |
Y |
Y |
Y |
Y |
Configure channel dropping setup |
tstat? |
Y |
Y |
Y |
Y |
Y |
Get current runtime status and performance |
vsn |
Y |
Y |
Y |
Y |
Write extended-VSN to permanent area |
Data Transfer, Record, Play
Note: data transfers can be monitored using “tstat?”
Avail ability: |
5 A |
5 I |
5 O |
5 C |
G |
|
|---|---|---|---|---|---|---|
da tastream |
Y |
Manage storing of VDIF frames in separate recordings (jive5ab ≥ 3.0.0) |
||||
d isk2file |
Y |
Y |
Y |
Y |
Y |
Transfer data between start- and stop-scan pointers to file (G ≥ 2.7.0) |
disk2net |
Y |
Y |
Y |
Y |
Y |
Transfer data between start- and stop-scan pointers to network (G ≥ 2.7.0) |
f ile2disk |
Y |
Y |
Y |
Y |
Transfer data from file to Mark5 disk pack |
|
file2net |
Y |
Y |
Y |
Y |
Y |
Transfer data from file on disk to network |
fi ll2net/f ill2file |
Y |
Y |
Y |
Y |
Y |
Transfer fill pattern from host to network or file on disk |
f ill2disk |
Y |
Y |
Y |
Y |
Record fill pattern to Mark5 disk pack (jive5ab ≥ 2.8) |
|
fill2vbs |
Y |
Record fill pattern to FlexBuff/Mark6 disks (jive5ab ≥ 2.8) |
||||
in2file |
Y |
Y |
Y |
Transfer data directly from Mark5 input to file on disk |
||
in2fork |
Y |
Y |
Y |
Duplicate data from Mark5 input to Mark5 disks and network |
||
in2mem |
Y |
Y |
Y |
Transfer data directly from Mark5 input to jive5ab internal buffer |
||
in 2memfork |
Y |
Y |
Y |
Duplicate data from Mark5 input to Mark5 disks and jive5ab internal buffer |
||
in2net |
Y |
Y |
Y |
Transfer data directly from Mark5 input to network |
||
mem2file |
Y |
Y |
Y |
Y |
Y |
Transfer data from jive5ab internal buffer to file on disk |
mem2net |
Y |
Y |
Y |
Y |
Y |
Transfer data from jive5ab internal buffer to network |
mem2time |
Y |
Y |
Y |
Y |
Y |
Decode data from jive5ab internal buffer into queryable time stamp |
net2disk |
Y |
Y |
Y |
Y |
Transfer data from network to Mark5 disk pack |
|
net2file |
Y |
Y |
Y |
Y |
Y |
Transfer data from network to file on disk |
net2mem |
Y |
Y |
Y |
Y |
Y |
Transfer data from network to file on disk |
net2out |
Y |
Transfer data from network to Mark5 output |
||||
play |
Y |
Play data from current play pointer position |
||||
record |
Y |
Y |
Y |
Turn recording on|off; set scan label |
||
record |
Y |
Turn recording on|off; set scan label;configure Mark6/FlexBuff setup |
||||
sp*2* |
Y |
Y |
Y |
Y |
Y |
Configure, start, stop corner turning: split [in/fill/net/file/disk/vbs] to [net/file] |