4.6.8 JP1/AJS jobnet scheduled execution results output
Function
This component outputs the following to the specified scheduled execution results file on the job server: the information including the execution results up to the previous time, the current status, and next execution schedule of the jobnet whose execution has been registered for 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.
Before the execution, check the format and the order of the start date and the end date of the scheduled execution results output.
Use situation
Outputs the next execution schedule in the specified period of the jobnet whose execution has been registered to a file on the specified job server.
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 referenced jobnet must be already created.
(2) The referenced jobnet calendar and schedule rules must be already defined.
(3) Specify the JP1 user name in the JP1AJS.executeJP1UserName property for outputting jobnet scheduled execution results by the execution target server. If scheduled execution results are output 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 referencing 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 application 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 job server.
Cautions
(1) Specify the scheduler service name that is set to the JP1AJS.serviceName property using 30 bytes or less.
(2) For the value to be set in the JP1AJS.outputFormat property, see the description of the -i option of the ajsshow command in "Command Reference 1" of the JP1/AJS manual .
(3) If the job server OS is Windows and multibyte characters are specified, specify the scheduled execution results file that is set to the common.outputFileName property using a maximum length of 256 bytes.
(4) If a scheduled execution results file already exists, the existing file is overwritten.
(5) If a folder of the path specified in the scheduled execution result file does not exist, the folder is created. The created folder remains and is not deleted. Delete unused folders on a regular basis.
(6) The content is output as specified by the format specifier that has been set in the JP1AJS.outputFormat property. If the jobnet name includes double quotations ("), an error might occur when the ODBC driver reads the name, so replace the mark with a character as needed.
(7) For other usage notes, see the usage notes of the ajsshow 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 application server has browsing privileges for the jobnet that is registered for execution.
- If a JP1 user that is mapped to the OS user when connected to the application server does not exist, specify the JP1 user that has browsing privileges for the target jobnet in the jp1ajs.executeJP1UserName property.
Version
02.00.00
Plug-in tags
Gather JP1 information,AJS,Windows,Linux,AIX
Plug-in name displayed in the task log
jp1ajsOutputSchedule
Return code
0: Normal
12: Error (Mistake by user) Invalid property
14: Error (Mistake by user) File inaccessible
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.executeJP1UserName |
JP1 user name that executes the AJS command to output the scheduled execution results of jobnet |
Specifies the JP1 user name used for executing the AJS command to output the scheduled execution results file of the jobnet. No need to specify when executed by a JP1 user with the same name as the OS user name when connecting to the application server. |
-- |
Input |
O |
|
JP1AJS.outputStartDate |
Jobnet scheduled execution results output start date |
The output start date of the scheduled execution results of the jobnet is separated by a hyphen (-) or slash (/) and specified in the following format: YYYY-MM-DD or YYYY/MM/DD. |
-- |
Input |
R |
|
JP1AJS.outputEndDate |
Jobnet scheduled execution results output end date |
The output end date of the scheduled execution results of the jobnet is separated by a hyphen (-) or slash (/) and specified in the following format: YYYY-MM-DD or YYYY/MM/DD. |
-- |
Input |
R |
|
JP1AJS.outputFormat |
Format of the scheduled execution results file |
Specifies the format specifier of the -i option of the ajsshow command. |
-- |
Input |
R |
|
common.outputFileName |
Scheduled execution results file |
Specifies the file to which the scheduled execution results of the jobnet are output. |
-- |
Input |
R |
|
common.returnValue |
Return value for the plugin |
The return value of this component is stored. |
-- |
Output |
O |