DBIA4514 ICR (4514)

Name

Value

NUMBER

4514

IA #

4514

DATE CREATED

2006/01/31

CUSTODIAL PACKAGE

MENTAL HEALTH

USAGE

Controlled Subscription

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

YTQAPI8

NAME

DBIA4514

GENERAL DESCRIPTION

This API is called to return the Mental Health scales,
raw scores and transformed scores associated with a specified entry from the
MH ADMINISTRATIONS file (#601.84) and the associated entry from the MH TESTS
AND SURVEYS file (#601.71) that was administered to the patient.

STATUS

Active

DURATION

Till Otherwise Agreed

YTQAPI8

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

GETSCORE(YSDATA,YS)

Use D GETSCORE^YTQAPI8(.YSDATA,.YS) to call the api.
A successful call of the api will return a temporary global array
(^TMP($J,"YSCOR",1)=[DATA]) followed by data that includes the Mental Health
scale name(s), raw score(s) and transformed score(s).

If an error occurs during processing of the input data the api will return a
temporary global array (^TMP($J,"YSCOR",1)=[ERROR] followed by an error
message (^TMP($J,"YSCOR",2)="Error message").

VARIABLES

TYPE

VARIABLES DESCRIPTION

Input

YS("AD") = Internal Entry Number of the MH
ADMINISTRATIONS file (#601.84)
Example
-------
S YS("AD")=94

YSDATA

Output

OUTPUT= SCALE NAME field (#3) of the MH SCALES file
(#601.87)=the calculated
raw score^the calculated transformed score

Example
-------
This example shows the scale names, raw scores and transformed scores for
the SCL9R (Symptom Checklist-90-Revised) instrument.
^TMP(543644718,"YSCOR",1)=[DATA]
2)=SOM;Somatization=2.83^72
3)=O-C;Obsessive-Compulsive=2.90^65
4)=I-S;Interpersonal-Sensitivity=2.78^64
5)=DEP;Depression=3.08^65
6)=ANX;Anxiety=2.80^67
7)=HOS;Hostility=2.83^66
8)=PHOB;Phobic Anxiety=2.71^71
9)=PAR;Paranoid Ideation=3.00^68
10)=PSY;Psychoticism=3.10^80
11)=ADD;Additional Items=2.57^
12)=GSI;Global Severity Index=2.88^76
13)=PSDI;Positive Symptom Distress Index=2.88^63
14)=PST;Positive Symptom Total=90^80
This example shows the scale name and raw score for the AUDC (Alcohol
Use Disorders Identification Test Condensed)
^TMP(545524790,"YSCOR",1)=[DATA]
2)=Total=6^

SUBSCRIBING PACKAGE

HEALTH SUMMARY