| 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.
 
 |