Use of DOLRO~ZOSV by VistA HL7 Application Developers ICR (3883)

Name

Value

NUMBER

3883

IA #

3883

DATE CREATED

2003/01/28

CUSTODIAL PACKAGE

KERNEL

CUSTODIAL ISC

San Francisco

USAGE

Controlled Subscription

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

%ZOSV

NAME

Use of DOLRO~ZOSV by VistA HL7 Application Developers

GENERAL DESCRIPTION

Patch HL*1.6*93 allows application developers to modify
four routing- related fields in the MSH segment of HL7 messages.  There are
two ways these changes can be made:

(1) Calling GENERATE^HLMA or DIRECT^HLMA with the string literal value to
be used for the routing-related fields, or

(2) Call GENERATE^HLMA or DIRECT^HLMA and specify M code to evaluate the
environment and make changes to specified (and a limited number of)
local variables.

Even though the M code called by the new HL*1.6*93 software can only make a
limited number of changes to local variables, evaluation of the total local
variable environment is extremely important.

The DOLRO^%ZOSV API has been built into the current HL7 software to make it
easier for application developers to perform the necessary evaluation and
actions.

STATUS

Active

DURATION

Till Otherwise Agreed

%ZOSV

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

DOLRO

The DOLRO^%ZOSV stores all local variables in the
global storage location specified by the variable X.

VARIABLES

TYPE

VARIABLES DESCRIPTION

Input

When X is set to an open global reference, (like
'^XTMP("ZZHL",25,'), all local variables existent when DOLRO^%ZOSV is called
are stored in the location specified by the open global reference.  These
variables, now stored in the X-specified global location, may be listed and
examined by application developers.

SUBSCRIBING PACKAGE

ISC

SUBSCRIBING DETAILS

HEALTH LEVEL SEVEN

Oakland

The DOLRO^%ZOSV API is used by application developers
during the initial development phase of their software.  This API is used to
"discover" and display all local variables.  These local variables are then
used to determine actions to take.

ORDER ENTRY/RESULTS REPORTING

VISTA SERVICES ASSEMBLER