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>
or
changeassistant.bat -MODE UM -ACTION ENVIMP -INI <path to ini file>
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)
|
-INI |
Path to ini file. |
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> -CKYN <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> -INBL <BASE LANGUAGE> -PSH <path to PS Home> -PAH <path to PS App Home> -PCH <path to PS Cust Home> -SQRF <SQR flags> -NPYN <Y or N> -NPSH <path to new PS Home> -NPAH <path to new PS App Home> -NPCH <path to new PS Cust Home> -NSQRF <new SQR Flags>
or
changeassistant.bat -MODE UM -ACTION ENVCREATE -INI <path to ini file>
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)
|
-EXONERR |
Specify whether or not to launch GUI if an error or manual stop is encountered. (Optional)
|
-CKYN |
Validate database connection and retrieve information from database (Optional) Y = Validate (by default) N = Do not validate |
-CT |
Database Type (Required) Database type is a number: 1 – DB2 zOS 2 – Oracle 3 – Informix 4 – DB2 LUW 6 – Sybase 7 – Microsoft SQL Server |
-CS |
Database Server Name (Optional) |
-OID |
Owner ID (Optional) |
-UDI |
Unicode (Required)
|
-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)
|
-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:
|
-PL |
Product Line (Optional) |
-IND |
Industry (Required) Specify either all , or a specific industry. For example:
|
-INL |
Languages (Required) Specify either all , or a specific languages. For example:
|
-INBL |
Base language (Required) |
-PSH |
PS Home (Required) |
-PAH |
PS App Home (Required) |
-PCH |
PS Cust Home (Required) |
-SQRF |
SQR Flags (Optional) |
-NPYN |
Enable new PS Home (Optional)
|
-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) |
-NSQRF |
New SQR Flags (Optional) |
-INI |
Path to ini file. |
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>
or
changeassistant.bat -MODE UM -ACTION OPTIONS -INI <path to ini file>
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)
|
-EXONERR |
Specify whether or not to launch GUI if an error or manual stop is encountered. (Optional)
|
-SWP |
Show Welcome Menu (Optional)
|
-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)
|
-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)
|
-SRCENV |
PUM Source Database Name (Required if –SRCYN is Y) |
-PUH |
PUM PS Home Directory (Required if –SRCYN is Y) |
-PIA |
PUM Source PIA URL (Required if –SRCYN is Y) |
-INI |
Path to ini file. |
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>
or
changeassistant.bat -MODE UM -ACTION EMFVAL -INI <path to ini file>
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)
|
-INI |
Path to INI file. |
The action UPLDTGT is 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>
or
changeassistant.bat -MODE UM -ACTION UPLDTGT -INI <path to ini file>
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)
|
-INI |
Path to ini file. |