MAG4 PAT GET IMAGES

TITLEVALUE
NAMEMAG4 PAT GET IMAGES
DESCRIPTIONThis Remote Procedure Call is used to filter out those specialty for which
a given image category may be relevant.

When images are displayed, it is desirable to limit the list of presented
images to only those that are likely to be relevant in the current
context.

This procedure accepts a patient-IEN (DFN) and optionally also a category,
type, event and specialty.

This procedure will return a list of all images for that patient that
match the specified other input parameters.

NOTE: This remote procedure is kept for backward compatibility only.
Please use the MAG4 IMAGE LIST remote procedure for any new
development.
TAGPGI
ROUTINEMAGSIXG1
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERDFN
DESCRIPTIONThe value of this parameter is the IEN in the Patient File (#2)
of a patient.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH15
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERPKG
DESCRIPTIONInternal or external values of the PACKAGE INDEX field (40) of the file
#2005 separated by commas.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERCLASS
DESCRIPTIONImage class names or IENs (see the CLASS INDEX field (41) of the IMAGE
file (#2005) for details) separated by commas.
Image categories are defined in file 2005.82.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER4
INPUT PARAMETERTYPE
DESCRIPTIONImage type names or IENs (see the TYPE INDEX field (42) of the file #2005
for details) separated by commas.
Image types are defined in file 2005.83.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER5
INPUT PARAMETEREVENT
DESCRIPTIONProcedure/Event names or IENs (see the PROC/EVENT INDEX field (43) of the
file #2005 for details) separated by commas.
Image events are defined in file 2005.85.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER6
INPUT PARAMETERSPEC
DESCRIPTIONSpeciality/SubSpecialty names or IENs (see the SPEC/SUBSPEC INDEX field
(44) of the file #2005 for details) separated by commas.
Image specialties are defined in file 2005.84.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER7
INPUT PARAMETERFROMDATE
DESCRIPTIONBeginning of the date range for image selection. Dates can be in internal
or external FileMan format. If the parameter is not defined or empty, then
the date range remains open on this side.

The date range filter is applied to the exam/procedure dates
(PROCEDURE/EXAM DATE/TIME field (15)).
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER8
INPUT PARAMETERTODATE
DESCRIPTIONEnd of the date range for image selection. Dates can be in internal or
external FileMan format. If the parameter is not defined or empty, then
the date range remains open on this side.

The date range filter is applied to the exam/procedure dates
(PROCEDURE/EXAM DATE/TIME field (15)).
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER9
INPUT PARAMETERORIGIN
DESCRIPTIONInternal or external values of the ORIGIN INDEX field (45) of the file
#2005 separated by commas.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER10
INPUT PARAMETERDATA
DESCRIPTIONReserved for future use.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER11
INPUT PARAMETERFLAGS
DESCRIPTIONFlags that control the execution (can be combined):

D Include only deleted images (file #2005.1)
E Include only existing images (file #2005)

By default, the "E" value is assumed.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
RETURN VALUE TYPEARRAY
RETURN PARAMETER DESCRIPTIONZero value of the first '^'-piece of the Results[0] indicates that an
error occurred during the execution of the procedure. In this case, the
errors are returned in the Results array as shown below:

Results[0] Result descriptor
^01: 0
^02: Message

Results[i] Error descriptor
^01: Error code
^02: Message
^03: Error location
^04: Message type

Results[j] Line of the additional info (optional)
^01: ""
^02: Text

Otherwise, the Results array is formatted as follows:

Results[0] Result descriptor
^01: 1
^02: Description of the image selection
criteria (filter).

Results[1] '^'-delimited list of column headers used
in the cMagListView (see the HEADER^MAGSIX1
for details).

Results[i] Image descriptor
|01: Values to be displayed in the columns
separated by '^'. (see the
BLDHDR1^MAGSIXG2 for details).

|02: Data that is used internally by the
application (see the $$INFO^MAGGAII
for details).
AVAILABILITYRESTRICTED
INACTIVEACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION3
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED