The GANTT Procedure

 
Macro Variable _ORGANTT

The GANTT procedure defines a macro variable named _ORGANTT, which is set at procedure termination. This variable contains a character string that indicates the status of the procedure and also provides chart specific information with respect to each Gantt chart produced by invocation of the GANTT procedure. This includes charts resulting from multiple CHART statements and BY groups.

The format of the _ORGANTT string for a GANTT procedure invocation with n CHART statements is as follows:

STATUS= REASON= CHART1 chart1info # ...CHARTn chartninfo #

where the value of STATUS= is either SUCCESSFUL or ERROR_EXIT, and the value of REASON= is one of the following:

  • BADDATA_ERROR

  • MEMORY_ERROR

  • IO_ERROR

  • SEMANTIC_ERROR

  • SYNTAX_ERROR

  • GANTT_BUG

  • UNKNOWN_ERROR

The notation chartiinfo is a string of the form

SCALE= INCREMENT= SKIP= HPAGES= VPAGES= SEGNAME=

if there are no BY groups, and it is a string of the form

BY1 by1info: ...BYm byminfo:

where byjinfo is a string of the form

SCALE= INCREMENT= SKIP= HPAGES= VPAGES= SEGNAME=

if there are m BY groups. In other words, the macro contains an informational substring for every chart produced, using the symbol "#" as a CHART statement delimiter and the symbol ":" as a BY statement delimiter within CHART statements.

The chart specific information given in _ORGANTT is described below along with the identifying keyword preceding it. It should be noted that these values refer to those actually used in producing the chart and are not necessarily the same as those specified in the invocation of the procedure.

  • SCALE= The value of scale

  • INCREMENT= The value of increment

  • SKIP= The value of skip

  • HPAGES= The number of horizontal pages

  • VPAGES= The number of vertical pages

  • SEGNAME= The name of the first chart segment in graphics mode

Note: Some of the information may be redundant or predictable in certain display modes. For example, the value of SEGNAME= is empty in line-printer and full-screen modes. The values of HPAGES= and VPAGES= are equal to 1 in full-screen mode.

This information can be used when PROC GANTT is one step in a larger program that needs to determine whether the procedure terminated successfully or not. Because _ORGANTT is a standard SAS macro variable, it can be used in the ways that all macro variables can be used.