^%ZISC: Close Device

Reference Type: Supported, Category: Device Handler, ICR#: 10089

Description

The ^%ZISC API closes a device opened with a call to the ^%ZIS API and restores the home device.

Do not issue a form feed when calling ^%ZISC. The Device Handler takes care of issuing a form feed if necessary (i.e., if $Y>0, indicating the cursor or print head is not at the top of form). To prevent the Device Handler from issuing this form feed, as appropriate for continuous printing of labels, for example, define the IONOFF input variable before calling ^%ZISC.

Before the ^%ZISC API existed, close logic was executed with the command X ^%ZIS("C"). Developers have been advised that X ^%ZIS("C") is no longer supported and that the ^%ZISC API should be used instead. In the current version of Kernel, the ^%ZIS("C") node only holds a call to the ^%ZISC routine. Kernel versions beyond Kernel 8.0 will not export ^%ZIS("C").

Format

  ^%ZISC

Make sure to perform the following steps before calling this API:

1. NEW all non-namespaced variables.
   
   
2. Set all input variables.
   
   
3. Call the API.

Input Variables

Output Variables