IDLffDicomExCfg::Echo

Syntax | Return Value | Arguments | Keywords | Version History

The IDLffDicomExCfg::Echo function method lets you test the network connection to a remote machine that supports Query SCP or Storage SCP service types. See Returning Connection Status with Echo for additional information.

Syntax

Result = Obj->[IDLffDicomExCfg::]Echo(ApplicationEntityName [, COUNT=variable] )

Return Value

An array of strings containing the results of the echo. The number of elements and information returned depends on whether the echo succeeded.


Echo Succeeded: 
AE Name: (StorScp) 
AE Title: (IDL_STORE_SCP) 
Host Name: (10.17.2.59) 
IP Address: (10.17.2.59) 
TCP/IP Port: (104) 
Implementation Version: (MergeCOM3_321) 
Implementation Class UID: (2.16.840.1.114226) 

Table 3-21: String Array Elements Returned by a Successful Echo
	Contents	Example Value
0	Success value	Echo Succeeded:
1	Application Entity Name	AE Name: (StorScp)
2	Application Entity Title	AE Title: (IDL_STORE_SCP)
3	Host Name	Host Name: (10.17.2.59)
4	IP Address	IP Address: (10.17.2.59)
5	TCP/IP Port	TCP/IP Port: (104)
6	Implementation Version	Implementation Version: (MergeCOM3_321)
7	Implementation Class UID	Implementation Class UID: (2.16.840.1.114226)

Table 3-22: String Array Elements Returned by a Failed Echo
	Contents	Example Value
0	Success value	Echo Failed:
1	Application Entity Name	AE Name: (StorScp)
2	Application Entity Title	AE Title: (IDL_STORE_SCP)
3	Reason	Open Association Failed (Failed to connect to remote host)

Arguments

ApplicationEntityName

A string containing the name of a defined Application Entity.

Keywords

COUNT

Set this keyword equal to a named variable that will contain an integer representing the number of strings in the returned string array. COUNT will be 8 when the echo succeeds or 4 when the echo fails.

Version History


6.3	Introduced