OPEN(handle [,valiop] [,.valzis]) |
One of three functions that support using multiple
devices at the same time. OPEN^%ZISUTL returns all the same output variables
as the ^%ZIS entry point. OPEN^%ZISUTL serves as a "wrapper" arount the ^%ZIS
entry point, providing additional management of IO variables that ^%ZIS does
not (principally to support opening multiple devices simultaneously).
|
VARIABLES |
TYPE |
VARIABLES DESCRIPTION |
handle |
Input |
A unique free text name to associate with a device
you want to open.
|
valiop |
Input |
Output device specification, in the same format as
the IOP input variable for the %ZIS entry point. The one execption to this is
passing a value of null: this is like leaving IOP undefined. With %ZIS, on the
other hand, setting IOP to null specifies the home device. To request the home
device, pass a value of "HOME" instead.
|
valzis |
Input |
(optional) Input specification array, in the same
format (and with the same meanings) as the %ZIS input specification array for
the ^%ZIS entry point. Must be passed by reference. Please see the
documentation of the ^%ZIS function for more information.
|
|
CLOSE(handle) |
Use the CLOSE^%ZISUTL to close a device opened with
the OPEN^%ZISUTL function. When you close a device with CLOSE^%ZISUTL, the IO
variables are set back to the home device's and the home device is made the
current device.
|
VARIABLES |
TYPE |
VARIABLES DESCRIPTION |
handle |
Input |
The handle of a device opened with an OPEN^%ZISUTL
call.
|
|
SAVDEV(handle) |
Use SAVDEV^%ZISUTL to save the current device IO*
variables under the handle name.
|
VARIABLES |
TYPE |
VARIABLES DESCRIPTION |
handle |
Input |
A unique free text name to associate with a device
you want to use.
|
IO* |
Both |
The standard set of IO variables.
|
|
RMDEV(handle) |
This call deletes the data associated with the
handle. It doesn't change any of the IO* variables.
|
VARIABLES |
TYPE |
VARIABLES DESCRIPTION |
handle |
Input |
A unique free text name to associate with a device
you want to delete.
|
|
USE(handle) |
Use the USE^%ZISUTL to restore the variables save
with OPEN^%ZISUTL or SAVDEV^%ZISUTL. It then does a USE of the device if it
is open. The same a a DO USE^%ZISUTL(handle) U IO.
|
VARIABLES |
TYPE |
VARIABLES DESCRIPTION |
IO* |
Output |
Standard IO variables.
|
|