Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Panel
-
deffmt

-RunControlId

-ProcessType

-RunControlId

-ProcessType

{-ProcessName

-JobName

-ServerName

-RunDateTime

-TimeZone

-RecurrenceName

-OutputDestinationType

-OutputDestinationFormat

-OutputDestinationString

-ReportFolderName

-ProcessFileName

-RetentionDays

-wait

-poll

-PrintJobTree

-PrintDistList

-PrintSystemMessage

-PrintApplicationMessage

-PrintParamList

-report

-cntfilter
sub 
{
   {filename -deffmt {xml | upps} [-RunControlId ID] [-ProcessType type}]} | 
   {-RunControlId ID -ProcessType type} {-ProcessName name | -JobName name}} 
   [-ServerName name]
   [-RunDateTime dateTime]
   [-TimeZone zone]
   [-RecurrenceName name]
   [-OutputDestinationType type]
   [-OutputDestinationFormat format]
   [-OutputDestinationString string]
   [-ReportFolderName name]
   [-ProcessFileName name]
   [-RetentionDays days]
}
[-wait   [-poll seconds]
   [-PrintJobTree {yes | no}]
   [-PrintDistList {yes | no}]
   [-PrintSystemMessage {yes | no}]
   [-PrintApplicationMessage {yes | no}]
   [-PrintParamList {yes | no}]
   [-report {yes | no}]
   [-cntfilter filterList]
] 


Note
titleNote

As the command line syntax illustrates, you can specify all of the options before the -wait on the command line to override values (if present) in the definition file.

...

Configuration
Option Name

Command Line
Long Form

Description

CNT_FILTER

-cntfilter

Comma-delimited list of report file suffixes that will not be returned.

DEFINITION_FILE_FORMAT

-deffmt

Format of the definition file.

JOB_NAME

-JobName

Name of the job being referenced by a command.

OUTPUT_DESTINATION_FORMAT

-OutputDestinationFormat

Override of the default output format for the submitted process.

OUTPUT_DESTINATION_STRING

-OutputDestinationString

Override for the file path or printer destination for the output, if the output type for a submitted process is File or Printer.

OUTPUT_DESTINATION_TYPE

-OutputDestinationType

Type of output for a submitted process.

PROCESS_FILE_NAME

-ProcessFileName

Override for the dependent file name for the submitted process.

PROCESS_NAME

-ProcessName

Name of a PeopleSoft process for which parameter names will be returned.

PROCESS_TYPE

-ProcessType

Specific type of PeopleSoft process.

RECURRENCE_NAME

-RecurrenceName

Named recurrence definition to apply to the process submission.

REPORT

-Report

Specification for whether or not the reports associated with a process are returned.

REPORT_FOLDER_NAME

-ReportFolderName

Override for the folder name for the main job or process.

RETENTION_DAYS

-RetentionDays

Override for the retention days defined for a submitted process.

RUN_CONTROL_ID

-RunControlId

Run control ID to be used for the process submission.

RUN_DATE_TIME

-RunDateTime

Custom run date time for the submitted process.

SERVER_NAME

-ServerName

Specific server name for which constraints will be returned.

TIME_ZONE

-TimeZone

Time zone to use for the RUN_DATE_TIME configuration option.

POLL

-poll

Length of time to wait between status calls to the PeopleSoft system.

PRINT_APPLICATION_MESSAGE

-printapplicationmessage

Specification for whether or not application messages are printed for the monitored processes when the work completes.

PRINT_DIST_LIST

-printdistlist

Specification for whether or not to print the report-recipient distribution list for the monitored process when the work completes.

PRINT_JOB_TREE

-printjobtree

Specification for whether or not to print the job tree when the monitored process completes.

PRINT_PARAM_LIST

-printparamlist

Specification for whether or not the parameter list for job items are included in the report.

PRINT_SYSTEM_MESSAGE

-printsystemmessage

Specification for whether or not system messages for the monitored processes when the work completes.

WAIT for PROCESS

-wait

Specification that UPPS will monitor the specified process to completion.
 

Note
titleNote

In the SUBMIT_PROCESS command line syntax, the WAIT for PROCESS (-wait) is a UPPS command used as a configuration option.


Example

Panel
upps -userid USERNAME1 -pwd PASSWORD1 -host

-port

-processname

-runcontrolid

-processtype

 qapsft.stone.branch -port 8000 -sub .\TM_parms.txt -processname TREEMOVER -runcontrolid ESS1A -processtype "Application Engine"

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

upps -userid USERNAME1 -pwd PASSWORD1 -host

-port

-processname

-runcontrolid

-processtype
 qapsft.stone.branch -port 8000 -sub .\TM_parms.txt -processname TREEMOVER -runcontrolid ESS1A -processtype "Application Engine" -wait

UNV6817I Process status for TREEMOVER/140607 is now queued.

UNV6817I Process status for TREEMOVER/140607 is now no success.
Process Instance..........: 140607
Process Name..............: TREEMOVER
Process Type..............: Application Engine
Run Control Id............: ESS1A
Server Name Run...........: PRCS1090
Operator Id...............: USERNAME1
Request Date Time.........: 2018-02-08-14.44.14.514964
Run Date Time.............: 2018-02-08-14.44.14.000000
Begin Date Time...........: 2018-02-08-14.44.23.302174
End Date Time.............: 2018-02-08-14.44.23.500502
Output Destination Format.: TXT
Output Destination Type...: WEB
Run Status................: no success
Distribution Status.......: n/a

UNV6834I Distribution status for TREEMOVER/140607 is now posted.
Process Instance..........: 140607
Process Name..............: TREEMOVER
Process Type..............: Application Engine
Run Control Id............: ESS1A
Server Name Run...........: PRCS1090
Operator Id...............: USERNAME1
Request Date Time.........: 2018-02-08-14.44.14.514964
Run Date Time.............: 2018-02-08-14.44.14.000000
Begin Date Time...........: 2018-02-08-14.44.23.302174
End Date Time.............: 2018-02-08-14.44.38.407472
Output Destination Format.: TXT
Output Destination Type...: WEB
Run Status................: no success
Distribution Status.......: posted
Content Id................: 29626

*******************************************************************************
Report URL.........: http://qapsft.stone.branch:8000/psreports/ps/29626/AE_TREEMOVER_140607.stdout
Report Description.: Redirected Terminal Output
*******************************************************************************
PeopleTools 8.55.09 - Application Engine Server
Copyright (c) 1988-2018 Oracle and/or its affiliates.
All Rights Reserved
PSAESRV started service request at 14.44.23 2018-02-08
Begin: PeopleSoft TreeMover (125,2)
A file with the name ESS1A-TreeExp1 already exists. Cannot overwrite. (125,498)
PeopleSoft TreeMover Completed Unsuccessfully. (125,5)
End: PeopleSoft TreeMover (125,3)
PeopleCode Exit(1) Abort invoked by Application at TREEMOVER.Export.Step01. (108,543)
Process 140607 ABENDED at Step TREEMOVER.Export.Step01 (PeopleCode) -- RC = ? (108,524)
Process %s ABENDED at Step %s.%s.%s (Action %s) -- RC = %s
PSAESRV completed service request at 14.44.23 2018-02-08

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