You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CHANGELOG.rst
+47-4Lines changed: 47 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,49 @@ ibm.ibm_zos_ims Release Notes
4
4
5
5
.. contents:: Topics
6
6
7
+
v1.3.1
8
+
======
9
+
10
+
Release Summary
11
+
---------------
12
+
13
+
Release Date: '2023-03-31'
14
+
This changelog describes all changes made to the modules and plugins included in this collection.
15
+
For additional details such as required dependencies and availability review
16
+
the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_ims/docs/source/release_notes.html>`__
17
+
18
+
Major Changes
19
+
-------------
20
+
- Compatibility to the latest dependencies versions
21
+
22
+
- Support for z/OS core v1.10 or later.
23
+
- Support for Python v3.11 or later.
24
+
- Support for ZOAU v1.3.0 or later.
25
+
- Support for Ansible 2.15 or later.
26
+
27
+
v1.3.0
28
+
======
29
+
30
+
Release Summary
31
+
---------------
32
+
33
+
Release Date: '2023-03-31'
34
+
This changelog describes all changes made to the modules and plugins included in this collection.
35
+
For additional details such as required dependencies and availability review
36
+
the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_ims/docs/source/release_notes.html>`__
37
+
38
+
39
+
Major Changes
40
+
-------------
41
+
- Added new module 'ims_ddl'
42
+
- Added new member dfsdf_member in the ims_catalog_populate and ims_catalog_purge modules.
43
+
- The DFSDFxxx member is in the IMS.PROCLIB data set where the CATALOG section is defined.
44
+
- Documentation update, minor updates to compression parameter in the ims_acbgen module where PRECOMP,POSTCOMP, in any combination, cause the required in-place compression.
45
+
- The choices are not mutually exclusive -- PRECOMP or POSTCOMP or PRECOMP,POSTCOMP can be used.
46
+
- Improved test and ansible-sanity coverage.
47
+
- Subset of the test cases were updated to support for Ansible 2.15.
48
+
- Additional support for test cases in ims_catalog_populate and ims_catalog_purge modules to support dfsdf_member parameter.
49
+
- 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.
7
50
8
51
v1.2.0
9
52
======
@@ -12,10 +55,9 @@ Release Summary
12
55
---------------
13
56
14
57
Release Date: '2023-03-31'
15
-
This changelog describes all changes made to the modules and plugins included
16
-
in this collection.
58
+
This changelog describes all changes made to the modules and plugins included in this collection.
17
59
For additional details such as required dependencies and availability review
18
-
the collections `release notes <https://github.com/ansible-collections/ibm_zos_ims/blob/dev/docs/source/release_notes.rst>`__
60
+
the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_ims/docs/source/release_notes.html>`__
19
61
20
62
21
63
Major Changes
@@ -27,6 +69,7 @@ Major Changes
27
69
- 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
28
70
- Improved JSON keys for ims_command_utils to replace whitespaces with underscores to help make the output more parsable
Copy file name to clipboardExpand all lines: README.md
+76-17Lines changed: 76 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,14 +10,14 @@ System programmers can automate IMS system management tasks while database admin
10
10
11
11
## Requirements
12
12
13
-
This collection has been tested against the following Ansible versions: >=2.14.0,<2.17.3.
13
+
This collection is tested against the following Ansible versions: 2.15.0 or later
14
14
15
15
The collection requires the following on the managed node:
16
16
- IBM z/OS IMS
17
17
- IBM Open Enterprise SDK for Python
18
18
- IBM Z Open Automation Utilities (ZOAU)
19
19
20
-
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.
20
+
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.
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:
43
+
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:
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:
<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).
56
+
57
+
<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).
58
+
59
+
<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).
60
+
61
+
<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
62
+
after an update.
63
+
64
+
<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`.
All releases will meet the following test criteria.
144
+
145
+
* 100% success for [Functional](https://github.com/ansible-collections/ibm_zos_ims/tree/dev/tests/functional) tests.
146
+
* 100% success for [Unit](https://github.com/ansible-collections/ibm_zos_ims/tree/dev/tests/units) tests.
147
+
* 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).
148
+
* 100% success for [ansible-lint](https://ansible.readthedocs.io/projects/lint/) allowing only false.
149
+
103
150
This release of the collection was tested with the following dependencies.
104
151
105
-
- ansible-core v2.17.x
152
+
- ansible-core v2.15.x
106
153
- Python 3.13.x
107
154
- IBM Open Enterprise SDK for Python 3.11.x
108
-
- IBM Z Open Automation Utilities (ZOAU) 1.2.x
109
-
- z/OS V2R5
155
+
- IBM Z Open Automation Utilities (ZOAU) 1.3.x
156
+
- z/OS V2R5 or later
110
157
111
158
## Contributing
112
159
113
-
We are not currently accepting community contributions. However, we encourage you to open git issues for bugs, comments or feature requests.
160
+
This community is not currently accepting contributions. However, we encourage you to open git issues for bugs, comments or feature requests.
114
161
115
162
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).
116
163
164
+
## Communication
165
+
166
+
If you would like to communicate with this community, you can do so through the following options.
*[Ansible Forum](https://forum.ansible.com/), please use the `zos` tag to ensure proper awareness.
171
+
* Discord [System Z Enthusiasts](https://discord.gg/sze) room `ansible`.
172
+
* Matrix general usage questions [room](https://matrix.to/#/#users:ansible.com).
173
+
117
174
## Support
118
175
119
-
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.
176
+
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.
177
+
178
+
<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).
179
+
180
+
<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).
120
181
121
182
## Release Notes and Roadmap
122
183
123
-
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).
184
+
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
185
+
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).
124
186
125
187
## Related Information
126
188
127
-
For guides and reference information, please visit:
-[Ansible sample playbooks using the z/OS IMS collection](https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_subsystems/ims)
189
+
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).
This collection is licensed under [Apache License, Version 2.0](https://opensource.org/licenses/Apache-2.0).
193
+
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).
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
12
+
changes before a new release is made available.
13
+
14
+
Product life cycle
15
+
==================
16
+
17
+
Review this matrix for the status of the IBM z/OS IMS collection version,
18
+
its critical dates, and which type of support it's currently eligible for.
0 commit comments