Skip to content

Commit 5de7b41

Browse files
Merge pull request #2394 from ansible-collections/staging-v1.16.0-beta.1
Merge v1.16.0-beta.1 release into main
2 parents 6e7574b + 5643909 commit 5de7b41

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

64 files changed

+5551
-440
lines changed

.gitignore

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -258,7 +258,6 @@ shell_exploits.txt
258258
importer_result.json
259259
ac
260260
scripts/
261-
ansible.cfg
262261

263262
################################################################################
264263
# Debugging .ignore, if you want to know why a particular file is being ignored

.secrets.baseline

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
{
2+
"exclude": {
3+
"files": "zos_mvs_raw.rst|^.secrets.baseline$",
4+
"lines": null
5+
},
6+
"generated_at": "2025-10-21T16:20:27Z",
7+
"plugins_used": [
8+
{
9+
"name": "AWSKeyDetector"
10+
},
11+
{
12+
"name": "ArtifactoryDetector"
13+
},
14+
{
15+
"name": "AzureStorageKeyDetector"
16+
},
17+
{
18+
"base64_limit": 4.5,
19+
"name": "Base64HighEntropyString"
20+
},
21+
{
22+
"name": "BasicAuthDetector"
23+
},
24+
{
25+
"name": "BoxDetector"
26+
},
27+
{
28+
"name": "CloudantDetector"
29+
},
30+
{
31+
"ghe_instance": "github.ibm.com",
32+
"name": "GheDetector"
33+
},
34+
{
35+
"name": "GitHubTokenDetector"
36+
},
37+
{
38+
"hex_limit": 3,
39+
"name": "HexHighEntropyString"
40+
},
41+
{
42+
"name": "IbmCloudIamDetector"
43+
},
44+
{
45+
"name": "IbmCosHmacDetector"
46+
},
47+
{
48+
"name": "JwtTokenDetector"
49+
},
50+
{
51+
"keyword_exclude": null,
52+
"name": "KeywordDetector"
53+
},
54+
{
55+
"name": "MailchimpDetector"
56+
},
57+
{
58+
"name": "NpmDetector"
59+
},
60+
{
61+
"name": "PrivateKeyDetector"
62+
},
63+
{
64+
"name": "SlackDetector"
65+
},
66+
{
67+
"name": "SoftlayerDetector"
68+
},
69+
{
70+
"name": "SquareOAuthDetector"
71+
},
72+
{
73+
"name": "StripeDetector"
74+
},
75+
{
76+
"name": "TwilioKeyDetector"
77+
}
78+
],
79+
"results": {},
80+
"version": "0.13.1+ibm.64.dss",
81+
"word_list": {
82+
"file": null,
83+
"hash": null
84+
}
85+
}

CHANGELOG.rst

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,57 @@ ibm.ibm\_zos\_core Release Notes
44

55
.. contents:: Topics
66

