broadcom.ca7.update_job_definition_job (2.0.7) — module

Install collection

Install with ansible-galaxy collection install broadcom.ca7:==2.0.7

Add to requirements.yml

  collections:
    - name: broadcom.ca7
      version: 2.0.7

Description

Update requirement definition for a job.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Update a CPU type job, TESTJOB1 to be executable
  broadcom.ca7.update_job_definition_job:
    job: TESTJOB1
    job_type: CPU
    execute: Y

Inputs

    
job:
    description:
    - The name of the job to update
    - ''
    - .
    required: true
    type: str

host:
    description:
    - Host name of the CA7 API service that is running on the mainframe system.
    required: true
    type: str

port:
    description:
    - Port for the CA7 API service that is running on the mainframe system.
    required: true
    type: int

user:
    description:
    - User name for authenticating connections to the CA7 API service that is running
      on the mainframe system.
    required: true
    type: str

execute:
    description:
    - Indicates whether to execute this job.
    - 'Valid values are: Y/N'
    - ''
    - .
    required: false
    type: str

job_type:
    description:
    - 'The type of job. Valid values are:  CPU|XPJOB|AGENT'
    - ''
    - .
    required: true
    type: str

password:
    description:
    - Password for authenticating connections to the CA7 API service that is running on
      the mainframe system.
    required: true
    type: str

protocol:
    choices:
    - http
    - https
    description:
    - Specifies protocol to use for CA7 connection (http or https).
    required: true
    type: str

base_path:
    description:
    - The base path for your Zowe API Mediation Layer instance. Specify this option to
      prepend the base path to all resources when making REST requests. Do not specify
      this option if you are not using an Zowe API Mediation Layer.
    required: false
    type: str

cert_file:
    description:
    - The file path to a certificate file to use for authentication.
    - ''
    - 'Note: The CLI does not support certificate files that require a password. For more
      information, search Troubleshooting PEM Certificates in Zowe Docs.'
    required: false
    type: path

cert_key_file:
    description:
    - The file path to a certificate key file to use for authentication.
    required: false
    type: path

reject_unauthorized:
    default: true
    description:
    - Reject self-signed certificates.
    required: false
    type: bool

use_jcl_override_library:
    description:
    - 'Specifies whether to retrieve the JCL from the JCL Override library (JCLID=254)
      for the next run only (Y or N). '
    - This field is automatically set back to N the next time the job comes into the request
      queue
    - ''
    - .
    required: false
    type: str

do_not_schedule_after_date:
    description:
    - Specifies not to schedule this job after this date (in YYDDD format, or 99999)
    - .
    required: false
    type: str

do_not_schedule_after_time:
    description:
    - Specifies not to schedule this job after this time (in HHMM format)
    - .
    required: false
    type: str

do_not_schedule_before_date:
    description:
    - Specifies not to schedule this job before this date (in YYDDD format, or 00000)
    - ''
    - .
    required: false
    type: str

do_not_schedule_before_time:
    description:
    - Specifies not to schedule this job before this time (in HHMM format)
    - .
    required: false
    type: str

Outputs

data:
  description: Data from the module execution (a data structure). The items of this
    dict are set as individual return values on the top level as well.
  elements: dict
  returned: when returned data is a dictionary
  type: list
error:
  contains:
    additional_details:
      description: Detailed message about the failure.
      type: str
    msg:
      description: Short description of the result or failure.
      type: str
    request:
      description: HTTP method used to invoke API service request.
      returned: API request failed
      type: str
    resource:
      description: URI of the resource of the API service request.
      returned: API request failed
      type: str
  description: More details about why the action has failed. If the failure is when
    calling an API service, the response contains the connection parameters.
  returned: error
  type: complex
failed:
  description: A boolean that indicates if the task was failed or not.
  returned: always
  type: bool
list:
  description: Data from the module execution (a list of data structures).
  elements: dict
  returned: when returned data is a list
  type: list
msg:
  description: Short description of the result or failure.
  returned: sometimes
  type: str
rc:
  description: Exit code of the module, successful exit code is 0, failure is typically
    1 or higher.
  returned: always
  type: int
stderr:
  description: Details of the error.
  returned: error
  type: str
stdout:
  description: Summary of the result.
  returned: success
  type: str