broadcom.file_master_plus.rename_data_set (5.0.9) — module

Rename a data set

| "added in version" 1.0.0 of broadcom.file_master_plus"

Authors: Petr Galik <petr.galik@broadcom.com> (@broadcom)

| supported by Broadcom

This plugin has a corresponding action plugin.

Install collection

Install with ansible-galaxy collection install broadcom.file_master_plus:==5.0.9


Add to requirements.yml

  collections:
    - name: broadcom.file_master_plus
      version: 5.0.9

Description

Rename a data set.

It supports all data set types that are supported by File Master Plus.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Renaming a data set
  broadcom.file_master_plus.rename_data_set:
    old: fmmvs.old.dsname
    new: fmmvs.new.dsname
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Renaming a VSAM data set along with its components
  broadcom.file_master_plus.rename_data_set:
    old: fmmvs.oldvsam.dsname
    new: fmmvs.newvsam.dsname
    vsam_component: y

Inputs

    
new:
    description:
    - Specifies the new name of the data set.
    required: true
    type: str

old:
    description:
    - Specifies the name of the data set that you want to rename.
    required: true
    type: str

host:
    description:
    - Specifies File Master Plus server host name.
    required: false
    type: str

port:
    default: 51914
    description:
    - Specifies File Master Plus server port.
    required: false
    type: int

user:
    description:
    - Specifies Mainframe user name. May be the same as TSO login.
    required: false
    type: str

password:
    description:
    - Specifies Mainframe password. May be the same as TSO password.
    required: false
    type: str

protocol:
    choices:
    - http
    - https
    default: https
    description:
    - Specifies File Master Plus REST API protocol.
    required: false
    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 FMP 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

vsam_component:
    description:
    - Rename the data and index components of a VSAM cluster if they share the cluster
      name.
    - 'Note: Used only if the target data set is a VSAM cluster.'
    - 'Example: y.'
    required: false
    type: bool

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

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