Installation

Property

Function

Additional Install Script

This script is called after the AB Suite Deployment process. It is run after the application has been successfully deployed and is used to run user-specific post-deployment configuration steps.

By default, this property is empty.

This property is enabled if Deployable is set to True, and Stop Deployment After is not set to Generate.

This property is specific to Folders only.

An example would be to copy Winform configuration files to a file server to automate Winform distribution.

Additional Uninstall Script

This script is called after the AB Suite application is deleted, usually from the Admin tool. It is run after the component has been removed and any DBReorg operations. It is used to run user-specific post-uninstallation clean up steps.

By default, this property is empty.

This property is enabled if Deployable is set to True, and Stop Deployment After is not set to Generate.

This property is specific to Folders only.

An example would be to de-register third party external components that are no longer used or needed after the AB Suite application is removed.

Clone Database

Specifies whether to clone the database for use as a secondary remote database.

This property is only valid if you set a valid name in the RDB Configuration property.

By default, this property is set to False.

This property is specific to Segments only.

Deployment Host

Specifies the name of the deployment server.

For Unix, it is the DNS name or the IP address of the machine where the application is to be deployed.

By default, this property is empty.

This property is enabled if Deployable is set to True, and Stop Deployment After is set to Install or Run.

Note: For a Windows host, precede the name with a double backslash \\, unless the entry is localhost.

This property is specific to Folders not contained within a segment.

Deployment Interface Type

Currently only one deployment interface is supported, which is the Default Windows Deployer.

This property is specific to Folders only.

Deployment Port Number

For Unix, it is the port number of the host where the application is to be deployed.

DMSII Pack

Specifies the name of the pack (location) where an alternative version of DMS II software is located. This pack and the value entered in the DMS II Usercode field identify the alternative version of DMS II to be used when building the DASDL source and by the deployment phase when compiling the database.

Select a pack from the list of available packs. By default, this property is empty.

This property is specific to Segments only.

DMSII Usercode

Specifies the usercode for use with an alternative version of DMS II software. This usercode and the value entered in the DMS II Pack field identify the alternative version of DMS II to be used when building the DASDL source and by the deployment phase when compiling the database.

This property is limited to a maximum length of 17 alphanumeric characters.

By default, this property is empty.

This property is specific to Segments only.

External Installer File Deployment Script

Specifies a script that is executed during installation to install anything from the External Internal Files property. That is, to install anything that is not from Agile Business Suite.

By default, this property is empty.

This property is specific to Folders only.

Number of Parallel Compiles

Specifies the number of compile threads (multithreading) that runs concurrently.

By default, this property is set to 1. The numbers range from 1 to 99.

This property is specific to Segments only.

Number of Reorg Tasks

Specifies the maximum number of reorganization tasks that can occur simultaneously.

By default, this property is set to 1. The numbers range from 1 to 9999.

This property is specific to Segments only.

Package Installation Directory

Specifies the directory where the msi file installs, when it is run.

Type a valid DOS path. For example,

C:\my folder

By default, this property is empty.

This property is enabled if Deployable is set to True, and Stop Deployment After is not set to Generate.

This property is specific to Folders not contained within a segment.

Package Intermediate Directory

Specifies where the package installer file should be transferred before the installation process begins.

By default, this property is empty.

This property is enabled if Deployable is set to True, and Stop Deployment After is set to Transfer, Install or Run.

This property is specific to Folders only.

Package Name

Specifies the name of the msi file. By default, this property is set to the folder name. Package names must be unique within a project.

This property is enabled if Deployable is set to True.

This property is specific to Folders only.

RDB Configuration

Specifies the name of an RDB Configuration that is to be used in conjunction with this Configuration to setup or maintain a secondary database. Refer to the Backup, Recovery, and Remote Database in the Agile Business Suite Runtime for Clearpath MCP Administration Guide for more information on this feature.

By using Remote Database Backup, you can maintain an up-to-date copy of your production database on a different host for backup or recovery due to a disaster.

If you want to clone the database the next time the system is transferred, set the Clone Database property to True.

This property is limited to a maximum length of 17 characters. By default, this property is empty.

This property is specific to Segments only.

Reorg Allowedcore

Specifies the amount of memory that you require for database reorganization. The value is specified in words and is factored by 100,000 (1 = 100,000). If you enter a value greater than the amount of the available memory, the value is changed to eighty five percent of the available memory. This ensures that reorganization does not fail.

The property value ranges between 1 and 5,497,558 inclusive. By default, this property is set to zero. If zero or no value is entered in this property, the default value of this property is set to 100,000.

This property is specific to Segments only.

Reorg Preverify

Specifies when to use the DMSII PREVERIFY option with a database reorganization. If you set Reorg Preverify to True, a preverification task is initiated for each generated data set before reorganization actually begins. This task locks the structure, preventing changes until the reorganization starts. It then reads all records in the data set to ensure the verify condition for records (for example, that required items are not null).

PREVERIFY is not permitted with the REORGDB option. You have to ensure that the Reorg Preverify property is set to False before setting the Reorganziation Type property to REORGDB.

Refer to the Enterprise Database Server for ClearPath MCP Utilities Operations Guide for more information.

By default, this property is set to False.

This property is specific to Segments only.

Reorganisation Type

Specifies the reorganization options.

The following options are available for this property:

  • DMS Offline – Indicates that you do not want reorganizations to be audited, but you want to use the DMS II OFFLINE or NORESTART feature. When the reorganization is complete you are prompted to perform a database dump.

    Refer to the Enterprise Application Runtime Administration Guide for ClearPath MCP for more information on the Offline and NORESTART features.

  • Offline NoPostDump – Indicates that you do not want reorganizations to be audited, but you want to use the NOPOSTDUMP feature. This option is an extension of the DMS Offline option, but you are not prompted to perform a database dump.

  • Online Reorg – Indicates that you want reorganizations to be audited. This might slow down your reorganization time.

Reorganisation Type (continued)

  • ReorgDB – Indicates that you want to use the DMSII REORGDB option with the next reorganization. Refer to the Enterprise Database Server for ClearPath MCP Utilities Operations Guide for more information on the usage and constraints of the REORGDB option. You do not need to shut down your database during the reorganization if AutoSwap is set to True and no user intervention is required. However, if AutoSwap is set to False, you need to shut down your system briefly at the time the reorganized structures are swapped. This allows you to install software changes at the same time. When you are asked to enter AX SWAPNOW, you must bring your system down before responding to the request. The generate operation continues as normal after that, and you might restart you system after the generate operation completes. When this option is selected, the following REORGDB properties are enabled:

    • REORGDB DB Title

    • REORGDB CopyTo

    • REORGDB AutoSwap

    • REORGDB TotalCopyCore

    • REORGDB KeepRSN

    • REORGDB NoRestart

Regardless of the AutoSwap setting, if you use ReordDB, ensure that you terminate any active reports prior to the deployment if they reference any database structure that is reorganized.

By default, this property is set to DMS Offline.

This property is specific to Segments only.

REORGDB AllowedCore

Specifies the amount of core memory that can be used for the reorganized database copy.  The value is specified in words and is factored by 10,000 (1 = 10,000). This option for the REORGDB mode of reorganization serves the same purpose as the database ALLOWEDCORE parameter that is specified in DASDL.

Note: The DMSII REORGDBALLOWEDCORE option serves the role of database ALLOWEDCORE parameter only during the processing of updates. It does not have a role during the background OFFLINE reorganization.

By default, this property is set to 1000 (10,000,000 words). The numbers range from 1 to 99999.

This property must be set if Reorganization Type property is set to ReorgDB.

This property is specific to Segments only.

REORGDB AutoSwap

In this release of Agile Business Suite Runtime for Clearpath MCP, this property is ignored. The DMSII REORGDBAUTOSWAP option will always be set to FALSE.

