DSQDEV

GDDM V3R2 Base Application Programming Reference

DSQDEV

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To query device characteristics.

DSQDEV (device-id, device-token, procopt-count, procopt-list, name-count, name-list, char-count, char-list)

APL code 907 GDDM RCP code X'0C000206' (201327110)

Parameters

device-id (specified by user) (fullword integer)
The identifier of the device whose characteristics are required.

device-token (returned by GDDM) (8-byte character string)
This parameter indicates the source of GDDM's information about the device properties. It can take the following values:

'* '-- GDDM-determined device properties from subsystem tables, the device itself, from GDDM's own defaults, or from both as appropriate.
The name of a device definition that is part of the ADMLSYSn table (where n is 1, 3, 4, or A).

procopt-count (specified by user) (fullword integer)
The number of fullwords in procopt-list. Zero can be specified to indicate that the procopt-list is empty and is not to be returned.

procopt-list (returned by GDDM) (an array of fullword integers)
In this list, GDDM returns the processing option groups that are applicable to the particular device's family, and to the environment in which GDDM is operating. (Plotter processing options are returned for plotters only.) Each option group consists of several contiguous fullwords, the first of which is a code identifying the particular option. The list is padded with zeros, if necessary. If the procopt-count value is too small, a processing option group may be truncated. For variable-length "mergeable" groups only (groups 4 and 20), the embedded count is modified appropriately.

For information on processing option groups, and the families and environments to which they apply, refer to "Processing options" in topic 19.0.

name-count (specified by user) (fullword integer)
The number of 8-byte tokens in name-list. Zero can be specified to indicate that name-list is empty and is not to be returned.

name-list (returned by GDDM) (array of 8-byte character tokens)
The name by which the device is known to the underlying subsystem. Again, for the meaning of these tokens for various device families and in various environments, refer to "Name-lists" in topic 20.0.

char-count (specified by user) (fullword integer)
The number of fullwords in char-list. Zero can be specified to indicate that char-list is empty and is not to be returned.

char-list (returned by GDDM) (an array of fullword integers)
An array of fullword integers to receive the device characteristics information. For an explanation of the device characteristics information that can be returned, see FSQURY (code=0).

Description

Requests the characteristics of the device to be returned. A device token, processing options list, and name-list are returned in DSOPEN format, including the values of any options that were defaulted when the device was opened; see DSOPEN. Another list, containing miscellaneous device characteristics, is also returned.

Storage for these lists is provided by the invoker. The various count parameters indicate how many elements (fullwords, or 8-byte tokens, as appropriate) for which there is room in each list. If there is not enough space, GDDM returns only as many elements as the space allows; if there is extra space, it pads the space with zeros or blanks, as appropriate.

Principal errors

ADM0074 E: INVALID DEVICE IDENTIFIER
ADM0078 E: INVALID NAME COUNT n
ADM0079 E: INVALID PROCESSING OPTIONS COUNT n
ADM0081 E: INVALID DEVICE CHARACTERISTICS COUNT
ADM0082 E: DEVICE DOES NOT EXIST
ADM0129 E: ARRAY COUNT n IS INVALID

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