GSLOAD      (name, count1, opt-array, seg-count, count2, descriptor)

   APL code               593
   GDDM RCP code          X'0C0C1201' (202117633)

name (specified by user) (8-byte character string)
The name (left-justified) of the GDF file from which segments or the GDF object is to be loaded. This must be a valid external object name for the subsystem being used.

count1 (specified by user) (fullword integer)
The number of elements specified in the opt-array parameter.

opt-array (specified by user) (an array of fullword integers)
Specifies how GSLOAD is to restore a picture when it is copied from the segment library. The parameter has seven elements; the options are:

1-seg-base

The starting segment identifier for loading segments into the GDDM page.

2-load-type

Specifies how the segment is to be restored from the segment library

3-draw-defaults

Specifies the action to be taken when loading a GDF object that contains drawing default specifications.

4-resolve

Specifies the action to be taken when loading a GDF object that contains call segment orders to segments that do not exist in the object

5-symbol-set

Specifies the action to be taken when loading a GDF object that references a symbol set.

6-seg-zero

Specifies how segments from the GDF object with an identifier of 0 are renumbered.

7-primitive tag value

Specifies a tag value to add to all untagged primitives to allow them to be picked with a locator device.

seg-count (returned by GDDM) (fullword integer)
When seg-base = 0, seg-count is always 0. When seg-base > 0, seg-count is the number of named segments created by the GSLOAD call. This may include previously unnamed segments and extra segments (created by GSLOAD to resolve call segment orders) depending upon the other parameters to GSLOAD.

count2 (specified by user) (fullword integer)
The length supplied for the descriptor parameter.

descriptor (returned by GDDM) (character)
The descriptive record, of up to 253 bytes, that is saved with the picture.

Subtopics:

• 3.164.1 The elements of opt-array