Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Command Reference


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

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