From d12fed375fc34bdfabf55d721744a1832411be6b Mon Sep 17 00:00:00 2001 From: Fernando Flores Date: Thu, 7 Dec 2023 12:49:34 -0600 Subject: [PATCH 01/11] Modified galaxy version --- galaxy.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/galaxy.yml b/galaxy.yml index b83b1014a..f7be530c7 100644 --- a/galaxy.yml +++ b/galaxy.yml @@ -6,7 +6,7 @@ namespace: ibm name: ibm_zos_core # The collection version -version: 1.8.0-beta.1 +version: 1.8.0 # Collection README file readme: README.md From d05f8253419263a4134b59a9f8effe9f90d5f9ef Mon Sep 17 00:00:00 2001 From: Fernando Flores Date: Thu, 7 Dec 2023 14:39:59 -0600 Subject: [PATCH 02/11] mofidied meta --- meta/ibm_zos_core_meta.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/meta/ibm_zos_core_meta.yml b/meta/ibm_zos_core_meta.yml index 7a68a05bb..e1ee28246 100644 --- a/meta/ibm_zos_core_meta.yml +++ b/meta/ibm_zos_core_meta.yml @@ -1,5 +1,5 @@ name: ibm_zos_core -version: "1.8.0-beta.1" +version: "1.8.0" managed_requirements: - name: "IBM Open Enterprise SDK for Python" @@ -7,4 +7,4 @@ managed_requirements: - name: "Z Open Automation Utilities" version: - - "1.2.3" + - "1.2.4" From 463dfbbacf0171b7f0b6d6d1d6d201141f00b8f2 Mon Sep 17 00:00:00 2001 From: Fernando Flores Date: Fri, 8 Dec 2023 10:32:21 -0600 Subject: [PATCH 03/11] Update copyright year --- plugins/module_utils/data_set.py | 2 +- plugins/module_utils/encode.py | 2 +- plugins/module_utils/job.py | 2 +- plugins/module_utils/mvs_cmd.py | 2 +- plugins/module_utils/template.py | 2 +- plugins/module_utils/zoau_version_checker.py | 2 +- plugins/modules/zos_blockinfile.py | 2 +- plugins/modules/zos_job_submit.py | 2 +- plugins/modules/zos_operator.py | 2 +- plugins/modules/zos_operator_action_query.py | 2 +- plugins/modules/zos_tso_command.py | 2 +- 11 files changed, 11 insertions(+), 11 deletions(-) diff --git a/plugins/module_utils/data_set.py b/plugins/module_utils/data_set.py index e1414cde8..4c618e1ea 100644 --- a/plugins/module_utils/data_set.py +++ b/plugins/module_utils/data_set.py @@ -1,4 +1,4 @@ -# Copyright (c) IBM Corporation 2020, 2023 +# Copyright (c) IBM Corporation 2020 - 2023 # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at diff --git a/plugins/module_utils/encode.py b/plugins/module_utils/encode.py index 047aa654c..6c96ed0ea 100644 --- a/plugins/module_utils/encode.py +++ b/plugins/module_utils/encode.py @@ -1,4 +1,4 @@ -# Copyright (c) IBM Corporation 2020, 2023 +# Copyright (c) IBM Corporation 2020 - 2023 # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at diff --git a/plugins/module_utils/job.py b/plugins/module_utils/job.py index bf23bf5bc..bf54d4cc6 100644 --- a/plugins/module_utils/job.py +++ b/plugins/module_utils/job.py @@ -1,4 +1,4 @@ -# Copyright (c) IBM Corporation 2019, 2020, 2023 +# Copyright (c) IBM Corporation 2019 - 2023 # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at diff --git a/plugins/module_utils/mvs_cmd.py b/plugins/module_utils/mvs_cmd.py index ec4955ac6..6331a1772 100644 --- a/plugins/module_utils/mvs_cmd.py +++ b/plugins/module_utils/mvs_cmd.py @@ -1,4 +1,4 @@ -# Copyright (c) IBM Corporation 2020, 2023 +# Copyright (c) IBM Corporation 2020 - 2023 # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at diff --git a/plugins/module_utils/template.py b/plugins/module_utils/template.py index 419b997b2..cccc03164 100644 --- a/plugins/module_utils/template.py +++ b/plugins/module_utils/template.py @@ -1,4 +1,4 @@ -# Copyright (c) IBM Corporation 2022, 2023 +# Copyright (c) IBM Corporation 2022 - 2023 # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at diff --git a/plugins/module_utils/zoau_version_checker.py b/plugins/module_utils/zoau_version_checker.py index 41dd35276..12470ef19 100644 --- a/plugins/module_utils/zoau_version_checker.py +++ b/plugins/module_utils/zoau_version_checker.py @@ -1,5 +1,5 @@ # -*- coding: utf-8 -*- -# Copyright (c) IBM Corporation 2022, 2023 +# Copyright (c) IBM Corporation 2022 - 2023 # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at diff --git a/plugins/modules/zos_blockinfile.py b/plugins/modules/zos_blockinfile.py index 1751c6472..7a2adf7cc 100644 --- a/plugins/modules/zos_blockinfile.py +++ b/plugins/modules/zos_blockinfile.py @@ -1,7 +1,7 @@ #!/usr/bin/python # -*- coding: utf-8 -*- -# Copyright (c) IBM Corporation 2020, 2022, 2023 +# Copyright (c) IBM Corporation 2020 - 2023 # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at diff --git a/plugins/modules/zos_job_submit.py b/plugins/modules/zos_job_submit.py index 11f0f3ccb..a099bd135 100644 --- a/plugins/modules/zos_job_submit.py +++ b/plugins/modules/zos_job_submit.py @@ -1,7 +1,7 @@ #!/usr/bin/python # -*- coding: utf-8 -*- -# Copyright (c) IBM Corporation 2019, 2020, 2022, 2023 +# Copyright (c) IBM Corporation 2019 - 2023 # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at diff --git a/plugins/modules/zos_operator.py b/plugins/modules/zos_operator.py index 969890ba5..c64e11337 100644 --- a/plugins/modules/zos_operator.py +++ b/plugins/modules/zos_operator.py @@ -1,7 +1,7 @@ #!/usr/bin/python # -*- coding: utf-8 -*- -# Copyright (c) IBM Corporation 2019, 2020, 2022, 2023 +# Copyright (c) IBM Corporation 2019 - 2023 # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at diff --git a/plugins/modules/zos_operator_action_query.py b/plugins/modules/zos_operator_action_query.py index ccf565626..a035cad33 100644 --- a/plugins/modules/zos_operator_action_query.py +++ b/plugins/modules/zos_operator_action_query.py @@ -1,7 +1,7 @@ #!/usr/bin/python # -*- coding: utf-8 -*- -# Copyright (c) IBM Corporation 2019, 2020, 2023 +# Copyright (c) IBM Corporation 2019 - 2023 # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at diff --git a/plugins/modules/zos_tso_command.py b/plugins/modules/zos_tso_command.py index 87b157318..28b033a90 100644 --- a/plugins/modules/zos_tso_command.py +++ b/plugins/modules/zos_tso_command.py @@ -1,7 +1,7 @@ #!/usr/bin/python # -*- coding: utf-8 -*- -# Copyright (c) IBM Corporation 2019, 2020, 2023 +# Copyright (c) IBM Corporation 2019 - 2023 # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at From c96e8ead34bc2c7808d43bee93e472170d853f02 Mon Sep 17 00:00:00 2001 From: Fernando Flores Date: Fri, 8 Dec 2023 10:36:07 -0600 Subject: [PATCH 04/11] Generated module docs --- docs/source/modules/zos_copy.rst | 7 +++++-- docs/source/modules/zos_job_submit.rst | 7 +++++-- docs/source/modules/zos_script.rst | 7 +++++-- docs/source/requirements-single.rst | 13 +++++++------ 4 files changed, 22 insertions(+), 12 deletions(-) diff --git a/docs/source/modules/zos_copy.rst b/docs/source/modules/zos_copy.rst index 004671ebc..bd321dc50 100644 --- a/docs/source/modules/zos_copy.rst +++ b/docs/source/modules/zos_copy.rst @@ -550,8 +550,11 @@ template_parameters | **required**: False | **type**: str - | **default**: \\n - | **choices**: \\n, \\r, \\r\\n + | **default**: + + | **choices**: +, , + auto_reload diff --git a/docs/source/modules/zos_job_submit.rst b/docs/source/modules/zos_job_submit.rst index e0fd8e2d1..dff435885 100644 --- a/docs/source/modules/zos_job_submit.rst +++ b/docs/source/modules/zos_job_submit.rst @@ -255,8 +255,11 @@ template_parameters | **required**: False | **type**: str - | **default**: \\n - | **choices**: \\n, \\r, \\r\\n + | **default**: + + | **choices**: +, , + auto_reload diff --git a/docs/source/modules/zos_script.rst b/docs/source/modules/zos_script.rst index bc8dff3c0..ca56783c4 100644 --- a/docs/source/modules/zos_script.rst +++ b/docs/source/modules/zos_script.rst @@ -217,8 +217,11 @@ template_parameters | **required**: False | **type**: str - | **default**: \\n - | **choices**: \\n, \\r, \\r\\n + | **default**: + + | **choices**: +, , + auto_reload diff --git a/docs/source/requirements-single.rst b/docs/source/requirements-single.rst index 3f0b2b8e0..555cf1ced 100644 --- a/docs/source/requirements-single.rst +++ b/docs/source/requirements-single.rst @@ -12,7 +12,7 @@ Requirements The **IBM z/OS core collection** requires both a **control node** and **managed node** be configured with a minimum set of requirements. The control node is often referred to as the **controller** and the -managed node as the **host**. +managed node as the **host** or **target**. Control node ============ @@ -20,7 +20,7 @@ The controller is where the Ansible engine that runs the playbook is installed. Refer to RedHat Ansible Certified Content documentation for more on the `controllers dependencies`_. .. _controllers dependencies: - https://ibm.github.io/z_ansible_collections_doc/requirements/requirements.html#control-node + https://ibm.github.io/z_ansible_collections_doc/requirements/requirements_controller.html .. ........................................................................... .. © Copyright IBM Corporation 2020 . .. ........................................................................... @@ -38,11 +38,12 @@ some dependencies are required to be installed on z/OS such as: * `IBM Open Enterprise SDK for Python`_ * `IBM Z Open Automation Utilities`_ - .. note:: - Each release of the IBM z/OS core collection depends on specific dependency - versions. For information on the dependencies or the versions, review the - `release notes`_ reference section. +.. note:: + + Each release of the IBM z/OS core collection depends on specific dependency + versions. For information on the dependencies or the versions, review the + `release notes`_ reference section. z/OS shell ---------- From 0930cd1b4152169ae4698d9944f419e1860994fe Mon Sep 17 00:00:00 2001 From: Fernando Flores Date: Fri, 8 Dec 2023 10:47:28 -0600 Subject: [PATCH 05/11] Created changelog --- changelogs/changelog.yaml | 49 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml index 2e50559d7..f251d649e 100644 --- a/changelogs/changelog.yaml +++ b/changelogs/changelog.yaml @@ -1023,6 +1023,55 @@ releases: - 930-archive-post-beta.yml - v1.7.0-beta.2_summary.yml release_date: '2023-08-21' + 1.8.0: + changes: + bugfixes: + - zos_copy - When copying an executable data set from controller to managed + node, copy operation failed with an encoding error. Fix now avoids encoding + when executable option is selected. (https://github.com/ansible-collections/ibm_zos_core/pull/1079). + - zos_copy - When copying an executable data set with aliases and destination + did not exist, destination data set was created with wrong attributes. Fix + now creates destination data set with the same attributes as the source. (https://github.com/ansible-collections/ibm_zos_core/pull/1067). + - zos_copy - When performing a copy operation to an existing file, the copied + file resulted in having corrupted contents. Fix now implements a workaround + to not use the specific copy routine that corrupts the file contents. (https://github.com/ansible-collections/ibm_zos_core/pull/1069). + - zos_operator - The module was ignoring the wait time argument. The module + now passes the wait time argument to ZOAU. (https://github.com/ansible-collections/ibm_zos_core/pull/1063). + - zos_operator_action_query - The module was ignoring the wait time argument. + The module now passes the wait time argument to ZOAU. (https://github.com/ansible-collections/ibm_zos_core/pull/1063). + - zos_unarchive - When zos_unarchive fails during unpack either with xmit or + terse it does not clean the temporary data sets created. Fix now removes the + temporary data sets. (https://github.com/ansible-collections/ibm_zos_core/pull/1054). + minor_changes: + - zos_script - Add support for remote_tmp from the Ansible configuration to + setup where temporary files will be created, replacing the module option tmp_path. + (https://github.com/ansible-collections/ibm_zos_core/pull/1068). + - zos_submit_job - Previous code did not return output, but still requested + job data from the target system. This changes to honor return_output=false + by not querying the job dd segments at all. (https://github.com/ansible-collections/ibm_zos_core/pull/1063). + - zos_tso_command - Add example for executing explicitly a REXX script from + a data set. (https://github.com/ansible-collections/ibm_zos_core/pull/1072). + release_summary: 'Release Date: ''2023-12-08'' + + 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 `__' + fragments: + - 1041-bug-zos-submit-job-honor-return-output-literally.yml + - 1043-bug-title-zos_operator-is-passing-wrong-value-to-zoauopercmd.yml + - 1049-xmit-temporary-data-sets.yml + - 1060-remote_tmp_zos_script.yml + - 1067-mvs_to_non_existent_mvs_copy_verify_destination_attrs_match.yml + - 1069-corrupted-second-copy.yml + - 1072-rexx-exec-tso_command.yml + - 1079-zos-copy-local-executable.yml + - 1089-update-managed_node_doc.yml + - v1.8.0-summary.yml + release_date: '2023-12-08' 1.8.0-beta.1: changes: bugfixes: From feb8a84cd3be1bbbc894169b494bf55eee7e2376 Mon Sep 17 00:00:00 2001 From: Fernando Flores Date: Fri, 8 Dec 2023 10:48:31 -0600 Subject: [PATCH 06/11] Removed changelog fragments --- ...1-bug-zos-submit-job-honor-return-output-literally.yml | 4 ---- ...zos_operator-is-passing-wrong-value-to-zoauopercmd.yml | 8 -------- changelogs/fragments/1049-xmit-temporary-data-sets.yml | 4 ---- changelogs/fragments/1060-remote_tmp_zos_script.yml | 5 ----- ...n_existent_mvs_copy_verify_destination_attrs_match.yml | 5 ----- changelogs/fragments/1069-corrupted-second-copy.yml | 5 ----- changelogs/fragments/1072-rexx-exec-tso_command.yml | 4 ---- changelogs/fragments/1079-zos-copy-local-executable.yml | 5 ----- changelogs/fragments/1089-update-managed_node_doc.yml | 3 --- 9 files changed, 43 deletions(-) delete mode 100644 changelogs/fragments/1041-bug-zos-submit-job-honor-return-output-literally.yml delete mode 100644 changelogs/fragments/1043-bug-title-zos_operator-is-passing-wrong-value-to-zoauopercmd.yml delete mode 100644 changelogs/fragments/1049-xmit-temporary-data-sets.yml delete mode 100644 changelogs/fragments/1060-remote_tmp_zos_script.yml delete mode 100644 changelogs/fragments/1067-mvs_to_non_existent_mvs_copy_verify_destination_attrs_match.yml delete mode 100644 changelogs/fragments/1069-corrupted-second-copy.yml delete mode 100644 changelogs/fragments/1072-rexx-exec-tso_command.yml delete mode 100644 changelogs/fragments/1079-zos-copy-local-executable.yml delete mode 100644 changelogs/fragments/1089-update-managed_node_doc.yml diff --git a/changelogs/fragments/1041-bug-zos-submit-job-honor-return-output-literally.yml b/changelogs/fragments/1041-bug-zos-submit-job-honor-return-output-literally.yml deleted file mode 100644 index e8190ed15..000000000 --- a/changelogs/fragments/1041-bug-zos-submit-job-honor-return-output-literally.yml +++ /dev/null @@ -1,4 +0,0 @@ -minor_changes: - - zos_submit_job - Previous code did not return output, but still requested job data from the target system. - This changes to honor return_output=false by not querying the job dd segments at all. - (https://github.com/ansible-collections/ibm_zos_core/pull/1063). \ No newline at end of file diff --git a/changelogs/fragments/1043-bug-title-zos_operator-is-passing-wrong-value-to-zoauopercmd.yml b/changelogs/fragments/1043-bug-title-zos_operator-is-passing-wrong-value-to-zoauopercmd.yml deleted file mode 100644 index 406ecf588..000000000 --- a/changelogs/fragments/1043-bug-title-zos_operator-is-passing-wrong-value-to-zoauopercmd.yml +++ /dev/null @@ -1,8 +0,0 @@ -bugfixes: - - zos_operator - The module was ignoring the wait time argument. - The module now passes the wait time argument to ZOAU. - (https://github.com/ansible-collections/ibm_zos_core/pull/1063). - - - zos_operator_action_query - The module was ignoring the wait time argument. - The module now passes the wait time argument to ZOAU. - (https://github.com/ansible-collections/ibm_zos_core/pull/1063). \ No newline at end of file diff --git a/changelogs/fragments/1049-xmit-temporary-data-sets.yml b/changelogs/fragments/1049-xmit-temporary-data-sets.yml deleted file mode 100644 index 733b93e16..000000000 --- a/changelogs/fragments/1049-xmit-temporary-data-sets.yml +++ /dev/null @@ -1,4 +0,0 @@ -bugfixes: - - zos_unarchive - When zos_unarchive fails during unpack either with xmit or terse it does not clean the - temporary data sets created. Fix now removes the temporary data sets. - (https://github.com/ansible-collections/ibm_zos_core/pull/1054). diff --git a/changelogs/fragments/1060-remote_tmp_zos_script.yml b/changelogs/fragments/1060-remote_tmp_zos_script.yml deleted file mode 100644 index d1183feea..000000000 --- a/changelogs/fragments/1060-remote_tmp_zos_script.yml +++ /dev/null @@ -1,5 +0,0 @@ -minor_changes: - - zos_script - add support for remote_tmp from the Ansible - configuration to setup where temporary files will be created, - replacing the module option tmp_path. - (https://github.com/ansible-collections/ibm_zos_core/pull/1068). \ No newline at end of file diff --git a/changelogs/fragments/1067-mvs_to_non_existent_mvs_copy_verify_destination_attrs_match.yml b/changelogs/fragments/1067-mvs_to_non_existent_mvs_copy_verify_destination_attrs_match.yml deleted file mode 100644 index 2f75a425b..000000000 --- a/changelogs/fragments/1067-mvs_to_non_existent_mvs_copy_verify_destination_attrs_match.yml +++ /dev/null @@ -1,5 +0,0 @@ -bugfixes: - - zos_copy - When copying an executable data set with aliases and destination did not exist, - destination data set was created with wrong attributes. Fix now creates destination data set - with the same attributes as the source. - (https://github.com/ansible-collections/ibm_zos_core/pull/1067). \ No newline at end of file diff --git a/changelogs/fragments/1069-corrupted-second-copy.yml b/changelogs/fragments/1069-corrupted-second-copy.yml deleted file mode 100644 index 706da205f..000000000 --- a/changelogs/fragments/1069-corrupted-second-copy.yml +++ /dev/null @@ -1,5 +0,0 @@ -bugfixes: - - zos_copy - When performing a copy operation to an existing file, the copied - file resulted in having corrupted contents. Fix now implements a workaround - to not use the specific copy routine that corrupts the file contents. - (https://github.com/ansible-collections/ibm_zos_core/pull/1069). diff --git a/changelogs/fragments/1072-rexx-exec-tso_command.yml b/changelogs/fragments/1072-rexx-exec-tso_command.yml deleted file mode 100644 index 4bb4ef6b4..000000000 --- a/changelogs/fragments/1072-rexx-exec-tso_command.yml +++ /dev/null @@ -1,4 +0,0 @@ -minor_changes: - - zos_tso_command - add example for executing explicitly a REXX script from - a data set. - (https://github.com/ansible-collections/ibm_zos_core/pull/1072). diff --git a/changelogs/fragments/1079-zos-copy-local-executable.yml b/changelogs/fragments/1079-zos-copy-local-executable.yml deleted file mode 100644 index 4347525c9..000000000 --- a/changelogs/fragments/1079-zos-copy-local-executable.yml +++ /dev/null @@ -1,5 +0,0 @@ -bugfixes: - - zos_copy - When copying an executable data set from controller to managed node, - copy operation failed with an encoding error. Fix now avoids encoding when executable - option is selected. - (https://github.com/ansible-collections/ibm_zos_core/pull/1079). \ No newline at end of file diff --git a/changelogs/fragments/1089-update-managed_node_doc.yml b/changelogs/fragments/1089-update-managed_node_doc.yml deleted file mode 100644 index e0c7ff18b..000000000 --- a/changelogs/fragments/1089-update-managed_node_doc.yml +++ /dev/null @@ -1,3 +0,0 @@ -trivial: - - managed node doc - updated the managed node documentation links and content. - (https://github.com/ansible-collections/ibm_zos_core/pull/1089). From dc992451bff493933014ba7b2edc6b3f349d49f8 Mon Sep 17 00:00:00 2001 From: Fernando Flores Date: Fri, 8 Dec 2023 11:12:49 -0600 Subject: [PATCH 07/11] Updated changelog and release notes --- CHANGELOG.rst | 21 ++++++++++++++---- changelogs/changelog.yaml | 2 +- docs/source/release_notes.rst | 42 +++++++++++++++++++++++++---------- 3 files changed, 48 insertions(+), 17 deletions(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 2c2815de4..5511d540a 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -5,13 +5,13 @@ ibm.ibm_zos_core Release Notes .. contents:: Topics -v1.8.0-beta.1 -============= +v1.8.0 +====== Release Summary --------------- -Release Date: '2023-10-24' +Release Date: '2023-12-08' 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 @@ -31,18 +31,31 @@ Minor Changes - zos_job_submit - Change action plugin call from copy to zos_copy. (https://github.com/ansible-collections/ibm_zos_core/pull/951) - zos_operator - Changed system to call 'wait=true' parameter to zoau call. Requires zoau 1.2.5 or later. (https://github.com/ansible-collections/ibm_zos_core/pull/976) - zos_operator_action_query - Add a max delay of 5 seconds on each part of the operator_action_query. Requires zoau 1.2.5 or later. (https://github.com/ansible-collections/ibm_zos_core/pull/976) +- zos_script - add support for remote_tmp from the Ansible configuration to setup where temporary files will be created, replacing the module option tmp_path. (https://github.com/ansible-collections/ibm_zos_core/pull/1068). +- zos_submit_job - Previous code did not return output, but still requested job data from the target system. This changes to honor return_output=false by not querying the job dd segments at all. (https://github.com/ansible-collections/ibm_zos_core/pull/1063). +- zos_tso_command - add example for executing explicitly a REXX script from a data set. (https://github.com/ansible-collections/ibm_zos_core/pull/1072). - zos_unarchive - Add validation into path joins to detect unauthorized path traversals. (https://github.com/ansible-collections/ibm_zos_core/pull/1029) - zos_unarchive - Enhanced test cases to use test lines the same length of the record length. (https://github.com/ansible-collections/ibm_zos_core/pull/965) -- zos_copy - add support in zos_copy for text files and data sets containing ASA control characters. (https://github.com/ansible-collections/ibm_zos_core/pull/1028) + +Deprecated Features +------------------- + +- zos_blockinfile debug - is deprecated in favor of 'as_json' (https://github.com/ansible-collections/ibm_zos_core/pull/904). Bugfixes -------- - zos_copy - Update option limit to include LIBRARY as dest_dataset/suboption value. Documentation updated to reflect this change. (https://github.com/ansible-collections/ibm_zos_core/pull/968). +- zos_copy - When copying an executable data set from controller to managed node, copy operation failed with an encoding error. Fix now avoids encoding when executable option is selected. (https://github.com/ansible-collections/ibm_zos_core/pull/1079). +- zos_copy - When copying an executable data set with aliases and destination did not exist, destination data set was created with wrong attributes. Fix now creates destination data set with the same attributes as the source. (https://github.com/ansible-collections/ibm_zos_core/pull/1067). +- zos_copy - When performing a copy operation to an existing file, the copied file resulted in having corrupted contents. Fix now implements a workaround to not use the specific copy routine that corrupts the file contents. (https://github.com/ansible-collections/ibm_zos_core/pull/1069). - zos_job_submit - Temporary files were created in tmp directory. Fix now ensures the deletion of files every time the module run. (https://github.com/ansible-collections/ibm_zos_core/pull/951) - zos_job_submit - The last line of the jcl was missing in the input. Fix now ensures the presence of the full input in job_submit. (https://github.com/ansible-collections/ibm_zos_core/pull/952) - zos_lineinfile - A duplicate entry was made even if line was already present in the target file. Fix now prevents a duplicate entry if the line already exists in the target file. (https://github.com/ansible-collections/ibm_zos_core/pull/916) - zos_operator - The last line of the operator was missing in the response of the module. The fix now ensures the presence of the full output of the operator. https://github.com/ansible-collections/ibm_zos_core/pull/918) +- zos_operator - The module was ignoring the wait time argument. The module now passes the wait time argument to ZOAU. (https://github.com/ansible-collections/ibm_zos_core/pull/1063). +- zos_operator_action_query - The module was ignoring the wait time argument. The module now passes the wait time argument to ZOAU. (https://github.com/ansible-collections/ibm_zos_core/pull/1063). +- zos_unarchive - When zos_unarchive fails during unpack either with xmit or terse it does not clean the temporary data sets created. Fix now removes the temporary data sets. (https://github.com/ansible-collections/ibm_zos_core/pull/1054). Known Issues ------------ diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml index f251d649e..35eeaebb0 100644 --- a/changelogs/changelog.yaml +++ b/changelogs/changelog.yaml @@ -1046,7 +1046,7 @@ releases: - zos_script - Add support for remote_tmp from the Ansible configuration to setup where temporary files will be created, replacing the module option tmp_path. (https://github.com/ansible-collections/ibm_zos_core/pull/1068). - - zos_submit_job - Previous code did not return output, but still requested + - zos_job_submit - Previous code did not return output, but still requested job data from the target system. This changes to honor return_output=false by not querying the job dd segments at all. (https://github.com/ansible-collections/ibm_zos_core/pull/1063). - zos_tso_command - Add example for executing explicitly a REXX script from diff --git a/docs/source/release_notes.rst b/docs/source/release_notes.rst index 10150952d..0ba5c2e92 100644 --- a/docs/source/release_notes.rst +++ b/docs/source/release_notes.rst @@ -6,7 +6,7 @@ Releases ======== -Version 1.8.0-beta.1 +Version 1.8.0 ==================== New Modules @@ -22,29 +22,46 @@ Minor Changes - Enhanced test cases to use test lines the same length of the record length. - ``zos_copy`` - - Add validation into path joins to detect unauthorized path traversals. + - Add validation into path joins to detect unauthorized path traversals. - Add new option `force_lock` that can copy into data sets that are already in use by other processes (DISP=SHR). User needs to use with caution because this is subject to race conditions and can lead to data loss. - - includes a new option `executable` that enables copying of executables such as load modules or program objects to both USS and partitioned data sets. When the `dest` option contains a non-existent data set, `zos_copy` will create a data set with the appropriate attributes for an executable. - - introduces a new option 'aliases' to enable preservation of member aliases when copying data to partitioned data sets (PDS) destinations from USS or other PDS sources. Copying aliases of text based members to/from USS is not supported. - - add support in zos_copy for text files and data sets containing ASA control characters. + - Includes a new option `executable` that enables copying of executables such as load modules or program objects to both USS and partitioned data sets. When the `dest` option contains a non-existent data set, `zos_copy` will create a data set with the appropriate attributes for an executable. + - Introduces a new option 'aliases' to enable preservation of member aliases when copying data to partitioned data sets (PDS) destinations from USS or other PDS sources. Copying aliases of text based members to/from USS is not supported. + - Add support in zos_copy for text files and data sets containing ASA control characters. - ``zos_fetch`` - Add validation into path joins to detect unauthorized path traversals. -- ``zos_job_submit`` - Change action plugin call from copy to zos_copy. -- ``zos_operator`` - Changed system to call 'wait=true' parameter to zoau call. Requires zoau 1.2.5 or later. +- ``zos_job_submit`` + + - Change action plugin call from copy to zos_copy. + - Previous code did not return output, but still requested job data from the target system. This changes to honor `return_output=false` by not querying the job dd segments at all. +- ``zos_operator`` - Changed system to call `wait=true` parameter to zoau call. Requires zoau 1.2.5 or later. - ``zos_operator_action_query`` - Add a max delay of 5 seconds on each part of the operator_action_query. Requires zoau 1.2.5 or later. - ``zos_unarchive`` - - Add validation into path joins to detect unauthorized path traversals. + - Add validation into path joins to detect unauthorized path traversals. - Enhanced test cases to use test lines the same length of the record length. - ``module_utils/template`` - Add validation into path joins to detect unauthorized path traversals. +- ``zos_tso_command`` - Add example for executing explicitly a REXX script from a data set. +- ``zos_script`` - Add support for remote_tmp from the Ansible configuration to setup where temporary files will be created, replacing the module option tmp_path. Bugfixes -------- -- ``zos_copy`` - Update option limit to include LIBRARY as dest_dataset/suboption value. Documentation updated to reflect this change. -- ``zos_job_submit`` - Temporary files were created in tmp directory. Fix now ensures the deletion of files every time the module run. -- ``zos_job_submit`` - The last line of the jcl was missing in the input. Fix now ensures the presence of the full input in job_submit. +- ``zos_copy`` + + - Update option to include `LIBRARY` as dest_dataset/suboption value. Documentation updated to reflect this change. + - When copying an executable data set from controller to managed node, copy operation failed with an encoding error. Fix now avoids encoding when `executable` option is selected. + - When copying an executable data set with aliases and destination did not exist, destination data set was created with wrong attributes. Fix now creates destination data set with the same attributes as the source. + - When performing a copy operation to an existing file, the copied file resulted in having corrupted contents. Fix now implements a workaround to not use the specific copy routine that corrupts the file contents. +- ``zos_job_submit`` + + - Temporary files were created in tmp directory. Fix now ensures the deletion of files every time the module run. + - The last line of the jcl was missing in the input. Fix now ensures the presence of the full input in job_submit. - ``zos_lineinfile`` - A duplicate entry was made even if line was already present in the target file. Fix now prevents a duplicate entry if the line already exists in the target file. -- ``zos_operator`` - The last line of the operator was missing in the response of the module. The fix now ensures the presence of the full output of the operator. +- ``zos_operator`` + + - The last line of the operator was missing in the response of the module. The fix now ensures the presence of the full output of the operator. + - The module was ignoring the wait time argument. The module now passes the wait time argument to ZOAU. +- ``zos_operator_action_query`` - The module was ignoring the wait time argument. The module now passes the wait time argument to ZOAU. +- ``zos_unarchive`` - When zos_unarchive fails during unpack either with xmit or terse it does not clean the temporary data sets created. Fix now removes the temporary data sets. Known Issues ------------ @@ -55,6 +72,7 @@ Known Issues Availability ------------ +* `Automation Hub`_ * `Galaxy`_ * `GitHub`_ From 06ef645aa051d8b11db0a651dbe495cc6e03f529 Mon Sep 17 00:00:00 2001 From: Fernando Flores Date: Sun, 10 Dec 2023 21:31:38 -0600 Subject: [PATCH 08/11] Fixed newline sequences --- docs/source/modules/zos_copy.rst | 6 ++---- docs/source/modules/zos_job_submit.rst | 6 ++---- docs/source/modules/zos_script.rst | 6 ++---- 3 files changed, 6 insertions(+), 12 deletions(-) diff --git a/docs/source/modules/zos_copy.rst b/docs/source/modules/zos_copy.rst index bd321dc50..995ee395a 100644 --- a/docs/source/modules/zos_copy.rst +++ b/docs/source/modules/zos_copy.rst @@ -550,10 +550,8 @@ template_parameters | **required**: False | **type**: str - | **default**: - - | **choices**: -, , + | **default**: \\n + | **choices**: \\n, \\r, \\r\\n diff --git a/docs/source/modules/zos_job_submit.rst b/docs/source/modules/zos_job_submit.rst index dff435885..8aa7d61d4 100644 --- a/docs/source/modules/zos_job_submit.rst +++ b/docs/source/modules/zos_job_submit.rst @@ -255,10 +255,8 @@ template_parameters | **required**: False | **type**: str - | **default**: - - | **choices**: -, , + | **default**: \\n + | **choices**: \\n, \\r, \\r\\n diff --git a/docs/source/modules/zos_script.rst b/docs/source/modules/zos_script.rst index ca56783c4..08fda548b 100644 --- a/docs/source/modules/zos_script.rst +++ b/docs/source/modules/zos_script.rst @@ -217,10 +217,8 @@ template_parameters | **required**: False | **type**: str - | **default**: - - | **choices**: -, , + | **default**: \\n + | **choices**: \\n, \\r, \\r\\n From adaa150f7f51fac3baee6ebbff68158d9c837f39 Mon Sep 17 00:00:00 2001 From: Fernando Flores Date: Tue, 12 Dec 2023 12:41:18 -0600 Subject: [PATCH 09/11] Update CHANGELOG.rst --- CHANGELOG.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 5511d540a..918767e17 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -40,7 +40,7 @@ Minor Changes Deprecated Features ------------------- -- zos_blockinfile debug - is deprecated in favor of 'as_json' (https://github.com/ansible-collections/ibm_zos_core/pull/904). +- zos_blockinfile- debug is deprecated in favor of 'as_json' (https://github.com/ansible-collections/ibm_zos_core/pull/904). Bugfixes -------- From 120d7f86df433c39340fc99eee7e7260b88850d5 Mon Sep 17 00:00:00 2001 From: Fernando Flores Date: Tue, 12 Dec 2023 12:41:42 -0600 Subject: [PATCH 10/11] Update CHANGELOG.rst --- CHANGELOG.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 918767e17..a5883246e 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -40,7 +40,7 @@ Minor Changes Deprecated Features ------------------- -- zos_blockinfile- debug is deprecated in favor of 'as_json' (https://github.com/ansible-collections/ibm_zos_core/pull/904). +- zos_blockinfile - debug is deprecated in favor of 'as_json' (https://github.com/ansible-collections/ibm_zos_core/pull/904). Bugfixes -------- From 8a012ab03154088ee05926a165a0ad93826f633d Mon Sep 17 00:00:00 2001 From: Fernando Flores Date: Tue, 12 Dec 2023 21:26:44 -0600 Subject: [PATCH 11/11] Corrected release notes --- docs/source/release_notes.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/source/release_notes.rst b/docs/source/release_notes.rst index 0ba5c2e92..b198d74de 100644 --- a/docs/source/release_notes.rst +++ b/docs/source/release_notes.rst @@ -7,7 +7,7 @@ Releases ======== Version 1.8.0 -==================== +============= New Modules ----------- @@ -47,7 +47,7 @@ Bugfixes - ``zos_copy`` - - Update option to include `LIBRARY` as dest_dataset/suboption value. Documentation updated to reflect this change. + - Update option to include `LIBRARY` as dest_dataset/suboption value. Documentation updated to reflect this change. - When copying an executable data set from controller to managed node, copy operation failed with an encoding error. Fix now avoids encoding when `executable` option is selected. - When copying an executable data set with aliases and destination did not exist, destination data set was created with wrong attributes. Fix now creates destination data set with the same attributes as the source. - When performing a copy operation to an existing file, the copied file resulted in having corrupted contents. Fix now implements a workaround to not use the specific copy routine that corrupts the file contents.