1 GRAPH

 Invokes VAX-11 DECgraph, the business graphics production
 facility.
 
 Format:
 
       GRAPH[/qualifiers] [data-set-name] [graph-desc-name]
 
 Examples:

       $ GRAPH
       $ GRAPH/PALETTE=5
       $ GRAPH/NOINTERACTIVE/PRINT/DOUBLE AUG83 SALES

2 Parameters

 [data-set-name]

  Specifies the name of the data set to be used.  You can specify
  device and directory names, but file types are ignored.

 [graph-desc-name]

  Specifies the name of the graph description file.  You can specify
  device and directory names, but file types are ignored.

  The default for both these parameters is GRAPH$LIBRARY:SAMPLE.

2 Qualifiers
/CONTEXT

 The /CONTEXT qualifier can only be used through the callable
 interface.
 
 This qualifier tells DECgraph that there is another parameter in the
 call to GRAPH$COMMAND.  The second parameter in the call is the
 address of a DATATRIEVE Access Block (DAB).

/DOUBLE_SIZE

 Specifies that the chart is to be printed in double size.  This
 qualifier can be used only with either the /PRINT or /SIXEL_GRAPHICS
 qualifier.  Double-size prints are available only on LA34-VA or
 LA100 printers.
 

/INTERACTIVE (D)
/NOINTERACTIVE

 Specifies whether or not the DECgraph session is interactive.

/LOAD

 Specifies that the data-set-name parameter is a DECgraph load file.
 The specified load file is converted to internal DECgraph format
 before being used.  The load file that you specify must have a file
 type of GRL.

/LOGO
/NOLOGO

 Tells DECgraph whether or not to display the VAX-11 DECgraph logo in
 the initial screen.  By default, the logo is displayed.  Using the
 /NOLOGO qualifier saves time during DECgraph startup.

/MONOCHROME

 Specifies the creation of a monochrome-only ReGIS output file.  This
 file contains the graphics commands to reproduce your chart in black
 and white patterns without entering DECgraph.  The file can be
 displayed on your terminal or mailed to other users with graphics
 terminals.  The format of this qualifier is:

    	/MONOCHROME[=mono-filename]

 The mono-filename parameter is optional and specifies the name of the
 monochrome output file.  The file type GRM is automatically supplied.
 The default file name is CURRENT.

 The /NOINTERACTIVE qualifier must be present when the /MONOCHROME
 qualifier is used.

/OUTPUT

 Specifies the creation of a ReGIS graphics output file with either
 color or patterns.  This file contains the graphics commands to
 reproduce your chart without entering DECgraph.  The chart can be
 displayed on your terminal or mailed to other users with graphics
 terminals.  The format of this qualifier is:

    	/OUTPUT[=filename]

 The filename parameter is optional and specifies the name of the
 graphics output file.  The file type GRO is automatically supplied.
 The default file name is CURRENT.

 The /NOINTERACTIVE qualifier must be present when the /OUTPUT
 qualifier is used.

 When a color graphics output file is displayed on a black and white
 terminal screen, the colors in filled and shaded areas are shown as
 gray tones.

/PALETTE

 Specifies which palette to use. The default palette file is number 1.
 The format of this qualifier is:

    	/PALETTE=n

 The n parameter is a number from 1 to 12 indicating which palette
 to use.

/PRINT

 Specifies that the chart is to be printed on the attached printer
 (LA34VA, LA100, LA12, or LA50).  By itself, this qualifier specifies
 that the chart is to be printed in single size.  You can use the
 /DOUBLE_SIZE qualifier with /PRINT to specify a double-size copy of
 the chart.

 The /NOINTERACTIVE qualifier must be present when the /PRINT
 qualifier is used.

/SIXEL_GRAPHICS

 Specifies the creation of a sixel output file.  This file contains
 the sixel graphics commands to reproduce your chart in black and
 white patterns without entering DECgraph.  The file can be displayed
 on your terminal or mailed to other users with graphics terminals.
 The format of this qualifier is:

    	/SIXEL_GRAPHICS[=sixel-filename]

 The sixel-filename parameter is optional and specifies the name of
 the sixel output file.  The file type GRS is automatically supplied.
 The default file name is CURRENT.

 The /NOINTERACTIVE qualifier must be present when the /SIXEL
 qualifier is used.

 Sixel files can be printed on remote graphics printers that use the
 sixel graphics protocol, such as LA34-VA, LA100, LA12, and LA50.

