DISPLAY REQUESTS - UPPS Command

Description

The DISPLAY REQUESTS command displays a list of request status information records from the PeopleSoft system that match the specified criteria.

Command Line Syntax

The following figure illustrates the command line syntax of the DISPLAY REQUESTS command, using the command line, long form of its configuration options.

-display prcs_findrequests 
{
[-processinstancefrom process_instance] 
[-processinstanceto process_instance] 
[-operatorid id] 
[-processtype type] 
[-processname name] 
[-serverrun server] 
[-runstatus status] 
[-distributionstatus status] 
[-langcode code] 
[-filtervalue value -filterunit {All | Days | Hours | Minutes} | {[-fromDate yyyy-mm-dd] [-toDate yyyy-mm-dd]}]
[-processrequestcount count] 
[-outfmt {text | xml}]
}

Command Argument

The DISPLAY REQUESTS command can be expressed as either:

  • -D (Short form)
  • -display (Long form)

The DISPLAY REQUESTS command argument, prcs_findrequests, displays a list of request status information records from the PeopleSoft system that match the specified criteria.

Configuration Options

The following table describes all DISPLAY REQUESTS configuration options and provides the command line, long form of each option illustrated in the DISPLAY REQUESTS command line syntax, above.

Configuration
Option Name

Command Line
Long Form

Description

PROCESS_INSTANCE_FROM

-processinstancefrom

Starting (lower) process instance ID in a range of instance IDs to be displayed.

PROCESS_INSTANCE_TO

-processinstanceto

Ending (upper) process instance ID in a range of instance IDs to be displayed.

OPERATOR_ID

-operatorid

Filter requests by this operator ID.

PROCESS_TYPE

-processtype

Filter requests by this process type.

PROCESS_NAME

-processname

Filter requests by this process name.

SERVER_RUN

-serverrun

Filter requests by this server name.

RUN_STATUS

-runstatus

Filter requests by this run status.

DISTRIBUTION_STATUS

-distributionstatus

Filter requests by this distribution status.

LANGUAGE_CODE

-langcode

Filter requests by this language code.

FILTER_VALUE

-filtervalue

Integer value that will be interpreted in FILTER_UNIT units to provide a time range for filtering requests.

FILTER_UNIT

-filterunit

Unit used to interpret FILTER_VALUE to provide a time range for filtering requests.

FROM_DATE

-FromDate

Explicit from date in the form of yyyy-mm-dd.

TO_DATE

-ToDate

Explicit from date in the form of yyyy-mm-dd.

PROCESS_REQUEST_COUNT

-processrequestcount

Limit to the number of requests that will be returned.

OUTPUT_FORMAT

-outfmt

Format of the output for this command.

Example

upps -userid USERNAME1 -pwd PASSWORD1 -host qapsft.stone.branch -port 8000 -display prcs_findrequests -operatorid USERNAME1 -runstatus Cancel
Process Instance..........: 140596
Process Name..............: CC_TEST
Process Type..............: PSJob
Job Name..................: CC_TEST
Run Control Id............: ESS1A
Server Name Requested.....:
Server Name Run...........: PRCS1090
Operator Id...............: USERNAME1
Request Date Time.........: 2018-02-08-14.00.47.627040
Run Date Time.............: 2018-02-08-14.00.47.000000
Begin Date Time...........: 2018-02-08-14.00.54.203951
End Date Time.............: 2018-02-08-14.01.13.266331
Output Destination Format.: (None)
Output Destination Type...: NONE
Recurrence Name...........:
Run Status................: Cancel
Distribution Status.......: N/A

UNV6830E Universal Connector for PeopleSoft Process Scheduler ending with exit code 0.