From 4bc7053f514001d05d89dfb5348fb89f5c1cbdbd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andr=C3=A9=20Marcel=20Guti=C3=A9rrez=20Ben=C3=ADtez?=
 <Andre.Marcel.Gutierrez@ibm.com>
Date: Thu, 2 Oct 2025 18:33:59 -0600
Subject: [PATCH 1/3] Add warning to values will change on new implementations

---
 plugins/modules/zos_apf.py                   |  9 +++++-
 plugins/modules/zos_archive.py               | 30 ++++++++++++++++++--
 plugins/modules/zos_copy.py                  | 19 +++++++++++--
 plugins/modules/zos_fetch.py                 | 10 +++++--
 plugins/modules/zos_find.py                  |  5 ++++
 plugins/modules/zos_job_output.py            |  9 ++++--
 plugins/modules/zos_job_submit.py            | 17 +++++++++--
 plugins/modules/zos_mount.py                 | 18 ++++++++++--
 plugins/modules/zos_operator.py              | 10 +++++--
 plugins/modules/zos_operator_action_query.py | 12 +++++++-
 plugins/modules/zos_unarchive.py             | 27 +++++++++++++++---
 11 files changed, 144 insertions(+), 22 deletions(-)

diff --git a/plugins/modules/zos_apf.py b/plugins/modules/zos_apf.py
index 211a1f4789..9e427c6bb2 100644
--- a/plugins/modules/zos_apf.py
+++ b/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,11 @@ def main():
     try:
         parser = better_arg_parser.BetterArgParser(arg_defs)
         parsed_args = parser.parse_args(module.params)
+
+        if module.params.get('data_set_name') is not None:
+            module.warn("The 'data_set_name' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'target' instead.")
+
     except ValueError as err:
         module.fail_json(msg="Parameter verification failed", stderr=str(err))
 
diff --git a/plugins/modules/zos_archive.py b/plugins/modules/zos_archive.py
index a02ec00a59..bf64af49b0 100644
--- a/plugins/modules/zos_archive.py
+++ b/plugins/modules/zos_archive.py
@@ -57,6 +57,7 @@
         type: str
         required: false
         default: gz
+        aliases: [type]
         choices:
           - bz2
           - gz
@@ -70,6 +71,7 @@
           - 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: [adrdssus]
   dest:
     description:
       - The remote absolute path or data set where the archive should be
@@ -1874,15 +1878,18 @@ 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',
@@ -1890,6 +1897,7 @@ def run_module():
                             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(
@@ -2051,6 +2063,20 @@ def run_module():
     try:
         parser = better_arg_parser.BetterArgParser(arg_defs)
         parsed_args = parser.parse_args(module.params)
+
+        if module.params.get('format') is not None and module.params.get('format').get('name') is not None:
+            module.warn("The 'name' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'type' instead.")
+        if module.params.get('format') is not None and module.params.get('format').get('format_options') is not None:
+            module.warn("The 'format_options' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'options' instead.")
+        if module.params.get('format') is not None and module.params.get('format').get('format_options') is not None and module.params.get('format').get('format_options').get("terse_pack") is not None:
+            module.warn("The 'terse_pack' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'spack' instead.")
+        if module.params.get('format') is not None and module.params.get('format').get('format_options') is not None and module.params.get('format').get('format_options').get("use_adrdssu")is not None:
+            module.warn("The 'use_adrdssu' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'adrdssu' instead.")
+
         module.params = parsed_args
     except ValueError as err:
         module.fail_json(msg="Parameter verification failed", stderr=str(err))
diff --git a/plugins/modules/zos_copy.py b/plugins/modules/zos_copy.py
index 0d2ac02134..27d93b66d6 100644
--- a/plugins/modules/zos_copy.py
+++ b/plugins/modules/zos_copy.py
@@ -193,6 +193,7 @@
     type: bool
     default: false
     required: false
+    aliases: [replace]
   force_lock:
     description:
       - By default, when C(dest) is a MVS data set and is being used by another
@@ -236,6 +237,7 @@
     type: bool
     default: false
     required: false
+    aliases: [binary]
   executable:
     description:
       - If set to C(true), indicates that the file or library to be copied is an executable.
@@ -4015,7 +4017,7 @@ def main():
         argument_spec=dict(
             src=dict(type='str'),
             dest=dict(required=True, type='str'),
-            is_binary=dict(type='bool', default=False),
+            is_binary=dict(type='bool', default=False, aliases=["binary"]),
             executable=dict(type='bool', default=False),
             asa_text=dict(type='bool', default=False),
             aliases=dict(type='bool', default=False, required=False),
@@ -4108,7 +4110,7 @@ def main():
                     autoescape=dict(type='bool', default=True),
                 )
             ),
