[Enhancement] [zos_job_submit] Adopt jsub better status with TYPRUN=SCAN

[fernandofloresg]

Is there an existing issue for this?

• There are no existing issues.

Enhancement or feature description

ZOAU worked on adding a better status when TYPRUN=SCAN than just returning '?'. Now, we need to integrate this change into zos_job_submit and make sure that it works correctly.

Developer can use the following JCL to test.

//TYPESCAN    JOB (T043JM,JM00,1,0,0,0),'HELLO WORLD - JRM',
//             MSGCLASS=H,MSGLEVEL=1,NOTIFY=&SYSUID,TYPRUN=SCAN
//*
//STEP0001 EXEC PGM=IEBGENER
//SYSIN    DD DUMMY
//SYSPRINT DD SYSOUT=*
//SYSUT1   DD *
HELLO, WORLD
/*
//SYSUT2   DD SYSOUT=*
// 

Current ansible output is :

{
   "changed":false,
   "duration":1,
   "jobs":[
      {
         "asid":"0",
         "class":"",
         "content_type":"",
         "creation_date":"2024-02-21",
         "creation_time":"1:31:44",
         "ddnames":[
            {
               "byte_count":"133",
               "content":[
                  "1                       J E S 2  J O B  L O G  --  S Y S T E M  S T L 1  --  N O D E  S T L 1",
                  "0     ",
                  " 11.31.44 JOB00408 ---- WEDNESDAY, 21 FEB 2024 ----",
                  " 11.31.44 JOB00408  IRR010I  USERID OMVSADM  IS ASSIGNED TO THIS JOB.",
                  " 11.31.45 JOB00408  $HASP375 TYPESCAN ESTIMATED  LINES EXCEEDED",
                  "0------ JES2 JOB STATISTICS ------",
                  "0           11 CARDS READ",
                  "0           23 SYSOUT PRINT RECORDS",
                  "0            0 SYSOUT PUNCH RECORDS",
                  "0            1 SYSOUT SPOOL KBYTES",
                  "0         0.00 MINUTES EXECUTION TIME",
                  " HELLO, WORLD"
               ],
               "ddname":"JESMSGLG",
               "id":"2",
               "proctep":null,
               "record_count":"11",
               "stepname":"JES2"
            },
            {
               "byte_count":"136",
               "content":[
                  "        1 //TYPESCAN    JOB (T043JM,JM00,1,0,0,0),'HELLO WORLD - JRM',            JOB00408",
                  "          //             MSGCLASS=H,MSGLEVEL=1,NOTIFY=&SYSUID,TYPRUN=SCAN",
                  "          //*",
                  "          IEFC653I SUBSTITUTION JCL - (T043JM,JM00,1,0,0,0),'HELLO WORLD - JRM',MSGCLASS=H,MSGLEVEL=1,NOTIFY=OMVSADM,",
                  "          TYPRUN=SCAN",
                  "        2 //STEP0001 EXEC PGM=IEBGENER",
                  "        3 //SYSIN    DD DUMMY",
                  "        4 //SYSPRINT DD SYSOUT=*",
                  "        5 //SYSUT1   DD *",
                  "        6 //SYSUT2   DD SYSOUT=*",
                  "        7 //",
                  " HELLO, WORLD"
               ],
               "ddname":"JESJCL",
               "id":"3",
               "proctep":null,
               "record_count":"11",
               "stepname":"JES2"
            }
         ],
         "duration":1,
         "job_class":"A",
         "job_id":"JOB00408",
         "job_name":"TYPESCAN",
         "owner":"OMVSADM",
         "priority":"1",
         "program_name":"?",
         "queue_position":"51",
         "ret_code":{
            "code":null,
            "msg":"? ?",
            "msg_code":"?",
            "msg_text":"?",
            "steps":[
               
            ]
         },
         "subsystem":"STL1",
         "svc_class":"?",
         "system":"STL1"
      }
   ],
   "msg":"The JCL submitted with job id JOB00408 but there was an error, please review the error for further details: The job return code was not available in the job log, please review the job log and error ? ?."
}
 

As you can see it shows there was an error where it was not, since TYPRUN=SCAN will only scan if the JCL is valid, read more here.

Ansible module

zos_job_submit