[Enabler][2294]Add_aliases_and_deprecation_messages_for_new_version

.secrets.baseline

@@ -0,0 +1,85 @@
+{
+  "exclude": {
+    "files": "zos_mvs_raw.rst|^.secrets.baseline$",
+    "lines": null
+  },
+  "generated_at": "2025-10-06T17:53:30Z",
+  "plugins_used": [
+    {
+      "name": "AWSKeyDetector"
+    },
+    {
+      "name": "ArtifactoryDetector"
+    },
+    {
+      "name": "AzureStorageKeyDetector"
+    },
+    {
+      "base64_limit": 4.5,
+      "name": "Base64HighEntropyString"
+    },
+    {
+      "name": "BasicAuthDetector"
+    },
+    {
+      "name": "BoxDetector"
+    },
+    {
+      "name": "CloudantDetector"
+    },
+    {
+      "ghe_instance": "github.ibm.com",
+      "name": "GheDetector"
+    },
+    {
+      "name": "GitHubTokenDetector"
+    },
+    {
+      "hex_limit": 3,
+      "name": "HexHighEntropyString"
+    },
+    {
+      "name": "IbmCloudIamDetector"
+    },
+    {
+      "name": "IbmCosHmacDetector"
+    },
+    {
+      "name": "JwtTokenDetector"
+    },
+    {
+      "keyword_exclude": null,
+      "name": "KeywordDetector"
+    },
+    {
+      "name": "MailchimpDetector"
+    },
+    {
+      "name": "NpmDetector"
+    },
+    {
+      "name": "PrivateKeyDetector"
+    },
+    {
+      "name": "SlackDetector"
+    },
+    {
+      "name": "SoftlayerDetector"
+    },
+    {
+      "name": "SquareOAuthDetector"
+    },
+    {
+      "name": "StripeDetector"
+    },
+    {
+      "name": "TwilioKeyDetector"
+    }
+  ],
+  "results": {},
+  "version": "0.13.1+ibm.64.dss",
+  "word_list": {
+    "file": null,
+    "hash": null
+  }
+}

branch_protection_rules.json

@@ -0,0 +1,12 @@
+[{
+    "type": "branch-protection",
+    "name": "code-review",
+    "params": {
+      "checks": [
+        "tekton/code-branch-protection",
+        "tekton/code-unit-tests",
+        "tekton/code-vulnerability-scan",
+        "tekton/code-detect-secrets"
+      ]
+    }
+}]

changelogs/fragments/2553-Add_aliases_and_deprecation_messages_for_new_version.yml

