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

%ZISUTL

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.