.CHART RENDER

This subroutine is called to render a chart for the "current" chart spec.

Usage:

      PASS         <chart_pathname>           FIELD            SHARE? Y
      SUBR     0CD .CHART RENDER                    SUBPROCESS   END? N  FAIL 0
      *        Check for error
      IF       0CD .CHART RENDER              NE

Description:

This subroutine renders a chart for the "current" chart spec using the associated dataset(s) and returns the full pathname of a (png) file containing the rendered chart.

The <chart_pathname> is a required parameter. The value passed may be blank or it may optionally specify the file name or the full pathname of the chart that is to be rendered.

If the <chart_pathname> value that is passed is blank, then the system will assign a sequentially numbered file name with the prefix specified in the system parameter file and will create the file in the default chart directory specified in the system parameter file. This parameter must be PASSed with Share "Y" to return the value.

If the <chart_pathname> value that is passed is not blank, then the value passed must either be the desired file name or the desired full pathname (directory and file name) for the chart file that is to be created. If a file name is passed, then the system will create the chart file using the specified name in the default chart directory specified in the system parameter file. If a full pathname is passed, then the system will create the chart file using the specified full pathname.

If .CHART RENDER is not blank, .CHART RENDER ERROR may contain more details. Since this might contain HTML code (if it's a PHP error), you should display this in an HTML Viewer control.

Also notice the use of SUBR to invoke this routine. This is a large process, and by invoking it as a separate process it will reduce the compile time and Em size of your process.

Comments:

Read what other users have said about this page or add your own comments.

-- SteveFrizzell - 2010-03-17