Changes already merged to staging1.16 for 761 and 2123

changelogs/fragments/2207-SYSIN-support-zos_job_output.yml

@@ -0,0 +1,3 @@
+minor_changes:
+   - zos_job_output - Adds support to query SYSIN DDs from a job with new option input.
+     (https://github.com/ansible-collections/ibm_zos_core/pull/2207)

changelogs/fragments/2213-test-case-conditional-failure-2-19.yml

@@ -0,0 +1,16 @@
+trivial:
+   - test_zos_copy_func.py - modified test case `test_job_script_async`
+     to resolve porting issues to ansible 2.19.
+     (https://github.com/ansible-collections/ibm_zos_core/pull/2213).
+
+   - test_zos_job_submit_func.py - modified test case `test_job_submit_async`
+     to resolve porting issues to ansible 2.19.
+     (https://github.com/ansible-collections/ibm_zos_core/pull/2213).
+
+   - test_zos_script_func.py - modified test case `test_job_script_async`
+     to resolve porting issues to ansible 2.19.
+     (https://github.com/ansible-collections/ibm_zos_core/pull/2213).
+
+   - test_zos_unarchive_func.py - modified test case `test_zos_unarchive_async`
+     to resolve porting issues to ansible 2.19.
+     (https://github.com/ansible-collections/ibm_zos_core/pull/2213).

plugins/module_utils/job.py

@@ -58,7 +58,7 @@
                                 ])
 
 
-def job_output(job_id=None, owner=None, job_name=None, dd_name=None, dd_scan=True, duration=0, timeout=0, start_time=timer()):
+def job_output(job_id=None, owner=None, job_name=None, dd_name=None, sysin=False, dd_scan=True, duration=0, timeout=0, start_time=timer()):
     """Get the output from a z/OS job based on various search criteria.
 
     Keyword Parameters
@@ -71,6 +71,8 @@ def job_output(job_id=None, owner=None, job_name=None, dd_name=None, dd_scan=Tru
         The job name search for (default: {None}).
     dd_name : str
         The data definition to retrieve (default: {None}).
+    sysin : bool
+        The input DD to retrieve SYSIN value (default: {False}).
     dd_scan : bool
         Whether or not to pull information from the dd's for this job {default: {True}}.
     duration : int
@@ -112,6 +114,7 @@ def job_output(job_id=None, owner=None, job_name=None, dd_name=None, dd_scan=Tru
         job_name=job_name,
         dd_name=dd_name,
         duration=duration,
+        sysin=sysin,
         dd_scan=dd_scan,
         timeout=timeout,
         start_time=start_time
@@ -128,6 +131,7 @@ def job_output(job_id=None, owner=None, job_name=None, dd_name=None, dd_scan=Tru
             owner=owner,
             job_name=job_name,
             dd_name=dd_name,
+            sysin=sysin,
             dd_scan=dd_scan,
             duration=duration,
             timeout=timeout,
@@ -300,7 +304,7 @@ def _parse_steps(job_str):
     return stp
 
 
-def _get_job_status(job_id="*", owner="*", job_name="*", dd_name=None, dd_scan=True, duration=0, timeout=0, start_time=timer()):
+def _get_job_status(job_id="*", owner="*", job_name="*", dd_name=None, sysin=False, dd_scan=True, duration=0, timeout=0, start_time=timer()):
     """Get job status.
 
     Parameters
@@ -313,6 +317,8 @@ def _get_job_status(job_id="*", owner="*", job_name="*", dd_name=None, dd_scan=T
         The job name search for (default: {None}).
     dd_name : str
         The data definition to retrieve (default: {None}).
+    sysin : bool
+        The input DD SYSIN (default: {False}).
     dd_scan : bool
         Whether or not to pull information from the dd's for this job {default: {True}}.
     duration : int
@@ -418,7 +424,7 @@ def _get_job_status(job_id="*", owner="*", job_name="*", dd_name=None, dd_scan=T
                 list_of_dds = []
 
                 try:
-                    list_of_dds = jobs.list_dds(entry.job_id)
+                    list_of_dds = jobs.list_dds(entry.job_id, sysin=sysin)
                 except exceptions.DDQueryException:
                     is_dd_query_exception = True
 
@@ -437,7 +443,7 @@ def _get_job_status(job_id="*", owner="*", job_name="*", dd_name=None, dd_scan=T
                     try:
                         # Note, in the event of an exception, eg job has TYPRUN=HOLD
                         # list_of_dds will still be populated with valuable content
-                        list_of_dds = jobs.list_dds(entry.job_id)
+                        list_of_dds = jobs.list_dds(entry.job_id, sysin=sysin)
                         is_jesjcl = True if search_dictionaries("dd_name", "JESJCL", list_of_dds) else False
                         is_job_error_status = True if entry.status in JOB_ERROR_STATUSES else False
                     except exceptions.DDQueryException:

plugins/modules/zos_job_output.py

@@ -33,6 +33,7 @@
     like "*".
   - If there is no dd_name, or if dd_name="?", output of all the dds under
     the given job will be displayed.
+  - If SYSIN DDs are needed, C(input) should be set to C(true).
 version_added: "1.0.0"
 author:
   - "Jack Ho (@jacklotusho)"
@@ -62,6 +63,12 @@
     type: str
     required: false
     aliases: [ ddname ]
+  input:
+    description:
+      - Whether to include SYSIN DDs as part of the output.
+    type: bool
+    default: false
+    required: false
 
 attributes:
   action:
@@ -91,6 +98,11 @@
     job_name: "*"
     owner: "IBMUSER"
     dd_name: "?"
+
+- name: Query a job's output including SYSIN DDs
+  zos_job_output:
+    job_id: "JOB00548"
+    input: true
 """
 
 RETURN = r"""
@@ -496,6 +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),
+        input=dict(type="bool", required=False, default=False),
         dd_name=dict(type="str", required=False, aliases=['ddname']),
     )
 
@@ -505,6 +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),
+        input=dict(type="bool", required=False, default=False),
         dd_name=dict(type="str", required=False, aliases=['ddname']),
     )
 
@@ -524,14 +538,15 @@ def run_module():
     job_id = module.params.get("job_id")
     job_name = module.params.get("job_name")
     owner = module.params.get("owner")
+    sysin = module.params.get("input")
     dd_name = module.params.get("dd_name")
 
     if not job_id and not job_name and not owner:
         module.fail_json(msg="Please provide a job_id or job_name or owner", stderr="", **results)
 
     try:
         results = {}
-        results["jobs"] = job_output(job_id=job_id, owner=owner, job_name=job_name, dd_name=dd_name)
+        results["jobs"] = job_output(job_id=job_id, owner=owner, job_name=job_name, dd_name=dd_name, sysin=sysin)
         for job in results["jobs"]:
             if "job_not_found" in job:
                 results["changed"] = False

tests/functional/modules/test_zos_copy_func.py

@@ -257,7 +257,7 @@
       async_status:
         jid: "{{{{ copy_output.ansible_job_id }}}}"
       register: job_result
-      until: job_result.finished
+      until: job_result.finished | bool
       retries: 10
       delay: 30
 

tests/functional/modules/test_zos_job_output_func.py

@@ -16,6 +16,7 @@
 __metaclass__ = type
 
 from shellescape import quote
+from ibm_zos_core.tests.helpers.dataset import get_tmp_ds_name
 
 
 JCL_FILE_CONTENTS = """//HELLO    JOB (T043JM,JM00,1,0,0,0),'HELLO WORLD - JRM',CLASS=R,
@@ -30,6 +31,19 @@
 //
 """
 
+JCL_FILE_CONTENTS_SYSIN = """//SYSINS  JOB (T043JM,JM00,1,0,0,0),'SYSINS - JRM',CLASS=R,   
+//      MSGCLASS=X,MSGLEVEL=1,NOTIFY=OMVSADM               
+//STEP1   EXEC PGM=BPXBATCH,PARM='SH sleep 1'              
+//STDOUT   DD SYSOUT=*                                     
+//STDERR   DD SYSOUT=*                                     
+//LISTCAT EXEC PGM=IDCAMS,REGION=4M                        
+//SYSPRINT DD   SYSOUT=*                                   
+//SYSIN DD   *                                             
+     LISTCAT ENTRIES('{0}') ALL           
+/*                                                         
+//
+"""
+
 TEMP_PATH = "/tmp/jcl"
 
 def test_zos_job_output_no_job_id(ansible_zos_module):
@@ -249,7 +263,7 @@ def test_zos_job_output_job_exists(ansible_zos_module):
         hosts.all.file(path=TEMP_PATH, state="absent")
 
 
-def test_zos_job_output_job_exists_with_filtered_ddname(ansible_zos_module):
+def test_zos_job_output_job_exists_with_filtered_dd_name(ansible_zos_module):
     try:
         hosts = ansible_zos_module
         hosts.all.file(path=TEMP_PATH, state="directory")
@@ -261,7 +275,7 @@ def test_zos_job_output_job_exists_with_filtered_ddname(ansible_zos_module):
         )
         hosts.all.file(path=TEMP_PATH, state="absent")
         dd_name = "JESMSGLG"
-        results = hosts.all.zos_job_output(job_name="HELLO", ddname=dd_name)
+        results = hosts.all.zos_job_output(job_name="HELLO", dd_name=dd_name)
         for result in results.contacted.values():
             assert result.get("changed") is True
             assert result.get("msg", False) is False
@@ -310,6 +324,43 @@ def test_zos_job_output_job_exists_with_filtered_ddname(ansible_zos_module):
         hosts.all.file(path=TEMP_PATH, state="absent")
 
 
+def test_zos_job_output_job_exists_with_sysin(ansible_zos_module):
+    try:
+        hosts = ansible_zos_module
+        hosts.all.file(path=TEMP_PATH, state="directory")
+        data_set_name = get_tmp_ds_name()
+        result = hosts.all.zos_data_set(
+                    name=data_set_name,
+                    type="seq",
+                    state="present"
+                )
+        print(f"job_submit_result: {result.contacted.values()}")
+        hosts.all.shell(
+            cmd=f"echo {quote(JCL_FILE_CONTENTS_SYSIN.format(data_set_name))} > {TEMP_PATH}/SYSIN"
+        )
+        result = hosts.all.zos_job_submit(
+            src=f"{TEMP_PATH}/SYSIN", remote_src=True, volume=None
+        )
+        print(f"job_submit_result: {result.contacted.values()}")
+        hosts.all.file(path=TEMP_PATH, state="absent")
+        sysin = True
+        results = hosts.all.zos_job_output(job_name="SYSINS", input=sysin)
+        for result in results.contacted.values():
+            print(f"job_output_result: {result}")
+            assert result.get("changed") is True
+            for job in result.get("jobs"):
+                assert len(job.get("dds")) >= 1
+                sysin_found = False
+                for ddname_entry in job.get("dds"):
+                    if ddname_entry.get("dd_name") == "SYSIN":
+                        sysin_found = True
+                        break
+                assert sysin_found
+    finally:
+        hosts.all.zos_data_set(name=data_set_name, state="absent")
+        hosts.all.file(path=TEMP_PATH, state="absent")
+
+
 def test_zos_job_submit_job_id_and_owner_included(ansible_zos_module):
     hosts = ansible_zos_module
     results = hosts.all.zos_job_output(job_id="STC00*", owner="MASTER")

tests/functional/modules/test_zos_job_submit_func.py

@@ -425,7 +425,7 @@
       async_status:
         jid: "{{{{ job_task.ansible_job_id }}}}"
       register: job_result
-      until: job_result.finished
+      until: job_result.finished | bool
       retries: 20
       delay: 5
 """

tests/functional/modules/test_zos_script_func.py

@@ -87,7 +87,7 @@
       async_status:
         jid: "{{{{ job_task.ansible_job_id }}}}"
       register: job_result
-      until: job_result.finished
+      until: job_result.finished | bool
       retries: 20
       delay: 5
 """

tests/functional/modules/test_zos_unarchive_func.py

@@ -72,7 +72,7 @@
       async_status:
         jid: "{{{{ job_task.ansible_job_id }}}}"
       register: job_result
-      until: job_result.finished
+      until: job_result.finished | bool
       retries: 20
       delay: 5
 """