DBIA3035-F ICR (3046)

Name

Value

NUMBER

3046

IA #

3046

DATE CREATED

2000/02/22

CUSTODIAL PACKAGE

PCE PATIENT CARE ENCOUNTER

CUSTODIAL ISC

Albany

USAGE

Supported

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

PXAAVPOV

NAME

DBIA3035-F

ORIGINAL NUMBER

3035

GENERAL DESCRIPTION

The following is a description of the available APIs
for the V POV (#9000010.07) file.  The V POV (#9000010.07) file is used to
store clinical data related to the "purpose of visit" or "problem of visit",
(POV).

STATUS

Active

KEYWORDS

PXAA

DURATION

Next Version

PXAAVPOV

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

$$GETIENS(VSITIEN,ARRAY)

Use this API to retrieve all Internal Entry Numbers
(IEN) from the V POV (#9000010.07) file associated with the given visit IEN,
VSITIEN.

VARIABLES

TYPE

VARIABLES DESCRIPTION

VSITIEN

Input

(required) This number represents the Internal Entry
Number for a given patient visit.

ARRAY

Input

(required) This array variable is populated by the
API with the Internal Entry Numbers of records found to be associated in the V
POV (#9000010.07) file with the patient visit IEN.

$$GETIENS

Output

Returns 0 if no record was found in the V POV
(#9000010.07) file for the given visit IEN.  Returns 1 if one or more records
were found in the V POV (#9000010.07) file for the given visit IEN.

$$LOADFLDS(IEN,ARRAY)

This API loads all the field values for a given
record IEN in the V POV (#9000010.07) file.

VARIABLES

TYPE

VARIABLES DESCRIPTION

IEN

Input

(required) This number represents the Internal Entry
Number for a record in the V POV (#9000010.07) file.

ARRAY

Input

(required) All the field values of the V POV
(#9000010.07) file for the given record IEN such as; Patient Name Provider
Narrative, Modifier, etc

$$LOADFLDS

Output

Returns 0 if no record was found in the V POV
(#9000010.07) file for the given patient IEN.  Returns 1 if the API has
successfully loaded all the field values into the ARRAY variable.

$$POV(IEN)

This API returns field (#.01) - PURPOSE OF VISIT, of
the V POV (#9000010.07) file.  A pointer to the ICD DIAGNOSIS (#80) file.

VARIABLES

TYPE

VARIABLES DESCRIPTION

IEN

Input

(required) This number represents the Internal Entry
Number for a record in the V POV (#9000010.07) file.

$$POV

Output

A pointer to the ICD DIAGNOSIS (#80) file which
indicates the ICD Diagnosis code or text for the problem treated at the
encounter.

$$PATINAME(IEN)

This API returns field (#.02) - PATIENT NAME, of the
V POV (#9000010.07) file.  A pointer to the PATIENT/IHS (#9000001) file.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$PATINAME	Output	A pointer to the PATIENT/IHS (#9000001) file.

$$VISIT(IEN)

This API returns field (#.03) - VISIT, of the V POV
(#9000010.07) file.  A pointer to the VISIT (#9000010) file.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$VISIT	Output	A pointer to the Visit (#9000010) file.

$$PROVNARR(IEN)

This API returns field (#.04) - PROVIDER NARRATIVE,
of the V POV (#9000010.07) file.  A pointer to the PROVIDER NARRATIVE
(#9999999.27) file indicating the providers text describing the diagnosis that
was treated at the visit.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$PROVNARR	Output	A pointer to the PROVIDER NARRATIVE (#9999999.27) file.

$$MODIFIER(IEN)

This API returns field (#.06) - MODIFIER, of the V
POV (#9000010.07) file.  This field indicates how the provider may modify the
diagnosis or problem treated to reflect the status of the diagnosis as of this
visit.

VARIABLES

TYPE

VARIABLES DESCRIPTION

IEN

Input

(required) This number represents the Internal Entry
Number for a record in the V POV (#9000010.07) file.

$$MODIFIER

Output

'C' - CONSIDER, 'D' - DOUBTFUL, 'F' - FOLLOW UP, 'M'
- MAYBE , POSSIBLE, PERHAPS, 'O' - RULE OUT, 'P' - PROBABLE, 'R' - RESOLVED,
'S' - SUSPECT, SUSPICIOUS, 'T' - STATUS POST

$$PRIMSECO(IEN)

This API returns field (#.12) - PRIMARY/SECONDARY, of
the V POV (#9000010.07) file.  This field represents the clinically pertinent
ranking of problems treated.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$PRIMSECO	Output	'P' - PRIMARY, 'S' - SECONDARY

$$DATEOFIN(IEN)

This API returns field (#.13) - DATE OF INJURY, of
the V POV (#9000010.07) file.  The date the injury occurred for the problem
being treated.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$DATEOFIN	Output	The date the injury occurred for the problem being treated.

$$CLINTERM(IEN)

This API returns field (#.15) - CLINICAL TERM of the
V POV (#9000010.07) file.  A pointer to the EXPRESSIONS (#757.01) file which
indicates the field in the clinical lexicon term which most closely represents
the provider narrative of the problem treated.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$CLINTERM	Output	A pointer to the EXPRESSIONS (#757.01) file.

$$PROLISEN(IEN)

This API returns field (#.16)  - PROBLEM LIST ENTRY,
of the V POV (#9000010.07) file.  A pointer to the PROBLEM (#9000011) file
which identifies the Problem List Entry related to the problem treated at the
visit.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$PROLISEN	Output	A pointer to the PROBLEM (#9000011) file.

$$EVENTDT(IEN)

This API returns field (#1201) - EVENT DATE AND TIME,
of the V POV (#9000010.07) file.  The date and time the problem was treated.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$EVENTDT	Output	The date and time the problem was treated.

$$ORDEPROV(IEN)

This API returns field (#1202) - ORDERING PROVIDER,
of the V POV (#9000010.07) file.  A pointer to the NEW PERSON (#200) file
identifying the provider who ordered the problem to be treated.

VARIABLES

TYPE

VARIABLES DESCRIPTION

IEN

Input

(required) This number represents the Internal Entry
Number for a record in the V POV (#9000010.07) file.

$$ORDEPROV

Output

A pointer to the NEW PERSON (#200) file identifying
the provider who ordered the problem to be treated.

$$ENCOPROV(IEN)

This API returns field (#1204) - ENCOUNTER PROVIDER,
of the V POV (#9000010.07) file.  A pointer to the NEW (#200) file identifying
the provider who treated the problem.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$ENCOPROV	Output	A pointer to the NEW PERSON (#200) file identifying the provider who treated the problem.

$$SERVCONN(IEN)

This API returns field (#80001) - SERVICE CONNECTED,
of the V POV (#9000010.07) file.  This field indicates whether the problem
treated was service connected.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$SERVCONN	Output	1 - YES, 0 - NO

$$AGEORAEX(IEN)

This API returns field (#80002) - AGENT ORANGE
EXPOSURE, of the V POV (#9000010.07) file.  This field indicates if the
problem treated is related to Agent Orange exposure.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$AGEORAEX	Output	1 - YES, 0 - NO

$$IONRADEX(IEN)

This API returns field (#80003) - IONIZING RADIATION
EXPOSURE, of the V POV (#9000010.07) file.  This field indicates if the
problem treated is related to Ionizing Radiation exposure.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$IONRADEX	Output	1 - YES, 0 - NO

$$PERGULEX(IEN)

This API returns field (#80003) - PERSIAN GULF
EXPOSURE, of the V POV (#9000010.07) file.  This field indicates if the
problem treated is related to Persian Gulf exposure.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$PERGULEX	Output	1 - YES, 0 - NO

$$EDITFLAG(IEN)

This API returns field (#80101) - EDITED FLAG, of the
V POV (#9000010.07) file.  This field indicates if PCE detects that any
original exam data is being edited.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$EDITFLAG	Output	Returns 1 if PCE detects that any original exam data is being edited.

$$AUDITRAI(IEN)

This API returns field (#80102) - AUDIT TRAIL, of the
V POV (#9000010.07) file.  This field is populated automatically by the PCE
filing logic. The format of the field is as follows:  Pointer to PCE data
source file_"-"_A for Add or E for Edit_" "_DUZ of the person who entered the
data_";"

VARIABLES

TYPE

VARIABLES DESCRIPTION

IEN

Input

(required) This number represents the Internal Entry
Number for a record in the V POV (#9000010.07) file.

$$AUDITRAI

Output

A Free Text value in the format; Pointer to PCE data
source file_"-"_A for Add or E for Edit_" "_DUZ of the person who entered the
data_";"

$$PRONARCA(IEN)

This API returns field (#80201) - PROVIDER NARRATIVE
CATEGORY, of the V POV (#9000010.07) file.  A pointer to the PROVIDER
NARRATIVE (#9999999.27) file indicating the category narrative related to the
problem treated.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$PRONARCA	Output	A pointer to the PROVIDER NARRATIVE (#9999999.27) file.

$$COMMENTS(IEN)

This API returns field (#81101) - COMMENTS, of the V
POV (#9000010.07) file.  Any comments related to the purpose of visit.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$COMMENTS	Output	A Free Text value indicating any comments related to the purpose of visit.

$$VERIFIED(IEN)

This API returns field (#81201) - VERIFIED, of the V
POV (#9000010.07) file.  This field indicates whether the record was
Electronically Signed or Verified by the Package.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$VERIFIED	Output	1 - Electronically Signed, 2 - Verified by the Package.

$$PACKAGE(IEN)

This API returns field (#81202) - PACKAGE, of the V
POV (#9000010.07) file.  A pointer to the Package (#9.4) file.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$PACKAGE	Output	Pointer to the Package (#9.4) file.

$$DATASRC(IEN)

This API returns field (#81203) - DATA SOURCE, of the
V POV (#9000010.07) file.  A pointer to the PCE Data Source (#839.7) file.

VARIABLES	TYPE	VARIABLES DESCRIPTION
IEN	Input	(required) This number represents the Internal Entry Number for a record in the V POV (#9000010.07) file.
$$DATASRC	Output	Pointer to the PCE Data Source (#839.7) file.

GOOD ONLY FOR VERSION

1.0