DSDROP

GDDM V3R2 Base Application Programming Reference

DSDROP

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To discontinue device usage.


   DSDROP      (usage, device-id)

   APL code               904
   GDDM RCP code          X'0C000203' (201327107)

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

Indicates that a device is no longer to operate with the specified usage.

Unless it is also being used in another mode (for example, as both the primary and alternate device), the device now enters a state in which the only operations that can be performed against it are DSCLS, DSRNIT, DSQDEV, and DSUSE. Its resources are not, however, released, and its usage (together with all the contents, and so on, that existed at the time of the DSDROP) may subsequently be restored by means of a DSUSE call.

A device is automatically dropped when the application issues a DSUSE call for a different device.

Principal errors

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

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