SSREAD

GDDM V3R2 Base Application Programming Reference

SSREAD

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To read a symbol set from auxiliary storage.


   SSREAD      (symbol-set-name, length, data)

   APL code               213
   GDDM RCP code          X'0C040B00' (201591552)

Parameters

symbol-set-name (specified by user) (8-byte character string)
The name (left-justified) of the symbol set or DBCS ward to be read from auxiliary storage.

If the name ends with the substitution character "[]" (for a DBCS ward name, the substitution character is just before the ward digits), GDDM tries to locate the symbol set file with a name formed by changing the "[]" to one appropriate to the current device. The symbol-set-name parameter is not itself changed upon return. For information on the character that is substituted, see "Symbol sets" in topic 7.0.

GDDM first tries to locate a symbol set whose name is formed by replacing the substitution character with that appropriate for the current alphanumerics cell size. (See the information for code=0 under FSQURY and also see the symbol set naming convention described in "Symbol sets" in topic 7.0.

If GDDM cannot find such a symbol set, it then looks for one whose name is formed by replacing its substitution character with the one that is appropriate for the current graphics cell size. (See the information for code=2 under FSQURY and also see the symbol set naming convention described in "Symbol sets" in topic 7.0).

length (specified by user) (fullword integer)
The length of storage provided for the data parameter. The SSQF call can be used to determine how much storage is needed for the symbol set.

data (returned by GDDM) (character)
Contains the symbol set as read from auxiliary storage.

Description

Reads a set of symbol definitions from auxiliary storage. The symbol set can be either an image symbol set or a vector symbol set.

The symbol set does not remain in GDDM storage, and is not available for use by it.

Principal errors

ADM0114 E: LENGTH n IS INSUFFICIENT FOR SYMBOL SET 'a'
ADM0115 E: SYMBOL SET 'a' LENGTH n IS INVALID

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