.. _submit_package_module:


submit_package -- The submit package module submits a JCL job stream to execute one or more Packages
====================================================================================================

.. contents::
   :local:
   :depth: 1


Synopsis
--------

The submit package module submits a JCL job stream to execute one or more Packages.







Parameters
----------

  package (type: str)
    Name of the Endevor package.



  from_file (type: str)
    Use this input to provide source file.



  from_dataset (type: str)
    Use this input to provide source data set name.



  from_member (type: str)
    Use this input to provide source member name in the data set.



  to_CA7 (type: bool)
    Specify to send the submission of the package to CA 7 scheduler.



  to_ddname (type: str)
    Send the submission of the package to be processed according to a DDName specified in the starter task (STC).



  status (type: str)
    Specify the status of the packages. Valid values are [APPROVED, EXECFAILED] for execute action, and additional values [INEDIT, INAPPROVAL, INEXECUTION, EXECUTED, COMMITTED, DENIED] for list action, additional value [ALLSTATE] for delete action.

    It is possible to specify multiple status separated by "," during list and delete package.


    Choices:
      * ``ALLSTATE`` 
      * ``INEDIT`` 
      * ``INAPPROVAL`` 
      * ``APPROVED`` 
      * ``INEXECUTION`` 
      * ``EXECUTED`` 
      * ``COMMITTED`` 
      * ``DENIED`` 
      * ``EXECFAILED`` 

  multiple_streams (type: bool)
    Specify to submit a separate, unique job for each package. If you do not specify this, a single job with a unique job step for each package is submitted.



  increment_jobname (type: bool)
    Specify to increases the last character in the jobcard you provide.



  jcl_procedure (type: str)
    This option lets you to identify the name of the JCL procedure that you want to invoke. ENDEVOR is used by default if any processor is specified.



  CA7_dependent_job (type: str)
    Specifies a single predecessor job which must complete while demanded job is waiting in the CA 7 scheduler.



  maxrc (type: int, default: ``8``)
    The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the module fails.



  asynchronous (type: bool)
    Submit this module as an asynchronous Endevor Web Services task.



  host (type: str)
    Specifies the base host name.



  port (type: str)
    Specifies the port number.



  instance (type: str)
    Specifies Endevor Web Services dataSource name.



  protocol (type: str, default: ``https``)
    Specifies the protocol used for connecting to Endevor Rest API.


    Choices:
      * ``http`` 
      * ``https`` **←**

  user (type: str)
    Specifies the user name.



  password (type: str)
    Specifies the user's password.



  reject_unauthorized (type: bool)
    Specify this option to have the server certificate verified against the list of supplied CAs.



  base_path (type: str)
    Specifies the base path used for connecting to Endevor Rest API.



  suppress_messages (type: bool)
    Suppress all [INFO]/[WARN] messages from terminal output.



  report_file (type: str)
    File name for saving reports from Endevor SCM locally.



  report_dir (type: str)
    Directory for saving reports from Endevor SCM locally, if wasn't specified. Defaults to current directory.



  write_report (type: bool)
    Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false.



  cert_file (type: path)
    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.



  cert_key_file (type: path)
    The file path to a certificate key file to use for authentication.










Examples
--------

.. code-block:: yaml+jinja

    
    - name: Submit package using jobcard from local file, with endevor profile set up
      broadcom.endevor.submit_package:
        package: packageName
        from_file: jobcardfile.txt
        instance: ENDEVOR




Return Values
-------------

data (type: list, *when returned data is a dictionary*)
  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.


error (type: complex, *error*)
  More details about why the action has failed. If the failure is when calling an API service, the response contains the connection parameters.


  additional_details (type: str)
    Detailed message about the failure.


  msg (type: str)
    Short description of the result or failure.


  request (type: str, *API request failed*)
    HTTP method used to invoke API service request.


  resource (type: str, *API request failed*)
    URI of the resource of the API service request.



failed (type: bool, *always*)
  A boolean that indicates if the task was failed or not.


list (type: list, *when returned data is a list*)
  Data from the module execution (a list of data structures).


msg (type: str, *sometimes*)
  Short description of the result or failure.


rc (type: int, *always*)
  Exit code of the module, successful exit code is 0, failure is typically 1 or higher.


stderr (type: str, *error*)
  Details of the error.


stdout (type: str, *success*)
  Summary of the result.





Status
------




- This module is maintained by Broadcom.