OBSERVATION API ICR (2664)

Name

Value

NUMBER

2664

IA #

2664

DATE CREATED

1998/12/24

CUSTODIAL PACKAGE

REGISTRATION

USAGE

Supported

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

DGPMOBS

NAME

OBSERVATION API

GENERAL DESCRIPTION

Routine DGPMOBS provides three entry points (MVT, PT,
and SPEC) to determine if a patient's treating specialty for a specified
movement or date/time is or was an observation specialty.

STATUS

Active

DURATION

Till Otherwise Agreed

DGPMOBS

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

$$MVT

$$MVT^DGPMOBS(IFN) returns the observation status
based on the treating specialty associated with a specified PATIENT MOVEMENT
(#405) file entry.

VARIABLES

TYPE

VARIABLES DESCRIPTION

IFN

Input

IFN = PATIENT MOVEMENT (#405) file internal entry
number.  (Required)

OBS

Output

If specialty associated with the specified PATIENT
MOVEMENT (#405) entry is an observation treating specialty, function call
returns:

1^FACILITY TREATING SPECIALTY (#45.7) file IEN^FACILITY TREATING SPECIALTY
(#45.7) file name^SPECIALTY (#42.4) file IEN^SPECIALTY (#42.4) file name

If specialty associated with the specified PATIENT MOVEMENT (#405) entry is
not an observation treating specialty, function call returns:

0^FACILITY TREATING SPECIALTY (#45.7) file IEN^FACILITY TREATING SPECIALTY
(#45.7) file name^SPECIALTY (#42.4) file IEN^SPECIALTY (#42.4) file name

If PATIENT MOVEMENT (#405) file internal entry number not defined or invalid,
function call returns:

-1^Error condition

$$PT

$$PT^DGPMOBS(DFN,MVTDT) returns the observation
status for a patient based on the treating specialty on a designated
date/time.  If no date/time is specified, the current date/time is used.

VARIABLES

TYPE

VARIABLES DESCRIPTION

DFN

Input

DFN = PATIENT (#2) file DFN (Required)

MVTDT

Input

MVTDT = File Manager date/time (Optional)  If
date/time not  defined, the current date/time will be used.

OBS

Output

If patient was in an observation treating specialty
on the designated date/time, function call returns:

1^FACILITY TREATING SPECIALTY (#45.7) file IEN^FACILITY TREATING SPECIALTY
(#45.7) file name^SPECIALTY (#42.4) file IEN^SPECIALTY (#42.4) file name

If patient was not in an observation treating specialty on the designated
date/time, function call returns:

0^FACILITY TREATING SPECIALTY (#45.7) file IEN^FACILITY TREATING SPECIALTY
(#45.7) file name^SPECIALTY (#42.4) file IEN^SPECIALTY (#42.4) file name

If PATIENT (#2) file internal entry number not defined or invalid, function
call returns:

-1^Error condition

$$SPEC

$$SPEC^DGPMOBS(SPIFN) determines if a SPECIALTY
(#42.4) file entry is an observation treating specialty.

VARIABLES	TYPE	VARIABLES DESCRIPTION
SPIFN	Input	SPIFN = SPECIALTY (#42.4) file internal entry number. (Required)
TX	Output	1 = Is an observation specialty 0 = Not an observation specialty -1^Error condition