IBS Enterprise Help Centre 9.0Business Suite 2016

Company generation

Related topics

IBS Enterprise applications are used within a company. In IBS Enterprise terms, a company is principally a database (or more accurately, a specific set of database files) with a unique company code and name.

Company generation is the process by which a company database and related program objects are created.

This document consists of the following sections:

Company generation overview

Creating a company consists of the following key steps:

  • Defining the company, entering company information, such as company name, address, etc.
  • Specifying a release for the company.
  • Specifying a life cycle-phase for the company.
  • Specifying an account dimension set for the company.
  • Activating applications, specifying which applications are to be active for this company.
  • Activating additional products, specifying which additional products to be active for this company.
  • Defining the database, specifying how the company database is to be created.
  • Creating the company, submitting the job to create the company.

Procedure

Use the following procedure to create a new company:

Preparation before creating a new company

Step To do
1 Sign on to IBS Enterprise.
2 Select the company from which you are going to run the generation. If possible, you should select a company within the same life-cycle phase as the company you are about to generate. If not possible, then you should select a company with a life-cycle phase that is nearest to it. The life-cycle phase order is:

  1. Development
  2. Integration test
  3. Quality control
  4. Customer acceptance
  5. Production
3 Run the Create/update object definition table task from menu IBSENV.
4 Check that the account dimension set that you are going to use for the company, which you are about to create, exists. Use the Work with dimension set definitions menu item from menu IBSINST.
5 It is recommended that you add the desired system-related records you want in the following three programs in the company you are running the generation from:

Program To do
Work with countries Add the system country for the companies you intend to generate.
Work with languages Add the system language for the companies you intend to generate, if different from those supplied.
Work with currencies Add both the system currency and base currency for the companies you intend to generate.

All these programs are accessed from the System setup tasks menu (IBSSET).

Creating a new company

Menu item/Panel To do
Create a new company (available from the Installation menu IBSINST) A list of all companies that exist in your environment is shown. Click Add to create a new company.
Work with companies Enter the company details as prompted. Some fields are optional, while others are mandatory. In addition, some fields must not be changed once the company is created and is in use. See the Panel help for details.

    Base system company
    Only shown for information purposes. It is set automatically to NO, and cannot be changed.

You must complete the following fields:

    System language
    System currency
    Base currency
    System country

Note: Press F4 to select from the records you added in the Preparation section before creating a new company, step 5.

You must also complete:

    Life-cycle phase
    Release level
    Dimension set

Click OK.

Application defn/company This panel is for application DBF. The company file library will contain the database files for all applications activated for this company, unless overridden for specific applications. A default name is proposed, which can be overridden.

The common file library, if specified, is intended to contain database files, which can be shared across several companies. In this way, you can maintain a single set of specific database files (for example, table data) for all companies, without having to maintain duplicate information. You need not enter a library name.

Click OK. Note: If the message "Library

does not exist" is displayed, then press F10 to create it.
Application defn/company You return to the first panel. The mandatory applications are shown as active. Activate the additional applications that are going to be active for the company. If you want to inactivate one or more applications, then select them and click Delete twice on the detail panel.

Note: You cannot inactivate mandatory applications. Plus, you can only activate one "country" application within each company. Click OK when ready.

Note: If any activated applications have prerequisite applications defined, and you have not already activated them, then you will receive a message telling you to do so now.
Release defn/company Note: You cannot do any manual changes on this panel. Click OK to confirm.
Additional products/company At this time, all installed additional products are shown as inactive for this company, except for products that are automatically activated, like IBSCOMMON. If you want to activate one or more additional products for the company, then select the product and click OK and click OK again on the detail panel. If you want to inactivate one or more activated additional products for the company, then select them and click Delete twice on the detail panel.

Click OK.
Library list entry The company library list entries displayed are built automatically, according to the release, life-cycle phase, dimension set code, applications and additional products activated for this company. Note: You cannot do any manual changes to the library list. Click OK.
Company generation You can choose to generate the database files for this company, or to copy them from an existing company. Generating the files is achieved by compiling the physical and logical file objects from the source. Copying the files generally takes significantly less time than generating them. In both cases, the database files that are created are empty; that is, they will not contain any data.

You may want to preload certain files with a copy of data from an existing company (for example, you may already have created a prototype company and want to copy table data you have already entered, rather than entering it again). You can do this in two ways:

Method To do
Using a copy set Specify the files you want to copy data from, by entering a copy set name. A copy set is simply a named list of physical files. Copy sets are maintained through the Work with system data copy set menu item on the System installation tasks menu (IBSINST).
Using a conversion set Specify the name of an existing conversion set. Application CVT (Data Conversion) must be installed. Conversion sets are maintained through the Work with conversion sets menu item on the Data conversion tasks menu (CVTDATA).



Note: You can copy data whether you choose to generate or copy the database files.

If you want to preload data in tables necessary for the activated applications, then set Run preload programs to YES. For information about the CCSID on database and LangId on database fields, see the Panel help.

You can specify the time that you want the company generation to start. Do not enter a time if you want the company generation to start immediately. Click OK.

Account part definition Complete the necessary information on the panel. See the Panel help for detailed information. Click OK.
The company creation job is now submitted to batch.

Ensure that the batch company generation job has completed successfully, before attempting to use the company. The job could take several hours. The actual time taken will depend on several factors such as the type of iSeries or iSeries processor, the amount of unused disk space available on your system and the level of system activity.

The company has now been created.

Follow up actions

You should now sign on to the new company. Many applications have system-defined table entries, which are automatically preloaded when the company is created. However, you must define information in the programs listed below before you can proceed. Note: You maintain the programs via the System setup tasks menu (IBSSET).

Program To do
Work with currencies You must add the system currency and base currency that you entered in Work with companies.

Note: Now you must restart the company with which you will work, by using Change company to reload the LDA, after having defined the system and base currencies.
Work with countries You must add the system country that you entered in Work with companies.

Note: Now you must restart the company again, by using Change company on the menu, to reload the LDA.
Work with IBS user profiles  

You also have to define additional parameters and table values in other tables/files, before the company can be used successfully. See the applicable application-related setup information.

Related topics