Each DEC DATATRIEVE plot statement uses the following general syntax. Format PLOT plotname [USING] [ALL] [arg [,arg]...] [OF rse] [ { file-spec } ] [ ON {*.prompt } ] [ { } ]
1 – Arguments
plotname Is the name of the plot, for example: DTR> PLOT BAR BAR is the name of the plot. Refer to the DEC DATATRIEVE User's Guide for plotname descriptions. USING Is an optional keyword to make the syntax more like English. The keyword USING does not affect the plot statement. ALL Is a keyword that may be optional or required, depending on the structure of the plot statement you use. It is optional if you use the OF rse clause; it is required if you use the current collection without any qualification. For example, the following two plot statements are the same: DTR> PLOT BAR BUILDER, PRICE OF YACHTS WITH CON> PRICE NE 0 DTR> FIND YACHTS WITH PRICE NE 0 DTR> PLOT BAR ALL BUILDER, PRICE The first example uses an OF rse clause in which the keyword ALL is not required. In the second example, ALL is required because it refers to the collection created in the FIND statement. In the syntax diagrams of the sections that follow, the keyword ALL is shown in brackets as an optional element. Note, however, that if you use the keyword ALL to refer to the contents of the current collection, ALL is required. arg Is a field name or other value expression. The argument can also contain an optional label string. To specify a label string, put a quoted string inside parentheses after the value expression. For example: DTR> PLOT X_Y LOA, CON> DISP / 2000 ("Weight in tons") OF YACHTS OF rse Specifies the record stream to be used in the plot. If you do not specify an RSE, the plot statement will use data from the current collection. ON { file-spec } { *.prompt } Specifies a device or file for output. If you do not specify a device or file specification, DEC DATATRIEVE displays the plot on your terminal screen. You can use a complete OpenVMS file specification or simply a file name. DEC DATATRIEVE uses .LIS as the default file type. A complete file specification has the following format: node-spec::device:[directory]file-name.type;version You can also use a prompting value expression that prompts you for a file or device specification. For example: DTR> PLOT PIE ALL RIG ON DRA0:[IACOBONE]RIGPLOT.LIS DTR> PLOT PIE ALL RIG ON *."File Name or Device Specification" You can use the ON clause with any of the plot statements to create a file containing the ReGIS[TM] graphics commands.
2 – Examples
The following example produces a simple bar chart showing the salary for each employee in PERSONNEL: DTR> FIND PERSONNEL SORTED BY DEPT DTR> PLOT BAR ALL LAST_NAME, SALARY DTR> The following example plots a marsupial: DTR> PLOT WOMBAT DTR>