External (Directory) Reports
External reports are available for Job objects only. They are stored on the Agents and not in the Automation Engine database and require some configuration.
As a developer and object designer, when configuring Jobs, you can specify whether the external reports should be saved to the database, or remain on the Agent.
This page includes the following:
Registering External Files
From an Automation Engine perspective, these files are external reports, so the first step is to register them as such. This way, you make the Automation Engine aware of their existence. Open the Output Pages of the relevant Job object and enter the path and name of the output files for this purpose. You can also register them using the :REGISTER_OUTPUTFILE script element.
If there are PeopleSoft jobs, you must configure the job to transfer the reports to the Automation Engine. To do so, activate the Register Output Files option in the Job definition. See Transferring Output Files to the Automation Engine.
Transferring External Files
Once registered, these files are available and accessible from the Automic Web Interface. To display them, they are transferred using File Transfer objects. This behavior has the following implications:
- The file size is decisive for the time if takes to transfer the files. This is why large files are split in smaller chunks and displayed in pages you can scroll through.
- Users can only open the files if they have the necessary authorization to access both the job and the external reports for the particular file and for the agent.
- The registered output files are retrieved by the agent; therefore, they must be accessible to the agent. If the agent cannot find the files, or if they cannot be accessed, an error is thrown.
Where You Find them
You can now open the external Job output files as any other report from the Reports window by selecting Directory from the drop-down list.
The basic information about the report is available at a glance on the Directory list:
- The name of the report as indicated on the Job object Output page
- The type of report
- Whether it is saved on the agent or in the Automation Engine database, according to the settings on defined on the object-specific page.
- Whether entering login information is required to be able to download the report. This depends on the job object configuration on the Attributes Page.
Downloading External Reports
You download external reports from the Reports window. You have two options:
- Click the download icon
- Right-click on the report and select Partial Download
It might be necessary to enter login information, this depends on the job object configuration on the Attributes Page.
The download starts immediately. If your report exceeds 10 MB, you are prompt to confirm if you want to download the whole report, or only a user-defined number of lines. Either the first or last ones.
Note: Since the download is performed through a File Transfer, make sure that the user also has execute permissions to open the report.
See also: