Overview

Note

These instructions assume the user has a working knowledge of PeopleSoft.

The PeopleSoft task allows you to send commands to a PeopleSoft system and gather status information and output back from PeopleSoft. The PeopleSoft task uses Stonebranch's proprietary Universal Connector for PeopleSoft (UPPS) to communicate with PeopleSoft . Universal Connector for PeopleSoft allows Universal Controller to connect to a PeopleSoft system and manage PeopleSoft background processing tasks.

Before You Begin

To run a PeopleSoft task, you must first complete the following:

Identify a Universal Agent for Linux/Unix that will interface with the PeopleSoft system.
Define an PeopleSoft connection in the Controller database.

Built-In Variables

The following built-in variables can be used in a PeopleSoft task to pass data where appropriate:

Creating a PeopleSoft Task

Step 1

From the Automation Center navigation pane, select Tasks > PeopleSoft Tasks. The PeopleSoft Tasks list displays a list of all currently defined PeopleSoft tasks.

To the right of the list, PeopleSoft Task Details for a new PeopleSoft task displays.

Step 2

Enter/select Details for a new PeopleSoft task, using the field descriptions below as a guide.

Required fields display an asterisk ( * ) after the field name.
Default values for fields, if available, display automatically.

To display more of the Details fields on the screen, you can either:

Use the scroll bar.
Temporarily hide the list above the Details.
Click the
button above the list to display a pop-up version of the Details.

Step 3

Click the

button. The task is added to the database, and all buttons and tabs in the Task Details are enabled.

Note

To open an existing record on the list, either:

Click a record in the list to display its record Details below the list. (To clear record Details below the list, click the New button that displays above and below the Details.)
Clicking the Details icon next to a record name in the list, or right-click a record in the list and then click Open in the Action menu that displays, to display a pop-up version of the record Details.
Right-click a record in the a list, or open a record and right-click in the record Details, and then click Open In Tab in the Action menu that displays, to display the record Details under a new tab on the record list page (see Record Details as Tabs).

PeopleSoft Task Details

The following PeopleSoft Task Details is for an existing PeopleSoft task.

Depending on the values that you enter / select for these fields, and whether or not the PeopleSoft task has ever been launched, more (or less) fields may display. See the field descriptions, below, for a description of all fields that may display in the PeopleSoft Task Details.

PeopleSoft Task Details Field Descriptions

The following table describes the fields, buttons, and tabs that display in the PeopleSoft Task Details.

Field Name	Description

Field Name	Description
General	This section contains general information about the task.
Name
Version
Description
Member of Business Services
Resolve Name Immediately
Time Zone Preference
Hold on Start
Hold Reason
Virtual Resource Priority
Hold Resources on Failure
Mutually Exclusive With Self
Simulate
Override Previous Instance Wait
Agent Details	This section contains assorted detailed information about the Agent / Agent Cluster selected for this task.
Cluster
Utility Agent
Utility Agent Variable
Utility Agent Cluster
Utility Agent Cluster Variable
Utility Credentials
Utility Credentials Variable
PeopleSoft Details	This section contains assorted detailed information about the task.
PeopleSoft Connection
PeopleSoft Connection Variable
PeopleSoft Credentials
PeopleSoft Credentials Variable
Command
Run Control ID
Process Type
Process/Job Name
Server Name
Output Destination Type
Output Destination Format
Output Destination String
Process File Name
Main Schedule Name
Main Job Name
Print Distribution List
Print Parameter List
Print Application Message
Print System Message
Print Job Tree
Report
Content Filter
PeopleSoft Distribution Details	If Command = Schedule Process or Schedule Job; This section contains assorted distribution details about the task.
Report Folder Name
Retention Days
Email Address List
Email Subject
Email Text
Email With Log
Email Web Report
Distribution Options
Result Processing Details	This section contains assorted detailed information about result processing for this task.
Exit Code Processing
Output Type
Scan Output For
Output File (for Exit Code Processing)
Exit Codes
Automatic Output Retrieval
Wait For Output
Failure Only
Start Line
Number of Lines
Scan Text
Output File (for Automatic Output Retrieval)
Retry Options	This section contains specifications for retrying the task.
Maximum Retries
Retry Indefinitely
Retry Interval (Seconds)
Suppress Intermediate Failures
Wait / Delay Options	This section contains specifications for waiting to start and/or delaying on start the task.
Wait To Start
Wait Time
Wait Day Constraint
Wait Duration
Wait Duration In Seconds
Delay On Start
Delay Duration
Delay Duration In Seconds
Workflow Only
Time Options	This section contains time-related specifications for the task.
Late Start
Late Start Type
Late Start Time
Late Start Day Constraint
Late Start Nth Amount
Late Start Duration
Late Finish
Late Finish Type
Late Finish Offset Type
Late Finish Percentage Offset ( + )
Late Finish Duration Offset ( + )
Late Finish Duration Offset Unit
Late Finish Time
Late Finish Day Constraint
Late Finish Nth Amount
Late Finish Duration
Early Finish
Early Finish Type
Early Finish Offset Type
Early Finish Percentage Offset ( - )
Early Finish Duration Offset ( - )
Early Finish Duration Offset Unit
Early Finish Time
Early Finish Day Constraint
Early Finish Nth Amount
Early Finish Duration
User Estimated Duration
Critical Path Options	This section contains Critical Path-related specifications for the task.
CP Duration
CP Duration (Resolved)
CP Duration Unit
Workflow Execution Options	This section contains Execution Restriction specifications for the task if it is within a Workflow.
Execution Restriction
Restriction Period
Before Date
Before Time
After Date
After Time
Date List
Self-Service Options	This section contains Self-Service specifications for the task.
Enforce Variables
Lock Variables