Constructing Command Lines for Configuring Change Assistant

Configuring Change Assistant includes the following:

  • ENVIMP = Import Environment

  • ENVCREATE = Create Environment

  • ENVUPDATE = Update Environment

  • EMFVAL = Validate EMF Settings

  • OPTIONS = Set General Options

  • EXPCFG = Export configuration

  • IMPCFG = Import configuration

  • UPLDTGT = Upload Target Database

The action ENVIMP is used to import an environment that was previously exported.

Command line format:

changeassistant.bat -MODE UM -ACTION ENVIMP -FILEPATH <location of xml file> -FILE <xml file name> -REPLACE <Y or N>

Parameter

Description

-MODE

Change Assistant Action (Required)

UM = Update Manager

-ACTION

Action name (Required)

ENVIMP = Import Environment

-FILEPATH

Location of xml file to be uploaded. (Required)

Example: -FILEPATH C:\pt8.53

-FILE

Name of xml file to be uploaded. (Required)]

Example: -FILE PT903R1.xml

-REPLACE

Replace existing data if it exists (Optional)

  • Y = Replace existing values if they exist. (default)

  • N = Do not replace values if they exist.

The action ENVCREATE is used to create an environment using the command line.

Command line format:

changeassistant.bat -MODE UM -ACTION ENVCREATE -TGTENV <target database> -OUT <log path> -REPLACE <Y or N> -EXONERR <Y or N> -CT <database type> -CS <database server name> -OID <owner ID> -UNI <unicode> -CA <access id> -CAP <access id password> -CO <user id> -CP <user password> -CI <connect id> -CW <connect id password> -CZYN <Y or N> -CZ <DB owner> -CZP <DB owner password> -SQH <path to SQL Query tool> -INP <products> -PL <product line> -IND <industry> -INL <languages> -PSH <path to PS Home> -PAH <path to PS App Home> -PCH <path to PS Cust Home> -NPYN <Y or N> -NPSH <path to new PS Home> -NPAH <path to new PS App Home> -NPCH <path to new PS Cust Home>

The parameters for ENVCREATE action are:

Parameter

Description

-MODE

Change Assistant Action (Required)

UM = Update Manager

-ACTION

Action name (Required)

ENVCREATE = Create Environment

-TGTENV

Name of target database. (Required)

-OUT

Path of log file (Optional)

If the log directory is not specified it uses the default defined under General Options.

-REPLACE

Replace existing data if it exists (Optional)

  • Y = Replace existing values if they exist. (default)

  • N = Do not replace values if they exist.

-EXONERR

Specify whether or not to launch GUI if an error or manual stop is encountered. (Optional)

  • Y = Do not Launch

  • N= Launch (default)

-CT

Database Type (Required)

-CS

Database Server Name (Optional)

-OID

Owner ID (Optional)

-UDI

Unicode (Required)

  • Y = Yes

  • N = No

-CO

User ID (Required)

-CP

User Password (Required)

-CA

Access ID (Required)

-CAP

Access Password (Required)

-CI

Connect ID (Required)

-CW

Connect Password (Required)

-CZYN

Set DB Owner Credentials (Optional)

  • Y = Yes

  • N = No (default)

-CZ

DBOwner ID (Required if –CZYN is Y)

-CZP

DBOwner Password (Required if –CZYN is Y)

-SQH

SQL Query Tool (Required)

-INP

Installed Products (Required)

Specify either all , a single or multiple products.

For example:

  • -INP all

  • -INP FMA

  • -INP FMA.REA,SMA

-PL

Product Line (Required)

-IND

Industry (Required)

Specify either all , or a specific industry.

For example:

  • -IND all

  • -IND Commercial

-INL

Languages (Required)

Specify either all , or a specific languages.

For example:

  • -INL all

  • -INL ENG,FRA

-PSH

PS Home (Required)

-PAH

PS App Home (Required)

-PCH

PS Cust Home (Required)

-NPYN

Enable new PS Home (Optional)

  • Y = Yes

  • N = No (default)

-NPSH

New PS Home (Required if –NPSH is Y)

-NPAH

New PS App Home (Required if –NPSH is Y)

-NPCH

New PS Cust Home (Required if –NPSH is Y)

