GDDM-PGF V2R1.3 Programming Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF | BOOK


CHDTAB

GDDM-PGF V2R1.3 Programming Guide and Reference
SC33-0333-01



Function: To construct a table chart.


   CHDTAB      (z-count, x-count, z-list, x-list, data-array)

APL code 806 PGF RCP code X'100D0A0B' (269289995)


Parameters



z-count (specified by user) (fullword integer)
Specifies the number of data groups (components) to be shown along the z axis.


x-count (specified by user) (fullword integer)
Specifies the number of data values to be shown along the x axis (that is, the number of values in each data group). All the data groups must have the same number of values.

z-list (specified by user) (array of short floating-point numbers)
The list of z values to be used along the z axis.

x-list (specified by user) (array of short floating-point numbers)
The list of x values to be used along the x axis.

data-array (specified by user) (array of short floating-point numbers)
An array that contains the data values to be shown in the table. The number of values to be displayed corresponds to the number specified in the z-count parameter multiplied by the number in the x-count parameter. For example, if the data-array contained 20 values, x-count was 5, and z-count was 3, then only 15 values would be displayed.

Description


Constructs a table chart. The horizontal dimension of the standard table chart is considered to be a z axis, and the vertical dimension an x axis. The data shown in the cells of the table is the y data.

The x and z axes of the standard table chart are treated similarly. They both have the option (controlled by CHXSET and CHZSET) to put a set of labels around the edge of the table. The x labels go down the left edge of the table and the z labels go across the top of the table. The labels can be:

  • Numeric values supplied on the CHDTAB call.
    
    
  • The data labels supplied by the CHXDLB and CHZDLB calls.
    
    
  • For the x axis only they may also be:
    
    
    • Labels supplied by the CHXLAB call.
    • Month or day labels as specified by the CHXDAY or CHXMTH calls.
      
      

The outer edges of the chart are at the current margins. No legends are allowed with this chart as it already shows all the information that a legend would contain.

Valid only in state-1.

Principal errors


ADM0502 E
PICTURE SPACE AND CHAREA ARE INCOMPATIBLE
ADM0504 E
MARGINS EXCEED AVAILABLE CHART AREA
ADM0512 W
HEADING TEXT EXCEEDS AVAILABLE SPACE AND HAS BEEN TRUNCATED
ADM0514 W
LABEL(S) OMITTED ON X, Y, OR Z AXIS
ADM0532 E
COMPONENT PARAMETER LESS THAN ZERO OR COUNT PARAMETER LESS THAN ONE
ADM0534 W
DATA LIES OUTSIDE THE X, Y, OR Z AXIS RANGE AND HAS NOT BEEN PLOTTED
ADM0543 S
INCOMPATIBLE MIXTURE OF CHART TYPES
ADM0544 S
STORAGE LIMIT EXCEEDED
ADM0546 E
THE X, Y, OR Z AXIS RANGE EXCEEDS NUMERIC BOUNDS
ADM0566 E
CHDRAX NOT ALLOWED WITH CURRENT CHART TYPE
ADM0587 W
CHART IS TOO WIDE. n COLUMN(S) MISSING
ADM0588 W
CHART IS TOO LONG. n ROW(S) MISSING

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012