Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


Harris Geospatial / Docs Center / IDL Reference / DICOM Toolkit / IDLffDicomExQuery::SetValue

IDLffDicomExQuery::SetValue

IDLffDicomExQuery::SetValue

The IDLffDicomExQuery::SetValue procedure method sets a tag value within a DICOM Network Service message request.

You should call the SetValue method after IDLffDicomExQuery::OpenFindRQ but before sending the message to the server.

For an example of using this method see IDLffDicomExQuery::OpenFindRQ.

Syntax


Obj.[IDLffDicomExQuery::]SetValue, MessageID, Tag [, Value] [, STATUS=variable]

Arguments


MessageID

Set this argument to an integer giving the message request ID that was returned from IDLffDicomExQuery::OpenFindRQ.

Tag

Set this argument to the desired DICOM group/element tag number. Tag can be specified either as a string or as a hexadecimal integer. For example, to return the value of DICOM tag 0020,1206 you would specify Tag as either "0020,1206" or 0x00201206.

Value

Set this optional argument to a scalar integer, a scalar floating point (single or double precision), a scalar string, or a string array.

Note: You should use a string array only for DICOM tags that allow multi-value, otherwise you should use a scalar string.

As an example of populating a cancel request:

oQuery.SetValue, requestID, '0000,0120', messageID
oQuery.SetValue, requestID, '0000,0800', 0x0101us

where messageID corresponds to a previous request ID (C_FIND_RQ) that has already been sent to the server. In this case a new request is created in order to request that the server cancels the previous request.

The Value argument is optional, and should be omitted when requesting that the server fill in information. For example:

oQuery.SetValue, requestID, '0020,1206'
oQuery.SetValue, requestID, '0020,1208'

When sent to the server, this will request that the server populate 0020,1206 and 0020,1208 in its reply.

Keywords


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.

Version History


8.6.1

Introduced

See Also


IDLffDicomExQuery::MC_Status, IDLffDicomExQuery::OpenFindRQ, IDLffDicomExQuery::Send



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us