MAG DICOM ROUTE LOG XMIT (1875)    REMOTE PROCEDURE (8994)

Name Value
NAME MAG DICOM ROUTE LOG XMIT
TAG LOGXIMG
ROUTINE MAGDRPC7
RETURN VALUE TYPE SINGLE VALUE
AVAILABILITY RESTRICTED
INACTIVE ACTIVE
CLIENT MANAGER 0
WORD WRAP ON TRUE
VERSION 3.0
SUPPRESS RDV USER SETUP No
DESCRIPTION
 +---------------------------------------------------------------+
 | 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.                     |
 +---------------------------------------------------------------+
 
When a file has been routed, information needs to be kept about
the fact that a copy has been made. In order to log this
information, the routing transmitter will call this RPC.
 
 | Property of the US Government.                                |
This RPC will take care of all logging of statistics that is
needed after a file has been transmitted. There are six input
parameters: the internal entry number of the queue entry (D0),
the internal entry number of the destination to which it was
transmitted (DEST) and the internal entry number of the location
from which it was transmitted (LOCATION). The input parameter
(STATUS) is equal to either "SENT" or "FAILED", depending on the
outcome of the transmission. The value of the input-parameter TO
is the name of the file at its destination (later to be used for
purging the file). The value of the parameter XMIT is the
 | No permission to copy or redistribute this software is given. |
timestamp of the start of the transmission.
 | 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  |
INPUT PARAMETER
  • QUEUE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   20
    REQUIRED:   NO
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    The value of this parameter is a pointer to ^MAGQUEUE(2006.035).
    This pointer identifies the queue-entry that caused the transmission.
    The value of this pointer will be used to retrieve the time-stamp
    when the entry was made into the queue and the internal entry number
    of the image involved.
    
  • DEST
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   64
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    The 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
    were to be transmitted.
    
  • LOCATION
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   YES
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    The value of this parameter is a pointer to ^DIC(4).
    This pointer identifies the location at which images were acquired.
    
  • STATUS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   YES
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    The value of this parameter is a string that identifies the
    new status of the current entry in the Transmission Queue.
    Possible values are "SENDING", "SENT" and "FAILED".
    
  • FILNAM
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   200
    REQUIRED:   YES
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    The value of this parameter is a string.
    This string value represents the name of the image file at its
    (remote) location.
    
  • XMIT
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   20
    REQUIRED:   NO
    SEQUENCE NUMBER:   6
    DESCRIPTION:   
    The value of this parameter is a (FileMan-formatted) date/time value.
    This value represents the time-stamp for the moment when the transmission
    of the image file started.
    
  • MECH
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   10
    REQUIRED:   NO
    SEQUENCE NUMBER:   7
    DESCRIPTION:   
    The 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
    
RETURN PARAMETER DESCRIPTION
The value of this parameter is an integer number.
Possible values:
  <0 when a log-entry could not be made
   1 when all log entries are made successfully