C-LANG Statements › DISTRLISTROLES Statement—Specify a Distribution List of Roles

DISTRLISTROLES Statement—Specify a Distribution List of Roles

The DISTRLISTROLES statement specifies a distribution list of the roles that represent the individuals who are receiving the PeopleSoft report.

Supported Job Type

This statement is optional for the PeopleSoft job type.

Syntax

This statement has the following format:

DISTRLISTROLES role|'role,role...'

role

Specifies a role or a list of roles to send the report to. This value corresponds to the ID Type field (with Role selected) and the Distribution ID field in PeopleSoft.

Limits: Case-sensitive

Notes:

• If you specify a single role containing spaces, enclose it in single quotation marks.
• You can specify multiple roles. Separate each role with a comma and enclose the entire list of roles in single quotes.
• The entire value can be up to 4078 characters.
• An alternative to using this statement is to use operator IDs as specified by the DISTRLISTUSERS statement.
• DISTRROLES is an alias of DISTRLISTROLES.

Example: Specify Multiple Roles

This example runs a Crystal report under the VP1 operator ID. The report output type is WEB and the output format is PDF. The report is distributed to the CLERK, BANK MANAGER, and Employee roles.

AGENT PSAGENT
PROCESSTYPE Crystal
PROCESSNAME XRFWIN
OUTDESTTYPE WEB
OUTDESTFORMAT PDF
DISTRLISTROLES 'CLERK,BANK MANAGER,Employee'
PSOPRID VP1

Example: Specify One Role

This example runs a Crystal report under the VP1 operator ID. The report output type is WEB and the output format is PDF. The report is distributed to the BANK MANAGER role.

AGENT PSAGENT
PROCESSTYPE Crystal
PROCESSNAME XRFWIN
OUTDESTTYPE WEB
OUTDESTFORMAT PDF
DISTRLISTROLES 'BANK MANAGER'
PSOPRID VP1