|
|
CALL:DATA
Last updated: May 18, 2009
GPIB Command Conventions
CALL:DATA:PING[:ALL]?
|
Function |
This command returns the following results: packets transmitted, packets received, percent packets lost, minimum round trip time (in seconds), average round trip time (in seconds), maximum round trip time (in seconds).
This command will return 9.91 E+37 if the ping results are not available.
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:ALL?"
ENTER 714;Pxmit,Prcvd,Plost,Min_time,Avg_time,Max_time
|
CALL:DATA:PING:ICOunt?
|
Function
|
This command queries the value that is available when the query is received.
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:ICOUNT?"
|
CALL:DATA:PING:PACKets:RX?
|
Function |
This command queries the number of packets received from the device being tested or from the alternate device if
CALL:DATA:PING:SETup:DEVice
is set to ALTernate.
This command will return 9.91 E+37 if the ping results are not available.
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:PACKETS:RX?"
!Queries the number of packets received from the device being tested.
|
CALL:DATA:PING:PACKets:TX?
|
Function |
This queries the number of packets transmitted from the test set.
This command will return 9.91 E+37 if the ping results are not available.
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:PACKETS:TX?"
!Queries the number of packets transmitted from the test set.
|
CALL:DATA:PING:PLOSs?
|
Function
|
This command queries the percentage of packets lost during the ping session.
This command will return 9.91 E+37 if the ping results are not available.
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:PLOSS?" !Queries the percentage of lost packets.
|
CALL:DATA:PING:SETup:ALTernate:IP:ADDRess[:IP4]
|
Function
|
This sets/queries the alternate internet protocol (IP) address. This address will be used as the address to ping instead of the device under test if the
CALL:DATA:PING:SETup:DEVice
command is set to ALT and the
CALL:DATA:PING:SETup:PROTocol
is set to IP4.
|
|
Setting
|
Range: IPv4 address in dotted decimal format.
|
|
Query
|
Same as setting.
|
|
Requirements |
Lab Application Revision: A.01 and above
Lab Application Revision: C.00.08 and above, added [:IP4]
|
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:SETUP:ALTERNATE:IP:ADDRESS '192.168.16.57'"
|
CALL:DATA:PING:SETup:ALTernate:IP:ADDRess:IP6
|
Function
|
This sets/queries the Alternate internet protocol version 6(IPv6) pinging address. This address will be used as the alternate address to ping instead of the device under test if the
CALL:DATA:PING:SETup:DEVice
command is set to ALT and the
CALL:DATA:PING:SETup:PROTocol
command is set to IP6.
|
|
Setting
|
Range: 0 to 45 characters of an valid IPv6 address, this can be a normal 39- character IPv6 address, a zero compression IPv6 address or a up to 45-character IPv4 address-compatible address (see
IPv6 Address Requirements
). Rangs are from
-
"" (blank field) or
-
2000:0000:0000:0000:0000:0000:0000:0000 to 3FFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF or
-
FC00:0000:0000:0000:0000:0000:0000:0000 to FDFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF or
-
FE80:0000:0000:0000:0000:0000:0000:0000 to FEBF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF
|
|
Query
|
Range: "" (blank field) or 39 characters of IPv6 address with the format: AAAA:BBBB:CCCC:DDDD:EEEE:FFFF:GGGG:HHHH. Each of the A, B, ... H is an hex number ranging from 0 to F. |
|
*RST Setting
|
FE80:0000:0000:0000:0000:0000:0000:0001 |
|
Requirements |
Lab Application Revision: C.00.08 and above. |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:SETUP:ALTERNATE:IP:ADDRESS:IP6 '2009::146.208.232.220'"
Sets the alternate Ping6 Address to 2009::146.208.232.220.
OUTPUT 714;"CALL:DATA:PING:SETUP:ALTERNATE:IP:ADDRESS:IP6 'FE80::1'"
Sets the alternate Ping6 Address to FE80::1.
|
CALL:DATA:PING:SETup:COUNt
|
Function
|
This command set/queries the number of ping IP messages sent for each uninterrupted invocation of the
CALL:DATA:PING:STARt
command.
|
|
Setting
|
Range: 1 to 1000
|
|
Query
|
Range: 1 to 1000
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
*RST Setting
|
10 |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:SETUP:COUNT 20"
|
CALL:DATA:PING:SETup:DEVice
|
Function
|
This command sets/queries which device address is used in the ping IP packets, the address of the device under test, or the address of an alternate device.
|
|
Setting
|
Range: DUT|ALTernate
|
|
Query
|
Range: DUT|ALT
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
*RST Setting
|
DUT |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:SETUP:DEVice ALT"
|
CALL:DATA:PING:SETup:PACKet[:SIZE][:IP4]
|
Function
|
This command sets/queries the number of bytes sent by the test set in each ping packet when the
CALL:DATA:PING:SETup:PROTocol
command is set to IP4.
|
|
Setting
|
Range: 8 to 4076
Resolution: 1
|
|
Query
|
Same as setting |
|
Requirements |
Lab Application Revision: A.01 and above
Lab Application Revision: C.00.08 and above, added [:IP4]
|
|
*RST Setting
|
64 bytes |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:SETup:PACKet 10"
|
CALL:DATA:PING:SETup:PACKet[:SIZE]:IP6
|
Function
|
This command sets/queries the number of bytes sent by the test set in each ping packet with the
CALL:DATA:PING:SETup:PROTocol
command set to IP6.
|
|
Setting
|
Range: 9 to 8192
Resolution: 1
|
|
Query
|
Same as setting |
|
Requirements |
Lab Application Revision: C.00.08 and above |
|
*RST Setting
|
64 bytes |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:SETup:PACKet:IP6 10"
|
CALL:DATA:PING:SETup:PROTocol
|
Function
|
This command sets/queries the ping protocol to use when pinging the external device.
|
|
Setting
|
IP4 | IP6 |
|
Query
|
Same as setting |
|
Requirements |
Lab Application Revision: C.00.08 and above |
|
*RST Setting
|
IP4 |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:SETup:PROTocol IP4"
|
CALL:DATA:PING:SETup:TIMeout
|
Function
|
This command sets or queries how long the test set will wait before ending a ping session.
This command will return 9.91 E+37 if the ping results are not available.
|
|
Setting
|
Range: 1 to 100 seconds
|
|
Query
|
Range: 1 to 100 seconds
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
*RST Setting
|
5 seconds |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:SETUP:TIMEOUT 10"
|
CALL:DATA:PING:STARt
|
Function
|
This command starts a ping session.
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:START"
|
CALL:DATA:PING:STOP
|
Function
|
This command immediately stops a ping session. The ping results will not include counts for any ping message that has not yet received a response.
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:STOP"
|
CALL:DATA:PING:TIME[:AVERage]?
|
Function |
This command queries the average round trip time (in seconds) for a series of pings.
This command will return 9.91 E+37 if ping results are not available.
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:TIME:AVERAGE?"
|
CALL:DATA:PING:TIME:MAXimum?
|
Function
|
This command queries the maximum round trip time (in seconds) for a series of pings.
This command will return 9.91 E+37 if ping results are not available.
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:TIME:MAXIMUM?"
|
CALL:DATA:PING:TIME:MINimum?
|
Function
|
This command queries the minimum round trip time (in seconds).
This command will return 9.91 E+37 if ping results are not available.
|
|
Requirements |
Lab Application Revision: A.01 and above |
|
Programming Example
OUTPUT 714;"CALL:DATA:PING:TIME:MINIMUM?"
|
CALL:DATA:PDSNode:EXTernal:IP:ADDRess
|
Function
|
Sets/queries the IP address of external PDSN (MOB-IP-SIM). It will not take effect until the
CALL:DATA:PDSNode:EXTernal:STATe
is set to ON. See
External PDSN IP Address
for details.
This setting is stored in the nonvolatile RAM, and will not be changed by a reset or cycling power of the test set.
|
|
Setting
|
Range: 15 characters formatted as follows: A.B.C.D or "" (empty string)
The range of values for A = 0 to 126 and 128 to 223. The range of values for B,C, D = 0 to 255 (no embedded spaces).
("0.0.0.0", "0" or "" (an empty string) will set the external PDSN IP address to be undefined)
|
|
Query
|
Range: same as setting
|
|
*RST Setting
|
-
"" (empty string when shipped from the factory)
-
the value last set and stored in the nonvolatile RAM
|
|
Requirements
|
Lab Application Revision: A.01 and above
|
|
Programming Example
OUTPUT 714;"CALL:DATA:PDSNode:EXTernal:IP:ADDRess '130.29.179.220'"
!Sets the External PDSN IP Address to 130.29.179.220.
|
CALL:DATA:PDSNode:EXTernal:STATe
|
Function
|
Sets/queries whether to use the external PDSN simulator (MOB-IP-SIM) or the test set's internal PDSN simulation.
-
On - indicates using external PDSN simulator (MOB-IP-SIM)
-
Off - indicates using test set's internal PDSN
You must specify a valid IP address (
CALL:DATA:PDSNode:EXTernal:IP:ADDRess
) and a valid TCP port (
CALL:DATA:PDSNode:EXTernal:TCP:PORT
) for the external PDSN (MOB-IP-SIM) before changing the external PDSN state to on. See
External PDSN State
for details.
|
|
Setting
|
Range: 1|ON|0|OFF
|
|
Query
|
same as setting
|
|
*RST Setting
|
0 (OFF) |
|
Requirements
|
Lab Application Revision: A.01 and above
|
|
Programming Example
OUTPUT 714;"CALL:DATA:PDSNode:EXTernal:STATe ON"
!Sets to use the External PDSN.
|
CALL:DATA:PDSNode:EXTernal:TCP:PORT
|
Function
|
Sets/queries the TCP port of the external PDSN (MOB-IP-SIM). It will not take effect until the
CALL:DATA:PDSNode:EXTernal:STATe
is set to ON. See
External PDSN TCP Port
.
This setting is stored in nonvolatile RAM, and will not be changed by a reset or cycling power of the test set.
|
|
Setting
|
Range: 0 to 65535
Resolution: 1
|
|
Query
|
Range: same as setting
|
|
*RST Setting
|
-
53613 (when shipped from the factory)
-
the value last set and stored in the nonvolatile RAM
|
|
Requirements
|
Lab Application Revision: A.01 and above
|
|
Programming Example
OUTPUT 714;"CALL:DATA:PDSNode:EXTernal:TCP:PORT 53613"
!Sets the External PDSN TCP port to 53613.
|
CALL:DATA:PDSNode:EXTernal:TIMeout[:CONNect]
|
Function
|
Sets/queries the maximum amount of time the test set will wait to connect to the external PDSN (MOB-IP-SIM). It will not take effect until the
CALL:DATA:PDSNode:EXTernal:STATe
is set to ON. See
External PDSN Connect Timeout
for details.
This setting is stored in nonvolatile RAM, and will not be changed by a reset or cycling power of the test set.
|
|
Setting
|
Range: 1 to 19 seconds
Resolution: 1 second
|
|
Query
|
Range: same as setting
|
|
*RST Setting
|
-
2 (when shipped from the factory)
-
the value last set and stored in the nonvolatile RAM
|
|
Requirements
|
Lab Application Revision: A.01 and above
Lab Application Revision: A.02.10 and above, value range changed from 0 - 19 seconds to 1 - 19 seconds.
|
|
Programming Example
OUTPUT 714;"CALL:DATA:PDSNode:EXTernal:TIMeout 10S"
!Sets the External PDSN timeout to 10 seconds.
|
CALL:DATA:MIP:STATe
|
Function
|
Sets/queries whether to use the Internal Mobile IP.
-
On - indicates using the Internal Mobile IP
-
Off - indicates not using the Internal Mobile IP
|
|
Setting
|
Range: 1|ON|0|OFF
|
|
Query
|
same as setting
|
|
*RST Setting
|
0 (OFF) |
|
Requirements
|
Lab Application Revision: B.00 and above
|
|
Programming Example
OUTPUT 714;"CALL:DATA:MIP:STATe ON"
!Sets to use the Internal Mobile IP.
|
CALL:DATA:MIP:HAGent:SECRet
|
Function
|
This command sets or queries what is the secret key used at the Home Agent and Mobile.
|
|
Setting
|
Range: 0 to 32 hex char strings. The number of hex digits must be even number.
|
|
Query
|
same as setting
|
|
Requirements |
Lab Application Revision: B.00 and above |
|
*RST Setting
|
8960 |
|
Programming Example
OUTPUT 714;"CALL:DATA:MIP:HAGent:SECRet '0123456789ABCDEF'"
!Sets the secret key 0123456789ABCDEF.
|
|
|