Language Reference

GOPEN Call

opens a graphics segment

CALL GOPEN( <segment-name<, replace<, description>);

The inputs to the GOPEN subroutine are as follows:

segment-name

is a character matrix or quoted literal specifying the name of a graphics segment.

replace

is a numeric argument.

description

is a character matrix or quoted text string with a maximum length of 40 characters.

The GOPEN subroutine starts a new graphics segment. The window and viewport are reset to the default values () in both cases. Any attribute modified by using a GSET call is reset to its default value, which is set by the attribute's corresponding GOPTIONS value.

A nonzero value for replace indicates that the new segment should replace the first found segment with the same name, and zero indicates otherwise. If you do not specify the replace flag, the flag set by a previous GSTART call is used. By default, the GSTART subroutine sets the flag to NOREPLACE.

The description is a text string of up to 40 characters that you want to store with the segment to describe the graph.

Two graphs cannot have the same name. If you try to create a segment - say, PLOT_A - twice, the second segment is given a name generated by IML.

To open a new segment named COSINE, set replace to replace a like-named segment, and attach a description to the segment. Use the following statement:

  
    call gopen('cosine',1,'Graph of Cosine Curve');