Print Page as PDF
DBIA2119 ICR (2119)

DBIA2119    ICR (2119)

Name Value
NUMBER 2119
IA # 2119
DATE CREATED 1997/09/05
CUSTODIAL PACKAGE KERNEL
CUSTODIAL ISC San Francisco
USAGE Supported
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE %ZISUTL
NAME DBIA2119
GENERAL DESCRIPTION
Access to some device handler tools.
STATUS Active
ID %ZISUTL
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
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.