C-LANG Statements › DISTRLISTUSERS Statement—Specify a Distribution List of Operator IDs

DISTRLISTUSERS Statement—Specify a Distribution List of Operator IDs

The DISTRLISTUSERS statement specifies a distribution list of operator IDs to send a PeopleSoft report to.

Supported Job Type

This statement is optional for the PeopleSoft job type.

Syntax

This statement has the following format:

DISTRLISTUSERS operator_id|'operator_id,operator_id...'

operator_id

Specifies an operator ID to send the report to. This value corresponds to the ID Type field (with User selected) and the Distribution ID field in PeopleSoft.

Limits: Case-sensitive

Notes:

• If you specify a single operator ID containing spaces, enclose it in single quotation marks.
• You can specify multiple operator IDs. Separate each operator ID with a comma and enclose the entire list of operator IDs in single quotes.
• The entire value can be up to 4078 characters.
• By default, the report output is sent to the operator ID PSOPRID. If you do not want to distribute the output to any operator IDs, you must include a DISTRLISTUSERS statement in the job definition and set it to two single quotes or provide no value.
• Instead of specifying a list of operator IDs to distribute the report output to, you can distribute the report output to a list of roles using the DISTRLISTROLES statement.
• If the output destination type is EMAIL or WEB, you can also distribute the report output to a list of email addresses using the EMAILADDR statement.
• DISTRUSERS is an alias of DISTRLISTUSERS.

Example: Specify Multiple Operator IDs

This example runs a Crystal report under the VP3 operator ID. The report is formatted as PDF and distributed in an email to the VP1, VP2, and VP3 operator IDs.

AGENT PSAGENT
PROCESSTYPE Crystal
PROCESSNAME XRFWIN
OUTDESTTYPE EMAIL
OUTDESTFORMAT PDF
PSOPRID VP3
RUNCONTROLID test
DISTRLISTUSERS 'VP1,VP2,VP3'

Example: Distribute a Report to Email Addresses Instead of a Distribution List

This example runs a Crystal report under the VP2 operator ID. The output is stored as a PDF web report. The DISTRLISTUSERS statement has no value, so the output is sent to the email addresses specified in the EMAILADDR statement. The email includes a subject title and body text. The web report is included with the email.

AGENT PSAGENT
EMAILADDR 'user1@example.com;user2@example.com'
DISTRLISTUSERS
EMAILWEBREPORT Y
OUTDESTTYPE WEB
OUTDESTFORMAT PDF
PSOPRID VP2
EMAILSUBJECT 'PeopleSoft Report Status'
EMAILTEXT 'The report is available for distribution'
PROCESSNAME XRFWIN
PROCESSTYPE Crystal