Release v1.12.1 tasks into staging branch (#1955)

* Changed lint, readme, galaxy, and ibm_zos_core

Signed-off-by: Rich Parker <[email protected]>

* updated release notes and maintenance
corrected galacy
fixed date on zos_copy.py

* tweaking documents before a doc (re) build

* Rebuilt changelogs to include summary.

* Modified README

* Updated docs

* Updated release notes

* updated release notes

* Updated releases maintenance

* Updated

* updated build ignore

* Updated ansible lint

* Removed temp file

* Updated changelogs

* Removed summary changelog

---------

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

Author: fernandofloresg

CHANGELOG.rst

@@ -4,6 +4,25 @@ ibm.ibm\_zos\_core Release Notes
 
 .. contents:: Topics
 
+v1.12.1
+=======
+
+Release Summary
+---------------
+
+Release Date: '2025-02-24'
+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>`__
+
+Bugfixes
+--------
+
+- zos_copy - Previously, if the dataset name included special characters such as $, validation would fail when force_lock was false. This has been changed to allow the use of special characters when force_lock option is false. (https://github.com/ansible-collections/ibm_zos_core/pull/1907)
+- zos_copy - Previously, if the dataset name included special characters such as ``$`` and ``asa_text`` option is true, the module would fail. Fix now allows the use of special characters in the data set name when ``asa_text`` option is true. (https://github.com/ansible-collections/ibm_zos_core/pull/1904).
+- zos_copy - When ``asa_text`` was set to true at the same time as ``force_lock``, a copy would fail saying the destination was already in use. Fix now opens destination data sets up with disposition SHR when ``force_lock`` and ``asa_text`` are set to true. (https://github.com/ansible-collections/ibm_zos_core/pull/1932).
+
 v1.12.0
 =======
 

README.md

@@ -175,10 +175,10 @@ For Galaxy and GitHub users, to see the supported ansible-core versions, review
 | Version  | Status         | Release notes | Changelogs |
 |----------|----------------|---------------|------------|
 | 1.13.x   | In development | unreleased    | unreleased |
-| 1.12.x   | Current   | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-12-0)   | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.12.0/CHANGELOG.rst) |
-| 1.11.x   | Released       | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-11-0)   | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.11.0/CHANGELOG.rst) |
+| 1.12.x   | Current   | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-12-0)   | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.12.1/CHANGELOG.rst) |
+| 1.11.x   | Released       | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-11-1)   | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.11.1/CHANGELOG.rst) |
 | 1.10.x   | Released       | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-10-0)   | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.10.0/CHANGELOG.rst) |
-| 1.9.x    | Released       | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-9-2)    | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.9.2/CHANGELOG.rst)  |
+| 1.9.x    | Released       | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-9-4)    | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.9.4/CHANGELOG.rst)  |
 | 1.8.x    | Released       | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-8-0)    | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.8.0/CHANGELOG.rst)  |
 | 1.7.x    | Released       | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-7-0)    | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.7.0/CHANGELOG.rst)  |
 | 1.6.x    | Released       | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-6-0)    | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.6.0/CHANGELOG.rst)  |

changelogs/.plugin-cache.yaml

@@ -6,11 +6,6 @@ plugins:
   callback: {}
   cliconf: {}
   connection: {}
-  filter:
-    filter_wtor_messages:
-      description: Filter a list of WTOR messages
-      name: filter_wtor_messages
-      version_added: 1.2.0
   httpapi: {}
   inventory: {}
   lookup: {}
@@ -133,6 +128,5 @@ plugins:
   netconf: {}
   shell: {}
   strategy: {}
-  test: {}
   vars: {}
-version: 1.12.0-beta.1
+version: 1.12.1

changelogs/changelog.yaml

@@ -544,6 +544,35 @@ releases:
     - 828-adds-concurrent-executor.yml
     - v1.12.0-beta.1_summary.yml
     release_date: '2024-10-24'
+  1.12.1:
+    changes:
+      bugfixes:
+      - zos_copy - Previously, if the dataset name included special characters such
+        as $, validation would fail when force_lock was false. This has been changed
+        to allow the use of special characters when force_lock option is false. (https://github.com/ansible-collections/ibm_zos_core/pull/1907)
+      - zos_copy - Previously, if the dataset name included special characters such
+        as ``$`` and ``asa_text`` option is true, the module would fail. Fix now allows
+        the use of special characters in the data set name when ``asa_text`` option
+        is true. (https://github.com/ansible-collections/ibm_zos_core/pull/1904).
+      - zos_copy - When ``asa_text`` was set to true at the same time as ``force_lock``,
+        a copy would fail saying the destination was already in use. Fix now opens
+        destination data sets up with disposition SHR when ``force_lock`` and ``asa_text``
+        are set to true. (https://github.com/ansible-collections/ibm_zos_core/pull/1932).
+      release_summary: 'Release Date: ''2025-02-24''
+
+        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:
+    - 1904-zos_copy-asa-special-char.yml
+    - 1917-wrong_behaviour_force_lock_parameter.yml
+    - 1932-zos_copy-asa-dest-lock-support.yml
+    - v1.12.1_summary.yaml
+    release_date: '2025-02-25'
   1.2.1:
     changes:
       bugfixes:
@@ -613,20 +642,21 @@ releases:
       - zos_operator supports new options **wait** and **wait_time_s** such that you
         can specify that zos_operator wait the full **wait_time_s** or return as soon
         as the first operator command executes.
-      release_summary: "Release Date: '2021-19-04'\nThis changlelog describes all
-        changes made to the modules and plugins included\nin this collection.\nFor
-        additional details such as required dependencies and availablity review\nthe
-        collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__
-        \n\n`New Playbooks <https://github.com/IBM/z_ansible_collections_samples>`__\n
-        \ - Authorize and synchronize APF authorized libraries on z/OS from a configuration
-        file cloned from GitHub\n  - Automate program execution with copy, sort and
-        fetch data sets on z/OS playbook.\n  - Automate user management with add,
-        remove, grant permission, generate\n    passwords, create zFS, mount zFS and
-        send email notifications when deployed\n    to Ansible Tower or AWX with the
-        manage z/OS Users Using Ansible playbook.\n  - Use the configure Python and
-        ZOAU Installation playbook to scan the\n    **z/OS** target to find the latest
-        supported configuration and generate\n    inventory and a variables configuration.\n
-        \ - Automate software management with SMP/E Playbooks\n"
+      release_summary: "Release Date: '2021-19-04'\nThis changlelog describes all\
+        \ changes made to the modules and plugins included\nin this collection.\n\
+        For additional details such as required dependencies and availablity review\n\
+        the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__\
+        \ \n\n`New Playbooks <https://github.com/IBM/z_ansible_collections_samples>`__\n\
+        \  - Authorize and synchronize APF authorized libraries on z/OS from a configuration\
+        \ file cloned from GitHub\n  - Automate program execution with copy, sort\
+        \ and fetch data sets on z/OS playbook.\n  - Automate user management with\
+        \ add, remove, grant permission, generate\n    passwords, create zFS, mount\
+        \ zFS and send email notifications when deployed\n    to Ansible Tower or\
+        \ AWX with the manage z/OS Users Using Ansible playbook.\n  - Use the configure\
+        \ Python and ZOAU Installation playbook to scan the\n    **z/OS** target to\
+        \ find the latest supported configuration and generate\n    inventory and\
+        \ a variables configuration.\n  - Automate software management with SMP/E\
+        \ Playbooks\n"
     fragments:
     - v1.3.0_summary.yml
     - v1.3.0_summary_bugs.yml
@@ -663,11 +693,11 @@ releases:
         in conjunction with FlashCopy or Fast Replication. - zos_mvs_raw module execution
         fails when invoking DFSRRC00 with parm "UPB,PRECOMP", "UPB, POSTCOMP" or "UPB,PRECOMP,POSTCOMP".
         This issue is addressed by APAR PH28089.
-      release_summary: "Release Date: '2022-27-04'\nThis changlelog describes all
-        changes made to the modules and plugins included\nin this collection.\nFor
-        additional details such as required dependencies and availablity review\nthe
-        collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__
-        \n"
+      release_summary: "Release Date: '2022-27-04'\nThis changlelog describes all\
+        \ changes made to the modules and plugins included\nin this collection.\n\
+        For additional details such as required dependencies and availablity review\n\
+        the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__\
+        \ \n"
     fragments:
     - v1.3.1_summary.yml
     - v1.3.1_summary_bugs.yml
@@ -689,30 +719,30 @@ releases:
       - zos_job_query was updated to correct a boolean condition that always evaluated
         to "CANCELLED". - When querying jobs that are either **CANCELLED** or have
         **FAILED**, they were always treated as **CANCELLED**.
-      release_summary: "Release Date: '2022-26-04'\nThis changlelog describes all
-        changes made to the modules and plugins included\nin this collection.\nFor
-        additional details such as required dependencies and availablity review\nthe
-        collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__
-        \n"
+      release_summary: "Release Date: '2022-26-04'\nThis changlelog describes all\
+        \ changes made to the modules and plugins included\nin this collection.\n\
+        For additional details such as required dependencies and availablity review\n\
+        the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__\
+        \ \n"
     fragments:
     - v1.3.3_summary.yml
     - v1.3.3_summary_bugs.yml
     release_date: '2022-06-07'
   1.3.5:
     changes:
       bugfixes:
-      - "zos_ssh - connection plugin was updated to correct a bug in Ansible that\n
-        \ would result in playbook task retries overriding the SSH connection\n  retries.
-        This is resolved by renaming the zos_ssh option\n  retries to reconnection_retries.
-        The update addresses users of\n  ansible-core v2.9 which continues to use
-        retries and users of\n  ansible-core v2.11 or later which uses reconnection_retries.\n
-        \ This also resolves a bug in the connection that referenced a deprecated\n
-        \ constant. (https://github.com/ansible-collections/ibm_zos_core/pull/328)\n"
-      release_summary: "Release Date: '2022-03-06'\nThis changlelog describes all
-        changes made to the modules and plugins included\nin this collection.\nFor
-        additional details such as required dependencies and availablity review\nthe
-        collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__
-        \n"
+      - "zos_ssh - connection plugin was updated to correct a bug in Ansible that\n\
+        \  would result in playbook task retries overriding the SSH connection\n \
+        \ retries. This is resolved by renaming the zos_ssh option\n  retries to reconnection_retries.\
+        \ The update addresses users of\n  ansible-core v2.9 which continues to use\
+        \ retries and users of\n  ansible-core v2.11 or later which uses reconnection_retries.\n\
+        \  This also resolves a bug in the connection that referenced a deprecated\n\
+        \  constant. (https://github.com/ansible-collections/ibm_zos_core/pull/328)\n"
+      release_summary: "Release Date: '2022-03-06'\nThis changlelog describes all\
+        \ changes made to the modules and plugins included\nin this collection.\n\
+        For additional details such as required dependencies and availablity review\n\
+        the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__\
+        \ \n"
     fragments:
     - 328-rename-retries-to-reconnection_retries.yml
     - v1.3.4_summary.yml
@@ -746,12 +776,12 @@ releases:
       - zos_copy - was enhanced for when `src` is a directory and ends with "/", the
         contents of it will be copied into the root of `dest`. If it doesn't end with
         "/", the directory itself will be copied. (https://github.com/ansible-collections/ibm_zos_core/pull/515)
-      release_summary: "Release Date: '2022-10-07'\nThis changelog describes all changes
-        made to the modules and plugins included\nin this collection. The release
-        date is the date the changelog is created.\nFor additional details such as
-        required dependencies and availability review\nthe collections `release notes
-        <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__
-        \n"
+      release_summary: "Release Date: '2022-10-07'\nThis changelog describes all changes\
+        \ made to the modules and plugins included\nin this collection. The release\
+        \ date is the date the changelog is created.\nFor additional details such\
+        \ as required dependencies and availability review\nthe collections `release\
+        \ notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__\
+        \ \n"
     fragments:
     - 462-copy-fetch-submit-utils.yml
     - 513-zos_ssh-support-ansible-2.11.yml
@@ -768,12 +798,12 @@ releases:
         exist in the `dest` path. Prior to this change, if a parent directory anywhere
         in the path did not exist the task would fail as it was stated in documentation.
         (https://github.com/ansible-collections/ibm_zos_core/pull/561)
-      - "zos_copy - enhanced to support system symbols in PARMLIB. System symbols
-        are elements that allow different z/OS\xAE systems to share PARMLIB definitions
-        while retaining unique values in those definitions. This was fixed in a future
-        release through the use of one of the ZOAU dependency but this version of
-        `ibm_zos_core` does not support that dependency version so this support was
-        added. (https://github.com/ansible-collections/ibm_zos_core/pull/566)"
+      - "zos_copy - enhanced to support system symbols in PARMLIB. System symbols\
+        \ are elements that allow different z/OS\xAE systems to share PARMLIB definitions\
+        \ while retaining unique values in those definitions. This was fixed in a\
+        \ future release through the use of one of the ZOAU dependency but this version\
+        \ of `ibm_zos_core` does not support that dependency version so this support\
+        \ was added. (https://github.com/ansible-collections/ibm_zos_core/pull/566)"
       release_summary: 'Release Date: ''2022-12-07''
 
         This changelog describes all changes made to the modules and plugins included
@@ -796,13 +826,13 @@ releases:
       - zos_job_output was updated to correct possible truncated responses for the
         ddname content. This would occur for jobs with very large amounts of content
         from a ddname.
-      - "zos_ssh - connection plugin was updated to correct a bug in Ansible that\n
-        \ would result in playbook task retries overriding the SSH connection\n  retries.
-        This is resolved by renaming the zos_ssh option\n  retries to reconnection_retries.
-        The update addresses users of\n  ansible-core v2.9 which continues to use
-        retries and users of\n  ansible-core v2.11 or later which uses reconnection_retries.\n
-        \ This also resolves a bug in the connection that referenced a deprecated\n
-        \ constant. (https://github.com/ansible-collections/ibm_zos_core/pull/328)\n"
+      - "zos_ssh - connection plugin was updated to correct a bug in Ansible that\n\
+        \  would result in playbook task retries overriding the SSH connection\n \
+        \ retries. This is resolved by renaming the zos_ssh option\n  retries to reconnection_retries.\
+        \ The update addresses users of\n  ansible-core v2.9 which continues to use\
+        \ retries and users of\n  ansible-core v2.11 or later which uses reconnection_retries.\n\
+        \  This also resolves a bug in the connection that referenced a deprecated\n\
+        \  constant. (https://github.com/ansible-collections/ibm_zos_core/pull/328)\n"
       deprecated_features:
       - zos_copy and zos_fetch option sftp_port has been deprecated. To set the SFTP
         port, use the supported options in the ansible.builtin.ssh plugin. Refer to
@@ -840,11 +870,11 @@ releases:
         information in the event an error is encountered.
       - zos_ping was updated to remove the need for the zos_ssh connection plugin
         dependency.
-      release_summary: "Release Date: '2021-06-23'\nThis changlelog describes all
-        changes made to the modules and plugins included\nin this collection.\nFor
-        additional details such as required dependencies and availablity review\nthe
-        collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__
-        \n"
+      release_summary: "Release Date: '2021-06-23'\nThis changlelog describes all\
+        \ changes made to the modules and plugins included\nin this collection.\n\
+        For additional details such as required dependencies and availablity review\n\
+        the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__\
+        \ \n"
     fragments:
     - v1.4.0-beta.1_summary.yml
     - v1.4.0-beta.1_summary_bugs.yml