@@ -0,0 +1,32 @@
+minor_changes:
+  - zos_apf - Adds new aliases ``target`` for ``data_set_name``  and warning message that will be deprecated on 2.0.0.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
+  - zos_archive - Adds new aliases ``type`` for ``name`` and warning message that will be deprecated on 2.0.0.
+  - zos_archive - Adds new aliases ``options`` for ``format_options`` and warning message that will be deprecated on 2.0.0.
+  - zos_archive - Adds new aliases ``spack`` for ``terse_pack`` and warning message that will be deprecated on 2.0.0.
+  - zos_archive - Adds new aliases ``adrdssus`` for ``use_adrdssu`` and warning message that will be deprecated on 2.0.0.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
+  - zos_copy - Adds new aliases ``replace`` for ``force`` and warning message that will be deprecated on 2.0.0.
+  - zos_copy - Adds new aliases ``binary`` for ``is_binary`` and warning message that will be deprecated on 2.0.0.
+  - zos_copy - Adds warning message for ``force_lock`` that will be deprecated on 2.0.0.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
+  - zos_fetch - Adds new aliases ``binary`` for ``is_binary`` and warning message that will be deprecated on 2.0.0.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
+  - zos_find - Adds warning message for ``pds_paths`` that will be deprecated on 2.0.0.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
+  - zos_job_output - Adds new aliases ``dd_name`` for ``ddname`` and warning message that will be aliases on 2.0.0.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
+  - zos_job_submit - Adds new aliases ``remote_src`` for ``location`` and warning message that will be deprecated on 2.0.0.
+  - zos_job_submit - Adds new aliases ``wait_time`` for ``wait_time_s`` and warning message that will be deprecated on 2.0.0.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
+  - zos_mount - Adds new aliases ``name`` for ``data_store`` and warning message that will be deprecated on 2.0.0.
+  - zos_mount - Adds new aliases ``marker`` for ``comment`` and warning message that will be deprecated on 2.0.0.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
+  - zos_operator - Adds new aliases ``wait_time`` for ``wait_time_s`` and warning message that will be deprecated on 2.0.0.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
+  - zos_operator_action_query - Adds new aliases ``literal`` for ``use_regex`` and warning message that will be deprecated on 2.0.0.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/2353).
+  - zos_unarchive - Adds new aliases ``type`` for ``name`` and warning message that will be deprecated on 2.0.0.
+  - zos_unarchive - Adds new aliases ``options`` for ``format_options`` and warning message that will be deprecated on 2.0.0.
+  - zos_unarchive - Adds new aliases ``adrdssus`` for ``use_adrdssu`` and warning message that will be deprecated on 2.0.0.
+    (https://github.com/ansible-collections/ibm_zos_core/pull/2353).

plugins/action/zos_fetch.py

@@ -129,6 +129,13 @@ def run(self, tmp=None, task_vars=None):
             self._task.args.get("validate_checksum"), default=True
         )
 
+        if is_binary is not None:
+            display.deprecated(
+                msg="The 'is_binary' parameter will be deprecated. Use 'binary' instead.",
+                version="2.0.0",
+                collection_name='ibm.ibm_zos_core',
+            )
+
         # ********************************************************** #
         #                 Parameter checks                           #
         # ********************************************************** #

plugins/module_utils/better_arg_parser.py

@@ -1108,12 +1108,6 @@ def _add_alias(self, arg_name, arg_aliases=None, aliases=None):
             aliases = {}
         arg_aliases.append(arg_name)
         for alternate_name in arg_aliases:
-            if aliases.get(alternate_name, arg_name) != arg_name:
-                raise ValueError(
-                    'Conflicting aliases "{0}" and "{1}" found for name "{2}"'.format(
-                        aliases.get(alternate_name), alternate_name, arg_name
-                    )
-                )
             aliases[alternate_name] = arg_name
         return aliases
 

plugins/modules/zos_apf.py

@@ -113,6 +113,7 @@
             the APF list.
         required: True
         type: str
+        aliases: [target]
       marker:
         description:
           - The marker line template.
@@ -439,6 +440,7 @@ def main():
                     data_set_name=dict(
                         type='str',
                         required=True,
+                        aliases=["target"],
                     ),
                     marker=dict(
                         type='str',
@@ -503,7 +505,7 @@ def main():
             arg_type='dict',
             required=False,
             options=dict(
-                data_set_name=dict(arg_type='str', required=True),
+                data_set_name=dict(arg_type='str', required=True, aliases=["target"]),
                 marker=dict(arg_type='str', required=False, default='/* {mark} ANSIBLE MANAGED BLOCK <timestamp> */'),
                 backup=dict(arg_type='bool', default=False),
                 backup_name=dict(arg_type='str', required=False, default=None),
@@ -534,6 +536,16 @@ def main():
     try:
         parser = better_arg_parser.BetterArgParser(arg_defs)
         parsed_args = parser.parse_args(module.params)
+
+        persistent_param = module.params.get('persistent', {})
+
+        if persistent_param.get('data_set_name') is not None:
+            module.deprecate(
+                msg="The 'persistent.data_set_name' parameter will be deprecated. Please use 'persistent.target' instead.",
+                version="2.0.0",
+                collection_name='ibm.ibm_zos_core',
+            )
+
     except ValueError as err:
         module.fail_json(msg="Parameter verification failed", stderr=str(err))
 

plugins/modules/zos_archive.py

@@ -65,11 +65,13 @@
           - terse
           - xmit
           - pax
+        aliases: [type]
       format_options:
         description:
           - Options specific to a compression format.
         type: dict
         required: false
+        aliases: [options]
         suboptions:
           terse_pack:
             description:
@@ -86,6 +88,7 @@
             choices:
               - pack
               - spack
+            aliases: [spack]
           xmit_log_data_set:
             description:
               - Provide the name of a data set to store xmit log output.
@@ -105,6 +108,7 @@
                 portable format before using C(xmit) or C(terse).
             type: bool
             default: false
+            aliases: [adrdssu]
   dest:
     description:
       - The remote absolute path or data set where the archive should be
@@ -1874,22 +1878,26 @@ def run_module():
                     name=dict(
                         type='str',
                         default='gz',
-                        choices=['bz2', 'gz', 'tar', 'zip', 'terse', 'xmit', 'pax']
+                        choices=['bz2', 'gz', 'tar', 'zip', 'terse', 'xmit', 'pax'],
+                        aliases=['type'],
                     ),
                     format_options=dict(
                         type='dict',
                         required=False,
+                        aliases=['options'],
                         options=dict(
                             terse_pack=dict(
                                 type='str',
                                 choices=['pack', 'spack'],
+                                aliases=['spack']
                             ),
                             xmit_log_data_set=dict(
                                 type='str',
                             ),
                             use_adrdssu=dict(
                                 type='bool',
                                 default=False,
+                                aliases=['adrdssu']
                             )
                         ),
                     ),
@@ -1969,16 +1977,19 @@ def run_module():
                 name=dict(
                     type='str',
                     default='gz',
-                    choices=['bz2', 'gz', 'tar', 'zip', 'terse', 'xmit', 'pax']
+                    choices=['bz2', 'gz', 'tar', 'zip', 'terse', 'xmit', 'pax'],
+                    aliases=['type'],
                 ),
                 format_options=dict(
                     type='dict',
                     required=False,
+                    aliases=["options"],
                     options=dict(
                         terse_pack=dict(
                             type='str',
                             required=False,
                             choices=['pack', 'spack'],
+                            aliases=['spack']
                         ),
                         xmit_log_data_set=dict(
                             type='str',
@@ -1987,6 +1998,7 @@ def run_module():
                         use_adrdssu=dict(
                             type='bool',
                             default=False,
+                            aliases=['adrdssu']
                         )
                     ),
                     default=dict(
@@ -2045,6 +2057,39 @@ def run_module():
         original_message='',
         message=''
     )
+
+    format_param = module.params.get('format', {})
+
+    if format_param.get('name') is not None:
+        module.deprecate(
+            msg="The 'format.name' parameter will be deprecated. Please use 'format.type' instead.",
+            version="2.0.0",
+            collection_name='ibm.ibm_zos_core',
+        )
+
+    if format_param.get('format_options') is not None:
+        module.deprecate(
+            msg="The 'format.format_options' parameter will be deprecated. Use 'format.options' instead.",
+            version="2.0.0",
+            collection_name='ibm.ibm_zos_core',
+        )
+
+        optopms_deprecate = format_param['format_options']
+
+        if optopms_deprecate.get('terse_pack') is not None:
+            module.deprecate(
+                msg="The 'format.format_options.terse_pack' parameter will be deprecated. On new version use 'format.format_options.spack' instead.",
+                version="2.0.0",
+                collection_name='ibm.ibm_zos_core',
+            )
+
+        if optopms_deprecate.get('use_adrdssu') is not None:
+            module.deprecate(
+                msg="The 'format.format_options.use_adrdssu' parameter will be deprecated. On new version use 'format.format_options.adrdssu' instead.",
+                version="2.0.0",
+                collection_name='ibm.ibm_zos_core',
+            )
+
     if module.check_mode:
         module.exit_json(**result)