Command Line for Applying Required for Upgrade Package

The action RFUAPPLY is used to apply a Tools Delta change package that was created using PUM.

Command line format:

Changeassistant.bat -MODE UM -ACTION RFUAPPLY -TGTENV <target database> -UPD <change package> -TYPE <initial pass or move to production> -SYNCTYPE <y OR n> -OUT <log file directory> -WARNINGSOK <Yor N> -RESETJOB <Y or N> -EXONERR <launch GUI Y or N> -RESUMEJOB [COMPLETECONTINUE|RESTARTCONTINUE| READYTORUNCONTINUE]

or

Changeassistant.bat -MODE UM -ACTION RFUAPPLY -INI <path to ini file>

Example command line:

Changeassistant.bat -MODE UM -ACTION RFUAPPLY  -TGTENV HC920001 – UPD PKG1

In this example the target database is named HC920001and the change package to apply is PKG1. All of the other parameters will use the default.

Parameter Description

-MODE

Change Assistant mode (Required)

UM

-ACTION

Change Assistant action (Required)

RFUAPPLY = Apply Required for Upgrade Change Package

-TGTENV

Target database (Required)

Optional if TYPE is IPSRC

-UPD

The Change Package to apply. (Required)

Specify either all , a single or multiple Change Packages to apply to the specified environment.

For example:

  • -UPD all

  • -UPD PKG1

  • -UPD PKG1,PKG2

-TYPE

Apply Type. (Optional)

  • IP = Initial Pass (All steps) (default)

  • MTP = Move to production

  • IPSRC = Source only initial pass

  • IPTGT = Target only initial pass

-SYNCTYPE

Synchronize target metadata. (Optional)

  • Y = Yes (default if type is IP)

  • N = No (default if type is not IP)

-OUT

Path of log file (Optional)

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

-WARNINGSOK

Proceed with apply even if warnings are found. (Optional)

  • Y = Proceed with apply even if warnings are found. (default)

  • N = Stop apply when warnings are encountered.

-EXONERR

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

  • Y = Do not Launch

  • N= Launch (default)

-RESETJOB

Specify whether or not to reset the job if the job fails the first time it is run.

  • Y = Delete existing job and create a new job

  • N = Do NOT delete existing job and continue running the existing job. (default)

-RESUMEJOB

Specify the parameter value:

  • COMPLETECONTINUE

    To mark the first failed step or manual stop step to status COMPLETE and continue the job.

  • RESTARTCONTINUE

    To mark the first failed step or manual stop step to status RE-START and continue the job

  • READYTORUNCONTINUE

    To mark the first failed step or manual stop step to status READYTORUN and continue the job

-FS

Specify either the file servers or ini path.

File servers hostname#configPath (Optional)

  • -FS all (default)

  • -FS slc06ejv#c:\pt8.53-102-r1

  • -FS slc06ejv#c:\pt8.53-102-r1;slc08eyu#c:\pt8.53-103-r1

-INI

Path to ini file.

See Using a Configuration File with Changeassistant.bat