broadcom / broadcom.ca7 / 2.0.7 / module / dataset_create_dataset Create a new dataset definition | "added in version" 1.0.0 of broadcom.ca7" Authors: Daniel Remta <daniel.remta@broadcom.com> (@broadcom) | supported by Broadcom This plugin has a corresponding action plugin.broadcom.ca7.dataset_create_dataset (2.0.7) — module
Install with ansible-galaxy collection install broadcom.ca7:==2.0.7
collections: - name: broadcom.ca7 version: 2.0.7
Create Dataset.
- name: Create a new dataset named DATASET.NAME.TEST of type NORM and data set is not a generation data group broadcom.ca7.dataset_create_dataset: dataset_name: DATASET.NAME.TEST type: NORM gdg: N
gdg: description: - (Optional) Specifies whether this data set is a generation data group. - 'Valid values are:' - 'Y = The data set is a generation data groupN = The data set is not a generation data groupDefault: N' - 'Note: The specific GDG creations cannot be used for posting requirements or for triggering jobs. Posting and triggering are done based on the creation/updating (SMF 15 record) of any generation of the GDG.' required: false 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 type: description: - (Optional) Specifies the data set type. - 'Valid values are:' - NORM = Internal means both the creating-job and using-jobs for this data set are known to CA 7. - 'External means the creating-job, using-jobs, or both for this data set are not known to CA 7.PERM = Specifies this data set is always available for inputDefault: NORM' - 'Note: When a data set is marked PERM, no SMF records are captured. PERM means no data set triggering can occur with this type of data set.' required: false type: str user: description: - User name for authenticating connections to the CA7 API service that is running on the mainframe system. required: true type: str dsorg: description: - (Optional) Specifies the data set organization. This value is the same as the DSORG specified in the DCB subparameter in the JCL. - 'Limits: 1 to 3 alphanumeric characters.' required: false type: str lrecl: description: - (Optional) Specifies the logical record length of the data set. This value is the same as the LRECL specified in the DCB subparameter in the JCL. - 'Limits: 1 to 5 numeric characters.' required: false type: str recfm: description: - (Optional) Specifies the record format of the data set. This value is the same as the RECFM specified in the DCB subparameter in the JCL. - 'Limits: 1 to 5 alphanumeric characters.' required: false type: str device: description: - (Optional) Specifies a device type. - 'Valid values are:' - TAPEDASD. required: false type: str blksize: description: - (Optional) Specifies the block size of the data set. This value is the same as the BLKSIZE specified in the DCB subparameter in the JCL. - 'Limits: 1 to 5 numeric characters.' required: false 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 dataset_name: description: - Specifies the data set and must be the fully qualified data set name. - 'Limits: 1 to 44 alphanumeric characters' - 'Note: dataset-name is not required to conform to MVS data set name standards. Embedded blanks and special characters such as slashes, dashes, and underscores are permitted. All alphabetic characters are uppercased.' required: true type: str cert_key_file: description: - The file path to a certificate key file to use for authentication. required: false type: path post_at_close_time: description: - (Optional) Specifies when to post the creation or update of a data set to the database and queues. This process does not ensure successful step or job termination. - 'Valid values are:' - 'Y = The action takes place when the SMF data set creation record is received (when the data set is closed)N = Causes triggering or posting action to take place at the job terminationDefault: N.' required: false type: str reject_unauthorized: default: true description: - Reject self-signed certificates. required: false type: bool smf_feedback_required: description: - (Optional) Specifies whether the interface to System Management Facility (SMF) inserts the values for DSORG, RECFM, LRECL, and BLKSIZE when this data set is next used. Unless the value is reset, this insertion is only done once. - 'Valid values are:' - 'Y = SMF inserts the values when the data set is next usedN = SMF does not insert the values when the data set is next usedDefault: Y' - 'Note: After the first time the job that creates this data set runs under CA 7, this field is reset to N. If the data set attributes change, this field must be reset to Y. The changed attribute field (that is, DSORG, RECFM) must be zeroed (if numeric) or blanked out. This process causes CA 7 to record the new values when the job is run again.' required: false type: str
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