/STACK

 Specifies how much stack to use to initialize DATATRIEVE.  The
 default is 100.  The format of this qualifier is:

    	/STACK=n

/VIEW

 Specifies that the chart is to be displayed on the terminal for
 viewing.

 The /NOINTERACTIVE qualifier must be present when the /VIEW
 qualifier is used.

2 Release_notes

The following notes contain information about the Version 1.3
release of VAX-11 DECgraph.

To get a printed copy of these notes, write them to an output file
and then print the file.  Use these commands:

     HELP /OUTPUT=filename GRAPH RELEASE_NOTES *
     PRINT filename

3 Problems

o   VT125 terminals:  a lowercase "p" appears for a split second in
    the left margin of your screen, just before DECgraph draws the
    Main Menu.  You can ignore it.

o   Using palette 3 or palette 12 causes a thin vertical line to
    appear on the right-hand side of the work area.  This line does
    not appear when you expand the chart to full screen size with the
    PF3 key or the DISPLAY icon.






o   A fatal error occurs if the user's disk is full or if the user's
    disk quota has been filled.  This condition happens when:

    o   DECgraph tries to create a file (for example, a graph descrip-
        tion file or an output file) and the user's disk is full.
        DECgraph will stop and display the following message:  

           File not created because the disk is full

    o   DECgraph tries to create a file (for example, a graph descrip-
        tion file or an output file) and the user's disk quota has been
        filled.  DECgraph will stop and display the following message:

           File not created because disk quota is exceeded

o   If you get a message from DECgraph in the form of a message number
    (such as:  Message number 008D8B2B) instead of message text, see
    the Installation_notes topic of these Release Notes.

3 Restrictions

o   You should not use the operator console (OPA0:) to create sixel
    files, because you might lose characters due to data overruns.
    If you must use the operator console, you should first lower the
    baud rate.  Change the baud rate setting in the hardware; you
    cannot use the SET TERMINAL/SPEED command.

o   Before displaying sixel files on a hardcopy terminal or sending them
    to a graphics printer set up as a terminal queue, be sure the Wrap
    terminal characteristic is set (use the SET TERMINAL/WRAP command).

o   DATATRIEVE users should not use the DATATRIEVE plotting commands
    while in DECgraph.

o   DECgraph does not support the use of CTRL/O.

o   If you reset your terminal during a DECgraph session, CTRL/W will
    not refresh the screen properly.  Press CTRL/C to restart your
    session from the Main Menu.

3 Fixed_Problems

o   Callable DECgraph now works correctly.

o   DECgraph now allows you to set the Y range in a chart which contains
    only one data value.

o   DECgraph no longer allows you to enter pie chart isolate if your
    data contains negative values.

3 Installation_notes

If you use the INSTALL utility to install DECgraph as a known image
on your system, it is strongly recommended that you do NOT install
DECgraph with privileges.  If you do, you may see a message number
such as the following, instead of a DECgraph message:

        Message number 008D8B2B

If you must install DECgraph with privileges, you must also install
all the message image files DECgraph needs to access (including those
message image files DATATRIEVE needs to access if DECgraph is linked
with DATATRIEVE).  The message files vary depending on your system.
DECgraph may require access to the following files:

        SYS$MESSAGE:ACMSMSG.EXE
        SYS$MESSAGE:CDDEXC.EXE
        SYS$MESSAGE:DTRMSGS.EXE
        SYS$MESSAGE:PASMSG.EXE

If you have not installed DECgraph with privileges and you still see
message numbers instead of DECgraph messages, DECgraph may not be able
to access the message image files.  Verify that the protection on all
message image files (in SYS$MESSAGE) makes them available to DECgraph.
Also, check for other reasons why DECgraph cannot gain access to the
files (for example, the disk drive containing the message image files
is offline).