-            force=dict(type='bool', default=False),
+            force=dict(type='bool', default=False, aliases=["replace"]),
             force_lock=dict(type='bool', default=False),
             mode=dict(type='str', required=False),
             owner=dict(type='str', required=False),
@@ -4120,7 +4122,7 @@ def main():
     arg_def = dict(
         src=dict(arg_type='data_set_or_path', required=False),
         dest=dict(arg_type='data_set_or_path', required=True),
-        is_binary=dict(arg_type='bool', required=False, default=False),
+        is_binary=dict(arg_type='bool', required=False, default=False, aliases=["binary"]),
         executable=dict(arg_type='bool', required=False, default=False),
         asa_text=dict(arg_type='bool', required=False, default=False),
         aliases=dict(arg_type='bool', required=False, default=False),
@@ -4132,6 +4134,7 @@ def main():
         checksum=dict(arg_type='str', required=False),
         validate=dict(arg_type='bool', required=False),
         volume=dict(arg_type='str', required=False),
+        force=dict(type='bool', default=False, aliases=["replace"]),
         force_lock=dict(type='bool', default=False),
 
         dest_data_set=dict(
@@ -4210,6 +4213,16 @@ def main():
             )
         )
 
+    if module.params.get("force") is not None:
+        module.warn("The 'force' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'replace' instead.")
+    if module.params.get("force_lock") is not None:
+        module.warn("The 'force_lock' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "For the 2.0.0 version please use 'force' instead.")
+    if module.params.get("is_binary") is not None:
+        module.warn("The 'is_binary' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'binary' instead.")
+
     res_args = conv_path = None
     try:
         res_args, conv_path = run_module(module, arg_def)
diff --git a/plugins/modules/zos_fetch.py b/plugins/modules/zos_fetch.py
index 62004698aa..e33931939c 100644
--- a/plugins/modules/zos_fetch.py
+++ b/plugins/modules/zos_fetch.py
@@ -83,6 +83,7 @@
     required: false
     default: "false"
     type: bool
+    aliases: [binary]
   use_qualifier:
     description:
       - Indicates whether the data set high level qualifier should be used when
@@ -849,7 +850,7 @@ def run_module():
             dest=dict(required=True, type="path"),
             fail_on_missing=dict(required=False, default=True, type="bool"),
             flat=dict(required=False, default=False, type="bool"),
-            is_binary=dict(required=False, default=False, type="bool"),
+            is_binary=dict(required=False, default=False, type="bool", aliases=["binary"]),
             use_qualifier=dict(required=False, default=False, type="bool"),
             validate_checksum=dict(required=False, default=True, type="bool"),
             encoding=dict(required=False, type="dict"),
@@ -872,7 +873,7 @@ def run_module():
         src=dict(arg_type="data_set_or_path", required=True),
         dest=dict(arg_type="path", required=True),
         fail_on_missing=dict(arg_type="bool", required=False, default=True),
-        is_binary=dict(arg_type="bool", required=False, default=False),
+        is_binary=dict(arg_type="bool", required=False, default=False, aliases=["binary"]),
         use_qualifier=dict(arg_type="bool", required=False, default=False),
         tmp_hlq=dict(type='qualifier_or_empty', required=False, default=None),
     )
@@ -907,6 +908,11 @@ def run_module():
 
     fetch_handler = FetchHandler(module)
     try:
