jajs_config

Format

jajs_config
     -k definition-key-name
     environment-setting-parameter-name=definition ...

To Page Top

Description

The jajs_config command changes the JP1/AJS3 environment settings.

To Page Top

Execution privileges

In Windows: Administrators privileges

In UNIX: Superuser privileges

To Page Top

Arguments

To Page Top

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.

To Page Top

Return values

To Page Top

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.

To Page Top