Skip to content

Commit 753a177

Browse files
committed
correct terminology - 'unix system services'
Signed-off-by: Ketan Kelkar <[email protected]>
1 parent c86f480 commit 753a177

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

docs/docsite/rst/os_guide/intro_zos.rst

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -5,18 +5,18 @@ Managing z/OS hosts with Ansible
55
================================
66

77

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.
99
This enables development and operations automation on IBM Z through a seamless,
1010
unified workflow orchestration with configuration management, provisioning, and application deployment with
1111
the easy-to-use Ansible platform.
1212

1313

14-
Ansible and UNIX Systems Services
14+
Ansible and UNIX System Services
1515
---------------------------------
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
1717
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
2020
and automated in an Ansible playbook.
2121

2222
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
2626
The z/OS Landscape
2727
-------------------
2828
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.
3030
Ansible has provisions to handle binary data and UTF-8 encoded textual data, but not EBCDIC encoded data.
3131
This is not necessarily a limitation, it simply requires additional tasks that convert files to/from their original encodings.
3232
It is up to the Ansible user managing z/OS nodes to understand the nature of the files in their automation.
3333

3434
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
3636
files from UTF-8 encoded text files and EBCDIC-encoded text files.
3737

3838
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
7979
8080
8181
* 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.
8484

8585
.. code-block:: yaml
8686
@@ -106,7 +106,7 @@ Here are some notes / pro-tips when using the community modules with z/OS. This
106106

107107
* ansible.builtin.script
108108
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.
110110
When the underlying shell attempts to read the untagged script file, it will assume the default,
111111
that the file is encoded in EBCDIC, and the file will not be read correctly and the script will not run.
112112
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
127127
ansible.builtin.command: "/u/ibmuser/scripts/sample.sh"
128128
129129
Another somewhat convoluted work-around is to store local script files in EBCDIC.
130-
They may be unreadable on the controller, but they will copy over to UNIX Systems Services targets,
130+
They may be unreadable on the controller, but they will copy over to UNIX System Services targets,
131131
be read in correctly in EBCDIC, and the script will run. This approach takes advantage of the built-in conveniences of the script module,
132132
but storing unreadable files locally makes maintaining those script files difficult.
133133

@@ -177,7 +177,7 @@ For more details, see: :ref:`python_interpreters`.
177177

178178
Configure the Remote Shell
179179
--------------------------
180-
The z/OS UNIX Systems Services managed node includes several shells.
180+
The z/OS UNIX System Services managed node includes several shells.
181181
Currently the only supported shell is the z/OS Shell located in path ``/bin/sh``.
182182
To configure which shell the Ansible control node uses on the target node, set inventory variable
183183
:ref:`ansible_shell_executable<ansible_shell_executable>`. For example:
@@ -233,7 +233,7 @@ Using z/OS as a Control Node
233233
.. RH blog- https://www.redhat.com/en/blog/red-hat-ansible-automation-platform-now-available-on-ibm
234234
235235
The z/OS operating system currently cannot be configured to run as an Ansible control node.
236-
Despite being POSIX-compliant, the UNIX Systems Services interface also cannot be configured to run as an Ansible control node.
236+
Despite being POSIX-compliant, the UNIX System Services interface also cannot be configured to run as an Ansible control node.
237237

238238
There are some options available on the IBM Z platform:
239239

0 commit comments

Comments
 (0)