4.4.4 Register for JP1/AJS jobnet planned execution
Function
This component registers the scheduled execution of a jobnet of JP1/AJS3 - Manager (or JP1/AJS2 - Manager, collectively referred to as JP1/AJS hereafter) of the specified server.
This component requires the following server:
- Job server (Execution target server)
This is the server that executes a jobnet of JP1/AJS. The JP1/AJS described in the pre-conditions needs to have been set up.
You must define in advance the calendar and schedule rule of the jobnet for execution registration.
With this component, only the registration of scheduled execution of a jobnet is available.
Use situation
Performs the scheduled execution registration for the jobnet created.
Prerequisites
For the latest support information about [Required product in the System]/[Required products on the execution target system]/[Prerequisite product OS running in the execution target server], see the release notes.
[Required product in the System]
Job Management Partner 1/Automatic Operation 10-10 or later
[Required products on the execution target system]
(1)Job Management Partner 1/Automatic Job Management System 2 - Manager 08-00 or later
(2)Job Management Partner 1/Automatic Job Management System 3 - Manager 09-00 or later
(3)Job Management Partner 1/Automatic Job Management System 3 - Manager 10-00 or later
[Prerequisite product OS running in the execution target server]
(1) Windows Server 2003,Standard Edition/Enterprise Edition (x86/x64) SP1 or later,Windows Server 2003 R2,Standard Edition/Enterprise Edition (x86/x64)
(2) Windows Server 2008 Standard/Enterprise (x86/x64),Windows Server 2008 R2 Standard/Enterprise/Datacenter
(3) Windows Server 2012 Standard/Datacenter, Windows Server 2012 R2 Standard/Datacenter
(4) Red Hat Enterprise Linux 5 Advanced Platform (x86), Red Hat Enterprise Linux 5 (x86), Red Hat Enterprise Linux 5 Advanced Platform (AMD/Intel 64), Red Hat Enterprise Linux 5 (AMD/Intel 64)
(5) Red Hat Enterprise Linux Server 6 (32-bit x86),Red Hat Enterprise Linux Server 6 (64-bit x86_64)
[Usage conditions for required products on the execution target server]
(1) The jobnet for execution registration must be already created.
(2) The calendar and schedule rule of the jobnet for execution registration must be already defined.
(3) Specify the JP1 user name in the JP1AJS.executeJP1UserName property for registering jobnet execution for the execution target server. If execution is registered by a JP1 user with the same name as the OS user connected from JP1/AO, the value does not need to be specified for this property.
(4) When registering the jobnet defined on the logical host in a cluster configuration, perform the following:
- Specify the physical host name or the logical host name of the execution server in the plugin.destinationHost property.
- Specify the scheduler server name running on the logical host in the JP1AJS.serviceName property.
- Specify the logical host name where the scheduler service is running in the JP1.logicalHostName property.
(5) If the job server OS is Linux, set the same setting for the character code of the JP1/AJS environment setting parameter of the job server and for the default locale of the OS user used when connecting to the application server.
Cautions
(1) Specify the scheduler service name that is set to the JP1AJS.serviceName property using 30 bytes or less.
(2) Scheduled execution registration of jobnets registered to the local (JP1/AO server) JP1/AJS are not supported.
(3) For other usage notes, see the usage notes of the ajsentry command in Job Management Partner 1/Automatic Job Management System 3 Command Reference 1.
Execution privilege
- The JP1 user that is mapped to the OS user when connected to the job server has operation privileges for the jobnet that is registered for execution.
- If a JP1 user that is mapped to the OS user when connected to the job server does not exist, specify the JP1 user that has operation privileges for the jobnet that is registered for execution to the jp1ajs.executeJP1UserName property.
Version
01.10.01
Category
JP1/AJS
Plug-in name displayed in the task log
jp1ajsRegisterPlannedExecution
Return code
0: Normal
21: Error (Environmental error) No command was found (An error was detected in the component script)
27: Error (Check with the task log about the error detail) Unidentified error
41: Error (An error has been detected in the component) Property not entered (An error has been detected in the component script)
Property list
The following table lists the properties:
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
---|---|---|---|---|---|
plugin.destinationHost |
Host name of the execution target server |
Specify the host name or IP address of the server on which this plugin will be executed. IPv6 addresses are not supported. |
-- |
Input |
R |
JP1.logicalHostName |
Logical host name for the execution target server |
Specify the JP1 logical host name of the execution target server. |
-- |
Input |
O |
JP1AJS.serviceName |
JP1/AJS service name |
Specify the service name of the scheduler. |
-- |
Input |
O |
JP1AJS.entryJobnetName |
Jobnet name |
Specifies the name of the jobnet where execution registration or scheduled execution results are output as a complete name. The manager job group name and manager jobnet name cannot be specified. |
-- |
Input |
R |
JP1AJS.macroParameter |
JP1/AJS macro variable |
Specifies the macro variable of JP1/AJS combined with a value by using a colon (:). Multiple items separated by a comma can be specified. Up to 32 items can be specified. (Example) AJS2AA:5,AJS2BB:test |
-- |
Input |
O |
JP1AJS.executeJP1UserName |
JP1 user name that executes the AJS command to register scheduled execution of jobnet |
Specifies the JP1 user name used for executing the AJS command to register the jobnet for planned execution. This does not need to be specified when executed by a JP1 user with the same name as the OS user name when connecting to the application server. |
-- |
Input |
O |
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 |
R |
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |