Adding error suggestion to generic error while copying GDG if its in edit mode.

[Rohitcodes28]

SUMMARY

The error from the ZOAU is very generic and does not suggest that the possible failure reason can be the src GDG in edit mode or being used by another task. This change improves the error handling and gives user a suggestion to resolve the issue.

ISSUE TYPE

• Bugfix Pull Request

COMPONENT NAME

zos_copy

ADDITIONAL INFORMATION

[Rohitcodes28]

Initial Error is

[Rohitcodes28]

Improved Error is

[Rohitcodes28]

Playbook to check the issue

    - name: Create GDG base
      zos_data_set:
          name: "GDG.SAMPLE.TEST"
          type: gdg
          state: present
          limit: 3
          force: true
          replace: false
          record_format: fb
          space_primary: 5
          space_secondary: 3
          space_type: m
       register: dataset_creation
      
    - name: Add "helloworld" data to the first GDG generation
      zos_copy:
        content: "helloworld"
        dest: "GDG.SAMPLE.TEST(+1)"
        is_binary: false

    - name: Add "helloworld" data to the second GDG generation
      zos_copy:
        content: "helloworld 2nd"
        dest: "GDG.SAMPLE.TEST(+1)"
        is_binary: false

After this we need to make sure the created generations is in edit state and post that we should run another playbook

    - name: Copy a file to a new generation data set.
      zos_copy:
        src: GDG.SAMPLE.TEST
        dest: GDG.SAMPLE.COPY
        remote_src: true
        force_lock: true

[Rohitcodes28]

Finally if the GDG is not in use the copy function is successful

[Rohitcodes28]

Pipeline was tested successfully for the same.

[fernandofloresg]

Requested few changes, not needed to run full regression only test it

[fernandofloresg]

LGTM!