ibm.ibm_zos_core.zos_tso_command (1.3.6) — module

Execute TSO commands

| "added in version" 1.1.0 of ibm.ibm_zos_core"

Authors: Xiao Yuan Ma (@bjmaxy)

Install collection

Install with ansible-galaxy collection install ibm.ibm_zos_core:==1.3.6


Add to requirements.yml

  collections:
    - name: ibm.ibm_zos_core
      version: 1.3.6

Description

Execute TSO commands on the target z/OS system with the provided options and receive a structured response.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Execute TSO commands to allocate a new dataset
  zos_tso_command:
      commands:
          - alloc da('TEST.HILL3.TEST') like('TEST.HILL3')
          - delete 'TEST.HILL3.TEST'
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Execute TSO command list user TESTUSER to obtain TSO information
  zos_tso_command:
      commands:
           - LU TESTUSER

Inputs

    
commands:
    aliases:
    - command
    description:
    - One or more TSO commands to execute on the target z/OS system.
    - Accepts a single string or list of strings as input.
    required: true
    type: raw

Outputs

output:
  contains:
    command:
      description: The executed TSO command.
      returned: always
      type: str
    content:
      description: The response resulting from the execution of the TSO command.
      returned: always
      sample:
      - NO MODEL DATA SET                                                OMVSADM
      - 'TERMUACC                                                                '
      - 'SUBGROUP(S)= VSAMDSET SYSCTLG  BATCH    SASS     MASS     IMSGRP1       '
      - '             IMSGRP2  IMSGRP3  DSNCAT   DSN120   J42      M63           '
      - '             J91      J09      J97      J93      M82      D67           '
      - '             D52      M12      CCG      D17      M32      IMSVS         '
      - '             DSN210   DSN130   RAD      CATLG4   VCAT     CSP           '
      type: list
    lines:
      description: The line number of the content.
      returned: always
      type: int
    rc:
      description: The return code from the executed TSO command.
      returned: always
      sample: 0
      type: int
  description: List of each TSO command output.
  elements: dict
  returned: always
  type: list