4.6.1 Register for JP1/AJS jobnet fixed execution
Function
This component registers the fixed 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.
With this component, only the registration of the fixed execution of a jobnet is available.
- When executing a jobnet on a particular date and time (Specify date and time)
Specify the fixed execution date and time.
- When specifying and executing the scheduled execution number of generations of jobnet (Specify number of future generations)
Specify the number of future generations.
Make sure that one of the above is specified.
Before the execution, check the format of the fixed execution date and the fixed execution time.
Use situation
The following methods of registering the fixed execution are available for the jobnet created.
- Specify the fixed execution date and time (Specify date and time) to register the fixed execution.
- Specify the number of future generations (Specify number of future generations) to register the fixed execution.
Prerequisites
For the latest support information about [Required product in the System]/[Required products on the execution target server]/[Prerequisite product OS running in the execution target server], see the release notes.
[Required product in the System]
JP1/Automatic Operation 11-00 or later
[Required products on the execution target server]
(1)Job Management Partner 1/Automatic Job Management System 3 - Manager 09-00 or later, or
JP1/Automatic Job Management System 3 - Manager 11-00 or later
[Prerequisite product OS running in the execution target server]
(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 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 UNIX, set the same setting for the character code of 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.
Cautions
(1) Specify the scheduler service name that is set to the JP1AJS.serviceName property using 30 bytes or less.
(2) When specifying a particular date and time (Specify date and time), specify both the JP1AJS.executeDate and JP1AJS.executeTime properties.
(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
02.00.00
Plug-in tags
Configure JP1,AJS,Windows,Linux,AIX
Plug-in name displayed in the task log
jp1ajsRegisterFixedExecution
Return code
0: Normal
12: Error (Mistake by user) Invalid property
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 fixed execution of jobnet |
Specifies the JP1 user name used for executing the AJS command to register the jobnet for fixed 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.executeDate |
Jobnet fixed execution date |
The fixed execution date when the jobnet is registered for fixed execution is separated by a hyphen (-) or slash (/) and specified in the following format: YYYY-MM-DD or YYYY/MM/DD. |
-- |
Input |
O |
|
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 colon (:) and minutes can be omitted. When omitted, this is assumed to be 0 minutes. |
-- |
Input |
O |
|
JP1AJS.executeGenerattion |
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 |
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 |