Hitachi

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


1.5.4 Commands used to manipulate units

The following table lists the commands used to manipulate units.

The privilege required to execute these commands depends on the JP1 privilege level for the user executing the command for the JP1 resource group name specified as the attribute of the target's unit. However, the execution privilege shown is not necessarily essential if the target's unit contains no JP1 resource group name or if the command-executing user has the superuser privileges (for UNIX systems) or is logged on as a member of the Administrators privileges (in Windows systems). For details about the execution privilege, see 6.4 Setting access permissions in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.

Cautionary note

If the "Required privileges" column lists more than one privilege, you need only have one of the listed privileges to execute the command.

Table 1‒11: Commands used to manipulate units

Function

Command name

Windows

UNIX

Required privileges

Supported products

Defines a unit.

ajsdefine

Y

Y

Destination of definition

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

Target and subsequent units (Forced change of a defined unit)

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

Modifies the definition of a unit defined in a jobnet.

ajschange

Y

Y

Destination of change

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

At attribute change

JP1_AJS_Admin

Ownership privilege for units

M

Modifies the definition of a jobnet.

ajschgnet

Y

Y

Destination of change

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

Modifies the definition of a job.

ajschgjob

Y

Y

Destination of change

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

Copies, moves or renames a unit.

ajscopy

Y

Y

Destination of copy/move

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

Copy-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

Move-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

Deletes a unit.

ajsdelete

Y

Y

Delete-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

Outputs the name of a unit to the standard output file.

ajsname

Y

Y

Output target unit

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

Outputs operating environment information of the scheduler service to the standard output file.

ajsgtroot

Y

Y

None

M

Outputs the definition of a unit to the standard output file.

ajsprint

Y

Y

Output-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

Backs up a unit.

ajsbackup

Y

Y

Save-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

Deletes a backup box or backup file.

ajsbkudel

Y

Y

None

M

Restores a unit.

ajsrestore

Y

Y

Destination of recovery

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

Target and subsequent units (Forced change of a defined unit)

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

Exports the registered execution-schedule information of a root jobnet.

ajsrgexport

Y

Y

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

Imports the registered execution-schedule information of a root jobnet.

ajsrgimport

Y

Y

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

Defines calendar information for a job group.

ajscalendar

Y

Y

Destination of change

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

Calculates multiple sets of calendar information, and then outputs the results to the standard output file using the format of the calendar information file.

ajscalutil

Y

Y

If a job group name is specified:

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

If a job group name is not specified:

None

M

Defines a jobnet execution schedule for a period and then outputs it to the standard output file using the format of the schedule information parameter.

ajsschedule

Y

Y

Output-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

Registers a defined jobnet for execution.

ajsentry

Y

Y

Manipulation-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

Cancels the registration of a jobnet.

ajsleave

Y

Y

Manipulation-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

Suspends the root jobnet. Cancels the suspended state of the root jobnet.

ajssuspend

Y

Y

Manipulation-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

Outputs information about a jobnet or job, including the execution history, current status, and next scheduled execution, to the standard output file.

ajsshow

Y

Y

Output-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

Outputs the list of event jobs being currently executed in the manager to the standard output file.

jpomanjobshow

Y

Y

UNIX: Superuser

Windows: Administrators

M

Temporarily modifies a schedule defined for a jobnet, or the status of a job.

ajsplan

Y

Y

Manipulation-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

Modifies the status of a job.

ajschgstat

Y

Y

Manipulation-target unit

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

Stops the execution of a jobnet.

ajsintrpt

Y

Y

Manipulation-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

Kills the execution of a job or jobnet.

ajskill

Y

Y

Manipulation-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

Re-executes a job or a jobnet.

ajsrerun

Y

Y

Manipulation-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

Exports a unit.

ajsexport#

Y

Y

Export-target and subsequent units

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

Imports a unit.

ajsimport#

Y

Y

Destination of import

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

Starts execution of the definition pre-check and displays the state of execution.

ajschkdef

Y

Y

Windows: Administrators

UNIX: Superuser

M

Performs release entry or cancellation, or outputs release information.

ajsrelease

Y

Y

For release entry and cancellation:

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

For outputting release information:

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

Outputs a list of temporary change information made to a root jobnet and its lower units to the standard output file.

ajsplanout

Y

Y

For root jobnets:

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

Legend:

Y: Supported

M: JP1/AJS3 - Manager

Note

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.

#

These commands are provided by JP1/AJS3 for the packaging function. Use them for distributing a unit in combination with JP1/Software Distribution. You can only use these commands in a batch file or shell script for the packaging function.