Hitachi

JP1 Version 12 JP1/Automatic Operation Service Template Reference


2.5.1 Register JP1/AJS jobnet for execution

Function

This service template executes root jobnets defined in JP1/AJS3 - Manager (or JP1/AJS2 - Manager). JP1/AJS3 (JP1/AJS2) macro variables required at execution can be specified.

This service template assumes that the following servers are being used.

• Job server

These are servers running JP1/AJS3 - Manager (or JP1/AJS2 - Manager). The jobnet that is being executed must be registered.

The following describes the processing.

(1) Jobnet execution is ordered for the job server's JP1/AJS3 - Manager (or JP1/AJS2 - Manager), and the service waits for it to finish.

(2) The results of jobnet execution by the job server is checked and then displayed.

Prerequisites

For the latest support information about [Required product in the System]/[Prerequisite products in the system executing the service template]/[Prerequisite product OS running in the system executing the service template], see the release notes.

[Required product in the System]

JP1/Automatic Operation 12-00 or later

[Prerequisite products in the system executing the service template]

(1) The following products are running on the job server:

JP1/Automatic Job Management System 3 - Manager 11-00 or later, or

Job Management Partner 1/Automatic Job Management System 3 - Manager 09-00 or later.

[Prerequisite product OS running in the system executing the service template]

(1) Windows Server 2008 R2 Standard/Enterprise/Datacenter

(2) Windows Server 2012 Standard/Datacenter, Windows Server 2012 R2 Standard/Datacenter

(3) Windows Server 2016 Standard/Datacenter

(4) Windows Server 2019 Standard/Datacenter

(5) Red Hat Enterprise Linux Server 6 (32-bit x86), Red Hat Enterprise Linux Server 6 (64-bit x86_64)

(6) Red Hat Enterprise Linux Server 7 (64-bit x86_64)

(7) Red Hat Enterprise Linux Server 8 (64-bit x86_64)

(8) AIX V6

(9) AIX V7

[Usage conditions of prerequisite products in the system executing the service template]

(1) The jobnet to be executed must have been created on the job server.

(2) This service template supports only execution registration of the root jobnet. Batch execution of job groups is not supported.

(3) This service template only allows immediate execution registration of jobnets. Further, if start conditions are provided for a jobnet, those conditions are disabled.

(4) In property jp1ajs.executeJP1UserName, specify the name of the JP1 user for whom jobnet execution registration will be performed by the job server. To perform execution registration of the same name as the OS user who connects from JP1/AO, you must specify a value in this property.

(5) If you register a jobnet defined on a logical host with a cluster configuration, specify the physical host name or logical host name of the active server in property common.targetHost. Also specify the logical host being run by the scheduler service in property jp1ajs.ajsServiceName, and the name of the logical host running the scheduler service in property jp1ajs.jp1ajsLHostName.

Cautions

(1) This service template only performs immediate execution registration of jobnets. Check the execution status of jobnets that require lengthy times to complete using the appropriate JP1/AJS3 - View (or JP1/AJS2 - View).

(2) Even when a task is stopped by JP1/AO, jobnet execution continues in the linked JP1/AJS3 (or JP1/AJS2). If necessary, check execution status using JP1/AJS3 - View (or JP1/AJS2 - View). If the task ended abnormally, eliminate the cause of the error, and then re-execute the task.

(3) Up to 1024 characters can be specified as macro parameters in property jp1ajs.ajsMacroParameter.

(4) The following characters can be used in jobnets: single-byte alphanumeric characters and symbols (!#$%+@-._) and double-byte characters. Double-byte characters can be used when the JP1/AJS manager character code type in Windows on the job server side is SJIS.

(5) If you are executing this service in a UNIX environment, do not use multibyte characters in properties.

(6) If you specify multibyte characters and if the job server OS is Windows, specify a jobnet name that is no longer than 930 bytes. Be sure to specify a service name no longer than 255 bytes.

Execution privilege

The following settings are required for OS users connecting to a job server from JP1/AO. If there is no JP1 user with the same name as the connecting OS user, you must specify the property jp1ajs.executeJP1UserName.

[For both Windows and UNIX]

The same name as a JP1 user who has been granted JP1_AJS_Operator permissions, JP1_AJS_Manager permissions, or JP1_AJS_Admin permissions.

Version

02.00.00

Tags

Configure JP1,AJS

Property list

The following shows the list of the property groups set in the property:

Property group

Description

Initial display

Business system environment information

Specify the environment information for the job server.

Y

Business information

Specify the information on the jobnet to be executed.

Y

The following shows the list of the properties to be displayed in the "Service Definition" window:

(Legend)

R: The property must be specified.

O: The property can be omitted. However, the property might be mandatory depending on what is specified for other properties. See the Description of each property.

Property key

Property name

Description

I/O type

Shared

Required

Property group

jp1ajs.ajsServiceName

Name of the JP1/AJS service for jobnet execution

Specify the service name of the JP1/AJS scheduler service that will execute the jobnet.Specify the service name of the JP1/AJS on logical host (when using business server in a cluster configuration).

Input

Disabled

O

Business information

jp1ajs.ajsJobnetName

Jobnet name

Specify the name and path of the jobnet you want to execute. You can't specify neither a manager job group name nor a manager jobnet name.

Input

Disabled

R

Business information

jp1ajs.executeJP1UserName

JP1 user for jobnet execution

Specify the JP1 user name used to execute the jobnet. You can omit this property if the JP1 user name is the same as the OS user name used to connect to the job server.

Input

Disabled

O

Business information

The following shows the list of the properties to be displayed on the "Service Definition" window and the "Submit Service" window:

Property key

Property name

Description

I/O type

Shared

Required

Property group

common.targetHost

Host name of job server

Specifies the host name or IP address of the job server. IPv6 addresses are not supported. In the case of a cluster configuration, specify the physical host or logical host of the active server.

Input

Disabled

R

Business system environment information

jp1ajs.ajsMacroParameter

Macro variables for jobnet execution

Specify values for the macro variables required by the jobnet you are executing, in the format "variable-name:value, variable-name:value, ...".

Input

Disabled

O

Business information

jp1ajs.jp1ajsLHostName

JP1/AJS logical host name

Specify the logical host name of JP1/AJS (when using JP1/AJS in a cluster configuration).

Input

Disabled

O

Business system environment information

The following shows the list of the properties to be displayed in the "Task Details" window only:

Property key

Property name

Description

I/O type

Shared

jp1ajs.jobnetResult

Jobnet execution results

This property stores the results of the jobnet execution.

Output

Disabled

The following shows the restrictions on inputs to the properties displayed in the "Service Definition" window:

Property key

Characters that can be input

jp1ajs.ajsServiceName

A character string of no more than 255 characters can be entered. It cannot include <, >, |, ;, &, `, or a trailing \.

jp1ajs.ajsJobnetName

A character string of no more than 930 bytes. Characters that can be used include alphanumeric characters, as well as !, #, $, %, +, @, -, ., _, / and double-byte character.

jp1ajs.executeJP1UserName

A maximum of 31 characters can be entered. Characters that can be used include alphanumeric characters, as well as !, #, $, %, ', -, @, _, and ~.

The following shows the restrictions on inputs to the property displayed on the "Service Definition" window and the "Submit Service" window:

Property key

Characters that can be input

common.targetHost

A maximum of 255 characters can be entered. Characters that can be used include alphanumeric characters, as well as . and -.

jp1ajs.ajsMacroParameter

A character string of no more than 1024 characters can be entered. It cannot include <, >, |, ;, &, `, or a trailing \.

jp1ajs.jp1ajsLHostName

A maximum of 255 characters can be entered. Characters that can be used include alphanumeric characters, as well as . and -.

Flow specification details

The following table shows the detailed specification of the flow:

Hierarchy

Display name

Plug-in

Plug-in name

Description

Error recovery method

1

jp1ajsExecute

Register JP1/AJS jobnet for execution

Registers a jobnet for execution on the job server.

Eliminate the cause of the error, and then re-execute the service.

2

jp1ajsCheck

Get JP1/AJS jobnet execution results

Acquires the execution result of the specified jobnet.

Eliminate the cause of the error, and then re-execute the service.