4.6.12 Get JP1/AJS jobnet execution results
Function
Obtains on a specified server a jobnet's execution results for JP1/AJS3 - Manager (or JP1/AJS2 - Manager; hereafter, both are referred to collectively as JP1/AJS).
This plugin assumes the following server:
• Job server (Execution target server)
This is the server that obtains the execution results of a JP1/AJS jobnet. The JP1/AJS described in the prerequisites must have already been set up.
Use situation
You use this plugin to acquire the execution results of a jobnet executed by the jp1ajsExecute plugin.
Because the execution results are stored in the jobnetState property, you can change the behavior of the service template on the basis of the results that are obtained.
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]
(1)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 to be registered and executed has already been created.
(2) You specify in the JP1AJS.executeJP1UserName property the name of the JP1 user who is to acquire the jobnet execution results on the execution target server. If this JP1 user has the same name as the OS user who is connected from JP1/AO, there is no need to specify this property.
(3) To acquire the jobnet execution results defined on a logical host in a cluster configuration:
• Specify the active server's physical host name or logical host name in the plugin.destinationHost property.
• Specify the name of the scheduler service running on the logical host in the JP1AJS.serviceName property.
• Specify the name of the logical host on which the scheduler service is running in the JP1.logicalHostName property.
Cautions
(1) If multiple jp1ajsExecute plugins are executed in parallel on the same jobnet of the same scheduler, the plugin acquires the results of the last jobnet that executes.
Execution privilege
The following settings are required for the OS user who will be connecting from JP1/AO to the job server.
If the JP1 user name and the OS user name are not the same, make sure that you specify the jp1ajs.executeJP1UserName property.
[Common to both Windows and UNIX]
The user name must be the same as the name of a JP1 user to whom JP1_AJS_Guest, JP1_AJS_Operator, JP1_AJS_Editor, JP1_AJS_Manager, or JP1_AJS_Admin permissions are granted.
Version
02.00.00
Plug-in tags
Gather JP1 information,AJS,Windows,Linux,AIX
Plug-in name displayed in the task log
jp1ajsCheck
Return code
0: Normal
21: Error (invalid environment) Command cannot be found (error detected in the plugin script)
27: Error (check task logs for the nature of error)
41: Error (error detected in plugin) Missing property (error detected in plugin script)
42: Error (error detected in plugin) Internal error (error detected in the plugin script)
Property list
The following table lists the properties:
|
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
|---|---|---|---|---|---|
|
JP1AJS.serviceName |
JP1/AJS service name |
Specify the service name of the scheduler.Specify the service name of the JP1/AJS on logical host (when using business server in a cluster configuration). |
-- |
Input |
O |
|
JP1AJS.jobnetName |
Jobnet name |
Specify the name of the jobnet whose execution results are to be acquired. |
-- |
Input |
R |
|
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 |
|
JP1AJS.executeJP1UserName |
Name of the JP1 user to review the jobnet results |
Specify the name of the JP1 user to review the results from the jobnet. This does not need to be specified if the executing JP1 user has the same name as the OS user who is connected to the execution target server. |
-- |
Input |
O |
|
JP1.logicalHostName |
Logical host name for the execution target server |
Specify the JP1 logical host name of the execution target server. |
-- |
Input |
O |
|
JP1AJS.jobnetResult |
Jobnet results |
This property stores the result of jobnet execution. |
-- |
Output |
O |
|
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |