From efd9cff33a3180f5a84cdf404cf6624ec6ceaddf Mon Sep 17 00:00:00 2001 From: Pavan Satwik <> Date: Thu, 21 Nov 2024 19:43:04 +0530 Subject: [PATCH 1/5] Added missing attributes to examples. --- docs/source/modules/cmci_action.rst | 17 ++++++++--------- docs/source/modules/cmci_create.rst | 1 + docs/source/modules/cmci_delete.rst | 3 ++- docs/source/modules/cmci_get.rst | 1 + docs/source/modules/cmci_update.rst | 3 ++- plugins/modules/cmci_action.py | 17 ++++++++--------- plugins/modules/cmci_create.py | 1 + plugins/modules/cmci_delete.py | 3 ++- plugins/modules/cmci_get.py | 1 + plugins/modules/cmci_update.py | 3 ++- 10 files changed, 28 insertions(+), 22 deletions(-) diff --git a/docs/source/modules/cmci_action.rst b/docs/source/modules/cmci_action.rst index 2d9d41a..043bdf7 100644 --- a/docs/source/modules/cmci_action.rst +++ b/docs/source/modules/cmci_action.rst @@ -374,16 +374,15 @@ Examples - name: install a bundle in a CICS region cmci_action: cmci_host: "example.com" - cmci_port: "12345" - context: "plex_or_applid" - type: CICSBundle - action_name: install - resource: + scheme: "http" + cmci_port: 1234 + context: "plex or applid" + scope: "regionName" + type: "CICSBundle" + action_name: DISABLE + resources: filter: - name: "PONGALT" - action_parameters: - - name: "usage" - value: "local" + name: "bundle" diff --git a/docs/source/modules/cmci_create.rst b/docs/source/modules/cmci_create.rst index 916342f..a8294b3 100644 --- a/docs/source/modules/cmci_create.rst +++ b/docs/source/modules/cmci_create.rst @@ -226,6 +226,7 @@ Examples cmci_port: 12345 context: "plex_or_applid" type: "CICSDefinitionBundle" + scope: "cics region" attributes: name: PONGALT bundledir: /u/ibmuser/bundle/pong/pongbundle_1.0.0 diff --git a/docs/source/modules/cmci_delete.rst b/docs/source/modules/cmci_delete.rst index f25a9ab..5d3e0f2 100644 --- a/docs/source/modules/cmci_delete.rst +++ b/docs/source/modules/cmci_delete.rst @@ -326,7 +326,7 @@ Examples cmci_port: 12345 context: "plex_or_applid" type: CICSBundle - resource: + resources: filter: name: "PONGALT" @@ -336,6 +336,7 @@ Examples cmci_port: 12345 context: "plex_or_applid" type: CICSDefinitionBundle + scope: "cics region" resource: filter: name: "PONGALT" diff --git a/docs/source/modules/cmci_get.rst b/docs/source/modules/cmci_get.rst index 83fd343..f965642 100644 --- a/docs/source/modules/cmci_get.rst +++ b/docs/source/modules/cmci_get.rst @@ -395,6 +395,7 @@ Examples cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" context: "plex_or_applid" + scope: "cics region" type: cicsdefinitionbundle resources: filter: diff --git a/docs/source/modules/cmci_update.rst b/docs/source/modules/cmci_update.rst index 5851a34..5c8ee98 100644 --- a/docs/source/modules/cmci_update.rst +++ b/docs/source/modules/cmci_update.rst @@ -362,12 +362,13 @@ Examples cmci_host: "example.com" cmci_port: "12345" context: "plex_or_applid" + scope: "cics region name" type: "CICSDefinitionBundle" attributes: description: "New description" update_parameters: - name: csd - resource: + resources: filter: name: "PONGALT" get_parameters: diff --git a/plugins/modules/cmci_action.py b/plugins/modules/cmci_action.py index adbc694..93f6c05 100644 --- a/plugins/modules/cmci_action.py +++ b/plugins/modules/cmci_action.py @@ -84,16 +84,15 @@ - name: install a bundle in a CICS region cmci_action: cmci_host: "example.com" - cmci_port: "12345" - context: "plex_or_applid" - type: CICSBundle - action_name: install - resource: + scheme: "http" + cmci_port: 1234 + context: "plex or applid" + scope: "regionName" + type: "CICSBundle" + action_name: DISABLE + resources: filter: - name: "PONGALT" - action_parameters: - - name: "usage" - value: "local" + name: "bundle" """ diff --git a/plugins/modules/cmci_create.py b/plugins/modules/cmci_create.py index fc77269..ce32058 100644 --- a/plugins/modules/cmci_create.py +++ b/plugins/modules/cmci_create.py @@ -63,6 +63,7 @@ cmci_port: 12345 context: "plex_or_applid" type: "CICSDefinitionBundle" + scope: "cics region" attributes: name: PONGALT bundledir: /u/ibmuser/bundle/pong/pongbundle_1.0.0 diff --git a/plugins/modules/cmci_delete.py b/plugins/modules/cmci_delete.py index 5a58c48..547eba2 100644 --- a/plugins/modules/cmci_delete.py +++ b/plugins/modules/cmci_delete.py @@ -38,7 +38,7 @@ cmci_port: 12345 context: "plex_or_applid" type: CICSBundle - resource: + resources: filter: name: "PONGALT" @@ -48,6 +48,7 @@ cmci_port: 12345 context: "plex_or_applid" type: CICSDefinitionBundle + scope: "cics region" resource: filter: name: "PONGALT" diff --git a/plugins/modules/cmci_get.py b/plugins/modules/cmci_get.py index 4e24df6..dc5f4c8 100644 --- a/plugins/modules/cmci_get.py +++ b/plugins/modules/cmci_get.py @@ -104,6 +104,7 @@ cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" context: "plex_or_applid" + scope: "cics region" type: cicsdefinitionbundle resources: filter: diff --git a/plugins/modules/cmci_update.py b/plugins/modules/cmci_update.py index 444fd11..a0eccc0 100644 --- a/plugins/modules/cmci_update.py +++ b/plugins/modules/cmci_update.py @@ -63,12 +63,13 @@ cmci_host: "example.com" cmci_port: "12345" context: "plex_or_applid" + scope: "cics region name" type: "CICSDefinitionBundle" attributes: description: "New description" update_parameters: - name: csd - resource: + resources: filter: name: "PONGALT" get_parameters: From 865c84d8b97c132740cd288ea2cf4f470a26cc11 Mon Sep 17 00:00:00 2001 From: Pavan Satwik <> Date: Thu, 28 Nov 2024 16:23:38 +0530 Subject: [PATCH 2/5] Updated scope and context with the comments --- docs/source/modules/cmci_action.rst | 7 +++---- docs/source/modules/cmci_create.rst | 4 ++-- docs/source/modules/cmci_delete.rst | 6 +++--- docs/source/modules/cmci_get.rst | 12 ++++++------ docs/source/modules/cmci_update.rst | 4 ++-- plugins/modules/cmci_action.py | 7 +++---- plugins/modules/cmci_create.py | 4 ++-- plugins/modules/cmci_delete.py | 6 +++--- plugins/modules/cmci_get.py | 12 ++++++------ plugins/modules/cmci_update.py | 4 ++-- 10 files changed, 32 insertions(+), 34 deletions(-) diff --git a/docs/source/modules/cmci_action.rst b/docs/source/modules/cmci_action.rst index 043bdf7..7212110 100644 --- a/docs/source/modules/cmci_action.rst +++ b/docs/source/modules/cmci_action.rst @@ -361,7 +361,7 @@ Examples cmci_action: cmci_host: "example.com" cmci_port: 12345 - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: "CICSProgram" action_name: NEWCOPY resource: @@ -374,10 +374,9 @@ Examples - name: install a bundle in a CICS region cmci_action: cmci_host: "example.com" - scheme: "http" cmci_port: 1234 - context: "plex or applid" - scope: "regionName" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: "CICSBundle" action_name: DISABLE resources: diff --git a/docs/source/modules/cmci_create.rst b/docs/source/modules/cmci_create.rst index a8294b3..958a4aa 100644 --- a/docs/source/modules/cmci_create.rst +++ b/docs/source/modules/cmci_create.rst @@ -224,9 +224,9 @@ Examples cmci_create: cmci_host: "example.com" cmci_port: 12345 - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: "CICSDefinitionBundle" - scope: "cics region" + scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) attributes: name: PONGALT bundledir: /u/ibmuser/bundle/pong/pongbundle_1.0.0 diff --git a/docs/source/modules/cmci_delete.rst b/docs/source/modules/cmci_delete.rst index 5d3e0f2..fa4c72a 100644 --- a/docs/source/modules/cmci_delete.rst +++ b/docs/source/modules/cmci_delete.rst @@ -324,7 +324,7 @@ Examples cmci_delete: cmci_host: "example.com" cmci_port: 12345 - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: CICSBundle resources: filter: @@ -334,9 +334,9 @@ Examples cmci_delete: cmci_host: "example.com" cmci_port: 12345 - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: CICSDefinitionBundle - scope: "cics region" + scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) resource: filter: name: "PONGALT" diff --git a/docs/source/modules/cmci_get.rst b/docs/source/modules/cmci_get.rst index f965642..c4c66a4 100644 --- a/docs/source/modules/cmci_get.rst +++ b/docs/source/modules/cmci_get.rst @@ -351,7 +351,7 @@ Examples cmci_port: 12345 cmci_user: "ibmuser" cmci_password: "123456" - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: CICSLocalFile record_count: 2 resource: @@ -364,7 +364,7 @@ Examples cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: "CICSLocalFile" resources: filter: @@ -378,7 +378,7 @@ Examples cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: cicsdefinitionprogram resources: filter: @@ -394,8 +394,8 @@ Examples cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "plex_or_applid" - scope: "cics region" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: cicsdefinitionbundle resources: filter: @@ -412,7 +412,7 @@ Examples cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: "CICSRegion" resources: complex_filter: diff --git a/docs/source/modules/cmci_update.rst b/docs/source/modules/cmci_update.rst index 5c8ee98..37b4ba6 100644 --- a/docs/source/modules/cmci_update.rst +++ b/docs/source/modules/cmci_update.rst @@ -361,8 +361,8 @@ Examples cmci_update: cmci_host: "example.com" cmci_port: "12345" - context: "plex_or_applid" - scope: "cics region name" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: "CICSDefinitionBundle" attributes: description: "New description" diff --git a/plugins/modules/cmci_action.py b/plugins/modules/cmci_action.py index 93f6c05..5bc0bf0 100644 --- a/plugins/modules/cmci_action.py +++ b/plugins/modules/cmci_action.py @@ -71,7 +71,7 @@ cmci_action: cmci_host: "example.com" cmci_port: 12345 - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: "CICSProgram" action_name: NEWCOPY resource: @@ -84,10 +84,9 @@ - name: install a bundle in a CICS region cmci_action: cmci_host: "example.com" - scheme: "http" cmci_port: 1234 - context: "plex or applid" - scope: "regionName" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: "CICSBundle" action_name: DISABLE resources: diff --git a/plugins/modules/cmci_create.py b/plugins/modules/cmci_create.py index ce32058..61e0dc3 100644 --- a/plugins/modules/cmci_create.py +++ b/plugins/modules/cmci_create.py @@ -61,9 +61,9 @@ cmci_create: cmci_host: "example.com" cmci_port: 12345 - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: "CICSDefinitionBundle" - scope: "cics region" + scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) attributes: name: PONGALT bundledir: /u/ibmuser/bundle/pong/pongbundle_1.0.0 diff --git a/plugins/modules/cmci_delete.py b/plugins/modules/cmci_delete.py index 547eba2..4117d40 100644 --- a/plugins/modules/cmci_delete.py +++ b/plugins/modules/cmci_delete.py @@ -36,7 +36,7 @@ cmci_delete: cmci_host: "example.com" cmci_port: 12345 - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: CICSBundle resources: filter: @@ -46,9 +46,9 @@ cmci_delete: cmci_host: "example.com" cmci_port: 12345 - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: CICSDefinitionBundle - scope: "cics region" + scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) resource: filter: name: "PONGALT" diff --git a/plugins/modules/cmci_get.py b/plugins/modules/cmci_get.py index dc5f4c8..7332558 100644 --- a/plugins/modules/cmci_get.py +++ b/plugins/modules/cmci_get.py @@ -60,7 +60,7 @@ cmci_port: 12345 cmci_user: "ibmuser" cmci_password: "123456" - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: CICSLocalFile record_count: 2 resource: @@ -73,7 +73,7 @@ cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: "CICSLocalFile" resources: filter: @@ -87,7 +87,7 @@ cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: cicsdefinitionprogram resources: filter: @@ -103,8 +103,8 @@ cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "plex_or_applid" - scope: "cics region" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: cicsdefinitionbundle resources: filter: @@ -121,7 +121,7 @@ cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "plex_or_applid" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: "CICSRegion" resources: complex_filter: diff --git a/plugins/modules/cmci_update.py b/plugins/modules/cmci_update.py index a0eccc0..66b59b9 100644 --- a/plugins/modules/cmci_update.py +++ b/plugins/modules/cmci_update.py @@ -62,8 +62,8 @@ cmci_update: cmci_host: "example.com" cmci_port: "12345" - context: "plex_or_applid" - scope: "cics region name" + context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: "CICSDefinitionBundle" attributes: description: "New description" From 1e7c53815980a196c6fe01a4888149e38b92f4a8 Mon Sep 17 00:00:00 2001 From: Pavan Satwik <> Date: Mon, 2 Dec 2024 11:00:06 +0530 Subject: [PATCH 3/5] updated the scope with 8 character long name --- docs/source/modules/cmci_action.rst | 2 +- docs/source/modules/cmci_create.rst | 2 +- docs/source/modules/cmci_delete.rst | 2 +- docs/source/modules/cmci_get.rst | 2 +- docs/source/modules/cmci_update.rst | 2 +- plugins/modules/cmci_action.py | 2 +- plugins/modules/cmci_create.py | 2 +- plugins/modules/cmci_delete.py | 2 +- plugins/modules/cmci_get.py | 2 +- plugins/modules/cmci_update.py | 2 +- 10 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/source/modules/cmci_action.rst b/docs/source/modules/cmci_action.rst index 7212110..85fac6b 100644 --- a/docs/source/modules/cmci_action.rst +++ b/docs/source/modules/cmci_action.rst @@ -376,7 +376,7 @@ Examples cmci_host: "example.com" cmci_port: 1234 context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: "CICSBundle" action_name: DISABLE resources: diff --git a/docs/source/modules/cmci_create.rst b/docs/source/modules/cmci_create.rst index 958a4aa..48f3f0a 100644 --- a/docs/source/modules/cmci_create.rst +++ b/docs/source/modules/cmci_create.rst @@ -226,7 +226,7 @@ Examples cmci_port: 12345 context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: "CICSDefinitionBundle" - scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) attributes: name: PONGALT bundledir: /u/ibmuser/bundle/pong/pongbundle_1.0.0 diff --git a/docs/source/modules/cmci_delete.rst b/docs/source/modules/cmci_delete.rst index fa4c72a..8210fac 100644 --- a/docs/source/modules/cmci_delete.rst +++ b/docs/source/modules/cmci_delete.rst @@ -336,7 +336,7 @@ Examples cmci_port: 12345 context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: CICSDefinitionBundle - scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) resource: filter: name: "PONGALT" diff --git a/docs/source/modules/cmci_get.rst b/docs/source/modules/cmci_get.rst index c4c66a4..b8601b5 100644 --- a/docs/source/modules/cmci_get.rst +++ b/docs/source/modules/cmci_get.rst @@ -395,7 +395,7 @@ Examples cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: cicsdefinitionbundle resources: filter: diff --git a/docs/source/modules/cmci_update.rst b/docs/source/modules/cmci_update.rst index 37b4ba6..86e1c6e 100644 --- a/docs/source/modules/cmci_update.rst +++ b/docs/source/modules/cmci_update.rst @@ -362,7 +362,7 @@ Examples cmci_host: "example.com" cmci_port: "12345" context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: "CICSDefinitionBundle" attributes: description: "New description" diff --git a/plugins/modules/cmci_action.py b/plugins/modules/cmci_action.py index 5bc0bf0..87ccb98 100644 --- a/plugins/modules/cmci_action.py +++ b/plugins/modules/cmci_action.py @@ -86,7 +86,7 @@ cmci_host: "example.com" cmci_port: 1234 context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: "CICSBundle" action_name: DISABLE resources: diff --git a/plugins/modules/cmci_create.py b/plugins/modules/cmci_create.py index 61e0dc3..a436957 100644 --- a/plugins/modules/cmci_create.py +++ b/plugins/modules/cmci_create.py @@ -63,7 +63,7 @@ cmci_port: 12345 context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: "CICSDefinitionBundle" - scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) attributes: name: PONGALT bundledir: /u/ibmuser/bundle/pong/pongbundle_1.0.0 diff --git a/plugins/modules/cmci_delete.py b/plugins/modules/cmci_delete.py index 4117d40..89b0840 100644 --- a/plugins/modules/cmci_delete.py +++ b/plugins/modules/cmci_delete.py @@ -48,7 +48,7 @@ cmci_port: 12345 context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: CICSDefinitionBundle - scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) resource: filter: name: "PONGALT" diff --git a/plugins/modules/cmci_get.py b/plugins/modules/cmci_get.py index 7332558..b669a0b 100644 --- a/plugins/modules/cmci_get.py +++ b/plugins/modules/cmci_get.py @@ -104,7 +104,7 @@ cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: cicsdefinitionbundle resources: filter: diff --git a/plugins/modules/cmci_update.py b/plugins/modules/cmci_update.py index 66b59b9..9aa7b2e 100644 --- a/plugins/modules/cmci_update.py +++ b/plugins/modules/cmci_update.py @@ -63,7 +63,7 @@ cmci_host: "example.com" cmci_port: "12345" context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - scope: "CSYDEF/CSYSGRP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: "CICSDefinitionBundle" attributes: description: "New description" From 87555bc8be9ca1981a32ec2f0aa5ab2478497ce1 Mon Sep 17 00:00:00 2001 From: Stewart Francis Date: Thu, 5 Dec 2024 15:38:36 +0000 Subject: [PATCH 4/5] Fix cmci_action examples Signed-off-by: Stewart Francis --- plugins/modules/cmci_action.py | 22 ++++++++++------------ 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/plugins/modules/cmci_action.py b/plugins/modules/cmci_action.py index 87ccb98..073cd1d 100644 --- a/plugins/modules/cmci_action.py +++ b/plugins/modules/cmci_action.py @@ -71,27 +71,25 @@ cmci_action: cmci_host: "example.com" cmci_port: 12345 - context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - type: "CICSProgram" + context: ABCDEFGH # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + type: CICSProgram action_name: NEWCOPY - resource: + resources: filter: - name: "PONGALT" - get_parameters: - - name: "csdgroup" - value: "JVMGRP" + name: PONGALT - name: install a bundle in a CICS region cmci_action: cmci_host: "example.com" cmci_port: 1234 - context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) - type: "CICSBundle" - action_name: DISABLE + context: ABCDEFGH # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + scope: IJKLMNOP # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + type: CICSBundle + action_name: CSDINSTALL resources: filter: - name: "bundle" + name: bundle + csdgroup: mygrp """ From a87004aa0a2a07ce51dbca330d44b78a85404c4e Mon Sep 17 00:00:00 2001 From: Stewart Francis Date: Thu, 5 Dec 2024 16:11:46 +0000 Subject: [PATCH 5/5] Fix some other example errors, standardize bare words, title case in descriptions Signed-off-by: Stewart Francis --- plugins/modules/cmci_action.py | 8 +++++--- plugins/modules/cmci_create.py | 10 +++++----- plugins/modules/cmci_delete.py | 16 ++++++++-------- plugins/modules/cmci_get.py | 30 +++++++++++++++--------------- plugins/modules/cmci_update.py | 14 +++++++------- 5 files changed, 40 insertions(+), 38 deletions(-) diff --git a/plugins/modules/cmci_action.py b/plugins/modules/cmci_action.py index 073cd1d..4c1164c 100644 --- a/plugins/modules/cmci_action.py +++ b/plugins/modules/cmci_action.py @@ -78,7 +78,7 @@ filter: name: PONGALT -- name: install a bundle in a CICS region +- name: Install a bundle definition from CSD in a CICS region cmci_action: cmci_host: "example.com" cmci_port: 1234 @@ -88,8 +88,10 @@ action_name: CSDINSTALL resources: filter: - name: bundle - csdgroup: mygrp + name: mybund + get_parameters: + - name: csdgroup + value: mygrp """ diff --git a/plugins/modules/cmci_create.py b/plugins/modules/cmci_create.py index a436957..effa225 100644 --- a/plugins/modules/cmci_create.py +++ b/plugins/modules/cmci_create.py @@ -57,19 +57,19 @@ EXAMPLES = r""" -- name: define a BUNDLE in a CSD +- name: Define a BUNDLE in CSD cmci_create: cmci_host: "example.com" cmci_port: 12345 - context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - type: "CICSDefinitionBundle" - scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + context: ABCDEFGH # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + type: CICSDefinitionBundle + scope: IJKLMNOP # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) attributes: name: PONGALT bundledir: /u/ibmuser/bundle/pong/pongbundle_1.0.0 csdgroup: JVMGRP create_parameters: - - name: "csd" + - name: csd """ diff --git a/plugins/modules/cmci_delete.py b/plugins/modules/cmci_delete.py index 89b0840..e37ad35 100644 --- a/plugins/modules/cmci_delete.py +++ b/plugins/modules/cmci_delete.py @@ -36,25 +36,25 @@ cmci_delete: cmci_host: "example.com" cmci_port: 12345 - context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + context: ABCDEFGH # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: CICSBundle resources: filter: - name: "PONGALT" + name: PONGALT - name: delete a bundle definition in a CICS region cmci_delete: cmci_host: "example.com" cmci_port: 12345 - context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + context: ABCDEFGH # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: CICSDefinitionBundle - scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) - resource: + scope: IJKLMNOP # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + resources: filter: - name: "PONGALT" + name: PONGALT get_parameters: - - name: "csdgroup" - value: "JVMGRP" + - name: csdgroup + value: JVMGRP """ diff --git a/plugins/modules/cmci_get.py b/plugins/modules/cmci_get.py index b669a0b..08cfac4 100644 --- a/plugins/modules/cmci_get.py +++ b/plugins/modules/cmci_get.py @@ -54,40 +54,40 @@ EXAMPLES = r""" -- name: get 2 LOCFILEs from a CICSplex +- name: Get 2 LOCFILEs from a CICSplex cmci_get: cmci_host: "example.com" cmci_port: 12345 - cmci_user: "ibmuser" + cmci_user: ibmuser cmci_password: "123456" - context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + context: ABCDEFGH # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: CICSLocalFile record_count: 2 - resource: + resources: filter: dsname: "CTS*" -- name: get a localfile in a CICS region +- name: Get a localfile in a CICS region cmci_get: cmci_host: "example.com" cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - type: "CICSLocalFile" + context: ABCDEFGH # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + type: CICSLocalFile resources: filter: dsname: "XIAOPIN*" file: "DFH*" record_count: 1 -- name: get a progdef from a CSD +- name: Get a progdef from CSD cmci_get: cmci_host: "example.com" cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + context: ABCDEFGH # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment type: cicsdefinitionprogram resources: filter: @@ -97,14 +97,14 @@ value: MYGRP record_count: 1 -- name: pass module even if bundle definition is not found +- name: Ignore errors when bundle definition is not found cmci_get: cmci_host: "example.com" cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + context: ABCDEFGH # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + scope: IJKLMNOP # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) type: cicsdefinitionbundle resources: filter: @@ -113,7 +113,7 @@ - name: csdgroup value: MYGRP record_count: 1 - fail_on_nodata: "false" + fail_on_nodata: false - name: Using complex_filter to combine filter expressions and change operators cmci_get: @@ -121,8 +121,8 @@ cmci_port: 12345 cmci_cert: "./sec/ansible.pem" cmci_key: "./sec/ansible.key" - context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - type: "CICSRegion" + context: ABCDEFGH # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + type: CICSRegion resources: complex_filter: or: diff --git a/plugins/modules/cmci_update.py b/plugins/modules/cmci_update.py index 9aa7b2e..d700c5b 100644 --- a/plugins/modules/cmci_update.py +++ b/plugins/modules/cmci_update.py @@ -58,20 +58,20 @@ EXAMPLES = r""" -- name: update a bundle definition in a CICS region +- name: Update the description of a bundle definition in CSD cmci_update: cmci_host: "example.com" - cmci_port: "12345" - context: "ABCDEFGH" # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment - scope: "IJKLMNOP" # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) - type: "CICSDefinitionBundle" + cmci_port: 12345 + context: ABCDEFGH # context is the name of your CICSplex in a CPSM environment or the applid of your region in an SMSS environment + scope: IJKLMNOP # scope only applies if you're in a CPSM environment and is either the name of a CICS system definition (CSYSDEF) or CICS system group (CSYSGRP) + type: CICSDefinitionBundle attributes: - description: "New description" + description: New description update_parameters: - name: csd resources: filter: - name: "PONGALT" + name: PONGALT get_parameters: - name: csdgroup value: JVMGRP