IDLffDicomExQuery::Read

The IDLffDicomExQuery::Read function method reads content that has been received from a DICOM server.

Example

For an example of setting up the configuration and query properties, see IDLffDicomExQuery::Query.

oQuery = IDLffDicomExQuery()

oQuery.SetProperty, QUERY_SCP = 'remote_qr_scp_aen'

reqID = oQuery.OpenFindRQ('STUDY_ROOT_QR_FIND')

oQuery.SetValue, reqID, '0008,0052', 'SERIES'

assocID = oQuery.Send(reqID, STATUS=status)

reqID = oQuery.Read(assocID, STATUS=status)

value = oQuery.GetValue(reqID, '0020,1206')

oQuery.Close, assocID

oQuery.FreeMessage, reqID

Syntax

Result = Obj.[IDLffDicomExQuery::]Read( AssociationID [, COMMAND=variable] [, SERVICENAME=variable] [, STATUS=variable] [, TIMEOUT=value] )

Return Value

This method returns a scalar integer giving the message ID for the content received from the server, or !NULL if no content is available in the specified timeout.

Arguments

AssociationID

Set this argument to an integer giving the association ID from a previous call to IDLffDicomExQuery::Send.

Keywords

COMMAND

Set this keyword to a named variable to return the command associated with the message.

SERVICENAME

Set this keyword to a named variable to return the service name associated with the message.

STATUS

Set this keyword to a named variable in which the status code for the operation will be returned. If STATUS is not specified then any error messages will be output to the screen and IDL will halt execution.

Tip: The status code can be converted to a human-readable string using the IDLffDicomExQuery::MC_Status method.

TIMEOUT

Set this to the maximum number of milliseconds to wait for incoming content from the server. The default is 3000 (3 seconds).

Version History

8.6.1

Introduced