zos_ping – Ping z/OS and check dependencies.


  • zos_ping verifies the presence of z/OS Web Client Enablement Toolkit, iconv, and Python.

  • zos_ping returns pong when the target host is not missing any required dependencies.

  • If the target host is missing optional dependencies, the zos_ping will return one or more warning messages.

  • If a required dependency is missing from the target host, an explanatory message will be returned with the module failure.

  • The zos_ssh connection plugin must be used for this module to function correctly.


- name: Ping the z/OS host and perform resource checks
  register: result

Return Values

Should contain the value “pong” on success.
type: str
List of warnings returned from stderr when performing resource checks.
type: list