Configuring Runtime Options from the Command Line

You can create, export, import, and overwrite an existing runtime option from the command line.

You can configure new runtime options through the command line. To do this you will need to create a response file.

A response file is a text file with parameters. It is a secured way to pass parameters to the command line while creating runtime options.

Create a response file for example, c:\resp_file.txt with the parameters described further. Then run PsTestFw "C:\resp_file.txt" to create an runtime option.

If validation fails, the runtime options are not created.

PeopleSoft Test Framework provides a template to generate a response file. The response file template includes the following:

Parameters

Description

-CS

Server:Port

-CO

User name

-CP

Password

-CNO

(Optional) Node name

-CUA

(Optional) Action on the SSL error. Values are:

  • True– Continue with unsecured connection.

  • False– Cancel the login.

-Action

Runtime option migration type. Values are:

  • rtoimp for importing runtime options.

  • rtoexp for exporting runtime options.

  • rtogen for generating runtime options.

  • testrun for running a test.

-Log

(Optional) Specify the name for the test runtime log. The default is unattended.log.

The following table describes the parameters to create runtime options, included in the response file.

Parameters

Descriptions

EXECOPTNAME

Name of runtime options

Note that:

  • It is a required field.

  • Do not use special characters such as: “&”, “\”, “*”, “<”, “?”.

URL

URL

(Optional) It cannot be validated like the URL configured in the PTF client.

TOOLSPATH

DMSINPUT

DMSOUTPUT

DMSWORKING

LOGEXPPATH

File paths

(Optional) PTF checks for special characters in the file path such as: “|”, “<”, “*”, “?”

PERSISTVARIABLES

If value is set to Yes, then following parameters are also required.

BYEONAME

BYUSERID

BYMACHINE

BROWSER

Browser type where values can be:

  • Chrome

  • Firefox

  • Microsoft Edge

NOWINDOW

Set the value to Yes (Y) to enable the Run In Background option.

Note: Use this parameter only if you have selected the Chrome or Microsoft Edge browser.

FORMFACTOR

Form factor type where values can be:

  • L

  • M

  • N

  • S

  • X

PROMPT

SKIPLANGUAGE

VERBOSE

SKIPPAGESAVE

SKIPRUNREQUEST

LOGEXPUSE

LOGEXPDTTMSTAMP

LOGEXPIMAGE

These parameters accept Yes or No values.

SSBYDEFAULT

SSMUSTBESEC

Based on the browser selected, a supported value is set for these SameSite flag parameters.

The supported values are:

  • DEF

  • ENA

  • DIS

  • TRU

  • FAL

This table details the SameSite flag parameter values, which are set based on the browser selected:

Browser

SameSite Flag Name

Response File Parameter

Command Line Value

Chrome

SameSite by default cookies

SSBYDEFAULT

  • DEF

  • ENA

  • DIS

Cookies without SameSite must be secure

SSMUSTBESEC

  • DEF

  • ENA

  • DIS

Firefox

network.cookie.sameSite.laxByDefault

SSBYDEFAULT

  • TRU

  • FAL

network.cookie.sameSite.noneRequiresSecure

SSMUSTBESEC

  • TRU

  • FAL

Microsoft Edge

SameSite by default cookies

SSBYDEFAULT

  • DEF

  • ENA

  • DIS

Cookies without SameSite must be secure

SSMUSTBESEC

  • DEF

  • ENA

  • DIS

Here is an example of a response file.

# Specify the server:port to connect to.
-CS=example.us.abc.com:8001
# Specify the user name
-CO=XY
# Specify the user password
-CP=XY
# Specify the node name
-CNO=
# Please keep this item as it is
-ACTION=rtogen
#Specify action of SSl error
-CUA=
# Specify the file path of runtime options creation log
-LOG=eo-create.log
# Following items are the fields of runtime options.
# The field EXECOPTNAME is required.
[EXECOPT]
EXECOPTNAME=TESTNK
PROMPT= No
URL=http://example.us.abc.com:8000/h92vknewx/signon.html
BROWSER= Chrome
USER=XY
PASSWORD=XY
VERBOSE= No
NOWINDOW= Y
SSBYDEFAULT=ENA
SSMUSTBESEC= ENA
# Add multiple instances of the runtime options
PORTAL_NAME_1= CUSTOMER
PORTAL_VALUE_1= http://example.com:8000/psp/database/CUSTOMER/FSCM/
PORTAL_NAME_2= EMPLOYEE
PORTAL_VALUE_2= http://example.com:8000/psp/database/EMPLOYEE/ERP/

Note: To define multiple instances of runtime options settings, suffix an index for each runtime options instance. Specify the instance with the parameters PORTAL_NAME and PORTAL_VALUE.

You can export runtime options using command line. Enter PsTestFw "C:\export_exo.txt" where export_exo.txt is the response file. The response file will have following parameters:

Parameters

Description

-CS

Server:Port

-CNO

Node name

-CO

User name

-CP

Password

-CUA

(Optional) Specify the action of SSL error. Values are:

  • True- Continue with the unsecured connection.

  • False- Cancel the login.

-ACTION

Specify the migration type. For exporting runtime options enter rtoexp

-RTO

Specifies the name of the runtime option, which is exported.

Add a comma; multiple runtime options can be selected.

-FILEPATH

Specifies the location and the file name where the runtime option data file is stored. For example C:\PsTestFrameWork\eo-export.dat.

Here is an example of the response file for exporting runtime options:

-CS=<Server> 
–CNO=<Nodeid> 
–CO=<username> 
-CP=<ConnectionPassword> 
–ACTION=rtoexp
-RTO=LOCAL
-FILEPATH=<Path & exporting file name>

On successful creation of the export file for the runtime options, a log file with the name unattended.log is also created under the export folder. The location of the export folder is specified in the Local Options dialog box. See Export/Import Options.

You can import runtime options from a data file to a database. The response file which is used to import the runtime options include server name, node name, user name, password, instances of runtime options to import, and the file path where the data file is located. See Exporting Runtime Options.

Overwrite Parameter

The overwrite parameter allows overwrite of runtime options with same name.

Field or Control

Description

–OVW

Y/N

A sample response file for importing runtime options and over writing existing runtime option is as follows:

-CS=<Server> 
–CNO=<Nodeid> 
–CO=<username>
-CP=<ConnectionPassword> 
–ACTION=rtoimp
#Over write exisitng runtime option with same name.
-OVW=Y
-FILEPATH=<Path & importing file name>
-LOG= c:\temp\eo-import.log