SD OUTPATIENT GAF SCORE UTILS ICR (2590)

Name

Value

NUMBER

2590

IA #

2590

DATE CREATED

1998/09/30

CUSTODIAL PACKAGE

SCHEDULING

CUSTODIAL ISC

Albany

USAGE

Supported

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

SDUTL2

NAME

SD OUTPATIENT GAF SCORE UTILS

GENERAL DESCRIPTION

The purpose of these API's is to facilitate the entry
of Global Assessment of Function (GAF) scores to the Mental Health package
from outpatient encounters.  VHA Directive, 97-059, dated November 25, 1997,
"Instituting Global Assessment of Function (GAF) Scores in Axis V Mental
Health Patients", provides guidelines for the collection of these GAF scores.
These API's will be used to (1) return whether a new GAF score is required for
an outpatient and (2) whether the outpatient encounter clinic is a Mental
Health clinic for which GAF scores must be collected.  These API's have been
added to the routine: SDUTL2.

STATUS

Active

DURATION

Till Otherwise Agreed

SDUTL2

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

NEWGAF(DFN)

Entry point NEWGAF^SDUTL2(DFN) returns whether a GAF
score is required for a patient, and if one is required, returns the date of
the last score, the score, and the IEN of the provider who made the
determination.  The internal entry number is passed into the call as variable
DFN.  The determination and latest occurrence of the GAF data are then passed
back in the form of a concatenated string in the following format:
-1 : New GAF required and no previous data
1 : New GAF required and previous data, the second piece will contain
the previous GAF score, the third piece will contain the date of the score,
and the fourth piece will contain the IEN of the provider w determined the GAF
score.
0 : A new GAF is not required

VARIABLES	TYPE	VARIABLES DESCRIPTION
DFN	Input	Contains the Internal entry number of the patient in the PATIENT File, #2.
SDGAF	Output	Contains the results

MHCLIN(SDCL,SDSC)

Entry point MHCLIN^SDUTL2(SDCL,SDSC) returns whether
the clinic for the encounter is a mental health clinic or not.  The current
criterion for this determination is a stop code that starts with a "5",
excluding the following codes: 526, 527, 528, 530, 536, 537, 542, 546, 579.
Either a pointer to the HOSPITAL LOCATION File, #44, or a pointer to the
CLINIC STOP File, #40.7, must be passed into the call.  If neither is passed
in, the default result will be "0".  If the clinic or the clinics stop match
the criterion, the call will pass back a "1" to indicate a mental health
clinic, otherwise a "0" will be passed back.

VARIABLES	TYPE	VARIABLES DESCRIPTION
SDCL	Input	Contains the internal entry number of the clinic
SDSC	Input	Contains the internal entry number of the CLINIC STOP File, #40.7
SDMH	Output	Contains the results