7+
v1.16.0-beta.1
8+
==============
9+
10+
Release Summary
11+
---------------
12+
13+
Release Date: '2025-10-31'
14+
This changelog describes all changes made to the modules and plugins included
15+
in this collection. The release date is the date the changelog is created.
16+
For additional details such as required dependencies and availability review
17+
the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__
18+
19+
Minor Changes
20+
-------------
21+
22+
- zos_apf - Adds new alias ``target`` for ``data_set_name`` and a warning message that it will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
23+
- zos_archive - Adds new alias ``adrdssu`` for ``use_adrdssu`` and a warning message that it will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
24+
- zos_archive - Adds new alias ``options`` for ``format_options`` and a warning message that it will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
25+
- zos_archive - Adds new alias ``type`` for ``name`` and a warning message that it will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
26+
- zos_backup_restore - Adds ``compress`` option to enable compression of partitioned data sets using hardware compression if available. (https://github.com/ansible-collections/ibm_zos_core/pull/2260)
27+
- zos_backup_restore - Adds ``terse`` option to modify the behavior of executing an AMATERSE step to compress the temporary data set for the backup. (https://github.com/ansible-collections/ibm_zos_core/pull/2260)
28+
- zos_copy - Adds a better error message that gives user a hint that copy issue can be due to a GDS part of ``src`` GDG is being used by another process. (https://github.com/ansible-collections/ibm_zos_core/pull/2220)
29+
- zos_copy - Adds new alias ``binary`` for ``is_binary`` and warning message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
30+
- zos_copy - Adds new alias ``replace`` for ``force`` and a warning message that it will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
31+
- zos_data_set - Adds `noscratch` option to allow uncataloging a data set without deleting it from the volume's VTOC. (https://github.com/ansible-collections/ibm_zos_core/pull/2202)
32+
- zos_data_set - Enhances error messages when creating a Generation Data Group fails. (https://github.com/ansible-collections/ibm_zos_core/pull/2212)
33+
- zos_data_set - Enhances error messages when deleting a Generation Data Group fails. (https://github.com/ansible-collections/ibm_zos_core/pull/2255)
34+
- zos_data_set - Merged `noscratch` functionality into the `scratch` option. This allows uncataloging a data set without deleting it from the volume's VTOC (https://github.com/ansible-collections/ibm_zos_core/pull/2268).
35+
- zos_fetch - Adds new alias ``binary`` for ``is_binary`` and warning message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
36+
- zos_job_output - Adds new alias ``dd_name`` for ``ddname`` and warning message that will be alias on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
37+
- zos_job_output - Adds support to query SYSIN DDs from a job with new option input. (https://github.com/ansible-collections/ibm_zos_core/pull/2207)
38+
- zos_job_submit - Adds new alias ``wait_time`` for ``wait_time_s`` and warning message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
39+
- zos_job_submit - Adds support for jobs with TYPRUN=JCLHOLD and TYPRUN=HOLD. (https://github.com/ansible-collections/ibm_zos_core/pull/2229).
40+
- zos_mount - Adds new alias ``marker`` for ``comment`` and warning message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
41+
- zos_mount - Adds new alias ``name`` for ``data_store`` and warning message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
42+
- zos_mvs_raw - Adds new `raw` option under ``dd_data_set`` that lets the MVS program create datasets with its own DCB attributes without the user having to specify them. (https://github.com/ansible-collections/ibm_zos_core/pull/2341).
43+
- zos_operator - Adds new alias ``wait_time`` for ``wait_time_s`` and warning message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
44+
- zos_unarchive - Adds new alias ``adrdssu`` for ``use_adrdssu`` and warning message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
45+
- zos_unarchive - Adds new alias ``options`` for ``format_options`` and warning message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
46+
- zos_unarchive - Adds new alias ``type`` for ``name`` and warning message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
47+
48+
Bugfixes
49+
--------
50+
51+
- zos_backup_restore - Module documentation stated that default ``space_type`` for a backup was ``m`` but module would use bytes instead. Fix now uses the correct default space type. (https://github.com/ansible-collections/ibm_zos_core/pull/2236).
52+
53+
New Modules
54+
-----------
55+
56+
- ibm.ibm_zos_core.zos_started_task - Perform operations on started tasks.
57+
758
v1.15.0
859
=======
960

README.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,9 @@ The **IBM z/OS core** collection enables Ansible to interact with z/OS Data Sets
44

55
## Description
66

7-
The **IBM z/OS core** collection is part of the **Red Hat® Ansible Certified Content for IBM Z®** offering that brings Ansible automation to IBM Z®. This collection brings forward the possibility to manage batch jobs, perform program authorizations, run operator operations, and execute both JES and MVS commands as well as execute shell, python, and REXX scripts. It supports data set creation, searching, copying, fetching, and encoding. It provides both archiving and unarchiving of data sets, initializing volumes, resizing aggregates, performing backups and supports Jinja templating.
7+
The **IBM z/OS core** collection is part of the **Red Hat® Ansible Certified Content for IBM Z®** offering that brings Ansible automation to IBM Z®. This collection brings forward the possibility to manage batch jobs, perform program authorizations, run operator operations, and execute both JES and MVS commands as well as execute shell, python, and REXX scripts. It supports data set creation, searching, copying, fetching, and encoding. It provides both archiving and unarchiving of data sets, performing backups and supports Jinja templating.
8+
9+
It can manage other z/OS core operations like initializing volumes, resizing aggregates; starting, modifying, stopping and canceling started tasks.
810

911
<br/>System programmers can enable pipelines to setup, tear down and deploy applications while system administrators can automate time consuming repetitive tasks inevitably freeing up their time. New z/OS users can find comfort in Ansible's familiarity and expedite their proficiency in record time.
1012

ansible.cfg

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
################################################################################
2+
# Copyright (c) IBM Corporation 2020, 2025
3+
################################################################################
4+
5+
################################################################################
6+
# For for on ansible.cfg options see:
7+
# https://docs.ansible.com/ansible/latest/reference_appendices/config.html
8+
#
9+
# For a full sample see:
10+
# https://github.com/ansible/ansible/blob/devel/examples/ansible.cfg
11+
#
12+
# Note:
13+
# Examples of some options often used:
14+
# remote_temp - The temporary directory Ansible uses to transfer files onto
15+
# the controller. Default is `/.ansible/tmp`
16+
# ansible_port - The connection port number Ansible uses to connect to the
17+
# target; configure the target if is not using default SSH
18+
# port 22
19+
# debug - Toggles debug output in Ansible. This is very verbose and can
20+
# hinder multiprocessing. Debug output can also include secret
21+
# information despite no_log settings being enabled, which means debug
22+
# mode should not be used in production. Optionally, ad-hoc you can
23+
# use ANSIBLE_DEBUG=1
24+
# verbosity - Sets the default verbosity, equivalent to the number of -v's
25+
# passed in the command line.
26+
# i.e. 0|1|2|3|4 == None|-v|-vv|-vvv|-vvvv
27+
################################################################################
28+
29+
[defaults]
30+
forks = 25
31+
action_plugins=~/.ansible/collections/ansible_collections/ibm/ibm_zos_core/plugins/action
32+
# remote_tmp = /u/ansible/tmp
33+
# remote_port = 22
34+
# debug = True
35+
# verbosity = 1
36+
37+
[ssh_connection]
38+
pipelining = True
39+
40+
[connection]
41+
pipelining = True
42+
43+
[colors]
44+
verbose = green
45+
46+
[persistent_connection]
47+
command_timeout = 60

branch_protection_rules.json

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
[{
2+
"type": "branch-protection",
3+
"name": "code-review",
4+
"params": {
5+
"checks": [
6+
"tekton/code-branch-protection",
7+
"tekton/code-unit-tests",
8+
"tekton/code-vulnerability-scan",
9+
"tekton/code-detect-secrets"
10+
]
11+
}
12+
}]

changelogs/.plugin-cache.yaml

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -120,6 +120,11 @@ plugins:
120120
name: zos_script
121121
namespace: ''
122122
version_added: 1.8.0
123+
zos_started_task:
124+
description: Perform operations on started tasks.
125+
name: zos_started_task
126+
namespace: ''
127+
version_added: 1.16.0
123128
zos_stat:
124129
description: Retrieve facts from MVS data sets, USS files, aggregates and generation
125130
data groups
@@ -151,4 +156,4 @@ plugins:
151156
strategy: {}
152157
test: {}
153158
vars: {}
154-
version: 1.15.0
159+
version: 1.16.0-beta.1

changelogs/changelog.yaml

Lines changed: 94 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -985,6 +985,100 @@ releases:
985985
name: zos_replace
986986
namespace: ''
987987
release_date: '2025-08-05'
988+
1.16.0-beta.1:
989+
changes:
990+
bugfixes:
991+
- zos_backup_restore - Module documentation stated that default ``space_type``
992+
for a backup was ``m`` but module would use bytes instead. Fix now uses the
993+
correct default space type. (https://github.com/ansible-collections/ibm_zos_core/pull/2236).
994+
minor_changes:
995+
- zos_apf - Adds new alias ``target`` for ``data_set_name`` and a warning message
996+
that it will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
997+
- zos_archive - Adds new alias ``adrdssu`` for ``use_adrdssu`` and a warning
998+
message that it will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
999+
- zos_archive - Adds new alias ``options`` for ``format_options`` and a warning
1000+
message that it will be deprecated on 2.0.0.
1001+
- zos_archive - Adds new alias ``type`` for ``name`` and a warning message that
1002+
it will be deprecated on 2.0.0.
1003+
- zos_backup_restore - Adds ``compress`` option to enable compression of partitioned
1004+
data sets using hardware compression if available. (https://github.com/ansible-collections/ibm_zos_core/pull/2260)
1005+
- zos_backup_restore - Adds ``terse`` option to modify the behavior of executing
1006+
an AMATERSE step to compress the temporary data set for the backup. (https://github.com/ansible-collections/ibm_zos_core/pull/2260)
1007+
- zos_copy - Adds a better error message that gives user a hint that copy issue
1008+
can be due to a GDS part of ``src`` GDG is being used by another process.
1009+
(https://github.com/ansible-collections/ibm_zos_core/pull/2220)
1010+
- zos_copy - Adds new alias ``binary`` for ``is_binary`` and warning message
1011+
that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
1012+
- zos_copy - Adds new alias ``replace`` for ``force`` and a warning message
1013+
that it will be deprecated on 2.0.0.
1014+
- zos_data_set - Adds `noscratch` option to allow uncataloging a data set without
1015+
deleting it from the volume's VTOC. (https://github.com/ansible-collections/ibm_zos_core/pull/2202)
1016+
- zos_data_set - Enhances error messages when creating a Generation Data Group
1017+
fails. (https://github.com/ansible-collections/ibm_zos_core/pull/2212)
1018+
- zos_data_set - Enhances error messages when deleting a Generation Data Group
1019+
fails. (https://github.com/ansible-collections/ibm_zos_core/pull/2255)
1020+
- zos_data_set - Merged `noscratch` functionality into the `scratch` option.
1021+
This allows uncataloging a data set without deleting it from the volume's
1022+
VTOC (https://github.com/ansible-collections/ibm_zos_core/pull/2268).
1023+
- zos_fetch - Adds new alias ``binary`` for ``is_binary`` and warning message
1024+
that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
1025+
- zos_job_output - Adds new alias ``dd_name`` for ``ddname`` and warning message
1026+
that will be alias on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
1027+
- zos_job_output - Adds support to query SYSIN DDs from a job with new option
1028+
input. (https://github.com/ansible-collections/ibm_zos_core/pull/2207)
1029+
- zos_job_submit - Adds new alias ``wait_time`` for ``wait_time_s`` and warning
1030+
message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
1031+
- zos_job_submit - Adds support for jobs with TYPRUN=JCLHOLD and TYPRUN=HOLD.
1032+
(https://github.com/ansible-collections/ibm_zos_core/pull/2229).
1033+
- zos_mount - Adds new alias ``marker`` for ``comment`` and warning message
1034+
that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
1035+
- zos_mount - Adds new alias ``name`` for ``data_store`` and warning message
1036+
that will be deprecated on 2.0.0.
1037+
- zos_mvs_raw - Adds new `raw` option under ``dd_data_set`` that lets the MVS
1038+
program create datasets with its own DCB attributes without the user having
1039+
to specify them. (https://github.com/ansible-collections/ibm_zos_core/pull/2341).
1040+
- zos_operator - Adds new alias ``wait_time`` for ``wait_time_s`` and warning
1041+
message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
1042+
- zos_unarchive - Adds new alias ``adrdssu`` for ``use_adrdssu`` and warning
1043+
message that will be deprecated on 2.0.0. (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
1044+
- zos_unarchive - Adds new alias ``options`` for ``format_options`` and warning
1045+
message that will be deprecated on 2.0.0.
1046+
- zos_unarchive - Adds new alias ``type`` for ``name`` and warning message that
1047+
will be deprecated on 2.0.0.
1048+
release_summary: 'Release Date: ''2025-10-31''
1049+
1050+
This changelog describes all changes made to the modules and plugins included
1051+
1052+
in this collection. The release date is the date the changelog is created.
1053+
1054+
For additional details such as required dependencies and availability review
1055+
1056+
the collections `release notes <https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html>`__'
1057+
fragments:
1058+
- 2202-zos_data_set-Support-noscratch-options.yml
1059+
- 2207-SYSIN-support-zos_job_output.yml
1060+
- 2212-data_set-Enhance-error-message.yml
1061+
- 2213-test-case-conditional-failure-2-19.yml
1062+
- 2220-zos_copy-better-error-message-GDG-copy-issue.yml
1063+
- 2229-job-typrun-support.yml
1064+
- 2236-space-type-default-zos_backup_restore.yml
1065+
- 2241-zos_zfs_resize-ansible2.18fix.yml
1066+
- 2251-zos_job_output-input-sysin_dd-rename.yml
1067+
- 2255-data_set-Enhance-error-message.yml
1068+
- 2258-zos_lineinfile-cleanup-file.yml
1069+
- 2260-zos_backup_restore-compression-bypass.yml
1070+
- 2265-stabilize-zos_archive-tests.yml
1071+
- 2268-zos_data_set-merge-noscratch-into-scratch-option.yml
1072+
- 2269-test_case_update_219.yml
1073+
- 2341-zos_mvs_raw-Add-raw-option-for-generic-dcb-selection.yml
1074+
- 2355-zos_backup_restore-dzip-command-failure.yml
1075+
- 2553-Add_aliases_and_deprecation_messages_for_new_version.yml
1076+
- v1.16.0-beta.1_summary.yml
1077+
modules:
1078+
- description: Perform operations on started tasks.
1079+
name: zos_started_task
1080+
namespace: ''
1081+
release_date: '2025-10-27'
9881082
1.2.1:
9891083
changes:
9901084
bugfixes:

docs/source/life-cycle.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,8 @@ its critical dates, and which type of support it's currently eligible for.
2727
+------------+----------------+-----------------------+------------------+-------------------+-------------------------+
2828
| Version | Status | Changelogs | GA Date | EOL Date | Life Cycle Phase |
2929
+============+================+=======================+==================+===================+=========================+
30+
| 1.16.x | In preview | `1.16.x changelogs`_ | TBD | TBD | `Beta phase` |
31+
+------------+----------------+-----------------------+------------------+-------------------+-------------------------+
3032
| 1.15.x | Released | `1.15.x changelogs`_ | 30 September 2025| 30 September 2027 | `Full support`_ |
3133
+------------+----------------+-----------------------+------------------+-------------------+-------------------------+
3234
| 1.14.x | Released | `1.14.x changelogs`_ | 30 June 2025 | 30 June 2027 | `Full support`_ |
@@ -43,6 +45,8 @@ its critical dates, and which type of support it's currently eligible for.
4345
.. .............................................................................
4446
.. Global Links
4547
.. .............................................................................
48+
.. _1.16.x changelogs:
49+
https://github.com/ansible-collections/ibm_zos_core/blob/v1.16.0-beta.1/CHANGELOG.rst
4650
.. _1.15.x changelogs:
4751
https://github.com/ansible-collections/ibm_zos_core/blob/v1.15.0/CHANGELOG.rst
4852
.. _1.14.x changelogs:

0 commit comments

Comments
 (0)