Skip to content

Commit 518cfad

Browse files
Merge branch 'dev' into bugfix/1776/zos_mvs_raw-stdout-replaced-by-stderr
2 parents ddd692b + 10a2128 commit 518cfad

32 files changed

+476
-82
lines changed

.github/ISSUE_TEMPLATE/bug_issue.yml

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
name: Report a bug
22
description: Request that a bug be reviewed. Complete all required fields.
33
title: "[Bug] Enter description"
4-
labels: ["Bug", "Needs Triage" ]
4+
labels: ["Bug", "Needs Triage"]
55
assignees:
66
- IBMAnsibleHelper
77
body:
@@ -36,16 +36,15 @@ body:
3636
- v1.12.0
3737
- v1.12.0-beta.1
3838
- v1.11.0
39-
- v1.11.0-beta.1
4039
- v1.10.0
41-
- v1.10.0-beta.1
40+
- v1.9.3
4241
- v1.9.2
43-
- v1.9.0 (default)
42+
- v1.9.0
4443
- v1.8.0
4544
- v1.7.0
4645
- v1.6.0
4746
- v1.5.0
48-
default: 6
47+
default: 3
4948
validations:
5049
required: true
5150
- type: dropdown
@@ -60,11 +59,11 @@ body:
6059
- v1.3.2
6160
- v1.3.1
6261
- v1.3.0
63-
- v1.2.5 (default)
62+
- v1.2.5
6463
- v1.2.4
6564
- v1.2.3
6665
- v1.2.2
67-
default: 5
66+
default: 3
6867
validations:
6968
required: true
7069
- type: dropdown
@@ -76,7 +75,7 @@ body:
7675
options:
7776
- v3.13.x
7877
- v3.12.x
79-
- v3.11.x (default)
78+
- v3.11.x
8079
- v3.10.x
8180
default: 2
8281
validations:
@@ -89,10 +88,10 @@ body:
8988
multiple: false
9089
options:
9190
- v2.17.x
92-
- v2.16.x (default)
91+
- v2.16.x
9392
- v2.15.x
9493
- v2.14.x
95-
default: 1
94+
default: 3
9695
validations:
9796
required: true
9897
- type: dropdown
@@ -102,8 +101,8 @@ body:
102101
description: What is the version of z/OS on the managed node? Please review the supported dependencies in the release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html).
103102
multiple: false
104103
options:
105-
- v3.1 (unsupported)
106-
- v2.5 (default)
104+
- v3.1
105+
- v2.5
107106
- v2.4
108107
default: 1
109108
validations:

CHANGELOG.rst

Lines changed: 48 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,53 @@ ibm.ibm\_zos\_core Release Notes
44

55
.. contents:: Topics
66

