Defining general options for an ODF report bundle

Before you begin

To define general options for a report bundle, you must be a system administrator or a user with ODF Administration authority.

About this task

For all optional parameters, you have two choices:
  • Leave them blank. During processing, ODF inherits the values that you specified for these parameters when you created the distribution.
  • Specify values for them. ODF uses the values that you specify for these parameters and overrides the values from the distribution.
The following are descriptions of all the parameters:
Distribution Name
The Distribution Name field is already filled with the value from the distribution. Because a report bundle is an integral part of a distribution, when a report bundle is added, the initial value for this field comes from the value that you specify in the distribution. You cannot update the distribution name.
Recipient/List
The Recipient/List field is already filled with the value from the distribution. Because a report bundle is an integral part of a distribution, when a report bundle is added, the initial value for this field comes from the value that you specify in the distribution. You cannot update the recipient ID or recipient list.
Sequence
This field is required. Enter a numeric value that is greater than or equal to 1 to uniquely identify the report bundle within the distribution. This value determines the order of the report bundle within the distribution. You can change the order of the report bundle in the distribution by changing the sequence number. For a new report bundle, the sequence is initialized to 10 if it is the first report bundle in the distribution. If there are existing report bundles, the sequence of a new report bundle is initialized to 10 plus the largest sequence number.
Report ID
Select the report ID of the report that you want to add to the distribution. This selection is required.
Report Build
In this drop-down list, select Full to let the system extract all of the documents in a load. Select Query to indicate that an SQL query is used to extract portions of the documents in a load.
SQL Source
Build an SQL query by clicking Keyboard or Build SQL. Then click Modify and enter a valid WHERE clause.

You can specify a wildcard with a substring in the SQL statement. When the SQL statement runs, ODF inserts the correct portion of the recipient or recipient list name into the SQL statement. The format of the wildcard is:

$ODF_RECIPIENT(starting-position:length) or

$ODF_RECIPLIST(starting-position:length)

where starting-position is the number of the first character to include and length is the number of characters to use. (starting-position:length) is optional.

Status
In the drop-down list, select Active to activate this report bundle. Select Inactive to deactivate this report bundle.
Job Name
Specify the job name for the report bundle. The value entered in this field overrides the job name specified in the associated distribution. If a job name is specified, but no job name was specified in the distribution, the value is ignored. On z/OS, when you use a job name on the distribution, ODF uses a feature of z/OS that allows the print process to run in a created address space. On IBM i and Multiplatforms servers, the job name value is ignored. The job name can also be used as search criteria when using the OnDemand Monitor. This value is optional. Job names are optional strings of length 1-8 and can have alphanumeric (A-Z,0-9) characters and national symbols (@,#,$). The first character must be an alphabetic or national symbol.
Wait/Ignore Indicator
This field is used to indicate whether this report bundle identifies a required report. If Wait is selected, then the distribution is not submitted for print processing until the report becomes available or the distribution method overrides the Wait/Ignore Indicator. If Don't Wait is selected, the distribution process continues even if the report is not available.
Location
Specify the output location for the report bundle. If not specified, then the location value specified in the distribution definition is used. If you specify a Location value, you must also select a Transform value. This value is optional. You can change this value for each report bundle in the distribution. Specify the output location:
Print
Output is available for printing.
File
Output is written to a file or data set.
E-mail
An email is sent to the email address associated with the recipient, with the document attached.
None
The distribution output is not generated. An email is sent, notifying the recipients that the report has been loaded into Content Manager OnDemand.
Notify by e-mail
Select this checkbox to receive an email notification when the report bundle is processed.
Transform
Data is transformed from one data type to another and the resulting converted data is what is distributed. PDF is typically selected when converting line data or AFP. For example, AFP data can be converted to PDF and sent in an email or printed. UTF-8 is typically selected when converting line data to UTF-8. For example, EBCDIC data can be converted to UTF-8 and sent in an email. None is typically selected if you do not need the output converted. If you specify a Location value, you must also select a Transform value, otherwise this field is optional.
File Name Location
If the output is an HFS file, specify a path name.
On z/OS, if the output data set is a Generation Data Group (GDG), enter the GDG base name. The base name must conform to the z/OS rules. See the z/OS Reference manual for more information.
On z/OS, if the field is left blank, a non-GDG data set is created using the high-level qualifier specified by the ARSODF_DATASET_HLQ parameter in the ARS.CFG file.
On an IBM i or Multiplatforms server, if the field is left blank, a default path name is used, specified by the ARSODF_FILE_LOCATION parameter in the ARS.CFG file. If the ARSODF_FILE_LOCATION parameter is not specified, then the path specified by the ARS_TMP parameter in the ARS.CFG file is used.
Customer Variables
This is a user-defined data field which allows you to enter values to be used by the print processor exits. This field is optional. Enter up to 55 bytes. If not specified, the value in the distribution is used.