Next: InitRoutine
Up: Property
Previous: ImplType

InitActuals

Description

The InitActuals property is used to further specify the implementation of a UniCon component. It is used to pass command line options to executable versions of programs when they are started at run-time. The typical usage of the property is to pass options to filters during pipe-and-filter system initialization at run-time.

Only one InitActuals property is accepted by the UniCon compiler for a given executable. Therefore, if an InitActuals property is specified in both the <component_implementation> and the <variant> property lists in the primitive implementation of a component, the UniCon compiler accepts only the one in the <component_implementation> property list.

The InitActuals property is typically specified in the <component_implementation> property list when the component has a composite implementation. It is otherwise generally found in the <variant> property list.

Property Lists

The InitActuals property can legally be specified in the property list in the following
UniCon language elements:

<component_implementation>
<variant>

Value Syntax

The syntax of the value part of the InitActuals property is a single "string" or
<identifier>, enclosed in parentheses. The case of the letters is significant. The command line options are passed unchanged to the associated executable program in the run-time environment.

Required Rule

Optional

There is no default value for the InitActuals property.

Merge Rule

REPLACE

Subsequent specifications of the InitActuals property in a single property list replace earlier specifications (i.e., the last specification is the one that the UniCon compiler uses).

Semantic Checks

No semantic checks are performed on the value of the InitActuals property.

Example

The following are two examples of specifications of InitActuals properties. The first example is embedded in the property list of a <variant> definition:

  VARIANT My_Sort_Filter IN "sort"
    IMPLTYPE (Executable)
    INITACTUALS ("-f")
  END My_Sort_Filter

The second example is embedded in the <component_implementation> property list of a composite implementation:

  IMPLEMENTATION IS
    INITACTUALS ("-f")

    USES main INTERFACE Sort_Main
    USES sort INTERFACE Sort
    USES libc INTERFACE Libc

    BIND input TO ABSTRACTION
      MAPSTO (main.libc.fgets)
    END input
    BIND output TO ABSTRACTION
      MAPSTO (main.libc.fprintf)
    END output

    ESTABLISH C-PLBundler WITH 
      main.sort_routines AS participant
      sort.sort_routines AS participant
    END C-PLBundler

    ESTABLISH C-PLBundler WITH 
      main.libc AS participant
      libc.libc AS participant
    END C-PLBundler
  END IMPLEMENTATION