Print Page as PDF
DBIA4551 ICR (4551)

DBIA4551    ICR (4551)

Name Value
NUMBER 4551
IA # 4551
DATE CREATED 2004/12/14
CUSTODIAL PACKAGE PHARMACY DATA MANAGEMENT
CUSTODIAL ISC Birmingham
USAGE Supported
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE PSSDI
NAME DBIA4551
GENERAL DESCRIPTION
This DBIA is provided by PDM (Pharmacy Data Management)
as an API to do simulated VA FileMan calls. This API is to be used in the
future by all packages needing to use FileMan to look at PDM files as all the
Pharmacy packages are being re-engineered.
STATUS Active
DURATION Till Otherwise Agreed
ID PSSDI
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
['DIC(PSSFILE,PSSAPP,.DIC,.X,DLAYGO,PSSSCRDT,PSSSCRUS,PSSVA', 'CL)']
VARIABLES TYPE VARIABLES DESCRIPTION
PSSFILE Input
PSSFILE = File number used for validation of access
[required]
PSSAPP Input
PSSAPP = Name space of the calling application (ex:
PSJ for Inpatient Meds, PSO for Outpatient; PSSAPP is used to check if write
access is allowed) [optional]
.DIC Input
See VA FileMan Programmer Manual for ^DIC call, for
DIC, X, and DLAYGO input definitions
PSSSCRDT Input
PSSSCRDT = Inactivation Date. If the file has an
Inactivation Date, then any entry with an Inactivation Date on or before
PSNDATE will not be returned [optional]
PSSSCRUS Input
PSSSCRUS = APPLICATION PACKAGES' USE. This parameter
only applies when the file is the DRUG File (#50). PSSSCRUS should be passed
in the form of a String. If any of the characters in the PSSSCRUS String is
contained in the APPLICATION PACKAGES' USE Field (#63), then the entry will be
returned [optional]
PSSDIY Output
PSSDIY will return null if the values for PSSFILE and
PSSAPP are valid (it will return -1 if conditions were not met)

See VA FileMan Programmer Manual for DIC output definition

DLAYGO should only be passed in if the calling application has this type of
access through another Integration Agreement
PSSVACL Input
PSSVACL = An array containing VA CLASSES that the
user wants either included or excluded for the Drug lookup.

For example, if only drugs with a VA Class of DX201 & DX202 were to be
available for selection, the local variable array would look like this:

PSSVACL("DX201")="" PSSVACL("DX202")="" PSSVACL("R")="" - The "R" means only
drugs with these classes will be available for selection. If these classes
were to be excluded, the letter "P" would be used instead.

DO(PSSFILE,PSSAPP,.DIC)
Format: D DO^PSSDI(PSSFILE,PSSAPP,.DIC)
VARIABLES TYPE VARIABLES DESCRIPTION
PSSFILE Input
PSSFILE = File number used for validation of access
[required]
PSSAPP Input
PSSAPP = Name space of the calling application (ex:
PSJ for Inpatient Meds, PSO for Outpatient; PSSAPP is used to check if write
access is allowed) [optional]
.DIC Input
See VA FileMan Programmer Manual for DIC input
definition
PSSDIY Output
PSSDIY will return null if the values for PSSFILE and
PSSAPP are valid (it will return -1 if conditions were not met)

See VA FileMan Programmer Manual for DO^DIC1 output definition
['MIX(PSSFILE,PSSAPP,.DIC,D,.X,DLAYGO,PSSDATE,PSSUSAGE,PSSV', 'ACL)']
VARIABLES TYPE VARIABLES DESCRIPTION
PSSFILE Input
PSSFILE = File number used for validation of access
[required]
PSSAPP Input
PSSAPP = Name space of the calling application (ex:
PSJ for Inpatient Meds, PSO for Outpatient; PSSAPP is used to check if write
access is allowed) [optional]
.DIC Input
See VA FileMan Programmer Manual for MIX^DIC1 call,
for DIC, D, X, and DLAYGO input definitions
PSSDATE Input
PSSDATE = Inactivation Date. If the file has an
Inactivation Date, then any entry with an Inactivation Date on or before
PSNDATE will not be returned [optional]
PSSUSAGE Input
PSSUSAGE = APPLICATION PACKAGES' USE. This parameter
only applies when the file is the DRUG File (#50). PSSUSAGE should be passed
in the form of a String. If any of the characters in the PSSUSAGE String is
contained in the APPLICATION PACKAGES' USE Field (#63), then the entry will be
returned [optional]
PSSDIY Output
PSSDIY will return null if the values for PSSFILE and
PSSAPP are valid (it will return -1 if conditions were not met)

See VA FileMan Programmer Manual for MIX^DIC1 output definition

DLAYGO should only be passed in if the calling application has this type of
access through another Integration Agreement
PSSVACL Input
PSSVACL = An array containing VA CLASSES that the
user wants either included or excluded for the Drug lookup.

For example, if only drugs with a VA Class of DX201 & DX202 were to be
available for selection, the local variable array would look like this:

PSSVACL("DX201")="" PSSVACL("DX202")="" PSSVACL("R")="" - The "R" means only
drugs with these classes will be available for selection. If these classes
were to be excluded, the letter "P" would be used instead.

EN(PSSFILE,PSSAPP,DIC,.DR,.DA,.DIQ)
Format: D EN^PSSDI(PSSFILE,PSSAPP,DIC,.DR,.DA,.DIQ)
VARIABLES TYPE VARIABLES DESCRIPTION
PSSFILE Input
PSSFILE = File number used for validation of access
[required]
PSSAPP Input
PSSAPP = Name space of the calling application (ex:
PSJ for Inpatient Meds, PSO for Outpatient; PSSAPP is used to check if write
access is allowed) [optional]
DIC Input
See VA FileMan Programmer Manual for EN^DIQ1 call,
for DIC, DR, DA, and DIQ input definitions
PSSDIY Output
PSSDIY will return null if the values for PSSFILE and
PSSAPP are valid (it will return -1 if conditions were not met)

See VA FileMan Programmer Manual for EN^DIQ1 output definition
$$FNAME(PSSFNO,PSSFILE)
This component returns the field name of the
specified Pharmacy file for the field number and file number passed in.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSFNO Input
Field number [required]
PSSFILE Input
File number or sub-file number. This file must be a
file that is owned by a Pharmacy application [required]
$$FNAME Output
$$FNAME = the field name. If an invalid field number
or invalid file number is passed in, or the file number passed in is not a
file owned by a pharmacy application, null will be returned.