Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Syntax:

Unix:
     codegen   -model model_name
                [-directory directory_name]
                [-config filename]
                [-help [help_dir] | -syntax [help_dir] | -version]
                [-units unit_name...]
                [-generate separate | combined |  bodies | specs]
                [-comment statement_type...]
                [-uncomment statement_type...]
                [-nocode statement_type...]
                [-directives]
                [-suffix suffix]
                [-autogen prepend | append | preserve | replace]
                [-old_style]


VMS:
     codegen    /model=model_name
                [/directory=directory_name]
                [/config=filename]
                [/help[=help_dir] | /syntax[=help_dir] | /version]
                [/units=unit_name... ]
                [/generate=separate | combined |  bodies | specs]
                [/comment=statement_type... ]
                [/uncomment=statement_type... ]
                [/nocode=statement_type... ]
                [/directives]
                [/suffix=suffix]
                [/autogen=prepend | append | preserve | replace]
                [/old_style]

OS/2:
     codegen    /model:model_name
                [/directory:directory_name]
                [/config:filename]
                [/help[:help_dir] | /syntax[:help_dir] | /version]
                [/units:(unit_name...)]
                [/generate:separate | combined |  bodies | specs]
                [/comment:(statement_type...) ]
                [/uncomment:(statement_type...) ]
                [/nocode:(statement_type... ) ]
                [/directives]
                [/suffix:suffix]
                [/autogen:prepend | append | preserve | replace]
                [/old_style]

Program Description:
    The ADA Source Builder (ASB) generates ADA source code from Teamwork model
objects.

Options:
    model <model_name>      Specifies a model name.
    config <config_file>    Specifies a configuration file.
                                 (Default: /cadre/tsa/config_file)
    help <help_dir>         Shows the full help screen (this information)
                                 and exits.  The optional argument indicates
                                 the directory that contains the help file.
    syntax <help_dir>       Shows the short help screen (syntax lines only)
                                 and exits.  The optional argument indicates
                                 the directory that contains the help file.
    version                 Shows the program header and the teamwork
                                 version, and exits.
    options                 Shows the command line options chosen, before
                                 executing the program.
    units <unit_name...>    Specifies the list of library level units for
                                which code is to be generated
    generate separate       Specifies that the specification and body for each
                                library unit are to be written to separate files
             combined       Specifies that the specification and body for each
                                library unit are to be written to a single file
             bodies         Specifies that only the body code for each library
                                unit is to be generated
             specs          Specifies that only the specification code for each
                                library unit is to be generated
    comment <statement_type> Specifies that the listed <statement_type>s
                                are to be generated as commentary.  Legal
                                statement types are as follows:
                                 accepts - entry accept statements,
                                 calls - subprogram, and entry call statements
                                 types - data type declarations
                                 data - data object declarations
                                 handlers - exception handling statements
                                 raises - exception raise statements
                                 returns - return statements
    uncomment <statement_type> Specifies that the listed <statement_type>s
                                are to be generated as code.  Legal
                                statement types are as follows:
                                 accepts - entry accept statements,
                                 calls - subprogram, and entry call statements
                                 types - data type declarations
                                 data - data object declarations
                                 handlers - exception handling statements
                                 raises - exception raise statements
                                 returns - return statements
    nocode <statement_type> Specifies that the listed <statement_type>s
                                are to be excluded from the generated code.  Legal
                                statement types are as follows:
                                 accepts - entry accept statements,
                                 calls - subprogram, and entry call statements
                                 types - data type declarations
                                 data - data object declarations
                                 handlers - exception handling statements
                                 raises - exception raise statements
                                 returns - return statements
    directives              Specifies that ADA code injector directives are to
                                be inserted into the generated ADA code
    suffix <suffix>         Specifies the suffix of each ADA source file generated
    autogen prepend         Specifies that the contents of the exception and
                                logic body code notes are to be generated and
                                prepended to the existing exception and logic
                                body notes.
            append          Specifies that the contents of the exception and
                                logic body code notes are to be generated and
                                appended to the existing exception and logic
                                body notes.
            replace         Specifies that the a new generation  of the
                                exception and logic body code notes are to be
                                generated and that the new generation will not
                                include any of the text of the previously
                                existing generations of those notes.
            preserve        Specifies that the contents of the exception and
                                logic body code notes are to be generated only
                                if no generation of the notes currently
                                exist.
    old_style               Specifies that comments are to be generated
                                preceeded by -- rather than ---.

Examples (Unix-format):

codegen -model manager_model
    Generates source code for all library units depicted on the CONTEXT ASG
    diagram in the model named manager_model.  Places each specification and
    each body in a separate file.

codegen -model manager_model -units q_manager

    Generates ADA source code for the library unit q_manager in the model named
    manager_model.  The body and specification of q_manager are written to
    separate files.

codegen -model manager_model -units q_manager -generate combined

    Generates ADA source code for the library unit q_manager in the model named
    manager_model.  The body and specification of q_manager are written to
    the same file.

codegen -model manager_model -units q_manager -generate combined @
         -nocomment accepts calls raises

    Generates ADA source code for the library unit q_manager in the model named
    manager_model.  The body and specification of q_manager are written to
    the same file. All calls, entry accepts and exception raises will be
    generated as code.

codegen -model manager_model -units q_manager -autogen replace


    Creates a new generation of the exception and body logic notes for the ASG
    q_manager in model manager_model.

codegen -model manager_model -suffix a

    Generates source code for all library units depicted on the CONTEXT ASG
    diagram in the model named manager_model.  Places each specification and
    each body in a separate file named <unit>.a

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026