Submit a job (JCL) contained in a data set. The data set may be of type physical sequential or a PDS member. The command does not pre-validate the data set name. The command presents errors verbatim from the Jobs REST endpoints. For more information about Jobs API errors, see the Jobs API REST documentation.
Usage
zowe rse-api-for-zowe-cli submit data-set <dataset> [options]
Positional Arguments
-
dataset (string)
- The z/OS data set containing the JCL to submit. You can specify a physical sequential data set (for example, "DATA.SET") or a partitioned data set qualified by a member (for example, "DATA.SET(MEMBER)").
Options
-
--wait-for-output | --wfo (boolean)
- Wait for the job to enter OUTPUT status before completing the command.
-
--wait-for-active | --wfa (boolean)
- Wait for the job to enter ACTIVE status before completing the command.
-
--view-all-spool-content | --vasc (boolean)
- Print all spool output. If you use this option you will wait the job to complete.
-
--directory | -d (string)
- The local directory you would like to download the output of the job. Creates a subdirectory using the jobID as the name and files are titled based on DD names. If you use this option you will wait the job to complete.
-
--extension | -e (string)
- A file extension to save the job output with. Default is '.txt'.
Profile Options
Base Connection Options
-
--host | -H (string)
- Host name of service on the mainframe.
-
--port | -P (number)
- Port number of service on the mainframe.
-
--user | -u (string)
- User name to authenticate to service on the mainframe.
-
--password | --pass | --pw (string)
- Password to authenticate to service on the mainframe.
-
--reject-unauthorized | --ru (boolean)
-
--token-type | --tt (string)
- The type of token to get and use for the API. Omit this option to use the default token type, which is provided by 'zowe auth login'.
-
--token-value | --tv (string)
- The value of the token to pass to the API.
-
--cert-file (local file path)
- The file path to a certificate file to use for authentication
-
--cert-key-file (local file path)
- The file path to a certificate key file to use for authentication
Response Format Options
-
--response-format-filter | --rff (array)
- Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.
-
--response-format-type | --rft (string)
-
The command response output format type. Must be one of the following:
table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.
list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.
object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.
string: Formats output data as a string. JSON objects/arrays are stringified.
Allowed values: table, list, object, string
-
--response-format-header | --rfh (boolean)
- If "--response-format-type table" is specified, include the column headers in the output.
Examples
-
Submit the JCL in the data set "ibmuser.cntl(deploy)":
zowe rse-api-for-zowe-cli submit data-set "ibmuser.cntl(deploy)"
-
Submit the JCL in the data set "ibmuser.cntl(deploy)", wait for the job to complete and print all output from the job:
zowe rse-api-for-zowe-cli submit data-set "ibmuser.cntl(deploy)" --vasc