IDLffDicomExCfg::Echo

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.

Table 3-21: String Array Elements Returned by a Successful Echo


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

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

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.