Job Management Partner 1/Automatic Job Management System 3 Command Reference 1

ajsalter

Format

ajsalter
     [-F service-name]
     [-s {none|EXEC}]
     [[-o] -c {CHANGE|COPY}]

Description

Temporarily modifies the operating environment for a scheduler service.

Execution privileges

In Windows: Administrators privilege

In UNIX: Superuser privilege

Arguments

-F service-name

Specify the name of the target scheduler service.

You can specify a character string of 1 to 30 bytes.

If you omit this option, the system assumes the default scheduler service name.

-s{none|EXEC}

Specify whether you want to suppress the execution of a jobnet or job, or cancel suppression.

If you use this option to suppress execution while a jobnet or job is being executed, the next jobnet or job will not be activated.

none
Cancels the suppression of execution for a jobnet or job.

EXEC
Suppresses the execution of a jobnet or job. Once the system has completed the execution of the jobnet or job currently being executed, it will not start any subsequent jobnet or job.

If you use this option, you can temporarily modify the setting of the SUPPRESS environment setting parameter.

-o

If you specify this option, the scheduler log file for the host, not the scheduler service, is replaced.

Depending on whether this option is specified and the value of the AJSLOGOUTPUTDEST environment setting parameter, the scheduler log file to be replaced differs, as described in the following table.

AJSLOGOUTPUTDEST value -o option

Specified Not specified

schedule(default) H S

host H H

Legend:

H: The scheduler log file for the host is replaced.

S: The scheduler log file for the scheduler service is replaced.

You must specify this option with the -c option.

-c {CHANGE|COPY}

Specify how to change the scheduler log file.

CHANGE
Writes history information to the alternate scheduler log file.

COPY
Copies the contents of the current scheduler log file to the alternate scheduler log file. The system deletes data from the current scheduler log file and then writes history information from the beginning of the file.

If a log output error occurs during output of a scheduler log and the log output is blocked, use this option to replace the scheduler log file. Once the scheduler log file has been replaced, the system cancels blocking of log output.

AJSLOGOUTPUTDEST value	-o option
Specified	Not specified
schedule(default)	H	S
host	H	H

Notes

For details about replacement of the scheduler log file, see 8.7 Swapping a scheduler log file in the Job Management Partner 1/Automatic Job Management System 3 Administration Guide.

If the -s option is specified, the setting of the SUPPRESS environment setting parameter is temporarily modified. The modification is lost the next time the scheduler service is started.

Return values

0 Normal end

Multiple of 4 within the range from 4 to 124 Abnormal end

Example1

The following command temporarily modifies the jobnet operating environment, suppressing the execution of jobs:
 
ajsalter -s EXEC
 

Example2

To replace the current scheduler log file for the host that contains scheduler service AJSROOT2 with the alternate scheduler log file after copying the contents of the current file to the alternate file, execute the following command:
 
ajsalter -F AJSROOT2 -o -c COPY
 
If host is set for the AJSLOGOUTPUTDEST environment setting parameter, regardless of whether the -o option is specified, scheduler log file for the host is replaced.
 
ajsalter -F AJSROOT2 [-o] -c COPY

[Contents][Back][Next]

[Trademarks]

0	Normal end
Multiple of 4 within the range from 4 to 124	Abnormal end