ajsalter
- Organization of this page
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.
Notes
-
For details about replacement of the scheduler log file, see 7.7 Swapping a scheduler log file in the JP1/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