This document covers the following topics:

• Purpose

• Properties

• Methods

---

Purpose

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.

Properties

The following properties are available:

• Parent

• Studio

• BaseApplication

• MainframeApplication

• Mapped

• Connected

• Active

• Name

• Description

• Host

• Port

• Profile

• ProfileDBnr

• ProfileFnr

• UserId

• MainLibrary

• HasLinkedObjects

• LinkedObjects

• LinkedEntries

• Environment

• LinkedApplications

Parent

Used to navigate to the parent interface of this interface.

Natural Data Format	Variant Type	Remark
HANDLE OF OBJECT	VT_DISPATCH (INatAutoApplications)	Get only

Studio

Used to navigate to the root interface.

Natural Data Format	Variant Type	Remark
HANDLE OF OBJECT	VT_DISPATCH (INatAutoStudio)	Get only

BaseApplication

TRUE if this is a base application.

Natural Data Format	Variant Type	Remark
L	VT_BOOL	Get only

MainframeApplication

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

Mapped

TRUE if this application is mapped into the application workspace.

Natural Data Format	Variant Type	Remark
L	VT_BOOL	Get only

Connected

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

Active

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

Name of the application.

Natural Data Format	Variant Type	Remark
A	VT_BSTR

Description

The description of the application.

Natural Data Format	Variant Type	Remark
A	VT_BSTR

Host

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

Port

The port number of the development server. Returns 0 for compound applications.

Natural Data Format	Variant Type	Remark
I4	VT_I4	Get only

Profile

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

ProfileDBnr

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

ProfileFnr

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

UserId

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

MainLibrary

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

HasLinkedObjects

TRUE if a base application has linked objects. Always FALSE for compound applications.

Natural Data Format	Variant Type	Remark
A	VT_BSTR	Get only

LinkedObjects

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

Document Type Description

<?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.

LinkedEntries

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

Document Type Description

<?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.

Environment

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

LinkedApplications

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

Methods

The following methods are available:

• Map

• Unmap

• Connect

• Disconnect

• Activate

• Remove

• LinkObject

• UnlinkObject

• LinkEntry

• UnlinkEntry

Map

Maps an application into the application workspace.

Parameters:

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

UserID

The user ID under which the application will be mapped.This parameter is ignored for compound applications

Password

The password of the user ID under which the application will be mapped. This parameter is ignored for compound applications.

ProfilePassword

The password for the profile which has been defined for the application. This parameter is ignored for compound applications.

Quiet

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.

IgnoreWarnings

If set to FALSE or not specified, warnings that occur during mapping are treated like errors.

If set to TRUE, warnings are ignored.

Unmap

Unmaps the application.

If this application was the active one, the previously active application gets activated.

Connect

Connects an application to a development server session.

This method is not applicable to compound applications or base applications that are already connected.

Parameters

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

UserID

The user ID under which the application will be connected.

Password

The password of the user ID under which the application will be connected.

ProfilePassword

The password of the profile which is defined for the application.

Quiet

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.

IgnoreWarnings

If set to FALSE or not specified, warnings that occur during connecting are treated like errors.

If set to TRUE, warnings are ignored.

Disconnect

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.

Activate

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.

Remove

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.

LinkObject

Links the specified development object to the application. Applicable only to base applications.

Parameters

Name	Natural Data Format	Variant Type	Remark
Type	I4	VT_I4
Object	A	VT_BSTR
Library	A	VT_BSTR	Optional

Type

The type numbers used here correspond to the type numbers described in the section Predefined Node Types.

Object

The name of the object.

Library

The library containing the object. This parameter is not applicable to DDMs.

UnlinkObject

Unlinks the specified object from the application. Applicable only to base applications.

Parameters

Name	Natural Data Format	Variant Type	Remark
Type	I4	VT_I4
Object	A	VT_BSTR
Library	A	VT_BSTR	Optional

Type

The type numbers used here correspond to the type numbers described in the section Predefined Node Types.

Object

The name of the object.

Library

The library containing the object. This parameter is not applicable to DDMs.

LinkEntry

Links the specified entry point to the application. Applicable only to base applications.

Parameters

Name	Natural Data Format	Variant Type	Remark
Type	I4	VT_I4
Object	A	VT_BSTR
Library	A	VT_BSTR

Type

The type numbers used here correspond to the type numbers described in the section Predefined Node Types.

Object

The name of the entry point object.

Library

The library containing the entry point object.

UnlinkEntry

Unlinks the specified entry point object from the application. Applicable only to base applications.

Parameters

Name	Natural Data Format	Variant Type	Remark
Type	I4	VT_I4
Object	A	VT_BSTR
Library	A	VT_BSTR

Type

The type numbers used here correspond to the type numbers described in the section Predefined Node Types.

Object

The name of the entry point object.

Library

The library containing the entry point object.