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
ID DGPMOBS
COMPONENT/ENTRY POINT
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
DBA Comments
9/26/16-MM:  VIA project team requested to use this API for
VIAB*1*8 and VIAB CURSPE RPC. Originally requested to be a subscriber for
OREVNTX1 CURSPE RPC.  This request was not approved by CPRS indicating they
are calling a Registration API and suggested writing a Registration call or
VIA RPC.

Verified CPRS is calling PT~DGPMOBS in VIAB CURSPE RPC routine OREVNTX1.

MAIL MESSAGE 31959340
Generated from SEP 05, 2018@ IA Listing Descriptions