DBIA2895 ICR (2895)

Name

Value

NUMBER

2895

IA #

2895

DATE CREATED

1999/08/19

CUSTODIAL PACKAGE

MENTAL HEALTH

CUSTODIAL ISC

Dallas

USAGE

Supported

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

YTAPI3

NAME

DBIA2895

STATUS

Active

DURATION

Till Otherwise Agreed

YTAPI3

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

SHOWIT

This API returns the text, bottom, introduction and
possible correct responses for a specified test item in MH INSTRUMENT file
(#601). It will work only for tests as opposed to interviews or batteries. The
ASI is not supported.

VARIABLES

TYPE

VARIABLES DESCRIPTION

CODE

Input

Test code from in the MH INSTRUMENT file (#601) (e.g.
"CAGE", "BDI")

ITEM

Input

A positive whole number between 1 and the highest
item number for the specified test.

YSDATA

Output

Array(1)=[DATA] ;indicates successful  call
Array(2)=MMPI2 item: 1 ;SECOND LINE IS TEST CODE AND ITEM NUMBER
Array(3)=[BEGIN ITEM]; BEGINS EACH ITEM Array(4)=MMPI2^1 ;CODE^ITEM NUMBER
Array(5)=[INTRO];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT
Array(12)=[TEXT];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT
Array(14)=[BOTTOM];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT
Array(18)=[RESPONSE] ];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT
Array(21)=[END ITEM]; ENDS EACH ITEM

Example: Input
-----
YS("CODE")="MMPI2" YS("ITEM")=1

Output
------
YSDATA(1)=[DATA] YSDATA(2)=[BEGIN ITEM] YSDATA(3)=MMPI2^1 YSDATA(4)=[INTRO]
YSDATA(5)=Please read each statement carefully and decide whether it is true
YSDATA(6)=as applied to you or false as applied to you.  YSDATA(7)=
YSDATA(8)=If a statement is true or mostly true, as applied to you, answer
'T'.  YSDATA(9)=If a statement is false or not usually true, as applied to
you, answer YSDATA(10)='F'.  YSDATA(11)= YSDATA(12)=Remember to give your own
opinion of yourself.  YSDATA(13)=[TEXT] YSDATA(14)=I like mechanics magazines.

YSDATA(15)=[BOTTOM] YSDATA(16)=T= True YSDATA(17)=F= False YSDATA(18)=Answer=
YSDATA(19)=[RESPONSE] YSDATA(20)=TFX YSDATA(21)=[END ITEM]

SHOWALL

This API returns the text, bottom, introduction and
possible correct responses for all items in a test in the MH INSTRUMENT file
(#601). It will work only for tests as opposed to interviews or batteries.
The ASI is not supported.

VARIABLES

TYPE

VARIABLES DESCRIPTION

CODE

Input

Test code from the MH INSTRUMENT file (#601). ( e.g.
"CAGE", "BDI")

YSDATA

Output

Array(1)=[DATA] ;indicates successful  call
Array(2)=MMPI2 item: 1 ;SECOND LINE IS TEST CODE AND ITEM NUMBER
Array(3)=[BEGIN ITEM]; BEGINS EACH ITEM Array(4)=MMPI2^1 ;CODE^ITEM NUMBER
Array(5)=[INTRO];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT
Array(12)=[TEXT];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT
Array(14)=[BOTTOM];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT
Array(18)=[RESPONSE] ];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT
Array(21)=[END ITEM]; ENDS EACH ITEM
.
.
.
Array(1003)=[BEGIN ITEM]; BEGINS EACH ITEM Array(1004)=MMPI2^567 ;CODE^ITEM
NUMBER Array(1005)=[INTRO];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT
Array(1012)=[TEXT];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT
Array(1014)=[BOTTOM];HEADER ALWAYS PRESENT OPTIONALY FOLLOWED BY TEXT
Array(1018)=[RESPONSE] ];HEADER ALWAYS PRESENT ALWAYS FOLLOWED BY TEXT
Array(1021)=[END ITEM]; ENDS EACH ITEM

Example: Input
-----
YS("CODE")="MMPI2" YS("ITEM")=1

Output
------
YSDATA(1)=[DATA] YSDATA(2)=[BEGIN ITEM] YSDATA(3)=MMPI2^1 YSDATA(4)=[INTRO]
YSDATA(5)=Please read each statement carefully and decide whether it is true
YSDATA(6)=as applied to you or false as applied to you.  YSDATA(7)=
YSDATA(8)=If a statement is true or mostly true, as applied to you, answer
'T'.  YSDATA(9)=If a statement is false or not usually true, as applied to
you, answer YSDATA(10)='F'.  YSDATA(11)= YSDATA(12)=Remember to give your own
opinion of yourself.  YSDATA(13)=[TEXT] YSDATA(14)=I like mechanics magazines.

YSDATA(15)=[BOTTOM] YSDATA(16)=T= True YSDATA(17)=F= False YSDATA(18)=Answer=
YSDATA(19)=[RESPONSE] YSDATA(20)=TFX YSDATA(21)=[END ITEM]
.
.
.
YSDATA(6950)=[BEGIN ITEM] YSDATA(6951)=MMPI2^567 YSDATA(6952)=[INTRO]
YSDATA(6953)=[TEXT] YSDATA(6954)=Most married couples don't show much
affection for each other.  YSDATA(6955)=[BOTTOM] YSDATA(6956)=T= True
YSDATA(6957)=F= False YSDATA(6958)=Answer= YSDATA(6959)=[RESPONSE]
YSDATA(6960)=TFX YSDATA(6961)=[END ITEM]