[Enhancement] [zos_job_output] Enable support for SYSIN DDs

[storfibm]

Is there an existing issue for this?

• [X] There are no existing issues.

Ansible module

zos_job_output

Enhancement or feature description

Enhancement or feature description ZOAU 1.2.4 delivered support for SYSIN DDs when querying job output. These additional DDs should also be exposed via the core collection at the request of the user. JES/SDSF traditionally permits users to either exclude or include such DDs when querying job output.

Acceptance Criteria Given the z/os Core Collection When a user invokes zos_job_query with input flag Then job output includes SYSIN DDs

Requirements -Leverage new SYSIN DDs functionality exposed by ZOAU -Allow users to choose to optionally include these DDs (off by default) via a new input option or similar

Additional Context

• https://www.ibm.com/docs/en/zos/2.3.0?topic=isfgrp-group-function-parameters-reference
• jobs.list_dds(sysin)

[storfibm]

Completed by ZOAU in 1.2.4

[ddimatos]

Supporting content: ZOAU PJDD command doc JCL EXEC statements: What are JCL procedures?

• This link provides a good example of using a proc and not with JCL

This item would change our common module_utils/job.py and impact 3 modules:

• zos_job_submit
• zos_job_query
• zos_job_output

PJDD specific doc:

pjdd can show the contents of SYSIN dd names, and in the case of
the EVENTLOG the output is parsed to show step information in
this format:
<step number> <step name> <program name> <substep number> <proc step> <exec name>

    <step number>       Step number (starting at 1).
    <step name>         Step name (from the EXEC card).
    <program name>      Program name (from PGM= parameter on EXEC card).
    <substep number>    Substep number (zero for non-z/OS UNIX steps).
    <proc step>         The name of the step that invoked the procedure.
    <exec name>         z/OS UNIX or MVS Program name.

    Note: blank fields are replaced with '-'.

Notes
    - <stepname>, <procstep> and <ddname> can be wildcards '*' or ''
        to match all cases.
    - Must provide <stepname> if <procname> is specified, even if
        passed as ''.
    - If EVENTLOG or 8 is specified as <ddname|dsid>,
        no other filter should be specified.

To find the stepname and DD name for a particular job id, ddls(1) can be used.