ibm.ibm_zos_core.zos_ping (1.9.0) — module

Ping z/OS and check dependencies.

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

Authors: Vijay Katoch (@vijayka), Blake Becker (@blakeinate), Demetrios Dimatos (@ddimatos)

This plugin has a corresponding action plugin.

Install collection

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


Add to requirements.yml

  collections:
    - name: ibm.ibm_zos_core
      version: 1.9.0

Description

L(zos_ping,./zos_ping.html) verifies the presence of z/OS Web Client Enablement Toolkit, iconv, and Python.

L(zos_ping,./zos_ping.html) returns C(pong) when the target host is not missing any required dependencies.

If the target host is missing optional dependencies, the L(zos_ping,./zos_ping.html) 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.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Ping the z/OS host and perform resource checks
  zos_ping:
  register: result

Outputs

ping:
  description: Should contain the value "pong" on success.
  returned: always
  sample: pong
  type: str
warnings:
  description: List of warnings returned from stderr when performing resource checks.
  elements: str
  returned: failure
  type: list

See also