Options

2.4.1.47.4 Options

-b

Indicates the database will be accessed by the program.

-e exit_type:exit_name

Indicates an exit routine must be used.

An exit routine may be used at the beginning and/or at the end of a program.

The exit type (BEGIN, END or BOTH) indicates if the exit routine must be called at the begin or at the end of the program (or both).

The exit name is used to build the names of the sub-programs to be inserted before the call to the program (RTEX-"exitName"-Begin) and after the call of the program (RTEX-"exitName"-End).

-n

This option is used to launch EXCI BATCH program. It informs the Batch Runtime to use runbexci but not runb.

The environment variables used are (see BatchRT.conf):

MT_EXCI
MT_JESDECRYPT
MT_EXCI_XA
MT_EXCIGRPNAME

MT_EXCI is set to an non-empty string if EXCI interface exists and needs to use it, otherwise MT_EXCI is empty by default (needs Oracle Tuxedo).

In the last case, MT_EXCI must be set to ART KIX objects folder and MT_JESDECRYPT must be set to jesdecrypt object file (for example, /path/to/jesdecrypt.dynamic.linux64.o)

To use XA, MT_EXCI_XA must be set with the name of the resource manager for XA and MT_EXCIGRPNAME must be set with the TUXEDO SRVGRP value of ARTDPL server.

(For example, MT_EXCI_XA=Oracle_XA and MT_EXCIGRPNAME=ResourceXA)

If MT_EXCI is set to an non-empty string and MT_EXCI_XA and MT_EXCIGRPNAME are set to empty, you will connect to database without using XA.

During installation phase MT_EXCI is checked to know if the specific Runtime for EXCI must be linked.m_DBTableLoad

During execution phase only MT_EXCIGRPNAME is checked.

-s <DB_SYSTEM>

Specifies the DB SYSTEM. This "DB SYSTEM" value is used to get the "DB connection credential string" from file specified by global variable MT_DB2_SYSTEM_MAPPING. And then apply it to MT_DB_LOGIN. After this API is executed successfully, MT_DB_LOGIN is restored.

Program [arguments]

Program name and user arguments to be passed to the program.

Note:

When m_ProgramExec invokes nonexistent programs, JOB will continue if those programs are specified in MT_UTILITY_LIST_UNSUPPORT.

Another way to use runbexci instead of runb is to configure the program in MT_EXCI_PGM_LIST. By doing this, whether or not -n is set, the program is invoked only by runbexci.

For more information about MT_UTILITY_LIST_UNSUPPORT and MT_EXCI_PGM_LIST, please refer to the table of "Oracle Tuxedo Application Runtime for Batch Environment Variables (Optional)" in Using Batch Runtime.

Parent topic: m_ProgramExec