This document covers the following topics:
An application available on the current application server. Applications and the application server are only available with Natural Single Point of Development. See also Remote Development Using SPoD.
The following properties are available:
Used to navigate to the parent interface of this interface.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| HANDLE OF OBJECT | VT_DISPATCH (INatAutoApplications) | Get only |
Used to navigate to the root interface.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| HANDLE OF OBJECT | VT_DISPATCH (INatAutoStudio) | Get only |
TRUE if this is a base application.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| L | VT_BOOL | Get only |
TRUE if this is a base application on a mainframe platform. FALSE if this is a base application on an Open Systems platform or a compound application.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| L | VT_BOOL | Get only |
TRUE if this application is mapped into the application workspace.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| L | VT_BOOL | Get only |
TRUE if
this is a base application, and
the application is mapped into the application workspace, and
there is a connection to a server session.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| L | VT_BOOL | Get only |
TRUE if
this is a base application, and
the application is mapped into the application workspace, and
there is a connection to a server session, and
the application is the active one.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| L | VT_BOOL | Get only |
Name of the application.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| A | VT_BSTR |
The description of the application.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| A | VT_BSTR |
The host name of the development server. Returns an empty string for a compound application.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| A | VT_BSTR | Get only |
The port number of the development server. Returns 0 for compound applications.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| I4 | VT_I4 | Get only |
The profile (mainframe) or NATPARM parameter file (Open
Systems) under which the development server is running. Returns an empty string
for compound applications.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| A | VT_BSTR | Get only |
The profile database number of the development server. Returns 0 for compound applications and for base applications running on Open Systems platforms.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| I4 | VT_I4 | Get only |
The profile file number of the development server. Returns 0 for compound applications and for base applications running on Open Systems platforms.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| I4 | VT_I4 | Get only |
The user ID under which a base applicaton is mapped. Returns an empty string for compound applications.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| A | VT_BSTR | Get only |
The main library of the application. Returns an empty string for compound applications and for base applications for which no main library has been defined.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| A | VT_BSTR |
TRUE if a base application has linked objects. Always FALSE for compound applications.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| A | VT_BSTR | Get only |
Returns the list of objects linked to a base application, formatted as an XML document according to the DTD shown below. Returns an empty document for compound applications.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| A | VT_BSTR | Get only |
<?xml version="1.0"?> <!ELEMENT aobjects (ccount, aobject*)> <!ELEMENT ccount (#PCDATA)> <!ELEMENT aobject (atype, akey)> <!ELEMENT atype (#PCDATA)> <!ELEMENT akey (#PCDATA)>
| Element | Meaning |
|---|---|
| ccount | The number of objects in the list. |
| atype | The type of the object. This must be one of the predefined development object types that is allowed to be used as entry object of an application. |
| akey | The key that identifies the object within its type. |
Returns the list of entry objects linked to a base application, formatted as an XML document according to the DTD shown below. Returns an empty document for compound applications.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| A | VT_BSTR | Get only |
<?xml version="1.0"?> <!ELEMENT aobjects (ccount, aobject*)> <!ELEMENT ccount (#PCDATA)> <!ELEMENT aobject (atype, akey)> <!ELEMENT atype (#PCDATA)> <!ELEMENT akey (#PCDATA)>
| Element | Meaning |
|---|---|
| ccount | The number of objects in the list. |
| atype | The type of the object. This must be one of the predefined development object types that is allowed to be used as entry object of an application. |
| akey | The key that identifies the object within its type. |
Returns the Natural environment of a base application. Returns NULL-HANDLE for compound applications.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| A | VT_BSTR | Get only |
Returns the collection of applications linked to a compound application. Returns NULL-HANDLE for base applications.
| Natural Data Format | Variant Type | Remark |
|---|---|---|
| A | VT_BSTR | Get only |
The following methods are available:
Maps an application into the application workspace.
| Name | Natural Data Format | Variant Type | Remark |
|---|---|---|---|
| UserID | A | VT_BSTR | Optional |
| Password | A | VT_BSTR | Optional |
| ProfilePassword | A | VT_BSTR | Optional |
| Quiet | L | VT_BOOL | Optional |
| IgnoreWarnings | L | VT_BOOL | Optional |
The user ID under which the application will be mapped.This parameter is ignored for compound applications
The password of the user ID under which the application will be mapped. This parameter is ignored for compound applications.
The password for the profile which has been defined for the application. This parameter is ignored for compound applications.
If set to FALSE or not specified, the Map Application dialog is shown if the session cannot be started with the given parameters.The dialog is then preset with the given parameters.
If set to TRUE, the Map Application dialog is not shown.
If set to FALSE or not specified, warnings that occur during mapping are treated like errors.
If set to TRUE, warnings are ignored.
Unmaps the application.
If this application was the active one, the previously active application gets activated.
Connects an application to a development server session.
This method is not applicable to compound applications or base applications that are already connected.
| Name | Natural Data Format | Variant Type | Remark |
|---|---|---|---|
| UserID | A | VT_BSTR | Optional |
| Password | A | VT_BSTR | Optional |
| ProfilePassword | A | VT_BSTR | Optional |
| Quiet | L | VT_BOOL | Optional |
| IgnoreWarnings | L | VT_BOOL | Optional |
The user ID under which the application will be connected.
The password of the user ID under which the application will be connected.
The password of the profile which is defined for the application.
If set to FALSE or not specified, the Map Application dialog is shown if the session cannot be started with the given parameters. The dialog is then preset with the given parameters.
If set to TRUE, the Map Application dialog is not shown.
If set to FALSE or not specified, warnings that occur during connecting are treated like errors.
If set to TRUE, warnings are ignored.
Disconnects the application (closes the development server session).
If this application was the active one, the previously active application gets activated.
This method is not applicable to compound applications or base application that are already disconnected.
Makes this application the active one.
An application cannot explicitly be deactivated. An application is implicitly deactivated when another application is activated.
This method is not applicable to compound applications or base application that are disconnected or not mapped.
Removes the application from the collection (effectively deletes it from the application server).
If this application was the active one, the previously active application gets activated.
Links the specified development object to the application. Applicable only to base applications.
| Name | Natural Data Format | Variant Type | Remark |
|---|---|---|---|
| Type | I4 | VT_I4 | |
| Object | A | VT_BSTR | |
| Library | A | VT_BSTR | Optional |
The type numbers used here correspond to the type numbers described in the section Predefined Node Types.
The name of the object.
The library containing the object. This parameter is not applicable to DDMs.
Unlinks the specified object from the application. Applicable only to base applications.
| Name | Natural Data Format | Variant Type | Remark |
|---|---|---|---|
| Type | I4 | VT_I4 | |
| Object | A | VT_BSTR | |
| Library | A | VT_BSTR | Optional |
The type numbers used here correspond to the type numbers described in the section Predefined Node Types.
The name of the object.
The library containing the object. This parameter is not applicable to DDMs.
Links the specified entry point to the application. Applicable only to base applications.
| Name | Natural Data Format | Variant Type | Remark |
|---|---|---|---|
| Type | I4 | VT_I4 | |
| Object | A | VT_BSTR | |
| Library | A | VT_BSTR |
The type numbers used here correspond to the type numbers described in the section Predefined Node Types.
The name of the entry point object.
The library containing the entry point object.
Unlinks the specified entry point object from the application. Applicable only to base applications.
| Name | Natural Data Format | Variant Type | Remark |
|---|---|---|---|
| Type | I4 | VT_I4 | |
| Object | A | VT_BSTR | |
| Library | A | VT_BSTR |
The type numbers used here correspond to the type numbers described in the section Predefined Node Types.
The name of the entry point object.
The library containing the entry point object.
