12.2.3 Description

buildartcics is used to construct one or more Oracle ART CICS server(s) load module. This command invokes “buildserver” to build the specified ART CICS server(s).

-v
Specifies that buildartcics should work in verbose mode. In particular, it writes the compilation command to its standard output.
-n
Supports non-XA for Oracle ART CICS server ARTATRN/1 and ARTDPL. When rebuilding ARTATRN/1 or ARTDPL, specify this option if you require non-XA support. Both Oracle and DB2 database support non-XA local transaction optimization. For more information, see ARTKIX_XA_DISABLE.
-M
Specifies multiple resource managers associated with this server. This option is mandatory if you want to associate your service with multiple XA complaint resource managers. If this option is not specified and you try to boot a server with a configuration file, in which this server is specified in a non-multiple resource manager server group, a warning message will be printed in the user log; in addition, the sever will revert to a general server associated with one resource manager if the "-r" option is specified when buildserver command is executed.
-r rmname
Specifies the resource manager associated with this server. Multiple “-r rmname” can be specified if “-M” is used. The value rmname must appear in the resource manager table located in $TUXDIR/udataobj/RM.
-f firstfiles
-f option will be passed to buildserver command. It specifies one or more user files to be included in the compilation and link edit phases of buildserver first, before the Oracle Tuxedo ATMI libraries. If you specify more than one file, use spaces to separate those filenames and enclose the entire list in quotation marks (see the following Listing). You can specify this option multiple times. For more information, see buildserver(1) in Oracle Tuxedo documentation.
-l lastfiles
-l option will be passed to buildserver command. It specifies one or more user files to be included in the compilation and link edit phases of buildserver last, after the Oracle Tuxedo ATMI libraries. If you specify more than one file, use spaces to separate those filenames and enclose the entire list in quotation marks (see the following Listing). You can specify this option multiple times. For more information, see buildserver(1) in Oracle Tuxedo documentation.
-o svrname
Specifies the name of the server to load. This option is mandatory. If “svrname” is a standalone filename without any “/” character, the server will be generated to $KIXDIR/bin by default.

Note:

Currently, supported resource managers include Oracle_XA*, UDB_XA*, BERKELEY-DB*, and MQSeries_XA_RMI*; therefore, the “rmname” must use one of these four strings as a prefix.

Specially, for ARTTSQ* servers, only RMs provided by Oracle or DB2 UDB are supported. If other RMs are specified when ARTTSQ* servers is built, the TSQ data may not be stored correctly. Besides, to build ARTTSQ* servers with "TMS_UDB" RM, please make sure that table "TS_Q_CONTENT" exists in the DB2 Database; if this table doesn't exist, you can create it by running "$KIXDIR/tools/crtstable_UDB".

Note:

For more information, see buildserver(1) in Section 1 - Commands.