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]>
ansible-collections · Sep 27, 2024 · 901fe6b · 901fe6b
1 parent 58cda22
commit 901fe6b
Show file tree

Hide file tree

Showing 23 changed files with 158 additions and 270 deletions.
diff --git a/CHANGELOG.rst b/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).
 

diff --git a/README.md b/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)  |

diff --git a/changelogs/.plugin-cache.yaml b/changelogs/.plugin-cache.yaml
@@ -135,4 +135,4 @@ plugins:
   strategy: {}
   test: {}
   vars: {}
-version: 1.11.0-beta.1
+version: 1.11.0
diff --git a/changelogs/changelog.yaml b/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

diff --git a/changelogs/fragments/v1.11.0-beta.1_summary.yml b/changelogs/fragments/v1.11.0-beta.1_summary.yml
diff --git a/docs/source/modules/zos_archive.rst b/docs/source/modules/zos_archive.rst
@@ -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
 
 
 

diff --git a/docs/source/modules/zos_blockinfile.rst b/docs/source/modules/zos_blockinfile.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 }}"
 

diff --git a/docs/source/modules/zos_encode.rst b/docs/source/modules/zos_encode.rst
@@ -279,6 +279,7 @@ Examples
 
 
 
+
 Notes
 -----
 

diff --git a/docs/source/modules/zos_find.rst b/docs/source/modules/zos_find.rst
@@ -253,7 +253,6 @@ Examples
 
 
 
-
 Notes
 -----
 

diff --git a/docs/source/modules/zos_lineinfile.rst b/docs/source/modules/zos_lineinfile.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'
 

diff --git a/docs/source/modules/zos_unarchive.rst b/docs/source/modules/zos_unarchive.rst
@@ -39,7 +39,7 @@ src
 
   MVS data sets supported types are ``SEQ``, ``PDS``, ``PDSE``.
 
-  GDS relative names are supported ``e.g. USER.GDG(-1)``.
+  GDS relative names are supported. e.g. *USER.GDG(-1*).
 
   | **required**: True
   | **type**: str
@@ -151,7 +151,7 @@ owner
 include
   A list of directories, files or data set names to extract from the archive.
 
-  GDS relative names are supported ``e.g. USER.GDG(-1)``.
+  GDS relative names are supported. e.g. *USER.GDG(-1*).
 
   When ``include`` is set, only those files will we be extracted leaving the remaining files in the archive.
 
@@ -165,7 +165,7 @@ include
 exclude
   List the directory and file or data set names that you would like to exclude from the unarchive action.
 
-  GDS relative names are supported ``e.g. USER.GDG(-1)``.
+  GDS relative names are supported. e.g. *USER.GDG(-1*).
 
   Mutually exclusive with include.