[New module] zos_started_task

[surendrababuravella]

SUMMARY

New module zos_started_task which support start, display, modify, cancel, stop and force operations.

ISSUE TYPE

New Module Pull Request

COMPONENT NAME

zos_started_task

ADDITIONAL INFORMATION

[surendrababuravella]

Start command response when started task gets started successfully:

{
    "msg": {
        "changed": true,
        "cmd": "S testr,SECS=300",
        "failed": false,
        "rc": 0,
        "state": "started",
        "stderr": "",
        "stderr_lines": [
            ""
        ],
        "stdout": "EC01244A   2025294  01:54:06.00             ISF031I CONSOLE OMVS0000 ACTIVATED\n
        EC01244A   2025294  01:54:06.00            -S TESTR,SECS=300 \n
        EC01244A   2025294  01:54:06.00             ",
        "stdout_lines": [
            "EC01244A   2025294  01:54:06.00             ISF031I CONSOLE OMVS0000 ACTIVATED",
            "EC01244A   2025294  01:54:06.00            -S TESTR,SECS=300 ",
            "EC01244A   2025294  01:54:06.00             "
        ],
        "system_logs": "",
        "tasks": [
            {
                "asidx": "0058",
                "cpu_time": "00000.00.00.003",
                "elapsed_time": "00000.01.41.137",
                "started_time": "2025-10-21 08:54:05.978805+00:00",
                "task_id": "STC00200",
                "task_identifier": "TESTR",
                "task_name": "TESTR"
            }
        ],
        "verbose_output": "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            \n
        0 \n 
        01.54.05 STC00200 ---- TUESDAY,   21 OCT 2025 ----\n 
        01.54.05 STC00200  IEF695I START TESTR    WITH JOBNAME TESTR    IS ASSIGNED TO USER USRT001 , GROUP SYS1\n 
        01.54.05 STC00200  $HASP373 TESTR    STARTED\n
                1 //TESTR    JOB MSGLEVEL=1                                               STC00200\n
                2 //STARTING EXEC TESTR,SECS=300                                                  \n
                3 XXMYSLEEP  PROC SECS=10                                                         \n
                  XX* Run a USS command using BPXBATCH                                            \n
                4 XXSTEP1    EXEC PGM=BPXBATCH,                                                   \n
                   XX         PARM='SH sleep &SECS'                                                \n
                   IEFC653I SUBSTITUTION JCL - PGM=BPXBATCH,PARM='SH sleep 300'\n
                5 XXSTDOUT   DD SYSOUT=*                                                          \n
                6 XXSTDERR   DD SYSOUT=*                                                          \n 
                7 XX                                                                              \n
                   STMT NO. MESSAGE\n
           2 IEFC001I PROCEDURE TESTR WAS EXPANDED USING SYSTEM LIBRARY USER.PRIVATE.PROCLIB\n
            IEF695I START TESTR    WITH JOBNAME TESTR    IS ASSIGNED TO USER USRT001 , GROUP SYS1\n
             IEF043I Actions taken by SMFLIMxx parmlib policy for TESTR    STEP1   \n
             Step shared page limit set to 2147483647 by policy - SMFLIM00 0001\n IEFA111I TESTR IS USING THE FOLLOWING JOB RELATED SETTINGS:\n
           SWA=ABOVE,TIOT SIZE=32K,DSENQSHR=DISALLOW,GDGBIAS=JOB\n
 IEF236I ALLOC. FOR TESTR TESTR\n IEF237I JES2 ALLOCATED TO STDOUT\n
  IEF237I JES2 ALLOCATED TO STDERR"
    }
}

[richp405]

This is impressive! Please should check with Fernando about adding a changelog fragment.

[fernandofloresg]

Request few minor changes

[fernandofloresg]

Let's change this option's name to system_logs, we are trying to avoid the verb options for the new 2.0 version so is better to have the same guidelines applied here.

[surendrababuravella]

Updated

[fernandofloresg]

Let's add bit more detail in here

Suggested change

	started task name.
	started task name used to query the system.

[surendrababuravella]

Done

[fernandofloresg]

Suggested change

	- Command executed via opercmd.
	- Command executed via opercmd to achieve the desired state.

[surendrababuravella]

done

[fernandofloresg]

This description is the same as cpu_time is that intended?

[surendrababuravella]

updated

[fernandofloresg]

PLease always return msg even is if empty, we are trying to return more consistent values in the collection overall.

[surendrababuravella]

done

[fernandofloresg]

Thanks for addressing all comments, making changes after feedback sessions where we went back and forth multiple times, even reverting previously agreed behaviors.

Appreciate your effort and attention to detail during the whole development process.