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


CHSET

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



Function: To specify chart options.


   CHSET       (option)

APL code 798 PGF RCP code X'10020101' (268566785)


Parameters


option (specified by user) (4-byte character string)
The option string must be at least four characters long, and must be enclosed in single quotes. If more than four characters are specified, they are ignored. However, they may be used to increase the readability of the program.


The options are as follows, in alphabetic order by function; the defaults are shown LIKE THIS.


   Function                                        Option
   Axis, autoranging                               RANGE
                                                   NORANGE

Axis, orientation YVERTICAL XVERTICAL ZVERTICAL

Axis, time of drawing IDRAW DRAW NDRAW

Axis, title line break TLBREAK NTLBREAK

Bar chart, controlled values CVALUES VALUES NOVALUES

Bar chart, type MBAR CBAR FBAR

Bar values, blanking behind BVALUES NBVALUES

Bar values, notation VFIXED VSCIENTIFIC

Bar values, placement VINSIDE VONTOP

Chart area, boxed or shaded CBOX CBACK NCBOX

Curve fitting or not CURVE NOCURVE

Data, absolute or relative RELATIVE ABSOLUTE

Date label abbreviations ABREV FULL LETTER

Heading justification HCENTER HLEFT HRIGHT

Heading or not HEADING NOHEADING

Heading position HTOP HBOTTOM

Histogram risers RISERS NORISERS

Label areas blanked BLABEL NBLABEL

Legend areas blanked NBKEY BKEY

Legend, box around KBOX NKBOX

Legend or not LEGEND NOLEGEND

Legend, order of elements KNORMAL KREVERSED

Line graphs and polar charts, lines LINES NOLINES

Line graphs and polar charts, markers MARKERS NOMARKERS

Marker scaling MSCALE NOMSCALE

Note area blanked BNOTE NBNOTE

Notes, box around NBOX NONBOX

Notes, repositioned NNOTES INOTES

Numbers punctuation PGFS NPGFS

Pie charts, labeling appearance SPISLICE SPILABEL

Pie charts, labeling type PIEKEY SPIDER

Pie charts, relative size PROPIE NOPROPIE

Pie data, type of PERPIE ABPIE

Screen position occupied by SO/SI characters POSITION NOPOSITION

Shading method FILL INFILL NOFILL

Shading, mountain range MOUNTAIN NOMOUNTAIN

Tower charts, backplane drawn BACK NOBACK

Tower charts, color face BGBASE TCBASE

Tower charts, pick axis ZPICK XPICK

Tower charts, scale tower SCALETOWER NOSCALETOWER

Tower charts, side plane drawn SIDE NOSIDE

Tower charts, y-axis ticks TOWERTICK NOTOWERTICK

X axis, secondary specification XDUP XNOD

Y axis, secondary specification YDUP YNOD


Description


Overrides defaults on all chart attributes that are not related to axes. In general, any attribute that does not need a value and does not refer to an axis is an option of CHSET.

Only one option may be set by each CHSET call. For example, to request a left-justified heading in the bottom margin, two calls are needed:


     CHSET ('HBOT')
     CHSET ('HLEFT')

Unless otherwise stated, CHSET calls are valid only in state-1.

Principal errors


ADM0505 E
INVALID PARAMETER: a
ADM0549 E
OPTION a IS INVALID IN THE CHART-DRAWING STATE

CHSET Options


