Description:
Display the DTMF gpi history buffer contents, most recent time of gpi arrival, oldest time of
gpi arrival, or clear the contents of a buffer. If no argument is given, then all buffers will
be displayed. If the input channel is given the contents of only that buffer or time will be
displayed.
If only the CHANNEL number is given the buffer will be displayed for the given CHANNEL.
To get an ARGUMENT the CHANNEL must be given. When clearing a buffer the CHANNEL must be given.
Form:
Command Handler: DPID
GPIHISTORY|GHS|GH [CHANNEL] [ARGUMENT] [VALUE]
Argument List:
Terse Verbose Description
NONE TIMENEW Get arrival time of most recent gpi to DTMF board in buffer.
NONE TIMEOLD Get arrival time of oldest gpi to DTMF board in buffer.
NONE CLEAR Clear contents of buffer to empty or fill with certain character [VALUE].
(valid values are ASCII characters)
Response:
MODIFY GPIHISTORY RESPONSE
Verbose- "OK\r\n" to acknowledge receipt of command, or
"ERROR- [Description]\r\n" if error, ending command
Terse- "0\r\n" to acknowledge receipt of command, or
"[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
"\r\n" concludes modify responses (empty line)
DISPLAY GPIHISTORY RESPONSE
Verbose- "OK\r\n" to acknowledge receipt of command, followed by
"[ARGUMENT] = [VALUE]\r\n", or
"ERROR- [Description]\r\n" if error, ending command
Terse- "0\r\n" to acknowledge receipt of command, followed by
"[TERSE NUMERIC VALUE]\r\n", or
"[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
"\r\n" concludes display responses (empty line)
Examples:
Verbose command to retrieve all buffers:
*.DPID GPIHISTORY <enter>
Response is: OK\r\n
Assigned Input = 1\r\n
Gpi Buffer = *658#658\r\n
\r\n
{etc...}\r\n
Terse command to retrieve all current settings:
*.DPID TH <enter>
Response is: 0\r\n
1 *658#658\r\n
{etc...}\r\n
Verbose command to retrieve buffer contents for a given CHANNEL:
*.DPID GPIHISTORY <CHANNEL> <enter>
Response is: OK\r\n
Assigned Input = 1\r\n
Gpi Buffer = *658#658\r\n
\r\n
Terse command to retrieve all current settings for a given CHANNEL:
*.DPID TH <CHANNEL> <enter>
Response is: 0\r\n
1 *658#658\r\n
\r\n
Verbose command to retrieve most recent time of last gpi to arrive in buffer for a given CHANNEL:
*.DPID GPIHISTORY <CHANNEL> TIMENEW <enter>
Response is: OK\r\n
Time Newest = 12345\r\n
\r\n
Terse command to retrieve most recent time of last gpi to arrive in buffer for a given CHANNEL:
*.DPID TH <CHANNEL> TIMENEW <enter>
Response is: 0\r\n
12345\r\n
\r\n
Verbose command to retrieve time of oldest gpi to arrive in buffer for a given CHANNEL:
*.DPID GPIHISTORY <CHANNEL> TIMEOLD <enter>
Response is: OK\r\n
Time Oldest = 12345\r\n
\r\n
Terse command to retrieve time of oldest gpi to arrive in buffer for a given CHANNEL:
*.DPID TH <CHANNEL> TIMEOLD <enter>
Response is: 0\r\n
12345\r\n
\r\n
Verbose command to clear buffer contents for given CHANNEL:
*.DPID GPIHISTORY <CHANNEL> CLEAR <enter>
Response is: OK\r\n
\r\n
Terse command to clear buffer contents for given CHANNEL:
*.DPID TH <CHANNEL> CLEAR <enter>
Response is: 0\r\n
0\r\n
Verbose command to clear and fill buffer contents with a character VALUE for given CHANNEL:
*.DPID GPIHISTORY <CHANNEL> CLEAR <VALUE> <enter>
Response is: OK\r\n
\r\n
Terse command to clear and fill buffer contents with a character VALUE for given CHANNEL:
*.DPID TH <CHANNEL> CLEAR <VALUE> <enter>
Response is: 0\r\n
0\r\n
Notes: