2.5.2 JP1/AJS jobnet planned execution registration
Function
This service template registers the route jobnet defined in JP1/AJS3 - Manager (or JP1/AJS2 - Manager, collectively referred to as JP1/AJS hereafter) for planned execution or fixed execution.
The JP1/AJS macro variables that are required at execution can be specified.
This service template requires the following server:
- Job server
Server where JP1/AJS operates. The jobnet for execution must be already created.
The jobnet must be a jobnet whose execution can be registered by the JP1/AJS command ajsentry. The manager job group name and manager jobnet name cannot be specified.
The process flow is given below.
(1) Registration for planned execution or fixed execution is determined from the execution registration type.
Execute one of the following processes.
(a) If registration for planned execution was specified, the specified jobnet is registered for planned execution in JP1/AJS on the job server.
(b) If registration for fixed execution was specified, the specified jobnet is registered for fixed execution in JP1/AJS on the job server.
- When executing the jobnet at a specific date and time (Specify date and time):
Specify the jp1ajs.executeDate property and jp1ajs.executeTime property.
- When specifying and executing the number of scheduled execution generations of a jobnet (Specify the number of future generations):
Specify the jp1ajs.executeGeneration property.
Make sure that one of the above is specified.
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:
Job Management Partner 1/Automatic Job Management System 3 - Manager 09-00 or later, or
Job Management Partner 1/Automatic Job Management System 3 - Manager 10-00 or later, or
JP1/Automatic Job Management System 3 - Manager 11-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) Specify the JP1 user name in the jp1ajs.entryJP1UserName property for registering jobnet execution for the execution target server. If execution is registered by a JP1 user whose name is the same as the OS user connected from JP1/AO, the value does not need to be specified for this property.
(2) When registering the jobnet defined on a logical host having a cluster configuration:
- In the common.targetHost property, specify the physical host name or logical host name of the execution system server.
- In the jp1ajs.ajsServiceName property, specify the name of the scheduler service operating in the logical host.
- In the jp1ajs.jp1ajsLHostName property, specify the name of the logical host where the scheduler service is operating.
Cautions
(1) If the job server OS is UNIX, set the same character encoding for the JP1/AJS environment setting parameter of the application server and for the default locale of the OS user used when connecting to the application server.
(2) Specify the scheduler service name that is set in the jp1ajs.ajsserviceName property. Use 30 bytes or less for the name.
(3) The job group cannot be specified in the jp1ajs.entryJobnetName property.
(4) For other usage notes, see the usage notes for the ajsentry command in Job Management Partner 1/Automatic Job Management System 3 Command Reference 1.
Execution privilege
(1) The JP1 user mapped to the OS user when connected to the job server has operation permissions for the jobnet registered for execution.
(2) If the JP1 user mapped to the OS user when connected to the job server does not exist, in the jp1ajs.entryJP1UserName property specify a JP1 user having operation permissions for the jobnet registered for execution.
Version
03.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 |
|---|---|---|
|
Application system environment information |
Specify the environment information of the job server. |
Y |
|
Jobnet registration information |
Specify the information of the jobnet to be executed. |
Y |
|
Fixed execution information |
Specify the fixed execution registration information. |
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 |
|---|---|---|---|---|---|---|
|
common.targetHost |
Job server host name |
Specifies the host name or IP address of the job server. IPv6 addresses are not supported. When a cluster configuration is used, specify the physical host or logical host of the execution system server. |
Input |
Disabled |
R |
Application system environment information |
|
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 |
Application system environment 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 |
Application system environment 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 |
|---|---|---|---|---|---|---|
|
jp1ajs.entryJobnetName |
Jobnet name where execution registration is performed |
Specifies, by a complete name, the name of the jobnet that is registered for execution. The manager job group name and manager jobnet name cannot be specified. |
Input |
Disabled |
R |
Jobnet registration information |
|
jp1ajs.entryType |
Jobnet execution registration methods |
Specifies whether the jobnet is registered for planned execution or fixed execution. Fixed: Registered for fixed execution, Planned: Registered for planned execution |
Input |
Disabled |
R |
Jobnet registration information |
|
jp1ajs.executePrior |
Scheduled execution required during stopped scheduler service |
If scheduled execution date passed during stopped scheduler service, specifies scheduled execution upon scheduler service restart, or from next scheduled execution. (true: Execute passed scheduled execution, false: Execute from next scheduled execution) |
Input |
Disabled |
R |
Jobnet registration information |
|
jp1ajs.ajsMacroParameter |
Macro variables for jobnet execution |
The value of the macro variable required in the jobnet that is executed is specified in the format "variable name: value, ...". Up to 32 macro variables can be specified. |
Input |
Disabled |
O |
Jobnet registration information |
|
jp1ajs.entryJP1UserName |
Jobnet execution registration JP1 user name |
Specifies the JP1 user name when the jobnet is registered for execution. This does not need to be specified when the JP1 user registering execution has the same name as the OS user name when connecting to the job server. |
Input |
Disabled |
O |
Jobnet registration information |
|
jp1ajs.executeDate |
Jobnet fixed execution date |
The fixed execution date when the jobnet is registered for fixed execution is selected from the calendar. |
Input |
Disabled |
O |
Fixed execution information |
|
jp1ajs.executeTime |
Jobnet fixed execution time (hh:mm) |
The fixed execution time when the jobnet is registered for fixed execution is separated by a colon (:) and specified in the format hh:mm. The ":mm" part can be omitted. When omitted, this is assumed to be 0 minutes. |
Input |
Disabled |
O |
Fixed execution information |
|
jp1ajs.executeGeneration |
Future scheduled number of generations for jobnet |
Specifies the scheduled number of generations to be executed from the next time when the jobnet is registered for fixed execution. |
Input |
Disabled |
O |
Fixed execution information |
The following shows the restrictions on inputs to the properties displayed in the "Service Definition" 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.ajsServiceName |
A character string of no more than 255 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 -. |
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 |
|---|---|
|
jp1ajs.entryJobnetName |
Enter a character string of no more than 930 bytes. You can use a character string of single-byte alphanumeric characters and symbols (! # $ % + @ - . _ /) and double-byte characters. |
|
jp1ajs.entryType |
Select one of the following values: Fixed,Planned |
|
jp1ajs.executePrior |
Select one of the following values: false,true |
|
jp1ajs.ajsMacroParameter |
A character string of no more than 1024 characters can be entered. It cannot include <, >, |, ;, &, `, or a trailing \. |
|
jp1ajs.entryJP1UserName |
Enter up to 31 halfwidth alphanumeric characters. You can also use the following symbols: ! # $ % ' - @ _ ~ |
|
jp1ajs.executeDate |
You can enter 10 or fewer bytes of single-byte numbers and a slash (/). |
|
jp1ajs.executeTime |
You can enter 5 or fewer single-byte alphanumeric characters and a colon (:). |
|
jp1ajs.executeGeneration |
Enter a number from 1 to 99. |
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 |
registerPlannedEntry |
Flow Plug-in |
Registers planned execution for a JP1/AJS jobnet. |
-- |
|
1-1 |
Compatible Plug-in |
Determines whether the registration is a planned execution. |
After removing the cause of the error, run the service again. |
|
|
1-2 |
Register for JP1/AJS jobnet planned execution |
Registers a planned execution of a JP1/AJS jobnet. |
After removing the cause of the error, run the service again. |
|
|
2 |
registerFixedEntry |
Flow Plug-in |
Registers fixed execution for a JP1/AJS jobnet. |
-- |
|
2-1 |
Compatible Plug-in |
Determines whether the registration is a fixed execution. |
After removing the cause of the error, run the service again. |
|
|
2-2 |
Register for JP1/AJS jobnet fixed execution |
Registers a fixed execution of a JP1/AJS jobnet. |
After removing the cause of the error, run the service again. |
|