apm_package_instance_new (public)

 apm_package_instance_new -package_key package_key \
    [ -instance_name instance_name ] [ -package_id package_id ] \
    [ -context_id context_id ]

Defined in packages/acs-tcl/tcl/apm-procs.tcl

Creates a new instance of a package and calls the post instantiation proc, if any. If the package is a singleton and already exists then this procedure will silently do nothing.

Switches:

-package_key (required)

The package_key of the package to instantiate.

-instance_name (optional)

The name of the package instance, defaults to the pretty name of the package type.

-package_id (optional)

The id of the new package. Optional.

-context_id (optional)

The context_id of the new package. Optional.

Returns:

The id of the instantiated package

Testcases:

test_apm_package_instance__new