The groups of CHSET options are listed in alphabetic order by option.

  • CHSET 'ABREV' | 'FULL' | 'LETTER'
    
    
    Specifies the form of axis labels supplied by CHXMTH, CHYMTH, CHXDAY, and CHYDAY. It applies to all charts except pie charts and Venn diagrams.
    
    
    ABREV specifies three-character abbreviations.
    
    
    FULL specifies complete words.
    
    
    LETTER specifies first letters only.
    
    
    The following tables list the month/day sequence numbers and the display variations.
    
    
    
             Number ABREV   FULL       LETTER
    

    Month

    1 JAN JANUARY J 2 FEB FEBRUARY F 3 MAR MARCH M 4 APR APRIL A 5 MAY MAY M 6 JUN JUNE J 7 JUL JULY J 8 AUG AUGUST A 9 SEP SEPTEMBER S 10 OCT OCTOBER O 11 NOV NOVEMBER N 12 DEC DECEMBER D

    Day

    1 MON MONDAY M 2 TUE TUESDAY T 3 WED WEDNESDAY W 4 THU THURSDAY T 5 FRI FRIDAY F 6 SAT SATURDAY S 7 SUN SUNDAY S

  • CHSET 'ABSOLUTE' | 'RELATIVE'
    
    
    ABSOLUTE specifies that absolute data values are supplied.
    
    
    RELATIVE specifies that the dependent data values, for all data groups except the first, are relative to the previous component. Relative data is the natural and recommended form of data for all chart types that involve stacking of components. The depth of each bar (or layer in a surface chart) then gives the absolute data value. The following example illustrates this point:
    
    
    
             Component       Value Supplied      Value Plotted
    

    1 2 2 2 5 7 3 3 10

    The resultant bar chart is:
    
    

    
       PICTURE 13          
    

    
    
  • CHSET 'BACK' | 'NOBACK'
    
    
    BACK specifies that the back plane is to be drawn on a tower chart. If this plane is present, an edge is always drawn round it, corresponding to the extremes of the axis. A grid can be drawn on this plane by using the GRID option of CHZSET.
    
    
    NOBACK specifies that the back plane is not to be drawn on a tower chart.
    
    
  • CHSET 'BGBASE' | 'TCBASE'
    
    
    BGBASE specifies that the face of the tower on a tower chart at the reference plane is to be shown in the background color. This allows any negative towers to be identified easily.
    
    
    TCBASE specifies that the face of the tower at the reference plane is to be shown in the same color as the tower.
    
    
  • CHSET 'BKEY' | 'NBKEY'
    
    
    BKEY specifies that the rectangular area to be occupied by the legend is blanked before the legend is constructed. On terminals not in the IBM 3270 family, this option may have no effect, because some types of hardware do not permit blanking.
    
    
    NBKEY specifies that the legend area is not blanked.
    
    
  • CHSET 'BLABEL' | 'NBLABEL'
    
    
    Controls blanking of the areas to be occupied by axis labels, before the labels are constructed. It can be used with CHSET('CBACK'), CHSET('DRAW'), or CHDRAX, to ensure that the axis labels are not obscured by background shading or some aspect of the plot.
    
    
    Valid in state-1 or state-2.
    
    
    NBLABEL does not blank label areas (except for mode 1 text, for which blanking is performed by hardware action).
    
    
    BLABEL blanks the label areas before the labels are written. On terminals not in the 3270 family, this option may have no effect, because some types of hardware do not permit blanking.
    
    
  • CHSET 'BNOTE' | 'NBNOTE'
    
    
    Controls the blanking of areas to be occupied by notes, before the notes are written (see CHNOTE).
    
    
    BNOTE blanks note areas before the notes are written. On terminals not in the 3270 family, this option may have no effect, because some types of hardware do not permit blanking.
    
    
    NBNOTE does not blank note areas (except for mode 1 text, for which blanking is performed by hardware action).
    
    
    Valid in state-1 or state-2.
    
    
  • CHSET 'BVALUES' | 'NBVALUES'
    
    
    Controls blanking of the areas to be occupied by data values on bar charts if CHSET('VALUES') is set.
    
    
    Valid in state-1 or state-2.
    
    
    NBVALUES does not blank the value areas (except for mode 1 text, for which blanking is performed by hardware action).
    
    
    BVALUES blanks the value areas before the values are written. On terminals not in the IBM 3270 family, this option may have no effect, because some types of hardware do not permit blanking.
    
    
  • CHSET 'CBOX' | 'NCBOX' | 'CBACK'
    
    
    Permits the drawing of a framing box about the perimeter of the chart area or the shading of the background. Defaults for the attributes of the lines defining the box can be overridden by CHBATT.
    
    
    CBOX specifies that the box is to be drawn.
    
    
    NCBOX suppresses the framing box.
    
    
    CBACK specifies that the entire chart area is to be shaded with a solid pattern as a background, in addition to drawing the framing box. The background color will be the same as the lines defining the box, as set by CHBATT.
    
    
    CBACK should not be used for Venn diagrams, for monochrome devices, or when the chart is to be printed. Furthermore, remember that the data streams generated by this option may be very long, because many more cell definitions are generated with multicolor contents. PS stores may be quickly exhausted with other than simple charts. Note that to cancel a CBACK request, CBOX or NCBOX must be specified.
    
    
  • CHSET 'CURVE' | 'NOCURVE'
    
    
    Controls the manner in which the supplied data points in a line graph, surface chart, or polar chart are connected. Each consecutive pair of points may be connected by a straight line, or by a smooth curve. For a line graph or polar chart, it is effective only if CHSET('LINES') is also specified (or defaulted).
    
    
    If a smooth curve is specified, the smoothness of the curve may be controlled by the CHFINE call. Note that the smooth curve constructed by use of this option is not intended to provide an interpretation of the supplied data values. Rather, the option is provided purely for its cosmetic effect on the resulting graph.
    
    
    Valid in state-1 or state-2.
    
    
    CURVE specifies that consecutive data points within each data group of a line graph, polar chart, or surface chart are to be connected by a smooth curve constructed using the current data-group attributes.
    
    
    NOCURVE specifies that consecutive data points within each data group of a line graph, polar chart, or surface chart are to be connected by straight lines constructed using the current data-group attributes.
    
    
  • CHSET 'CVALUES' | 'VALUES' | 'NOVALUES'
    
    
    Specifies how values are to be displayed for bar charts and table charts (or, in the case of the 'VALUES' option, for bar and pie charts).
    
    
    Valid in state-1 or state-2.
    
    
    CVALUES specifies that controlled bar-chart values are to be provided. Related calls are CHVDIG, CHTHRS, CHSET('VINSIDE' | 'VONTOP'), CHSET('VFIXED' | 'VSCIENTIFIC'), and CHVATT with the bar-value rotation option. Values and bars might overlap on composite (stacked) or floating bar charts. See "CHVCHR - Number of characters in bar values" in topic 4.63 for a further discussion. Text attributes for the value representations are set by CHVATT. The area to be occupied by each bar value may be blanked, before the value is constructed, with the BVALUES option.
    
    
    VALUES controls the appearance of dependent data values at the ends of bars on bar charts, or percentage values on pie charts.
    
    
    For bar charts, VALUES constructs character representations of the dependent data values at the end of each bar, on each CHBAR or CHBARX call. Overlap of values and bars may occur on composite (stacked) or floating bar charts. See the description of CHVCHR for further discussion. Text attributes for the value representations are set by CHVATT. The area to be occupied by each bar value may be blanked, before the value is constructed, with the BVALUES option.
    
    
    For pie charts, VALUES has two possible meanings:
    
    
    • If the option CHSET('PIEKEY') (the default) is in effect, integer percentage data values are constructed as spider labels around the pie, connected to their corresponding slices by lines. Each consists of the character representation of the integer closest to the percentage slice value, followed by a % sign.
      
      
    • If CHSET('SPIDER') is in effect, spider labels are constructed, each consisting of a percentage representation as above, followed by a label text string as specified by CHKEY.
      
      
      In both cases, the data values are always in percentage form, regardless of the pie chart data type. See CHSET('SPISLICE') for a description of text attributes.
      
      

    NOVALUES indicates that no values are given on bar charts or pie charts.
    
    
  • CHSET 'FILL' | 'INFILL' | 'NOFILL'
    
    
    Specifies the method of shading. Applies to all charts except line graphs, scatter plots, and table charts. Note that shading, when specified, always shades the interior of a defined boundary. If the defined boundary crosses itself, the effects of shading may be unexpected.
    
    
    Valid in state-1 or state-2.
    
    
    Shading patterns are taken from the pattern-attribute table. The default table may be overridden by a call to CHPAT.
    
    
    • Surface charts, bar charts, polar charts, tower charts, and histograms
      
      
      FILL specifies that all data groups are shaded with patterns taken from the pattern-attribute table. The first data group specified in a plotting routine call is shaded to the x axis (or y datum reference line if specified). Subsequent data groups in the same call are shaded to the previous data group.
      
      
      INFILL is equivalent to FILL for multiple bar charts and tower charts. It suppresses the shading of the first data group for polar charts, surface charts, histograms, and composite (stacked) bar charts.
      
      
      NOFILL suppresses all shading for all charts except surface charts, for which it is equivalent to INFILL.
      
      
    • Pie charts
      
      
      FILL specifies that all pie slices are shaded with patterns taken from the pattern-attribute table. Corresponding slices in different pies are shaded with the same pattern.
      
      
      INFILL is equivalent to FILL.
      
      
      NOFILL suppresses shading for all pie slices.
      
      
    • Venn diagrams
      
      
      FILL specifies that the two population circles are shaded with patterns from the pattern attribute table.
      
      
      INFILL is equivalent to FILL.
      
      
      NOFILL suppresses shading of the two population circles.
      
      

  • CHSET 'HCENTER' | 'HLEFT' | 'HRIGHT'
    
    
    Controls the justification of the chart heading.
    
    
    HCENTER specifies that each line of the heading is centered between the left and right edges of the chart area.
    
    
    HLEFT specifies that each line of the heading is left-justified to the edge of the chart area.
    
    
    HRIGHT specifies that each line of the heading is right-justified to the edge of the chart area.
    
    
  • CHSET 'HEADING' | 'NOHEADING'
    
    
    This option controls whether or not the chart heading is displayed.
    
    
    HEADING specifies that the heading is displayed.
    
    
    NOHEADING specifies that the heading is suppressed.
    
    
  • CHSET 'HTOP' | 'HBOTTOM'
    
    
    Controls the location of the chart heading.
    
    
    HTOP specifies that the heading is placed in the top margin.
    
    
    HBOTTOM specifies that the heading is placed in the bottom margin.
    
    
  • CHSET 'IDRAW' | 'DRAW' | 'NDRAW'
    
    
    This option governs the time of construction of the axes, together with their scale marks, labels, and associated grid/datum lines.
    
    
    Valid in state-1 or state-2.
    
    
    IDRAW specifies that each axis is constructed automatically at the time of its definition, that is, when the first plotting routine call is issued with the axis selected. In this case each axis is constructed once and once only, before the data supplied on the plotting routine call is plotted. Data thus overwrites the axis where they cross.
    
    
    DRAW specifies that each axis is constructed automatically on each plotting routine call for which the axis is selected, after the data is plotted. In this case each axis is constructed as many times as there are plotting routine calls for which the axis is selected. The axis thus overwrites the data. DRAW may result in unnecessary processing if several plotting routines calls are made. In such a situation, data can be overwritten using the CHDRAX call and possibly the NDRAW option.
    
    
    DRAW is ignored for tower charts.
    
    
    NDRAW suppresses the automatic construction of axes on plotting routine calls. Axis drawing can be explicitly requested by means of a CHDRAX call.
    
    
    In all cases, axis construction may be forced at any time in state-2 by execution of CHDRAX.
    
    
  • CHSET 'KBOX' | 'NKBOX'
    
    
    Controls the construction of a box around each key in the legend. NKBOX specifies that no key box is to be constructed.
    
    
    KBOX specifies that each key in the legend is surrounded by a box whose attributes are the same as those for the primary x-axis line (see CHAATT).
    
    
  • CHSET 'KNORMAL' | 'KREVERSED'
    
    
    Controls the order of items in a legend (K stands for Key).
    
    
    KNORMAL specifies that the first key is on the left or bottom.
    
    
    In a horizontal legend, each row of key entries is constructed from left to right (using the keys in the order in which they are defined by a CHKEY call). Similarly, in a vertical legend, each column of key entries is constructed from bottom to top.
    
    
    KREVERSED specifies that the first key is on the right or top.
    
    
    In a horizontal legend, each row of key entries is constructed from right to left (using the keys in the order in which they are defined by a CHKEY call). Similarly, in a vertical legend, each column of key entries is constructed from top to bottom.
    
    
  • CHSET 'LEGEND' | 'NOLEGEND'
    
    
    Specifies whether a legend is to be constructed. Legends are not produced for Venn diagrams irrespective of the setting of this option. See the PIEKEY option for information about construction of legends for pie charts.
    
    
    LEGEND specifies that a legend is to be constructed after any subsequent plotting calls (for example, CHPLOT, CHTOWR, CHBAR, and CHBARX).
    
    
    Valid in state-1 or state-2.
    
    
    NOLEGEND specifies that a legend is not to be constructed.
    
    
    Valid in state-1 only.
    
    
  • CHSET 'LINES' | 'NOLINES'
    
    
    Controls whether CHPLOT and CHPOLR produce a line graph (LINES) or a scatter plot (NOLINES).
    
    
    Valid in state-1 or state-2.
    
    
    LINES specifies that consecutive points on each data group are joined by a line, or curve (see CHSET('CURVE')).
    
    
    NOLINES specifies that only the markers are drawn, giving the effect of a scatter plot. If the CHSET('NOMARKERS') option is specified, nothing is drawn for CHPLOT; for CHPOLR, only shaded areas are drawn.
    
    
  • CHSET 'MARKERS' | 'NOMARKERS'
    
    
    Indicates whether markers are shown.
    
    
    Valid in state-1 or state-2.
    
    
    MARKERS specifies that markers on line graphs, scatter plots, or polar charts appear at the data points specified on a CHPLOT or CHPOLR call. Markers are obtained from the marker-attribute table. The default marker table can be overridden by a CHMARK call.
    
    
    NOMARKERS suppresses the construction of markers.
    
    
  • CHSET 'MBAR' | 'CBAR' | 'FBAR'
    
    
    Specifies the type of bar chart to be constructed.
    
    
    Valid in state-1 or state-2.
    
    
    MBAR specifies a multiple bar chart (groups of bars, side-by-side).
    
    
    CBAR specifies a composite (stacked) bar chart (colinear bars).
    
    
    FBAR specifies a floating bar chart (like a stacked bar chart but with first data group bars omitted).
    
    

  • CHSET 'MOUNTAIN' | 'NOMOUNTAIN'
    
    
    MOUNTAIN specifies that, for surface charts and polar charts, the successive data groups appear behind the previous data group(s) so that the shading does not overlap. This effect is called mountain-range shading. Chart details (for example, grid lines and datum lines) that are behind a mountain range are not shown. The first component is shaded if the CHSET option 'FILL' has been specified; otherwise, shading is suppressed.
    
    
    NOMOUNTAIN suppresses mountain-range shading and restores the standard method of shading.
    
    
    Valid in state-1 only.
    
    
  • CHSET 'MSCALE' | 'NOMSCALE'
    
    
    Indicates whether markers are scaled to the size of the chart.
    
    
    NOMSCALE, the default, specifies that markers on line graphs, scatter plots, or polar charts have an absolute size independent of the overall size of the chart. Markers are scaled relative to the device's default markers. This option has been kept for compatibility with other releases.
    
    
    MSCALE specifies that scaling of markers is to occur relative to the size of the chart. This means that if the overall size of the chart is changed, then the markers will be scaled accordingly.
    
    
  • CHSET 'NBOX' | 'NONBOX'
    
    
    Controls the construction of a framing box round all subsequent chart notes, until the option is changed. Refer to the CHNOTE call description for the parameters affecting framing-box construction.
    
    
    Valid in state-1 or state-2.
    
    
    NBOX specifies construction of a framing box round subsequent chart notes.
    
    
    NONBOX suppresses construction of a framing box round subsequent chart notes.
    
    
  • CHSET 'NNOTES' | 'INOTES'
    
    
    Controls whether notes that do not fully appear on a display are repositioned.
    
    
    Valid in state-1 or state-2.
    
    
    NNOTES indicates that notes drawn after this call are repositioned by PGF to ensure that all of the note is visible on the display.
    
    
    INOTES indicates that notes drawn after this call are not repositioned by PGF; this means that not all of the note is visible on the display.
    
    
  • CHSET 'PERPIE' | 'ABPIE'
    
    
    Specifies the data type for pie charts.
    
    
    Valid in state-1 or state-2.
    
    
    PERPIE specifies that the data supplied in any subsequent calls to CHPIE is a percentage. Each slice subtends an angle of V*360/100 degrees, where V is the data value for the slice.
    
    
    If the total for all slices is less than 100, the complete circle is not drawn. If it is greater than 100, an error message is issued.
    
    
    ABPIE specifies that the data is absolute. All values of a pie are added together and the slice angle determined as a proportion of the total. Each slice subtends an angle of V*360/T degrees, where V is the data value and T is the total of all data values for the pie.
    
    
  • CHSET 'PGFS' | 'NPGFS'
    
    
    Specifies the method used to punctuate numbers of 1000 and over. The convention is used for the display of numeric data values in fixed-point format. Applies to all numeric axis labels, to bar values on bar charts, and to table chart values. These options are used in CHXSET and CHYSET calls to specify punctuation for numeric labels on the x or y axis.
    
    
    Valid in state-1 or state-2.
    
    
    PGFS suppresses all punctuation except the decimal point. This minimizes the space required for numeric values, for example: 1234567.999
    
    
    NPGFS selects the default national convention that may be specified when GDDM is installed. Widely used conventions are:
    
    
    • The period decimal convention. Example: 1,234,567.999
      
      
    • The comma decimal convention. Example: 1.234.567,999
      
      
    • The French convention. Example: 1 234 567,999
      
      

  • CHSET 'PIEKEY' | 'SPIDER'
    
    
    Specifies the configuration of pie chart labels.
    
    
    PIEKEY specifies that a legend will be constructed in the chart margin.
    
    
    SPIDER suppresses the generation of a legend, and specifies the construction of spider labels consisting of the labels specified by CHKEY written around the circumference of each pie. The labels are connected to their corresponding slices by lines. See CHSET('SPISLICE') for further discussion.
    
    
    Note: Any labels supplied by CHXLAB are written as pie titles adjacent to the pies, independently of labels supplied by CHKEY.
    
    
  • CHSET 'POSITION' | 'NOPOSITION'
    
    
    Controls whether the shift out (SO) and shift in (SI) characters occupy a screen position or not.
    
    
    NOPOSITION indicates that the SO/SI characters are removed.
    
    
    POSITION indicates that the SO/SI characters are replaced by blanks.
    
    
    Valid in state-1 only.
    
    
  • CHSET 'PROPIE' | 'NOPROPIE'
    
    
    Applies only to multiple pie charts using absolute (not percentage) data, generated by a single call to CHPIE.
    
    
    NOPROPIE specifies that all pies generated are the same size.
    
    
    PROPIE specifies that the area of each pie will be proportional to the sum of its slice values. The pies generated from a single call to CHPIE will be in proportion. The largest pie in each such group of pies has the same size as if NOPROPIE had been specified, and the remaining pies are reduced in proportion.
    
    
  • CHSET 'RANGE' | 'NORANGE'
    
    
    Controls whether plotting is to be done or whether just the range of the currently selected axes is to be calculated.
    
    
    Valid in state-1 only.
    
    
    RANGE indicates that a subsequent CHPLOT, CHSURF, CHHIST, CHBAR, or CHBARX call will enter state-2, calculate the axis range, define the axes (if they have not already been defined), and return without plotting any data. (Note that the first plotting call always defines the axes, whether RANGE has been specified or not.)
    
    
    NORANGE indicates that a subsequent plotting call will plot the data, as normal.
    
    
  • CHSET 'RISERS' | 'NORISERS'
    
    
    Controls whether steps of a histogram are delimited by riser lines.
    
    
    Valid in state-1 or state-2.
    
    
    RISERS specifies that lines perpendicular to the x axis are drawn at the ends of each histogram range. NORISERS suppresses the generation of intermediate histogram risers. The two outermost risers remain, joining the ends of the step to the x axis or datum reference line.
    
    
  • CHSET 'SCALETOWER' | 'NOSCALETOWER'
    
    
    SCALETOWER specifies that a tower, whose height corresponds to the y axis, is to be constructed on the left-hand side of the x axis if the z axis slopes to the right, or on the right-hand side if it slopes to the left. The tower will be placed so that it appears to be constructed on the x-z plane.
    
    
    NOSCALETOWER specifies that a tower is not to be constructed.
    
    
  • CHSET 'SIDE' | 'NOSIDE'
    
    
    SIDE specifies that the side plane is to be drawn on a tower chart. If this plane is present, an edge is always drawn round it, corresponding to the extremes of the axis. A grid can be drawn on this plane by using the GRID option of CHZSET.
    
    
    NOSIDE specifies that the side plane is not to be drawn.
    
    
  • CHSET 'SPISLICE' | 'SPILABEL'
    
    
    Specifies the appearance of pie-chart labels. It determines whether the pie labels and spider lines are the same colors as the slice to which they are attached, or are controlled by CHKATT or CHVATT. SPISLICE and SPILABEL are effective only if slice values, or slice labels, or both are specified. Slice values are specified by CHSET('VALUES'), and slice labels are specified by CHKEY and CHSET('SPIDER').
    
    
    Valid in state-1 or state-2.
    
    
    SPISLICE draws the spider line and associated text (slice value, or label, or both) in the color of the corresponding slice. The character mode, symbol-set identifier, and character multiplier for the text are determined by CHKATT if CHSET('SPIDER') is in effect, by CHVATT otherwise.
    
    
    Note: The SPISLICE option was previously called SPISECTOR. Both names are valid; the abbreviation (SPIS) is the same for both names.
    
    
    SPILABEL draws the spider lines in the default color. The associated text attributes are those specified by CHKATT if CHSET('SPIDER') is in effect, by CHVATT otherwise.
    
    
  • CHSET 'TLBREAK' | 'NTLBREAK'
    
    
    TLBREAK specifies that a semicolon in an axis title will cause a line break.
    
    
    NTLBREAK specifies that a semicolon in an axis title will not cause a line break.
    
    
  • CHSET 'TOWERTICK' | 'NOTOWERTICK'
    
    
    TOWERTICK specifies that a tower is to have the major scale (tick) marks from the y axis copied on to it. This option allows the heights of the towers to be compared more easily. The scale marks are drawn in the background color. A solid shading pattern should be specified in the CHPAT call (see "CHPAT - Component shading pattern table" in topic 4.42) when this option is used so that the scale marks are clearly visible.
    
    
    NOTOWERTICK specifies that scale marks are not to be copied.
    
    
  • CHSET 'VINSIDE' | 'VONTOP'
    
    
    Controls the placement of values for bar charts. The values can appear either on top of or inside the bars. A CHSET('CVALUES') call is required if you specify one of these options.
    
    
    VINSIDE specifies that bar values are to be centered within each bar.
    
    
    VONTOP specifies that bar values are to be placed on top of the bars.
    
    
    Valid in state-1 or state-2.
    
    
  • CHSET 'VSCIENTIFIC' | 'VFIXED'
    
    
    Controls the format of the values for bar charts and table charts. The values can appear either in scientific format or in fixed-point format. A CHSET('CVALUES') call is required if you specify one of these options.
    
    
    VSCIENTIFIC specifies that values are to appear in scientific format (for example, 1.3E+01).
    
    
    VFIXED specifies that values are to appear in fixed-point format (for example, 13).
    
    
    Valid in state-1 or state-2.
    
    
  • CHSET 'XDUP' | 'XNODUP'
    
    
  • CHSET 'YDUP' | 'YNODUP'
    
    
    These options specify that a duplicate of the primary axis is used as a secondary axis. By default this will give axes at both sides or ends of the graph.
    
    
    XDUP specifies that the primary x axis is duplicated.
    
    
    YDUP specifies that the primary y axis is duplicated.
    
    
    XNODUP specifies that the x axis is not duplicated.
    
    
    YNODUP specifies that the y axis is not duplicated.
    
    
    For pie charts and Venn diagrams, a duplicate axis specification is ignored.
    
    
    When a duplicate axis is specified, the secondary axis is used to support it. For this reason, certain items are copied into the secondary axis fields on entry to state-2 if the duplicate axis option is set. The following items are copied: axis range, scale mark positions, scale type (linear or logarithmic), scaling factor, and axis attributes (line type, width, and color). These supersede any corresponding items that may have been explicitly specified for the secondary axis. Also, the secondary axis grid lines option is suppressed to avoid redrawing grid lines.
    
    
  • CHSET 'YVERTICAL' | 'XVERTICAL' | 'ZVERTICAL'
    
    
    Specifies the orientation of all axes; also controls the orientation of multiple pie charts, and Venn diagrams. It is ignored for tower charts.
    
    
    YVERTICAL specifies that the y axis should be vertical and the x axis horizontal. YVERTICAL is the default and creates horizontal line graphs, and bar charts and histograms with vertical bars. Venn diagrams are arranged horizontally and pie charts in a horizontal line if there are more than one. Table charts have components (data groups) in columns vertically.
    
    
    XVERTICAL specifies that the x axis is to be vertical and the y axis horizontal. XVERTICAL creates vertical line graphs, and bar charts and histograms with horizontal bars. Venn diagrams are vertically aligned. Pie charts are arranged above one another if there are more than one. Table charts have components (data groups) in columns vertically.
    
    
    ZVERTICAL specifies that table charts have components (data groups) in rows horizontally. All other chart types are arranged as for YVERTICAL.
    
    
  • CHSET 'ZPICK' | 'XPICK'
    
    
    ZPICK specifies that the color, pattern, and line types for each tower in a tower chart or each component (data group) on a table chart are to be picked from the attribute list, according to their positions on the z axis.
    
    
    XPICK specifies that the color, pattern, and line types for each tower in a tower chart or each x slice on a table chart are to be picked from the attribute list, according to their positions on the x axis.

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012