| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Instance for OnDemand (CRTINSTOND) command creates an OnDemand instance.
An OnDemand instance is a logical server environment with its own library containing a unique set of database files. An instance is defined in the ARS.INI file by naming the instance (which identifies the name of the library used by the instance). All of the database files that belong to an instance run in one and only one coded character set identifier (CCSID).
You can run multiple instances on the same server, with each instance configured differently:
When you work with more than one instance, you must identify the instance name when you run OnDemand commands (such as ADDRPTOND and STRMONOND).
Each instance has different security from other instances on the same system. You must define users and groups to each instance and set application group and folder permissions for users of each instance. Each instance has its own system log.
When you are creating 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 may need to change your user profile, then sign off and back on before creating the instance. Use the Change User Profile (CHGUSRPRF) command to change (if necessary) your user profile. You should also make sure that other language-related parameters in your user profile are set correctly. You can use the Display User Profile (DSPUSRPRF) command to check the locale setting. The locale Job Attributes (SETJOBATR) parameter in your user profile is used to determine which values are obtained from the locale. For OnDemand, at a minimum, you must use SETJOBATR(*CCSID).
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| INSTANCE | Instance | Character value | Required, Positional 1 |
| LANGID | Language ID | Character value, *SYSVAL | Optional |
| LOCALE | Locale | Path name, *SYSVAL | Optional |
| PORT | Port number | 1024-65535, *DFT | Optional |
| AUTOSTART | Autostart instance server | *NO, *YES | Optional |
| ASP | ASP number | 1-32, 1, *ASPDEV | Optional |
| ASPDEV | ASP device | Name, *ASP, *ASPGRPPRI, *SYSTEM | Optional |
| SECURITY | Server security | *SYSTEM, *ONDMD | Optional |
| DFTINST | Default instance | *NO, *YES | Optional |
| STRSVR | Start instance after creation | *NO, *YES | Optional |
| SBMJOB | Submit to batch | *YES, *NO | Optional |
| JOBD | Job description | Qualified object name | Optional |
| Qualifier 1: Job description | Name, QOND400 | ||
| Qualifier 2: Library | Name, QRDARS, *LIBL, *CURLIB |
| Top |
Specifies the name of the instance to create.
This is a required parameter.
The instance name must start with an alphabetic character or @ followed by any of these characters: 0-9, A-Z, @, # and underscore (_). Be sure 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.
| Top |
Specifies the language identifier to be used for this instance.
Note: IBM i may support additional languages which are not supported by OnDemand system log messages. System log messages will appear in English when an instance uses a language identifier that is not supported.
| Top |
Specifies the path name of the locale that is assigned to the instance.
| Top |
Specify the TCP/IP port to which the instance server listens to receive requests from an OnDemand client.
Note: You can use the Work with TCP/IP Network Status (WRKTCPSTS) with OPTION(*CNN) command to see what IPv4 ports are currently in use on your system. You can use the Work with TCP/IP Network Status (WRKTCPSTS) with OPTION(*CNN6) command to see what IPv6 ports are currently in use on your system.
| Top |
Specifies whether to automatically start the instance server when running the Start TCP/IP Server (STRTCPSVR) command with SERVER(*ONDMD) and INSTANCE(*AUTOSTART) specified. If SERVER(*ONDMD) is not specified when running the STRTCPSVR command, this parameter is ignored.
| Top |
Specifies the number of the system or basic user auxiliary storage pool (ASP) where storage for the instance library is allocated. For instances created in an ASP, all objects in the instance library must be in the same ASP as the library. When a value other than *ASP is specified for the ASP device (ASPDEV) parameter, *ASPDEV is the only valid value that can be specified for the ASP number (ASP) parameter, if specified. Also when a value other than *ASP is specified for the ASPDEV parameter, the ASP parameter can be omitted and its defaulted value will be ignored.
| Top |
Specifies the auxiliary storage pool (ASP) device name where storage is allocated for the instance library. When a value other than *ASPDEV is specified for the ASP number (ASP) parameter, ASPDEV(*ASP) is the only valid value for the ASP device (ASPDEV) parameter, if specified. Other values for the ASPDEV parameter are valid if the ASP parameter is omitted. In this case, the defaulted value for the ASP parameter is ignored.
Note: To specify a specific auxiliary storage pool (ASP) device name, you must have use (*USE) authority for each ASP device in the ASP group.
| Top |
This specifies how security will be administered for this instance.
You may select to use System i administered user profiles and passwords as the OnDemand user IDs and passwords or you may select to use user IDs and passwords that are administered by OnDemand.
| Top |
Specifies that this instance should be set as the new default (*DFT) instance in the QDFTINST data area in library QUSRRDARS.
Note: If the QDFTINST data area does not exist in library QUSRRDARS, it will be created. The default (*DFT) instance specified in the QDFTINST data area in library QUSRRDARS can be overridden by creating another QDFTINST data area in a user library which can then be included in the library list of any OnDemand job that requires that default instance to be used instead.
| Top |
Start the instance server for this instance, after the instance has been successfully created.
| Top |
Specify if you want to create the instance interactively or in a batch job.
| Top |
Specifies the name of the job description used for the submitted job.
Qualifier 1: Job description
Qualifier 2: Library
| Top |
Example 1: Create an Instance
CRTINSTOND INSTANCE(ONDTEST) LANGID(ENU)
LOCALE('/QSYS.LIB/EN_US.LOCALE')
PORT(*DFT) AUTOSTART(*YES) SECURITY(*SYSTEM)
This command submits a job to batch that will create an instance called ONDTEST. The instance will be created with a server language of US English. The instance server will listen on the default TCP/IP port number and will be started automatically when the Start TCP/IP Server (STRTCPSVR) with SERVER(*ONDMD) and INSTANCE(*AUTOSTART) is specified. The instance server will use IBM i user profiles and passwords.
Example 2: Create an Instance which uses OnDemand Managed User IDs and Passwords
CRTINSTOND INSTANCE(ONDPROD) LANGID(DEU)
LOCALE('/QSYS.LIB/DE_DE_E.LOCALE')
PORT(1450) AUTOSTART(*YES) ASP(*ASPDEV)
ASPDEV(ASP01) SECURITY(*ONDMD) DFTINST(*YES)
STRSVR(*YES)
This command submits a job to batch that will create an instance called ONDPROD. The instance will be created with a server language of German with a locale which supports the Euro. The instance server will listen on TCP/IP port 1450 and will be started automatically when the Start TCP/IP Server (STRTCPSVR) with SERVER(*ONDMD) and INSTANCE(*AUTOSTART) is specified. The instance server will use user IDs and passwords which are managed using the OnDemand Administrator Client. The instance library will be created in an independent auxiliary storage pool (IASP) called ASP01. The ONDPROD instance will become the default instance server (*DFT) used by other OnDemand commands. The instance server will be started after it has been created.
| Top |
*ESCAPE Messages
| Top |