DSUSE

GDDM V3R2 Base Application Programming Reference

DSUSE

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To specify device usage.


   DSUSE       (usage, device-id)

   APL code               903
   GDDM RCP code          X'0C000202' (201327106)

Parameters

usage (specified by user) (fullword integer)
The device usage code. Possible values are:

1: Current primary device
2: Current alternate device.

device-id (specified by user) (fullword integer)
The identifier of the device concerned.

Description

DSUSE activates a device, and specifies the usage that the application may make of the device. The device so activated becomes the one whose contents are manipulated by subsequent calls. For example, the current primary device is the one within which a page would be created if an FSPCRT call were issued.

These rules apply to DSUSE:

The device must already be open.
Any device currently operating with the required usage is dropped from that usage.
A device of any family can be used as the primary or alternate device. However, for family-4 alternate devices, a cell-based device token must be used.

Note: If you issue a function requiring a primary device to be in use, when no primary device is in use, then GDDM makes the default primary device the current primary device. (The default primary device is always given the device ID 0.) GDDM also makes the alternate device that has been opened by an FSOPEN call the current alternate device.

Principal errors

ADM0074 E: INVALID DEVICE IDENTIFIER
ADM0076 E: INVALID DEVICE USAGE
ADM0082 E: DEVICE DOES NOT EXIST

Notices | Terms of use | Support | Contact z/OS