PRIMARY CARE INPUT AND OUTPUT API CALLS ICR (1252)

Name

Value

NUMBER

1252

IA #

1252

DATE CREATED

1995/06/20

CUSTODIAL PACKAGE

SCHEDULING

CUSTODIAL ISC

Albany

USAGE

Supported

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

SDUTL3

NAME

PRIMARY CARE INPUT AND OUTPUT API CALLS

GENERAL DESCRIPTION

SDUTL3 contains 2 input APIs and 3 output APIs which
allow enter of/return of the CURRENT PC PRACTITIONER and CURRENT PC TEAM.  The
three output APIs will continue to be supported.  The two input APIs will be
supported as long as the two fields exist in the patient file. The approximate
time for deletion of these fields is March 1 2000.

STATUS

Active

DURATION

Till Otherwise Agreed

SDUTL3

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

$$OUTPTPR(DFN[,SCDATE][,SCPCROLE])

Function: $$OUTPTPR^SDUTL3(DFN)
Input:    DFN - This is a required parameter that is the internal entry
number of the PATIENT file.
Output:   CURRENT PC PRACTITIONER in Internal^External format

Internal- If there is a successful lookup for the CURRENT
PC PRACTITIONER, this is a pointer to the NEW
PERSON file (#200).  If it is not successful, a
0 is returned.
External- If there is a successful lookup, this is the
practitioner's name, as entered in the NAME
field (#.01) of file #200.  If there is not a
successful lookup, this is null.

VARIABLES	TYPE	VARIABLES DESCRIPTION
DFN	Input	Internal entry of the PATIENT file (#2)
SCDATE	Input	Relevant Date (Default=DT)
SCPCROLE	Input	Type of PC Role (Default =1 (PC Practitioner),2=Attending)

$$OUTPTTM(DFN[,SCDATE][,ASSTYPE])

Output API for CURRENT PC TEAM field:
=====================================
Function: $$OUTPTTM^SDUTL3(DFN)
Input:    DFN - This is a required parameter that is the internal entry
number of the PATIENT file.
Output:   CURRENT PC TEAM in Internal^External format

Internal- If there is a successful lookup for the CURRENT
PC TEAM, this is a pointer to the TEAM file
(#404.51), which is distributed with this patch.  If
the lookup is not successful, a 0 is returned.
External- If there is a successful lookup, this is the
team's name, as entered in the NAME field (#.01)
of file #404.51.  If there is not a successful
lookup, this is null.

VARIABLES	TYPE	VARIABLES DESCRIPTION
DFN	Input	Internal entry of the PATIENT file (#2)
ASSTYPE	Input	Assignment Type (Default=1: PC Team)
SCDATE	Input	Date of interest (Default=DT)

INPTPR(DFN,PRACT)

Subroutine:  INPTPR^SDUTL3(DFN,PRACT)
Input:       DFN  - This is a required parameter that is the internal
entry number of the PATIENT file.
PRACT- This is a required parameter that is a pointer to
file #200 associated with the patient's primary care
practitioner.
Output:      SDOKS- This is 1 if the data is stored successfully, 0
otherwise.

VARIABLES	TYPE	VARIABLES DESCRIPTION
DFN	Input	Internal entry of the PATIENT file (#2)
PRACT	Input	Internal entry number of the NEW PERSON file (#200) denoting the practitioner assigned to the patient.
SDOKS	Output	1 if addition was successful or 0 if it was not.

INPTTM(DFN,TEAM)

Subroutine:  INPTTM^SDUTL3(DFN,TEAM)
Input:       DFN  - This is a required parameter that is the internal
entry number of the PATIENT file.
TEAM - This is a required parameter that is a pointer to
the TEAM file, which associate with this patient's
primary care team.
Output:      SDOKS- This is 1 if the data is stored successfully, 0
otherwise.

VARIABLES	TYPE	VARIABLES DESCRIPTION
DFN	Input	Internal entry of the PATIENT file (#2)
TEAM	Input	Then internal entry number of the TEAM file associated with the patient.
SDOKS	Output	1 if addition was successful or 0 if it was not.

$$OUTPTAP(DFN[,SCDATE])

Function:  $$OUTPTAP^SDUTL3(DFN) Input:     DFN -
This is a required parameter that is the internal entry
number of the PATIENT file.  Output:    CURRENT PC ASSOCIATE
PROVIDER in Internal^External format.
Internal - If there is a successfule lookup for the CURRENT PC
ASSOCIATE PROVIDER, this is a pointer to the PERSON
file (#200).  If it is not successful, a 0 is
returned.
External - If there is a successfule lookup, this is the
provider's name as entered in the field (#.01) of
file #200.  If there is not a successfule lookup,
this is null.

VARIABLES	TYPE	VARIABLES DESCRIPTION
DFN	Input	Internal entry of the PATIENT file (#2)
SCDATE	Input	Relevant Date (Default=DT)