# Upgrading a macro

**URL:** <https://cms-helpdesk.ncas.ac.uk/t/upgrading-a-macro/1719>\
**Category:** Unified Model\
**Created:** [4 June 2025 12:43 UTC](https://cms-helpdesk.ncas.ac.uk/t/upgrading-a-macro/1719 "2025-06-04T12:43:53Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![hannahbryant](https://avatars.discourse-cdn.com/v4/letter/h/b5a626/32.png) [@hannahbryant](https://cms-helpdesk.ncas.ac.uk/u/hannahbryant)\
**Post date:** [4 June 2025 12:43 UTC](https://cms-helpdesk.ncas.ac.uk/t/upgrading-a-macro/1719/1 "2025-06-04T12:43:53Z")

</div>

Hi!  
I am adding a run\_ukca namelist to a branch at the moment, and have been following the instructions here: [UKCA Chemistry and Aerosol vn10.9 Tutorial 11 - UKCA](https://www.ukca.ac.uk/wiki/index.php/UKCA_Chemistry_and_Aerosol_vn10.9_Tutorial_11)  
I have added the changes to the version.py script to set up the upgrade\_macro as it suggests but I am slightly confused by how to actually put this into my job (or if I need to do the upgrade even as this is just for my jobs?)

I have merged jobs into other branches which have changes to this module and in those simply the fcm commit after the merge command have added them to my GUI interface, but I am not quite sure how to proceed when adding one myself.

Thanks,  
Hannah

---

<div class="post-metadata">

**Author:** ![mdalvi](https://avatars.discourse-cdn.com/v4/letter/m/ad7895/32.png) [@mdalvi](https://cms-helpdesk.ncas.ac.uk/u/mdalvi)\
**Post date:** [4 June 2025 13:30 UTC](https://cms-helpdesk.ncas.ac.uk/t/upgrading-a-macro/1719/2 "2025-06-04T13:30:13Z")

</div>

Hi Hannah,

The upgrade\_macro is useful when upgrading a suite between UM versions, but only if the change is lodged onto the trunk.  
To add/ modify any namelist parameters in your current job, edit the _app/um/rose-app.conf_ and change

> meta=um-atmos/vnXX to  
> meta=/path/to/working\_copy/rose-meta/um-atmos/HEAD

Then open the app in ‘rose edit’ and you will be prompted to add the new items.  
Note that if your suite already contains a branch for the ‘meta=’ setting all the rose-meta.conf changes need to be merged into a single working copy.

–  
Mohit

---

<div class="post-metadata">

**Author:** ![hannahbryant](https://avatars.discourse-cdn.com/v4/letter/h/b5a626/32.png) [@hannahbryant](https://cms-helpdesk.ncas.ac.uk/u/hannahbryant)\
**Post date:** [4 June 2025 14:25 UTC](https://cms-helpdesk.ncas.ac.uk/t/upgrading-a-macro/1719/3 "2025-06-04T14:25:36Z")

</div>

Hi Mohit,

Thanks! Would you recommend leaving the version.py file as it was before or include the changes suggested in the tutorial? (without doing the upgrade itself)

Best,  
Hannah

---

<div class="post-metadata">

**Author:** ![mdalvi](https://avatars.discourse-cdn.com/v4/letter/m/ad7895/32.png) [@mdalvi](https://cms-helpdesk.ncas.ac.uk/u/mdalvi)\
**Post date:** [4 June 2025 16:04 UTC](https://cms-helpdesk.ncas.ac.uk/t/upgrading-a-macro/1719/4 "2025-06-04T16:04:30Z")

</div>

Adding a macro will make it easier to commit the changes to UM/UKCA in the future.

Mohit

---

<div class="post-metadata">

**Author:** ![system](https://europe1.discourse-cdn.com/flex013/uploads/cms_support/original/1X/1fd2411499ffcbc299fe756cd5cdf26e44956558.png) [@system](https://cms-helpdesk.ncas.ac.uk/u/system)\
**Post date:** [4 July 2025 16:04 UTC](https://cms-helpdesk.ncas.ac.uk/t/upgrading-a-macro/1719/5 "2025-07-04T16:04:59Z")

</div>

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.