Hitachi

JP1 Version 12 JP1/Client Process Automation Configuration and Administration Guide


cpajobentry

Organization of this page

Function

Registers a job or items.

Format

cpajobentry -a definition-file-name [-u]

Permission for execution

None

Arguments

-a definition-file-name

Specify the absolute path to the definition file you want to register.

Note that the definition file is a local file specified in Save job file or Save as file of the Job Design View, or a file that stores the output result of the cpajobprint command.

-u

Updates an existing job or items.

An item created in the Item Design View can also be updated.

An update you made to a job is applied when the job runs next time.

This command returns an error when the specified job is running.

Return values

0

Succeeded

40

Insufficient resources

52

Could not access the file.

58

Syntax error in arguments

63

Cannot update because the job is running.

66

There is already a job or item with the same name.

85

The number of items to be registered exceeds the maximum allowed number.

96

The specified XML file has an error.

111

The specified file does not exist.

125

System error

126

Program error

Environment requirements

This command can run regardless of whether the job execution service is running or stopped.

Command stored in:

install-path\bin

Note that the command is stored in the following folder by default.

In a 32-bit operating system:

%ProgramFiles%\Hitachi\JP1CPA\bin

In a 64-bit operating system:

%ProgramFiles(x86)%\Hitachi\JP1CPA\bin

Notes

If the job execution service terminates due to power shutdown or other reasons, you should not run this command with the -u option to update an existing job until the job execution service restarts (that is, while the service is stopped). Doing so might prevent the state restoration process of the service from working properly when the service restarts.