| DESCRIPTION OF ENHANCEMENTS |
Two new Psychological Testing APIs/RPCs have been developed to allow reading
Four new fields have been added to file MH MULTIPLE SCORING (#601.6).
Array(5)=R3^ Responses 401-600 undelimited
Array(6)=S1^Scale Name^Raw Score^Transformed Score
Array(7)=S2^ Scale Name^Raw Score^Transformed Score
.
.
And onward as needed
Array("ON")= output text
Example:
--------
The new fields are OUTCOMES (#5) and RESULTS (#6) a multiple containing
Input
-----
YSDATA(1)=[DATA]
YSDATA(2)=CAPP,ANDY W^MMPI2^--- ZUNG ---^2940509^05/09/1994^CAULFIELD,MARY A
YSDATA(3)="12121212121212121212"
YSDATA(4)=R2^
YSDATA(5)=R3^
YSDATA(6)=S1^Total^12^
YSDATA("ON")= A mood disorder screening test (ZUNG) was in the low range
(score = 12).
sub-fields RESULTS NUMBER (#.01), RESULTS DESCRIPTION (#1) and RESULTS
The text and decision criteria is stored in MH MULTIPLE SCORING file (#601.6)
field RESULTS (#6), sub-field RESULTS TEXT (#2).
Example of text to be stored:
Test Code Score Text
--------- ----- -----
AUDIT <8 An alcohol screening test (AUDIT) was negative
(score =|SCORE|).
>7 An alcohol screening test (AUDIT) was positive
(score =|SCORE|).
TEXT (#2).
AUDC <4 An alcohol screening test (AUDIT-C) was negative
(score =|SCORE|).
>3 An alcohol screening test (AUDIT-C) was positive
(score =|SCORE|).
BDI <10 The Beck Depression Inventory suggests minimal mood disorder
(score =|SCORE|).
10-16 The Beck Depression Inventory suggests mild mood disorder
(score =|SCORE|).
17-29 The Beck Depression Inventory suggests moderate mood disorder
(score =|SCORE|).
Four new routines YSMTI2, YSMTI6, YTAPI4 and YTAPI5.
>29 The Beck Depression Inventory suggests severe mood disorder
(score =|SCORE|).
CAGE <2 An alcohol screening test (CAGE) was negative
(score =|SCORE|).
>1 An alcohol screening test (CAGE) was positive
(score =|SCORE|).
DOM80 A mood disorder screening test (DOM80) was negative.
A mood disorder screening test (DOM80) was positive.
1. The DOM80 does not have a cut-off score. Rather, the
algorithm is:
One modified routine YTAPI2.
a. If Q1 returned = Y, then the test is positive.
b. If Q2 returned = Y and Q3 = Y and Q4 > 1, then the test
is positive.
c. If neither a nor b (above) is true, then the test is
negative.
DOMG <4 A mood disorder screening test (DOMG) was negative
(score =|SCORE|).
>3 A mood disorder screening test (DOMG) was positive
(score =|SCORE|).
MISS <107 This patient endorsed a significant number of items
Two new APIs and Remote Procedures YTAPI PREVIEW and YTAPI OUTNOTE.
associated with PTSD (MISS score =|SCORE|).
>106 This patient endorsed fewer items associated with PTSD
than is commonly found in Vietnam veterans diagnosed with
PTSD (MISS score =|SCORE|).
SMAST >2 Positive screen for alcoholism.
6 or 10 or 11 Previous treatment for alcoholism reported.
<3 Negative screen for alcoholism.
ZUNG <33 A mood disorder screening test (ZUNG) was in the low range
(score =|SCORE|).
33-50 A mood disorder screening test (ZUNG) was in the medium range
(score =|SCORE|).
>50 A mood disorder screening test (ZUNG) was in the high range
(score =|SCORE|).
Additional Information
----------------------
1. The AIMS progress note should have each item and each item response
included in the progress note. Below is an example progress note created
using an AIMS test from file MH INSTRUMENTS (#601). Note that the items are
separated by headings that are not in the item text, and that the first
Documentation for APIs and RPCs
5 lines contain the total score and the number of items rated mild, moderate
and severe.
Example of an AIMS note
-----------------------
The patient was evaluated for symptoms of tardive dyskinesia using the
AIMS.
Total score for items 1-7: 8
Number of items 1-7 rated "mild": 1
Number of items 1-7 rated "moderate": 1
-------------------------------
Number of items 1-7 rated "severe": 1
Facial and oral movements:
Muscles of facial expression Minimal
Lips and perioral area Minimal
Jaw None
Tongue Moderate
Extremity movements:
Upper (arms, wrists, hands, fingers) Mild
and saving of psychological testing data. This data normally resides in the
1. PREVIEW
Lower (legs, knees, ankles, toes) None
Trunk movements:
Neck, shoulders, hips Minimal
Global judgments:
Severity of abnormal movements Mild
RPC: YTAPI PREVIEW
NOIS Call(s): AMA-0200-70550
Test Site(s): Amarillo, TX
El Paso, TX
Fargo, ND
Grand Junction, CO
Huntington, WV
Miami, FL
Sheridan, WY
South Texas HCS
M: PREVIEW^YTAPI4
ST Louis, MO
Tampa, FL
West Palm Beach, FL
White River Junction, VT
ROUTINE SUMMARY:
================
The second line of the routine now looks like:
This API allows scoring of patient responses to a test or interview without
<tab> ;;5.01;MENTAL HEALTH;**[patch list]**;Dec 30, 1994
Checksum Values
Routine Name Before Patch After Patch Patch List
------------ ------------ ----------- -----------
YSMTI2 N/A 7197346 62
YSMTI6 N/A 550933 62
YTAPI2 6279046 6291220 53,62
making changes in the M database. The patient ien, the test code, and
YTAPI4 N/A 2425764 62
YTAPI5 N/A 3665995 62
Installation Instructions:
==========================
1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu.
This option will load the KIDS package in this message onto
your system.
administration date is required along with the responses. All responses are
2. The patch has now been loaded into a Transport global on your
system. You now need to use KIDS to install the Transport
global. On the KIDS menu, under the 'Installation' menu, use
the following options:
Print Transport Global
Compare Transport Global to Current System
Verify Checksums in Transport Global
Backup a Transport Global
checked for validity. Scoring is returned in the output documented in the
3. Installation of this patch should be at off peak hours.
4. Users may remain on the system.
5. Installation will take less than five minutes. Installation
of this patch requires no additional memory space.
6. From the 'Installation Menu' of the KIDS menu, run the option
'Install Package(s)' Select the package 'YS*5.01*62' and
proceed with install.
SCOREIT API.
7. When prompted 'Want KIDS to INHIBIT LOGONs during the
install? YES//', respond NO.
8. When prompted 'Want to DISABLE Scheduled Options, Menu
Options, and Protocols? YES//', respond NO.
Input:
PSYCH INSTRUMENT PATIENT file (#601.2) for patient responses and the
------
DFN: patient internal identifier
CODE: Test code from file 601 or "ASI" e.g. "CAGE", "BDI"
ADATE: inclusive administration date in %DT acceptable format (11/11/2011)
Staff: DUZ of professional ordering the test
R1: string of patient responses 1-200
R2: string of patient responses 201-400 [as needed]
R3: string of patient responses 401-600 [as needed]
Output:
MH INSTRUMENT file (#601) for test and interviews. In addition, the
-------
Array(2)= Patient Name^Test Code^Test Title^Internal Admin date^External
Admin Date ^Ordered by
Array(3)=R1^Responses 1-200 undelimited
Array(4)=R2^ Responses 201-400 undelimited (even if less than 200)
Array(5)=R3^ Responses 401-600 undelimited
Array(6)=S1^Scale Name^Raw Score^Transformed Score
Array(7)=S2^ Scale Name^Raw Score^Transformed Score
.
.
APIs/RPCs retrieve ADDICTION SEVERITY INDEX data found in the ADDICTION
And onward as needed
Example:
--------
Input
-----
YS("DFN")=6
YS("ADATE")="T"
YS("CODE")="ZUNG"
SEVERITY INDEX file (#604) and Global Assessment of Functioning (GAF) data
YS("STAFF")=67
YS("R1")="12121212121212121212"
Output
------
YSDATA(1)=[DATA]
YSDATA(2)=CAPP,ANDY W^MMPI2^--- ZUNG ---^2940509^05/09/1994^CAULFIELD,MARY A
YSDATA(3)="12121212121212121212"
YSDATA(4)=R2^
YSDATA(5)=R3^
found in the DIAGNOSTIC RESULTS - MENTAL HEALTH file (#627.8).
YSDATA(6)=S1^Total^12^
2. OUTNOTE
RPC: YTAPI OUTNOTE
M: OUTNOTE^YTAPI5
This API returns text to be entered in a progress note based on the outcome
of a test administration. Input is the output of SCOREIT or PREVIEW API.
Output adds this text to the output YSDATA.
Input:
------
Array(2)= Patient Name^Test Code^Test Title^Internal Admin date^External
Admin Date ^Ordered by
Array(3)=R1^Responses 1-200 undelimited
Array(4)=R2^ Responses 201-400 undelimited (even if less than 200)
Array(5)=R3^ Responses 401-600 undelimited
Array(6)=S1^Scale Name^Raw Score^Transformed Score
Array(7)=S2^ Scale Name^Raw Score^Transformed Score
This patch contains:
.
.
And onward as needed
Output:
-------
Array(2)= Patient Name^Test Code^Test Title^Internal Admin date^External
Admin Date ^Ordered by
Array(3)=R1^Responses 1-200 undelimited
Array(4)=R2^ Responses 201-400 undelimited (even if less than 200)
|
