MAG SCAN IMAGE TEXT FILES (2726)    REMOTE PROCEDURE (8994)

Name Value
NAME MAG SCAN IMAGE TEXT FILES
TAG SCANIMG
ROUTINE MAGDOD01
RETURN VALUE TYPE SINGLE VALUE
AVAILABILITY RESTRICTED
INACTIVE ACTIVE
WORD WRAP ON FALSE
VERSION 3
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.                     |
 +---------------------------------------------------------------+
 
This Remote Procedure assists the client software in traversing
the IMAGE file (#2005)
The following sub-actions are supported:
  Init    - return information to the client about the
 | Property of the US Government.                                |
            current scan-status
  Restart - reset internal counters so that the next scan
            will re-scan the whole database
  Scan    - return the file-name for the next (or previous) image
 | 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
  • ACTION
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   15
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    The value of this parameter is a string. This string specifies
    the action to be taken by the Remote Procedure.
     
    Possible values are: Init, Restart and Scan.
    
  • IMAGE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   20
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    The value of this parameter is a pointer to the IMAGE file (#2005).
    If image=" " and DIR=-1, the last image in the database will be found.
    (In order to start a scan, the special values 9 (zero) and " " (space)
    are also permitted.)
     
    The value of this parameter indicates the image-number from which
    the Remote Procedure is to start its search for the next (or previous)
    image.
     
    If image=0 and DIR=1, the first image in the database will be found.
    
  • DIR
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   5
    REQUIRED:   NO
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    The value of this parameter is a number. If the value of this number
    is less than zero, the value -1 will be used. Otherwise, the value
    1 will be used.
     
    The value of this parameter is used in references to $ORDER to traverse
    the IMAGE file (#2005)
    
RETURN PARAMETER DESCRIPTION
The return value of this remote procedure is a string.
The third comma-separated piece will be one of the following values, 
indicating the proximity of the nearest version of the file:
   M:  magnetic
   W:  WORM (jukebox)
   A:  archive
   O:  offline
   I:  invalid/undeterminable
 
If the numeric interpretation of this string is a negative number,
the value will contain an error message.
 
Otherwise, the first comma-separated piece of the return value
will be the internal entry number of the image found.
The second comma-separated piece will either be the name of
the "text" file for that image, or a negative number.