DBIA2535 ICR (2535)

Name

Value

NUMBER

2535

IA #

2535

DATE CREATED

1998/09/08

CUSTODIAL PACKAGE

MENTAL HEALTH

CUSTODIAL ISC

Dallas

USAGE

Supported

TYPE

Routine

ROUTINE

YSGAF

NAME

DBIA2535

GENERAL DESCRIPTION

GAF API'S

The purpose of this patch is the creation of two API's for use with Mental
Health system's Global Assessment of Function (GAF) Scores.  The API's will be
used to (1) return the most recent GAF score and diagnosis date the score was
assessed and (2) store a new GAF score and date in the Diagnostics Results
file (627.8).  These two API's have been added to routine YSGAF.


10/30/13: The recently released Diagnostic and Statistical Manual of Mental
Disorders, Fifth Edition, abbreviated as DSM-5, eliminates the use of the
Global Assessment of Functioning (GAF) score. Starting with patch YS*5.01*108,
new GAF scores for patients will no longer be saved in the Mental Health
package. Historical data will continue to be available. The UPD call will set
the YSERR variable equal to 1 and write an informational message.

GLOBAL REFERENCE

FIELD NUMBER

YSD(627.8,D0,60)

FIELD NUMBER	ACCESS	FIELD DESCRIPTION	FIELD NAME	LOCATION
66	Both R/W w/Fileman	Patient Type indicates that the patient is either an 'I'n-Patient or 'O'ut-Patient.	Patient Type	60;4

STATUS

Active

DURATION

Till Otherwise Agreed

YSGAF

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

RET(YSX)

Entry point RET^YSGAF(YSX) returns the most recent
GAF score and diagnosis date.  The internal entry number is passed into the
call as variable YSX.  The latest occurrence of the GAF score and GAF date are
then passed back in the form of a concatenated string.  If there is no GAF
score entry then the API will pass back "-1" to indicate this situation.

VARIABLES	TYPE	VARIABLES DESCRIPTION
YSX	Input	Contains the internal entry number.
YSZ	Output	Contains the result.

UPD(YSPN,YSGN,YSGD,YSGC,YSPT)

Entry point UPD^YSGAF(YSPN,YSGN,YSGD,YSGC,YSPT) is
designed to store patient GAF score information in the DIAGNOSTIC RESULTS -
MENTAL HEALTH file (627.8).  The information passed into the call includes
patient name, GAF score (Axis 5), date/time of diagnosis, name of person
giving diagnosis and patient type.

VARIABLES	TYPE	VARIABLES DESCRIPTION
YSPN	Input	Patient name - Pointer to the patient name file (#2).
YSGN	Input	GAF score (Axis 5).
YSGD	Input	Date/Time of diagnosis.
YSGC	Input	Diagnosis by - Pointer to the new person file (#200).
YSPT	Input	Patient type - 'I'npatient or 'O'utpatient
YSERR	Output	The output variable will always be equal to one (i.e., YSERR=1) to indicate a new record was not created. An informational message will also be displayed to the user.