Hitachi

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


1.5.10 Commands used during special operation

This subsection shows the commands used during special operation such as when an old-version compatibility function or an optional function is being used.

Organization of this subsection

(1) Commands available in an execution environment for queue or submit jobs

The following table lists the commands available in an execution environment for queue or submit jobs.

Note that to execute a command other than the jpqexport, jpqimport, and jajs_maintain commands, the OS user who executes the command must be registered as a JP1 user on the authentication server. Also make sure that the JP1 user is granted the proper permissions to execute the command. For details about command execution permissions, see 6.4 Setting access permissions in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.

Table 1‒17: Commands used during special operation (commands available in an execution environment for queue or submit jobs)

Function

Command name

Windows

UNIX

Required privileges

Supported products

Outputs the current job execution environment to a file.

jpqexport

Y

Y

Windows: Administrators

UNIX: Superuser

M

Defines the job execution environment (job execution agents, queues, and exclusive execution resources) collectively using the job execution environment configuration definition file (jpqsetup.conf).

jpqimport

Y

Y

Windows: Administrators

UNIX: Superuser

M

Performs maintenance on JP1/AJS3.

jajs_maintain

Y

Y

Windows: Administrators

UNIX: Superuser

M

Registers a submit job.

jpqjobsub

Y

Y

Destination of a request to register a submit job

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User

M and A

Cancels or kills the execution of a job.

jpqjobcan

Y

Y

Destination of a request to cancel a job

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User#1

However, if the -em option is specified, the following privileges are required (and the above privileges are not required).

Windows: Administrators#2

UNIX: Superuser

M and A

Holds, or unholds the execution of a job.

jpqjobalt

Y

Y

Destination of a request to hold/unhold a job

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User#1

M and A

Moves a job.

jpqjobmove

Y

Y

Destination of a request to move a job

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User#1

M and A

Outputs information about a particular job to the standard output file.

jpqjobget

Y

Y

Destination of a request to acquire job information

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User#1

M and A

Outputs a list of uncompleted jobs to the standard output file.

jpqjobshow

Y

Y

Destination of a request to acquire job information

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User#1

M and A

Outputs a list of completed jobs to the standard output file.

jpqendjobshow

Y

Y

Destination of a request to acquire job information

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User#1

M and A

Deletes information about completed jobs from the database.

jpqjobdel

Y

Y

Destination of a request to delete a job

JP1_JPQ_Admin

JP1_JPQ_Operator

M and A

Opens a queue.

jpqqueopen

Y

Y

Destination of a request to open a queue

JP1_JPQ_Admin

JP1_JPQ_Operator

However, if the -em option is specified, the following privileges are required (and the above privileges are not required).

Windows: Administrators#2

UNIX: Superuser

M and A

Closes a queue.

jpqqueclose

Y

Y

Destination of a request to close a queue

JP1_JPQ_Admin

JP1_JPQ_Operator

However, if the -em option is specified, the following privileges are required (and the above privileges are not required).

Windows: Administrators#2

UNIX: Superuser

M and A

Outputs queue information to the standard output file.

jpqqueshow

Y

Y

Destination of a request to acquire queue information

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User

However, if the -em option is specified, the following privileges are required (and the above privileges are not required).

Windows: Administrators#2

UNIX: Superuser

M and A

Adds a queue.

jpqqueadd

Y

Y

Destination of a request to add a queue

JP1_JPQ_Admin

M

Deletes a queue.

jpqquedel

Y

Y

Destination of a request to delete a queue

JP1_JPQ_Admin

M

Changes a queue definition.

jpqquealt

Y

Y

Destination of a request to change a queue definition

JP1_JPQ_Admin

However, if the -em option is specified, the following privileges are required (and the above privilege is not required).

Windows: Administrators#2

UNIX: Superuser

M

Connects a queue to an agent; otherwise, changes the level of priority to a connected agent.

jpqagtlink

Y

Y

Destination of a request to connect an agent

JP1_JPQ_Admin

However, if the -em option is specified, the following privileges are required (and the above privilege is not required).

Windows: Administrators#2

UNIX: Superuser

M

Releases the connection between a queue and an agent.

jpqagtunlink

Y

Y

