jajs_config
- Organization of this page
Format
jajs_config -k definition-key-name environment-setting-parameter-name=definition ...
Description
The jajs_config command changes the JP1/AJS3 environment settings.
Execution privileges
In Windows: Administrators privileges
In UNIX: Superuser privileges
Arguments
-k definition-key-name
Specify the name of the definition key under which you set an environment setting parameter.
Make sure that the definition key name is enclosed in square brackets ([]).
You cannot specify multiple definition key names. You can only specify the environment setting parameter or environment setting parameters that correspond to one definition key name at each command execution.
If the specified definition key name is incorrect, this command terminates abnormally. For details, see 20. Environment Setting Parameters in the JP1/Automatic Job Management System 3 Configuration Guide.
environment-setting-parameter-name=definition ...
Specify one or more pairs of environment setting parameter name and value you want to set.
If the specification contains an error, this command terminates abnormally. For details, see 20. Environment Setting Parameters in the JP1/Automatic Job Management System 3 Configuration Guide.
If you specify a numeric value, use dword:hexadecimal-number format. If you specify multiple values for an environment setting parameter, separate the values by using a colon (:).
If you specify multiple pairs of environment setting parameter name and value, separate the pairs by using a space character.
Notes
-
The time when the environment setting parameters set by this command take effect differs depending on the parameter. For details, see the description of the environment setting parameter in 20. Environment Setting Parameters in the JP1/Automatic Job Management System 3 Configuration Guide.
-
If you specify environment setting parameters that are not applicable to the specified definition key, the command terminates abnormally. For definition keys and applicable environment setting parameters, see 20. Environment Setting Parameters in the JP1/Automatic Job Management System 3 Configuration Guide.
-
You cannot specify multiple definition keys in this command. If you need to specify multiple definition keys, execute the command for each definition key or use the jbssetcnf command. For details on the jbssetcnf command, see the JP1/Base User's Guide.
-
Do not execute this command more than once in quick succession.
-
Do not terminate this command forcibly.
-
This command checks the values specified in environment setting parameters that can take different values in Windows and UNIX. The command ends normally if each of the defined values falls within the allowed scope given in the following table.
Category
Parameter
Condition
System-managed environment settings
"AJSSYSDIR"
A string of no more than 191 bytes
"AJSLOGDIR"
A string of no more than 191 bytes
Scheduler service environment settings
"LOGSIZE"
A hexadecimal number from 0 to 1E8480 (units: KB)
(equivalent decimal number: from 0 to 2,000,000)
"AJSTMPDIR"
A string of no more than 191 bytes
"JOBINFDIR"
A string of no more than 191 bytes
"AJSBKUROOT"
A string of no more than 191 bytes
"AJSDBDIRECTORY"
A string of no more than 191 bytes
"AJSSYSDIR"
A string of no more than 191 bytes
"AJSLOGDIR"
A string of no more than 191 bytes
"AJSREPORTDIR"
A string of no more than 191 bytes
"AJSODBC_DSNAME"
A string of no more than 255 bytes
Agent management control environment settings
"AJSODBC_DSNAME"
A string of no more than 255 bytes
For details about the values that can be specified for the above environment setting parameters in the relevant OS, see 20. Environment Setting Parameters in the JP1/Automatic Job Management System 3 Configuration Guide.
-
This command cannot change the value of the environment setting parameter DEFLENTYPE, which is automatically set by the ajsembdbsetup command.
Return values
0 to 9 |
Normal end |
10 to 49 |
End with warning. The command terminated but requires manual operations. |
50 or greater |
Abnormal end |
Example
In this example, the command changes the settings of scheduler service AJSROOT1 on physical host JP1_DEFAULT as follows:
-
Changing the size of the scheduler log file to 10,240 (2800 in hexadecimal) KB
-
Enabling outputting of the scheduler service startup and termination messages to the scheduler log file
- For Windows
jajs_config -k [JP1_DEFAULT\JP1AJSMANAGER\AJSROOT1] "LOGSIZE"=dword:00002800 "AJSLOG"="all"
- For UNIX
jajs_config -k "[JP1_DEFAULT\JP1AJSMANAGER\AJSROOT1]" "LOGSIZE"=dword:00002800 "AJSLOG"="all"
- Note
-
The value specified for the -k option or on the command line might contain a backslash (\) or space character. If a backslash (\) or space character is contained, you must, for example, enclose the option or parameter value in double quotation marks (") or single quotation marks ('), or replace a backslash (\) with two backslashes (\\). For details, see the OS documentation or other applicable reference.