Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions CHANGELOG.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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).

Expand Down
13 changes: 5 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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"

Expand Down Expand Up @@ -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.
Expand All @@ -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
Expand All @@ -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) |
Expand Down
2 changes: 1 addition & 1 deletion changelogs/.plugin-cache.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -135,4 +135,4 @@ plugins:
strategy: {}
test: {}
vars: {}
version: 1.11.0-beta.1
version: 1.11.0
26 changes: 20 additions & 6 deletions changelogs/changelog.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -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).
Expand Down Expand Up @@ -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
Expand Down
6 changes: 0 additions & 6 deletions changelogs/fragments/v1.11.0-beta.1_summary.yml

This file was deleted.

4 changes: 2 additions & 2 deletions docs/source/modules/zos_archive.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -406,7 +406,7 @@ Examples
format:
name: terse
format_options:
use_adrdssu: True
use_adrdssu: true



Expand Down
4 changes: 2 additions & 2 deletions docs/source/modules/zos_blockinfile.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -295,7 +295,7 @@ Examples
zos_blockinfile:
src: SOME.CREATION.TEST
insertbefore: BOF
backup: True
backup: true
backup_name: CREATION.GDS(+1)
block: "{{ CONTENT }}"

Expand Down
1 change: 1 addition & 0 deletions docs/source/modules/zos_encode.rst
Original file line number Diff line number Diff line change
Expand Up @@ -279,6 +279,7 @@ Examples




Notes
-----

Expand Down
1 change: 0 additions & 1 deletion docs/source/modules/zos_find.rst
Original file line number Diff line number Diff line change
Expand Up @@ -253,7 +253,6 @@ Examples




Notes
-----

Expand Down
4 changes: 2 additions & 2 deletions docs/source/modules/zos_lineinfile.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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'

Expand Down
6 changes: 3 additions & 3 deletions docs/source/modules/zos_unarchive.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.

Expand All @@ -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.

Expand Down
Loading