CSNUM       (chart-id, type, value)

   APL code               1211
   PGF RCP code           X'14080020' (336068640)

Parameters

chart-id (specified by user) (fullword integer)
Gives the identification number of the chart for which control values are to be set.

1. Set the current note number to the number in the value parameter. If the number is greater than the current maximum, new empty notes are created and the maximum is increased to this number.
   The current note number is set to the default of 0:
   • When a new chart is created
   • After a CSNUM type 2 call
   • After a CSSICU call with DISPLAY = 1 or 2
   • After a CSDEL type 1 call
   • After a CSLOAD type 1 call.

   The value parameter must be in the range 0 through 999. This item is not saved.

2. Set the maximum note number to the number in the value parameter. If the number is greater than the current maximum, new empty notes are created and the maximum is increased to this number. If the number is less than the current maximum, the excess notes are deleted. The maximum note number is 8 when a new chart is created.
   The value parameter must be in the range 0 through 999. This item is saved in the chart format file.

3. Set the current subchart number to the number in the value parameter. If the number is greater than the current maximum, new empty subcharts are created and the maximum is increased to this number.
   The current subchart number is set to the default of 0:
   • When a new chart is created
   • After a CSNUM type 4 call
   • After a CSSICU call with DISPLAY = 1 or 2
   • After a CSDEL type 3 call
   • After a CSLOAD type 1 call.

   The value parameter must be in the range 0 through 999. This item is not saved.

4. Set the maximum subchart number to the number in the value parameter. If the number is greater than the current maximum, new default subcharts are created and the maximum is increased to this number. If the number is less than the current maximum, the excess subcharts are deleted (but never the master chart). The maximum subchart number is 5 when a new chart is created.
   The value parameter must be in the range 1 through 999. This item is saved in the chart format file.

5. Set the number of data groups to the number in the value parameter. If the number is greater than the current number, new data groups with missing values, null names, and appropriate z values are created. If the number is less than the current number, the excess data groups are deleted. The number of data groups is 0 when a new chart is created.
   The value parameter must be in the range 0 through 999. This item is saved in the chart data file.

6. Set the number of elements (x values) to the number in the value parameter. If the number is greater than the current number, new elements with missing values are added to each data group and appropriate x values and null data values are created. If the number is less than the current number, the excess elements are deleted. The number of elements is 0 when a new chart is created.
   For free data, the number of elements is set for the current component, as defined by CSNUM type 13.
   The value parameter must be in the range 0 through 999. This item is saved in the chart data file.

7. Set the number of data attribute sets to the number in the value parameter. If the number is greater than the current number, new sets are created and attribute values are created as if the I command had been used on the ICU data attributes panel (2.6). If the number is less than the current number, the excess attribute sets are deleted. The number of sets is 12 if Version 2 defaults have been selected or 8 if not, when a new chart is created. (See ICUFMDF in the GDDM System Customization and Administration book for information on selecting these GDDM external defaults.)
   The value parameter must be in the range 0 through 32. This item is saved in the chart format file.

8. Set the type of object to be listed on the directory panel when using CSSICU with DISPLAY = 8. The number in the value parameter must be one of the following:

   
               -1     No list
                0     Image symbol sets
                1     Vector symbol sets
                2     Generated map groups
                3     Saved pictures (in device-dependent form)
                4     Chart format
                5     Chart data
                6     Chart format and data
                7     GDF files (in device-independent form)
                9     Chart data definitions
               10     Projections
               11     Image data
   
              This item is not saved.
   
   

9. Reserved. The value must be 0.

10. Set the number of the master chart to the number in the value parameter. The master chart is moved so that it precedes the subchart with this number. The subcharts are renumbered. The number must not be greater than the maximum subchart number. The number is set to 1 when a new chart is created.
    This item is saved in the chart format file.

11. Set the subchart nesting level to the number in the value parameter. The number must be in the range 0 through 5. The number is set to 5 when a new chart is created.
    This item is not saved.

12. Set type of data: tied or free data. All existing data is cleared and all data groups are deleted.

    
                  1 = tied data
                  2 = free data
    
               This is set to 1 when a new chart is created.
    
    

    This item is saved in the chart data file.

13. Set the current component for x data to be used by CSNUM and CSQNUM type 6. The number in the value parameter must not exceed the current number of components as set by CSNUM type 5.
    It must be set to 0 for tied data. It is set to 1 for free data:
    • When a new chart is created
    • After a CSSICU call with DISPLAY = 1 or 2
    • After a CSNUM type 5 call
    • After a CSLOAD type 2 call.

    This item is not saved.

ADM0720 E

CHART IDENTIFIER (=n) IS INVALID

ADM0721 E

CHART WITH IDENTIFIER n DOES NOT EXIST

ADM0725 E

'TYPE' (=t) IS INVALID

ADM0738 E

FOR TYPE t, 'VALUE' (=n) IS INVALID