You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/docsite/rst/os_guide/intro_zos.rst
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,18 +5,18 @@ Managing z/OS hosts with Ansible
5
5
================================
6
6
7
7
8
-
Ansible can connect to UNIX Systems Services to bring your Ansible Automation strategy to IBM Z.
8
+
Ansible can connect to UNIX System Services to bring your Ansible Automation strategy to IBM Z.
9
9
This enables development and operations automation on IBM Z through a seamless,
10
10
unified workflow orchestration with configuration management, provisioning, and application deployment with
11
11
the easy-to-use Ansible platform.
12
12
13
13
14
-
Ansible and UNIX Systems Services
14
+
Ansible and UNIX System Services
15
15
---------------------------------
16
-
UNIX Systems Services can support the required dependencies for an Ansible managed node including running python and
16
+
UNIX System Services can support the required dependencies for an Ansible managed node including running python and
17
17
spawning interactive shell processes through SSH connections.
18
-
Ansible can target UNIX Systems Services nodes to modify files, directories, etc. through built-in Ansible community modules.
19
-
Further, anything that one can do by typing command(s) into the UNIX Systems Services shell can be captured
18
+
Ansible can target UNIX System Services nodes to modify files, directories, etc. through built-in Ansible community modules.
19
+
Further, anything that one can do by typing command(s) into the UNIX System Services shell can be captured
20
20
and automated in an Ansible playbook.
21
21
22
22
To learn more about z/OS managed nodes,
@@ -26,13 +26,13 @@ see `Red Hat Certified Content for IBM Z <https://ibm.github.io/z_ansible_collec
26
26
The z/OS Landscape
27
27
-------------------
28
28
While most systems process files in two modes - binary or UTF-8 encoded text,
29
-
IBM Z including UNIX Systems Services features an additional third flavor - text encoded in EBCDIC.
29
+
IBM Z including UNIX System Services features an additional third flavor - text encoded in EBCDIC.
30
30
Ansible has provisions to handle binary data and UTF-8 encoded textual data, but not EBCDIC encoded data.
31
31
This is not necessarily a limitation, it simply requires additional tasks that convert files to/from their original encodings.
32
32
It is up to the Ansible user managing z/OS nodes to understand the nature of the files in their automation.
33
33
34
34
The type (binary or text) and encoding of files can be stored in file "tags".
35
-
File tags is a z/OS UNIX Systems Services concept (part of enhanced ASCII) which was established to distinguish binary
35
+
File tags is a z/OS UNIX System Services concept (part of enhanced ASCII) which was established to distinguish binary
36
36
files from UTF-8 encoded text files and EBCDIC-encoded text files.
37
37
38
38
Default behavior for an un-tagged file or stream is determined by the program, for example,
@@ -79,8 +79,8 @@ Here are some notes / pro-tips when using the community modules with z/OS. This
79
79
80
80
81
81
* ansible.builtin.raw
82
-
The raw module, by design, ignores all remote environment settings. However, UNIX Systems Services managed nodes require some base configurations.
83
-
One trick to use this module with UNIX Systems Services is to pass in the bare minimal environment variables as a chain of export statements before the desired command.
82
+
The raw module, by design, ignores all remote environment settings. However, UNIX System Services managed nodes require some base configurations.
83
+
One trick to use this module with UNIX System Services is to pass in the bare minimal environment variables as a chain of export statements before the desired command.
84
84
85
85
.. code-block:: yaml
86
86
@@ -106,7 +106,7 @@ Here are some notes / pro-tips when using the community modules with z/OS. This
106
106
107
107
* ansible.builtin.script
108
108
The built in script module copies a local file over to a remote target and attempts to run it.
109
-
The issue that UNIX Systems Services targets run into is that the file does not get tagged as UTF-8 text.
109
+
The issue that UNIX System Services targets run into is that the file does not get tagged as UTF-8 text.
110
110
When the underlying shell attempts to read the untagged script file, it will assume the default,
111
111
that the file is encoded in EBCDIC, and the file will not be read correctly and the script will not run.
112
112
One work-around is to manually copy local files over (``ansible.builtin.copy`` ) and convert or tag files (with the ``ansible.builtin.command`` module).
@@ -127,7 +127,7 @@ Here are some notes / pro-tips when using the community modules with z/OS. This
0 commit comments