CHLC

GDDM-PGF V2R1.3 Programming Guide and Reference

CHLC

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

Function: To specify component line color table.


   CHLC        (count, colors)

   APL code               800
   GDDM RCP code          X'10020307' (268567303)

Parameters

count (specified by user) (fullword integer)
A fullword integer specifying the number of attribute values to be taken from the colors array and used as the line color attribute table. If zero, the default colors are used. The maximum number of values that can be specified is 32.

colors (specified by user) (an array of fullword integers)
An array of fullword integers indicating the color codes used consecutively for components.

For valid values of color, see Appendix C. Colors, line types, markers, and shading patterns in topic C.0.

Example

If the line in the first two data components (for example, lines on a line graph) is to be green and the third red, enter the following:


     DCL LCARRAY FIXED BIN(31) INIT(4,4,2);
     CALL CHLC (3,LCARRAY);

In this example, 3 is the number of attribute values, 4 means green, and 2 means red.

Marker and shading colors are controlled by the CHCOL call.

Note: The table is used cyclically and therefore, in this case, the fourth component (if any) would be green.

Description

Overrides the default table of line color attributes used for data representation lines on, for example, line graphs; for outlines on, for example, bar charts; and for x slices on table charts. Colors are taken from the line color table in sequence to construct each data component, pie slice, or Venn diagram circle.

The default line color attribute table is the basic color attribute table, whether this is specified explicitly in CHCOL or allowed to default.

Valid only in state-1.

Principal errors

ADM0501 E: THIS FUNCTION CANNOT BE INVOKED IN THE CHART-DRAWING STATE
ADM0515 E: ATTRIBUTE COUNT IS NEGATIVE
ADM0516 W: ARRAY COUNT EXCEEDS THE MAXIMUM ALLOWED
ADM0517 E: INVALID COLOR VALUE

Notices | Terms of use | Support | Contact z/OS