+
+        if module.params.get("is_binary") is not None:
+            module.warn("The 'is_binary' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'binary' instead.")
+
         parser = better_arg_parser.BetterArgParser(arg_def)
         parsed_args = parser.parse_args(module.params)
     except ValueError as err:
diff --git a/plugins/modules/zos_find.py b/plugins/modules/zos_find.py
index 68319b9171..59394690f0 100644
--- a/plugins/modules/zos_find.py
+++ b/plugins/modules/zos_find.py
@@ -1231,6 +1231,7 @@ def run_module(module):
         Failed to process size.
     """
     # Parameter initialization
+    pds_paths = None
     age = module.params.get('age')
     age_stamp = module.params.get('age_stamp')
     contains = module.params.get('contains')
@@ -1260,6 +1261,10 @@ def run_module(module):
     filtered_migrated_types = set()
     vsam_migrated_types = set()
 
+    if pds_paths is not None:
+        module.warn("The 'pds_pattern' parameter and aliases is deprecated and will be removed in a 2.0.0 release.\n"
+                        "On 2.0.0 version to serach for an specific member required regex isnide ().")
+
     for type in resource_type:
         if type in vsam_types:
             filtered_resource_types.add("VSAM")
diff --git a/plugins/modules/zos_job_output.py b/plugins/modules/zos_job_output.py
index b2a7cdcaa4..996eaca9d2 100644
--- a/plugins/modules/zos_job_output.py
+++ b/plugins/modules/zos_job_output.py
@@ -62,6 +62,7 @@
         (e.g "JESJCL", "?")
     type: str
     required: false
+    aliases: [dd_name]
   sysin_dd:
     description:
       - Whether to include SYSIN DDs as part of the output.
@@ -507,7 +508,7 @@ def run_module():
         job_id=dict(type="str", required=False),
         job_name=dict(type="str", required=False),
         owner=dict(type="str", required=False),
-        ddname=dict(type="str", required=False),
+        ddname=dict(type="str", required=False, aliases=["dd_name"]),
         sysin_dd=dict(type="bool", required=False, default=False),
     )
 
@@ -517,7 +518,7 @@ def run_module():
         job_id=dict(type="job_identifier", required=False),
         job_name=dict(type="job_identifier", required=False),
         owner=dict(type="str", required=False),
-        ddname=dict(type="str", required=False),
+        ddname=dict(type="str", required=False, aliases=["dd_name"]),
         sysin_dd=dict(type="bool", required=False, default=False),
     )
 
@@ -531,6 +532,10 @@ def run_module():
             stderr=str(err)
         )
 
+    if module.params.get(ddname) is not None:
+        module.warn("The 'ddname' parameter is deprecated and will be use as alias in a 2.0.0 release.\n"
+                        "Please use 'dd_name' instead.")
+
     job_id = module.params.get("job_id")
     job_name = module.params.get("job_name")
     owner = module.params.get("owner")
diff --git a/plugins/modules/zos_job_submit.py b/plugins/modules/zos_job_submit.py
index 0917fc0079..2cb440c028 100644
--- a/plugins/modules/zos_job_submit.py
+++ b/plugins/modules/zos_job_submit.py
@@ -50,6 +50,7 @@
     required: false
     default: data_set
     type: str
+    aliases: [remote_src]
     choices:
       - data_set
       - uss
@@ -63,6 +64,7 @@
     required: false
     default: 10
     type: int
+    aliases: [wait_time]
     description:
       - Option I(wait_time_s) is the total time that module
         L(zos_job_submit,./zos_job_submit.html) will wait for a submitted job
@@ -948,6 +950,7 @@ def run_module():
             type="str",
             default="data_set",
             choices=["data_set", "uss", "local"],
+            aliases=["remote_src"]
         ),
         encoding=dict(
             type="dict",
@@ -967,7 +970,7 @@ def run_module():
         ),
         volume=dict(type="str", required=False),
         return_output=dict(type="bool", required=False, default=True),
-        wait_time_s=dict(type="int", default=10),
+        wait_time_s=dict(type="int", default=10, wait_time=["wait_time"]),
         max_rc=dict(type="int", required=False),
         use_template=dict(type='bool', default=False),
         template_parameters=dict(
@@ -1019,6 +1022,7 @@ def run_module():
             arg_type="str",
             default="data_set",
             choices=["data_set", "uss", "local"],
+            aliases=["remote_src"]
         ),
         from_encoding=dict(
             arg_type="encoding", default=Defaults.DEFAULT_ASCII_CHARSET, required=False),
@@ -1027,7 +1031,7 @@ def run_module():
         ),
         volume=dict(arg_type="volume", required=False),
         return_output=dict(arg_type="bool", default=True),
-        wait_time_s=dict(arg_type="int", required=False, default=10),
+        wait_time_s=dict(arg_type="int", required=False, default=10, aliases=["wait_time"]),
         max_rc=dict(arg_type="int", required=False),
     )
 
@@ -1042,6 +1046,15 @@ def run_module():
         module.fail_json(
             msg="Parameter verification failed", stderr=str(err))
 
+    if module.params.get("location") is not None:
+        module.warn("The 'location' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'remote_src' instead. Logic will change to set if the document with the job is" \
+                        "on the controller or the node")
+
+    if module.params.get("wait_time_s") is not None:
+        module.warn("The 'wait_time_s' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'wait_time' instead.")
+
     # Extract values from set module options
     location = parsed_args.get("location")
     volume = parsed_args.get("volume")
diff --git a/plugins/modules/zos_mount.py b/plugins/modules/zos_mount.py
index a35dda095a..afd575983c 100644
--- a/plugins/modules/zos_mount.py
+++ b/plugins/modules/zos_mount.py
@@ -117,6 +117,7 @@
                       This is usually BPXPRMxx or a copy.
                 required: True
                 type: str
+                aliases: [name]
             backup:
                 description:
                     - Creates a backup file or backup data set for
@@ -160,6 +161,7 @@
                 type: list
                 elements: str
                 required: False
+                aliases: [marker]
     unmount_opts:
         description:
             - Describes how the unmount will be performed.
@@ -754,6 +756,15 @@ def run_module(module, arg_def):
 
     if persistent:
         data_store = persistent.get("data_store").upper()
+
+        if data_store:
+            module.warn("The 'data_store' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'name' instead.")
+
+        if persistent.get("comment") is not None:
+            module.warn("The 'comment' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'marker' instead.")
+
         comment = persistent.get("comment")
         backup = persistent.get("backup")
         if backup:
@@ -1133,10 +1144,11 @@ def main():
                     data_store=dict(
                         type="str",
                         required=True,
+                        aliases=["name"]
                     ),
                     backup=dict(type="bool", default=False),
                     backup_name=dict(type="str", required=False, default=None),
-                    comment=dict(type="list", elements="str", required=False),
+                    comment=dict(type="list", elements="str", required=False, aliases=["marker"]),
                 ),
             ),
             unmount_opts=dict(
@@ -1193,10 +1205,10 @@ def main():
             arg_type="dict",
             required=False,
             options=dict(
-                data_store=dict(arg_type="str", required=True),
+                data_store=dict(arg_type="str", required=True, aliases=["name"]),
                 backup=dict(arg_type="bool", default=False),
                 backup_name=dict(arg_type="str", required=False, default=None),
-                comment=dict(arg_type="list", elements="str", required=False),
+                comment=dict(arg_type="list", elements="str", required=False, aliases=["marker"]),
             ),
         ),
         unmount_opts=dict(
diff --git a/plugins/modules/zos_operator.py b/plugins/modules/zos_operator.py
index ab529cf335..939e300f63 100644
--- a/plugins/modules/zos_operator.py
+++ b/plugins/modules/zos_operator.py
@@ -61,6 +61,7 @@
     type: int
     required: false
     default: 1
+    aliases: [wait_time]
   case_sensitive:
     description:
       - If C(true), the command will not be converted to uppercase before
@@ -252,7 +253,7 @@ def run_module():
     module_args = dict(
         cmd=dict(type="str", required=True),
         verbose=dict(type="bool", required=False, default=False),
-        wait_time_s=dict(type="int", required=False, default=1),
+        wait_time_s=dict(type="int", required=False, default=1, aliases=["wait_time"]),
         case_sensitive=dict(type="bool", required=False, default=False),
     )
 
@@ -264,6 +265,11 @@ def run_module():
         module.fail_json(msg="An error ocurred while importing ZOAU: {0}".format(opercmd.traceback))
 
     try:
+
+        if module.params.get('wait_time_s') is not None:
+            module.warn("The 'wait_time_s' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'wait time' instead. And option 'time_unit' will be added to set cs o seconds.")
+
         new_params = parse_params(module.params)
         rc_message = run_operator_command(new_params)
         result["rc"] = rc_message.get("rc")
@@ -339,7 +345,7 @@ def parse_params(params):
     arg_defs = dict(
         cmd=dict(arg_type="str", required=True),
         verbose=dict(arg_type="bool", required=False),
-        wait_time_s=dict(arg_type="int", required=False),
+        wait_time_s=dict(arg_type="int", required=False, aliases=["wait_time"]),
         case_sensitive=dict(arg_type="bool", required=False),
     )
     parser = BetterArgParser(arg_defs)
diff --git a/plugins/modules/zos_operator_action_query.py b/plugins/modules/zos_operator_action_query.py
index 525518a2f2..cb9b3acc08 100644
--- a/plugins/modules/zos_operator_action_query.py
+++ b/plugins/modules/zos_operator_action_query.py
@@ -90,6 +90,7 @@
         required: False
         type: bool
         default: False
+        aliases: [literal]
 seealso:
 - module: zos_operator
 
@@ -267,7 +268,12 @@ def run_module():
             required=False,
             options=dict(
                 filter=dict(type="str", required=True),
-                use_regex=dict(default=False, type="bool", required=False)
+                use_regex=dict(
+                    default=False,
+                    type="bool",
+                    required=False,
+                    aliases=["literal"]
+                    )
             )
         )
     )
@@ -276,6 +282,10 @@ def run_module():
     module = AnsibleModule(argument_spec=module_args, supports_check_mode=False)
     requests = []
     try:
+        if module.params.get('use_regex') is not None:
+            module.warn("The 'use_regex' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'literal' instead. On 2.0.0 version will work on reverse logic being" \
+                        "False to use as regex.")
         new_params = parse_params(module.params)
 
         kwargs = {}
diff --git a/plugins/modules/zos_unarchive.py b/plugins/modules/zos_unarchive.py
index 970d789a6b..afe2ad4614 100644
--- a/plugins/modules/zos_unarchive.py
+++ b/plugins/modules/zos_unarchive.py
@@ -51,6 +51,7 @@
           - The compression format used while archiving.
         type: str
         required: true
+        aliases: [type]
         choices:
           - bz2
           - gz
@@ -64,6 +65,7 @@
           - Options specific to a compression format.
         type: dict
         required: false
+        aliases: [options]
         suboptions:
           xmit_log_data_set:
             description:
@@ -84,6 +86,7 @@
                 a portable format after using C(xmit) or C(terse).
             type: bool
             default: False
+            aliases: [adrdssu]
           dest_volumes:
             description:
               - When I(use_adrdssu=True), specify the volume the data sets
@@ -1597,11 +1600,13 @@ def run_module():
                     name=dict(
                         type='str',
                         required=True,
-                        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(
                             xmit_log_data_set=dict(
                                 type='str',
@@ -1614,6 +1619,7 @@ def run_module():
                             use_adrdssu=dict(
                                 type='bool',
                                 default=False,
+                                aliases=['adrdssu']
                             )
                         )
                     ),
@@ -1701,12 +1707,13 @@ def run_module():
                 name=dict(
                     type='str',
                     required=True,
-                    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(
                         xmit_log_data_set=dict(
                             type='str',
@@ -1714,11 +1721,12 @@ def run_module():
                         ),
                         dest_volumes=dict(
                             type='list',
-                            elements='str'
+                            elements='str',
                         ),
                         use_adrdssu=dict(
                             type='bool',
                             default=False,
+                            aliases=['adrdssu']
                         ),
                     ),
                     default=dict(xmit_log_data_set=""),
@@ -1770,6 +1778,17 @@ def run_module():
     try:
         parser = better_arg_parser.BetterArgParser(arg_defs)
         parsed_args = parser.parse_args(module.params)
+
+        if module.params.get('format') is not None and module.params.get('format').get('name') is not None:
+            module.warn("The 'name' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'type' instead.")
+        if module.params.get('format') is not None and module.params.get('format').get('format_options') is not None:
+            module.warn("The 'format_options' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'options' instead.")
+        if module.params.get('format') is not None and module.params.get('format').get('format_options') is not None and module.params.get('format').get('format_options').get("use_adrdssu") is not None:
+            module.warn("The 'use_adrdssu' parameter is deprecated and will be removed in a 2.0.0 release.\n"
+                        "Please use 'adrdssu' instead.")
+
         module.params = parsed_args
     except ValueError as err:
         module.fail_json(msg="Parameter verification failed", stderr=str(err))

From 7b36ef3244e2a987cfea5bb8a7de305602d8a2bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andr=C3=A9=20Marcel=20Guti=C3=A9rrez=20Ben=C3=ADtez?=
 <Andre.Marcel.Gutierrez@ibm.com>
Date: Mon, 6 Oct 2025 15:42:35 -0600
Subject: [PATCH 2/3] Add fails to avoid fails pipeliine

---
 .secrets.baseline            | 85 ++++++++++++++++++++++++++++++++++++
 branch_protection_rules.json | 12 +++++
 2 files changed, 97 insertions(+)
 create mode 100644 .secrets.baseline
 create mode 100644 branch_protection_rules.json

diff --git a/.secrets.baseline b/.secrets.baseline
new file mode 100644
index 0000000000..e1a888d658
--- /dev/null
+++ b/.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
+  }
+}
diff --git a/branch_protection_rules.json b/branch_protection_rules.json
new file mode 100644
index 0000000000..ec67bed7dd
--- /dev/null
+++ b/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"
+      ]
+    }
+}]
\ No newline at end of file

From 72eb66952ca0e77dc2dd44ddaa83e5e15933df73 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andr=C3=A9=20Marcel=20Guti=C3=A9rrez=20Ben=C3=ADtez?=
 <Andre.Marcel.Gutierrez@ibm.com>
Date: Mon, 6 Oct 2025 16:03:29 -0600
Subject: [PATCH 3/3] Add fragments

---
 ...-raw-option-for-generic-dcb-selection.yml} |  0
 ...d_deprecation_messages_for_new_version.yml | 32 +++++++++++++++++++
 2 files changed, 32 insertions(+)
 rename changelogs/fragments/{2341-zos_mvs_raw-Add-raw-option-for-generic-dcb-selection => 2341-zos_mvs_raw-Add-raw-option-for-generic-dcb-selection.yml} (100%)
 create mode 100644 changelogs/fragments/2553-Add_aliases_and_deprecation_messages_for_new_version.yml

diff --git a/changelogs/fragments/2341-zos_mvs_raw-Add-raw-option-for-generic-dcb-selection b/changelogs/fragments/2341-zos_mvs_raw-Add-raw-option-for-generic-dcb-selection.yml
similarity index 100%
rename from changelogs/fragments/2341-zos_mvs_raw-Add-raw-option-for-generic-dcb-selection
rename to changelogs/fragments/2341-zos_mvs_raw-Add-raw-option-for-generic-dcb-selection.yml
diff --git a/changelogs/fragments/2553-Add_aliases_and_deprecation_messages_for_new_version.yml b/changelogs/fragments/2553-Add_aliases_and_deprecation_messages_for_new_version.yml
new file mode 100644
index 0000000000..be2a8e1b2b
--- /dev/null
+++ b/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_nam``  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_s`` for ``wait_time`` 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).
\ No newline at end of file