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.48.027040
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.