Annotate Dictionary |
If there is an error in your Annotate data set, one or more diagnostic messages are printed in the SAS log. A partial list of these messages is supplied here. Annotate data sets are checked for errors this way:
If an error is found in preprocessing, this message appears:
NOTE: ERROR DETECTED IN ANNOTATE= libref.dataset
If an error is found as an observation is being read, this message appears:
PROBLEM IN OBSERVATION number - messagewhere message is the text of the error message.
If the error limit of 20 errors is reached at any point during processing of the data set, a termination message similar to this one appears:
ERROR LIMIT REACHED IN ANNOTATE PROCESS 20 TOTAL ERRORS
Some common diagnostic messages are explained here.
Explanation: The x or y coordinate is outside the display area (defined by HPOS= and VPOS= values).
User Action: Check for an invalid or misspecified coordinate system value, or x or y values outside displayed range.
Explanation: the x or y coordinate is outside of the window area. This message may accompany the message for invalid coordinate system specification.
User Action: Check for an invalid or misspecified coordinate system value, or x or y values outside displayed range.
Explanation: The x or y value requested is negative or greater than 100 percent. This message is informational.
Explanation: The MIDPOINT variable in the Annotate data set is character, and the GCHART midpoint is numeric or vice versa.
User Action: Check for misspelling or wrong variable assignment, or check for quotes in the assignment statement.
Explanation: The GROUP variable in the Annotate data set is character, and the GCHART group is numeric or vice versa.
User Action: Check for misspelling or wrong variable assignment, or check for quotes in the assignment statement.
Explanation: The SUBGROUP variable in the Annotate data set is character, and the GCHART subgroup is numeric or vice versa.
User Action: Check for misspelling or wrong variable assignment, or check for quotes in the assignment statement.
Explanation: Variables named both MIDPOINT and MIDPNT or SUBGROUP and SUBGRP occur in the Annotate data set.
User Action: Determine which variable has the proper values for the Annotate data set and either delete the other variable or rename MIDPNT to MIDPOINT and SUBGRP to SUBGROUP.
Explanation: Both the x and y coordinates supplied are outside the visible display area.
User Action: Check for improper or inappropriate coordinate system specification or coordinates out of range.
Explanation: The GROUP variable in the Annotate data set contains a missing value.
User Action: If the GROUP= option is specified in the GCHART procedure, the Annotate GROUP variable cannot contain missing values. Remove the missing value from the request. Check reference system for data-dependent request.
Explanation: Data coordinate system was requested and the X, Y and SUBGROUP variables contain missing values.
User Action: The X, Y or SUBGROUP variable must have a value if a data coordinate system is requested. Check stream for improper request.
Explanation: You used a data coordinate system and specified GROUP= in the GCHART procedure, but the Annotate data set does not contain the GROUP variable.
User Action: Supply the GROUP variable in the Annotate data set.
Explanation: The specified value of the XC variable is not on the x axis of the graph or chart. The observation is ignored.
User Action: Check for misspelling, for uppercase or lowercase conflict, or for exclusion in an axis specification.
Explanation: The specified value of the YC variable does not occur on the y axis of the graph or chart. The observation is ignored.
User Action: Check for misspelling, for uppercase or lowercase conflict, or for exclusion in an axis specification.
Explanation: The axis type is character and the x and y coordinates are numeric or vice versa.
Explanation: The data coordinate systems 1, 2, 7, 8 are not permitted for this statement.
User Action: Choose a different reference system for this observation.
Explanation: The coordinate specified is not on displayed graph, and data coordinate system placement has been requested.
User Action: Check for improper specification of data value or graph axis parameters, or incorrect system specification. If this occurs, you may be able to use percent of the data area to position Annotate graphics.
Explanation: Not all requested XSYS, YSYS, and ZSYS variable values are data values.
User Action: If one variable in G3D annotation is data-dependent, all variables must be data-dependent. Either specify all points in the data coordinate system or use another reference system value.
Explanation: The X, Y, or Z variable contained a missing value.
User Action: All values in G3D data placement requests must be specified. Remove the missing value from the request.
Explanation: The limit of stack positions has been exhausted. The maximum number of stack positions is system-dependent. Each PUSH operation uses one position; each POP frees one position for re-use.
User Action: Rewrite the program section to decrease the number of values stored in the stack.
Explanation: The POP function has been issued with no values in the LIFO stack.
User Action: Check for unequal numbers of PUSH versus POP functions. They can be unequal, but you cannot have more values moved with the POP function than are stored with the PUSH function. At least one PUSH must occur {it before} a POP can be issued.
Explanation: A TEXT variable has not been found for the LABEL function.
User Action: If FUNCTION='LABEL', the TEXT variable must contain the string to be placed in the display area. Check for misspelling of variable name or specification of the wrong Annotate data set.
Explanation: An invalid special line value has been specified.
User Action: The LINE value specified was not acceptable for FUNCTION='BAR' or the RECT macro. Check function for definition of line values or previous value used in DATA step prior to this observation.
Explanation: The LINE value specified is not in the range 1 through 46.
User Action: Check for improper specification of data value. Line styles represented by the LINE values can be found in the line-type table.
Explanation: The combinations of available X, Y, XC, YC, GROUP, MIDPOINT, and SUBGROUP variables do not identify the data-dependent values uniquely.
Explanation: The X, XC, Y, or YC variables have not been found in the Annotate data set.
User Action: The X or XC and Y or YC variables must be in the data set. This message represents a minimum validity check of the supplied Annotate data set.
Explanation: The POLYCONT function was encountered with no POLY function specification.
User Action: Probable sequencing error. Check for missing POLY command, improper ordering of polygon points, or interruption of POLY type commands by other valued functions. Also, check the value of WHEN for a mismatch.
Explanation: A POLYCONT definition has been interrupted and resumed in the Annotate data set. This usually accompanies the error message
POLYCONT ENCOUNTERED BEFORE POLY
Explanation: The value of the POSITION variable is not in range '0' through '9' or 'A' through 'F' or '<', '+', or '>' in a LABEL command.
User Action: Check desired value in POSITION description and correct.
Explanation: The maximum allocation for polygon points is exhausted. The maximum number of vertices is limited by a device's memory.
User Action: Define polygon with fewer points or break polygon into sections.
Explanation: The value supplied for the XSYS, YSYS, or HSYS variable is not valid.
User Action: Check the desired value and correct the data set.
Explanation: The text string is too long.
User Action: Check for excessive SIZE value or shorten the string. This error could be caused by HSYS='4' and a small value of the VPOS graphics option.
Explanation: The X variable is character type in the Annotate data set when it should be numeric.
User Action: If character data are being plotted, use the XC variable to specify any data-related points pertaining to character values. If data are not character, omit quotes in X data value assignment.
Explanation: The Y variable is character type in the Annotate data set when it should be numeric.
User Action: If character data are being plotted, use the YC variable to specify any data-related points pertaining to character values. If data are not character, omit quotes in Y data value assignment.
Explanation: The value of the STYLE variable is not a valid font or pattern.
User Action: Check the value supplied for misspelling, truncation, and support in the FUNCTION description.
Explanation: The value in the FUNCTION variable is not recognized as an available function.
User Action: Check for misspellings or truncation of value. Truncation can be corrected by specifying a length of 8 bytes in the LENGTH statement in the DATA step that generates the data set.
Explanation: The SIZE value of the variable is negative or excessive.
User Action: Check request or calculation for positive value result.
Explanation: The length is incorrect for variable indicated. Either the length of the character string exceeds the length for the variable specified in a LENGTH statement, or the variable was not specified in a LENGTH statement.
User Action: Make sure the variable length is defined in a length statement and that the length specified adequately covers the length of the character strings that are used.
Explanation: The data type does not match required type for variable listed. Either variable type is character where a numeric is required, or numeric where a character is required.
User Action: Specify proper type for variable as described in Annotate Variables.
Copyright © 2010 by SAS Institute Inc., Cary, NC, USA. All rights reserved.