MAG DICOM ROUTE NEXT FILE

TITLEVALUE
NAMEMAG DICOM ROUTE NEXT FILE
DESCRIPTION +---------------------------------------------------------------+
| Property of the US Government. |
| No permission to copy or redistribute this software is given. |
| Use of unreleased versions of this software requires the user |
| to execute a written test agreement with the VistA Imaging |
| Development Office of the Department of Veterans Affairs, |
| telephone (301) 734-0100. |
| |
| The Food and Drug Administration classifies this software as |
| a medical device. As such, it may not be changed in any way. |
| Modifications to this software may result in an adulterated |
| medical device under 21CFR820, the use of which is considered |
| to be a violation of US Federal Statutes. |
+---------------------------------------------------------------+

The Routing Transmitter will continuously ask the VistA system
for the next file to transmit. This RPC will be called to obtain
the name of the next file to be transmitted.

This RPC returns information about the next image file to be
transmitted by a certain Routing Transmitter.

The next file to be transmitted is either the next file for
the current destination, or the next file with the highest
priority in any of the queues for the destinations that are
being served by the current transmitter.

If neither of the parameters DEST and PRIOR have a non-empty
value, information about the first file (if any) to be transmitted
will be returned.
TAGXMIT
ROUTINEMAGDRPC5
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERLOCATION
DESCRIPTIONThe value of this parameter is a pointer to ^DIC(4).
This pointer identifies the location at which images were acquired.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH30
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERDEST
DESCRIPTIONThe value of this parameter is a pointer to either ^MAG(2005.2)
or ^MAGDICOM(2006.585).
This pointer identifies the destination to which the images
are to be transmitted.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH30
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERPRIOR
DESCRIPTIONThe value of this parameter is an integer number (> 0).
This number establishes the priority of the new entry in its queue.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH30
INPUT PARAMETERSSEQUENCE NUMBER4
INPUT PARAMETERMECH
DESCRIPTIONThe value of this parameter is an integer value (1 or 2).
This number defines the mechanism that will be used to transmit
the images:
1 = standard copy
2 = DICOM copy
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH10
INPUT PARAMETERSSEQUENCE NUMBER5
INPUT PARAMETERDESTS
DESCRIPTIONThis parameter is an array containing the list of destinations
that is being served by the current transmitter.
The values in this array each are string with two pieces of data,
separated by a caret ("^").

The first piece describes the transmission mechanism:
1 = regular copy
2 = DICOM copy

The second piece is a pointer. When the first piece is equal
to 1, this pointer points to table # 2005.2 (Network Location);
when the first piece is equal to 2, this pointer points to
table # 2006.585 (User Application).
PARAMETER TYPELIST
REQUIREDYES
MAXIMUM DATA LENGTH
RETURN VALUE TYPEARRAY
RETURN PARAMETER DESCRIPTIONThe output parameter is an array.
The meaning of the various elements is:
OUT(1) = 0: all OK
2: no files to be transmitted for this image
3: cannot yet transmit, purge first
-1: No Location Specified
-2: No Valid Destinations Specified
If OUT(1) is equal to 0, the other elements are defined as:
OUT(2)=DEST
OUT(3)=PRIOR
OUT(4)=MECH
OUT(5)=logical name for destination
OUT(6)=physical name for destination
OUT(7)='from' file name
OUT(8)='to' file name
OUT(9)=D0 (^MAGQUEUE(2006.035))
AVAILABILITYRESTRICTED
INACTIVEACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION3.0
SUPPRESS RDV USER SETUPNo
APP PROXY ALLOWED