This chapter contains the following topics:
You must use a batch version to process a report. You can submit batch versions from the Microsoft Windows client using these two methods:
Locally
The client immediately launches the batch engine process. You have the option to view the output on screen or send it to a printer.
On the server
The server handles batch processing more efficiently than the workstation. When the batch version is submitted to the server for processing, a message is sent to the server with the defined data selection, data sequencing, and other information necessary to run the report, such as report interconnect values and printer information.
You can submit batch versions to the server using these methods:
The JD Edwards EnterpriseOne Batch Versions (P98305) application on the Microsoft Windows client.
Another report or interactive application using a report interconnect.
You must define the report interconnect in JD Edwards EnterpriseOne Report Design Aid (RDA). The system launches the child batch version from a batch application or interactive application submitted from either the Microsoft Windows client or the web client.
The JD Edwards EnterpriseOne Submit Job (P98305W) application on the web client.
On the web client, batch versions are submitted only to the server.
From the JD Edwards EnterpriseOne Menu on the web client .
For easy access, you can add a report as a task on the JD Edwards EnterpriseOne Menu.
On the Microsoft Windows client, you can select from these options when submitting batch jobs:
| Output Option | Description |
|---|---|
| On Screen. | Enables you to generate a PDF file that is displayed through the Adobe Acrobat Reader. Adobe Acrobat Reader is launched by the system when the processing of the batch version is complete. |
| To Printer. | Enables you to modify output options from the Printer Selection form. |
| Export to CSV. | Enables you to generate both a CSV and a PDF file. The report is displayed through a CSV viewer, such as Microsoft Excel. The CSV viewer is launched automatically by the system when processing of the batch version is complete. |
| Export using output stream access (OSA). | Enables you to export the report to a third-party software application. The location of the output is determined by the OSA interface. For example, the JD Edwards EnterpriseOne Extended Markup Language (XML) interface creates an XML file in the same location where the PDF and CSV outputs are stored. An OSA library created by the vendor of the third-party software to which you are exporting the report, might store the OSA output in a different location. |
Note:
For advanced version prompting options that apply to BI Publisher for JD Edwards EnterpriseOne functionality, see JD Edwards EnterpriseOne Tools BI Publisher For JD Edwards EnterpriseOne Guide.When you launch batch versions from the Microsoft Windows client, the printer information is stored in the pUBEDs structure and passed to the batch engine.
When you submit batch versions to the server, the printer information that is obtained from the Printer Selection form is stored in the Job Control Status Master (F986110) table as a binary large object (BLOB).
When batch jobs are submitted using report interconnects, the printer definition for the child report is inherited from the parent report. The values that are inherited are:
Printer name
Print immediate
SavePDL
Paper type
Printer settings
Number of copies
Paper source
Export to CSV is not an inherited functionality. If the child report has a printer name defined in its specifications or a custom paper type defined, then these properties override the inherited values.
When you print a batch version on the iSeries server, the resulting report is sent to the IFS in PDF. You can map to the reports using Microsoft Windows Explorer.
The default PrintQueue directory is located under the install directory on the server. If you want to create a custom PrintQueue directory, you need to define the PrintQueue in the initialization file using a valid IFS file name.
This code indicates how the jde.ini should be modified for the IFS on the iSeries:
[NETWORK QUEUE SETTINGS]
OutputDirectory = system
When you submit batch versions to a printer, the system looks first for the printer defined in RDA. If no printer is defined in RDA, the system uses the default printer defined in the JD Edwards EnterpriseOne Printers (P98616) application. The system determines a printer based on this hierarchical structure:
Printer defined at runtime.
Printer defined in RDA.
The printer definition becomes part of the report specifications.
Printer defined in the JD Edwards EnterpriseOne Printers application using this hierarchy:
Specific report defined for the user or role.
Specific report defined for *PUBLIC.
All reports defined for the user or role.
All reports defined for *PUBLIC.
Depending on the printer that is selected, the system selects the corresponding Printer Definition Language on the Advanced tab of the Printer Selection form at runtime.
When batch jobs are submitted using report interconnects, the child report inherits the printer definitions from the parent report. At print time, once the job has completed processing, you can override the printer for the child report from the JD Edwards EnterpriseOne Work With Servers (P986116) application.
When you submit a job using RUNUBE, if you do not indicate a printer name through the command line parameters, the printer name stored in the specifications is used at print time; otherwise, the default printer is used. At print time, you can override the printer from the JD Edwards EnterpriseOne Work With Servers application when the job has completed processing.
The paper type that you define for the selected printer is used during job submission. From the Print Property tab on the Printer Selection form, you can change the paper type. Depending on the printer that you select, the Paper Type field is automatically populated by the system with the paper type that is defined for that printer.
When you define a custom paper size in RDA, you cannot change the paper type at runtime.
See Also:
The paper orientation that you select in RDA is stored in the report specifications. Orientation from the specifications is displayed on the Print Property tab of the Printer Selection form at runtime. However, you can change the orientation at runtime.
When you define a custom paper size in RDA, the orientation option is unavailable for selection on the Printer Selection form. In the case of line printers, the Characters per Inch (CPI), Characters per Page (CPP), Lines per Inch (LPI), and Lines per Page (LPP) options that you define for the line printer determine the orientation.
When you select the Export to CSV option in RDA, the definition is stored in the report specifications. This option is displayed in the Report Output Destination form at runtime.
When you submit the batch version to the printer, you have the option of overriding the Export to CSV option on the Document Setup tab of the Printer Selection form. Both a CSV file and a PDF file are created in the PrintQueue directory when the Export to CSV option is selected.
When you submit batch jobs to the server, and the Export to CSV option is defined in RDA, you have the opportunity to modify the option from the JD Edwards EnterpriseOne Work With Servers application.
When batch jobs are submitted using report interconnects, the child report does not inherit the export to CSV option from the parent. Therefore, you must select the CSV option in RDA to enable this option for both the child and parent reports.
The Print Immediate option and the Save PDL setting are defined in the initialization files.
You can define batch jobs to print immediately by modifying the Print Immediate setting in the initialization file. For the Microsoft Windows client, the Print Immediate setting is located in the jde.ini. For the web client, the Print Immediate setting is located in the jas.ini.
When the Print Immediate setting in the initialization file is set to TRUE, all batch versions print immediately upon processing. When you want specific batch versions to print immediately, use the Print Immediate option on the Version Details form for the individual batch version. The Print Immediate option can be overridden at runtime.
You can modify the following setting in the jde.ini to specify the Print Immediate functionality for batch jobs:
[NETWORK QUEUE SETTINGS]
PrintImmediate=TRUE/FALSE
The value of TRUE sends the report output to the printer immediately after processing. FALSE holds the report output in a queue until you select Print from the Row menu on the Submitted Job Search form on the Microsoft Windows client.
You can modify the following setting in the jas.ini to specify the Print Immediate functionality for batch jobs:
[OWWEB]
PrintImmediate=TRUE/FALSE
The value of TRUE sends the report output to the printer immediately after processing. FALSE holds the report output in a queue until you select Print from the Row menu on the Submit Job - Submitted Job Search form on the web client.
This table describes the results of defining batch jobs to print immediately:
| Action | Result |
|---|---|
| The batch job automatically prints. | You do not have to select the Print menu option on the JD Edwards EnterpriseOne Work With Servers application. By default, at runtime, the Print Immediate option is selected on the Document Setup tab on the Printer Selection form. You can override this setting at runtime. |
| The child report inherits the definition from the parent report when batch jobs are submitted using report interconnects. | In this case, you cannot override the Print Immediate option at runtime. |
You can pass the Print Immediate option as an argument when using RUNUBE from the command line. In this case, the job automatically prints when the PrintImmediate setting in the jde.ini is set to TRUE.
You can modify the following setting in the jde.ini to specify the SavePDL functionality on the enterprise server:
[NETWORK QUEUE SETTINGS]
SavePDL=TRUE/FALSE
When you modify the SavePDL setting in the jde.ini to TRUE, both a PDF file and a PDL file are created in the PrintQueue directory. By default, at runtime, the Printer Definition Language File option on the Document Setup tab of the Printer Selection form is selected. However, you can override this option at runtime.
When you modify the SavePDL setting to FALSE, you can select the option at runtime to save the intermediate temporary file. The PDL file resides in the PrintQueue directory. When batch jobs are submitted using report interconnects, the child report inherits the PDL definition from the parent report.
You have the option of modifying the Printer Definition Language File option at runtime. Depending on whether the option is selected or cleared, a PDF and a PDL file are created for that batch job only.