zowe › ca7 › dataset › post-dataset🖨️

Create a new definition of a dataset

Usage

zowe ca7 dataset post-dataset [options]

Required Options

• --ca7Id (string)

  • CA7ONL Instance

• --dataset-name | --dname (string)

  • 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.

Options

• --type (string)

  • (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

• --gdg (string)

  • (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.

• --smf-feedback-required | --sfr (string)

  • (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.

• --post-at-close-time | --pact (string)

  • (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

• --device (string)

  • (Optional) Specifies a device type.
    Valid values are:
    TAPEDASD

• --dsorg (string)

  • (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

• --recfm (string)

  • (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

• --lrecl (string)

  • (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

• --blksize (string)

  • (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

CA7 Connection Options

• --host | -H (string)

  • Host name of the CA7 API service that is running on the mainframe system.

• --port | -P (number)

  • Port for the CA7 API service that is running on the mainframe system.

• --user | -u (string)

  • User name for authenticating connections to the CA7 API service that is running on the mainframe system.

• --password | --pass | --pw (string)

  • Password for authenticating connections to the CA7 API service that is running on the mainframe system.

• --base-path | --bp (string)

  • The base path for your 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 API mediation layer.

• --protocol | -o (string)

  • Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

Profile Options

• --ca7-profile | --ca7-p (string)

  • The name of a (ca7) profile to load for this command execution.

• --base-profile | --base-p (string)

  • The name of a (base) profile to load for this command execution.

Base Connection Options

• --reject-unauthorized | --ru (boolean)

  • Reject self-signed certificates.

    Default value: true

• --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.

    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 (local file path)

  • The file path to a certificate key file to use for authentication

Examples

• Create a new dataset named DATASET.NAME.TEST of type NORM and data set is not a generation data group on Instance1:

  • zowe ca7 dataset post-dataset --dname DATASET.NAME.TEST --type NORM --gdg N --ca7Id Instance1 Copy