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
+14-7Lines changed: 14 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,13 +5,13 @@ ibm.ibm_zos_core Release Notes
5
5
.. contents:: Topics
6
6
7
7
8
-
v1.6.0-beta.1
9
-
=============
8
+
v1.6.0
9
+
======
10
10
11
11
Release Summary
12
12
---------------
13
13
14
-
Release Date: '2023-04-26'
14
+
Release Date: '2023-06-23'
15
15
This changelog describes all changes made to the modules and plugins included
16
16
in this collection. The release date is the date the changelog is created.
17
17
For additional details such as required dependencies and availability review
@@ -26,23 +26,30 @@ Minor Changes
26
26
-------------
27
27
28
28
- Updated the text converter import from "from ansible.module_utils._text" to "from ansible.module_utils.common.text.converters" to remove warning".. warn Use ansible.module_utils.common.text.converters instead.". (https://github.com/ansible-collections/ibm_zos_core/pull/602)
29
-
- module_utils - job.py utility did not support positional wiled card placement, this enhancement uses `fnmatch` logic to support wild cards.
29
+
- module_utils - job.py utility did not support positional wild card placement, this enhancement uses `fnmatch` logic to support wild cards.
30
30
- zos_copy - Fixed a bug where the module would change the mode for a directory when copying into it the contents of another. (https://github.com/ansible-collections/ibm_zos_core/pull/723)
31
31
- zos_copy - was enhanced to keep track of modified members in a destination dataset, restoring them to their previous state in case of a failure. (https://github.com/ansible-collections/ibm_zos_core/pull/551)
32
-
- zos_data_set - add force parameter to enable member delete while pdse is in use (https://github.com/ansible-collections/ibm_zos_core/pull/718).
33
-
- zos_job_query - ansible module does not support positional wild card placement for `job_name1 or `job_id`. This enhancement allows embedded wildcards throughout the `job_name` and `job_id`. (https://github.com/ansible-collections/ibm_zos_core/pull/721)
32
+
- zos_data_set - add force parameter to enable member delete while PDS/e is in use (https://github.com/ansible-collections/ibm_zos_core/pull/718).
33
+
- zos_job_query - ansible module does not support positional wild card placement for `job_name` or `job_id`. This enhancement allows embedded wildcards throughout the `job_name` and `job_id`. (https://github.com/ansible-collections/ibm_zos_core/pull/721)
34
34
- zos_lineinfile - would access data sets with exclusive access so no other task can read the data, this enhancement allows for a data set to be opened with a disposition set to share so that other tasks can access the data when option `force` is set to `true`. (https://github.com/ansible-collections/ibm_zos_core/pull/731)
35
35
- zos_tso_command - was enhanced to accept `max_rc` as an option. This option allows a non-zero return code to succeed as a valid return code. (https://github.com/ansible-collections/ibm_zos_core/pull/666)
36
36
37
37
Bugfixes
38
38
--------
39
39
40
40
- Fixed wrong error message when a USS source is not found, aligning with a similar error message from zos_blockinfile "{src} does not exist".
41
-
- zos_blockinfile - was unable to use double quotes which prevented some use cases and did not display an approriate message. The fix now allows for double quotes to be used with the module. (https://github.com/ansible-collections/ibm_zos_core/pull/680)
41
+
- module_utils - data_set.py - Reported a failure caused when cataloging a VSAM data set. Fix now corrects how VSAM data sets are cataloged. (https://github.com/ansible-collections/ibm_zos_core/pull/816).
42
+
- zos_blockinfile - was unable to use double quotes which prevented some use cases and did not display an appropriate message. The fix now allows for double quotes to be used with the module. (https://github.com/ansible-collections/ibm_zos_core/pull/680)
43
+
- zos_copy - Encoding normalization used to handle newlines in text files was applied to binary files too. Fix makes sure that binary files bypass this normalization. (https://github.com/ansible-collections/ibm_zos_core/pull/810)
42
44
- zos_copy - Fixes a bug where files not encoded in IBM-1047 would trigger an error while computing the record length for a new destination dataset. Issue 664. (https://github.com/ansible-collections/ibm_zos_core/pull/743)
43
45
- zos_copy - Fixes a bug where the code for fixing an issue with newlines in files (issue 599) would use the wrong encoding for normalization. Issue 678. (https://github.com/ansible-collections/ibm_zos_core/pull/743)
46
+
- zos_copy - Reported a warning about the use of _play_context.verbosity.This change corrects the module action to prevent the warning message. (https://github.com/ansible-collections/ibm_zos_core/pull/814).
47
+
- zos_copy - kept permissions on target directory when copy overwrote files. The fix now set permissions when mode is given. (https://github.com/ansible-collections/ibm_zos_core/pull/790)
48
+
- zos_data_set - Reported a failure caused when `present=absent` for a VSAM data set leaving behind cluster components. Fix introduces a new logical flow that will evaluate the volumes, compare it to the provided value and if necessary catalog and delete. (https://github.com/ansible-collections/ibm_zos_core/pull/816).
44
49
- zos_encode - fixes a bug where converted files were not tagged afterwards with the new code set. (https://github.com/ansible-collections/ibm_zos_core/pull/534)
50
+
- zos_fetch - Reported a warning about the use of _play_context.verbosity.This change corrects the module action to prevent the warning message. (https://github.com/ansible-collections/ibm_zos_core/pull/814).
45
51
- zos_find - fixes a bug where find result values stopped being returned after first value in a list was 'not found'. (https://github.com/ansible-collections/ibm_zos_core/pull/668)
52
+
- zos_gather_facts - Fixes an issue in the zoau version checker which prevented the zos_gather_facts module from running with newer versions of ZOAU. (https://github.com/ansible-collections/ibm_zos_core/pull/797)
46
53
- zos_lineinfile - Fixed a bug where a Python f-string was used and thus removed to ensure support for Python 2.7 on the controller. (https://github.com/ansible-collections/ibm_zos_core/pull/659)
Copy file name to clipboardExpand all lines: docs/source/modules/zos_data_set.rst
+15-3Lines changed: 15 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -56,6 +56,9 @@ state
56
56
If *state=absent* and *volumes* is provided, and the data set is not found in the catalog, the module attempts to perform catalog using supplied *name* and *volumes*. If the attempt to catalog the data set catalog fails, then no action is taken. Module completes successfully with *changed=False*.
57
57
58
58
59
+
If *state=absent* and *volumes* is provided, and the data set is found in the catalog, the module compares the catalog volume attributes to the provided *volumes*. If the volume attributes are different, the cataloged data set will be uncataloged temporarily while the requested data set be deleted is cataloged. The module will catalog the original data set on completion, if the attempts to catalog fail, no action is taken. Module completes successfully with *changed=False*.
60
+
61
+
59
62
If *state=present* and the data set does not exist on the managed node, create and catalog the data set, module completes successfully with *changed=True*.
60
63
61
64
@@ -65,6 +68,9 @@ state
65
68
If *state=present* and *replace=False* and the data set is present on the managed node, no action taken, module completes successfully with *changed=False*.
66
69
67
70
71
+
If *state=present* and *type=MEMBER* and the member does not exist in the data set, create a member formatted to store data, module completes successfully with *changed=True*. Note, a PDSE does not allow a mixture of formats such that there is executables (program objects) and data. The member created is formatted to store data, not an executable.
72
+
73
+
68
74
If *state=cataloged* and *volumes* is provided and the data set is already cataloged, no action taken, module completes successfully with *changed=False*.
69
75
70
76
@@ -74,7 +80,7 @@ state
74
80
If *state=cataloged* and *volumes* is provided and the data set is not cataloged, module attempts to perform catalog using supplied *name* and *volumes*. If the attempt to catalog the data set catalog fails, returns failure with *changed=False*.
75
81
76
82
77
-
If *state=uncataloged* and the data set is not found, no action taken, module completes successfully with *changed=False*.
83
+
If *state=uncataloged* and the data set is not found, no action taken, module completes successfully with *changed=False*.
78
84
79
85
80
86
If *state=uncataloged* and the data set is found, the data set is uncataloged, module completes successfully with *changed=True*.
@@ -321,6 +327,9 @@ batch
321
327
If *state=absent* and *volumes* is provided, and the data set is not found in the catalog, the module attempts to perform catalog using supplied *name* and *volumes*. If the attempt to catalog the data set catalog fails, then no action is taken. Module completes successfully with *changed=False*.
322
328
323
329
330
+
If *state=absent* and *volumes* is provided, and the data set is found in the catalog, the module compares the catalog volume attributes to the provided *volumes*. If they volume attributes are different, the cataloged data set will be uncataloged temporarily while the requested data set be deleted is cataloged. The module will catalog the original data set on completion, if the attempts to catalog fail, no action is taken. Module completes successfully with *changed=False*.
331
+
332
+
324
333
If *state=present* and the data set does not exist on the managed node, create and catalog the data set, module completes successfully with *changed=True*.
325
334
326
335
@@ -330,6 +339,9 @@ batch
330
339
If *state=present* and *replace=False* and the data set is present on the managed node, no action taken, module completes successfully with *changed=False*.
331
340
332
341
342
+
If *state=present* and *type=MEMBER* and the member does not exist in the data set, create a member formatted to store data, module completes successfully with *changed=True*. Note, a PDSE does not allow a mixture of formats such that there is executables (program objects) and data. The member created is formatted to store data, not an executable.
343
+
344
+
333
345
If *state=cataloged* and *volumes* is provided and the data set is already cataloged, no action taken, module completes successfully with *changed=False*.
334
346
335
347
@@ -339,7 +351,7 @@ batch
339
351
If *state=cataloged* and *volumes* is provided and the data set is not cataloged, module attempts to perform catalog using supplied *name* and *volumes*. If the attempt to catalog the data set catalog fails, returns failure with *changed=False*.
340
352
341
353
342
-
If *state=uncataloged* and the data set is not found, no action taken, module completes successfully with *changed=False*.
354
+
If *state=uncataloged* and the data set is not found, no action taken, module completes successfully with *changed=False*.
343
355
344
356
345
357
If *state=uncataloged* and the data set is found, the data set is uncataloged, module completes successfully with *changed=True*.
@@ -352,7 +364,7 @@ batch
352
364
353
365
354
366
type
355
-
The data set type to be used when creating a data set. (e.g ``pdse``)
367
+
The data set type to be used when creating a data set. (e.g ``PDSE``)
356
368
357
369
``MEMBER`` expects to be used with an existing partitioned data set.
Copy file name to clipboardExpand all lines: docs/source/release_notes.rst
+21-3Lines changed: 21 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,8 +6,8 @@
6
6
Releases
7
7
========
8
8
9
-
Version 1.6.0-beta.1
10
-
====================
9
+
Version 1.6.0
10
+
=============
11
11
12
12
New Modules
13
13
-----------
@@ -18,23 +18,41 @@ Minor Changes
18
18
-------------
19
19
20
20
- ``zos_blockinfile`` - Adds an enhancement to allow double quotes within a block.
21
+
- ``zos_copy``
22
+
23
+
- Updates the behavior of the `mode` option so that permissions are applied to existing directories and contents.
24
+
- Adds an enhancement to option `restore_backup` to track modified members in a data set in the event of an error, restoring them to their previous state without reallocating the data set.
21
25
- ``zos_data_set`` - Adds a new option named *force* to enable deletion of a data member in a PDSE that is simultaneously in use by others.
22
26
- ``zos_job_query`` - Enables embedded positional wild card placement throughout *job_name* and *job_id* parameters.
23
27
- ``zos_lineinfile`` - Adds a new option named *force* to enable modification of a data member in a data set that is simultaneously in use by others.
24
28
- ``zos_tso_command`` - Adds a new option named *max_rc* to enable non-zero return codes lower than the specified maximum return as succeeded.
29
+
- ``module_utils``
30
+
31
+
- job - Adds support for positional wild card placement for `job_name`` and `job_id`.
32
+
- Adds support for import *common.text.converters* over the deprecated *_text* import.
25
33
26
34
Bugfixes
27
35
--------
28
36
29
37
- ``zos_copy``
38
+
30
39
- Fixes a bug where files not encoded in IBM-1047 would trigger an error while computing the record length for a new destination dataset.
31
40
- Fixes a bug where the module would change the mode for a directory when copying in the contents of another directory.
32
41
- Fixes a bug where the incorrect encoding would be used during normalization, particularly when processing newlines in files.
42
+
- Fixes a bug where binary files were not excluded when normalizing data to remove newlines.
43
+
- Fixes a bug where a *_play_context.verbosity* deprecation warning would appear.
44
+
- ``zos_fetch`` - Fixes a bug where a *_play_context.verbosity* deprecation warning would appear.
33
45
- ``zos_encode`` - Fixes a bug where converted files were not tagged with the new code set afterwards.
34
46
- ``zos_find`` - Fixes a bug where the module would stop searching and exit after the first value in a list was not found.
35
47
- ``zos_lineinfile``
48
+
36
49
- Removes use of Python f-string to ensure support for Python 2.7 on the controller.
37
-
- Fixes a bug where an incorect error message would be raised when a USS source was not found.
50
+
- Fixes a bug where an incorrect error message would be raised when a USS source was not found.
51
+
- ``module_utils``
52
+
53
+
- data_set - Fixes an failure caused by cataloging a VSAM data set when the data set is not cataloged.
54
+
- ``zos_data_set`` - Fixes a bug that will leave VSAM data set cluster components behind when instructed to delete the data set (`present=absent`).
55
+
- ``zos_gather_facts`` - Fixes a bug that prevented the module from executing with newer versions of ZOAU.
0 commit comments