Destination of a request to cancel an agent connection

JP1_JPQ_Admin

M

Outputs information about the agent host to the standard output file.

jpqagtshow

Y

Y

Destination of a request to acquire agent information

JP1_JPQ_Admin

However, if the -em option is specified, the following privileges are required (and the above privilege is not required).

Windows: Administrators#2

UNIX: Superuser

M and A

Adds an agent and creates a default queue at the same time.

jpqagtadd

Y

Y

Destination of a request to add an agent

JP1_JPQ_Admin

M

Deletes an agent and deletes the default queue at the same time.

jpqagtdel

Y

Y

Destination of a request to delete an agent

JP1_JPQ_Admin

M

Modifies the number of concurrently-executable jobs.

jpqagtalt

Y

Y

Destination of a request to change the number of concurrently-executable jobs

JP1_JPQ_Admin

However, if the -em option is specified, the following privileges are required (and the above privilege is not required).

Windows: Administrators#2

UNIX: Superuser

M and A

Outputs information about exclusive execution resources to the standard output file.

jpqresshow

Y

Y

Destination of a request to acquire exclusive execution resources

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User

M

Adds exclusive execution resources.

jpqresadd

Y

Y

Destination of a request to add exclusive execution resources

JP1_JPQ_Admin

M

Deletes exclusive execution resources.

jpqresdel

Y

Y

Destination of a request to delete exclusive execution resources

JP1_JPQ_Admin

M

Legend:

Y: Supported

M: JP1/AJS3 - Manager

A: JP1/AJS3 - Agent

#1

With JP1_JPQ_User permission, the user can operate or view only jobs submitted by the user himself or herself.

#2

On a Windows host, before you execute a command that must be executed by a user with administrator privileges, make sure that you open the Command Prompt window as an administrator. If the UAC function is disabled, you do not need to open the Command Prompt window as an administrator.

(2) Commands available when queueless jobs are used

The following table lists the commands available when queueless jobs are used.

Table 1‒18: Commands used during special operation (commands available when queueless jobs are used)

Function

Command name

Windows

UNIX

Required privileges

Supported products

Sets up the execution environment for queueless jobs.

ajsqlsetup

Y

Y

Windows: Administrators

UNIX: Superuser

M and A

Temporarily modifies the operating environment for the queueless agent service.

ajsqlalter

Y

Y

Windows: Administrators

UNIX: Superuser

M and A

Adds hosts to be processed by the queueless agent service.

ajsqlattach

Y

Y

Windows: Administrators

UNIX: Superuser

M and A

Disconnects hosts processed by the queueless agent service.

ajsqldetach

Y

Y

Windows: Administrators

UNIX: Superuser

M and A

Starts the queueless file transfer service.

ajsqlftpstart

--

Y

UNIX: Superuser

M

Stops the queueless file transfer service.

ajsqlftpstop

Y

Y

Windows: Administrators

UNIX: Superuser

M

Starts the JP1/AJS3 Queueless Agent service.

ajsqlstart

--

Y

UNIX: Superuser

M and A

Stops the queueless agent service.

ajsqlstop

Y

Y

Windows: Administrators

UNIX: Superuser

M and A

Outputs detailed information about the queueless agent service.

ajsqlstatus

Y

Y

None

M and A

Modifies the size of the trace log file for the queueless agent service.

ajsqltrsetsz

Y

Y

Windows: Administrators

UNIX: Superuser

M and A

Changes the size of the internal log file for execution of queueless jobs.

ajsqlexecsetsz

Y

Y

Windows: Administrators

UNIX: Superuser

M and A

Legend:

Y: Supported

--: Not supported

M: JP1/AJS3 - Manager

A: JP1/AJS3 - Agent

#

These commands cannot be used for JP1/AJS3 - Agent Minimal Edition.

(3) Commands available during an operation test

The following table lists the commands available during an operation test.

Table 1‒19: Commands used during special operation (commands available during an operation test)

Function

Command name

Windows

UNIX

Required privileges

Supported products

Changes and references the local time and date of the scheduler service.

ajslocaldate

Y

Y

Windows: Administrators

UNIX: Superuser

M

Legend:

Y: Supported

M: JP1/AJS3 - Manager