Syntax:
Unix:
autograf -all | -object obj_name [obj_name...]
-in_model input_model_name | -in_cdif cdif_input_file
-out_model output_model_name | -out_cdif cdif_output_file
-type sc [-merge_into merge_obj_name]
[-expand number_of_levels] [-config config_file]
[-generation generation_number]
[-help [help_dir] | -syntax [help_dir] | -version]
[-options] [-arg_input filename] [-noheader]
[-quiet] [-ask] [-unix] [-vms] [-os2]
VMS:
autograf /all | /object=(obj_name,obj_name,...)
/in_model=input_model_name | /in_cdif=cdif_input_file
/out_model=output_model_name | /out_cdif=cdif_output_file
/type=sc [/merge_into=merge_obj_name]
[/expand=number_of_levels] [/config=config_file]
[/generation=generation_number]
[/help [=help_dir] | /syntax [=help_dir] | /version]
[/options] [/arg_input=filename] [/noheader]
[/quiet] [/ask] [/unix] [/vms] [/os2]
OS/2:
autograf /all | /object:(obj_name,obj_name,...)
/in_model:input_model_name | /in_cdif:cdif_input_file
/out_model:output_model_name | /out_cdif:cdif_output_file
/type:sc [/merge_into:merge_obj_name]
[/expand:number_of_levels] [/config:config_file]
[/generation:generation_number]
[/help [:help_dir] | /syntax [:help_dir] | /version]
[/options] [/arg_input:filename] [/noheader]
[/quiet] [/ask] [/unix] [/vms] [/os2]
Program Description:
This program builds a layout of a Teamwork Structure Chart, or
merges multiple Structure Charts, and places the resulting diagram in
a new Structure Chart. The program can be run from the command line via
the host system shell using the following options, or from within
Teamwork via a User Menu (see "User Menu Selections" below).
Options:
all Specifies that all Structure Charts in the input
Teamwork model or CDIF file are to be
processed. These will be laid out
individually, or merged according to the
-merge_into option.
USE WITH CAUTION WITH TEAMWORK MODEL INPUT.
object <obj_name...> Specifies the name(s) of the Structure Charts
to layout. If multiple objects are
specified, they will be merged, or laid
out individually according to the
-merge_into option.
in_model <model_name> Indicates the name of the Teamwork model that
contains the Structure Charts to layout.
in_cdif <input_file> Indicates the pathname of the CDIF file that
contains the Structure Charts to layout.
Default: use Teamwork model.
out_model <model_name> Indicates the name of the Teamwork model that
is to contain the laid out Structure Charts.
out_cdif <output_file> Indicates the pathname of the CDIF file that
is to contain the new Structure Charts.
Default: use Teamwork model.
type sc Specifies that Structure Charts are to be
processed. In future versions, other types
of diagrams will be laid out.
merge_into <obj_name> Specifies that the input Structure Charts are to
be merged and specifies the name of the
Teamwork Structure Chart that is to contain
the merged, laid-out diagram. Merging means
that modules and connectors with identical
names will be combined on the laid out
diagram.
expand <num_levels> Indicates the number of levels of off-page
connectors to recursively expand and merge.
If this option is specified, then the
'merge_into' option must also be specified.
Default: do not expand off-page connectors.
config <config_file> Specifies the Teamwork configuration file.
Default: /cadre/tsa/config_file
generation <gen_number> Indicates the generation number of the first
Structure Chart to open.
Default: latest generation.
help <help_dir> Shows the full help screen
(this information) and quits.
syntax <help_dir> Shows the short help screen (syntax lines
only) and quits.
version Shows the program header with the version
and quits.
options Shows the command line options chosen before
program execution.
arg_input <input_file> Indicates more command line options are in
the file identified by the argument.
noheader Suppresses display of the program header
before program execution.
quiet Suppresses status messages during
program execution.
ask Prompts user for the entry of command line
options not provided.
unix Allows entry of options in Unix format
(-example_option arg).
vms Allows entry of options in VMS format
(/example_option=arg).
os2 Allows entry of options in OS2 format
(/example_option:arg).
User Menu Selections:
The User Menu for the PI Editor is in /cadre/samples/menus/pi_ag.um.
The one for the SC Editor is in /cadre/samples/menus/sc_ag.um.
Layout Sheet Draws a new sheet with the newly produced diagram
and opens a window on it.
Expand Connector Merges the sheet named by the selected connector
with the current sheet. The new diagram
is placed in a new sheet with the current
sheet name (or with a new sheet name if
a name is specified via Set New Name).
This selection does not appear in the
PI Editor.
Expand Levels Displays a form on which to specify the number
of levels in a Structure Chart to recursively
expand and merge with the current sheet.
Set New Name Displays a form on which to specify a name for
the new diagram. From the PI, you can view
the updated diagram after layout by selecting
Reread DB from the File menu.
Help Displays the Help file text.
Configuration File Options:
# Sets the distance from the left of the world to the left of the
# left-most module of the SC.
AUTOGRAPH_OVERALL_LEFT_MARGIN=400
# Sets the distance from the top of the world to the top of the root.
AUTOGRAPH_OVERALL_TOP_MARGIN=350
# Sets the vertical spacing from the bottom of the tallest module in a
# level to the top of the couple-bearing-invoc-segment of the next level
# down.
AUTOGRAPH_INTER_LEVEL_SPACING=75
# Sets the horizontal spacing between direct siblings.
AUTOGRAPH_INTER_MODULE_SPACING=20
# Sets the horizontal spacing between modules that are adjacent but
# not direct siblings (i.e., they are cousins with a common grandparent).
AUTOGRAPH_INTER_TREE_SPACING=40
# Sets the vertical spacing between couples on the same side of an
# invocation.
AUTOGRAPH_INTER_COUPLE_SPACING=20
# Specifies the fraction of the AUTOGRAPH_INTER_LEVEL_SPACING where the
# bend points occur along an invocation. A setting of .5 will yield a
# horizontal middle segment.
AUTOGRAPH_BEND_FRACTION=0.20
# Specifies the margin of space around a textblock to the edge
# of a module.
AUTOGRAPH_TEXT_MARGIN=10
# Controls whether or not library modules are shown on the SC.
AUTOGRAPH_LIBRARY_MODULES=ON
# Controls whether modules are sized by their textblocks.
AUTOGRAPH_SIZE_BY_TEXTBLOCK=TRUE
# Controls whether modules are sized by the maximum dimensions of
# all modules.
AUTOGRAPH_SIZE_BY_MAXIMUM=FALSE
# Controls which side of the invocation couples are placed on.
# CW (clockwise) is the left side of a downward-pointing couple.
AUTOGRAPH_INPUT_COUPLE_SIDE=CW
AUTOGRAPH_OUTPUT_COUPLE_SIDE=CCW
AUTOGRAPH_INOUT_COUPLE_SIDE=CCW