| DESCRIPTION OF ENHANCEMENTS |
This patch enhances the functionality of PSODI, PSO59, and PSO52EX.
PSOFLAGS: CONTROLS THE PROCESSING OF DATA RETURNED [OPTIONAL]
PSOWORD: RETURN OF WORD PROCESSING FIELDS [REQUIRED only with word
processing fields]
If a file access error is encountered, the calling application will have
"0^FILE ACCESS ERROR" returned. If a FileMan error has occurred, the
calling application will have "0^FILEMAN UNABLE TO PROCESS REQUEST"
returned. A successful data retrieval will return in the format "1^(FIELD
DATA)". When retrieving data from a word processing field, an array name
must be passed in to PSOWORD. Once the word processing field is returned,
it will then populate an array as defined by PSOWORD and the calling
application will have "1^(PSOWORD)" returned. If there is no data in the
Word Processing field, the calling application will have "1^" returned,
and the array defined by PSOWORD will be empty.
Please see the VA FileMan Programmer Manual V. 22.0 for $$GET1^DIQ input
definitions and DBIA 4858 for further description.
PSO59 retrieves data from the OUTPATIENT SITE file (#59) and has three
parameters: PSOIEN (optional), PSOTXT (optional), and LIST (required).
PSODI contains a new Application Programmer Interface (API) named GET1.
While PSOIEN and PSOTXT are both labeled as optional, PSO59 requires that
either parameter be passed in or no data will be returned. PSOIEN is the
internal entry number (IEN) of a site, PSOTXT is a free text entry that
works as a search parameter, and LIST is the subscript name used in the
^TMP global. The new functionality now allows the user to pass in "??" to
retrieve all divisions in the file and subscripts them accordingly. If
both an IEN and "??" are passed in, PSO59 will ignore the "??" and return
data specific to the IEN.
Please refer to DBIA 4827 for further description on PSO59.
This API will invoke the $$GET1^DIQ FileMan Database Server (DBS) call and
PSO52EX contains a new Application Programmer Interface (API) named
ARXREF. This API is to be used as an extrinsic function call and requires
three parameters: PSODATE, PSOIEN, and PSOFILL. PSODATE is the RELEASED
DATE/TIME field (#31) and PSOIEN is the internal entry number from the
PRESCRIPTION file (#52). PSOFILL is the fill number of prescription (0
for Original Fill, 1 for Refill #1, 2 for Refill #2, etc.). The user can
set a local variable equal to the return value of ARXREF. If the return
value equals:
is to be used as an extrinsic function. GET1 has five parameters:
0 (zero) = Data does not exist in the "AR" cross reference, indicating
the fill was not dispensed from the Consolidated Mail Outpatient
Pharmacy (CMOP).
1 (one) = Data does exist in the "AR" cross reference, indicating the
fill was dispensed from the CMOP.
Please refer to DBIA 4902 for further description on PSO52EX.
PSOFILE: FILE OR SUBFILE NUMBER TO RETRIEVE DATA FROM [REQUIRED]
PSOIEN: IEN TO RETRIEVE DATA FROM [REQUIRED]
PSOFIELD: FIELD TO RETRIEVE DATA FROM [REQUIRED]
|
