Staging v1.11.0 (#1726)

* Fixed zos_copy

* Fixed encode test case

* update version and remove author

Signed-off-by: ddimatos <[email protected]>

* Python is EOS 9-30, updated meta

Signed-off-by: ddimatos <[email protected]>

* Update README with new links and cleanup

Signed-off-by: ddimatos <[email protected]>

* Update GA dates

Signed-off-by: ddimatos <[email protected]>

* Update module docs with auto generations

Signed-off-by: ddimatos <[email protected]>

* Add changelog summary

Signed-off-by: ddimatos <[email protected]>

* Changelog updates

Signed-off-by: ddimatos <[email protected]>

* remove stale changelog files

Signed-off-by: ddimatos <[email protected]>

* update galaxy exclusions

Signed-off-by: ddimatos <[email protected]>

* update release notes for 1.11.0

Signed-off-by: ddimatos <[email protected]>

* Remove unused imports from action plugin

Signed-off-by: ddimatos <[email protected]>

* Corrections for flake8

Signed-off-by: ddimatos <[email protected]>

* Updated example to not escape the paren

Signed-off-by: ddimatos <[email protected]>

* Update module doc to correct use of monospace

Signed-off-by: ddimatos <[email protected]>

* Corretions to release notes

Signed-off-by: ddimatos <[email protected]>

* Corrections

Signed-off-by: ddimatos <[email protected]>

---------

Signed-off-by: ddimatos <[email protected]>
Co-authored-by: Fernando Flores <[email protected]>

Author: ddimatos

CHANGELOG.rst

@@ -4,13 +4,13 @@ ibm.ibm\_zos\_core Release Notes
 
 .. contents:: Topics
 
-v1.11.0-beta.1
-==============
+v1.11.0
+=======
 
 Release Summary
 ---------------
 
-Release Date: '2024-08-05'
+Release Date: '2024-10-01'
 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
@@ -32,11 +32,11 @@ Minor Changes
 - zos_job_submit - add support for generation data groups and generation data sets as sources for jobs. (https://github.com/ansible-collections/ibm_zos_core/pull/1497)
 - zos_lineinfile - Added support for GDG and GDS relative name notation to use a data set. And backup in new generations. Added support for data set names with special characters like $, /#, /- and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1516).
 - zos_mount - Added support for data set names with special characters ($, /#, /- and @). This is for both src and backup data set names. (https://github.com/ansible-collections/ibm_zos_core/pull/1631).
-- zos_tso_command - Added support for GDG and GDS relative name notation to use a data set name. Added support for data set names with special characters like $, /#, /- and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1563).
 - zos_mvs_raw - Added support for GDG and GDS relative name notation to use a data set. Added support for data set names with special characters like $, /#, /- and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1525).
 - zos_mvs_raw - Added support for GDG and GDS relative positive name notation to use a data set. (https://github.com/ansible-collections/ibm_zos_core/pull/1541).
 - zos_mvs_raw - Redesign the wrappers of dd clases to use properly the arguments. (https://github.com/ansible-collections/ibm_zos_core/pull/1470).
 - zos_script - Improved the copy to remote mechanic to avoid using deepcopy that could result in failure for some systems. (https://github.com/ansible-collections/ibm_zos_core/pull/1561).
+- zos_tso_command - Added support for GDG and GDS relative name notation to use a data set name. Added support for data set names with special characters like $, /#, /- and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1563).
 - zos_unarchive - Added support for data set names with special characters like $, /#, /- and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1511).
 - zos_unarchive - Improved the copy to remote mechanic to avoid using deepcopy that could result in failure for some systems. (https://github.com/ansible-collections/ibm_zos_core/pull/1561).
 

README.md

@@ -6,7 +6,6 @@ The **IBM z/OS core** collection enables Ansible to interact with z/OS Data Sets
 
 The **IBM z/OS core** collection is part of the **Red Hat® Ansible Certified Content for IBM Z®** offering that brings Ansible automation to IBM Z®. This collection brings forward the possibility to manage batch jobs, perform program authorizations, run operator operations, and execute both JES and MVS commands as well as execute shell, python, and REXX scripts. It supports data set creation, searching, copying, fetching, and encoding. It provides both archiving and unarchiving of data sets, initializing volumes, performing backups and supports Jinja templating.
 
-
 <br/>System programmers can enable pipelines to setup, tear down and deploy applications while system administrators can automate time consuming repetitive tasks inevitably freeing up their time. New z/OS users can find comfort in Ansible's familiarity and expedite their proficiency in record time.
 
 ## Requirements
@@ -64,7 +63,7 @@ after an update.
 ```sh
 PYZ: "path_to_python_installation_on_zos_target"
 ZOAU: "path_to_zoau_installation_on_zos_target"
-ZOAU_PYTHONPATH: "path_to_zoau_wheel_installation_directory"
+ZOAU_PYTHON_LIBRARY_PATH: "path_to_zoau_wheel_installation_directory"
 
 ansible_python_interpreter: "{{ PYZ }}/bin/python3"
 
@@ -135,12 +134,10 @@ All releases will meet the following test criteria.
 
 * ansible-core v2.15.x
 * Python 3.11.x
-* IBM Open Enterprise SDK for Python 3.11.x
+* IBM Open Enterprise SDK for Python 3.12.x
 * IBM Z Open Automation Utilities (ZOAU) 1.3.1.x
 * z/OS V2R5
 
-This release introduces case sensitivity for option values and includes a porting guide in the [release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html) to assist with which option values will need to be updated.
-
 ## Contributing
 
 This community is not currently accepting contributions. However, we encourage you to open [git issues](https://github.com/ansible-collections/ibm_zos_core/issues) for bugs, comments or feature requests and check back periodically for when community contributions will be accepted in the near future.
@@ -154,7 +151,7 @@ If you would like to communicate with this community, you can do so through the
 * GitHub [discussions](https://github.com/ansible-collections/ibm_zos_core/discussions).
 * GitHub [issues](https://github.com/ansible-collections/ibm_zos_core/issues/new/choose).
 * [Ansible Forum](https://forum.ansible.com/), please use the `zos` tag to ensure proper awareness.
-* Discord [System Z Enthusiasts](https://discord.gg/Kmy5QaUGbB) room [ansible](https://discord.gg/nHrDdRTC).
+* Discord [System Z Enthusiasts](https://discord.gg/sze) room `ansible`.
 * Matrix general usage questions [room](https://matrix.to/#/#users:ansible.com).
 
 ## Support
@@ -178,8 +175,8 @@ For Galaxy and GitHub users, to see the supported ansible-core versions, review
 | Version  | Status         | Release notes | Changelogs |
 |----------|----------------|---------------|------------|
 | 1.12.x   | In development | unreleased    | unreleased |
-| 1.11.x   | In preview     | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-11-0-beta.1) | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.11.0-beta.1/CHANGELOG.rst) |
-| 1.10.x   | Current        | [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.11.x   | Current        | [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.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.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)  |

changelogs/.plugin-cache.yaml

@@ -135,4 +135,4 @@ plugins:
   strategy: {}
   test: {}
   vars: {}
-version: 1.11.0-beta.1
+version: 1.11.0

changelogs/changelog.yaml

@@ -259,6 +259,20 @@ releases:
     - 992-fix-sanity4to6.yml
     - v1.10.0-beta.1_summary.yml
     release_date: '2024-05-08'
+  1.11.0:
+    changes:
+      release_summary: 'Release Date: ''2024-10-01''
+
+        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:
+    - v1.11.0_summary.yml
+    release_date: '2024-09-25'
   1.11.0-beta.1:
     changes:
       bugfixes:
@@ -283,9 +297,9 @@ releases:
       - zos_archive - Added support for GDG and GDS relative name notation to archive
         data sets. Added support for data set names with special characters like $,
         /#, /- and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1511).
-      - zos_backup_restore - Added support for GDS relative name notation to include or
-        exclude data sets when operation is backup. Added support for data set names
-        with special characters like $, /#, and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1527).
+      - zos_backup_restore - Added support for GDS relative name notation to include
+        or exclude data sets when operation is backup. Added support for data set
+        names with special characters like $, /#, and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1527).
       - zos_blockinfile - Added support for GDG and GDS relative name notation to
         use a data set. And backup in new generations. Added support for data set
         names with special characters like $, /#, /- and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1516).
@@ -315,11 +329,11 @@ releases:
         to use a data set. (https://github.com/ansible-collections/ibm_zos_core/pull/1541).
       - zos_mvs_raw - Redesign the wrappers of dd clases to use properly the arguments.
         (https://github.com/ansible-collections/ibm_zos_core/pull/1470).
-      - zos_tso_command - Added support for GDG and GDS relative name notation to use
-        a data set name. Added support for data set names with special characters
-        like $, /#, /- and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1563).
       - zos_script - Improved the copy to remote mechanic to avoid using deepcopy
         that could result in failure for some systems. (https://github.com/ansible-collections/ibm_zos_core/pull/1561).
+      - zos_tso_command - Added support for GDG and GDS relative name notation to
+        use a data set name. Added support for data set names with special characters
+        like $, /#, /- and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1563).
       - zos_unarchive - Added support for data set names with special characters like
         $, /#, /- and @. (https://github.com/ansible-collections/ibm_zos_core/pull/1511).
       - zos_unarchive - Improved the copy to remote mechanic to avoid using deepcopy

changelogs/fragments/v1.11.0-beta.1_summary.yml

@@ -397,7 +397,7 @@ Examples
        format:
          name: terse
          format_options:
-           use_adrdssu: True
+           use_adrdssu: true
 
    - name: Archive multiple data sets into a new GDS
      zos_archive:
@@ -406,7 +406,7 @@ Examples
        format:
          name: terse
          format_options:
-           use_adrdssu: True
+           use_adrdssu: true
 
 
 

docs/source/modules/zos_archive.rst

@@ -33,7 +33,7 @@ src
 
   The USS file must be an absolute pathname.
 
-  Generation data set (GDS) relative name of generation already created.  ``e.g. SOME.CREATION(-1``.)
+  Generation data set (GDS) relative name of generation already created. e.g. *SOME.CREATION(-1*).
 
   | **required**: True
   | **type**: str
@@ -295,7 +295,7 @@ Examples
      zos_blockinfile:
        src: SOME.CREATION.TEST
        insertbefore: BOF
-       backup: True
+       backup: true
        backup_name: CREATION.GDS(+1)
        block: "{{ CONTENT }}"
 

docs/source/modules/zos_blockinfile.rst

@@ -279,6 +279,7 @@ Examples
 
 
 
+
 Notes
 -----
 

docs/source/modules/zos_encode.rst

@@ -253,7 +253,6 @@ Examples
 
 
 
-
 Notes
 -----
 

docs/source/modules/zos_find.rst

@@ -33,7 +33,7 @@ src
 
   The USS file must be an absolute pathname.
 
-  Generation data set (GDS) relative name of generation already created. ``e.g. SOME.CREATION(-1.)``
+  Generation data set (GDS) relative name of generation already created. e.g. *SOME.CREATION(-1*).
 
   | **required**: True
   | **type**: str
@@ -262,7 +262,7 @@ Examples
      zos_lineinfile:
        src: SOME.CREATION.TEST
        insertafter: EOF
-       backup: True
+       backup: true
        backup_name: CREATION.GDS(+1)
        line: 'Should be a working test now'