MAG DICOM ROUTE LOCK TRANSMIT (1874)    REMOTE PROCEDURE (8994)

Name Value
NAME MAG DICOM ROUTE LOCK TRANSMIT
TAG LOCK
ROUTINE MAGDRPC5
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.                     |
 +---------------------------------------------------------------+
 
The various routing transmitters avoid that multiple transmitters
attempt to do the same task at the same time by LOCKing some
names of global variables. They will acquire and release these
LOCKs by calling this RPC.
 | Property of the US Government.                                |
 
This RPC will either attempt to LOCK a name, or release its
current LOCK on the name, depending on the value of input
parameter PLUSMIN. The other input parameters identify a
destination to which files are to be sent (D0) and the location
from which the files are being sent (LOCATION).
 | 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  |
INPUT PARAMETER
  • D0
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    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
    are to be transmitted.
    
  • LOCATION
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    The value of this parameter is a pointer to ^DIC(4).
    This pointer identifies the location at which images were acquired.
    
  • PLUSMIN
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   10
    REQUIRED:   YES
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    The value of this parameter is a number. When the value of this
    number is zero, this RPC will perform one (decremental) unLOCK;
    when the value of this number is nonzero, this RPC will attempt
    to perform one (incremental) LOCK with a time-out of zero seconds.
    
RETURN PARAMETER DESCRIPTION
The value of this parameter is an integer number.
Possible values are:
   0 = name could not be LOCKed
   1 = name was successfully LOCKed
   2 = name was successfully unLOCKed