zos_ping – Ping z/OS and check dependencies.¶
Synopsis¶
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.
Notes¶
Note
This module is written in REXX and relies on the SCP protocol to transfer the source to the managed z/OS node and encode it in the managed nodes default encoding, eg IBM-1047. Starting with OpenSSH 9.0, it switches from SCP to use SFTP by default, meaning transfers are no longer treated as text and are transferred as binary preserving the source files encoding resulting in a module failure. If you are using OpenSSH 9.0 (ssh -V) or later, you can instruct SSH to use SCP by adding the entry scp_extra_args="-O"
into the ini file named ansible.cfg
.
Return Values¶
- ping
Should contain the value “pong” on success.
returned: alwaystype: strsample: pong- warnings
List of warnings returned from stderr when performing resource checks.
returned: failuretype: listelements: str