The action ENVUPDATE is used to set options using the command line.

The command line for updating the environment uses the same parameters as creating an environment (ENVCREATE), except -REPLACE is not included.

The action OPTIONS is used to set options using the command line.

Command line options are available for the General Options, EM Hub Options, and PUM Source Options. Additional options are not supported via command line.

Command line format:

changeassistant.bat -MODE UM -ACTION OPTIONS -OUT <path to output log> -REPLACE <Y or N> -EXONERR <Y or N> -SWP <True or False> -MCP <maximum concurrect processes> -PSH <path to PS Home> -STG <staging directory> -OD <output directory> -DL <download directory> -SQH <path to SQL Query tool> -EMYN <Y or N) -EMH <server host name> -EMP <server host port> -EMC <chunck size> -EMPING <ping interval> -EMDRV <drives to crawl> -SRCYN <Y or N> -SRCENV <PUMsource database name> -PUH <PUM PS Home> -PIA <PUM PIA URL>

The parameters for OPTIONS action are:

Parameter

Description

-MODE

Change Assistant Action (Required)

UM = Update Manager

-ACTION

Action name (Required)

OPTIONS = Set General Options

-OUT

Path of log file (Optional)

If the log directory is not specified it uses the default defined under General Options.

-REPLACE

Replace existing data if it exists (Optional)

  • Y = Replace existing values if they exist. (default)

  • N = Do not replace values if they exist.

-EXONERR

Specify whether or not to launch GUI if an error or manual stop is encountered. (Optional)

  • Y = Do not Launch

  • N= Launch (default)

-SWP

Show Welcome Menu (Optional)

  • True = Show welcome page

  • False = Do not show welcome page

-MCP

Maximum Concurrent Processes (Optional)

-PCH

PS Home (Optional)

-PAF

PS App Home (Optional)

-PCH

PS Cust Home (Optional)

-STG

Staging Directory (Optional)

-OD

Output Directory (Optional)

-DL

Download Directory (Optional)

-PUH

PeopleSoft Update Directory (Optional)

-SQH

SQL Query Tools (Optional)

-EMYN

Configure EM Hub for file deploy (Optional)

  • Y = Yes

  • N = No (default)

-EMH

Server Host Name (Required if –EMYN is Y)

-EMP

Server Host Port (Required if –EMYN is Y)

-EMC

Chunk Size (Required if –EMYN is Y)

-EMPING

Ping Interval (Required if –EMYN is Y)

-EMDRV

Drives to Crawl (Required if –EMYN is Y)

-SRCYN

Configure PUM Source (Optional)

  • Y = Yes

  • N = No (default)

-SRCENV

PUM Source Database Name (Required if –SRCYN is Y)

-PUH

PUM PS HomDirectory (Required if –SRCYN is Y)

-PIA

PUM Source PIA URL (Required if –SRCYN is Y)

The action EMFVAL is used to validate EMF using the command line.

Note: In Linux/UNIX, the user running validating EMF settings should have write permission to PS_APP_HOME.

Command line format:

changeassistant.bat -MODE UM -ACTION EMFVAL -OUT <path to log file>  -EXONERR <Y or N>

The parameters for EMFVAL action are:

Parameter

Description

-MODE

Change Assistant Action (Required)

UM = Update Manager

-ACTION

Action name (Required)

EMFVAL = Validate environment

-OUT

Path to log file. (Optional)

-EXONERR

Specify whether or not to launch GUI if an error or manual stop is encountered. (Optional)

  • Y = Do not Launch

  • N= Launch (default)

The action UPLDTGTis used to a target database using the command line.

Command line format:

changeassistant.bat -MODE UM -ACTION UPLDTGT -OUT <path to log file>  -EXONERR <Y or N>

The parameters for UPLDTGT action are:

Parameter

Description

-MODE

Change Assistant Action (Required)

UM = Update Manager

-ACTION

Action name (Required)

UPLDTGT = Upload target database

-TGTENV

Target database (Required)

-OUT

Path to log file. (Optional)

-EXONERR

Specify whether or not to launch GUI if an error or manual stop is encountered. (Optional)

  • Y = Do not Launch

  • N= Launch (default)