ARTJESADM supports the following parameters and options:

-i JESCONFIG

JESCONFIG represents the full path name of the TuxJES system configuration file. It allows the following parameters:

JESROOT

The full path name of the root directory to store job information. It is a mandatory attribute. If this directory does not exist, ARTJESADM creates it automatically.

JESROOT=/xxx/xxx

DEFAULTJOBCLASS

The default job class if the job class is not set for a job. It is an optional attribute. The default job class is A if this attribute is not set.

DEFAULTJOBCLASS=[A-Z],[0=9]

DEFAULTJOBPRIORITY

The default job priority if the job priority is not set for a job. It is an optional attribute. The default job priority is 0 if this attribute is not set.

DEFAULTJOBPRIORITY=[0-15]

DUPL_JOB=NODELAY

If it is not set, only one job can be in execution status for a job name. NODELAY will remove the dependency check. The default value is delay execution.

EVENTPOST=S,C,E,P,L,A

Specifies whether events are posted for a job at particular stages.

• S: Job submission event. Event name: ARTJES_JOBSUBMIT
• C: Job conversion complete event. Event name: ARTJES_JOBCVT
• E: Job execution finish event. Event name: ARTJES_JOBFINISH
• P: Job purge event. Event name: ARTJES_JOBPURGE
• L: Job cancel completed event. Event Name: ARTJES_JOBCANCEL
• A: All supported events.

If EVENTPOST is not specified, no events are posted. The data buffer with event post is FML32 type and the fields are defined in JESDIR/include/jesflds.h.

JES_ACL_FILE

The full path of job access authorization configuration file. This file can be plain or encrypted. Because the JESCONFIG file and JES_ACL_FILE file are based on TuxJES security mechanism, it's important to well protect these two files at the very beginning. It is strongly recommended that read/write permissions for these two files must be granted to only the user who is responsible for booting the whole TuxJES domain (normally it is the root account).

JES_ACL_FILE_TYPE

The format of JES_ACL_FILE file. It can be set as PLAIN or ENCRYPTED (case insensitive). PLAIN means JES_ACL_FILE file is plain while ENCRYPTED means this file is encrypted. The encrypted file can be generated by genjesacl tool. The default value is PLAIN.

JES_ACL_MODE

The action when no matching rule is found for the tuple of user, operation, and job in JES_ACL_FILE. It can be set as MAC or DAC. MAC (Mandatory Access Control) means all operations are denied if no matching rule is found while DAC (Discretionary Access Control) means all operations are allowed if no matching rule is found. MAC is the default value. If JES_ACL_MODE is configured to invalid values, server ARTJESADM cannot boot up.

JOBREPOSITORY

The path of the job repository where jobs are stored. The script file path inputted in job submitting may be a relative path in JOBREPOSITORY if it is set. You can specify multiple path names, delimit them with a colon (:). For example, JOBREPOSITORY=<path1>:<path2>:<path3> To find job to submit, Batch Runtime searches from these paths in the order that you specify (in JOBREPOSITORY). When finding a job name match, Batch Runtime stops searching, and submits this matched job.

PRIVILEGE_MODE

Specifies whether and how to enable the user substitution ( For more information, see TuxJES User Substitution). The values are:

NONE

Default value. Indicates jobs are executed by the OS user who starts JES system. This is compatible with all previous implementations on JES system.

USER_IDENTICAL

Indicates jobs are executed by the Oracle Tuxedo user with which JES client joins JES system. Make sure that each Oracle Tuxedo user corresponds to an existing OS user before you choose this value.

USER_MAPPING

When this value is specified, the JES system looks up the TuxJES user mapping file and finds out the OS user corresponding to the Oracle Tuxedo user with which JES client joins JES system, and then appoints this OS user as the job executor.

USER_MAPPING_FILE

The full path where TuxJES user mapping file is stored. It is used along with PRIVILEGE_MODE when its value is USER_MAPPING.

It is recommended that the owner of user mapping file is root and the file permission is "-rw-------".

One Oracle Tuxedo user must be mapped to one OS user only, and it is recommended that one OS user is mapped to one Tuxedo user as well.

USE_DB

Enable to use Database to store job management data. Values could be:

ORACLE

Use Oracle Database to store job management data.

DB2

Use DB2 as storage to store job information.

BDB

Use BDB as storage to store job information.

NOT SET

Use /Q to store job information.