Command Line for Applying PUM Updates

The action CPAPPLY is used to apply a change package that was created using PUM.

Command line format:

Changeassistant.bat -MODE UM -ACTION CPAPPLY -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 CPAPPLY -INI <path to ini file>

Example command line:

Changeassistant.bat -MODE UM -ACTION CPAPPLY  -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)

CPAPPLY = Apply Previously Created (non-PRP) Change Package

-TGTENV

Target database

-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 COMPLETED MANUALLY 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.

  • WARNINGSREVIEWED

    To retrieve and review the job which stopped with warnings, and then set to status COMPLETED MANUALLY.

    This is similar to COMPLETECONTINUE resume option.

-INI

Path to ini file.

See Using a Configuration File with Changeassistant.bat