This property must be set if Reorganisation Type property is set to ReorgDB.

By default, this property is set to False.

This property is specific to Segments only.

REORGDB CopyTo

Specifies the database location where the production database structures are captured and applied during a REORGDB reorganization. When the REORGDB CopyTo option is set to spaces, the pack name of the existing structure is used.

This property might be set if Reorganisation Type property is set to ReorgDB.

REORGDB KeepRSN

Specifies whether the KEEPRSN option is used with a REORGDB reorganization. Set this property to True to preserve the RSN value of new records created during a REORGDB reorganization.

This property is enabled when Reorganization Type is set to REORGDB.

By default, this property is set to False.

This property is specific to Segments only.

REORGDB NoRestart

Specifies that the reorganization cannot be restarted. Select this option to enable the reorganization of the database copy designated by the REORGDBTITLE to proceed without performing excessive input/output operations that can slow the process.

This property is enabled when Reorganization Type is set to REORGDB.

By default, this property is set to False.

This property is specific to Segments only.

REORGDB Title

Specifies the name of the database copy during a REORGDB reorganization.

This property must be set if Reorganization Type property is set to ReorgDB.

This property allows a maximum length of 50 characters.

By default, this property is empty.

This property is specific to Segments only.

REORGDB TotalCopyCore

Specifies the value to be used with the REORGDB TOTALCOPYCORE option. The value is specified in words and is factored by 10,000 (1 = 10,000).

This property must be set if the Reorganization Type property is set to ReorgDB.

By default, this property is set to 5000 (50, 000, 000 words). The numbers range from 1 to 99,999.

This property is specific to Segments only.

Sort Sets on Reorg

Specifies whether Agile Business Suite 1.1 Runtime for Clearpath MCP includes explicit statements in the BUILDREORG deck for reorganizing datasets (<<Ispec>> or Classes with no stereotype) and their sets or subsets (Profiles) when the deployment process has determined that a structure needs reorganizing. For large structures, this can be a more efficient reorganization of the dataset and its sets.

By default, this property is set to False.

This property is specific to Segments only.

Suggested Number of Class DLLs

Defines the number of classes that is included in each DLL. The number of DLLs is determined by dividing the number of classes by this property value.

For example, if Classes per DLL is set to 50 and you have 250 classes, you end up with 5 DLLs.

Every group class is counted as a class.

User Deployment Script

This property allows specific deployment processes to be developed, tailored to the user's requirements and deployment context. This script is run after the generated deployment package is produced and placed in the package intermediate directory. It can be used, for example, to manually copy and deploy the application across non-domain network scenarios, or to run specific pre-deployment configuration steps.

By default, this property is empty. If left empty, default process is used to control installation.

This property is enabled if Deployable is set to True, and Stop Deployment After is set to Install or Run.

This property is specific to Folders only.

Refer to the Visual Studio Online Help for more information on how to set up remote Windows script hosts.

WFL Family

Specifies the MCP Family statement to be used by the generate process for storing your system and system software files.

This property requires an entry if either of the following situations apply:

The system software required during the installation (for example, the compilers) is not resident on either the primary or alternate pack family of the WFL usercode family. To address this situation, enter the statement (where pack is the pack family of system software):

DISK = pack ONLY

To ensure all work files are kept on your primary family, enter (where pack is the pack family of system software and primary is the primary family):

DISK = primary OTHERWISE pack

You are placing some or all of the installed host software onto a pack family called DISK. To address this situation, enter the statement:

DISK = DISK ONLY

Or, if the system software is not on the pack family called DISK, enter (where pack is the pack family of system software):

DISK = DISK OTHERWISE pack

Note: If you specify an alternate pack, that is used as the alternate pack of the FAMILY statement associated with LSS and the Update programs within COMS, and therefore be the alternate pack for files accessed by those programs (for example, WFLs referenced by a START; command).

This property is limited to a maximum length of 44 characters.

By default, this property is empty.

This property is specific to Segments only.