Cherry pick v1.15.0-beta.1 into staging-v1.16.0-beta.1 (#2225)

* Release tasks v1.14.0 GA (#2189)

* [v1.14.0] Avoid failures when default dir ~/.ansible/tmp/ is not previously created and fix failures when using become in zos_job_submit (#2109)

* Updated plugins in zos_copy

* Updated action zos_job_submit

* Updated tests

* Updated permissions

* Added fix for content

* Added changelogs

* Updated zos_job_submit action plugin

* Fixed sanity issue

* Updated zos_copy

* Started release process

* Updated lifecylce

* Updated meta

* Updated zos_mount docs

* Updated docs

* Updated data set utils

* Updated release notes

* Updaded lifecycle

* [Release] Merge release tasks for v1.14.1 to main (#2200)

* [1.14.1][zos_copy] Fix permission denied when transferring file to managed node with non-root user (#2198)

* Updated issue template

* Added fix for wrong permissions set in zos_copy

* Removed comment

* Fixed sanity isseu

* Added changelogs

* Added changelog and release notes

* Updated release notes

* Modified release notes

* Merged release tasks into staging (#2219)

* updated galaxy.yml with versioning

* updating versions and dates.

* version summary block

* changelog work

* ac document run

* release notes updated.

* cleaned up antsibull run, verified new version is in changelog

* correction to release notes

* Fixed release notes

* removed all the changelog fragments

---------

Co-authored-by: Rich Parker <[email protected]>

Updated release notes

* Updated release notes

---------

Co-authored-by: André Marcel Gutiérrez Benítez <[email protected]>

Author: fernandofloresg

.github/ISSUE_TEMPLATE/bug_issue.yml

@@ -33,6 +33,7 @@ body:
       description: Which version of z/OS Ansible core collection are you using. If you are unsure, review the [documentation](https://ibm.github.io/z_ansible_collections_doc/faqs/faqs.html#how-do-i-update-a-collection-to-the-latest-version).
       multiple: false
       options:
+        - v1.15.0-beta.1
         - v1.14.1
         - v1.14.0
         - v1.14.0-beta.1

.github/ISSUE_TEMPLATE/collaboration_issue.yml

@@ -42,6 +42,7 @@ body:
       description: Which version of z/OS Ansible core collection are you using. If you are unsure, review the [documentation](https://ibm.github.io/z_ansible_collections_doc/faqs/faqs.html#how-do-i-update-a-collection-to-the-latest-version).
       multiple: false
       options:
+        - v1.15.0-beta.1
         - v1.14.1
         - v1.14.0
         - v1.14.0-beta.1

.github/ISSUE_TEMPLATE/doc_issue.yml

@@ -34,6 +34,7 @@ body:
       description: Which version of z/OS Ansible core collection are you using. If you are unsure, review the [documentation](https://ibm.github.io/z_ansible_collections_doc/faqs/faqs.html#how-do-i-update-a-collection-to-the-latest-version).
       multiple: false
       options:
+        - v1.15.0-beta.1
         - v1.14.1
         - v1.14.0
         - v1.14.0-beta.1

CHANGELOG.rst

@@ -4,12 +4,56 @@ ibm.ibm\_zos\_core Release Notes
 
 .. contents:: Topics
 
-v1.14.1
-=======
+v1.15.0-beta.1
+==============
 
 Release Summary
 ---------------
 
+Release Date: '2025-07-30'
+This changelog describes all changes made to the modules and plugins included
+in this collection. The release date is the date the changelog is created.
+For additional details such as required dependencies and availability review
+the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`
+
+Minor Changes
+-------------
+
+- zos_archive - Adds support for encoding before archiving files. (https://github.com/ansible-collections/ibm_zos_core/pull/2081)
+- zos_archive - Adds support for reverting the encoding of a source's files after archiving them. (https://github.com/ansible-collections/ibm_zos_core/pull/2192)
+- zos_archive - Adds support for skipping encoding in archive module. This allows users to skip encoding for certain files before archiving them. (https://github.com/ansible-collections/ibm_zos_core/pull/2116)
+- zos_copy - Added support for british pound character usage in file content and data set names for both source and destination when copying. (https://github.com/ansible-collections/ibm_zos_core/pull/2153)
+- zos_copy - Adds new option `identical_gdg_copy` in the module. This allows copying GDG generations from a source base to a destination base while preserving generation data set absolute names when the destination base does not exist prior to the copy. (https://github.com/ansible-collections/ibm_zos_core/pull/2100).
+- zos_copy - Adds support of using alias names in src and dest parameters for PS, PDS and PDSE data sets. (https://github.com/ansible-collections/ibm_zos_core/pull/2103)
+- zos_fetch - Updated the documentation to correctly state what the default behavior of the module is. (https://github.com/ansible-collections/ibm_zos_core/pull/2047).
+- zos_find - Adds functionality to find migrated data sets. - Adds functionality to find different types of data sets at the same time. (https://github.com/ansible-collections/ibm_zos_core/pull/2073).
+- zos_job_output - Adds new fields cpu_time, origin_node and execution_node to response. (https://github.com/ansible-collections/ibm_zos_core/pull/2056).
+- zos_job_query - Adds new fields cpu_time, origin_node and execution_node to response. (https://github.com/ansible-collections/ibm_zos_core/pull/2056).
+- zos_job_submit - Adds new fields cpu_time, origin_node and execution_node to response. (https://github.com/ansible-collections/ibm_zos_core/pull/2056).
+- zos_mvs_raw  - Before this addition, you could not put anything in columns 1 or 2, were reserved for JCL processing. Change now allows add reserved_cols option and validate that the module get access to modify dd_content option base on the value, if not retain the previous behavior or work. (https://github.com/ansible-collections/ibm_zos_core/pull/2086)
+- zos_mvs_raw - Adds support for volume data definition. (https://github.com/ansible-collections/ibm_zos_core/pull/2194)
+- zos_stat - Added support to recall migrated data sets and return its attributes. (https://github.com/ansible-collections/ibm_zos_core/pull/2075)
+- zos_stat - Adds new fields that describe the type of the resource that was queried. These new fields are `isfile`, `isdataset`, `isaggregate` and `isgdg`. (https://github.com/ansible-collections/ibm_zos_core/pull/2137)
+- zos_stat - Adds support to query data sets using their aliases. (https://github.com/ansible-collections/ibm_zos_core/pull/2061)
+- zos_stat - Module now returns whether the resource queried exists on the managed node with the `exists` field inside `stat`. (https://github.com/ansible-collections/ibm_zos_core/pull/2137)
+- zos_unarchive - Added encoding support for the unarchive module. This allows users to encode the files after unarchiving them in a perticular encoding. (https://github.com/ansible-collections/ibm_zos_core/pull/2105)
+
+Bugfixes
+--------
+
+- zos_backup_restore - Return value `backup_name` was empty upon successful result. Fix now returns `backup_name` populated. (https://github.com/ansible-collections/ibm_zos_core/pull/2040).
+- zos_data_set - Attempting to create a data set with the same name on a different volume did not work, nor did it report a failure. The fix now informs the user that if the data set is cataloged on a different volume, it needs to be uncataloged before using the data set module to create a new data set on a different volume. (https://github.com/ansible-collections/ibm_zos_core/pull/2057).
+- zos_fetch - Previously, the use of `become` would result in a permissions error while trying to fetch a data set or a member. Fix now allows a user to escalate privileges when fetching resources. (https://github.com/ansible-collections/ibm_zos_core/pull/2079)
+- zos_lineinfile - Return values ``return_content`` and ``backup_name`` were not always being returned. Fix now ensure that these values are always present in the module's response. (https://github.com/ansible-collections/ibm_zos_core/pull/2120)
+- zos_lineinfile - The module would report a false negative when certain special characters where present in the `line` option. Fix now reports the successful operation. (https://github.com/ansible-collections/ibm_zos_core/pull/2080).
+- zos_mount - FSUMF168 return in stderror means that the mount dataset wouldn't resolve. While this shows a catalog or volume issue, it should not impact our search for an existing mount. Added handling to the df call, so that FSUMF168 are ignored. (https://github.com/ansible-collections/ibm_zos_core/pull/2060).
+
+New Modules
+-----------
+
+- ibm.ibm_zos_core.zos_replace - Replace all instances of a pattern within a file or data set.
+
+v1.14.1
 Release Date: '2025-07-03'
 This changelog describes all changes made to the modules and plugins included
 in this collection. The release date is the date the changelog is created.

README.md

@@ -136,7 +136,7 @@ All releases will meet the following test criteria.
 * Python 3.12.x
 * IBM Open Enterprise SDK for Python 3.12.x
 * IBM Z Open Automation Utilities (ZOAU) 1.3.4.x
-* z/OS V2R5
+* z/OS V2R5 or V3R1
 
 ## Contributing
 

changelogs/.plugin-cache.yaml

@@ -110,6 +110,11 @@ plugins:
       name: zos_ping
       namespace: ''
       version_added: 1.1.0
+    zos_replace:
+      description: Replace all instances of a pattern within a file or data set.
+      name: zos_replace
+      namespace: ''
+      version_added: 1.15.0
     zos_script:
       description: Run scripts in z/OS
       name: zos_script
@@ -146,4 +151,4 @@ plugins:
   strategy: {}
   test: {}
   vars: {}
-version: 1.14.1
+version: 1.15.0-beta.1

changelogs/changelog.yaml

@@ -855,6 +855,122 @@ releases:
     - 2196-fix-copy-permission-issues.yml
     - v1.14.1_summary.yml
     release_date: '2025-07-01'
+  1.15.0-beta.1:
+    changes:
+      bugfixes:
+      - zos_backup_restore - Return value `backup_name` was empty upon successful
+        result. Fix now returns `backup_name` populated. (https://github.com/ansible-collections/ibm_zos_core/pull/2040).
+      - zos_data_set - Attempting to create a data set with the same name on a different
+        volume did not work, nor did it report a failure. The fix now informs the
+        user that if the data set is cataloged on a different volume, it needs to
+        be uncataloged before using the data set module to create a new data set on
+        a different volume. (https://github.com/ansible-collections/ibm_zos_core/pull/2057).
+      - zos_fetch - Previously, the use of `become` would result in a permissions
+        error while trying to fetch a data set or a member. Fix now allows a user
+        to escalate privileges when fetching resources. (https://github.com/ansible-collections/ibm_zos_core/pull/2079)
+      - zos_lineinfile - Return values ``return_content`` and ``backup_name`` were
+        not always being returned. Fix now ensure that these values are always present
+        in the module's response. (https://github.com/ansible-collections/ibm_zos_core/pull/2120)
+      - zos_lineinfile - The module would report a false negative when certain special
+        characters where present in the `line` option. Fix now reports the successful
+        operation. (https://github.com/ansible-collections/ibm_zos_core/pull/2080).
+      - zos_mount - FSUMF168 return in stderror means that the mount dataset wouldn't
+        resolve. While this shows a catalog or volume issue, it should not impact
+        our search for an existing mount. Added handling to the df call, so that FSUMF168
+        are ignored. (https://github.com/ansible-collections/ibm_zos_core/pull/2060).
+      minor_changes:
+      - zos_archive - Adds support for encoding before archiving files. (https://github.com/ansible-collections/ibm_zos_core/pull/2081)
+      - zos_archive - Adds support for reverting the encoding of a source's files
+        after archiving them. (https://github.com/ansible-collections/ibm_zos_core/pull/2192)
+      - zos_archive - Adds support for skipping encoding in archive module. This allows
+        users to skip encoding for certain files before archiving them. (https://github.com/ansible-collections/ibm_zos_core/pull/2116)
+      - zos_copy - Added support for british pound character usage in file content
+        and data set names for both source and destination when copying. (https://github.com/ansible-collections/ibm_zos_core/pull/2153)
+      - zos_copy - Adds new option `identical_gdg_copy` in the module. This allows
+        copying GDG generations from a source base to a destination base while preserving
+        generation data set absolute names when the destination base does not exist
+        prior to the copy. (https://github.com/ansible-collections/ibm_zos_core/pull/2100).
+      - zos_copy - Adds support of using alias names in src and dest parameters for
+        PS, PDS and PDSE data sets. (https://github.com/ansible-collections/ibm_zos_core/pull/2103)
+      - zos_fetch - Updated the documentation to correctly state what the default
+        behavior of the module is. (https://github.com/ansible-collections/ibm_zos_core/pull/2047).
+      - zos_find - Adds functionality to find migrated data sets. - Adds functionality
+        to find different types of data sets at the same time. (https://github.com/ansible-collections/ibm_zos_core/pull/2073).
+      - zos_job_output - Adds new fields cpu_time, origin_node and execution_node
+        to response. (https://github.com/ansible-collections/ibm_zos_core/pull/2056).
+      - zos_job_query - Adds new fields cpu_time, origin_node and execution_node to
+        response. (https://github.com/ansible-collections/ibm_zos_core/pull/2056).
+      - zos_job_submit - Adds new fields cpu_time, origin_node and execution_node
+        to response. (https://github.com/ansible-collections/ibm_zos_core/pull/2056).
+      - zos_mvs_raw  - Before this addition, you could not put anything in columns
+        1 or 2, were reserved for JCL processing. Change now allows add reserved_cols
+        option and validate that the module get access to modify dd_content option
+        base on the value, if not retain the previous behavior or work. (https://github.com/ansible-collections/ibm_zos_core/pull/2086)
+      - zos_mvs_raw - Adds support for volume data definition. (https://github.com/ansible-collections/ibm_zos_core/pull/2194)
+      - zos_stat - Added support to recall migrated data sets and return its attributes.
+        (https://github.com/ansible-collections/ibm_zos_core/pull/2075)
+      - zos_stat - Adds new fields that describe the type of the resource that was
+        queried. These new fields are `isfile`, `isdataset`, `isaggregate` and `isgdg`.
+        (https://github.com/ansible-collections/ibm_zos_core/pull/2137)
+      - zos_stat - Adds support to query data sets using their aliases. (https://github.com/ansible-collections/ibm_zos_core/pull/2061)
+      - zos_stat - Module now returns whether the resource queried exists on the managed
+        node with the `exists` field inside `stat`. (https://github.com/ansible-collections/ibm_zos_core/pull/2137)
+      - zos_unarchive - Added encoding support for the unarchive module. This allows
+        users to encode the files after unarchiving them in a perticular encoding.
+        (https://github.com/ansible-collections/ibm_zos_core/pull/2105)
+      release_summary: 'Release Date: ''2025-07-30''
+
+        This changelog describes all changes made to the modules and plugins included
+
+        in this collection. The release date is the date the changelog is created.
+
+        For additional details such as required dependencies and availability review
+
+        the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`
+
+        '
+    fragments:
+    - 2030-Set_dynamic_volumes_for_volume_init.yml
+    - 2033-remove-dev-tools.yml
+    - 2039-documentation-zos_copy-opercmd.yml
+    - 2040-zos_backup_restore-fixed_return_backup_name.yml
+    - 2043-zos_mount-volume-size-resize.yml
+    - 2047-zos_fetch-update-docs.yml
+    - 2049-zos_backup_restore-added-return-values-in-doc.yml
+    - 2055-Zos_apf-shell-commands-to-api.yml
+    - 2056-zos_job-modules-adding-cpu_time-execution_node-origin_node.yml
+    - 2057-zos_data_set&data_set-Ensure-Dataset-Volume-Validation.yml
+    - 2058-Add_sanity_ignore_for_2_18.yml
+    - 2059-Github-sanity-2-18-fix.yml
+    - 2060-zos_mount-skip_fsumf168_from_df.yml
+    - 2061-alias-support-zos_stat.yml
+    - 2068-zos_data_set-Removed-Extra-Validation.yml
+    - 2073-zos_find-finding-migrated-datasets.yml
+    - 2075-migrated-data-sets-support-zos_stat.yml
+    - 2079-become-use-zos_fetch.yml
+    - 2080-zos_lineinfile-fixed-json-parsing.yml
+    - 2081-zos_archive-add-encoding-support.yml
+    - 2086_Programs_fails_when_need_access_to_the_first_and_second_columns.yml
+    - 2098-docs-migrated-data-sets-examples.yml
+    - 2100-zos_copy-Identical-gdg-copy-support.yml
+    - 2103-zos_copy-supporting-aliases-for-src-and-dest.yml
+    - 2105-zos_unarchive-encoding-support.yml
+    - 2111-update-zos_copy-block-size-docs.yml
+    - 2116-zos_archive-skip_encoding.yml
+    - 2120-zos_lineinfile-Added-return-content.yml
+    - 2135-Test_case_to_check_tmphlq_zos_backup_restore.yml
+    - 2136-zos_unarchive_skip_encoding_support.yml
+    - 2137-zos_stat-new-fields.yml
+    - 2138-Allow_run_dependency_finder_with_other_command.yml
+    - 2153-zos_copy-supporting-pound-in-dataset-name-and content.yml
+    - 2192-zos_archive-revert_src_encoding.yml
+    - 2194-zos_mvs_raw-Supporting-for-volume-definition-in-zos_mvs_raw.yml
+    - v1.15.0-beta.1_summary.yml
+    modules:
+    - description: Replace all instances of a pattern within a file or data set.
+      name: zos_replace
+      namespace: ''
+    release_date: '2025-08-05'
   1.2.1:
     changes:
       bugfixes: