ansible-collections
diff --git a/‎.ansible.lint‎
Lines changed: 50 additions & 0 deletions b/‎.ansible.lint‎
Lines changed: 50 additions & 0 deletions
diff --git a/‎CHANGELOG.rst‎
Lines changed: 47 additions & 4 deletions b/‎CHANGELOG.rst‎
Lines changed: 47 additions & 4 deletions
diff --git a/‎README.md‎
Lines changed: 76 additions & 17 deletions b/‎README.md‎
Lines changed: 76 additions & 17 deletions
diff --git a/‎changelogs/changelog.yaml‎
Lines changed: 11 additions & 3 deletions b/‎changelogs/changelog.yaml‎
Lines changed: 11 additions & 3 deletions
diff --git a/‎docs/source/life-cycle.rst‎
Lines changed: 32 additions & 0 deletions b/‎docs/source/life-cycle.rst‎
Lines changed: 32 additions & 0 deletions
@@ -0,0 +1,50 @@
+################################################################################
+# Copyright (c) IBM Corporation 2024, 2025
+################################################################################
+# For additonal doc, see https://ansible.readthedocs.io/projects/lint/configuring/
+exclude_paths:
+  - .tar.gz
+  - __pycache__/
+  - .ansible-lint
+  - .cache/
+  - .DS_Store
+  - .git/
+  - .github/
+  - .gitignore
+  - .python-version
+  - .pytest_cache/
+  - .vscode/
+  - Jenkinsfile
+  - ac
+  - ansible.cfg
+  - changelogs/
+  - collections/
+  - docs/
+  - importer_result.json
+  - scripts/
+  - test_config.yml
+  - tests/*.ini
+  - tests/*.py
+  - tests/.pytest_cache
+  - tests/__pycache__
+  - tests/functional
+  - tests/helpers
+  - tests/requirements.txt
+  - tests/unit
+  - tests/sanity/ignore-2.9.txt
+  - tests/sanity/ignore-2.10.txt
+  - tests/sanity/ignore-2.11.txt
+  - tests/sanity/ignore-2.12.txt
+  - tests/sanity/ignore-2.13.txt
+  - tests/sanity/ignore-2.14.txt
+  - venv*
+  - ansible_collections/
+  - tests/ims-collection-sample.yaml
+  - ./*.log
+parseable: true
+quiet: false
+use_default_rules: true
+verbosity: 1
+# Offline mode disables installation of requirements.yml and schema refreshing often
+# found in project_root/collections/requirements.yml.
+offline: true
@@ -4,6 +4,49 @@ ibm.ibm_zos_ims Release Notes
 
 .. contents:: Topics
 
+v1.3.1
+======
+
+Release Summary
+---------------
+
+Release Date: '2023-03-31'
+This changelog describes all changes made to the modules and plugins included in this collection.
+For additional details such as required dependencies and availability review
+the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_ims/docs/source/release_notes.html>`__
+
+Major Changes
+-------------
+ - Compatibility to the latest dependencies versions
+
+   - Support for z/OS core v1.10 or later.
+   - Support for Python v3.11 or later.
+   - Support for ZOAU v1.3.0 or later.
+   - Support for Ansible 2.15 or later.
+
+v1.3.0
+======
+
+Release Summary
+---------------
+
+Release Date: '2023-03-31'
+This changelog describes all changes made to the modules and plugins included in this collection.
+For additional details such as required dependencies and availability review
+the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_ims/docs/source/release_notes.html>`__
+
+
+Major Changes
+-------------
+- Added new module 'ims_ddl'
+- Added new member dfsdf_member in the ims_catalog_populate and ims_catalog_purge modules.
+- The DFSDFxxx member is in the IMS.PROCLIB data set where the CATALOG section is defined.
+- Documentation update, minor updates to compression parameter in the ims_acbgen module where PRECOMP,POSTCOMP, in any combination, cause the required in-place compression.
+- The choices are not mutually exclusive -- PRECOMP or POSTCOMP or PRECOMP,POSTCOMP can be used.
+- Improved test and ansible-sanity coverage.
+- Subset of the test cases were updated to support for Ansible 2.15.
+- Additional support for test cases in ims_catalog_populate and ims_catalog_purge modules to support dfsdf_member parameter.
+- This update also has updated prerequisites for Ansible 2.14 or newer and ZOAU 1.2.2 or newer but prior to version 1.3.
 
 v1.2.0
 ======
@@ -12,10 +55,9 @@ Release Summary
 ---------------
 
 Release Date: '2023-03-31'
-This changelog describes all changes made to the modules and plugins included
-in this collection.
+This changelog describes all changes made to the modules and plugins included in this collection.
 For additional details such as required dependencies and availability review
-the collections `release notes <https://github.com/ansible-collections/ibm_zos_ims/blob/dev/docs/source/release_notes.rst>`__ 
+the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_ims/docs/source/release_notes.html>`__
 
 
 Major Changes
@@ -27,6 +69,7 @@ Major Changes
 - Fixed sanity test error for ims_dbdgen and ims_psbgen modules after the member_list argument type was updated to 'raw' from 'list' since the element type can either be str or key:value pair
 - Improved JSON keys for ims_command_utils to replace whitespaces with underscores to help make the output more parsable
 
+.. _Release notes for v1.2.0
 v1.1.0
 ======
 
@@ -64,4 +107,4 @@ New Modules
 - ibm.ibm_zos_ims.ims_acb_gen - Generate IMS ACB
 - ibm.ibm_zos_ims.ims_command - Submit IMS Commands
 - ibm.ibm_zos_ims.ims_dbd_gen - Generate IMS DBD
-- ibm.ibm_zos_ims.ims_psb_gen - Generate IMS PSB
+- ibm.ibm_zos_ims.ims_psb_gen - Generate IMS PSB
@@ -10,14 +10,14 @@ System programmers can automate IMS system management tasks while database admin
 
 ## Requirements
 
-This collection has been tested against the following Ansible versions: >=2.14.0,<2.17.3.
+This collection is tested against the following Ansible versions: 2.15.0 or later
 
 The collection requires the following on the managed node:
 - IBM z/OS IMS
 - IBM Open Enterprise SDK for Python
 - IBM Z Open Automation Utilities (ZOAU)
 
-The control node requires the IBM z/OS core collection to be installed before installing the IMS collection. Please refer to the [IBM z/OS collections support matrix](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/resources/releases_maintenance.html#support-matrix) for specific version requirements.
+The control node requires the IBM z/OS core collection to be installed before installing the IMS collection. Refer to the [IBM z/OS Core collection requirements](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/collection-requirements.html) for specific version requirements.
 
 ## Installation
 
@@ -29,7 +29,7 @@ ansible-galaxy collection install ibm.ibm_zos_ims
 
 You can also include it in a requirements.yml file and install it with `ansible-galaxy collection install -r requirements.yml`, using the format:
 
-```yaml
+```sh
 collections:
   - name: ibm.ibm_zos_ims
 ```
@@ -40,10 +40,50 @@ Note that if you install the collection from Ansible Galaxy, it will not be upgr
 ansible-galaxy collection install ibm.ibm_zos_ims --upgrade
 ```
 
-You can also install a specific version of the collection, for example, if you need to downgrade when something is broken in the latest version (please report an issue in this repository). Use the following syntax to install version 1.2.0:
+You can also install a specific version of the collection, for example, if you need to install a different version. Use the following syntax to install version 1.0.0:
+
+```sh
+ansible-galaxy collection install ibm.ibm_zos_ims:1.1.0
+```
+
+You can also install a beta version of the collection. A beta version is only available on Galaxy and is only supported by the community until it is promoted to General Availability (GA). Use the following syntax to install a beta version:
+
+```sh
+ansible-galaxy collection install ibm.ibm_zos_ims:1.1.0-beta.1
+```
+
+<br/>As part of the installation, the collection [requirements](#Requirements) must be made available to Ansible through the use of environment variables. The preferred configuration is to place the environment variables in `group_vars` and `host_vars`, you can find examples of this configuration under any [playbook project](https://github.com/IBM/z_ansible_collections_samples).
+
+<br/>If you are testing a configuration, it can be helpful to set the environment variables in a playbook, for an example to review, refer [Discussions](https://github.com/ansible-collections/ibm_zos_core/discussions/657).
+
+<br/>To learn more about the ZOAU Python wheel installation method, review the [documentation](https://www.ibm.com/docs/en/zoau/1.3.x?topic=installing-zoau#python-wheel-installation-method).
+
+<br/>If the wheel is installed using the `--target` option, it will install the package into the specified target directory. The environment variable `PYTHONPATH` will have to be configured to where the packages is installed, e.g; `PYTHONPATH: /usr/zoau/wheels`. Using `--target` is recommended, else the wheel will be installed in Python's home directory which may not have write permissions or persist
+after an update.
+
+<br/>If the wheel is installed using the `--user` option, it will install the package into the user directory. The environment variable `PYTHONPATH` will have to be configured to where the packages is installed, e.g; `PYTHONPATH: /u/user`.
+
+<br/>Environment variables:
 
 ```sh
-ansible-galaxy collection install ibm.ibm_zos_ims:1.2.0
+PYZ: "path_to_python_installation_on_zos_target"
+ZOAU: "path_to_zoau_installation_on_zos_target"
+ZOAU_PYTHON_LIBRARY_PATH: "path_to_zoau_wheel_installation_directory"
+
+ansible_python_interpreter: "{{ PYZ }}/bin/python3"
+
+environment_vars:
+  _BPXK_AUTOCVT: "ON"
+  ZOAU_HOME: "{{ ZOAU }}"
+  PYTHONPATH: "{{ ZOAU_PYTHONPATH }}"
+  LIBPATH: "{{ ZOAU }}/lib:{{ PYZ }}/lib:/lib:/usr/lib:."
+  PATH: "{{ ZOAU }}/bin:{{ PYZ }}/bin:/bin:/var/bin"
+  _CEE_RUNOPTS: "FILETAG(AUTOCVT,AUTOTAG) POSIX(ON)"
+  _TAG_REDIR_ERR: "txt"
+  _TAG_REDIR_IN: "txt"
+  _TAG_REDIR_OUT: "txt"
+  LANG: "C"
+  PYTHONSTDINENCODING: "cp1047"
 ```
 
 ## Use Cases
@@ -100,36 +140,55 @@ ansible-galaxy collection install ibm.ibm_zos_ims:1.2.0
 
 ## Testing
 
+All releases will meet the following test criteria.
+
+* 100% success for [Functional](https://github.com/ansible-collections/ibm_zos_ims/tree/dev/tests/functional) tests.
+* 100% success for [Unit](https://github.com/ansible-collections/ibm_zos_ims/tree/dev/tests/units) tests.
+* 100% success for [Sanity](https://docs.ansible.com/ansible/latest/dev_guide/testing/sanity/index.html#all-sanity-tests) tests as part of [ansible-test](https://docs.ansible.com/ansible/latest/dev_guide/testing.html#run-sanity-tests).
+* 100% success for [ansible-lint](https://ansible.readthedocs.io/projects/lint/) allowing only false.
+
 This release of the collection was tested with the following dependencies.
 
-- ansible-core v2.17.x
+- ansible-core v2.15.x
 - Python 3.13.x
 - IBM Open Enterprise SDK for Python 3.11.x
-- IBM Z Open Automation Utilities (ZOAU) 1.2.x
-- z/OS V2R5
+- IBM Z Open Automation Utilities (ZOAU) 1.3.x
+- z/OS V2R5 or later
 
 ## Contributing
 
-We are not currently accepting community contributions. However, we encourage you to open git issues for bugs, comments or feature requests.
+This community is not currently accepting contributions. However, we encourage you to open git issues for bugs, comments or feature requests.
 
 Review this content periodically to learn when and how to make contributions in the future. For the latest information on open issues, see: [git issues](https://github.com/ansible-collections/ibm_zos_ims/issues).
 
+## Communication
+
+If you would like to communicate with this community, you can do so through the following options.
+
+* GitHub [discussions](https://github.com/ansible-collections/ibm_zos_ims/discussions).
+* GitHub [issues](https://github.com/ansible-collections/ibm_zos_ims/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/sze) room `ansible`.
+* Matrix general usage questions [room](https://matrix.to/#/#users:ansible.com).
+
 ## Support
 
-As Red Hat Ansible Certified Content, this collection is entitled to support through Ansible Automation Platform (AAP). After creating a Red Hat support case, if it is determined the issue belongs to IBM, Red Hat will instruct you to create an IBM support case and share the case number with Red Hat so that a collaboration can begin between Red Hat and IBM.
+As Red Hat Ansible [Certified Content](https://catalog.redhat.com/software/search?target_platforms=Red%20Hat%20Ansible%20Automation%20Platform), this collection is entitled to [support](https://access.redhat.com/support/) through [Ansible Automation Platform](https://www.redhat.com/en/technologies/management/ansible) (AAP). After creating a Red Hat support case, if it is determined the issue belongs to IBM, Red Hat will instruct you to create an [IBM support case](https://www.ibm.com/mysupport/s/createrecord/NewCase) and share the case number with Red Hat so that a collaboration can begin between Red Hat and IBM.
+
+<br/>If a support case cannot be opened with Red Hat and the collection has been obtained either from [Galaxy](https://galaxy.ansible.com/ui/) or [GitHub](https://github.com/ansible-collections/ibm_zos_core), there is community support available at no charge. Community support is limited to the collection; community support does not include any of the Ansible Automation Platform components, [IBM Z Open Automation Utilities](https://www.ibm.com/docs/en/zoau), [IBM Open Enterprise SDK for Python](https://www.ibm.com/products/open-enterprise-python-zos) or [ansible-ims](https://github.com/ansible/ansible).
+
+<br/>The current supported versions of this collection can be found listed under the [release section](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_ims/docs/source/release_notes.html).
 
 ## Release Notes and Roadmap
 
-Release notes and changelogs are maintained in the [documentation](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_ims/docs/source/release_notes.html).
+For the collection's cumulative, refer [release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_ims/docs/source/release_notes.html) are an easy way to review changes. The collection [Life Cycle](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_ims/docs/source/life-cycle_ims.html) also referred to as the Roadmap contains changelog details, support dates and the current level of support
+for each collection. For a complete guide to support, review the **Ansible for IBM Z** [Collection Life Cycles](https://ibm.github.io/z_ansible_collections_doc/collections_content/collection-life-cycles.html#life-cycles).
 
 ## Related Information
 
-For guides and reference information, please visit:
-- [IBM z/OS collections documentation](https://ibm.github.io/z_ansible_collections_doc/index.html)
-- [Ansible sample playbooks using the z/OS IMS collection](https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_subsystems/ims)
+Example playbooks and use cases can be be found in the [Ansible sample playbooks using the z/OS IMS collection](https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_subsystems/ims). For supplemental content on getting started with Ansible, architecture and use cases, refer to [IBM z/OS collections documentation](https://ibm.github.io/z_ansible_collections_doc/index.html).
 
 ## License Information
 
-© Copyright IBM Corporation 2025
-
-This collection is licensed under [Apache License, Version 2.0](https://opensource.org/licenses/Apache-2.0).
+Some portions of this collection are licensed under [GNU General Public License, Version 3.0](https://opensource.org/licenses/GPL-3.0), and other portions of this collection are licensed under [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
+See individual files for applicable licenses.
@@ -101,7 +101,7 @@ releases:
         \n"
     fragments:
     - v1.3.0_summary.yml
-    release_date: '2024-04-10'     
+    release_date: '2024-04-10'
   1.3.0-beta.1:
     changes:
       major_changes:
@@ -120,5 +120,13 @@ releases:
     fragments:
     - v1.3.0-beta1_summary.yml
     release_date: '2023-12-15'
-  
-    
+  1.3.1:
+    changes:
+      release_summary: "Release Date: '2025-08-08'\nThis changelog describes all changes
+        made to the modules and plugins included\nin this collection.\nFor additional
+        details such as required dependencies and availability review\nthe collections
+        `release notes <https://github.com/ansible-collections/ibm_zos_ims/blob/dev/docs/source/release_notes.rst>`__
+        \n"
+    fragments:
+    - v1.3.1_summary.yml
+    release_date: '2023-08-08'
@@ -0,0 +1,32 @@
+.. ...........................................................................
+.. © Copyright IBM Corporation 2025                                          .
+.. File needs to be contributed by a collection, likely the ref's won't work
+.. since the source will be in another, so need to create an external link.
+.. ...........................................................................
+
+==========
+Life cycle
+==========
+
+The IBM z/OS® IMS (``ibm_zos_ims``) collection is developed and released on a flexible release cycle. Occasionally, the cycle may be extended to properly implement and test larger 
+changes before a new release is made available.
+
+Product life cycle
+==================
+
+Review this matrix for the status of the IBM z/OS IMS collection version,
+its critical dates, and which type of support it's currently eligible for.
+
++--------------+----------------+-----------------------+------------------+-------------------+-------------------------+
+| Version      | Status         | Changelogs            | GA Date          | EOL Date          | Life Cycle Phase        |
++==============+================+=======================+==================+===================+=========================+
+| 1.3.x        | Released       | `1.3.x changelogs`_   | 10 April 2024    | 10 April 2026     | `Full support`_         |
++--------------+----------------+-----------------------+------------------+-------------------+-------------------------+
+
+.. .............................................................................
+.. Global Links
+.. .............................................................................
+.. _1.3.x changelogs:
+    https://github.com/ansible-collections/ibm_zos_ims/blob/v1.3.1/CHANGELOG.rst
+.. _Full support:
+    ../../../collections_content/collection-life-cycles.html#life-cycle-phase