/
DISPLAY REQUESTS - UPPS Command

DISPLAY REQUESTS - UPPS Command

Feb 06, 2023

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 { [-processinstancefromprocess_instance] [-processinstancetoprocess_instance] [-operatoridid] [-processtypetype] [-processnamename] [-serverrunserver] [-runstatusstatus] [-distributionstatusstatus] [-langcodecode] [-filtervaluevalue-filterunit {All | Days | Hours | Minutes} | {[-fromDateyyyy-mm-dd] [-toDateyyyy-mm-dd]}] [-processrequestcountcount] [-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

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