MAG SCAN IMAGE TEXT FILES

TITLEVALUE
NAMEMAG SCAN IMAGE TEXT FILES
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. |
+---------------------------------------------------------------+

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
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
TAGSCANIMG
ROUTINEMAGDOD01
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERACTION
DESCRIPTIONThe 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.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH15

INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERIMAGE
DESCRIPTIONThe value of this parameter is a pointer to the IMAGE file (#2005).
(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.
If image=" " and DIR=-1, the last image in the database will be found.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH20

INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERDIR
DESCRIPTIONThe 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)
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH5

RETURN VALUE TYPESINGLE VALUE
RETURN PARAMETER DESCRIPTIONThe return value of this remote procedure is a string.

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.
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
AVAILABILITYRESTRICTED
INACTIVEACTIVE
CLIENT MANAGER
WORD WRAP ONFALSE
VERSION3
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED