From 82648b89bc26a5a76397d6ca4edf52750ea02313 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Tue, 9 Apr 2024 17:28:21 -0700 Subject: [PATCH 01/18] updates to initial set of playbooks Signed-off-by: Ketan Kelkar --- .../data_sets/copy_edit_submit/copy_edit_submit.yml | 8 +++----- .../data_sets/data_set_basics/data_set_basics.yml | 11 ++++++----- .../encoding/convert_encoding/convert_encoding.yml | 12 +++++++----- .../tso_commands/scripts/run_rexx_and_clist.yml | 6 +++--- zos_concepts/zos_script/zos_script.yml | 8 ++++---- 5 files changed, 23 insertions(+), 22 deletions(-) diff --git a/zos_concepts/data_sets/copy_edit_submit/copy_edit_submit.yml b/zos_concepts/data_sets/copy_edit_submit/copy_edit_submit.yml index 878a70a4b..958ca0aee 100644 --- a/zos_concepts/data_sets/copy_edit_submit/copy_edit_submit.yml +++ b/zos_concepts/data_sets/copy_edit_submit/copy_edit_submit.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2020, 2021 +# © Copyright IBM Corporation 2020, 2024 ############################################################################### ############################################################################### @@ -93,8 +93,7 @@ - name: "Submit the JCL {{ tmp_data_set }}(PSA)" zos_job_submit: src: "{{ tmp_data_set }}(PSA)" - location: DATA_SET - wait: true + location: data_set register: result_submit_psa - name: "Response for submitting JCL {{ tmp_data_set }}(PSA)" @@ -104,8 +103,7 @@ - name: "Submit the JCL {{ tmp_data_set }}(UPTIME)" zos_job_submit: src: "{{ tmp_data_set }}(UPTIME)" - location: DATA_SET - wait: true + location: data_set register: result_submit_uptime - name: "Response for submitting JCL {{ tmp_data_set }}(UPTIME)" diff --git a/zos_concepts/data_sets/data_set_basics/data_set_basics.yml b/zos_concepts/data_sets/data_set_basics/data_set_basics.yml index 3110db22f..03f3bdba0 100644 --- a/zos_concepts/data_sets/data_set_basics/data_set_basics.yml +++ b/zos_concepts/data_sets/data_set_basics/data_set_basics.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2020, 2021 +# © Copyright IBM Corporation 2020, 2024 ############################################################################### # This sample playbook demonstrates basic data set operations using modules # included in the Red Hat Ansible Certified Content for IBM Z core collection. @@ -85,7 +85,8 @@ replace: true format: fb record_length: 100 - size: 5M + space_primary: 5 + space_type: m register: result - name: Response for data set creation @@ -106,7 +107,6 @@ zos_copy: src: "{{ playbook_dir }}/files/HELLO.jcl" dest: "{{ tgt_tmp_dir }}/HELLO" - # remote_src: yes register: result - name: Response for populating USS file {{ tgt_tmp_dir }}/HELLO @@ -129,7 +129,8 @@ zos_data_set: name: "{{ pds_name }}" type: pds - size: 5M + space_primary: 5 + space_type: m format: fba record_length: 100 register: result @@ -141,7 +142,7 @@ - name: Remove the target PDS member if it exists, for idempotency. zos_data_set: name: "{{ pds_name }}(HELLO)" - type: MEMBER + type: member state: absent register: result diff --git a/zos_concepts/encoding/convert_encoding/convert_encoding.yml b/zos_concepts/encoding/convert_encoding/convert_encoding.yml index 27f638905..eef7a9021 100644 --- a/zos_concepts/encoding/convert_encoding/convert_encoding.yml +++ b/zos_concepts/encoding/convert_encoding/convert_encoding.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2020, 2021 +# © Copyright IBM Corporation 2020, 2024 ############################################################################### ############################################################################### @@ -96,8 +96,9 @@ zos_encode: src: "{{ tgt_tmp_dir }}/date.sh" dest: "{{ tgt_tmp_dir }}/date.sh" - from_encoding: ISO8859-1 - to_encoding: "{{ target_charset }}" + encoding: + from: ISO8859-1 + to: "{{ target_charset }}" backup: false register: result @@ -196,8 +197,9 @@ zos_encode: src: "{{ tgt_tmp_dir }}/encode/" dest: "{{ tgt_tmp_dir }}/encode/" - from_encoding: ISO8859-1 - to_encoding: "{{ target_charset }}" + encoding: + from: ISO8859-1 + to: "{{ target_charset }}" register: result - name: Response for encode files in {{ tgt_tmp_dir }}/encode/` from diff --git a/zos_concepts/tso_commands/scripts/run_rexx_and_clist.yml b/zos_concepts/tso_commands/scripts/run_rexx_and_clist.yml index 997f8a924..ab89e827b 100644 --- a/zos_concepts/tso_commands/scripts/run_rexx_and_clist.yml +++ b/zos_concepts/tso_commands/scripts/run_rexx_and_clist.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2023 +# © Copyright IBM Corporation 2023, 2024 ############################################################################### ############################################################################### @@ -40,7 +40,7 @@ block: - name: Copy file to a new data set. ibm.ibm_zos_core.zos_copy: - src: ./files/DSINFO + src: "{{ playbook_dir }}/files/DSINFO" dest: "{{ script_data_set }}" remote_src: false @@ -58,7 +58,7 @@ block: - name: Copy file to a new data set. ibm.ibm_zos_core.zos_copy: - src: ./files/CLIST + src: "{{ playbook_dir }}/files/CLIST" dest: "{{ clist_data_set }}" remote_src: false diff --git a/zos_concepts/zos_script/zos_script.yml b/zos_concepts/zos_script/zos_script.yml index 02453d892..e0acbefe3 100644 --- a/zos_concepts/zos_script/zos_script.yml +++ b/zos_concepts/zos_script/zos_script.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2023 +# © Copyright IBM Corporation 2023, 2024 ############################################################################### ############################################################################### @@ -45,7 +45,7 @@ # node. Make sure to replace the values of the arguments. - name: Run REXX script to get a job's information. ibm.ibm_zos_core.zos_script: - cmd: ./files/JOB_INFO JOBID=ID OWNER=OWNER JOBNAME=NAME + cmd: "{{ playbook_dir }}/files/JOB_INFO JOBID=ID OWNER=OWNER JOBNAME=NAME" remote_src: false register: job_output @@ -57,7 +57,7 @@ # control over the way a script is run. - name: Run Python script in a given directory. ibm.ibm_zos_core.zos_script: - cmd: ./files/list_dir.py + cmd: "{{ playbook_dir }}/files/list_dir.py" chdir: "{{ python_script_dir }}" executable: "{{ ansible_python_interpreter }}" remote_src: false @@ -71,7 +71,7 @@ # the variables defined above. - name: Run template of a REXX script. ibm.ibm_zos_core.zos_script: - cmd: ./files/CATALOG + cmd: "{{ playbook_dir }}/files/CATALOG" remote_src: false use_template: true template_parameters: From f56e42e8905bd5b7cd580e49dceef5a79918d76f Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Tue, 9 Apr 2024 17:30:21 -0700 Subject: [PATCH 02/18] removes task creating pds member since new behavior of zos_copy creates it. also updates newly case-sensitive params Signed-off-by: Ketan Kelkar --- .../submit_query_retrieve.yml | 42 +++++-------------- 1 file changed, 11 insertions(+), 31 deletions(-) diff --git a/zos_concepts/jobs/submit_query_retrieve/submit_query_retrieve.yml b/zos_concepts/jobs/submit_query_retrieve/submit_query_retrieve.yml index 5236107af..a1c5c46c5 100644 --- a/zos_concepts/jobs/submit_query_retrieve/submit_query_retrieve.yml +++ b/zos_concepts/jobs/submit_query_retrieve/submit_query_retrieve.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2020, 2021, 2022 +# © Copyright IBM Corporation 2020, 2024 ############################################################################### ############################################################################### @@ -74,7 +74,8 @@ zos_data_set: name: "{{ data_set_name }}" type: pds - size: 5M + space_primary: 5 + space_type: m format: fb record_length: 80 replace: true @@ -84,25 +85,6 @@ debug: msg: "{{ result }}" - # +------------------------------------------------------------------------- - # | "with_sequence" is a type of conditional Ansible loop. The loop here - # | only runs for a single iteration and is included solely to demonstrate - # | how easy it is to perform the operation for multiple members. The result - # | is that single member 'MEM1' is created. - # +------------------------------------------------------------------------- - - - name: Create a PDS member and replace if member exist - zos_data_set: - name: "{{ data_set_name }}(MEM{{ item }})" - type: MEMBER - replace: true - with_sequence: count=1 - register: result - - - name: Response for create a PDS member and replace if member exist - debug: - msg: "{{ result }}" - - name: Ensure JCL folder exists in USS to manage JCL file: path: "{{ tgt_tmp_dir }}/ansible/jcl" @@ -139,16 +121,16 @@ msg: "{{ result }}" # +------------------------------------------------------------------------- - # | Similar to how the PDS member was created earlier, this is another - # | Ansible loop with a single iteration designed to showcase how multiple - # | jobs could be submitted under a single task for members of a single PDS + # | "with_sequence" is a type of conditional Ansible loop. The loop here + # | only runs for a single iteration and is included solely to demonstrate + # | how multiple jobs could be submitted under a single task for members of + # | a single PDS. # +------------------------------------------------------------------------- - name: Submit the JCL {{ data_set_name }}(MEM1) zos_job_submit: src: "{{ data_set_name }}(MEM{{ item }})" - location: DATA_SET - wait: true + location: data_set register: result with_sequence: count=1 @@ -165,8 +147,7 @@ - name: Setting fact `job_id_pds` for id of job submitted above set_fact: - job_id_pds: "{{ result.results[0].job_id }}" - + job_id_pds: "{{ result.results[0].jobs[0].job_id }}" - name: Fact `job_id_pds` set with value debug: msg: "{{ job_id_pds }}" @@ -199,8 +180,7 @@ in {{ tgt_tmp_dir }}/ansible/jcl/{{ job_name }} zos_job_submit: src: "{{ tgt_tmp_dir }}/ansible/jcl/{{ job_name }}" - location: USS - wait: true + location: uss register: result - name: Response for submit {{ job_name }} JCL located on target @@ -211,7 +191,7 @@ - name: Setting fact `job_id_uss` for id of job submitted above set_fact: - job_id_uss: "{{ result.job_id }}" + job_id_uss: "{{ result.jobs[0].job_id }}" - name: Fact `job_id_uss` set with value debug: From a6312249985abb041e2d2d7f4546f1fc1017d370 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Wed, 10 Apr 2024 12:07:26 -0700 Subject: [PATCH 03/18] update case sensitive params, update unsafe conditional, slightly reduce initial data set size Signed-off-by: Ketan Kelkar --- .../zfsadm/zfs_grow_aggr/scan_and_grow_zfs_aggr.yml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/zos_concepts/zfsadm/zfs_grow_aggr/scan_and_grow_zfs_aggr.yml b/zos_concepts/zfsadm/zfs_grow_aggr/scan_and_grow_zfs_aggr.yml index 45258a4e3..46e58fe8f 100644 --- a/zos_concepts/zfsadm/zfs_grow_aggr/scan_and_grow_zfs_aggr.yml +++ b/zos_concepts/zfsadm/zfs_grow_aggr/scan_and_grow_zfs_aggr.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2022 +# © Copyright IBM Corporation 2022, 2024 ############################################################################### ############################################################################### @@ -60,8 +60,8 @@ zos_data_set: name: "{{ item | upper }}" type: zfs - space_primary: 1 - space_type: M + space_primary: 950 + space_type: k replace: true loop: "{{ zfs_data_sets }}" @@ -119,7 +119,7 @@ - name: Build grow_list set_fact: grow_list: "{{ grow_list | default([]) + [item[0]] }}" - when: "{{ item[1] | int }} > {{ threshold_limit }}" + when: item[1] | int > threshold_limit | int loop: "{{ dsn_per_util_list }}" - name: Echo grow_list From f566046cb44f2d8c0d49978fc3aa474b0fe50b67 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Wed, 10 Apr 2024 12:21:32 -0700 Subject: [PATCH 04/18] updates top module options for volume init playbooks Signed-off-by: Ketan Kelkar --- .../init_dasd_vol_and_run_sample_jcl.yml | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/init_dasd_vol_and_run_sample_jcl.yml b/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/init_dasd_vol_and_run_sample_jcl.yml index fc8466d0a..43fcd2983 100644 --- a/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/init_dasd_vol_and_run_sample_jcl.yml +++ b/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/init_dasd_vol_and_run_sample_jcl.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2023 +# © Copyright IBM Corporation 2023, 2024 ############################################################################### ############################################################################### @@ -80,11 +80,11 @@ not be SMS managed. zos_volume_init: address: "{{ vol_unit }}" - verify_offline: true + verify_offline: no volid: "{{ new_volser }}" index: true sms_managed: false - verify_volume_empty: true + verify_volume_empty: no register: output - name: Response for intialize target volume. @@ -100,7 +100,7 @@ name: "{{ zfs_dsname }}" type: zfs space_primary: 50 - space_type: M + space_type: m replace: true volumes: "{{ new_volser }}" @@ -113,7 +113,7 @@ zos_mount: src: "{{ zfs_dsname }}" path: "{{ mount_point }}" - fs_type: ZFS + fs_type: zfs state: mounted - name: Copy JCL to data set. @@ -124,7 +124,7 @@ - name: Submit the JCL at {{ mount_point}}/HELLO.jcl. zos_job_submit: src: "{{ mount_point }}/HELLO.jcl" - location: USS + location: uss register: result - name: Setting fact `job_id` for id of job submitted above. @@ -155,7 +155,7 @@ zos_mount: src: "{{ zfs_dsname }}" path: "{{ mount_point }}" - fs_type: ZFS + fs_type: zfs state: absent - name: Delete ZFS data set {{ zfs_dsname }}. From 86aaa96e5f39c817aa404af15167c2bad2afba58 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Wed, 10 Apr 2024 15:38:39 -0700 Subject: [PATCH 05/18] update case-sensitive modules options in role, update unsafe jinja in conditional Signed-off-by: Ketan Kelkar --- .../roles/copy-local-data/tasks/main.yml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/zos_concepts/data_transfer/copy_sort_fetch/roles/copy-local-data/tasks/main.yml b/zos_concepts/data_transfer/copy_sort_fetch/roles/copy-local-data/tasks/main.yml index aa89a458f..3a2a61cea 100644 --- a/zos_concepts/data_transfer/copy_sort_fetch/roles/copy-local-data/tasks/main.yml +++ b/zos_concepts/data_transfer/copy_sort_fetch/roles/copy-local-data/tasks/main.yml @@ -1,6 +1,6 @@ --- ################################################################################ -# © Copyright IBM Corporation 2020 +# © Copyright IBM Corporation 2020, 2024 # Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) ################################################################################ @@ -41,8 +41,8 @@ - name: Create the temporary data set ibm.ibm_zos_core.zos_data_set: name: "{{ dest_tmp_data_set }}" - type: "SEQ" - record_format: "FB" + type: seq + record_format: fb - name: Copy local data file to remote z/OS temporary data set ibm.ibm_zos_core.zos_copy: @@ -58,6 +58,6 @@ - ansible.builtin.assert: that: - - "{{ result.data_sets | valid_list }}" - - "'{{ result.data_sets[0]['name'] }}' == '{{ dest_tmp_data_set }}'" + - "result.data_sets | valid_list" + - "result.data_sets[0]['name'] == dest_tmp_data_set" fail_msg: "The destination data set does not exist" From ec1230d088bc2921852f2c744a528bfbe04ebf28 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Wed, 10 Apr 2024 15:39:24 -0700 Subject: [PATCH 06/18] update module options copy fetch data set playbook Signed-off-by: Ketan Kelkar --- .../copy_fetch_data_set/copy_fetch_data_set.yml | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/zos_concepts/data_transfer/copy_fetch_data_set/copy_fetch_data_set.yml b/zos_concepts/data_transfer/copy_fetch_data_set/copy_fetch_data_set.yml index d33afe4eb..5dd35724b 100644 --- a/zos_concepts/data_transfer/copy_fetch_data_set/copy_fetch_data_set.yml +++ b/zos_concepts/data_transfer/copy_fetch_data_set/copy_fetch_data_set.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2020, 2021 +# © Copyright IBM Corporation 2020, 2024 ############################################################################### ############################################################################### @@ -107,7 +107,8 @@ type: pds format: fba record_length: 100 - size: 5M + space_primary: 5 + space_type: m register: result - name: Response for creating the PDS @@ -153,13 +154,14 @@ debug: msg: "{{ result }}" - - name: Copy the updated directory back to the remote host + - name: Copy the updated directory back to the remote host overwriting previous content. zos_copy: src: "{{ ctl_tmp_dir }}/{{ data_set_name }}" dest: "{{ data_set_name }}" encoding: from: ISO8859-1 to: "{{ target_charset }}" + force: true register: result - name: Response for copying From 46448df8377949e98a502fbdf14bcc5f4c7d1ff3 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Thu, 11 Apr 2024 10:42:33 -0700 Subject: [PATCH 07/18] update module options constructs/zos job submit Signed-off-by: Ketan Kelkar --- zos_basics/constructs/zos_job_submit_ansible_constructs.yml | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/zos_basics/constructs/zos_job_submit_ansible_constructs.yml b/zos_basics/constructs/zos_job_submit_ansible_constructs.yml index 37917727b..6df317aef 100644 --- a/zos_basics/constructs/zos_job_submit_ansible_constructs.yml +++ b/zos_basics/constructs/zos_job_submit_ansible_constructs.yml @@ -1,5 +1,5 @@ ############################################################################### -# Copyright (c) IBM Corporation 2021 +# Copyright (c) IBM Corporation 2021, 2024 ############################################################################### ############################################################################### @@ -382,8 +382,7 @@ - name: Convert a local JCL file to IBM-037 and submit the job zos_job_submit: src: "{{playbook_dir}}/files/HELLO.jcl" - location: LOCAL - wait: false + location: local encoding: from: ISO8859-1 to: IBM-037 From 21cea9a48c69b71682eaf23579ea74b7ebe4775a Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Thu, 11 Apr 2024 11:59:34 -0700 Subject: [PATCH 08/18] update module options for templates playbooks Signed-off-by: Ketan Kelkar --- .../copy_template/zos_copy_template.yml | 10 +++++----- .../templates/loadlib/compile_link_loadlib.yml | 16 ++++++++-------- .../submit_job_template/submit_templates.yml | 6 +++--- 3 files changed, 16 insertions(+), 16 deletions(-) diff --git a/zos_concepts/templates/copy_template/zos_copy_template.yml b/zos_concepts/templates/copy_template/zos_copy_template.yml index 1573bae82..dad4080c6 100644 --- a/zos_concepts/templates/copy_template/zos_copy_template.yml +++ b/zos_concepts/templates/copy_template/zos_copy_template.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2023 +# © Copyright IBM Corporation 2023, 2024 ############################################################################### ############################################################################### @@ -89,7 +89,7 @@ # be copied over to the host. - name: Copy a template to a remote file. ibm.ibm_zos_core.zos_copy: - src: ./files/template.j2 + src: "{{ playbook_dir }}/files/template.j2" dest: "{{ json_path }}" use_template: true @@ -115,7 +115,7 @@ # to make use of Jinja. - name: Copy a template to a dataset. ibm.ibm_zos_core.zos_copy: - src: ./files/records.j2 + src: "{{ playbook_dir }}/files/records.j2" dest: "{{ default_dataset_name }}" use_template: true @@ -137,7 +137,7 @@ # "{{" and "}}", to "((" and "))". - name: Copy a template to a dataset while changing the markers used. ibm.ibm_zos_core.zos_copy: - src: ./files/records_custom_markers.j2 + src: "{{ playbook_dir }}/files/records_custom_markers.j2" dest: "{{ custom_dataset_name }}" use_template: true template_parameters: @@ -154,7 +154,7 @@ # after rendering blocks. - name: Copy a template to a dataset without trimming whitespace. ibm.ibm_zos_core.zos_copy: - src: ./files/records.j2 + src: "{{ playbook_dir }}/files/records.j2" dest: "{{ default_dataset_name }}" force: true use_template: true diff --git a/zos_concepts/templates/loadlib/compile_link_loadlib.yml b/zos_concepts/templates/loadlib/compile_link_loadlib.yml index fb3c28432..71237036a 100644 --- a/zos_concepts/templates/loadlib/compile_link_loadlib.yml +++ b/zos_concepts/templates/loadlib/compile_link_loadlib.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2023 +# © Copyright IBM Corporation 2023, 2024 ############################################################################### ############################################################################### @@ -43,10 +43,10 @@ - name: Create {{ pgm_dataset }} for the COBOL program. ibm.ibm_zos_core.zos_data_set: name: "{{ pgm_dataset }}" - type: PDS + type: pds space_primary: 2 - space_type: M - record_format: FB + space_type: m + record_format: fb record_length: 80 block_size: 3120 @@ -58,17 +58,17 @@ - name: Create {{ loadlib_dataset }} where the compiled source will be linked. ibm.ibm_zos_core.zos_data_set: name: "{{ loadlib_dataset }}" - type: PDSE + type: pdse space_primary: 2 - space_type: M - record_format: U + space_type: m + record_format: u record_length: 0 block_size: 32760 - name: Compile and link the COBOL code. ibm.ibm_zos_core.zos_job_submit: src: "{{playbook_dir}}/files/COMPLINK.j2" - location: LOCAL + location: local wait_time_s: 60 use_template: true register: comp_result diff --git a/zos_concepts/templates/submit_job_template/submit_templates.yml b/zos_concepts/templates/submit_job_template/submit_templates.yml index a556c5a2b..1ce03b24d 100644 --- a/zos_concepts/templates/submit_job_template/submit_templates.yml +++ b/zos_concepts/templates/submit_job_template/submit_templates.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2023 +# © Copyright IBM Corporation 2023, 2024 ############################################################################### ############################################################################### @@ -75,7 +75,7 @@ - name: Submit shell command job using a local template. ibm.ibm_zos_core.zos_job_submit: src: "{{ playbook_dir }}/files/CMD.j2" - location: LOCAL + location: local use_template: true register: job_output @@ -103,7 +103,7 @@ - name: Submit IEFBR14 job using a local template. ibm.ibm_zos_core.zos_job_submit: src: "{{ playbook_dir }}/files/LOOP.j2" - location: LOCAL + location: local use_template: true template_parameters: trim_blocks: true From 1c036e8c1f75cc2afbdfc654c5fa309952ad1591 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Thu, 11 Apr 2024 15:47:48 -0700 Subject: [PATCH 09/18] update module options and rename some variables for archive/unarchive playbooks, also adds some cleanup tasks Signed-off-by: Ketan Kelkar --- .../archive_fetch_data_sets.yml | 55 ++++++++++++------- .../{zos_host.yml => destination.yml} | 0 .../inventories/host_vars/source.yml | 24 ++++++++ .../unarchive_data_sets.yml | 28 +++++----- 4 files changed, 73 insertions(+), 34 deletions(-) rename zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/{zos_host.yml => destination.yml} (100%) create mode 100644 zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/source.yml diff --git a/zos_concepts/data_transfer/archive_copy_unarchive_restore/archive_fetch_data_sets.yml b/zos_concepts/data_transfer/archive_copy_unarchive_restore/archive_fetch_data_sets.yml index 4a8105246..d4fd6763c 100644 --- a/zos_concepts/data_transfer/archive_copy_unarchive_restore/archive_fetch_data_sets.yml +++ b/zos_concepts/data_transfer/archive_copy_unarchive_restore/archive_fetch_data_sets.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2023 +# © Copyright IBM Corporation 2023, 2024 ############################################################################### ############################################################################### @@ -18,11 +18,10 @@ # IBM z/OS core collection 1.7.0 or later. # Ansible Community General Collection # -# Configure: +# Configure (optional): # data_sets_to_archive - A list of data sets contained in an archive you wish to include in dump. -# archive_data_set - The name to use for the data set archive, -# if not provided, module-generated name will be used. -# delete - Indicates if terse and archive data sets should be deleted upon successful transfer. +# archive_data_set - The name to use for the data set archive. +# remove_data_sets - Indicates if terse and archive data sets should be deleted upon successful transfer. # ############################################################################### @@ -30,20 +29,26 @@ collections : - "ibm.ibm_zos_core" gather_facts: false + vars: - data_sets_to_archive: ["USER.PRIVATE.TEST"] - archive_data_set: "" - delete: true + data_sets_to_archive: + - "{{ ansible_user | upper }}.ANSIBLE.SAMPLE.ONE" + - "{{ ansible_user | upper }}.ANSIBLE.SAMPLE.TWO" + archive_data_set: "{{ ansible_user | upper }}.ANSIBLE.SAMPLE.ARCHIVE" + remove_data_sets: true + environment: '{{ environment_vars }}' tasks: - - name: Create a temporary data set - zos_data_set: - type: seq - space_primary: 5 - space_secondary: 1 - space_type: cyl - name: "{{ item }}" + - name: Create and copy content into data sets to archive. + zos_copy: + content: "HELLO WORLD - {{ item }}" + dest: "{{ item }}" + dest_data_set: + type: seq + space_primary: 5 + space_secondary: 1 + space_type: cyl loop: "{{ data_sets_to_archive }}" ######################################################################### @@ -76,18 +81,18 @@ - name: Create a dump with adrdssu of the data sets and archive using terse. ibm.ibm_zos_core.zos_archive: src: "{{ data_sets_to_archive }}" - dest: "{{ dest_archive }}" + dest: "{{ archive_data_set }}" force: True format: name: terse format_options: - terse_pack: SPACK + terse_pack: spack use_adrdssu: True - remove: "{{ delete }}" + remove: "{{ remove_data_sets }}" dest_data_set: space_primary: "{{ size_in_cyls.primary }}" space_secondary: "{{ size_in_cyls.secondary }}" - space_type: CYL + space_type: cyl register: archive_result - debug: @@ -103,12 +108,20 @@ ######################################################################### - name: Fetch the data set into the controller ibm.ibm_zos_core.zos_fetch: - src: "{{ dest_archive }}" + src: "{{ archive_data_set }}" dest: "{{ playbook_dir }}/" is_binary: True flat: True register: result - - name: "Result of fetching {{ dest_archive }} to controller node" + - name: "Result of fetching {{ archive_data_set }} to controller node" debug: msg: "{{ result }}" + + ######################################################################### + # Remove archive data set from remote system. + ######################################################################### + - name: Delete archive data set from remote system. + zos_data_set: + name: "{{ archive_data_set }}" + state: absent \ No newline at end of file diff --git a/zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/zos_host.yml b/zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/destination.yml similarity index 100% rename from zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/zos_host.yml rename to zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/destination.yml diff --git a/zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/source.yml b/zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/source.yml new file mode 100644 index 000000000..445e66d6f --- /dev/null +++ b/zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/source.yml @@ -0,0 +1,24 @@ +################################################################################ +# Copyright (c) IBM Corporation 2023 +################################################################################ + +################################################################################ +# Description of the properties used in this configuration: +# - Property `PYZ` is the python installation home path on the z/OS managed node (target), +# e.g, pyz: "/usr/lpp/IBM/cyp/v3r11/pyz" +# - Property `ZOAU` is the ZOAU installation home on the z/OS managed node (target), +# e.g, zoau: "/usr/lpp/IBM/zoautil" +# - property `ansible_python_interpreter` is the z/OS managed node (target) Python +# binary installation path, e.g, ansible_python_interpreter: "{{PYZ}}/bin/python3" +# +# Note, PYZ and ZOAU environment variables must be configured. +################################################################################ + +PYZ: "path_to_python_installation_on_zos_target" +ZOAU: "path_to_zoau_installation_on_zos_target" + +################################################################################ +# Do not configure, variable substituion will correctly set the +# variable`ansible_python_interpreter` +################################################################################ +ansible_python_interpreter: "{{ PYZ }}/bin/python3" \ No newline at end of file diff --git a/zos_concepts/data_transfer/archive_copy_unarchive_restore/unarchive_data_sets.yml b/zos_concepts/data_transfer/archive_copy_unarchive_restore/unarchive_data_sets.yml index e6e5dc3ea..7a56b171c 100644 --- a/zos_concepts/data_transfer/archive_copy_unarchive_restore/unarchive_data_sets.yml +++ b/zos_concepts/data_transfer/archive_copy_unarchive_restore/unarchive_data_sets.yml @@ -1,5 +1,5 @@ ############################################################################### -# © Copyright IBM Corporation 2023 +# © Copyright IBM Corporation 2023, 2024 ############################################################################### ############################################################################### @@ -17,10 +17,10 @@ # IBM z/OS core collection 1.7.0 or later. # Ansible Community General Collection # -# Configure: +# Configure (optional): # archive_data_set - The name to use for the data set archive. -# delete - Indicates if terse and archive data sets should be deleted upon -# successful restore. +# remove_data_sets - Indicates if terse and archive data sets should be deleted +# upon successful restore. # replace - Indicates if existing data sets should be overwritten during restore. # ############################################################################### @@ -29,31 +29,33 @@ collections : - "ibm.ibm_zos_core" gather_facts: false + vars: - archive_data_set: "" - delete: False + archive_data_set: "{{ ansible_user | upper }}.ANSIBLE.SAMPLE.ARCHIVE" + remove_local_archive: True replace: True + environment: '{{ environment_vars }}' tasks: - block: - name: Unarchive the dump using terse and restore the data sets. ibm.ibm_zos_core.zos_unarchive: - src: "{{ playbook_dir }}/{{ dest_archive }}" - force: True + src: "{{ playbook_dir }}/{{ archive_data_set }}" + force: "{{ replace }}" format: name: terse format_options: use_adrdssu: True - force: "{{ replace }}" register: unarchive_result - debug: msg: "{{ unarchive_result }}" always: - - name: Clean up archive data set - ibm.ibm_zos_core.zos_data_set: - name: "{{ dest_archive }}" + - name: Clean up local archive. + ansible.builtin.file: + name: "{{ playbook_dir }}/{{ archive_data_set }}" state: absent - when: delete and dest_archive is defined + when: remove_local_archive + delegate_to: localhost From 776ef5693d8b48ed28b80c08a8979893dd026045 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Wed, 15 May 2024 16:55:17 -0700 Subject: [PATCH 10/18] update changelogs Signed-off-by: Ketan Kelkar --- zos_basics/constructs/changelog.yml | 9 ++++++++- .../data_sets/copy_edit_submit/changelog.yml | 9 ++++++++- zos_concepts/data_sets/data_set_basics/changelog.yml | 8 +++++++- .../archive_copy_unarchive_restore/changelog.yml | 12 +++++++++++- .../data_transfer/copy_fetch_data_set/changelog.yml | 9 ++++++++- .../data_transfer/copy_sort_fetch/changelog.yml | 7 ++++++- zos_concepts/encoding/convert_encoding/changelog.yml | 8 +++++++- .../jobs/submit_query_retrieve/changelog.yml | 9 ++++++++- zos_concepts/templates/copy_template/changelog.yml | 7 ++++++- zos_concepts/templates/loadlib/changelog.yml | 10 +++++++++- .../templates/submit_job_template/changelog.yml | 7 ++++++- zos_concepts/tso_commands/scripts/changelog.yml | 7 ++++++- .../init_dasd_vol_and_run_sample_jcl/changelog.yml | 9 ++++++++- zos_concepts/zfsadm/zfs_grow_aggr/changelog.yml | 7 ++++++- zos_concepts/zos_script/changelog.yml | 7 ++++++- 15 files changed, 110 insertions(+), 15 deletions(-) diff --git a/zos_basics/constructs/changelog.yml b/zos_basics/constructs/changelog.yml index c697c5b01..437937a94 100644 --- a/zos_basics/constructs/changelog.yml +++ b/zos_basics/constructs/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2021 +# Copyright (c) IBM Corporation 2021, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -40,3 +40,10 @@ releases: - Added runtime-requirements.txt that lists the requirements needed for this playbook to execute minor: - Changed dependency from Ansible 2.10 to 2.11 to align with the collections supported Ansible + 2024.04.11: + date: 2024-04-11 + changes: + fixed: + - Lower case zos_job_submit module option 'location' per ibm.ibm_zos_core:1.10.0 requirements. + removed: + - Remove deprecated zos_job_submit module option 'wait'. diff --git a/zos_concepts/data_sets/copy_edit_submit/changelog.yml b/zos_concepts/data_sets/copy_edit_submit/changelog.yml index 7d9704716..9a8c4baad 100644 --- a/zos_concepts/data_sets/copy_edit_submit/changelog.yml +++ b/zos_concepts/data_sets/copy_edit_submit/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2021 +# Copyright (c) IBM Corporation 2021, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -43,3 +43,10 @@ releases: - Renamed `copy_edit_submit.yaml` to `copy_edit_submit.yml` to standardize all playbooks with the same extension removed: - Removed the zos_ssh connection plugin, it is no longer included in the ibm_zos_core collection. + 2024.04.09: + date: 2024-04-09 + changes: + fixed: + - Lower case zos_job_submit module option 'location' per ibm.ibm_zos_core:1.10.0 requirements. + removed: + - Remove deprecated zos_job_submit module option 'wait'. \ No newline at end of file diff --git a/zos_concepts/data_sets/data_set_basics/changelog.yml b/zos_concepts/data_sets/data_set_basics/changelog.yml index c7dee58d5..7fc957c9c 100644 --- a/zos_concepts/data_sets/data_set_basics/changelog.yml +++ b/zos_concepts/data_sets/data_set_basics/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2021 +# Copyright (c) IBM Corporation 2021, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -44,3 +44,9 @@ releases: - Renamed `data_set_basics.yaml` to `data_set_basics.yml` with a `yml` extenstion to follow standardize on the extension removed: - Removed the zos_ssh connection plugin, it is no longer included in the ibm_zos_core collection. + 2024.04.09: + date: 2024-04-09 + changes: + fixed: + - Replace deprecated zos_data_set module option 'size' with new module options 'space_primary' and 'space_type'. + - Lower case zos_data_set module option 'type' per ibm.ibm_zos_core:1.10.0 requirements. diff --git a/zos_concepts/data_transfer/archive_copy_unarchive_restore/changelog.yml b/zos_concepts/data_transfer/archive_copy_unarchive_restore/changelog.yml index ffae0f964..72eda92ea 100644 --- a/zos_concepts/data_transfer/archive_copy_unarchive_restore/changelog.yml +++ b/zos_concepts/data_transfer/archive_copy_unarchive_restore/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2023 +# Copyright (c) IBM Corporation 2023, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -31,3 +31,13 @@ releases: changes: added: - Released initial version + 2024.04.11: + date: 2024-04-11 + changes: + added: + - Update description of optional configurations. + - Update vars section to use more generic data set names. + - Add new host_vars files for 'source' and 'destination' target nodes. + fixed: + - Lower case zos_archive module option 'terse_pack' per ibm.ibm_zos_core:1.10.0 requirements. + - Lower case zos_archive module option 'space_type' per ibm.ibm_zos_core:1.10.0 requirements. \ No newline at end of file diff --git a/zos_concepts/data_transfer/copy_fetch_data_set/changelog.yml b/zos_concepts/data_transfer/copy_fetch_data_set/changelog.yml index 0e1e97889..635272a61 100644 --- a/zos_concepts/data_transfer/copy_fetch_data_set/changelog.yml +++ b/zos_concepts/data_transfer/copy_fetch_data_set/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2021 +# Copyright (c) IBM Corporation 2021, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -44,3 +44,10 @@ releases: - Renamed `copy_fetch_data_set.yaml` to `copy_fetch_data_set.yml` with a `yml` extenstion to follow standardize on the extension removed: - Removed the zos_ssh connection plugin, it is no longer included in the ibm_zos_core collection. + 2024.04.10: + date: 2024-04-10 + changes: + fixed: + - Replace deprecated zos_data_set module option 'size' with new module options 'space_primary' and 'space_type'. + - Modify playbook task to force the copy operation when writing the directory back to host to ensure + uninterrupted playbook execution. \ No newline at end of file diff --git a/zos_concepts/data_transfer/copy_sort_fetch/changelog.yml b/zos_concepts/data_transfer/copy_sort_fetch/changelog.yml index 9474a88e8..9168c1ea9 100644 --- a/zos_concepts/data_transfer/copy_sort_fetch/changelog.yml +++ b/zos_concepts/data_transfer/copy_sort_fetch/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2021 +# Copyright (c) IBM Corporation 2021, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -43,3 +43,8 @@ releases: - Renamed `copy-sort-fetch.yaml` to `copy-sort-fetch.yml` with a `yml` extenstion to follow standardize on the extension removed: - Removed the zos_ssh connection plugin, it is no longer included in the ibm_zos_core collection. + 2024.04.10: + date: 2024-04-10 + changes: + fixed: + - Replace deprecated zos_data_set module option 'size' with new module options 'space_primary' and 'space_type'. \ No newline at end of file diff --git a/zos_concepts/encoding/convert_encoding/changelog.yml b/zos_concepts/encoding/convert_encoding/changelog.yml index 0ce60cf55..acd4f4c48 100644 --- a/zos_concepts/encoding/convert_encoding/changelog.yml +++ b/zos_concepts/encoding/convert_encoding/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2021 +# Copyright (c) IBM Corporation 2021, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -48,3 +48,9 @@ releases: - Renamed `convert_encoding.yaml` to `convert_encoding.yml` with a `yml` extenstion to follow standardize on the extension removed: - Removed the zos_ssh connection plugin, it is no longer included in the ibm_zos_core collection. + 2024.04.09: + date: 2024-04-09 + changes: + fixed: + - Replace deprecated zos_encode module options 'from_encoding' and 'to_encoding' with new module option + 'encoding' with sub-options 'to' and from' \ No newline at end of file diff --git a/zos_concepts/jobs/submit_query_retrieve/changelog.yml b/zos_concepts/jobs/submit_query_retrieve/changelog.yml index ddbb7df05..cd6b09cf2 100644 --- a/zos_concepts/jobs/submit_query_retrieve/changelog.yml +++ b/zos_concepts/jobs/submit_query_retrieve/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2021 +# Copyright (c) IBM Corporation 2021, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -40,3 +40,10 @@ releases: - Updated host_vars, group_vars and inventory removed: - Removed the zos_ssh connection plugin, it is no longer included in the ibm_zos_core collection. + 2024.04.09: + date: 2024-04-09 + changes: + fixed: + - Replace deprecated zos_data_set module option 'size' with new module options 'space_primary' and 'space_type'. + removed: + - Remove playbook task creating members to avoid using 'force' module option in the zos_copy playbook task. \ No newline at end of file diff --git a/zos_concepts/templates/copy_template/changelog.yml b/zos_concepts/templates/copy_template/changelog.yml index 572e5c6e3..8ba0f73ae 100644 --- a/zos_concepts/templates/copy_template/changelog.yml +++ b/zos_concepts/templates/copy_template/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2023 +# Copyright (c) IBM Corporation 2023, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -31,3 +31,8 @@ releases: changes: added: - Released initial version + 2024.04.11: + date: 2024-04-11 + changes: + fixed: + - Prefix paths with 'playbook_dir' Ansible global variable. \ No newline at end of file diff --git a/zos_concepts/templates/loadlib/changelog.yml b/zos_concepts/templates/loadlib/changelog.yml index afc95fa0a..882a74281 100644 --- a/zos_concepts/templates/loadlib/changelog.yml +++ b/zos_concepts/templates/loadlib/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2023 +# Copyright (c) IBM Corporation 2023, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -31,3 +31,11 @@ releases: changes: added: - Released initial version + 2024.04.11: + date: 2024-04-11 + changes: + fixed: + - Lower case zos_data_set module option 'type' per ibm.ibm_zos_core:1.10.0 requirements. + - Lower case zos_data_set module option 'space_type' per ibm.ibm_zos_core:1.10.0 requirements. + - Lower case zos_data_set module option 'record_format' per ibm.ibm_zos_core:1.10.0 requirements. + - Lower case zos_job_submit module option 'location' per ibm.ibm_zos_core:1.10.0 requirements. \ No newline at end of file diff --git a/zos_concepts/templates/submit_job_template/changelog.yml b/zos_concepts/templates/submit_job_template/changelog.yml index afc95fa0a..f71a67f9b 100644 --- a/zos_concepts/templates/submit_job_template/changelog.yml +++ b/zos_concepts/templates/submit_job_template/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2023 +# Copyright (c) IBM Corporation 2023, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -31,3 +31,8 @@ releases: changes: added: - Released initial version + 2024.04.11: + date: 2024-04-11 + changes: + fixed: + - Lower case zos_job_submit module option 'location' per ibm.ibm_zos_core:1.10.0 requirements. diff --git a/zos_concepts/tso_commands/scripts/changelog.yml b/zos_concepts/tso_commands/scripts/changelog.yml index 69edf768c..f50a3810c 100644 --- a/zos_concepts/tso_commands/scripts/changelog.yml +++ b/zos_concepts/tso_commands/scripts/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2023 +# Copyright (c) IBM Corporation 2023, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -31,3 +31,8 @@ releases: changes: added: - Released initial version + 2024.04.09: + date: 2024-04-09 + changes: + fixed: + - Prefix paths with 'playbook_dir' Ansible global variable. \ No newline at end of file diff --git a/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/changelog.yml b/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/changelog.yml index 19a1b9272..66a3e69fc 100644 --- a/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/changelog.yml +++ b/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2023 +# Copyright (c) IBM Corporation 2023, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -31,3 +31,10 @@ releases: changes: added: - Released initial version + 2024.04.10: + date: 2024-04-10 + changes: + fixed: + - Lower case zos_data_set module option 'space_type' per ibm.ibm_zos_core:1.10.0 requirements. + - Lower case zos_mount module option 'fs_type' per ibm.ibm_zos_core:1.10.0 requirements. + - Lower case zos_job_submit module option 'location' per ibm.ibm_zos_core:1.10.0 requirements. diff --git a/zos_concepts/zfsadm/zfs_grow_aggr/changelog.yml b/zos_concepts/zfsadm/zfs_grow_aggr/changelog.yml index 30857c2ed..f845bcd56 100644 --- a/zos_concepts/zfsadm/zfs_grow_aggr/changelog.yml +++ b/zos_concepts/zfsadm/zfs_grow_aggr/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2022 +# Copyright (c) IBM Corporation 2022, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -31,3 +31,8 @@ releases: changes: added: - Released initial version (pending) + 2024.04.10: + date: 2024-04-10 + changes: + fixed: + - Update data set space configurations for clearer threshold variations in output. diff --git a/zos_concepts/zos_script/changelog.yml b/zos_concepts/zos_script/changelog.yml index 69edf768c..f50a3810c 100644 --- a/zos_concepts/zos_script/changelog.yml +++ b/zos_concepts/zos_script/changelog.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2023 +# Copyright (c) IBM Corporation 2023, 2024 # # All notable changes to this project will be documented in this file. Following # releases is a decimal based date since playbooks have no version in this @@ -31,3 +31,8 @@ releases: changes: added: - Released initial version + 2024.04.09: + date: 2024-04-09 + changes: + fixed: + - Prefix paths with 'playbook_dir' Ansible global variable. \ No newline at end of file From bb3b79f6bb6def4db8ef00535af0ee66c04a8ad6 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Mon, 24 Jun 2024 15:57:14 -0700 Subject: [PATCH 11/18] ibm_zos_core v1.10 release update to playbook README Signed-off-by: Ketan Kelkar --- zos_basics/constructs/README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/zos_basics/constructs/README.md b/zos_basics/constructs/README.md index 589a5daa5..619da22b8 100644 --- a/zos_basics/constructs/README.md +++ b/zos_basics/constructs/README.md @@ -22,6 +22,21 @@ configuration, flexibility is written into the samples because it can't always be determined if a sample has access to the host’s resources. Review the playbook for additional details and configuration. +> [!IMPORTANT] +> The release of `ibm_zos_core` collection version 1.10.0 introduces case-sensitive +> changes to modules, specifically that module choices must be lower case. See the porting +> guide in the release notes (here) to understand the full scope of these changes. +> +> These changes require sample playbook updates that are not compatible with earlier +> versions of the `ibm_zos_core` collection. +> +> To support both the latest and prior versions of the collection: +> +> * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * The ` ibm-z-playbooks-2024` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. See the compatible version of the playbook here .??? +> +> The ` ibm-z-playbooks-2024` branch will remain available until April 2025 but will no longer receive updates. + ## Playbook Requirements - [IBM® z/OS® core collection 1.0.0 or later](https://galaxy.ansible.com/ibm/ibm_zos_core) - [Ansible® 2.11 or later](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html) From 1a8ab6f34030d294f3810f636ab05860f528bc6c Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Mon, 24 Jun 2024 16:01:26 -0700 Subject: [PATCH 12/18] ibm_zos_core v1.10 release update to playbook README minor tweaks Signed-off-by: Ketan Kelkar --- zos_basics/constructs/README.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/zos_basics/constructs/README.md b/zos_basics/constructs/README.md index 619da22b8..642ee28b9 100644 --- a/zos_basics/constructs/README.md +++ b/zos_basics/constructs/README.md @@ -23,9 +23,11 @@ be determined if a sample has access to the host’s resources. Review the playbook for additional details and configuration. > [!IMPORTANT] -> The release of `ibm_zos_core` collection version 1.10.0 introduces case-sensitive +> The release of `ibm_zos_core` collection version 1.10.0 introduced case-sensitive > changes to modules, specifically that module choices must be lower case. See the porting -> guide in the release notes (here) to understand the full scope of these changes. +> guide in the release notes +> ([here](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#porting-guide)) +> to understand the full scope of these changes. > > These changes require sample playbook updates that are not compatible with earlier > versions of the `ibm_zos_core` collection. @@ -33,9 +35,11 @@ playbook for additional details and configuration. > To support both the latest and prior versions of the collection: > > * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. -> * The ` ibm-z-playbooks-2024` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. See the compatible version of the playbook here .??? +> * The `ibm-z-playbooks-2024` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. > -> The ` ibm-z-playbooks-2024` branch will remain available until April 2025 but will no longer receive updates. +> The `ibm-z-playbooks-2024` branch will remain available until April 2025 but will not receive updates. +> +> ## Playbook Requirements - [IBM® z/OS® core collection 1.0.0 or later](https://galaxy.ansible.com/ibm/ibm_zos_core) From 74ccb603e009f58ba9589b7366e40b6e0afc2443 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Mon, 24 Jun 2024 18:41:37 -0700 Subject: [PATCH 13/18] tweak ibm_zos_core v1.10 release update to playbook README Signed-off-by: Ketan Kelkar --- zos_basics/constructs/README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/zos_basics/constructs/README.md b/zos_basics/constructs/README.md index 642ee28b9..efeadea3e 100644 --- a/zos_basics/constructs/README.md +++ b/zos_basics/constructs/README.md @@ -29,15 +29,15 @@ playbook for additional details and configuration. > ([here](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#porting-guide)) > to understand the full scope of these changes. > -> These changes require sample playbook updates that are not compatible with earlier -> versions of the `ibm_zos_core` collection. +> These changes are not compatible with earlier versions of the `ibm_zos_core` collection, +> and since the earlier versions do not reach their end of life until April 2025, +> the sample playbook compatible with the older versions will remain available. > -> To support both the latest and prior versions of the collection: -> +> To support both the latest and prior versions of the collection: > * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. -> * The `ibm-z-playbooks-2024` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. > -> The `ibm-z-playbooks-2024` branch will remain available until April 2025 but will not receive updates. +> The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. > > From cec53f29f9611dc8cf8534b28ece6776a18b586d Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Mon, 24 Jun 2024 18:47:49 -0700 Subject: [PATCH 14/18] ibm_zos_core v1.10 release update to playbook README Signed-off-by: Ketan Kelkar --- .../data_sets/copy_edit_submit/README.md | 19 +++++++++++++++++++ .../archive_copy_unarchive_restore/README.md | 19 +++++++++++++++++++ .../jobs/submit_query_retrieve/README.md | 19 +++++++++++++++++++ zos_concepts/templates/loadlib/README.md | 19 +++++++++++++++++++ .../templates/submit_job_template/README.md | 19 +++++++++++++++++++ .../README.md | 19 +++++++++++++++++++ 6 files changed, 114 insertions(+) diff --git a/zos_concepts/data_sets/copy_edit_submit/README.md b/zos_concepts/data_sets/copy_edit_submit/README.md index c9d1d4c6d..f356394bc 100644 --- a/zos_concepts/data_sets/copy_edit_submit/README.md +++ b/zos_concepts/data_sets/copy_edit_submit/README.md @@ -14,6 +14,25 @@ It is a good practice to review the playbook contents before executing them. It will help you understand the requirements in terms of space, location, names, authority, and the artifacts that will be created and cleaned up. +> [!IMPORTANT] +> The release of `ibm_zos_core` collection version 1.10.0 introduced case-sensitive +> changes to modules, specifically that module choices must be lower case. See the porting +> guide in the release notes +> ([here](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#porting-guide)) +> to understand the full scope of these changes. +> +> These changes are not compatible with earlier versions of the `ibm_zos_core` collection, +> and since the earlier versions do not reach their end of life until April 2025, +> the sample playbook compatible with the older versions will remain available. +> +> To support both the latest and prior versions of the collection: +> * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> +> The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. +> +> + ## Playbook Requirements This playbook requires: diff --git a/zos_concepts/data_transfer/archive_copy_unarchive_restore/README.md b/zos_concepts/data_transfer/archive_copy_unarchive_restore/README.md index 13cb82b49..d0860d54d 100644 --- a/zos_concepts/data_transfer/archive_copy_unarchive_restore/README.md +++ b/zos_concepts/data_transfer/archive_copy_unarchive_restore/README.md @@ -21,6 +21,25 @@ names, authority, and the artifacts that will be created and cleaned up. - [**archive_fetch_data_sets.yml**](archive_fetch_data_sets.yml) - Dumps and archive of data sets. - [**unarchive_data_sets.yml**](unarchive_data_sets.yml) - Transfers, unarchives, and restores the target data set archive. +> [!IMPORTANT] +> The release of `ibm_zos_core` collection version 1.10.0 introduced case-sensitive +> changes to modules, specifically that module choices must be lower case. See the porting +> guide in the release notes +> ([here](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#porting-guide)) +> to understand the full scope of these changes. +> +> These changes are not compatible with earlier versions of the `ibm_zos_core` collection, +> and since the earlier versions do not reach their end of life until April 2025, +> the sample playbook compatible with the older versions will remain available. +> +> To support both the latest and prior versions of the collection: +> * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> +> The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. +> +> + ## Playbook Requirements This playbook requires: diff --git a/zos_concepts/jobs/submit_query_retrieve/README.md b/zos_concepts/jobs/submit_query_retrieve/README.md index 65801cfef..9de6160bd 100644 --- a/zos_concepts/jobs/submit_query_retrieve/README.md +++ b/zos_concepts/jobs/submit_query_retrieve/README.md @@ -19,6 +19,25 @@ It is a good practice to review the playbook contents before executing them. It will help you understand the requirements in terms of space, location, names, authority, and the artifacts that will be created and cleaned up. +> [!IMPORTANT] +> The release of `ibm_zos_core` collection version 1.10.0 introduced case-sensitive +> changes to modules, specifically that module choices must be lower case. See the porting +> guide in the release notes +> ([here](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#porting-guide)) +> to understand the full scope of these changes. +> +> These changes are not compatible with earlier versions of the `ibm_zos_core` collection, +> and since the earlier versions do not reach their end of life until April 2025, +> the sample playbook compatible with the older versions will remain available. +> +> To support both the latest and prior versions of the collection: +> * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> +> The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. +> +> + ## Playbook Requirements This playbook requires: diff --git a/zos_concepts/templates/loadlib/README.md b/zos_concepts/templates/loadlib/README.md index 008b9a406..01d8826f2 100644 --- a/zos_concepts/templates/loadlib/README.md +++ b/zos_concepts/templates/loadlib/README.md @@ -16,6 +16,25 @@ It is a good practice to review the playbook contents before executing them. It will help you understand the requirements in terms of space, location, names, authority, and the artifacts that will be created and cleaned up. +> [!IMPORTANT] +> The release of `ibm_zos_core` collection version 1.10.0 introduced case-sensitive +> changes to modules, specifically that module choices must be lower case. See the porting +> guide in the release notes +> ([here](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#porting-guide)) +> to understand the full scope of these changes. +> +> These changes are not compatible with earlier versions of the `ibm_zos_core` collection, +> and since the earlier versions do not reach their end of life until April 2025, +> the sample playbook compatible with the older versions will remain available. +> +> To support both the latest and prior versions of the collection: +> * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> +> The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. +> +> + ## Playbook Requirements This playbook requires: diff --git a/zos_concepts/templates/submit_job_template/README.md b/zos_concepts/templates/submit_job_template/README.md index cfaf47d45..56add72d9 100644 --- a/zos_concepts/templates/submit_job_template/README.md +++ b/zos_concepts/templates/submit_job_template/README.md @@ -12,6 +12,25 @@ It is a good practice to review the playbook contents before executing them. It will help you understand the requirements in terms of space, location, names, authority, and the artifacts that will be created and cleaned up. +> [!IMPORTANT] +> The release of `ibm_zos_core` collection version 1.10.0 introduced case-sensitive +> changes to modules, specifically that module choices must be lower case. See the porting +> guide in the release notes +> ([here](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#porting-guide)) +> to understand the full scope of these changes. +> +> These changes are not compatible with earlier versions of the `ibm_zos_core` collection, +> and since the earlier versions do not reach their end of life until April 2025, +> the sample playbook compatible with the older versions will remain available. +> +> To support both the latest and prior versions of the collection: +> * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> +> The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. +> +> + ## Playbook Requirements This playbook requires: diff --git a/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/README.md b/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/README.md index f8b5de837..b409e20d7 100644 --- a/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/README.md +++ b/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/README.md @@ -20,6 +20,25 @@ It is a good practice to review the playbook contents before executing them. It will help you understand the requirements in terms of space, location, names, authority, and the artifacts that will be created and cleaned up. +> [!IMPORTANT] +> The release of `ibm_zos_core` collection version 1.10.0 introduced case-sensitive +> changes to modules, specifically that module choices must be lower case. See the porting +> guide in the release notes +> ([here](https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/release_notes.html#porting-guide)) +> to understand the full scope of these changes. +> +> These changes are not compatible with earlier versions of the `ibm_zos_core` collection, +> and since the earlier versions do not reach their end of life until April 2025, +> the sample playbook compatible with the older versions will remain available. +> +> To support both the latest and prior versions of the collection: +> * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> +> The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. +> +> + ## Playbook Requirements This playbook requires: From 060391ae82cec404a476054d33ac989468452f74 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Tue, 25 Jun 2024 09:10:15 -0700 Subject: [PATCH 15/18] update copyright year Signed-off-by: Ketan Kelkar --- .../inventories/host_vars/source.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/source.yml b/zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/source.yml index 445e66d6f..ee6a0e7d8 100644 --- a/zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/source.yml +++ b/zos_concepts/data_transfer/archive_copy_unarchive_restore/inventories/host_vars/source.yml @@ -1,5 +1,5 @@ ################################################################################ -# Copyright (c) IBM Corporation 2023 +# Copyright (c) IBM Corporation 2024 ################################################################################ ################################################################################ From e1d65c02ac732b400560f5d426371d9403ef2326 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Tue, 25 Jun 2024 15:55:14 -0700 Subject: [PATCH 16/18] add links to README Signed-off-by: Ketan Kelkar --- zos_basics/constructs/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/zos_basics/constructs/README.md b/zos_basics/constructs/README.md index efeadea3e..80d83e4ac 100644 --- a/zos_basics/constructs/README.md +++ b/zos_basics/constructs/README.md @@ -35,7 +35,9 @@ playbook for additional details and configuration. > > To support both the latest and prior versions of the collection: > * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * Find this playbook on the `main` branch: [here] (https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_basics/constructs). > * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> * Find this playbook on the `ibm_zos_core-v1.9.x-samples` branch: [here] (https://github.com/IBM/z_ansible_collections_samples/tree/ibm_zos_core-v1.9.x-samples/zos_basics/constructs). > > The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. > From adf179fde43e4b4438719498ed4c651e5cc6a3f2 Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Tue, 25 Jun 2024 15:56:24 -0700 Subject: [PATCH 17/18] fix links in README Signed-off-by: Ketan Kelkar --- zos_basics/constructs/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zos_basics/constructs/README.md b/zos_basics/constructs/README.md index 80d83e4ac..3ae10acbd 100644 --- a/zos_basics/constructs/README.md +++ b/zos_basics/constructs/README.md @@ -35,9 +35,9 @@ playbook for additional details and configuration. > > To support both the latest and prior versions of the collection: > * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. -> * Find this playbook on the `main` branch: [here] (https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_basics/constructs). +> * Find this playbook on the `main` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_basics/constructs). > * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. -> * Find this playbook on the `ibm_zos_core-v1.9.x-samples` branch: [here] (https://github.com/IBM/z_ansible_collections_samples/tree/ibm_zos_core-v1.9.x-samples/zos_basics/constructs). +> * Find this playbook on the `ibm_zos_core-v1.9.x-samples` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/ibm_zos_core-v1.9.x-samples/zos_basics/constructs). > > The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. > From 6924383031a1a37a475e67e90cec5c2abce2398f Mon Sep 17 00:00:00 2001 From: Ketan Kelkar Date: Tue, 25 Jun 2024 16:07:46 -0700 Subject: [PATCH 18/18] add links to README Signed-off-by: Ketan Kelkar --- zos_concepts/data_sets/copy_edit_submit/README.md | 2 ++ .../data_transfer/archive_copy_unarchive_restore/README.md | 2 ++ zos_concepts/jobs/submit_query_retrieve/README.md | 2 ++ zos_concepts/templates/loadlib/README.md | 2 ++ zos_concepts/templates/submit_job_template/README.md | 2 ++ .../init_dasd_vol_and_run_sample_jcl/README.md | 2 ++ 6 files changed, 12 insertions(+) diff --git a/zos_concepts/data_sets/copy_edit_submit/README.md b/zos_concepts/data_sets/copy_edit_submit/README.md index f356394bc..852c88fd4 100644 --- a/zos_concepts/data_sets/copy_edit_submit/README.md +++ b/zos_concepts/data_sets/copy_edit_submit/README.md @@ -27,7 +27,9 @@ names, authority, and the artifacts that will be created and cleaned up. > > To support both the latest and prior versions of the collection: > * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * Find this playbook on the `main` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_concepts/data_sets/copy_edit_submit). > * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> * Find this playbook on the `ibm_zos_core-v1.9.x-samples` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/ibm_zos_core-v1.9.x-samples/zos_concepts/data_sets/copy_edit_submit). > > The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. > diff --git a/zos_concepts/data_transfer/archive_copy_unarchive_restore/README.md b/zos_concepts/data_transfer/archive_copy_unarchive_restore/README.md index d0860d54d..f18db489c 100644 --- a/zos_concepts/data_transfer/archive_copy_unarchive_restore/README.md +++ b/zos_concepts/data_transfer/archive_copy_unarchive_restore/README.md @@ -34,7 +34,9 @@ names, authority, and the artifacts that will be created and cleaned up. > > To support both the latest and prior versions of the collection: > * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * Find this playbook on the `main` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_concepts/data_transfer/archive_copy_unarchive_restore). > * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> * Find this playbook on the `ibm_zos_core-v1.9.x-samples` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/ibm_zos_core-v1.9.x-samples/zos_concepts/data_transfer/archive_copy_unarchive_restore). > > The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. > diff --git a/zos_concepts/jobs/submit_query_retrieve/README.md b/zos_concepts/jobs/submit_query_retrieve/README.md index 9de6160bd..6f0b9713c 100644 --- a/zos_concepts/jobs/submit_query_retrieve/README.md +++ b/zos_concepts/jobs/submit_query_retrieve/README.md @@ -32,7 +32,9 @@ names, authority, and the artifacts that will be created and cleaned up. > > To support both the latest and prior versions of the collection: > * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * Find this playbook on the `main` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_concepts/jobs/submit_query_retrieve). > * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> * Find this playbook on the `ibm_zos_core-v1.9.x-samples` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/ibm_zos_core-v1.9.x-samples/zos_concepts/jobs/submit_query_retrieve). > > The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. > diff --git a/zos_concepts/templates/loadlib/README.md b/zos_concepts/templates/loadlib/README.md index 01d8826f2..d0907ca01 100644 --- a/zos_concepts/templates/loadlib/README.md +++ b/zos_concepts/templates/loadlib/README.md @@ -29,7 +29,9 @@ names, authority, and the artifacts that will be created and cleaned up. > > To support both the latest and prior versions of the collection: > * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * Find this playbook on the `main` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_concepts/templates/loadlib). > * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> * Find this playbook on the `ibm_zos_core-v1.9.x-samples` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/ibm_zos_core-v1.9.x-samples/zos_concepts/templates/loadlib). > > The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. > diff --git a/zos_concepts/templates/submit_job_template/README.md b/zos_concepts/templates/submit_job_template/README.md index 56add72d9..08f4202f6 100644 --- a/zos_concepts/templates/submit_job_template/README.md +++ b/zos_concepts/templates/submit_job_template/README.md @@ -25,7 +25,9 @@ names, authority, and the artifacts that will be created and cleaned up. > > To support both the latest and prior versions of the collection: > * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * Find this playbook on the `main` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_concepts/templates/submit_job_template). > * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> * Find this playbook on the `ibm_zos_core-v1.9.x-samples` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/ibm_zos_core-v1.9.x-samples/zos_concepts/templates/submit_job_template). > > The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. > diff --git a/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/README.md b/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/README.md index b409e20d7..3b50b7c1f 100644 --- a/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/README.md +++ b/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl/README.md @@ -33,7 +33,9 @@ authority, and the artifacts that will be created and cleaned up. > > To support both the latest and prior versions of the collection: > * The `main` branch will reflect playbooks compatible with `ibm_zos_core` version 1.10.0 or later. +> * Find this playbook on the `main` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl). > * The `ibm_zos_core-v1.9.x-samples` branch will reflect playbooks compatible with `ibm_zos_core` version 1.9.x or earlier. +> * Find this playbook on the `ibm_zos_core-v1.9.x-samples` branch: [here](https://github.com/IBM/z_ansible_collections_samples/tree/ibm_zos_core-v1.9.x-samples/zos_concepts/volume_management/volume_initialization/init_dasd_vol_and_run_sample_jcl). > > The `ibm_zos_core-v1.9.x-samples` branch will remain available until April 2025 but will not receive updates. >