Command Line for Applying Downloaded PRP to PeopleSoft Update Image

The action PRPAPPLY is used to apply a previously downloaded PRP to the PeopleSoft Update Image.

In order to apply a PRP from the command line, you must run 2 commands, first identify the PUM source using the Options action and then apply the PRP.

  1. This is an example of the command line to set the PUM environment.

    Changeassistant.bat -MODE UM -ACTION OPTIONS -SRCYN Y -SRCENV HR92U016 -PUH D:\psft\pt\pi_home\ -PIA http://machine.example.com:8000/ps/signon.html -OUT d:\temp\PRP.LOG -EXONERR Y

    In this example, Configure PUM Source (SRCYN) is set to Y, the PUM Source database (-SRCENV) is HR92U016 , the PI home directory (-PUH) is set to D:\psft\pt\pi_home\, the PIA URL (-PIA) is set to http://edddr32p1.example.com:8000/ps/signon.html.

    See the section on Command Line for Setting Options for additional details on setting General Options.

  2. This is an example for applying the PRP.

    changeassistant.bat  -MODE UM -ACTION PRPAPPLY -UPD PRJ22534037 

    In this example the change package to apply is PRJ22534037 (name of the downloaded PRP change package). All of the other parameters will use the default.

    Command line format:

    Changeassistant.bat -MODE UM -ACTION PRPAPPLY  –UPD <change package> -OUT <log file directory> -WARNINGSOK <Y or N> -REPLACE <Y or N> -EXONERR <launch GUI Y or N> -RESETJOB <Y or N>

    or

    Changeassistant.bat -MODE UM -ACTION PRPAPPLY -INI <path to ini file>
  3. You can re-apply PRPs using the REPLACE parameter.

    If the REPLACE parameter is set to N, then from the given list of PRPs, the PRPs that you applied previously will not be reapplied. Only the PRPs that are not yet applied will be applied in the current run.

    This is an example of re-applying PRPs when the REPLACE parameter is N:

    Changeassistant.bat  -MODE UM -ACTION PRPAPPLY  -UPD PRJ34526338_I45;PRJ34513463_I45;PRJ34526732_I45;PRJ34513987_I45  -EXONERR Y -REPLACE N

    In this example, you want to re-apply the change packages PRJ34526338_I45;PRJ34513463_I45;PRJ34526732_I45;PRJ34513987_I45.

    The command line log displays:

    REPLACE parameter is not set. Already applied PRPs will not be re-applied.

    If the REPLACE parameter is set to Y, then Change Assistant needs to apply all the PRPs from the given list.

    This is an example of re-applying PRPs when REPLACE parameter is Y:

    Changeassistant.bat  -MODE UM -ACTION PRPAPPLY  -UPD PRJ34526338_I45;PRJ34513463_I45;PRJ34526732_I45;PRJ34513987_I45
     -EXONERR Y -REPLACE Y

    The command line log displays:

    REPLACE parameter is set. Applied PRPs will be re-applied on PUM source.
Parameter Description

-MODE

Change Assistant mode (Required)

UM = Update Manager

-ACTION

Action name (Required)

PRPAPPLY = Apply PRP

-UPD

Update ID of Change Package to apply. (Required)

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

-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)

-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

-INI

Path to ini file.

See Using a Configuration File with Changeassistant.bat