Configuring an instance

Your user profile must have its locale set to the locale of the instance you wish to create. Because the locale is set in the user profile, you might need to change your user profile, then sign off and back on before creating the instance

To create your Content Manager OnDemand instance:

1. Name the instance or use the default instance name of QUSROND. The instance name must be a valid library name for IBM® i. The instance name must start with an alphabetic character or @ followed by any of these characters: 0-9, A-Z, @, #, or underscore (_). Ensure that no library, user profile, or authorization list by that name already exists. Further, the instance name must not start with the letter Q (except for QUSROND), and must not be named CONFIG or WWW. This instance name is referred to as [instance] in the rest of these instructions.
2. Create the instance by using the Create Instance for OnDemand (CRTINSTOND) command. At a minimum, you must specify the name of the instance (which then uses system values and defaults for the additional parameters, such as *DFT for the PORT parameter, which uses port 1445). You can specify additional parameters in order to customize the instance to meet your requirements. For example, you can specify a three-character language identifier (using the LANGID parameter) which must match one of the language identifiers. If you specify the LOCALE parameter, the one that you specify should be included in the list of valid locales. If the instance should be located in a user Auxiliary Storage Pool (ASP), then the user ASP number (2 through 32) must be specified for the ASP parameter and *ASP must be specified for the ASPDEV parameter. If the instance should be located in an Independent Auxiliary Storage Pool (IASP), then *ASPDEV must be specified for the ASP parameter and the IASP name (such as IASP2) must be specified for the ASPDEV parameter.
   Important: If you create an instance in an IASP, that instance cannot have a disk pool in the system ASP or a user ASP.
   For example, the following command would create an instance called ONDTEST with a server language of US English, using TCP/IP port 1445 :

   CRTINSTOND INSTANCE(ONDTEST) LANGID(ENU) LOCALE('/QSYS.LIB/EN_US.LOCALE')

   The CRTINSTOND command:

   • Creates the /CONFIG directory under /QIBM/UserData/OnDemand and the default and model files within this directory (if they do not already exist).
   • Appends the model ARS.INI file (in directory /QIBM/ProdData/OnDemand/config) to the actual ARS.INI file (in directory /QIBM/UserData/OnDemand/CONFIG) and uses the name of the instance wherever it finds [instance] in the model file.
   • Creates the instance directory: /QIBM/UserData/OnDemand/[instance]. If the instance is located in an Independent ASP, the instance directory path is preceded by the Independent ASP name. For example, if the Independent ASP name is IASP, the instance directory is created in directory /IASP/QIBM/UserData/OnDemand.
   • Creates the ARS.CFG, ARS.CACHE and ARS.DBFS files in directory: /QIBM/UserData/OnDemand/[instance] and uses the name of the instance wherever it finds [instance] and the language identifier wherever it finds [language] in the model file. (The model files for these three new files are located in directory /QIBM/ProdData/OnDemand/config.) If the instance is located in an Independent ASP, the instance directory path is preceded by the Independent ASP name. For example, if the Independent ASP name is IASP, the ARS.CFG, ARS.CACHE and ARS.DBFS files are created in directory /IASP/QIBM/UserData/OnDemand/[instance].
   • Creates the library and database tables for the instance. If the instance is located in an IASP, you must set the ASP Group before you can work with files in that library. Use the Set ASP Group (SETASPGRP) command to set the ASP Group.
   • Creates the directories needed for the instance as specified in the ARS.CFG and ARS.CACHE files. And creates a user profile with the same name as the instance, and adds that user to the instance as a Content Manager OnDemand System Administrator.
   • Creates an authorization list with the same name as the instance. If the instance is located in an Independent ASP, a record is added to file QARLCASP in library QUSRRDARS.