Merge pull request #2063 from ansible-collections/rel-tasks-v1.14.0-beta.1

[v1.14.0-beta.1] Release tasks for v1.14.0 beta.1

Author: fernandofloresg

.ansible-lint

@@ -1,5 +1,5 @@
 ################################################################################
-# Copyright (c) IBM Corporation 2025
+# Copyright (c) IBM Corporation 2024, 2025
 ################################################################################
 # For additonal doc, see https://ansible.readthedocs.io/projects/lint/configuring/
 exclude_paths:

.github/ISSUE_TEMPLATE/bug_issue.yml

@@ -2,8 +2,6 @@ name: Report a bug
 description: Request that a bug be reviewed. Complete all required fields.
 title: "[Bug] Enter description"
 labels: ["Bug", "Needs Triage"]
-title: "[Bug] Enter description"
-labels: ["Bug", "Needs Triage"]
 assignees:
   - IBMAnsibleHelper
 body:
@@ -35,6 +33,8 @@ body:
       description: Which version of z/OS Ansible core collection are you using. If you are unsure, review the [documentation](https://ibm.github.io/z_ansible_collections_doc/faqs/faqs.html#how-do-i-update-a-collection-to-the-latest-version).
       multiple: false
       options:
+        - v1.13.0
+        - v1.13.0-beta.1
         - v1.12.0
         - v1.12.0-beta.1
         - v1.11.1

.github/ISSUE_TEMPLATE/collaboration_issue.yml

@@ -42,6 +42,8 @@ body:
       description: Which version of z/OS Ansible core collection are you using. If you are unsure, review the [documentation](https://ibm.github.io/z_ansible_collections_doc/faqs/faqs.html#how-do-i-update-a-collection-to-the-latest-version).
       multiple: false
       options:
+        - v1.13.0
+        - v1.13.0-beta.1
         - v1.12.0
         - v1.12.0-beta.1
         - v1.11.1

.github/ISSUE_TEMPLATE/doc_issue.yml

@@ -34,6 +34,8 @@ body:
       description: Which version of z/OS Ansible core collection are you using. If you are unsure, review the [documentation](https://ibm.github.io/z_ansible_collections_doc/faqs/faqs.html#how-do-i-update-a-collection-to-the-latest-version).
       multiple: false
       options:
+        - v1.13.0
+        - v1.13.0-beta.1
         - v1.12.0
         - v1.12.0-beta.1
         - v1.11.1

CHANGELOG.rst

@@ -4,6 +4,59 @@ ibm.ibm\_zos\_core Release Notes
 
 .. contents:: Topics
 
+v1.14.0-beta.1
+==============
+
+Release Summary
+---------------
+
+Release Date: '2025-04-30'
+This changelog describes all changes made to the modules and plugins included
+in this collection. The release date is the date the changelog is created.
+For additional details such as required dependencies and availability review
+the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__
+
+Minor Changes
+-------------
+
+- zos_copy - Adds ``large`` as a choice for ``type`` in ``dest_data_set``. (https://github.com/ansible-collections/ibm_zos_core/pull/1938)
+- zos_copy - Adds logging of Jinja rendered template content when `use_template` is true and verbosity level `-vvv` is used. (https://github.com/ansible-collections/ibm_zos_core/pull/1968).
+- zos_copy - Adds support for copying in asynchronous mode inside playbooks. (https://github.com/ansible-collections/ibm_zos_core/pull/1953).
+- zos_copy - Removes the need to allow READ access to MVS.MCSOPER.ZOAU to execute the module by changing how the module checks if a data set is locked. (https://github.com/ansible-collections/ibm_zos_core/pull/1917).
+- zos_job_output - Add execution_time return value in the modules response. (https://github.com/ansible-collections/ibm_zos_core/pull/1891).
+- zos_job_query - Add execution_time return value in the modules response. (https://github.com/ansible-collections/ibm_zos_core/pull/1891).
+- zos_job_query - Loads correct bytes size value for dds when using zoau 1.3.4 or later (https://github.com/ansible-collections/ibm_zos_core/pull/1868).
+- zos_job_query - System and Subsystem are now retrieved from JES. (https://github.com/ansible-collections/ibm_zos_core/pull/1900).
+- zos_job_submit -  Adds logging of Jinja rendered template content when `use_template` is true and verbosity level `-vvv` is used. (https://github.com/ansible-collections/ibm_zos_core/pull/1962).
+- zos_job_submit - Add execution_time return value in the modules response. (https://github.com/ansible-collections/ibm_zos_core/pull/1891).
+- zos_job_submit - Loads correct bytes size value for dds when using zoau 1.3.4 or later (https://github.com/ansible-collections/ibm_zos_core/pull/1868).
+- zos_script - Adds error message for when remote source does not exist. (https://github.com/ansible-collections/ibm_zos_core/pull/1894).
+- zos_script - Adds logging of Jinja rendered template content when `use_template` is true and verbosity level `-vvv` is used. (https://github.com/ansible-collections/ibm_zos_core/pull/1968).
+- zos_script - Adds support for running local and remote scripts in asynchronous mode inside playbooks. (https://github.com/ansible-collections/ibm_zos_core/pull/1934).
+- zos_script - Support automatic removal of carriage return line breaks [CR, CRLF] when copying local files to USS. (https://github.com/ansible-collections/ibm_zos_core/pull/1954).
+- zos_stat - Adds support to query data sets using their aliases. (https://github.com/ansible-collections/ibm_zos_core/pull/2048)
+- zos_unarchive - Adds support for unarchiving files in asynchronous mode inside playbooks. (https://github.com/ansible-collections/ibm_zos_core/pull/2020).
+- zos_zfs_resize - Adds validations for trace destination dataset used for trace verbose. (https://github.com/ansible-collections/ibm_zos_core/pull/1897).
+
+Bugfixes
+--------
+
+- zos_apf - When trying to add a library into the APF list that was already added, the module would fail. Fix now will not fail the module, and will inform the user that the library is already on the APF list. (https://github.com/ansible-collections/ibm_zos_core/pull/1893)
+- zos_copy - Previously, if the dataset name included special characters such as $, validation would fail when force_lock was false. This has been changed to allow the use of special characters when force_lock option is false. (https://github.com/ansible-collections/ibm_zos_core/pull/1908)
+- zos_copy - When ``asa_text`` was set to true at the same time as ``force_lock``, a copy would fail saying the destination was already in use. Fix now opens destination data sets up with disposition SHR when ``force_lock`` and ``asa_text`` are set to true. (https://github.com/ansible-collections/ibm_zos_core/pull/1941).
+- zos_copy - the carriage return characters were being removed from only first 1024 bytes of a file. Now fixed that issue to support removal of the carriage return characters from the complete file content if the file size is more than 1024 bytes. (https://github.com/ansible-collections/ibm_zos_core/pull/1954).
+- zos_data_set - Module would fail when trying to delete a non-existent Generation Data Group. Fix now provides a successful response with `changed=false`. (https://github.com/ansible-collections/ibm_zos_core/pull/1971).
+- zos_data_set - Module would fail with TypeError when trying to replace an existing GDG. Fix now allows to replacing a GDG. (https://github.com/ansible-collections/ibm_zos_core/pull/1964).
+- zos_job_output - When searching for a job name, module performed a '*' (find all), then filtered the results. Fix now asks for specific job name, making the return faster and more precise. (https://github.com/ansible-collections/ibm_zos_core/pull/1916).
+- zos_job_query - When searching for a job name, module performed a '*' (find all), then filtered the results. Fix now asks for specific job name, making the return faster and more precise. (https://github.com/ansible-collections/ibm_zos_core/pull/1916).
+- zos_job_submit - When searching for a job name, module performed a '*' (find all), then filtered the results. Fix now asks for specific job name, making the return faster and more precise. (https://github.com/ansible-collections/ibm_zos_core/pull/1916).
+- zos_mount - Module failed when using persistent option with a data set that contains non UTF-8 characters. Fix now can use a data set with non UTF-8 characters as data_store. (https://github.com/ansible-collections/ibm_zos_core/pull/1871).
+
+New Modules
+-----------
+
+- ibm.ibm_zos_core.zos_stat - Retrieve facts from MVS data sets, USS files, aggregates and generation data groups
+
 v1.13.0
 =======
 

README.md

@@ -135,7 +135,7 @@ All releases will meet the following test criteria.
 * ansible-core v2.15.x
 * Python 3.11.x
 * IBM Open Enterprise SDK for Python 3.12.x
-* IBM Z Open Automation Utilities (ZOAU) 1.3.3.x
+* IBM Z Open Automation Utilities (ZOAU) 1.3.4.x
 * z/OS V2R5
 
 ## Contributing

ac

@@ -1909,7 +1909,84 @@ venv_stop(){
     venv_pid=`ps -ef |grep $venv_tty | grep -v "grep" | grep "/bin/sh -i" | awk '{print $3}'`
     kill -9 $venv_pid > /dev/null 2>&1
 }
+#->venv-refresh:
+## Refresh managed virtual environments with the latest scripts
+## Usage: ac --refresh-env [--all] [--name <venv-name>]
+## Options:
+##     --all    - Refresh all environments
+##     --name   - Specific environment to refresh
+## Example:
+##  $ ac --refresh-env              # Refresh the active environment
+##  $ ac --refresh-env --all        # Refresh all environments
+##  $ ac --refresh-env=all        # Refresh all environments
+##  $ ac --refresh-env --name venv-2.18  # Refresh a specific environment (e.g., venv-2.18)
+##  $ ac --refresh-env=venv-2.18  # Refresh a specific environment (e.g., venv-2.18)
+venv_refresh() {
+    local raw_arg="$1"       # Value from --refresh-env=...
+    local all_flag="$2"      # --all option value
+    local name_arg="$3"      # --name option value
+    local mode
+    local env_name
+    local target_envs=()
+    local source_dir="${PWD}/scripts"
+
+    # Validate source files
+    local required_files=("profile.sh" "mounts.sh" "mounts.env")
+    for f in "${required_files[@]}"; do
+        [[ ! -f "${source_dir}/${f}" ]] && message_error "Missing source file: ${source_dir}/${f}" && exit_all
+    done
+
+    # Argument resolution priority: 1. = syntax 2. --all/--name flags
+    if [ -n "$raw_arg" ]; then
+        # Handle --refresh-env=value syntax
+        case "$raw_arg" in
+            all)
+                mode="all"
+                ;;
+            venv-*)
+                mode="named"
+                env_name="$raw_arg"
+                ;;
+            *)
+                message_error "Invalid refresh-env argument: $raw_arg"
+                exit_all
+                ;;
+        esac
+    elif [ "$all_flag" = "true" ]; then
+        mode="all"
+    elif [ -n "$name_arg" ]; then
+        mode="named"
+        env_name="$name_arg"
+    else
+        mode="active"
+    fi
+
+    # Mode execution
+    case "$mode" in
+        all)
+            for env in "${VENV_HOME_MANAGED}"/venv-*; do
+                [[ -d "$env" ]] && target_envs+=("$env")
+            done
+            [[ ${#target_envs[@]} -eq 0 ]] && message_error "No managed environments found" && exit_all
+            ;;
+        named)
+            [[ -z "$env_name" ]] && message_error "Environment name required" && exit_all
+            env=$(validate_venv "$env_name")
+            target_envs+=("$env")
+            ;;
+        active)
+            ensure_managed_venv_exists "--refresh-env"
+            target_envs+=("$VENV")
+            ;;
+    esac
 
+    # Perform file operations
+    for env in "${target_envs[@]}"; do
+        message "Refreshing: $(basename "$env")"
+        cp -v "${source_dir}/profile.sh" "${source_dir}/mounts.sh" "${source_dir}/mounts.env" "$env/"
+        chmod +x "$env/mounts.sh" "$env/profile.sh"
+    done
+}
 # ==============================================================================
 # Main arg parsing
 # ==============================================================================
@@ -2033,6 +2110,18 @@ while true; do
             ensure_managed_venv_exists $1
             option_submitted="--venv-stop"
             ;;
+      --refresh-env|--refresh-env=?*)           # command
+            ensure_managed_venv_exists $1
+            option_submitted="--refresh-env"
+
+            # Capture raw argument value if using = syntax
+            if [[ "$1" == *=* ]]; then
+                refresh_arg="${1#*=}"
+            else
+                refresh_arg=""
+            fi
+            ;;
+
       # End of main command list.
       # Start of command options.
       # Used by:
@@ -2383,4 +2472,6 @@ elif [ "$option_submitted" ] && [ "$option_submitted" = "--venv-start" ] ; then
     venv_start $name
 elif [ "$option_submitted" ] && [ "$option_submitted" = "--venv-stop" ] ; then
     venv_stop $name
+elif [ "$option_submitted" = "--refresh-env" ]; then
+    venv_refresh "$refresh_arg" "$all" "$name"
 fi

changelogs/.plugin-cache.yaml

@@ -115,6 +115,12 @@ plugins:
       name: zos_script
       namespace: ''
       version_added: 1.8.0
+    zos_stat:
+      description: Retrieve facts from MVS data sets, USS files, aggregates and generation
+        data groups
+      name: zos_stat
+      namespace: ''
+      version_added: 1.14.0
     zos_tso_command:
       description: Execute TSO commands
       name: zos_tso_command
@@ -130,9 +136,14 @@ plugins:
       name: zos_volume_init
       namespace: ''
       version_added: 1.6.0
+    zos_zfs_resize:
+      description: Resize a zfs data set.
+      name: zos_zfs_resize
+      namespace: ''
+      version_added: 1.13.0
   netconf: {}
   shell: {}
   strategy: {}
   test: {}
   vars: {}
-version: 1.12.0-beta.1
+version: 1.14.0-beta.1