PRSN NURS LOCATION EXTRACTION (2934)    REMOTE PROCEDURE (8994)

Name Value
NAME PRSN NURS LOCATION EXTRACTION
TAG NURSLOC
ROUTINE PRSN9A
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY AGREEMENT
INACTIVE ACTIVE
WORD WRAP ON TRUE
DESCRIPTION
VANOD shall have the ability to extract data from the Nursing Location 
Parameter 1:
The date is in format 'YYYYMMDD' is optional. If there is no
date then the defult date will be 'TODAY'. The Nursing Location output
provided in this RPC shall only include data for locations that are active
in any one of the day # of the Pay Period of the parameter date. If the
current date is between day 1 and day 11 of the pay period, the Nursing
Locations RPC shall return locations that were active for the prior pay
period with the data that currently resides in the NURS LOCATION file
(211.4).  If the current date is between day 12 and day 14 of the pay
period the Nursing Locations RPC shall return locations that are active
(file # 211.4).
for the current pay period with the data that currently resides in the
NURS LOCATION file (211.4).
 
For inpatient settings the location data can be used by VANOD as a map 
between nurse POC data and the patients for whom they provide care.  For 
other care settings the location data can be used to report an activity.
 
Input Parameter
 
INPUT PARAMETER
  • PRSNDT
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   15
    REQUIRED:   NO
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    The PRSNDT is, in date format 'YYYYMMDD', for extracting all NURS
    LOCATIONS and their assocated Wards in File #211.4 that is active in any
    one of the Day# (1-14) of the Pay Period of the PRSNDT.
    
RETURN PARAMETER DESCRIPTION
The PEV RPC shall provide a VistA temporary global array of records with 
^       1       Site Name (STATION NUMBER) of VistA Database
^       2       Total Number of Records Extracted
 
Data Nodes
 
The output shall be an array of records indexed by sequence number 
beginning at 1.  Each record is a delimited literal string defined as 
follows:
 
Delimiter       Piece # Data Description
the name provided with the input parameter 1.
^       1       IEN of Nurse Location File #211.4
^       2       Record Type: L for Location, W for MAS Ward
^       3       IEN of Hospital Location File #44
^       4       Hospital Location Name
^       5       DIVISION (INSTITUTION FILE #4 IEN as defined in the 
                computed expression in .02 field of file 211.4)
^       6       INSTITUTION FILE NAME
^       7       Care Setting (I=inpatient/O=other)
^       8       Pt. Pop (VANOD Unit Type)
^       9       IEN of MAS Ward File (#42)
 
^       10      MAS Ward Name
^       11      DSS Department
^       12      Site Name (STATION NUMBER) of VistA Database
Header Node
This global array shall have a header node with index 0.  The header node 
is a literal string with delimiter '^'.  Data returned in the header node 
is defined as follows:
 
Delimiter       Piece # Data Description