diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_archive.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_archive.rst.txt index b4a9f218..bca1c5e8 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_archive.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_archive.rst.txt @@ -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: @@ -406,7 +406,7 @@ Examples format: name: terse format_options: - use_adrdssu: True + use_adrdssu: true diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_blockinfile.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_blockinfile.rst.txt index b57f6fee..4a61287f 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_blockinfile.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_blockinfile.rst.txt @@ -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 @@ -295,7 +295,7 @@ Examples zos_blockinfile: src: SOME.CREATION.TEST insertbefore: BOF - backup: True + backup: true backup_name: CREATION.GDS(+1) block: "{{ CONTENT }}" diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_encode.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_encode.rst.txt index 957d97a8..860a150b 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_encode.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_encode.rst.txt @@ -279,6 +279,7 @@ Examples + Notes ----- diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_find.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_find.rst.txt index 3d6f75f9..5c23a28a 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_find.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_find.rst.txt @@ -253,7 +253,6 @@ Examples - Notes ----- diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_lineinfile.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_lineinfile.rst.txt index 65fa9cd5..a7162127 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_lineinfile.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_lineinfile.rst.txt @@ -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 @@ -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' diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_unarchive.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_unarchive.rst.txt index 89b4b065..07988a47 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_unarchive.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_unarchive.rst.txt @@ -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 @@ -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. @@ -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. diff --git a/_sources/ibm_zos_core/docs/source/release_notes.rst.txt b/_sources/ibm_zos_core/docs/source/release_notes.rst.txt index 45f3f100..e2ee6058 100644 --- a/_sources/ibm_zos_core/docs/source/release_notes.rst.txt +++ b/_sources/ibm_zos_core/docs/source/release_notes.rst.txt @@ -6,75 +6,92 @@ Releases ======== -Version 1.11.0-beta.1 -===================== +Version 1.11.0 +============== Minor Changes ------------- -- ``zos_apf`` - Added support that auto-escapes 'library' names containing symbols. -- ``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 @. -- ``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 @. -- ``zos_blockinfile`` - Added support for GDG and GDS relative name notation to specify a data set. And backup in new generations. Added support for data set names with special characters like $, /#, /- and @. -- ``zos_copy`` - Added support for copying from and copying to generation data sets (GDS) and generation data groups (GDG) including using a GDS for backup. -- ``zos_data_set`` - Added support for GDG and GDS relative name notation to create, delete, catalog and uncatalog a data set. Added support for data set names with special characters like $, /#, /- and @. -- ``zos_encode`` - Added support for converting the encodings of generation data sets (GDS). Also added support to backup into GDS. -- ``zos_fetch`` - Added support for fetching generation data groups (GDG) and generation data sets (GDS). Added support for specifying data set names with special characters like $, /#, /- and @. -- ``zos_find`` - Added support for finding generation data groups (GDG) and generation data sets (GDS). Added support for specifying data set names with special characters like $, /#, /- and @. -- ``zos_job_submit`` +- ``zos_apf`` - Added support for data set names (libraries) with special characters ($, /#, /- and @). +- ``zos_archive`` - - Improved the mechanism for copying to remote systems by removing the use of deepcopy, which had previously resulted in the module failing on some systems. - - Added support for running JCL stored in generation data groups (GDG) and generation data sets (GDS). + - Added support for GDG and GDS relative name notation to archive data sets. + - Added support for data set names with special characters ($, /#, /- and @). -- ``zos_lineinfile`` - Added support for GDG and GDS relative name notation to specify the target data set and to backup into new generations. Added support for data set names with special characters like $, /#, /- and @. -- ``zos_mount`` - Added support for data set names with special characters ($, /#, /- and @). -- ``zos_mvs_raw`` - Added support for GDG and GDS relative name notation to specify data set names. Added support for data set names with special characters like $, /#, /- and @. -- ``zos_script`` - Improved the mechanism for copying to remote systems by removing the use of deepcopy, which had previously resulted in the module failing on some systems. -- ``zos_tso_command`` - Added support for using GDG and GDS relative name notation in running TSO commands. Added support for data set names with special characters like $, /#, /- and @. -- ``zos_unarchive`` +- ``zos_backup_restore`` - - Added support for data set names with special characters like $, /#, /- and @. - - Improved the mechanism for copying to remote systems by removing the use of deepcopy, which had previously resulted in the module failing on some systems. + - 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 ($, /#, /- and @). -Bugfixes --------- +- ``zos_blockinfile`` + + - Added support for GDG and GDS relative name notation to specify a data set. And backup in new generations. + - Added support for data set names with special characters ($, /#, /- and @). - ``zos_copy`` - - a regression in version 1.4.0 made the module stop automatically computing member names when copying a single file into a PDS/E. Fix now lets a user copy a single file into a PDS/E without adding a member in the dest option. - - module would use opercmd to check if a non existent destination data set is locked. Fix now only checks if the destination is already present. + - Added support for copying from and to generation data sets (GDS) and generation data groups (GDG) including using a GDS for backup. + - Added support for data set names with special characters ($, /#, /- and @). -- ``zos_data_set`` - When checking if a data set is cataloged, module failed to account for exceptions which occurred during the LISTCAT. The fix now raises an MVSCmdExecError if the return code from LISTCAT is too high. -- ``zos_job_submit`` - The module was not propagating any error types including UnicodeDecodeError, JSONDecodeError, TypeError, KeyError when encountered. The fix now shares the type error in the error message. -- ``zos_mvs_raw`` - The first character of each line in dd_output was missing. The fix now includes the first character of each line. +- ``zos_data_set`` -Availability ------------- + - Added support for GDG and GDS relative name notation to create, delete, catalog and uncatalog a data set. + - Added support for data set names with special characters ($, /#, /- and @). -* `Galaxy`_ -* `GitHub`_ +- ``zos_encode`` -Requirements ------------- + - Added support for converting the encodings of generation data sets (GDS). + - Added support for data set names with special characters ($, /#, /- and @). -The IBM z/OS core collection has several dependencies, please review the `z/OS core support matrix`_ to understand both the -controller and z/OS managed node dependencies. +- ``zos_fetch`` -Known Issues ------------- -- ``zos_job_submit`` - when setting 'location' to 'local' and not specifying the from and to encoding, the modules defaults are not read leaving the file in its original encoding; explicitly set the encodings instead of relying on the default. -- ``zos_job_submit`` - when submitting JCL, the response value returned for **byte_count** is incorrect. -- ``zos_apf`` - When trying to remove a library that contains the '$' character in the name from APF(authorized program facility), operation will fail. -- In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, this is so that the collection can continue to maintain certified status. + - Added support for fetching generation data groups (GDG) and generation data sets (GDS). + - Added support for data set names with special characters ($, /#, /- and @). +- ``zos_find`` -Version 1.9.2 -============= + - Added support for finding generation data groups (GDG) and generation data sets (GDS). + - Added support for data set names with special characters ($, /#, /- and @). + +- ``zos_job_submit`` + + - Improved the mechanism for copying to remote systems by removing the use of deepcopy, which had previously resulted in the module failing on some systems. + - Added support for running JCL stored in generation data groups (GDG) and generation data sets (GDS). + - Added support for data set names with special characters ($, /#, /- and @). + +- ``zos_lineinfile`` + + - Added support for GDG and GDS relative name notation to specify the target data set and to backup into new generations. + - Added support for data set names with special characters ($, /#, /- and @). + +- ``zos_mount`` - Added support for data set names with special characters ($, /#, /- and @). +- ``zos_mvs_raw`` + + - Added support for GDG and GDS relative name notation to specify data set names. + - Added support for data set names with special characters ($, /#, /- and @). + +- ``zos_script`` - Improved the mechanism for copying to remote systems by removing the use of deepcopy, which had previously resulted in the module failing on some systems. +- ``zos_tso_command`` + + - Added support for using GDG and GDS relative name notation in running TSO commands. + - Added support for data set names with special characters ($, /#, /- and @). + +- ``zos_unarchive`` + + - Improved the mechanism for copying to remote systems by removing the use of deepcopy, which had previously resulted in the module failing on some systems. + - Added support for data set names with special characters ($, /#, /- and @). Bugfixes -------- -- ``zos_copy`` - when creating the destination data set, the module would unnecessarily check if a data set is locked by another process. The module no longer performs this check when it creates the data set. +- ``zos_copy`` + + - Fixes the issue that prevents the module from automatically computing member names when copying a file into a PDS/E. The module now computes the member name when copying into a PDS/E. + - Fixes an issue that would perform an unnecessary check if a destination data set is locked for data sets the module created. The module only performs this check for destinations that are present. + +- ``zos_data_set`` - When checking if a data set is cataloged, module failed to account for exceptions which occurred during the LISTCAT. The module now raises an MVSCmdExecError if the return code from LISTCAT exceeds the determined threshold. +- ``zos_job_submit`` - Was not propagating any error types including UnicodeDecodeError, JSONDecodeError, TypeError, KeyError when encountered. The module now shares the error type (UnicodeDecodeError, JSONDecodeError, TypeError, KeyError) in the error message. +- ``zos_mvs_raw`` - The first character of each line in dd_output was missing. The module now includes the first character of each line. Availability ------------ @@ -87,28 +104,13 @@ Requirements ------------ The IBM z/OS core collection has several dependencies, please review the `z/OS core support matrix`_ to understand both the -controller and z/OS managed node dependencies. +control node and z/OS managed node dependencies. Known Issues ------------ - -- ``zos_job_submit`` - when setting 'location' to 'LOCAL' and not specifying the from and to encoding, the modules defaults are not read leaving the file in its original encoding; explicitly set the encodings instead of relying on the default. +- ``zos_job_submit`` - when setting 'location' to 'local' and not specifying the from and to encoding, the modules defaults are not read leaving the file in its original encoding; explicitly set the encodings instead of relying on the default. - ``zos_job_submit`` - when submitting JCL, the response value returned for **byte_count** is incorrect. - -- ``zos_job_submit``, ``zos_job_output``, ``zos_operator_action_query`` - encounters UTF-8 decoding errors when interacting with results that contain non-printable UTF-8 characters in the response. This has been addressed in this release and corrected with **ZOAU version 1.2.5.6** or later. - - - If the appropriate level of ZOAU can not be installed, some options are to: - - - Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters. - - Ignore module errors by using **ignore_errors:true** for a specific playbook task. - - If the error is resulting from a batch job, add **ignore_errors:true** to the task and capture the output into a registered variable to extract the - job ID with a regular expression. Then use ``zos_job_output`` to display the DD without the non-printable character such as the DD **JESMSGLG**. - - If the error is the result of a batch job, set option **return_output** to false so that no DDs are read which could contain the non-printable UTF-8 characters. - -- ``zos_data_set`` - An undocumented option **size** was defined in module **zos_data_set**, this has been removed to satisfy collection certification, use the intended and documented **space_primary** option. - -- In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, this is so that the collection can continue to maintain certified status. - +- ``zos_apf`` - When trying to remove a library that contains the '$' character in the name from APF(authorized program facility), operation will fail. Version 1.10.0 ============== @@ -228,6 +230,46 @@ Known Issues - In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, this is so that the collection can continue to maintain certified status. - Use of special characters (#, @, $, \- ) in different options like data set names and commands is not fully supported, some modules support them but is the user responsibility to escape them. Read each module documentation for further details. +Version 1.9.2 +============= + +Bugfixes +-------- + +- ``zos_copy`` - when creating the destination data set, the module would unnecessarily check if a data set is locked by another process. The module no longer performs this check when it creates the data set. + +Availability +------------ + +* `Automation Hub`_ +* `Galaxy`_ +* `GitHub`_ + +Requirements +------------ + +The IBM z/OS core collection has several dependencies, please review the `z/OS core support matrix`_ to understand both the +controller and z/OS managed node dependencies. + +Known Issues +------------ + +- ``zos_job_submit`` - when setting 'location' to 'LOCAL' and not specifying the from and to encoding, the modules defaults are not read leaving the file in its original encoding; explicitly set the encodings instead of relying on the default. +- ``zos_job_submit`` - when submitting JCL, the response value returned for **byte_count** is incorrect. + +- ``zos_job_submit``, ``zos_job_output``, ``zos_operator_action_query`` - encounters UTF-8 decoding errors when interacting with results that contain non-printable UTF-8 characters in the response. This has been addressed in this release and corrected with **ZOAU version 1.2.5.6** or later. + + - If the appropriate level of ZOAU can not be installed, some options are to: + + - Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters. + - Ignore module errors by using **ignore_errors:true** for a specific playbook task. + - If the error is resulting from a batch job, add **ignore_errors:true** to the task and capture the output into a registered variable to extract the + job ID with a regular expression. Then use ``zos_job_output`` to display the DD without the non-printable character such as the DD **JESMSGLG**. + - If the error is the result of a batch job, set option **return_output** to false so that no DDs are read which could contain the non-printable UTF-8 characters. + +- ``zos_data_set`` - An undocumented option **size** was defined in module **zos_data_set**, this has been removed to satisfy collection certification, use the intended and documented **space_primary** option. + +- In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, this is so that the collection can continue to maintain certified status. Version 1.9.1 ============= diff --git a/_sources/ibm_zos_core/docs/source/resources/releases_maintenance.rst.txt b/_sources/ibm_zos_core/docs/source/resources/releases_maintenance.rst.txt index df4ee675..a9d30942 100644 --- a/_sources/ibm_zos_core/docs/source/resources/releases_maintenance.rst.txt +++ b/_sources/ibm_zos_core/docs/source/resources/releases_maintenance.rst.txt @@ -89,7 +89,7 @@ The z/OS managed node includes several shells, currently the only supported shel +---------+----------------------------+---------------------------------------------------+---------------+---------------+ | Version | Controller | Managed Node | GA | End of Life | +=========+============================+===================================================+===============+===============+ -| 1.11.x |- `ansible-core`_ >=2.15.x |- `z/OS`_ V2R4 - V2Rx | In preview | TBD | +| 1.11.x |- `ansible-core`_ >=2.15.x |- `z/OS`_ V2R4 - V2Rx | 1 Oct 2024 | 1 Oct 2026 | | |- `Ansible`_ >=8.0.x |- `z/OS shell`_ | | | | |- `AAP`_ >=2.4 |- IBM `Open Enterprise SDK for Python`_ | | | | | |- IBM `Z Open Automation Utilities`_ >=1.3.1 | | | diff --git a/ibm_zos_core/docs/source/modules/zos_archive.html b/ibm_zos_core/docs/source/modules/zos_archive.html index 63e14820..ef4e607c 100644 --- a/ibm_zos_core/docs/source/modules/zos_archive.html +++ b/ibm_zos_core/docs/source/modules/zos_archive.html @@ -537,7 +537,7 @@
The location can be a UNIX System Services (USS) file, PS (sequential data set), member of a PDS or PDSE, PDS, PDSE.
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).
The location can be a UNIX System Services (USS) file, PS (sequential data set), member of a PDS or PDSE, PDS, PDSE.
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).
USS file paths should be absolute paths.
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).
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.
Mutually exclusive with 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.
zos_apf
- Added support that auto-escapes ‘library’ names containing symbols.
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 @.
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 @.
zos_blockinfile
- Added support for GDG and GDS relative name notation to specify a data set. And backup in new generations. Added support for data set names with special characters like $, /#, /- and @.
zos_copy
- Added support for copying from and copying to generation data sets (GDS) and generation data groups (GDG) including using a GDS for backup.
zos_data_set
- Added support for GDG and GDS relative name notation to create, delete, catalog and uncatalog a data set. Added support for data set names with special characters like $, /#, /- and @.
zos_encode
- Added support for converting the encodings of generation data sets (GDS). Also added support to backup into GDS.
zos_fetch
- Added support for fetching generation data groups (GDG) and generation data sets (GDS). Added support for specifying data set names with special characters like $, /#, /- and @.
zos_find
- Added support for finding generation data groups (GDG) and generation data sets (GDS). Added support for specifying data set names with special characters like $, /#, /- and @.
zos_apf
- Added support for data set names (libraries) with special characters ($, /#, /- and @).
zos_archive
+++
+- +
Added support for GDG and GDS relative name notation to archive data sets.
- +
Added support for data set names with special characters ($, /#, /- and @).
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 ($, /#, /- and @).
zos_blockinfile
+++
+- +
Added support for GDG and GDS relative name notation to specify a data set. And backup in new generations.
- +
Added support for data set names with special characters ($, /#, /- and @).
zos_copy
+++
+- +
Added support for copying from and to generation data sets (GDS) and generation data groups (GDG) including using a GDS for backup.
- +
Added support for data set names with special characters ($, /#, /- and @).
zos_data_set
+++
+- +
Added support for GDG and GDS relative name notation to create, delete, catalog and uncatalog a data set.
- +
Added support for data set names with special characters ($, /#, /- and @).
zos_encode
+++
+- +
Added support for converting the encodings of generation data sets (GDS).
- +
Added support for data set names with special characters ($, /#, /- and @).
zos_fetch
+++
+- +
Added support for fetching generation data groups (GDG) and generation data sets (GDS).
- +
Added support for data set names with special characters ($, /#, /- and @).
zos_find
+++
+- +
Added support for finding generation data groups (GDG) and generation data sets (GDS).
- +
Added support for data set names with special characters ($, /#, /- and @).
zos_job_submit
++
Improved the mechanism for copying to remote systems by removing the use of deepcopy, which had previously resulted in the module failing on some systems.
- +
Added support for running JCL stored in generation data groups (GDG) and generation data sets (GDS).
- +
Added support for data set names with special characters ($, /#, /- and @).
zos_lineinfile
++
- +
Added support for GDG and GDS relative name notation to specify the target data set and to backup into new generations.
Added support for data set names with special characters ($, /#, /- and @).
zos_lineinfile
- Added support for GDG and GDS relative name notation to specify the target data set and to backup into new generations. Added support for data set names with special characters like $, /#, /- and @.
zos_mount
- Added support for data set names with special characters ($, /#, /- and @).
zos_mvs_raw
- Added support for GDG and GDS relative name notation to specify data set names. Added support for data set names with special characters like $, /#, /- and @.
zos_mvs_raw
+++
+- +
Added support for GDG and GDS relative name notation to specify data set names.
- +
Added support for data set names with special characters ($, /#, /- and @).
zos_script
- Improved the mechanism for copying to remote systems by removing the use of deepcopy, which had previously resulted in the module failing on some systems.
zos_tso_command
- Added support for using GDG and GDS relative name notation in running TSO commands. Added support for data set names with special characters like $, /#, /- and @.
zos_tso_command
+++
+- +
Added support for using GDG and GDS relative name notation in running TSO commands.
- +
Added support for data set names with special characters ($, /#, /- and @).
zos_unarchive
-
Added support for data set names with special characters like $, /#, /- and @.
- +
Improved the mechanism for copying to remote systems by removing the use of deepcopy, which had previously resulted in the module failing on some systems.
Added support for data set names with special characters ($, /#, /- and @).
--
- -
a regression in version 1.4.0 made the module stop automatically computing member names when copying a single file into a PDS/E. Fix now lets a user copy a single file into a PDS/E without adding a member in the dest option.
- +
module would use opercmd to check if a non existent destination data set is locked. Fix now only checks if the destination is already present.
- +
Fixes the issue that prevents the module from automatically computing member names when copying a file into a PDS/E. The module now computes the member name when copying into a PDS/E.
Fixes an issue that would perform an unnecessary check if a destination data set is locked for data sets the module created. The module only performs this check for destinations that are present.
zos_data_set
- When checking if a data set is cataloged, module failed to account for exceptions which occurred during the LISTCAT. The fix now raises an MVSCmdExecError if the return code from LISTCAT is too high.
zos_job_submit
- The module was not propagating any error types including UnicodeDecodeError, JSONDecodeError, TypeError, KeyError when encountered. The fix now shares the type error in the error message.
zos_mvs_raw
- The first character of each line in dd_output was missing. The fix now includes the first character of each line.
zos_data_set
- When checking if a data set is cataloged, module failed to account for exceptions which occurred during the LISTCAT. The module now raises an MVSCmdExecError if the return code from LISTCAT exceeds the determined threshold.
zos_job_submit
- Was not propagating any error types including UnicodeDecodeError, JSONDecodeError, TypeError, KeyError when encountered. The module now shares the error type (UnicodeDecodeError, JSONDecodeError, TypeError, KeyError) in the error message.
zos_mvs_raw
- The first character of each line in dd_output was missing. The module now includes the first character of each line.
The IBM z/OS core collection has several dependencies, please review the z/OS core support matrix to understand both the -controller and z/OS managed node dependencies.
+control node and z/OS managed node dependencies.zos_job_submit
- when submitting JCL, the response value returned for byte_count is incorrect.
zos_apf
- When trying to remove a library that contains the ‘$’ character in the name from APF(authorized program facility), operation will fail.
In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, this is so that the collection can continue to maintain certified status.
zos_copy
- when creating the destination data set, the module would unnecessarily check if a data set is locked by another process. The module no longer performs this check when it creates the data set.
The IBM z/OS core collection has several dependencies, please review the z/OS core support matrix to understand both the -controller and z/OS managed node dependencies.
-zos_job_submit
- when setting ‘location’ to ‘LOCAL’ and not specifying the from and to encoding, the modules defaults are not read leaving the file in its original encoding; explicitly set the encodings instead of relying on the default.
zos_job_submit
- when submitting JCL, the response value returned for byte_count is incorrect.
zos_job_submit
, zos_job_output
, zos_operator_action_query
- encounters UTF-8 decoding errors when interacting with results that contain non-printable UTF-8 characters in the response. This has been addressed in this release and corrected with ZOAU version 1.2.5.6 or later.
---
-- -
If the appropriate level of ZOAU can not be installed, some options are to:
----
-- -
Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters.
- -
Ignore module errors by using ignore_errors:true for a specific playbook task.
- -
If the error is resulting from a batch job, add ignore_errors:true to the task and capture the output into a registered variable to extract the -job ID with a regular expression. Then use
zos_job_output
to display the DD without the non-printable character such as the DD JESMSGLG.- -
If the error is the result of a batch job, set option return_output to false so that no DDs are read which could contain the non-printable UTF-8 characters.
zos_data_set
- An undocumented option size was defined in module zos_data_set, this has been removed to satisfy collection certification, use the intended and documented space_primary option.
In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, this is so that the collection can continue to maintain certified status.
zos_apf
- Enhanced error messages when an exception is caught.
zos_backup_restore
- Added option tmp_hlq to the user module to override the default high level qualifier (HLQ) for temporary and backup data sets.
zos_copy
- Documented module options group and owner.
zos_apf
- Option list previously only returned one data set, now it returns a list of retrieved data sets.
zos_blockinfile
- Option block when containing double double quotation marks results in a task failure (failed=True); now the module handles this case to avoid failure.
The IBM z/OS core collection has several dependencies, please review the z/OS core support matrix to understand both the controller and z/OS managed node dependencies.
zos_job_submit
- when setting ‘location’ to ‘local’ and not specifying the from and to encoding, the modules defaults are not read leaving the file in its original encoding; explicitly set the encodings instead of relying on the default.
zos_job_submit
- when submitting JCL, the response value returned for byte_count is incorrect.
zos_copy
- when creating the destination data set, the module would unnecessarily check if a data set is locked by another process. The module no longer performs this check when it creates the data set.
The IBM z/OS core collection has several dependencies, please review the z/OS core support matrix to understand both the +controller and z/OS managed node dependencies.
+zos_job_submit
- when setting ‘location’ to ‘LOCAL’ and not specifying the from and to encoding, the modules defaults are not read leaving the file in its original encoding; explicitly set the encodings instead of relying on the default.
zos_job_submit
- when submitting JCL, the response value returned for byte_count is incorrect.
zos_job_submit
, zos_job_output
, zos_operator_action_query
- encounters UTF-8 decoding errors when interacting with results that contain non-printable UTF-8 characters in the response. This has been addressed in this release and corrected with ZOAU version 1.2.5.6 or later.
+++
+- +
If the appropriate level of ZOAU can not be installed, some options are to:
++++
+- +
Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters.
- +
Ignore module errors by using ignore_errors:true for a specific playbook task.
- +
If the error is resulting from a batch job, add ignore_errors:true to the task and capture the output into a registered variable to extract the +job ID with a regular expression. Then use
zos_job_output
to display the DD without the non-printable character such as the DD JESMSGLG.- +
If the error is the result of a batch job, set option return_output to false so that no DDs are read which could contain the non-printable UTF-8 characters.
zos_data_set
- An undocumented option size was defined in module zos_data_set, this has been removed to satisfy collection certification, use the intended and documented space_primary option.
In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, this is so that the collection can continue to maintain certified status.
In preview
TBD
1 Oct 2024
1 Oct 2026
1.10.x