DBIA3499 ICR (3499)

Name

Value

NUMBER

3499

IA #

3499

DATE CREATED

2002/01/14

CUSTODIAL PACKAGE

ENROLLMENT APPLICATION SYSTEM

CUSTODIAL ISC

Albany

USAGE

Supported

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

EASMTCHK

NAME

DBIA3499

GENERAL DESCRIPTION

The purpose of this API is to facilitate the check for
a required means test for a veteran during appointment management.  A
deficiency noted in the "Report of Task Force to Review Enrollment, Means
Testing and Income Verification", item #22, required VHA to identify a means
to acquire veterans' signatures on means tests at a local level.  This API
provides a procedure that when called will check on a veteran means test
status and return a flag on whether a means test is required or not, and
optionally, a related text message that can be displayed by the calling
procedure.  This API is provided in the Enrollment Application Systems
namespace.

STATUS

Active

KEYWORDS

EAS
APPOINTMENT BLOCKING

DURATION

Till Otherwise Agreed

EASMTCHK

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

MT(DFN,EASAPT,EASACT,EASDT,EASQT,EASMSG)

The MT^EASMTCHK entry point returns a flag and alert
messgae if a means test update is required for the patient.  If a means test
update is not required, a "0" is returned.  The IEN in the PATIENT File, #2,
is passed into the call as variable DFN.  If DFN is not populated, the call
fails.   EASAPT is the IEN of the Appointment type in the APPOINTMENT TYPE
File, #409.1, and EASDT is the date of the appointment.  If the Appointment
type is not available, then the appointment date/time must be passed in.  When
the Appointment action flag is "C", the appointment date/time is used to
lookup the appointment and determine the appointment type for the MT status
determination.  Normally either the appointment type or the appointment
date/time will be available to the API.  If one or the other is not passed in,
the API will return "0".

VARIABLES	TYPE	VARIABLES DESCRIPTION
DFN	Input	Contains the Internal Entry Number of the patient in the PATIENT File, #2.
EASAPT	Input	Contains the Internal Entry Number of the appointment type from the APPOINTMENT TYPE, File #409.1. Current requirements are for action only on "Regular" type appointments.
EASACT	Input	Appointment action flag [Optional]. Used to specify the appointment action being taken. If not specified, a default of "Other" is used. Walk-In and Other appointment actions will not block an appointment action, and may be used for returning a MT status message. M - Make an appointment C - Check In/Out an existing appointment W - Unscheduled/Walk-In appointment O - Other (Default)
EASDT	Input	Appointment Date/Time in FileMan format. If the appointment type is not available, then the appointment date/time must be passed.
EASMSG	Input	Return array for alert message [Optional], if defined, the alert text is copied to the array. Can be used in conjunction with EASQT to control how and when alert messages are displayed.
RSLT	Output	Outputcontains the results: 1 - MT Required 0 - MT Not required
EASQT	Input	Silent flag [Optional], if set, prevents display of alert message.