7+
v1.12.0-beta.1
8+
==============
9+
10+
Release Summary
11+
---------------
12+
13+
Release Date: '2024-10-31'
14+
This changelog describes all changes made to the modules and plugins included
15+
in this collection. The release date is the date the changelog is created.
16+
For additional details such as required dependencies and availability review
17+
the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__
18+
19+
Minor Changes
20+
-------------
21+
22+
- zos_backup_restore - Redefines the default behavior of module option `hlq`. When option `operation` is set to `restore` and the `hlq` is not provided, the original high level qualifiers in a backup will be used for a restore. (https://github.com/ansible-collections/ibm_zos_core/pull/1632).
23+
- zos_job_output - Added address space type used by jobs in return JSON as `content_type`. (https://github.com/ansible-collections/ibm_zos_core/pull/1673).
24+
- zos_job_query - Added address space type used by jobs in return JSON as `content_type`. (https://github.com/ansible-collections/ibm_zos_core/pull/1673).
25+
- zos_job_submit - Added address space type used by jobs in return JSON as `content_type`. (https://github.com/ansible-collections/ibm_zos_core/pull/1673).
26+
- zos_mvs_raw - Un-mappable chars in stdout/stderr streams are now replaced with the replacement character. (https://github.com/ansible-collections/ibm_zos_core/pull/1634).
27+
- zos_operator - Added new option ``case_sensitive`` to module, allowing users to control how case in a command is handled by it. (https://github.com/ansible-collections/ibm_zos_core/pull/1641)
28+
- zos_script - Un-mappable chars in stdout/stderr streams are now replaced with the replacement character. (https://github.com/ansible-collections/ibm_zos_core/pull/1634).
29+
- zos_tso_command - Un-mappable chars in stdout/stderr streams are now replaced with the replacement character. (https://github.com/ansible-collections/ibm_zos_core/pull/1634).
30+
31+
Bugfixes
32+
--------
33+
34+
- zos_apf - The ``tmp_hlq`` option was previously ignored and default values were used instead. Fix now honors the value set in the module option. (https://github.com/ansible-collections/ibm_zos_core/pull/1695).
35+
- zos_archive - The ``tmp_hlq`` option was previously ignored and default values were used instead. Fix now honors the value set in the module option. (https://github.com/ansible-collections/ibm_zos_core/pull/1695).
36+
- zos_backup_restore - When a recoverable error was encountered and ``recover=True``, the module would ignore the option and fail. Fix now does not fail when a recoverable error is raised when ``recover=True``. (https://github.com/ansible-collections/ibm_zos_core/pull/1643).
37+
- zos_blockinfile - Previously module was not able to delete a block when 'marker_begin' and 'marker_end' were set to the same value. Fix introduces a requirement for 'marker_begin' and 'marker_end' to have different values. (https://github.com/ansible-collections/ibm_zos_core/pull/1684).
38+
- zos_blockinfile - The ``tmp_hlq`` option was previously ignored and default values were used instead. Fix now honors the value set in the module option. (https://github.com/ansible-collections/ibm_zos_core/pull/1695).
39+
- zos_copy - Improve module zos_copy error handling when the user does not have universal access authority set to UACC(READ) for SAF Profile 'MVS.MCSOPER.ZOAU' and SAF Class OPERCMDS. The module now handles the exception and returns an informative message. (https://github.com/ansible-collections/ibm_zos_core/pull/1766).
40+
- zos_copy - Previously, the module ignored the value of ``remote_tmp`` set in Ansible configuration file and used the ``/tmp/`` directory. Fix now uses the value of ``remote_tmp`` or the default value ``~/.ansible/tmp`` if none is given. (https://github.com/ansible-collections/ibm_zos_core/pull/1739).
41+
- zos_copy - The ``tmp_hlq`` option was previously ignored and default values were used instead. Fix now honors the value set in the module option. (https://github.com/ansible-collections/ibm_zos_core/pull/1695).
42+
- zos_data_set - The ``tmp_hlq`` option was previously ignored and default values were used instead. Fix now honors the value set in the module option. (https://github.com/ansible-collections/ibm_zos_core/pull/1695).
43+
- zos_encode - The ``tmp_hlq`` option was previously ignored and default values were used instead. Fix now honors the value set in the module option. (https://github.com/ansible-collections/ibm_zos_core/pull/1695).
44+
- zos_fetch - The ``tmp_hlq`` option was previously ignored and default values were used instead. Fix now honors the value set in the module option. (https://github.com/ansible-collections/ibm_zos_core/pull/1695).
45+
- zos_job_output - RACF user names containing a ``@``, ``$``, or ``#`` raised an invalid argument error. Fix now allows the use of all valid characters for a RACF user. (https://github.com/ansible-collections/ibm_zos_core/pull/1661).
46+
- zos_job_query - Module was not returning values for system and subsystem. Fix now returns these values. (https://github.com/ansible-collections/ibm_zos_core/pull/1761).
47+
- zos_job_query - RACF user names containing a ``@``, ``$``, or ``#`` raised an invalid argument error. Fix now allows the use of all valid characters for a RACF user. (https://github.com/ansible-collections/ibm_zos_core/pull/1661).
48+
- zos_lineinfile - The ``tmp_hlq`` option was previously ignored and default values were used instead. Fix now honors the value set in the module option. (https://github.com/ansible-collections/ibm_zos_core/pull/1695).
49+
- zos_mount - The ``tmp_hlq`` option was previously ignored and default values were used instead. Fix now honors the value set in the module option. (https://github.com/ansible-collections/ibm_zos_core/pull/1695).
50+
- zos_mvs_raw - base64 sub-option for return_content under option for retrieving DD output did not return base64. Fix now returns the base64 encoded contents of the DD. (https://github.com/ansible-collections/ibm_zos_core/pull/1691).
51+
- zos_script - The module would discard command line arguments in a command, except for the first one. Fix now makes sure that all arguments are passed to the remote command that gets executed. (https://github.com/ansible-collections/ibm_zos_core/pull/1698).
52+
- zos_unarchive - The ``tmp_hlq`` option was previously ignored and default values were used instead. Fix now honors the value set in the module option. (https://github.com/ansible-collections/ibm_zos_core/pull/1695).
53+
754
v1.11.0
855
=======
956

@@ -218,7 +265,7 @@ Bugfixes
218265
Known Issues
219266
------------
220267

221-
- Several modules have reported UTF8 decoding errors when interacting with results that contain non-printable UTF8 characters in the response. This occurs when a module receives content that does not correspond to a UTF-8 value. These include modules `zos_job_submit`, `zos_job_output`, `zos_operator_action_query` but are not limited to this list. This will be addressed in `ibm_zos_core` version 1.10.0-beta.1. Each case is unique, some options to work around the error are below. - Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters. - Add `ignore_errors:true` to the playbook task so the task error will not fail the playbook. - If the error is resulting from a batch job, add `ignore_errors:true` to the task and capture the output into a variable and extract the job ID with a regular expression and then use `zos_job_output` to display the DD without the non-printable character such as the DD `JESMSGLG`. (https://github.com/ansible-collections/ibm_zos_core/issues/677) (https://github.com/ansible-collections/ibm_zos_core/issues/776) (https://github.com/ansible-collections/ibm_zos_core/issues/972)
268+
- Several modules have reported UTF8 decoding errors when interacting with results that contain non-printable UTF8 characters in the response. This occurs when a module receives content that does not correspond to a UTF-8 value. These include modules `zos_job_submit`, `zos_job_output`, `zos_operator_action_query` but are not limited to this list. This will be addressed in `ibm_zos_core` version 1.10.0. Each case is unique, some options to work around the error are below. - Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters. - Add `ignore_errors:true` to the playbook task so the task error will not fail the playbook. - If the error is resulting from a batch job, add `ignore_errors:true` to the task and capture the output into a variable and extract the job ID with a regular expression and then use `zos_job_output` to display the DD without the non-printable character such as the DD `JESMSGLG`. (https://github.com/ansible-collections/ibm_zos_core/issues/677) (https://github.com/ansible-collections/ibm_zos_core/issues/776) (https://github.com/ansible-collections/ibm_zos_core/issues/972)
222269
- With later versions of `ansible-core` used with `ibm_zos_core` collection a warning has started to appear "Module "ansible.builtin.command" returned non UTF-8 data in the JSON response" that is currently being reviewed. There are no recommendations at this point. (https://github.com/ansible-collections/ibm_zos_core/issues/983)
223270

224271
New Modules

README.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,7 @@ All releases will meet the following test criteria.
135135
* ansible-core v2.15.x
136136
* Python 3.11.x
137137
* IBM Open Enterprise SDK for Python 3.12.x
138-
* IBM Z Open Automation Utilities (ZOAU) 1.3.1.x
138+
* IBM Z Open Automation Utilities (ZOAU) 1.3.2.x
139139
* z/OS V2R5
140140

141141
## Contributing
@@ -174,14 +174,15 @@ For Galaxy and GitHub users, to see the supported ansible-core versions, review
174174

175175
| Version | Status | Release notes | Changelogs |
176176
|----------|----------------|---------------|------------|
177-
| 1.12.x | In development | unreleased | unreleased |
178-
| 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) |
179-
| 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) |
180-
| 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) |
181-
| 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) |
182-
| 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) |
183-
| 1.6.x | Released | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-6-0) | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.6.0/CHANGELOG.rst) |
184-
| 1.5.x | Released | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-5-0) | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.5.0/CHANGELOG.rst) |
177+
| 1.13.x | In development | unreleased | unreleased |
178+
| 1.12.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.12.0-beta.1/CHANGELOG.rst#v1-12-0-beta-1) |
179+
| 1.11.x | Released | [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#v1-11-0) |
180+
| 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#v1-10-0) |
181+
| 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#v1-9-2) |
182+
| 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#v1-8-0) |
183+
| 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#v1-7-0) |
184+
| 1.6.x | Released | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-6-0) | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.6.0/CHANGELOG.rst#v1-6-0) |
185+
| 1.5.x | Released | [Release notes](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#version-1-5-0) | [Changelogs](https://github.com/ansible-collections/ibm_zos_core/blob/v1.5.0/CHANGELOG.rst#v1-5-0) |
185186

186187
## Related Information
187188

changelogs/.plugin-cache.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -135,4 +135,4 @@ plugins:
135135
strategy: {}
136136
test: {}
137137
vars: {}
138-
version: 1.11.0
138+
version: 1.12.0-beta.1

0 commit comments

Comments
 (0)