diff --git a/_sources/ibm_zos_cics/docs/ansible_content.rst.txt b/_sources/ibm_zos_cics/docs/ansible_content.rst.txt index 5de60ad7..227d8570 100644 --- a/_sources/ibm_zos_cics/docs/ansible_content.rst.txt +++ b/_sources/ibm_zos_cics/docs/ansible_content.rst.txt @@ -1,5 +1,5 @@ .. ........................................................................... -.. © Copyright IBM Corporation 2020,2021 . +.. © Copyright IBM Corporation 2020,2024 . .. ........................................................................... ========= @@ -7,18 +7,22 @@ z/OS CICS ========= The **IBM® z/OS® CICS® collection**, also represented as -ibm_zos_cics in this document, is part of the broader +ibm_zos_cics in this document, is part of the broader initiative to bring Ansible® Automation to IBM Z® through the offering **Red Hat® Ansible Certified Content for IBM Z**. -The **IBM® z/OS® CICS® collection** supports automation tasks that can -define, install, and perform actions on CICS definitions and resources such as -creating a PROGRAM definition, installing and updating it, and deleting the -definition. +The **IBM® z/OS® CICS® collection** provides modules for automation tasks that +perform operations on CICS and CICSPlex SM resources and definitions, for example, +creating and installing a PROGRAM definition, then updating or deleting the definition. +These modules interact with the `CMCI REST API`_ of the CICS® management client +interface (CMCI) for system management. -The Ansible modules in this collection are written in Python and interact with -the `CMCI REST API`_ of the CICS® management client interface (CMCI) for system -management. +The **IBM® z/OS® CICS® collection** also provides modules for provisioning and managing +CICS TS data sets and utilities. You can use these Ansible modules to create automation +tasks that provision or deprovision a CICS region and tasks for CICS startup and +shutdown. + +The Ansible modules in this collection are written in Python. .. _CMCI REST API: https://www.ibm.com/docs/en/cics-ts/latest?topic=cmci-how-it-works-rest-api diff --git a/_sources/ibm_zos_cics/docs/source/modules.rst.txt b/_sources/ibm_zos_cics/docs/source/modules.rst.txt index 91743875..68863a68 100644 --- a/_sources/ibm_zos_cics/docs/source/modules.rst.txt +++ b/_sources/ibm_zos_cics/docs/source/modules.rst.txt @@ -9,6 +9,77 @@ Modules Modules can be used in a playbook to automate tasks. Ansible® executes each module on the target node and returns the result back to the controller. +The **IBM® z/OS® CICS® collection** provides two categories of modules: + +* Modules for working with CICS and CICSPlex SM resources and definitions. + These modules interact with CMCI over an HTTP connection by leveraging + the `CMCI REST API`_. These modules are collectively referred to as + **CMCI modules** in documentation. +* Modules for provisioning and deprovisioning of CICS TS regions and for + CICS startup and shutdown operations. These modules are collectively + referred to as CICS **provisioning modules** in documentation. + +These modules have different requirements of the managed node. For details, see :doc:`requirements_managed`. + +.. _CMCI REST API: + https://www.ibm.com/docs/en/cics-ts/latest?topic=cmci-how-it-works-rest-api + + +Using Defaults Groups in CICS Provisioning Modules +--------------- + +The CICS provisioning modules use several defaults groups. In particular, these two defaults groups are used for specific purposes: + +* ``cics_data_sets`` can be used to specify the location of a CICS installation. +* ``region_data_sets`` can be used to specify a high level qualifier for the data sets used by a single CICS region. + +The example below shows how to use these default groups within the **global_catalog** module. + +.. code-block:: yaml+jinja + + + - name: Initialize a global catalog + ibm.ibm_zos_cics.global_catalog: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "initial" + + +In the above example, the global catalog is created at the data set location of ``REGIONS.ABCD0001.DFHGCD``, +and the CICS load libraries can be found at ``CICSTS61.CICS``, which means that the SDFHLOAD library can be +found at ``CICSTS61.CICS.SDFHLOAD``. + +These groups can be placed in a `module_defaults`_ section, which means that all +the CICS provisioning modules use the same high level qualifier for the +region data sets, and the location of the CICS installation only has to be +declared once for all the modules. + +To override the data set location or name for a specific task, you can provide an +additional parameter to the ``region_data_sets`` group as shown in the example +for a global catalog data set below. + +.. code-block:: yaml+jinja + + + - name: Initialize a global catalog with a custom name + ibm.ibm_zos_cics.global_catalog: + region_data_sets: + dfhgcd: + dsn: "MY.CICS.GLOBAL.CATALOG" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "initial" + + +.. _module_defaults: + https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_module_defaults.html + + +Module Reference +--------------- + The **IBM® z/OS® CICS® collection** contains these modules. For each module, the accepted parameters, return values, and examples are provided in the documentation. diff --git a/_sources/ibm_zos_cics/docs/source/modules/aux_temp_storage.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/aux_temp_storage.rst.txt new file mode 100644 index 00000000..92dff8d3 --- /dev/null +++ b/_sources/ibm_zos_cics/docs/source/modules/aux_temp_storage.rst.txt @@ -0,0 +1,330 @@ +.. ............................................................................... +.. © Copyright IBM Corporation 2020,2023 . +.. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . +.. ............................................................................... + +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/aux_temp_storage.py + +.. _aux_temp_storage_module: + + +aux_temp_storage -- Create and remove the CICS auxiliary temporary storage data set +=================================================================================== + + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- Create and remove the \ `auxiliary temporary storage `__\ data set used by a CICS® region. +- You can use this module when provisioning or de-provisioning a CICS region. +- Use the \ :literal:`state`\ option to specify the intended state for the auxiliary temporary storage data set. For example, use \ :literal:`state=initial`\ to create an auxiliary temporary storage data set if it doesn't exist. + + + + + +Parameters +---------- + + + +region_data_sets + The location of the region data sets to be created by using a template, for example, \ :literal:`REGIONS.ABCD0001.\<\< data\_set\_name \>\>`\ . + + If you want to use a data set that already exists, ensure that the data set is an auxiliary temporary storage data set. + + + | **required**: True + | **type**: dict + + + + dfhtemp + Overrides the templated location for the auxiliary temporary storage data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of the auxiliary temporary storage to override the template. + + + | **required**: False + | **type**: str + + + + + template + The base location of the region data sets with a template. + + + | **required**: False + | **type**: str + + + + +space_primary + The size of the primary space allocated to the auxiliary temporary storage data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the auxiliary temporary storage data set is being created. If the data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 200 + + + +space_secondary + The size of the secondary space allocated to the auxiliary temporary storage data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the auxiliary temporary storage data set is being created. If the data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 10 + + + +space_type + The unit portion of the auxiliary temporary storage data set size. Note that this is just the unit; the value for the primary space is specified with \ :literal:`space\_primary`\ and the value for the secondary space is specified with \ :literal:`space\_secondary`\ . + + This option takes effect only when the auxiliary temporary storage data set is being created. If the data set already exists, the option has no effect. + + The size can be specified in megabytes (\ :literal:`M`\ ), kilobytes (\ :literal:`K`\ ), records (\ :literal:`REC`\ ), cylinders (\ :literal:`CYL`\ ), or tracks (\ :literal:`TRK`\ ). + + + | **required**: False + | **type**: str + | **default**: REC + | **choices**: M, K, REC, CYL, TRK + + + +state + The intended state for the auxiliary temporary storage data set, which the module aims to achieve. + + Specify \ :literal:`absent`\ to remove the auxiliary temporary storage data set entirely, if it already exists. + + Specify \ :literal:`initial`\ to create the auxiliary temporary storage data set, if it does not exist. If the specified data set exists but is empty, the module leaves the data set as is. If the specified data set exists and has contents, the module deletes the data set and then creates a new, empty data set. + + Specify \ :literal:`warm`\ to retain an existing auxiliary temporary storage data set in its current state. The module checks whether the specified data set exists, and if it does, leaves the data set as is. If the data set does not exist, the operation fails. + + + | **required**: True + | **type**: str + | **choices**: initial, absent, warm + + + +volumes + The volume(s) where the data set is created. Use a string to define a singular volume or a list of strings for multiple volumes. + + + | **required**: False + | **type**: raw + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Initialize an auxiliary temporary storage data set by using the templated location + ibm.ibm_zos_cics.aux_temp_storage: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "initial" + + - name: Initialize a user specified auxiliary temporary storage data set + ibm.ibm_zos_cics.aux_temp_storage: + region_data_sets: + dfhtemp: + dsn: "REGIONS.ABCD0001.DFHTEMP" + state: "initial" + + - name: Initialize a large auxiliary temporary storage data set by using the templated location + ibm.ibm_zos_cics.aux_temp_storage: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + space_primary: 50 + space_type: "M" + state: "initial" + + - name: Retain the existing state of an auxiliary temporary storage data set defined by the template + ibm.ibm_zos_cics.aux_temp_storage: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "warm" + + - name: Retain the existing state of a user specified auxiliary temporary storage data set + ibm.ibm_zos_cics.aux_temp_storage: + region_data_sets: + dfhtemp: + dsn: "REGIONS.ABCD0001.DFHTEMP" + state: "warm" + + - name: Delete an existing auxiliary temporary storage data set defined by the template + ibm.ibm_zos_cics.aux_temp_storage: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "absent" + + - name: Delete an existing user specified auxiliary temporary storage data set + ibm.ibm_zos_cics.aux_temp_storage: + region_data_sets: + dfhtemp: + dsn: "REGIONS.ABCD0001.DFHTEMP" + state: "absent" + + + + + + + + + +Return Values +------------- + + + + + changed + | True if the state was changed, otherwise False. + + | **returned**: always + | **type**: bool + + + + failed + | True if the Ansible task failed, otherwise False. + + | **returned**: always + | **type**: bool + + + + start_state + | The state of the auxiliary temporary storage data set before the Ansible task runs. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the start of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + exists + | True if the specified auxiliary temporary storage data set exists. + + | **returned**: always + | **type**: bool + + + + + + end_state + | The state of the auxiliary temporary storage data set at the end of the Ansible task. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the end of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + exists + | True if the specified auxiliary temporary storage data set exists. + + | **returned**: always + | **type**: bool + + + + + + executions + | A list of program executions performed during the Ansible task. + + | **returned**: always + | **type**: list + + + + name + | A human-readable name for the program execution. + + | **returned**: always + | **type**: str + + + + rc + | The return code for the program execution. + + | **returned**: always + | **type**: int + + + + stdout + | The standard output stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + stderr + | The standard error stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + + + msg + | A string containing an error message if applicable + + | **returned**: always + | **type**: str + + diff --git a/_sources/ibm_zos_cics/docs/source/modules/aux_trace.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/aux_trace.rst.txt new file mode 100644 index 00000000..1f4a4084 --- /dev/null +++ b/_sources/ibm_zos_cics/docs/source/modules/aux_trace.rst.txt @@ -0,0 +1,415 @@ +.. ............................................................................... +.. © Copyright IBM Corporation 2020,2023 . +.. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . +.. ............................................................................... + +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/aux_trace.py + +.. _aux_trace_module: + + +aux_trace -- Allocate auxiliary trace data sets +=============================================== + + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- Allocates the two \ `auxiliary trace `__\ data sets used by a CICS® region. When CICS auxiliary trace is activated, trace entries produced by CICS are written to the auxiliary trace data sets. These data sets can hold large amounts of trace data. +- The two data sets are referred to as auxiliary trace data set A (DFHAUXT) and auxiliary trace data set B (DFHBUXT). + + + + + +Parameters +---------- + + + +destination + Identify which one of the auxiliary trace data sets is the target of the operation. If the value is left blank, A is implied, but you can specify A or B. + + Specify \ :literal:`A`\ to create or delete the A data set. + + Specify \ :literal:`B`\ to create or delete the B data set. This MUST be set for the creation of the B data set. + + + | **required**: False + | **type**: str + | **default**: A + | **choices**: A, B + + + +region_data_sets + The location of the region data sets to be created by using a template, for example, \ :literal:`REGIONS.ABCD0001.\<\< data\_set\_name \>\>`\ . + + If you want to use a data set that already exists, ensure that the data set is an auxiliary trace data set. + + + | **required**: True + | **type**: dict + + + + dfhauxt + Overrides the templated location for the DFHAUXT data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of DFHAUXT to override the template. + + + | **required**: False + | **type**: str + + + + + dfhbuxt + Overrides the templated location for the DFHBUXT data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of DFHBUXT to override the template. + + + | **required**: False + | **type**: str + + + + + template + The base location of the region data sets with a template. + + + | **required**: False + | **type**: str + + + + +space_primary + The size of the primary space allocated to the auxiliary trace data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the auxiliary trace data set is being created. If the data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 20 + + + +space_secondary + The size of the secondary space allocated to the auxiliary trace data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the auxiliary trace data set is being created. If the data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 4 + + + +space_type + The unit portion of the auxiliary trace data set size. Note that this is just the unit; the value for the primary space is specified with \ :literal:`space\_primary`\ and the value for the secondary space is specified with \ :literal:`space\_secondary`\ . + + This option takes effect only when the auxiliary trace data set is being created. If the data set already exists, the option has no effect. + + The size can be specified in megabytes (\ :literal:`M`\ ), kilobytes (\ :literal:`K`\ ), cylinders (\ :literal:`CYL`\ ), or tracks (\ :literal:`TRK`\ ). + + + | **required**: False + | **type**: str + | **default**: M + | **choices**: M, K, CYL, TRK + + + +state + The intended state for the auxiliary trace data set, which the module aims to achieve. + + Specify \ :literal:`absent`\ to remove the auxiliary trace data set data set entirely, if it exists. + + Specify \ :literal:`initial`\ to create the auxiliary trace data set if it does not exist. If the specified data set exists but is empty, the module leaves the data set as is. If the specified data set exists and has contents, the module deletes the data set and then creates a new, empty one. + + Specify \ :literal:`warm`\ to retain an existing auxiliary trace data set in its current state. The module checks whether the specified data set exists, and if it does, leaves the data set as is. If the data set does not exist, the operation fails. + + + | **required**: True + | **type**: str + | **choices**: initial, absent, warm + + + +volumes + The volume(s) where the data set is created. Use a string to define a singular volume or a list of strings for multiple volumes. + + + | **required**: False + | **type**: raw + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Allocate auxiliary trace data set A (implicit) by using the templated location + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: initial + + - name: Allocate a user specified data set as auxiliary trace data set A (implicit) + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + dfhauxt: + dsn: "REGIONS.ABCD0001.DFHAUXT" + state: initial + + - name: Allocate auxiliary trace data set A by using the templated location + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: initial + destination: A + + - name: Allocate a user specified data set as auxiliary trace data set A + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + dfhauxt: + dsn: "REGIONS.ABCD0001.DFHAUXT" + state: initial + destination: A + + - name: Allocate auxiliary trace data set B by using the templated location + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: initial + destination: B + + - name: Allocate a user specified data set as auxiliary trace data set B + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + dfhbuxt: + dsn: "REGIONS.ABCD0001.DFHBUXT" + state: initial + destination: B + + - name: Retain the existing state of auxiliary trace data set A (implicit) defined by the template + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "warm" + + - name: Retain the existing state of a user specified auxiliary trace data set A (implicit) + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + dfhauxt: + dsn: "REGIONS.ABCD0001.DFHAUXT" + state: "warm" + + - name: Retain the existing state of auxiliary trace data set B defined by the template + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "warm" + destination: B + + - name: Retain the existing state of a user specified auxiliary trace data set B + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + dfhbuxt: + dsn: "REGIONS.ABCD0001.DFHBUXT" + state: "warm" + destination: B + + - name: Delete auxiliary trace data set A (implicit) defined by the template + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: absent + + - name: Delete a user specified auxiliary trace data set A (implicit) + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + dfhauxt: + dsn: "REGIONS.ABCD0001.DFHBUXT" + state: absent + + - name: Delete auxiliary trace data set B defined by the template + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: absent + destination: B + + - name: Delete a user specified auxiliary trace data set B + ibm.ibm_zos_cics.aux_trace: + region_data_sets: + dfhbuxt: + dsn: "REGIONS.ABCD0001.DFHBUXT" + state: absent + destination: B + + + + + + + + + +Return Values +------------- + + + + + changed + | True if the state was changed, otherwise False. + + | **returned**: always + | **type**: bool + + + + failed + | True if the Ansible task failed, otherwise False. + + | **returned**: always + | **type**: bool + + + + start_state + | The state of the auxiliary trace data set before the Ansible task runs. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the start of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: Sequential + + + + + + exists + | True if the specified auxiliary trace data set exists. + + | **returned**: always + | **type**: bool + + + + + + end_state + | The state of the auxiliary trace data set at the end of the Ansible task. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the end of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: Sequential + + + + + + exists + | True if the specified auxiliary trace data set exists. + + | **returned**: always + | **type**: bool + + + + + + executions + | A list of program executions performed during the Ansible task. + + | **returned**: always + | **type**: list + + + + name + | A human-readable name for the program execution. + + | **returned**: always + | **type**: str + + + + rc + | The return code for the program execution. + + | **returned**: always + | **type**: int + + + + stdout + | The standard output stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + stderr + | The standard error stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + + + msg + | A string containing an error message if applicable + + | **returned**: always + | **type**: str + + diff --git a/_sources/ibm_zos_cics/docs/source/modules/cmci_action.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/cmci_action.rst.txt index ef762942..877481ae 100644 --- a/_sources/ibm_zos_cics/docs/source/modules/cmci_action.rst.txt +++ b/_sources/ibm_zos_cics/docs/source/modules/cmci_action.rst.txt @@ -1,9 +1,9 @@ .. ............................................................................... -.. © Copyright IBM Corporation 2020 . +.. © Copyright IBM Corporation 2020,2023 . .. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . .. ............................................................................... -:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/dev/plugins/modules/cmci_action.py +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/cmci_action.py .. _cmci_action_module: @@ -20,7 +20,7 @@ cmci_action -- Perform actions on CICS and CICSPlex SM resources Synopsis -------- -- Perform actions on CICS® or CICSPlex® SM definitions and resources, by initiating PUT requests via the CMCI REST API. The CMCI REST API can be configured in CICSPlex SM or stand-alone regions (SMSS). For information about the API, see `CMCI REST API `_. For information about how to compose PUT requests, see `CMCI PUT requests `_. +- Perform actions on CICS® or CICSPlex® SM definitions and resources, by initiating PUT requests via the CMCI REST API. The CMCI REST API can be configured in CICSPlex SM or stand-alone regions (SMSS). For information about the API, see \ `CMCI REST API `__\ . For information about how to compose PUT requests, see \ `CMCI PUT requests `__\ . @@ -32,7 +32,7 @@ Parameters action_name - The name of the target action. To find the name of the appropriate action, consult the CICSPlex SM resource tables for the target resource type. For example, the `PROGRAM resource table reference `_ lists the eligible actions for CICS programs. + The name of the target action. To find the name of the appropriate action, consult the CICSPlex SM resource tables for the target resource type. For example, the \ `PROGRAM resource table reference `__\ lists the eligible actions for CICS programs. @@ -42,7 +42,7 @@ action_name action_parameters - A list of one or more parameters that control the *action* operation. Eligible actions and corresponding parameters for the target operation can be found in the resource table reference for the target resource type, as listed in the PERFORM SET operation section of the "Valid CPSM operations" table. For example, the valid parameters for a PROGDEF CSDCOPY action are ``AS_RESOURCE``, ``DUPACTION`` and ``TO_CSDGROUP``, as found in the `PROGDEF resource table reference `_. + A list of one or more parameters that control the \ :emphasis:`action`\ operation. Eligible actions and corresponding parameters for the target operation can be found in the resource table reference for the target resource type, as listed in the PERFORM SET operation section of the "Valid CPSM operations" table. For example, the valid parameters for a PROGDEF CSDCOPY action are \ :literal:`AS\_RESOURCE`\ , \ :literal:`DUPACTION`\ and \ :literal:`TO\_CSDGROUP`\ , as found in the \ `PROGDEF resource table reference `__\ . @@ -74,11 +74,11 @@ action_parameters cmci_cert Location of the PEM-formatted certificate chain file to be used for HTTPS client authentication. - Can also be specified using the environment variable CMCI_CERT. + Can also be specified using the environment variable CMCI\_CERT. - Required if *cmci_key* is specified. + Required if \ :emphasis:`cmci\_key`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: False @@ -98,11 +98,11 @@ cmci_host cmci_key Location of the PEM-formatted file storing your private key to be used for HTTPS client authentication. - Can also be specified using the environment variable CMCI_KEY. + Can also be specified using the environment variable CMCI\_KEY. - Required if *cmci_cert* is specified. + Required if \ :emphasis:`cmci\_cert`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: False @@ -111,13 +111,13 @@ cmci_key cmci_password - The password of *cmci_user* to pass HTTP basic authentication. + The password of \ :emphasis:`cmci\_user`\ to pass HTTP basic authentication. - Can also be specified using the environment variable CMCI_PASSWORD. + Can also be specified using the environment variable CMCI\_PASSWORD. - Required if *cmci_user* is specified. + Required if \ :emphasis:`cmci\_user`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: false @@ -137,11 +137,11 @@ cmci_port cmci_user The user ID under which the CMCI request will run. - Can also be specified using the environment variable CMCI_USER. + Can also be specified using the environment variable CMCI\_USER. - Required if *cmci_password* is specified. + Required if \ :emphasis:`cmci\_password`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: false @@ -150,11 +150,11 @@ cmci_user context - If CMCI is installed in a CICSPlex® SM environment, *context* is the name of the CICSplex or CMAS associated with the request, for example, ``PLEX1``. To determine whether a CMAS can be specified as *context*, see the **CMAS context** entry in the CICSPlex SM resource table reference of a resource. For example, according to the `PROGRAM resource table `_, CMAS context is not supported for PROGRAM. + If CMCI is installed in a CICSPlex® SM environment, \ :emphasis:`context`\ is the name of the CICSplex or CMAS associated with the request, for example, \ :literal:`PLEX1`\ . To determine whether a CMAS can be specified as \ :emphasis:`context`\ , see the \ :strong:`CMAS context`\ entry in the CICSPlex SM resource table reference of a resource. For example, according to the \ `PROGRAM resource table `__\ , CMAS context is not supported for PROGRAM. - If CMCI is installed in a single region (SMSS), *context* is the APPLID of the CICS region associate with the request. + If CMCI is installed in a single region (SMSS), \ :emphasis:`context`\ is the APPLID of the CICS region associate with the request. - The value of *context* must contain no spaces. *context* is not case-sensitive. + The value of \ :emphasis:`context`\ must contain no spaces. \ :emphasis:`context`\ is not case-sensitive. | **required**: True @@ -163,7 +163,7 @@ context insecure - When set to ``true``, disables SSL certificate trust chain verification when using HTTPS. + When set to \ :literal:`true`\ , disables SSL certificate trust chain verification when using HTTPS. | **required**: False @@ -181,17 +181,17 @@ resources complex_filter - A dictionary representing a complex filter expression. Complex filters are composed of filter expressions, represented as dictionaries. Each dictionary can specify either an attribute expression, a list of filter expressions to be composed with the ``and`` operator, or a list of filter expressions to be composed with the ``or`` operator. + A dictionary representing a complex filter expression. Complex filters are composed of filter expressions, represented as dictionaries. Each dictionary can specify either an attribute expression, a list of filter expressions to be composed with the \ :literal:`and`\ operator, or a list of filter expressions to be composed with the \ :literal:`or`\ operator. - The ``attribute``, ``and`` and ``or`` options are mutually exclusive with each other. + The \ :literal:`attribute`\ , \ :literal:`and`\ and \ :literal:`or`\ options are mutually exclusive with each other. - Can contain one or more filters. Multiple filters must be combined using ``and`` or ``or`` logical operators. + Can contain one or more filters. Multiple filters must be combined using \ :literal:`and`\ or \ :literal:`or`\ logical operators. Filters can be nested. - When supplying the ``attribute`` option, you must also supply a ``value`` for the filter. You can also override the default operator of ``=`` with the ``operator`` option. + When supplying the \ :literal:`attribute`\ option, you must also supply a \ :literal:`value`\ for the filter. You can also override the default operator of \ :literal:`=`\ with the \ :literal:`operator`\ option. - For examples, see "Examples" in :ref:`cmci_get `. + For examples, see "Examples" in \ :ref:`ibm.ibm\_zos\_cics.cmci\_get `\ . | **required**: False @@ -200,9 +200,9 @@ resources and - A list of filter expressions to be combined with an ``and`` operation. + A list of filter expressions to be combined with an \ :literal:`and`\ operation. - Filter expressions are nested ``complex_filter`` elements. Each nested filter expression can be either an ``attribute``, ``and`` or ``or`` complex filter expression. + Filter expressions are nested \ :literal:`complex\_filter`\ elements. Each nested filter expression can be either an \ :literal:`attribute`\ , \ :literal:`and`\ or \ :literal:`or`\ complex filter expression. | **required**: False @@ -213,7 +213,7 @@ resources attribute The name of a resource table attribute on which to filter. - For supported attributes of different resource types, see their resource table reference, for example, `PROGDEF resource table reference `_. + For supported attributes of different resource types, see their resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -222,7 +222,7 @@ resources operator - These operators are accepted: ``<`` or ``LT`` (less than), ``<=`` or ``LE`` (less than or equal to), ``=`` or ``EQ`` (equal to), ``>`` or ``GT`` (greater than), ``>=`` or ``GE`` (greater than or equal to), ``==`` or ``IS`` (is), ``¬=``, ``!=``, or ``NE`` (not equal to). If not supplied when ``attribute`` is used, ``EQ`` is assumed. + These operators are accepted: \ :literal:`\<`\ or \ :literal:`LT`\ (less than), \ :literal:`\<=`\ or \ :literal:`LE`\ (less than or equal to), \ :literal:`=`\ or \ :literal:`EQ`\ (equal to), \ :literal:`\>`\ or \ :literal:`GT`\ (greater than), \ :literal:`\>=`\ or \ :literal:`GE`\ (greater than or equal to), \ :literal:`==`\ or \ :literal:`IS`\ (is), \ :literal:`¬=`\ , \ :literal:`!=`\ , or \ :literal:`NE`\ (not equal to). If not supplied when \ :literal:`attribute`\ is used, \ :literal:`EQ`\ is assumed. @@ -233,9 +233,9 @@ resources or - A list of filter expressions to be combined with an ``or`` operation. + A list of filter expressions to be combined with an \ :literal:`or`\ operation. - Filter expressions are nested ``complex_filter`` elements. Each nested filter expression can be either an ``attribute``, ``and`` or ``or`` complex filter expression. + Filter expressions are nested \ :literal:`complex\_filter`\ elements. Each nested filter expression can be either an \ :literal:`attribute`\ , \ :literal:`and`\ or \ :literal:`or`\ complex filter expression. | **required**: False @@ -246,7 +246,7 @@ resources value The value by which you are to filter the resource attributes. - The value must be a valid one for the resource table attribute as documented in the resource table reference, for example, `PROGDEF resource table reference `_. + The value must be a valid one for the resource table attribute as documented in the resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -258,21 +258,21 @@ resources filter A dictionary with attribute names as keys, and target values, to be used as criteria to filter the set of resources returned from CICSPlex SM. - Filters implicitly use the ``=`` operator. + Filters implicitly use the \ :literal:`=`\ operator. - Filters for ``string`` type attributes can use the ``*`` and ``+`` wildcard operators. + Filters for \ :literal:`string`\ type attributes can use the \ :literal:`\*`\ and \ :literal:`+`\ wildcard operators. - ``*`` is a wildcard representing an unknown number of characters, and must appear at the end of the value. + \ :literal:`\*`\ is a wildcard representing an unknown number of characters, and must appear at the end of the value. - ``+`` is a wildcard representing a single character, and can appear in any place in the value, potentially multiple times. + \ :literal:`+`\ is a wildcard representing a single character, and can appear in any place in the value, potentially multiple times. - To use more complicated filter expressions, including a range of different filter operators, and the ability to compose filters with ``and`` and ``or`` operators, see the ``complex_filter`` parameter. + To use more complicated filter expressions, including a range of different filter operators, and the ability to compose filters with \ :literal:`and`\ and \ :literal:`or`\ operators, see the \ :literal:`complex\_filter`\ parameter. - For more details, see `How to build a filter expression `_. + For more details, see \ `How to build a filter expression `__\ . - For examples, see :ref:`cmci_get ` + For examples, see \ :ref:`ibm.ibm\_zos\_cics.cmci\_get `\ . - For supported attributes of different resource types, see their resource table reference, for example, `PROGDEF resource table reference `_. + For supported attributes of different resource types, see their resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -281,7 +281,7 @@ resources get_parameters - A list of one or more parameters with optional values used to identify the resources for this request. Eligible parameters for identifying the target resources can be found in the resource table reference for the target resource type, as valid parameters for the GET operation in the "Valid CPSM operations" table. For example, the valid parameters for identifying a PROGDEF resource are CICSSYS, CSDGROUP and RESGROUP, as found in the `PROGDEF resource table reference `_. + A list of one or more parameters with optional values used to identify the resources for this request. Eligible parameters for identifying the target resources can be found in the resource table reference for the target resource type, as valid parameters for the GET operation in the "Valid CPSM operations" table. For example, the valid parameters for identifying a PROGDEF resource are CICSSYS, CSDGROUP and RESGROUP, as found in the \ `PROGDEF resource table reference `__\ . @@ -324,11 +324,11 @@ scheme scope Specifies the name of a CICSplex, CICS region group, CICS region, or logical scope that is associated with the query. - *scope* is a subset of *context* and limits the request to particular CICS systems or resources. + \ :emphasis:`scope`\ is a subset of \ :emphasis:`context`\ and limits the request to particular CICS systems or resources. - *scope* is optional. If it's not specified, the request is limited by the value of *context* alone. + \ :emphasis:`scope`\ is optional. If it's not specified, the request is limited by the value of \ :emphasis:`context`\ alone. - The value of *scope* must contain no spaces. *scope* is not case-sensitive. + The value of \ :emphasis:`scope`\ must contain no spaces. \ :emphasis:`scope`\ is not case-sensitive. | **required**: false @@ -336,8 +336,18 @@ scope +timeout + HTTP request timeout in seconds + + + | **required**: False + | **type**: int + | **default**: 30 + + + type - The CMCI external resource name that maps to the target CICS or CICSPlex SM resource type. For a list of CMCI external resource names, see `CMCI resource names `_. + The CMCI external resource name that maps to the target CICS or CICSPlex SM resource type. For a list of CMCI external resource names, see \ `CMCI resource names `__\ . | **required**: True @@ -354,31 +364,31 @@ Examples - name: Newcopy a program cmci_action: - cmci_host: 'winmvs2c.hursley.ibm.com' + cmci_host: "winmvs2c.hursley.ibm.com" cmci_port: 10080 - context: 'iyk3z0r9' - type: 'CICSProgram' + context: "iyk3z0r9" + type: "CICSProgram" action_name: NEWCOPY - resources: + resource: filter: - name: 'PONGALT' + name: "PONGALT" get_parameters: - - name: 'csdgroup' - value: 'JVMGRP' + - name: "csdgroup" + value: "JVMGRP" - name: install a bundle in a CICS region cmci_action: - cmci_host: 'winmvs2c.hursley.ibm.com' - cmci_port: '10080' - context: 'iyk3z0r9' + cmci_host: "winmvs2c.hursley.ibm.com" + cmci_port: "10080" + context: "iyk3z0r9" type: CICSBundle action_name: install - resources: + resource: filter: - name: 'PONGALT' + name: "PONGALT" action_parameters: - - name: 'usage' - value: 'local' + - name: "usage" + value: "local" @@ -419,7 +429,7 @@ Return Values cpsm_reason - | The character value of the REASON code returned by each CICSPlex SM API command. For a list of REASON character values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2ky.html. + | The character value of the REASON code returned by each CICSPlex SM API command. For a list of REASON character values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-reason-in-alphabetical-order. | **returned**: success | **type**: str @@ -427,7 +437,7 @@ Return Values cpsm_reason_code - | The numeric value of the REASON code returned by each CICSPlex SM API command. For a list of REASON numeric values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kw.html. + | The numeric value of the REASON code returned by each CICSPlex SM API command. For a list of REASON numeric values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-reason-in-numerical-order. | **returned**: success | **type**: int @@ -435,7 +445,7 @@ Return Values cpsm_response - | The character value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE character values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kx.html. + | The character value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE character values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-response-in-alphabetical-order. | **returned**: success | **type**: str @@ -443,7 +453,7 @@ Return Values cpsm_response_code - | The numeric value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE numeric values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kv.html. + | The numeric value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE numeric values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-response-in-numerical-order. | **returned**: success | **type**: str diff --git a/_sources/ibm_zos_cics/docs/source/modules/cmci_create.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/cmci_create.rst.txt index 048f2d37..6c1d4d9c 100644 --- a/_sources/ibm_zos_cics/docs/source/modules/cmci_create.rst.txt +++ b/_sources/ibm_zos_cics/docs/source/modules/cmci_create.rst.txt @@ -1,9 +1,9 @@ .. ............................................................................... -.. © Copyright IBM Corporation 2020 . +.. © Copyright IBM Corporation 2020,2023 . .. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . .. ............................................................................... -:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/dev/plugins/modules/cmci_create.py +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/cmci_create.py .. _cmci_create_module: @@ -20,7 +20,7 @@ cmci_create -- Create CICS and CICSPlex SM definitions Synopsis -------- -- Create definitional CICS® or CICSPlex® SM resources in CSD and BAS repositories, by initiating POST requests via the CMCI REST API. The CMCI REST API can be configured in CICSPlex SM or stand-alone regions (SMSS). For information about the API, see `CMCI REST API `_. For information about how to compose POST requests, see `CMCI POST requests `_. +- Create definitional CICS® or CICSPlex® SM resources in CSD and BAS repositories, by initiating POST requests via the CMCI REST API. The CMCI REST API can be configured in CICSPlex SM or stand-alone regions (SMSS). For information about the API, see \ `CMCI REST API `__\ . For information about how to compose POST requests, see \ `CMCI POST requests `__\ . @@ -32,7 +32,7 @@ Parameters attributes - The resource attributes to be created or updated. Available attributes can be found in the CICSPlex® SM resource table reference for the target resource type, for example, `PROGDEF resource table reference `_. + The resource attributes to be created or updated. Available attributes can be found in the CICSPlex® SM resource table reference for the target resource type, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -43,11 +43,11 @@ attributes cmci_cert Location of the PEM-formatted certificate chain file to be used for HTTPS client authentication. - Can also be specified using the environment variable CMCI_CERT. + Can also be specified using the environment variable CMCI\_CERT. - Required if *cmci_key* is specified. + Required if \ :emphasis:`cmci\_key`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: False @@ -67,11 +67,11 @@ cmci_host cmci_key Location of the PEM-formatted file storing your private key to be used for HTTPS client authentication. - Can also be specified using the environment variable CMCI_KEY. + Can also be specified using the environment variable CMCI\_KEY. - Required if *cmci_cert* is specified. + Required if \ :emphasis:`cmci\_cert`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: False @@ -80,13 +80,13 @@ cmci_key cmci_password - The password of *cmci_user* to pass HTTP basic authentication. + The password of \ :emphasis:`cmci\_user`\ to pass HTTP basic authentication. - Can also be specified using the environment variable CMCI_PASSWORD. + Can also be specified using the environment variable CMCI\_PASSWORD. - Required if *cmci_user* is specified. + Required if \ :emphasis:`cmci\_user`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: false @@ -106,11 +106,11 @@ cmci_port cmci_user The user ID under which the CMCI request will run. - Can also be specified using the environment variable CMCI_USER. + Can also be specified using the environment variable CMCI\_USER. - Required if *cmci_password* is specified. + Required if \ :emphasis:`cmci\_password`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: false @@ -119,11 +119,11 @@ cmci_user context - If CMCI is installed in a CICSPlex® SM environment, *context* is the name of the CICSplex or CMAS associated with the request, for example, ``PLEX1``. To determine whether a CMAS can be specified as *context*, see the **CMAS context** entry in the CICSPlex SM resource table reference of a resource. For example, according to the `PROGRAM resource table `_, CMAS context is not supported for PROGRAM. + If CMCI is installed in a CICSPlex® SM environment, \ :emphasis:`context`\ is the name of the CICSplex or CMAS associated with the request, for example, \ :literal:`PLEX1`\ . To determine whether a CMAS can be specified as \ :emphasis:`context`\ , see the \ :strong:`CMAS context`\ entry in the CICSPlex SM resource table reference of a resource. For example, according to the \ `PROGRAM resource table `__\ , CMAS context is not supported for PROGRAM. - If CMCI is installed in a single region (SMSS), *context* is the APPLID of the CICS region associate with the request. + If CMCI is installed in a single region (SMSS), \ :emphasis:`context`\ is the APPLID of the CICS region associate with the request. - The value of *context* must contain no spaces. *context* is not case-sensitive. + The value of \ :emphasis:`context`\ must contain no spaces. \ :emphasis:`context`\ is not case-sensitive. | **required**: True @@ -132,7 +132,7 @@ context create_parameters - A list of one or more parameters that control the *create* operation. Eligible parameters for the CREATE operation can be found in the resource table reference for the target resource type, as listed in the CREATE operation section of the "Valid CPSM operations" table. For example, the valid parameters for a PROGDEF CREATE operation are CSD and RESGROUP, as found in the `PROGDEF resource table reference `_. + A list of one or more parameters that control the \ :emphasis:`create`\ operation. Eligible parameters for the CREATE operation can be found in the resource table reference for the target resource type, as listed in the CREATE operation section of the "Valid CPSM operations" table. For example, the valid parameters for a PROGDEF CREATE operation are CSD and RESGROUP, as found in the \ `PROGDEF resource table reference `__\ . @@ -161,7 +161,7 @@ create_parameters insecure - When set to ``true``, disables SSL certificate trust chain verification when using HTTPS. + When set to \ :literal:`true`\ , disables SSL certificate trust chain verification when using HTTPS. | **required**: False @@ -183,11 +183,11 @@ scheme scope Specifies the name of a CICSplex, CICS region group, CICS region, or logical scope that is associated with the query. - *scope* is a subset of *context* and limits the request to particular CICS systems or resources. + \ :emphasis:`scope`\ is a subset of \ :emphasis:`context`\ and limits the request to particular CICS systems or resources. - *scope* is optional. If it's not specified, the request is limited by the value of *context* alone. + \ :emphasis:`scope`\ is optional. If it's not specified, the request is limited by the value of \ :emphasis:`context`\ alone. - The value of *scope* must contain no spaces. *scope* is not case-sensitive. + The value of \ :emphasis:`scope`\ must contain no spaces. \ :emphasis:`scope`\ is not case-sensitive. | **required**: false @@ -195,8 +195,18 @@ scope +timeout + HTTP request timeout in seconds + + + | **required**: False + | **type**: int + | **default**: 30 + + + type - The CMCI external resource name that maps to the target CICS or CICSPlex SM resource type. For a list of CMCI external resource names, see `CMCI resource names `_. + The CMCI external resource name that maps to the target CICS or CICSPlex SM resource type. For a list of CMCI external resource names, see \ `CMCI resource names `__\ . | **required**: True @@ -213,16 +223,16 @@ Examples - name: define a BUNDLE in a CSD cmci_create: - cmci_host: 'winmvs2c.hursley.ibm.com' + cmci_host: "winmvs2c.hursley.ibm.com" cmci_port: 10080 - context: 'iyk3z0r9' - type: 'CICSDefinitionBundle' + context: "iyk3z0r9" + type: "CICSDefinitionBundle" attributes: name: PONGALT bundledir: /u/ibmuser/bundle/pong/pongbundle_1.0.0 csdgroup: JVMGRP create_parameters: - - name: 'csd' + - name: "csd" @@ -263,7 +273,7 @@ Return Values cpsm_reason - | The character value of the REASON code returned by each CICSPlex SM API command. For a list of REASON character values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2ky.html. + | The character value of the REASON code returned by each CICSPlex SM API command. For a list of REASON character values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-reason-in-alphabetical-order. | **returned**: success | **type**: str @@ -271,7 +281,7 @@ Return Values cpsm_reason_code - | The numeric value of the REASON code returned by each CICSPlex SM API command. For a list of REASON numeric values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kw.html. + | The numeric value of the REASON code returned by each CICSPlex SM API command. For a list of REASON numeric values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-reason-in-numerical-order. | **returned**: success | **type**: int @@ -279,7 +289,7 @@ Return Values cpsm_response - | The character value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE character values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kx.html. + | The character value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE character values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-response-in-alphabetical-order. | **returned**: success | **type**: str @@ -287,7 +297,7 @@ Return Values cpsm_response_code - | The numeric value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE numeric values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kv.html. + | The numeric value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE numeric values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-response-in-numerical-order. | **returned**: success | **type**: str diff --git a/_sources/ibm_zos_cics/docs/source/modules/cmci_delete.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/cmci_delete.rst.txt index 484f5dde..5ba2e80f 100644 --- a/_sources/ibm_zos_cics/docs/source/modules/cmci_delete.rst.txt +++ b/_sources/ibm_zos_cics/docs/source/modules/cmci_delete.rst.txt @@ -1,9 +1,9 @@ .. ............................................................................... -.. © Copyright IBM Corporation 2020 . +.. © Copyright IBM Corporation 2020,2023 . .. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . .. ............................................................................... -:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/dev/plugins/modules/cmci_delete.py +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/cmci_delete.py .. _cmci_delete_module: @@ -20,7 +20,7 @@ cmci_delete -- Delete CICS and CICSPlex SM resources Synopsis -------- -- Remove or discard definitional or installed CICS® and CICSPlex® SM resources from CICS regions, by initiating DELETE requests via the CMCI REST API. The CMCI REST API can be configured in CICSPlex SM or stand-alone regions (SMSS). For information about the API, see `CMCI REST API `_. For information about how to compose DELETE requests, see `CMCI DELETE requests `_. +- Remove or discard definitional or installed CICS® and CICSPlex® SM resources from CICS regions, by initiating DELETE requests via the CMCI REST API. The CMCI REST API can be configured in CICSPlex SM or stand-alone regions (SMSS). For information about the API, see \ `CMCI REST API `__\ . For information about how to compose DELETE requests, see \ `CMCI DELETE requests `__\ . @@ -34,11 +34,11 @@ Parameters cmci_cert Location of the PEM-formatted certificate chain file to be used for HTTPS client authentication. - Can also be specified using the environment variable CMCI_CERT. + Can also be specified using the environment variable CMCI\_CERT. - Required if *cmci_key* is specified. + Required if \ :emphasis:`cmci\_key`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: False @@ -58,11 +58,11 @@ cmci_host cmci_key Location of the PEM-formatted file storing your private key to be used for HTTPS client authentication. - Can also be specified using the environment variable CMCI_KEY. + Can also be specified using the environment variable CMCI\_KEY. - Required if *cmci_cert* is specified. + Required if \ :emphasis:`cmci\_cert`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: False @@ -71,13 +71,13 @@ cmci_key cmci_password - The password of *cmci_user* to pass HTTP basic authentication. + The password of \ :emphasis:`cmci\_user`\ to pass HTTP basic authentication. - Can also be specified using the environment variable CMCI_PASSWORD. + Can also be specified using the environment variable CMCI\_PASSWORD. - Required if *cmci_user* is specified. + Required if \ :emphasis:`cmci\_user`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: false @@ -97,11 +97,11 @@ cmci_port cmci_user The user ID under which the CMCI request will run. - Can also be specified using the environment variable CMCI_USER. + Can also be specified using the environment variable CMCI\_USER. - Required if *cmci_password* is specified. + Required if \ :emphasis:`cmci\_password`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: false @@ -110,11 +110,11 @@ cmci_user context - If CMCI is installed in a CICSPlex® SM environment, *context* is the name of the CICSplex or CMAS associated with the request, for example, ``PLEX1``. To determine whether a CMAS can be specified as *context*, see the **CMAS context** entry in the CICSPlex SM resource table reference of a resource. For example, according to the `PROGRAM resource table `_, CMAS context is not supported for PROGRAM. + If CMCI is installed in a CICSPlex® SM environment, \ :emphasis:`context`\ is the name of the CICSplex or CMAS associated with the request, for example, \ :literal:`PLEX1`\ . To determine whether a CMAS can be specified as \ :emphasis:`context`\ , see the \ :strong:`CMAS context`\ entry in the CICSPlex SM resource table reference of a resource. For example, according to the \ `PROGRAM resource table `__\ , CMAS context is not supported for PROGRAM. - If CMCI is installed in a single region (SMSS), *context* is the APPLID of the CICS region associate with the request. + If CMCI is installed in a single region (SMSS), \ :emphasis:`context`\ is the APPLID of the CICS region associate with the request. - The value of *context* must contain no spaces. *context* is not case-sensitive. + The value of \ :emphasis:`context`\ must contain no spaces. \ :emphasis:`context`\ is not case-sensitive. | **required**: True @@ -123,7 +123,7 @@ context insecure - When set to ``true``, disables SSL certificate trust chain verification when using HTTPS. + When set to \ :literal:`true`\ , disables SSL certificate trust chain verification when using HTTPS. | **required**: False @@ -141,17 +141,17 @@ resources complex_filter - A dictionary representing a complex filter expression. Complex filters are composed of filter expressions, represented as dictionaries. Each dictionary can specify either an attribute expression, a list of filter expressions to be composed with the ``and`` operator, or a list of filter expressions to be composed with the ``or`` operator. + A dictionary representing a complex filter expression. Complex filters are composed of filter expressions, represented as dictionaries. Each dictionary can specify either an attribute expression, a list of filter expressions to be composed with the \ :literal:`and`\ operator, or a list of filter expressions to be composed with the \ :literal:`or`\ operator. - The ``attribute``, ``and`` and ``or`` options are mutually exclusive with each other. + The \ :literal:`attribute`\ , \ :literal:`and`\ and \ :literal:`or`\ options are mutually exclusive with each other. - Can contain one or more filters. Multiple filters must be combined using ``and`` or ``or`` logical operators. + Can contain one or more filters. Multiple filters must be combined using \ :literal:`and`\ or \ :literal:`or`\ logical operators. Filters can be nested. - When supplying the ``attribute`` option, you must also supply a ``value`` for the filter. You can also override the default operator of ``=`` with the ``operator`` option. + When supplying the \ :literal:`attribute`\ option, you must also supply a \ :literal:`value`\ for the filter. You can also override the default operator of \ :literal:`=`\ with the \ :literal:`operator`\ option. - For examples, see "Examples" in :ref:`cmci_get `. + For examples, see "Examples" in \ :ref:`ibm.ibm\_zos\_cics.cmci\_get `\ . | **required**: False @@ -160,9 +160,9 @@ resources and - A list of filter expressions to be combined with an ``and`` operation. + A list of filter expressions to be combined with an \ :literal:`and`\ operation. - Filter expressions are nested ``complex_filter`` elements. Each nested filter expression can be either an ``attribute``, ``and`` or ``or`` complex filter expression. + Filter expressions are nested \ :literal:`complex\_filter`\ elements. Each nested filter expression can be either an \ :literal:`attribute`\ , \ :literal:`and`\ or \ :literal:`or`\ complex filter expression. | **required**: False @@ -173,7 +173,7 @@ resources attribute The name of a resource table attribute on which to filter. - For supported attributes of different resource types, see their resource table reference, for example, `PROGDEF resource table reference `_. + For supported attributes of different resource types, see their resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -182,7 +182,7 @@ resources operator - These operators are accepted: ``<`` or ``LT`` (less than), ``<=`` or ``LE`` (less than or equal to), ``=`` or ``EQ`` (equal to), ``>`` or ``GT`` (greater than), ``>=`` or ``GE`` (greater than or equal to), ``==`` or ``IS`` (is), ``¬=``, ``!=``, or ``NE`` (not equal to). If not supplied when ``attribute`` is used, ``EQ`` is assumed. + These operators are accepted: \ :literal:`\<`\ or \ :literal:`LT`\ (less than), \ :literal:`\<=`\ or \ :literal:`LE`\ (less than or equal to), \ :literal:`=`\ or \ :literal:`EQ`\ (equal to), \ :literal:`\>`\ or \ :literal:`GT`\ (greater than), \ :literal:`\>=`\ or \ :literal:`GE`\ (greater than or equal to), \ :literal:`==`\ or \ :literal:`IS`\ (is), \ :literal:`¬=`\ , \ :literal:`!=`\ , or \ :literal:`NE`\ (not equal to). If not supplied when \ :literal:`attribute`\ is used, \ :literal:`EQ`\ is assumed. @@ -193,9 +193,9 @@ resources or - A list of filter expressions to be combined with an ``or`` operation. + A list of filter expressions to be combined with an \ :literal:`or`\ operation. - Filter expressions are nested ``complex_filter`` elements. Each nested filter expression can be either an ``attribute``, ``and`` or ``or`` complex filter expression. + Filter expressions are nested \ :literal:`complex\_filter`\ elements. Each nested filter expression can be either an \ :literal:`attribute`\ , \ :literal:`and`\ or \ :literal:`or`\ complex filter expression. | **required**: False @@ -206,7 +206,7 @@ resources value The value by which you are to filter the resource attributes. - The value must be a valid one for the resource table attribute as documented in the resource table reference, for example, `PROGDEF resource table reference `_. + The value must be a valid one for the resource table attribute as documented in the resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -218,21 +218,21 @@ resources filter A dictionary with attribute names as keys, and target values, to be used as criteria to filter the set of resources returned from CICSPlex SM. - Filters implicitly use the ``=`` operator. + Filters implicitly use the \ :literal:`=`\ operator. - Filters for ``string`` type attributes can use the ``*`` and ``+`` wildcard operators. + Filters for \ :literal:`string`\ type attributes can use the \ :literal:`\*`\ and \ :literal:`+`\ wildcard operators. - ``*`` is a wildcard representing an unknown number of characters, and must appear at the end of the value. + \ :literal:`\*`\ is a wildcard representing an unknown number of characters, and must appear at the end of the value. - ``+`` is a wildcard representing a single character, and can appear in any place in the value, potentially multiple times. + \ :literal:`+`\ is a wildcard representing a single character, and can appear in any place in the value, potentially multiple times. - To use more complicated filter expressions, including a range of different filter operators, and the ability to compose filters with ``and`` and ``or`` operators, see the ``complex_filter`` parameter. + To use more complicated filter expressions, including a range of different filter operators, and the ability to compose filters with \ :literal:`and`\ and \ :literal:`or`\ operators, see the \ :literal:`complex\_filter`\ parameter. - For more details, see `How to build a filter expression `_. + For more details, see \ `How to build a filter expression `__\ . - For examples, see :ref:`cmci_get ` + For examples, see \ :ref:`ibm.ibm\_zos\_cics.cmci\_get `\ . - For supported attributes of different resource types, see their resource table reference, for example, `PROGDEF resource table reference `_. + For supported attributes of different resource types, see their resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -241,7 +241,7 @@ resources get_parameters - A list of one or more parameters with optional values used to identify the resources for this request. Eligible parameters for identifying the target resources can be found in the resource table reference for the target resource type, as valid parameters for the GET operation in the "Valid CPSM operations" table. For example, the valid parameters for identifying a PROGDEF resource are CICSSYS, CSDGROUP and RESGROUP, as found in the `PROGDEF resource table reference `_. + A list of one or more parameters with optional values used to identify the resources for this request. Eligible parameters for identifying the target resources can be found in the resource table reference for the target resource type, as valid parameters for the GET operation in the "Valid CPSM operations" table. For example, the valid parameters for identifying a PROGDEF resource are CICSSYS, CSDGROUP and RESGROUP, as found in the \ `PROGDEF resource table reference `__\ . @@ -284,11 +284,11 @@ scheme scope Specifies the name of a CICSplex, CICS region group, CICS region, or logical scope that is associated with the query. - *scope* is a subset of *context* and limits the request to particular CICS systems or resources. + \ :emphasis:`scope`\ is a subset of \ :emphasis:`context`\ and limits the request to particular CICS systems or resources. - *scope* is optional. If it's not specified, the request is limited by the value of *context* alone. + \ :emphasis:`scope`\ is optional. If it's not specified, the request is limited by the value of \ :emphasis:`context`\ alone. - The value of *scope* must contain no spaces. *scope* is not case-sensitive. + The value of \ :emphasis:`scope`\ must contain no spaces. \ :emphasis:`scope`\ is not case-sensitive. | **required**: false @@ -296,8 +296,18 @@ scope +timeout + HTTP request timeout in seconds + + + | **required**: False + | **type**: int + | **default**: 30 + + + type - The CMCI external resource name that maps to the target CICS or CICSPlex SM resource type. For a list of CMCI external resource names, see `CMCI resource names `_. + The CMCI external resource name that maps to the target CICS or CICSPlex SM resource type. For a list of CMCI external resource names, see \ `CMCI resource names `__\ . | **required**: True @@ -314,26 +324,26 @@ Examples - name: delete a bundle in a CICS region cmci_delete: - cmci_host: 'winmvs2c.hursley.ibm.com' + cmci_host: "winmvs2c.hursley.ibm.com" cmci_port: 10080 - context: 'iyk3z0r9' + context: "iyk3z0r9" type: CICSBundle resource: filter: - name: 'PONGALT' + name: "PONGALT" - name: delete a bundle definition in a CICS region cmci_delete: - cmci_host: 'winmvs2c.hursley.ibm.com' + cmci_host: "winmvs2c.hursley.ibm.com" cmci_port: 10080 - context: 'iyk3z0r9' + context: "iyk3z0r9" type: CICSDefinitionBundle resource: filter: - name: 'PONGALT' + name: "PONGALT" get_parameters: - - name: 'csdgroup' - value: 'JVMGRP' + - name: "csdgroup" + value: "JVMGRP" @@ -374,7 +384,7 @@ Return Values cpsm_reason - | The character value of the REASON code returned by each CICSPlex SM API command. For a list of REASON character values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2ky.html. + | The character value of the REASON code returned by each CICSPlex SM API command. For a list of REASON character values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-reason-in-alphabetical-order. | **returned**: success | **type**: str @@ -382,7 +392,7 @@ Return Values cpsm_reason_code - | The numeric value of the REASON code returned by each CICSPlex SM API command. For a list of REASON numeric values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kw.html. + | The numeric value of the REASON code returned by each CICSPlex SM API command. For a list of REASON numeric values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-reason-in-numerical-order. | **returned**: success | **type**: int @@ -390,7 +400,7 @@ Return Values cpsm_response - | The character value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE character values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kx.html. + | The character value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE character values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-response-in-alphabetical-order. | **returned**: success | **type**: str @@ -398,7 +408,7 @@ Return Values cpsm_response_code - | The numeric value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE numeric values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kv.html. + | The numeric value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE numeric values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-response-in-numerical-order. | **returned**: success | **type**: str diff --git a/_sources/ibm_zos_cics/docs/source/modules/cmci_get.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/cmci_get.rst.txt index 4fecec25..3d926506 100644 --- a/_sources/ibm_zos_cics/docs/source/modules/cmci_get.rst.txt +++ b/_sources/ibm_zos_cics/docs/source/modules/cmci_get.rst.txt @@ -1,9 +1,9 @@ .. ............................................................................... -.. © Copyright IBM Corporation 2020 . +.. © Copyright IBM Corporation 2020,2023 . .. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . .. ............................................................................... -:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/dev/plugins/modules/cmci_get.py +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/cmci_get.py .. _cmci_get_module: @@ -20,7 +20,7 @@ cmci_get -- Query CICS and CICSPlex SM resources and definitions Synopsis -------- -- Get information about installed and definitional CICS® and CICSPlex® SM resources from CICS regions, by initiating GET requests via the CMCI REST API. The CMCI REST API can be configured in CICSPlex SM or stand-alone regions (SMSS). For information about the API, see `CMCI REST API `_. For information about how to compose GET requests, see `CMCI GET requests `_. +- Get information about installed and definitional CICS® and CICSPlex® SM resources from CICS regions, by initiating GET requests via the CMCI REST API. The CMCI REST API can be configured in CICSPlex SM or stand-alone regions (SMSS). For information about the API, see \ `CMCI REST API `__\ . For information about how to compose GET requests, see \ `CMCI GET requests `__\ . @@ -34,11 +34,11 @@ Parameters cmci_cert Location of the PEM-formatted certificate chain file to be used for HTTPS client authentication. - Can also be specified using the environment variable CMCI_CERT. + Can also be specified using the environment variable CMCI\_CERT. - Required if *cmci_key* is specified. + Required if \ :emphasis:`cmci\_key`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: False @@ -58,11 +58,11 @@ cmci_host cmci_key Location of the PEM-formatted file storing your private key to be used for HTTPS client authentication. - Can also be specified using the environment variable CMCI_KEY. + Can also be specified using the environment variable CMCI\_KEY. - Required if *cmci_cert* is specified. + Required if \ :emphasis:`cmci\_cert`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: False @@ -71,13 +71,13 @@ cmci_key cmci_password - The password of *cmci_user* to pass HTTP basic authentication. + The password of \ :emphasis:`cmci\_user`\ to pass HTTP basic authentication. - Can also be specified using the environment variable CMCI_PASSWORD. + Can also be specified using the environment variable CMCI\_PASSWORD. - Required if *cmci_user* is specified. + Required if \ :emphasis:`cmci\_user`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: false @@ -97,11 +97,11 @@ cmci_port cmci_user The user ID under which the CMCI request will run. - Can also be specified using the environment variable CMCI_USER. + Can also be specified using the environment variable CMCI\_USER. - Required if *cmci_password* is specified. + Required if \ :emphasis:`cmci\_password`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: false @@ -110,11 +110,11 @@ cmci_user context - If CMCI is installed in a CICSPlex® SM environment, *context* is the name of the CICSplex or CMAS associated with the request, for example, ``PLEX1``. To determine whether a CMAS can be specified as *context*, see the **CMAS context** entry in the CICSPlex SM resource table reference of a resource. For example, according to the `PROGRAM resource table `_, CMAS context is not supported for PROGRAM. + If CMCI is installed in a CICSPlex® SM environment, \ :emphasis:`context`\ is the name of the CICSplex or CMAS associated with the request, for example, \ :literal:`PLEX1`\ . To determine whether a CMAS can be specified as \ :emphasis:`context`\ , see the \ :strong:`CMAS context`\ entry in the CICSPlex SM resource table reference of a resource. For example, according to the \ `PROGRAM resource table `__\ , CMAS context is not supported for PROGRAM. - If CMCI is installed in a single region (SMSS), *context* is the APPLID of the CICS region associate with the request. + If CMCI is installed in a single region (SMSS), \ :emphasis:`context`\ is the APPLID of the CICS region associate with the request. - The value of *context* must contain no spaces. *context* is not case-sensitive. + The value of \ :emphasis:`context`\ must contain no spaces. \ :emphasis:`context`\ is not case-sensitive. | **required**: True @@ -122,8 +122,20 @@ context +fail_on_nodata + Specifies whether the module should fail if no data is returned by the query. If set to true, the module will fail if no data is returned. + + Default behaviour is for the module to fail if no data is returned. When set to false, the module will return OK, just with no records. + + + | **required**: False + | **type**: bool + | **default**: True + + + insecure - When set to ``true``, disables SSL certificate trust chain verification when using HTTPS. + When set to \ :literal:`true`\ , disables SSL certificate trust chain verification when using HTTPS. | **required**: False @@ -134,7 +146,7 @@ insecure record_count Identifies a subset of records in the results cache, starting either from the first record in the results cache or from the record specified by the index parameter. If not specified, all the records are returned by default. - A negative number indicates a count back from the last record; for example, ``-1`` means the last record, ``-2`` the last record but one, and so on. + A negative number indicates a count back from the last record; for example, \ :literal:`-1`\ means the last record, \ :literal:`-2`\ the last record but one, and so on. The count value must be an integer; a value of zero is not permitted. @@ -154,17 +166,17 @@ resources complex_filter - A dictionary representing a complex filter expression. Complex filters are composed of filter expressions, represented as dictionaries. Each dictionary can specify either an attribute expression, a list of filter expressions to be composed with the ``and`` operator, or a list of filter expressions to be composed with the ``or`` operator. + A dictionary representing a complex filter expression. Complex filters are composed of filter expressions, represented as dictionaries. Each dictionary can specify either an attribute expression, a list of filter expressions to be composed with the \ :literal:`and`\ operator, or a list of filter expressions to be composed with the \ :literal:`or`\ operator. - The ``attribute``, ``and`` and ``or`` options are mutually exclusive with each other. + The \ :literal:`attribute`\ , \ :literal:`and`\ and \ :literal:`or`\ options are mutually exclusive with each other. - Can contain one or more filters. Multiple filters must be combined using ``and`` or ``or`` logical operators. + Can contain one or more filters. Multiple filters must be combined using \ :literal:`and`\ or \ :literal:`or`\ logical operators. Filters can be nested. - When supplying the ``attribute`` option, you must also supply a ``value`` for the filter. You can also override the default operator of ``=`` with the ``operator`` option. + When supplying the \ :literal:`attribute`\ option, you must also supply a \ :literal:`value`\ for the filter. You can also override the default operator of \ :literal:`=`\ with the \ :literal:`operator`\ option. - For examples, see "Examples" in :ref:`cmci_get `. + For examples, see "Examples" in \ :ref:`ibm.ibm\_zos\_cics.cmci\_get `\ . | **required**: False @@ -173,9 +185,9 @@ resources and - A list of filter expressions to be combined with an ``and`` operation. + A list of filter expressions to be combined with an \ :literal:`and`\ operation. - Filter expressions are nested ``complex_filter`` elements. Each nested filter expression can be either an ``attribute``, ``and`` or ``or`` complex filter expression. + Filter expressions are nested \ :literal:`complex\_filter`\ elements. Each nested filter expression can be either an \ :literal:`attribute`\ , \ :literal:`and`\ or \ :literal:`or`\ complex filter expression. | **required**: False @@ -186,7 +198,7 @@ resources attribute The name of a resource table attribute on which to filter. - For supported attributes of different resource types, see their resource table reference, for example, `PROGDEF resource table reference `_. + For supported attributes of different resource types, see their resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -195,7 +207,7 @@ resources operator - These operators are accepted: ``<`` or ``LT`` (less than), ``<=`` or ``LE`` (less than or equal to), ``=`` or ``EQ`` (equal to), ``>`` or ``GT`` (greater than), ``>=`` or ``GE`` (greater than or equal to), ``==`` or ``IS`` (is), ``¬=``, ``!=``, or ``NE`` (not equal to). If not supplied when ``attribute`` is used, ``EQ`` is assumed. + These operators are accepted: \ :literal:`\<`\ or \ :literal:`LT`\ (less than), \ :literal:`\<=`\ or \ :literal:`LE`\ (less than or equal to), \ :literal:`=`\ or \ :literal:`EQ`\ (equal to), \ :literal:`\>`\ or \ :literal:`GT`\ (greater than), \ :literal:`\>=`\ or \ :literal:`GE`\ (greater than or equal to), \ :literal:`==`\ or \ :literal:`IS`\ (is), \ :literal:`¬=`\ , \ :literal:`!=`\ , or \ :literal:`NE`\ (not equal to). If not supplied when \ :literal:`attribute`\ is used, \ :literal:`EQ`\ is assumed. @@ -206,9 +218,9 @@ resources or - A list of filter expressions to be combined with an ``or`` operation. + A list of filter expressions to be combined with an \ :literal:`or`\ operation. - Filter expressions are nested ``complex_filter`` elements. Each nested filter expression can be either an ``attribute``, ``and`` or ``or`` complex filter expression. + Filter expressions are nested \ :literal:`complex\_filter`\ elements. Each nested filter expression can be either an \ :literal:`attribute`\ , \ :literal:`and`\ or \ :literal:`or`\ complex filter expression. | **required**: False @@ -219,7 +231,7 @@ resources value The value by which you are to filter the resource attributes. - The value must be a valid one for the resource table attribute as documented in the resource table reference, for example, `PROGDEF resource table reference `_. + The value must be a valid one for the resource table attribute as documented in the resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -231,21 +243,21 @@ resources filter A dictionary with attribute names as keys, and target values, to be used as criteria to filter the set of resources returned from CICSPlex SM. - Filters implicitly use the ``=`` operator. + Filters implicitly use the \ :literal:`=`\ operator. - Filters for ``string`` type attributes can use the ``*`` and ``+`` wildcard operators. + Filters for \ :literal:`string`\ type attributes can use the \ :literal:`\*`\ and \ :literal:`+`\ wildcard operators. - ``*`` is a wildcard representing an unknown number of characters, and must appear at the end of the value. + \ :literal:`\*`\ is a wildcard representing an unknown number of characters, and must appear at the end of the value. - ``+`` is a wildcard representing a single character, and can appear in any place in the value, potentially multiple times. + \ :literal:`+`\ is a wildcard representing a single character, and can appear in any place in the value, potentially multiple times. - To use more complicated filter expressions, including a range of different filter operators, and the ability to compose filters with ``and`` and ``or`` operators, see the ``complex_filter`` parameter. + To use more complicated filter expressions, including a range of different filter operators, and the ability to compose filters with \ :literal:`and`\ and \ :literal:`or`\ operators, see the \ :literal:`complex\_filter`\ parameter. - For more details, see `How to build a filter expression `_. + For more details, see \ `How to build a filter expression `__\ . - For examples, see :ref:`cmci_get ` + For examples, see \ :ref:`ibm.ibm\_zos\_cics.cmci\_get `\ . - For supported attributes of different resource types, see their resource table reference, for example, `PROGDEF resource table reference `_. + For supported attributes of different resource types, see their resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -254,7 +266,7 @@ resources get_parameters - A list of one or more parameters with optional values used to identify the resources for this request. Eligible parameters for identifying the target resources can be found in the resource table reference for the target resource type, as valid parameters for the GET operation in the "Valid CPSM operations" table. For example, the valid parameters for identifying a PROGDEF resource are CICSSYS, CSDGROUP and RESGROUP, as found in the `PROGDEF resource table reference `_. + A list of one or more parameters with optional values used to identify the resources for this request. Eligible parameters for identifying the target resources can be found in the resource table reference for the target resource type, as valid parameters for the GET operation in the "Valid CPSM operations" table. For example, the valid parameters for identifying a PROGDEF resource are CICSSYS, CSDGROUP and RESGROUP, as found in the \ `PROGDEF resource table reference `__\ . @@ -297,11 +309,11 @@ scheme scope Specifies the name of a CICSplex, CICS region group, CICS region, or logical scope that is associated with the query. - *scope* is a subset of *context* and limits the request to particular CICS systems or resources. + \ :emphasis:`scope`\ is a subset of \ :emphasis:`context`\ and limits the request to particular CICS systems or resources. - *scope* is optional. If it's not specified, the request is limited by the value of *context* alone. + \ :emphasis:`scope`\ is optional. If it's not specified, the request is limited by the value of \ :emphasis:`context`\ alone. - The value of *scope* must contain no spaces. *scope* is not case-sensitive. + The value of \ :emphasis:`scope`\ must contain no spaces. \ :emphasis:`scope`\ is not case-sensitive. | **required**: false @@ -309,8 +321,18 @@ scope +timeout + HTTP request timeout in seconds + + + | **required**: False + | **type**: int + | **default**: 30 + + + type - The CMCI external resource name that maps to the target CICS or CICSPlex SM resource type. For a list of CMCI external resource names, see `CMCI resource names `_. + The CMCI external resource name that maps to the target CICS or CICSPlex SM resource type. For a list of CMCI external resource names, see \ `CMCI resource names `__\ . | **required**: True @@ -327,38 +349,38 @@ Examples - name: get 2 LOCFILEs from a CICSplex cmci_get: - cmci_host: 'winmvs2c.hursley.ibm.com' + cmci_host: "winmvs2c.hursley.ibm.com" cmci_port: 10080 - cmci_user: 'ibmuser' - cmci_password: '123456' - context: 'iyk3z0r9' - type: CICSLocalFile + cmci_user: "ibmuser" + cmci_password: "123456" + context: "iyk3z0r9" + type: CICSLocalFile record_count: 2 resource: filter: - dsname: 'CTS*' + dsname: "CTS*" - name: get a localfile in a CICS region cmci_get: - cmci_host: 'winmvs2c.hursley.ibm.com' + cmci_host: "winmvs2c.hursley.ibm.com" cmci_port: 10080 - cmci_cert: './sec/ansible.pem' - cmci_key: './sec/ansible.key' - context: 'iyk3z0r9' - type: 'CICSLocalFile' + cmci_cert: "./sec/ansible.pem" + cmci_key: "./sec/ansible.key" + context: "iyk3z0r9" + type: "CICSLocalFile" resources: filter: - dsname: 'XIAOPIN*' - file: 'DFH*' + dsname: "XIAOPIN*" + file: "DFH*" record_count: 1 - name: get a progdef from a CSD cmci_get: - cmci_host: 'winmvs2c.hursley.ibm.com' + cmci_host: "winmvs2c.hursley.ibm.com" cmci_port: 10080 - cmci_cert: './sec/ansible.pem' - cmci_key: './sec/ansible.key' - context: 'iyk3z0r9' + cmci_cert: "./sec/ansible.pem" + cmci_key: "./sec/ansible.key" + context: "iyk3z0r9" type: cicsdefinitionprogram resources: filter: @@ -368,25 +390,38 @@ Examples value: MYGRP record_count: 1 + - name: pass module even if bundle definition is not found + cmci_get: + cmci_host: "winmvs2c.hursley.ibm.com" + cmci_port: 10080 + cmci_cert: "./sec/ansible.pem" + cmci_key: "./sec/ansible.key" + context: "iyk3z0r9" + type: cicsdefinitionbundle + resources: + filter: + name: MYBUNDLE + get_parameters: + - name: csdgroup + value: MYGRP + record_count: 1 + fail_on_nodata: "false" + - name: Using complex_filter to combine filter expressions and change operators cmci_get: - cmci_host: 'winmvs2c.hursley.ibm.com' + cmci_host: "winmvs2c.hursley.ibm.com" cmci_port: 10080 - cmci_cert: './sec/ansible.pem' - cmci_key: './sec/ansible.key' - context: 'iyk3z0r9' - type: 'CICSRegion' + cmci_cert: "./sec/ansible.pem" + cmci_key: "./sec/ansible.key" + context: "iyk3z0r9" + type: "CICSRegion" resources: complex_filter: - or: [{ - attribute: 'currtasks', - value: '10', - operator: '<' - }, { - attribute: 'currtasks', - value: '100', - operator: '>' - }] + or: + [ + { attribute: "currtasks", value: "10", operator: "<" }, + { attribute: "currtasks", value: "100", operator: ">" }, + ] record_count: 1 @@ -428,7 +463,7 @@ Return Values cpsm_reason - | The character value of the REASON code returned by each CICSPlex SM API command. For a list of REASON character values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2ky.html. + | The character value of the REASON code returned by each CICSPlex SM API command. For a list of REASON character values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-reason-in-alphabetical-order. | **returned**: success | **type**: str @@ -436,7 +471,7 @@ Return Values cpsm_reason_code - | The numeric value of the REASON code returned by each CICSPlex SM API command. For a list of REASON numeric values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kw.html. + | The numeric value of the REASON code returned by each CICSPlex SM API command. For a list of REASON numeric values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-reason-in-numerical-order. | **returned**: success | **type**: int @@ -444,7 +479,7 @@ Return Values cpsm_response - | The character value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE character values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kx.html. + | The character value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE character values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-response-in-alphabetical-order. | **returned**: success | **type**: str @@ -452,7 +487,7 @@ Return Values cpsm_response_code - | The numeric value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE numeric values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kv.html. + | The numeric value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE numeric values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-response-in-numerical-order. | **returned**: success | **type**: str diff --git a/_sources/ibm_zos_cics/docs/source/modules/cmci_update.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/cmci_update.rst.txt index 2d577e41..2aaf20d0 100644 --- a/_sources/ibm_zos_cics/docs/source/modules/cmci_update.rst.txt +++ b/_sources/ibm_zos_cics/docs/source/modules/cmci_update.rst.txt @@ -1,9 +1,9 @@ .. ............................................................................... -.. © Copyright IBM Corporation 2020 . +.. © Copyright IBM Corporation 2020,2023 . .. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . .. ............................................................................... -:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/dev/plugins/modules/cmci_update.py +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/cmci_update.py .. _cmci_update_module: @@ -20,7 +20,7 @@ cmci_update -- Update CICS and CICSPlex resources and definitions Synopsis -------- -- Make changes to CICS® and CICSPlex® SM resources in CICS regions, by initiating PUT requests via the CMCI REST API. The CMCI REST API can be configured in CICSPlex SM or stand-alone regions (SMSS). For information about the API, see `CMCI REST API `_. For information about how to compose PUT requests, see `CMCI PUT requests `_. +- Make changes to CICS® and CICSPlex® SM resources in CICS regions, by initiating PUT requests via the CMCI REST API. The CMCI REST API can be configured in CICSPlex SM or stand-alone regions (SMSS). For information about the API, see \ `CMCI REST API `__\ . For information about how to compose PUT requests, see \ `CMCI PUT requests `__\ . @@ -32,7 +32,7 @@ Parameters attributes - The resource attributes to be created or updated. Available attributes can be found in the CICSPlex® SM resource table reference for the target resource type, for example, `PROGDEF resource table reference `_. + The resource attributes to be created or updated. Available attributes can be found in the CICSPlex® SM resource table reference for the target resource type, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -43,11 +43,11 @@ attributes cmci_cert Location of the PEM-formatted certificate chain file to be used for HTTPS client authentication. - Can also be specified using the environment variable CMCI_CERT. + Can also be specified using the environment variable CMCI\_CERT. - Required if *cmci_key* is specified. + Required if \ :emphasis:`cmci\_key`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: False @@ -67,11 +67,11 @@ cmci_host cmci_key Location of the PEM-formatted file storing your private key to be used for HTTPS client authentication. - Can also be specified using the environment variable CMCI_KEY. + Can also be specified using the environment variable CMCI\_KEY. - Required if *cmci_cert* is specified. + Required if \ :emphasis:`cmci\_cert`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: False @@ -80,13 +80,13 @@ cmci_key cmci_password - The password of *cmci_user* to pass HTTP basic authentication. + The password of \ :emphasis:`cmci\_user`\ to pass HTTP basic authentication. - Can also be specified using the environment variable CMCI_PASSWORD. + Can also be specified using the environment variable CMCI\_PASSWORD. - Required if *cmci_user* is specified. + Required if \ :emphasis:`cmci\_user`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: false @@ -106,11 +106,11 @@ cmci_port cmci_user The user ID under which the CMCI request will run. - Can also be specified using the environment variable CMCI_USER. + Can also be specified using the environment variable CMCI\_USER. - Required if *cmci_password* is specified. + Required if \ :emphasis:`cmci\_password`\ is specified. - Authentication prioritises certificate authentication if *cmci_cert* and *cmci_key* are provided, then basic authentication if *cmci_user* and (cmci_password) are provided, and then unauthenticated if none is provided. + Authentication prioritises certificate authentication if \ :emphasis:`cmci\_cert`\ and \ :emphasis:`cmci\_key`\ are provided, then basic authentication if \ :emphasis:`cmci\_user`\ and \ :emphasis:`cmci\_password`\ are provided, and then unauthenticated if none is provided. | **required**: false @@ -119,11 +119,11 @@ cmci_user context - If CMCI is installed in a CICSPlex® SM environment, *context* is the name of the CICSplex or CMAS associated with the request, for example, ``PLEX1``. To determine whether a CMAS can be specified as *context*, see the **CMAS context** entry in the CICSPlex SM resource table reference of a resource. For example, according to the `PROGRAM resource table `_, CMAS context is not supported for PROGRAM. + If CMCI is installed in a CICSPlex® SM environment, \ :emphasis:`context`\ is the name of the CICSplex or CMAS associated with the request, for example, \ :literal:`PLEX1`\ . To determine whether a CMAS can be specified as \ :emphasis:`context`\ , see the \ :strong:`CMAS context`\ entry in the CICSPlex SM resource table reference of a resource. For example, according to the \ `PROGRAM resource table `__\ , CMAS context is not supported for PROGRAM. - If CMCI is installed in a single region (SMSS), *context* is the APPLID of the CICS region associate with the request. + If CMCI is installed in a single region (SMSS), \ :emphasis:`context`\ is the APPLID of the CICS region associate with the request. - The value of *context* must contain no spaces. *context* is not case-sensitive. + The value of \ :emphasis:`context`\ must contain no spaces. \ :emphasis:`context`\ is not case-sensitive. | **required**: True @@ -132,7 +132,7 @@ context insecure - When set to ``true``, disables SSL certificate trust chain verification when using HTTPS. + When set to \ :literal:`true`\ , disables SSL certificate trust chain verification when using HTTPS. | **required**: False @@ -150,17 +150,17 @@ resources complex_filter - A dictionary representing a complex filter expression. Complex filters are composed of filter expressions, represented as dictionaries. Each dictionary can specify either an attribute expression, a list of filter expressions to be composed with the ``and`` operator, or a list of filter expressions to be composed with the ``or`` operator. + A dictionary representing a complex filter expression. Complex filters are composed of filter expressions, represented as dictionaries. Each dictionary can specify either an attribute expression, a list of filter expressions to be composed with the \ :literal:`and`\ operator, or a list of filter expressions to be composed with the \ :literal:`or`\ operator. - The ``attribute``, ``and`` and ``or`` options are mutually exclusive with each other. + The \ :literal:`attribute`\ , \ :literal:`and`\ and \ :literal:`or`\ options are mutually exclusive with each other. - Can contain one or more filters. Multiple filters must be combined using ``and`` or ``or`` logical operators. + Can contain one or more filters. Multiple filters must be combined using \ :literal:`and`\ or \ :literal:`or`\ logical operators. Filters can be nested. - When supplying the ``attribute`` option, you must also supply a ``value`` for the filter. You can also override the default operator of ``=`` with the ``operator`` option. + When supplying the \ :literal:`attribute`\ option, you must also supply a \ :literal:`value`\ for the filter. You can also override the default operator of \ :literal:`=`\ with the \ :literal:`operator`\ option. - For examples, see "Examples" in :ref:`cmci_get `. + For examples, see "Examples" in \ :ref:`ibm.ibm\_zos\_cics.cmci\_get `\ . | **required**: False @@ -169,9 +169,9 @@ resources and - A list of filter expressions to be combined with an ``and`` operation. + A list of filter expressions to be combined with an \ :literal:`and`\ operation. - Filter expressions are nested ``complex_filter`` elements. Each nested filter expression can be either an ``attribute``, ``and`` or ``or`` complex filter expression. + Filter expressions are nested \ :literal:`complex\_filter`\ elements. Each nested filter expression can be either an \ :literal:`attribute`\ , \ :literal:`and`\ or \ :literal:`or`\ complex filter expression. | **required**: False @@ -182,7 +182,7 @@ resources attribute The name of a resource table attribute on which to filter. - For supported attributes of different resource types, see their resource table reference, for example, `PROGDEF resource table reference `_. + For supported attributes of different resource types, see their resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -191,7 +191,7 @@ resources operator - These operators are accepted: ``<`` or ``LT`` (less than), ``<=`` or ``LE`` (less than or equal to), ``=`` or ``EQ`` (equal to), ``>`` or ``GT`` (greater than), ``>=`` or ``GE`` (greater than or equal to), ``==`` or ``IS`` (is), ``¬=``, ``!=``, or ``NE`` (not equal to). If not supplied when ``attribute`` is used, ``EQ`` is assumed. + These operators are accepted: \ :literal:`\<`\ or \ :literal:`LT`\ (less than), \ :literal:`\<=`\ or \ :literal:`LE`\ (less than or equal to), \ :literal:`=`\ or \ :literal:`EQ`\ (equal to), \ :literal:`\>`\ or \ :literal:`GT`\ (greater than), \ :literal:`\>=`\ or \ :literal:`GE`\ (greater than or equal to), \ :literal:`==`\ or \ :literal:`IS`\ (is), \ :literal:`¬=`\ , \ :literal:`!=`\ , or \ :literal:`NE`\ (not equal to). If not supplied when \ :literal:`attribute`\ is used, \ :literal:`EQ`\ is assumed. @@ -202,9 +202,9 @@ resources or - A list of filter expressions to be combined with an ``or`` operation. + A list of filter expressions to be combined with an \ :literal:`or`\ operation. - Filter expressions are nested ``complex_filter`` elements. Each nested filter expression can be either an ``attribute``, ``and`` or ``or`` complex filter expression. + Filter expressions are nested \ :literal:`complex\_filter`\ elements. Each nested filter expression can be either an \ :literal:`attribute`\ , \ :literal:`and`\ or \ :literal:`or`\ complex filter expression. | **required**: False @@ -215,7 +215,7 @@ resources value The value by which you are to filter the resource attributes. - The value must be a valid one for the resource table attribute as documented in the resource table reference, for example, `PROGDEF resource table reference `_. + The value must be a valid one for the resource table attribute as documented in the resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -227,21 +227,21 @@ resources filter A dictionary with attribute names as keys, and target values, to be used as criteria to filter the set of resources returned from CICSPlex SM. - Filters implicitly use the ``=`` operator. + Filters implicitly use the \ :literal:`=`\ operator. - Filters for ``string`` type attributes can use the ``*`` and ``+`` wildcard operators. + Filters for \ :literal:`string`\ type attributes can use the \ :literal:`\*`\ and \ :literal:`+`\ wildcard operators. - ``*`` is a wildcard representing an unknown number of characters, and must appear at the end of the value. + \ :literal:`\*`\ is a wildcard representing an unknown number of characters, and must appear at the end of the value. - ``+`` is a wildcard representing a single character, and can appear in any place in the value, potentially multiple times. + \ :literal:`+`\ is a wildcard representing a single character, and can appear in any place in the value, potentially multiple times. - To use more complicated filter expressions, including a range of different filter operators, and the ability to compose filters with ``and`` and ``or`` operators, see the ``complex_filter`` parameter. + To use more complicated filter expressions, including a range of different filter operators, and the ability to compose filters with \ :literal:`and`\ and \ :literal:`or`\ operators, see the \ :literal:`complex\_filter`\ parameter. - For more details, see `How to build a filter expression `_. + For more details, see \ `How to build a filter expression `__\ . - For examples, see :ref:`cmci_get ` + For examples, see \ :ref:`ibm.ibm\_zos\_cics.cmci\_get `\ . - For supported attributes of different resource types, see their resource table reference, for example, `PROGDEF resource table reference `_. + For supported attributes of different resource types, see their resource table reference, for example, \ `PROGDEF resource table reference `__\ . | **required**: False @@ -250,7 +250,7 @@ resources get_parameters - A list of one or more parameters with optional values used to identify the resources for this request. Eligible parameters for identifying the target resources can be found in the resource table reference for the target resource type, as valid parameters for the GET operation in the "Valid CPSM operations" table. For example, the valid parameters for identifying a PROGDEF resource are CICSSYS, CSDGROUP and RESGROUP, as found in the `PROGDEF resource table reference `_. + A list of one or more parameters with optional values used to identify the resources for this request. Eligible parameters for identifying the target resources can be found in the resource table reference for the target resource type, as valid parameters for the GET operation in the "Valid CPSM operations" table. For example, the valid parameters for identifying a PROGDEF resource are CICSSYS, CSDGROUP and RESGROUP, as found in the \ `PROGDEF resource table reference `__\ . @@ -293,11 +293,11 @@ scheme scope Specifies the name of a CICSplex, CICS region group, CICS region, or logical scope that is associated with the query. - *scope* is a subset of *context* and limits the request to particular CICS systems or resources. + \ :emphasis:`scope`\ is a subset of \ :emphasis:`context`\ and limits the request to particular CICS systems or resources. - *scope* is optional. If it's not specified, the request is limited by the value of *context* alone. + \ :emphasis:`scope`\ is optional. If it's not specified, the request is limited by the value of \ :emphasis:`context`\ alone. - The value of *scope* must contain no spaces. *scope* is not case-sensitive. + The value of \ :emphasis:`scope`\ must contain no spaces. \ :emphasis:`scope`\ is not case-sensitive. | **required**: false @@ -305,8 +305,18 @@ scope +timeout + HTTP request timeout in seconds + + + | **required**: False + | **type**: int + | **default**: 30 + + + type - The CMCI external resource name that maps to the target CICS or CICSPlex SM resource type. For a list of CMCI external resource names, see `CMCI resource names `_. + The CMCI external resource name that maps to the target CICS or CICSPlex SM resource type. For a list of CMCI external resource names, see \ `CMCI resource names `__\ . | **required**: True @@ -315,7 +325,7 @@ type update_parameters - A list of one or more parameters that control the *update* operation. Eligible parameters for the UPDATE operation can be found in the resource table reference for the target resource type, as listed in the UPDATE operation section of the "Valid CPSM operations" table. For example, the only valid parameter for a PROGDEF UPDATE operation is CSD, as found in the `PROGDEF resource table reference `_. + A list of one or more parameters that control the \ :emphasis:`update`\ operation. Eligible parameters for the UPDATE operation can be found in the resource table reference for the target resource type, as listed in the UPDATE operation section of the "Valid CPSM operations" table. For example, the only valid parameter for a PROGDEF UPDATE operation is CSD, as found in the \ `PROGDEF resource table reference `__\ . @@ -352,17 +362,17 @@ Examples - name: update a bundle definition in a CICS region cmci_update: - cmci_host: 'winmvs2c.hursley.ibm.com' - cmci_port: '10080' - context: 'iyk3z0r9' - type: 'CICSDefinitionBundle' + cmci_host: "winmvs2c.hursley.ibm.com" + cmci_port: "10080" + context: "iyk3z0r9" + type: "CICSDefinitionBundle" attributes: - description: 'New description' + description: "New description" update_parameters: - name: csd resource: filter: - name: 'PONGALT' + name: "PONGALT" get_parameters: - name: csdgroup value: JVMGRP @@ -406,7 +416,7 @@ Return Values cpsm_reason - | The character value of the REASON code returned by each CICSPlex SM API command. For a list of REASON character values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2ky.html. + | The character value of the REASON code returned by each CICSPlex SM API command. For a list of REASON character values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-reason-in-alphabetical-order. | **returned**: success | **type**: str @@ -414,7 +424,7 @@ Return Values cpsm_reason_code - | The numeric value of the REASON code returned by each CICSPlex SM API command. For a list of REASON numeric values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kw.html. + | The numeric value of the REASON code returned by each CICSPlex SM API command. For a list of REASON numeric values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-reason-in-numerical-order. | **returned**: success | **type**: int @@ -422,7 +432,7 @@ Return Values cpsm_response - | The character value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE character values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kx.html. + | The character value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE character values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-response-in-alphabetical-order. | **returned**: success | **type**: str @@ -430,7 +440,7 @@ Return Values cpsm_response_code - | The numeric value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE numeric values, see https://www.ibm.com/support/knowledgecenter/SSGMCP_5.6.0/reference-system-programming/commands-cpsm/eyup2kv.html. + | The numeric value of the RESPONSE code returned by each CICSPlex SM API command. For a list of RESPONSE numeric values, see https://www.ibm.com/docs/en/cics-ts/latest?topic=values-eyuda-response-in-numerical-order. | **returned**: success | **type**: str diff --git a/_sources/ibm_zos_cics/docs/source/modules/csd.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/csd.rst.txt new file mode 100644 index 00000000..20e624aa --- /dev/null +++ b/_sources/ibm_zos_cics/docs/source/modules/csd.rst.txt @@ -0,0 +1,481 @@ +.. ............................................................................... +.. © Copyright IBM Corporation 2020,2023 . +.. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . +.. ............................................................................... + +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/csd.py + +.. _csd_module: + + +csd -- Create, remove, and manage the CICS CSD +============================================== + + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- Create, remove, and manage the \ `CICS system definition data set `__\ (CSD) used by a CICS® region. +- You can use this module when provisioning or de-provisioning a CICS region, or when managing the state of the CSD during upgrades or restarts. +- Use the \ :literal:`state`\ option to specify the intended state for the CSD. For example, use \ :literal:`state=initial`\ to create and initialize a CSD if it doesn't exist, or empty an existing CSD of all records. + + + + + +Parameters +---------- + + + +cics_data_sets + The name of the \ :literal:`SDFHLOAD`\ library of the CICS installation, for example, \ :literal:`CICSTS61.CICS.SDFHLOAD`\ . + + + | **required**: True + | **type**: dict + + + + sdfhload + The location of the \ :literal:`SDFHLOAD`\ library. If \ :literal:`cics\_data\_sets.template`\ is provided, this value overrides the template. + + + | **required**: False + | **type**: str + + + + template + The templated location of the \ :literal:`SDFHLOAD`\ library. + + + | **required**: False + | **type**: str + + + + +input_content + The content of the DFHCSDUP script to submit, if you are using the \ :literal:`input\_location=INLINE`\ option. + + + | **required**: False + | **type**: str + + + +input_location + The type of location from which to load the DFHCSDUP script. + + Specify \ :literal:`DATA\_SET`\ to load from a PDS, PDSE, or sequential data set. + + Specify \ :literal:`USS`\ to load from a file on UNIX System Services (USS). + + Specify \ :literal:`LOCAL`\ to load from a file local to the Ansible control node. + + Specify \ :literal:`INLINE`\ to allow a script to be passed directly through the \ :literal:`input\_content`\ parameter. + + + | **required**: False + | **type**: str + | **default**: DATA_SET + | **choices**: DATA_SET, USS, LOCAL, INLINE + + + +input_src + The path to the source file that contains the DFHCSDUP script to submit. + + It can be a data set. For example: "TESTER.DEFS.SCRIPT" or "TESTER.DEFS(SCRIPT)" + + It can be a USS file. For example: "/u/tester/defs/script.csdup" + + It can be a local file. For example: "/User/tester/defs/script.csdup" + + + | **required**: False + | **type**: str + + + +log + Specify the recovery attribute for the CSD, overriding the CSD system initialization parameters. + + Specify NONE for a nonrecoverable CSD. + + Specify UNDO for a CSD that is limited to file backout only. + + Specify ALL for a CSD for which you want both forward recovery and file backout. If you specify \ :literal:`log=ALL`\ , you must also specify LOGSTREAMID to identify the 26-character name of the z/OS™ log stream to be used as the forward recovery log. The CICS collection does not support defining forward recovery log streams; you must follow the instructions in \ `Defining forward recovery log streams `__\ . + + + | **required**: False + | **type**: str + | **choices**: NONE, UNDO, ALL + + + +logstream_id + The 26-character name of the z/OS™ log stream to be used as the forward recovery log. + + This is required when you use \ :literal:`log=ALL`\ . + + + | **required**: False + | **type**: str + + + +region_data_sets + The location of the region data sets to be created by using a template, for example, \ :literal:`REGIONS.ABCD0001.\<\< data\_set\_name \>\>`\ . + + + | **required**: True + | **type**: dict + + + + dfhcsd + Overrides the templated location for the CSD. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of the CSD to override the template. + + + | **required**: False + | **type**: str + + + + + template + The base location of the region data sets with a template. + + + | **required**: False + | **type**: str + + + + +space_primary + The size of the primary space allocated to the CSD. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the CSD is being created. If the CSD already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 4 + + + +space_secondary + The size of the secondary space allocated to the CSD. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the CSD is being created. If the CSD already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 1 + + + +space_type + The unit portion of the CSD size. Note that this is just the unit; the value for the primary space is specified with \ :literal:`space\_primary`\ and the value for the secondary space is specified with \ :literal:`space\_secondary`\ . + + This option takes effect only when the CSD is being created. If the CSD already exists, the option has no effect. + + The size can be specified in megabytes (\ :literal:`M`\ ), kilobytes (\ :literal:`K`\ ), records (\ :literal:`REC`\ ), cylinders (\ :literal:`CYL`\ ), or tracks (\ :literal:`TRK`\ ). + + + | **required**: False + | **type**: str + | **default**: M + | **choices**: M, K, REC, CYL, TRK + + + +state + The intended state for the CSD, which the module aims to achieve. + + Specify \ :literal:`absent`\ to remove the CSD entirely, if it already exists. + + Specify \ :literal:`initial`\ to create the CSD if it does not already exist, and initialize it by using DFHCSDUP. + + Specify \ :literal:`warm`\ to retain an existing CSD in its current state. The module verifies whether the specified data set exists and whether it contains any records. If both conditions are met, the module leaves the data set as is. If the data set does not exist or if it is empty, the operation fails. + + Specify \ :literal:`changed`\ to run a DFHCSDUP script to update an existing CSD. + + + | **required**: True + | **type**: str + | **choices**: initial, absent, warm, changed + + + +volumes + The volume(s) where the data set is created. Use a string to define a singular volume or a list of strings for multiple volumes. + + + | **required**: False + | **type**: raw + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Initialize a CSD by using the templated location + ibm.ibm_zos_cics.csd: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "initial" + + - name: Initialize a user specified CSD + ibm.ibm_zos_cics.csd: + region_data_sets: + dfhcsd: + dsn: "REGIONS.ABCD0001.DFHCSD" + cics_data_sets: + sdfhload: "CICSTS61.CICS.SDFHLOAD" + state: "initial" + + - name: Initialize a large CSD by using the templated location + ibm.ibm_zos_cics.csd: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + space_primary: 10 + space_type: "M" + state: "initial" + + - name: Delete a CSD defined by the template + ibm.ibm_zos_cics.csd: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "absent" + + - name: Delete a user specified CSD + ibm.ibm_zos_cics.csd: + region_data_sets: + dfhcsd: + dsn: "REGIONS.ABCD0001.DFHCSD" + cics_data_sets: + sdfhload: "CICSTS61.CICS.SDFHLOAD" + state: "absent" + + - name: Retain the existing state of a CSD defined by the template + ibm.ibm_zos_cics.csd: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "warm" + + - name: Retain the existing state of a user specified CSD + ibm.ibm_zos_cics.csd: + region_data_sets: + dfhcsd: + dsn: "REGIONS.ABCD0001.DFHCSD" + cics_data_sets: + sdfhload: "CICSTS61.CICS.SDFHLOAD" + state: "warm" + + - name: Run a DFHCSDUP script from a data set + ibm.ibm_zos_cics.csd: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "changed" + input_location: "DATA_SET" + input_src: "TESTER.DEFS.SCRIPT" + + - name: Run a DFHCSDUP script from a USS file + ibm.ibm_zos_cics.csd: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + input_location: "USS" + input_src: "/u/tester/defs/script.csdup" + + - name: Run a DFHCSDUP script from a local file + ibm.ibm_zos_cics.csd: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + input_location: "LOCAL" + input_src: "/User/tester/defs/script.csdup" + + - name: Run a DFHCSDUP script inline + ibm.ibm_zos_cics.csd: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + input_location: "INLINE" + input_content: | + DEFINE PROGRAM(TESTPRG1) GROUP(TESTGRP1) + DEFINE PROGRAM(TESTPRG2) GROUP(TESTGRP2) + + + + + + + + + +Return Values +------------- + + + + + changed + | True if the state was changed, otherwise False. + + | **returned**: always + | **type**: bool + + + + failed + | True if the Ansible task failed, otherwise False. + + | **returned**: always + | **type**: bool + + + + start_state + | The state of the CSD before the Ansible task runs. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the start of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + exists + | True if the CSD exists. + + | **returned**: always + | **type**: bool + + + + + + end_state + | The state of the CSD at the end of the Ansible task. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the end of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + exists + | True if the CSD exists. + + | **returned**: always + | **type**: bool + + + + + + executions + | A list of program executions performed during the Ansible task. + + | **returned**: always + | **type**: list + + + + name + | A human-readable name for the program execution. + + | **returned**: always + | **type**: str + + + + rc + | The return code for the program execution. + + | **returned**: always + | **type**: int + + + + stdout + | The standard output stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + stderr + | The standard error stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + + + msg + | A string containing an error message if applicable + + | **returned**: always + | **type**: str + + diff --git a/_sources/ibm_zos_cics/docs/source/modules/global_catalog.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/global_catalog.rst.txt new file mode 100644 index 00000000..0c605a17 --- /dev/null +++ b/_sources/ibm_zos_cics/docs/source/modules/global_catalog.rst.txt @@ -0,0 +1,433 @@ +.. ............................................................................... +.. © Copyright IBM Corporation 2020,2023 . +.. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . +.. ............................................................................... + +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/global_catalog.py + +.. _global_catalog_module: + + +global_catalog -- Create, remove, and manage the CICS global catalog +==================================================================== + + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- Create, remove, and manage the \ `global catalog `__\ data set used by a CICS® region. The global catalog is used to store start type information, location of the CICS system log, installed resource definitions, terminal control information and profiles. It contains information that CICS requires on a restart. +- You can use this module when provisioning or de-provisioning a CICS region, or when managing the state of the global catalog during upgrades or restarts. +- Use the \ :literal:`state`\ option to specify the intended state for the global catalog. For example, use \ :literal:`state=initial`\ to create and initialize a global catalog data set if it doesn't exist, or set the autostart override record of an existing global catalog to \ :literal:`AUTOINIT`\ . In either case, a CICS region that is using this global catalog and set with the \ :literal:`START=AUTO`\ system initialization parameter performs an initial start. + + + + + +Parameters +---------- + + + +cics_data_sets + The name of the \ :literal:`SDFHLOAD`\ library of the CICS installation, for example, \ :literal:`CICSTS61.CICS.SDFHLOAD`\ . + + This module uses the \ :literal:`DFHRMUTL`\ utility internally, which is found in the \ :literal:`SDFHLOAD`\ library. + + + | **required**: True + | **type**: dict + + + + sdfhload + The location of the \ :literal:`SDFHLOAD`\ library. If \ :literal:`cics\_data\_sets.template`\ is provided, this value overrides the template. + + + | **required**: False + | **type**: str + + + + template + The templated location of the \ :literal:`SDFHLOAD`\ library. + + + | **required**: False + | **type**: str + + + + +region_data_sets + The location of the region data sets to be created by using a template, for example, \ :literal:`REGIONS.ABCD0001.\<\< data\_set\_name \>\>`\ . + + If you want to use a data set that already exists, ensure that the data set is a global catalog data set. + + + | **required**: True + | **type**: dict + + + + dfhgcd + Overrides the templated location for the global catalog data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of the global catalog to override the template. + + + | **required**: False + | **type**: str + + + + + template + The base location of the region data sets with a template. + + + | **required**: False + | **type**: str + + + + +space_primary + The size of the primary space allocated to the global catalog data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the global catalog data set is being created. If the global catalog data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 5 + + + +space_secondary + The size of the secondary space allocated to the global catalog data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the global catalog data set is being created. If the global catalog data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 1 + + + +space_type + The unit portion of the global catalog data set size. Note that this is just the unit; the value for the primary space is specified with \ :literal:`space\_primary`\ and the value for the secondary space is specified with \ :literal:`space\_secondary`\ . + + This option takes effect only when the global catalog data set is being created. If the global catalog data set already exists, the option has no effect. + + The size can be specified in megabytes (\ :literal:`M`\ ), kilobytes (\ :literal:`K`\ ), records (\ :literal:`REC`\ ), cylinders (\ :literal:`CYL`\ ), or tracks (\ :literal:`TRK`\ ). + + + | **required**: False + | **type**: str + | **default**: M + | **choices**: M, K, REC, CYL, TRK + + + +state + The intended state for the global catalog data set, which the module aims to achieve. + + Specify \ :literal:`absent`\ to remove the global catalog data set entirely, if it exists. + + Specify \ :literal:`initial`\ to set the autostart override record to \ :literal:`AUTOINIT`\ . If the specified global catalog data set does not already exist, the module creates the data set. + + Specify \ :literal:`cold`\ to set the autostart override record of an existing global catalog to \ :literal:`AUTOCOLD`\ . If the specified global catalog data set does not already exist, the operation fails. + + Specify \ :literal:`warm`\ to set the autostart override record of an existing global catalog to \ :literal:`AUTOASIS`\ , undoing any previous setting of \ :literal:`AUTOINIT`\ or \ :literal:`AUTOCOLD`\ . The module verifies whether the specified data set exists and whether it contains any records. If either condition is not met, the operation fails. + + + | **required**: True + | **type**: str + | **choices**: absent, initial, cold, warm + + + +volumes + The volume(s) where the data set is created. Use a string to define a singular volume or a list of strings for multiple volumes. + + + | **required**: False + | **type**: raw + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Initialize a global catalog by using the templated location + ibm.ibm_zos_cics.global_catalog: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "initial" + + - name: Initialize a large global catalog by using the templated location + ibm.ibm_zos_cics.global_catalog: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + space_primary: 100 + space_type: "M" + state: "initial" + + - name: Initialize a large user specified global catalog + ibm.ibm_zos_cics.global_catalog: + region_data_sets: + dfhgcd: + dsn: "REGIONS.ABCD0001.DFHGCD" + cics_data_sets: + sdfhload: "CICSTS61.CICS.SDFHLOAD" + space_primary: 100 + space_type: "M" + state: "initial" + + - name: Set the autostart override record to AUTOASIS for a global catalog defined by the template + ibm.ibm_zos_cics.global_catalog: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "warm" + + - name: Set the autostart override record to AUTOASIS for a user specified global catalog + ibm.ibm_zos_cics.global_catalog: + region_data_sets: + dfhgcd: + dsn: "REGIONS.ABCD0001.DFHGCD" + cics_data_sets: + sdfhload: "CICSTS61.CICS.SDFHLOAD" + state: "warm" + + - name: Set the autostart override record to AUTOCOLD for a global catalog defined by the template + ibm.ibm_zos_cics.global_catalog: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "cold" + + - name: Set the autostart override record to AUTOCOLD for a user specified global catalog + ibm.ibm_zos_cics.global_catalog: + region_data_sets: + dfhgcd: + dsn: "REGIONS.ABCD0001.DFHGCD" + cics_data_sets: + sdfhload: "CICSTS61.CICS.SDFHLOAD" + state: "cold" + + - name: Delete a global catalog defined by the template + ibm.ibm_zos_cics.global_catalog: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "absent" + + - name: Delete a user specified global catalog + ibm.ibm_zos_cics.global_catalog: + region_data_sets: + dfhgcd: + dsn: "REGIONS.ABCD0001.DFHGCD" + cics_data_sets: + sdfhload: "CICSTS61.CICS.SDFHLOAD" + state: "absent" + + + + + + +See Also +-------- + +.. seealso:: + + - :ref:`local_catalog_module` + + + +Return Values +------------- + + + + + changed + | True if the state was changed, otherwise False. + + | **returned**: always + | **type**: bool + + + + failed + | True if the Ansible task failed, otherwise False. + + | **returned**: always + | **type**: bool + + + + start_state + | The state of the global catalog before the Ansible task runs. + + | **returned**: always + | **type**: dict + + + + autostart_override + | The current autostart override record. + + | **returned**: always + | **type**: str + + + + next_start + | The next start type listed in the global catalog. + + | **returned**: always + | **type**: str + + + + exists + | True if the specified global catalog data set exists. + + | **returned**: always + | **type**: bool + + + + data_set_organization + | The organization of the data set at the start of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + + + end_state + | The state of the global catalog at the end of the Ansible task. + + | **returned**: always + | **type**: dict + + + + autostart_override + | The current autostart override record. + + | **returned**: always + | **type**: str + + + + next_start + | The next start type listed in the global catalog + + | **returned**: always + | **type**: str + + + + exists + | True if the specified global catalog data set exists. + + | **returned**: always + | **type**: bool + + + + data_set_organization + | The organization of the data set at the end of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + + + executions + | A list of program executions performed during the Ansible task. + + | **returned**: always + | **type**: list + + + + name + | A human-readable name for the program execution. + + | **returned**: always + | **type**: str + + + + rc + | The return code for the program execution. + + | **returned**: always + | **type**: int + + + + stdout + | The standard output stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + stderr + | The standard error stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + + + msg + | A string containing an error message if applicable + + | **returned**: always + | **type**: str + + diff --git a/_sources/ibm_zos_cics/docs/source/modules/local_catalog.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/local_catalog.rst.txt new file mode 100644 index 00000000..73ae81e4 --- /dev/null +++ b/_sources/ibm_zos_cics/docs/source/modules/local_catalog.rst.txt @@ -0,0 +1,380 @@ +.. ............................................................................... +.. © Copyright IBM Corporation 2020,2023 . +.. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . +.. ............................................................................... + +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/local_catalog.py + +.. _local_catalog_module: + + +local_catalog -- Create, remove, and manage the CICS local catalog +================================================================== + + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- Create, remove, and manage the \ `local catalog `__\ data set used by a CICS® region. CICS domains use the local catalog to save some of their information between CICS runs and to preserve this information across a cold start. +- You can use this module when provisioning or de-provisioning a CICS region, or when managing the state of the local catalog during upgrades or restarts. +- Use the \ :literal:`state`\ option to specify the intended state for the local catalog. For example, use \ :literal:`state=initial`\ to create and initialize a local catalog data set if it doesn't exist, or empty an existing local catalog of all records. + + + + + +Parameters +---------- + + + +cics_data_sets + The name of the \ :literal:`SDFHLOAD`\ library of the CICS installation, for example, \ :literal:`CICSTS61.CICS.SDFHLOAD`\ . + + This module uses the \ :literal:`DFHCCUTL`\ utility internally, which is found in the \ :literal:`SDFHLOAD`\ library. + + + | **required**: True + | **type**: dict + + + + sdfhload + The location of the \ :literal:`SDFHLOAD`\ library. If \ :literal:`cics\_data\_sets.template`\ is provided, this value overrides the template. + + + | **required**: False + | **type**: str + + + + template + The templated location of the \ :literal:`SDFHLOAD`\ library. + + + | **required**: False + | **type**: str + + + + +region_data_sets + The location of the region data sets to be created by using a template, for example, \ :literal:`REGIONS.ABCD0001.\<\< data\_set\_name \>\>`\ . + + If you want to use a data set that already exists, ensure that the data set is a local catalog data set. + + + | **required**: True + | **type**: dict + + + + dfhlcd + Overrides the templated location for the local catalog data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of the local catalog to override the template. + + + | **required**: False + | **type**: str + + + + + template + The base location of the region data sets with a template. + + + | **required**: False + | **type**: str + + + + +space_primary + The size of the primary space allocated to the local catalog data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the local catalog data set is being created. If the local catalog data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 200 + + + +space_secondary + The size of the secondary space allocated to the local catalog data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the local catalog data set is being created. If the local catalog data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 5 + + + +space_type + The unit portion of the local catalog data set size. Note that this is just the unit; the value for the primary space is specified with \ :literal:`space\_primary`\ and the value for the secondary space is specified with \ :literal:`space\_secondary`\ . + + This option takes effect only when the local catalog data set is being created. If the local catalog data set already exists, the option has no effect. + + The size can be specified in megabytes (\ :literal:`M`\ ), kilobytes (\ :literal:`K`\ ), records (\ :literal:`REC`\ ), cylinders (\ :literal:`CYL`\ ), or tracks (\ :literal:`TRK`\ ). + + + | **required**: False + | **type**: str + | **default**: REC + | **choices**: M, K, REC, CYL, TRK + + + +state + The intended state for the local catalog, which the module aims to achieve. + + Specify \ :literal:`absent`\ to remove the local catalog data set entirely, if it already exists. + + Specify \ :literal:`initial`\ to create the local catalog data set if it does not exist, or empty this existing local catalog of all records. + + Specify \ :literal:`warm`\ to retain an existing local catalog in its current state. The module verifies whether the specified data set exists and whether it contains any records. If both conditions are met, the module leaves the data set as is. If the data set does not exist or if it is empty, the operation fails. + + + | **required**: True + | **type**: str + | **choices**: initial, absent, warm + + + +volumes + The volume(s) where the data set is created. Use a string to define a singular volume or a list of strings for multiple volumes. + + + | **required**: False + | **type**: raw + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Initialize a local catalog data set by using the templated location + ibm.ibm_zos_cics.local_catalog: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "initial" + + - name: Initialize a user specified local catalog data set + ibm.ibm_zos_cics.local_catalog: + region_data_sets: + dfhlcd: + dsn: "REGIONS.ABCD0001.DFHLCD" + cics_data_sets: + sdfhload: "CICSTS61.CICS.SDFHLOAD" + state: "initial" + + - name: Initialize a large catalog data set by using the templated location + ibm.ibm_zos_cics.local_catalog: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + space_primary: 500 + space_type: "REC" + state: "initial" + + - name: Retain the existing local catalog defined by the template + ibm.ibm_zos_cics.local_catalog: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "warm" + + - name: Retain a user specified local catalog in its current state + ibm.ibm_zos_cics.local_catalog: + region_data_sets: + dfhlcd: + dsn: "REGIONS.ABCD0001.DFHLCD" + cics_data_sets: + sdfhload: "CICSTS61.CICS.SDFHLOAD" + state: "warm" + + - name: Delete a local catalog data set defined by the template + ibm.ibm_zos_cics.local_catalog: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + cics_data_sets: + template: "CICSTS61.CICS.<< lib_name >>" + state: "absent" + + - name: Delete a user specified local catalog data set + ibm.ibm_zos_cics.local_catalog: + region_data_sets: + dfhlcd: + dsn: "REGIONS.ABCD0001.DFHLCD" + cics_data_sets: + sdfhload: "CICSTS61.CICS.SDFHLOAD" + state: "absent" + + + + + + +See Also +-------- + +.. seealso:: + + - :ref:`global_catalog_module` + + + +Return Values +------------- + + + + + changed + | True if the state was changed, otherwise False. + + | **returned**: always + | **type**: bool + + + + failed + | True if the Ansible task failed, otherwise False. + + | **returned**: always + | **type**: bool + + + + start_state + | The state of the local catalog data set before the Ansible task runs. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the start of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + exists + | True if the specified local catalog data set exists. + + | **returned**: always + | **type**: bool + + + + + + end_state + | The state of the local catalog data set at the end of the Ansible task. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the end of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + exists + | True if the specified local catalog data set exists. + + | **returned**: always + | **type**: bool + + + + + + executions + | A list of program executions performed during the Ansible task. + + | **returned**: always + | **type**: list + + + + name + | A human-readable name for the program execution. + + | **returned**: always + | **type**: str + + + + rc + | The return code for the program execution. + + | **returned**: always + | **type**: int + + + + stdout + | The standard output stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + stderr + | The standard error stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + + + msg + | A string containing an error message if applicable + + | **returned**: always + | **type**: str + + diff --git a/_sources/ibm_zos_cics/docs/source/modules/local_request_queue.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/local_request_queue.rst.txt new file mode 100644 index 00000000..34bf6b77 --- /dev/null +++ b/_sources/ibm_zos_cics/docs/source/modules/local_request_queue.rst.txt @@ -0,0 +1,330 @@ +.. ............................................................................... +.. © Copyright IBM Corporation 2020,2023 . +.. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . +.. ............................................................................... + +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/local_request_queue.py + +.. _local_request_queue_module: + + +local_request_queue -- Create and remove the CICS local request queue +===================================================================== + + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- Create and remove the \ `local request queue `__\ data set used by a CICS® region. The local request queue data set stores pending BTS requests. It ensures that, if CICS fails, no pending requests are lost. +- You can use this module when provisioning or de-provisioning a CICS region. +- Use the \ :literal:`state`\ option to specify the intended state for the local request queue. For example, use \ :literal:`state=initial`\ to create a local request queue data set if it doesn't yet exist, or empty an existing local request queue of all records. + + + + + +Parameters +---------- + + + +region_data_sets + The location of the region data sets to be created by using a template, for example, \ :literal:`REGIONS.ABCD0001.\<\< data\_set\_name \>\>`\ . + + If you want to use a data set that already exists, ensure that the data set is a local request queue data set. + + + | **required**: True + | **type**: dict + + + + dfhlrq + Overrides the templated location for the local request queue data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of the local request queue to override the template. + + + | **required**: False + | **type**: str + + + + + template + The base location of the region data sets with a template. + + + | **required**: False + | **type**: str + + + + +space_primary + The size of the primary space allocated to the local request queue data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect when the local request queue data set is being created. If the data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 4 + + + +space_secondary + The size of the secondary space allocated to the local request queue data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect when the local request queue data set is being created. If the data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 1 + + + +space_type + The unit portion of the local request queue data set size. Note that this is just the unit; the value for the primary space is specified with \ :literal:`space\_primary`\ and the value for the secondary space is specified with \ :literal:`space\_secondary`\ . + + This option takes effect only when the local request queue data set is being created. If the data set already exists, the option has no effect. + + The size can be specified in megabytes (\ :literal:`M`\ ), kilobytes (\ :literal:`K`\ ), records (\ :literal:`REC`\ ), cylinders (\ :literal:`CYL`\ ), or tracks (\ :literal:`TRK`\ ). + + + | **required**: False + | **type**: str + | **default**: M + | **choices**: M, K, REC, CYL, TRK + + + +state + The intended state for the local request queue, which the module aims to achieve. + + Specify \ :literal:`absent`\ to remove the local request queue data set entirely, if it exists. + + Specify \ :literal:`initial`\ to create the local request queue data set if it does not exist, or empty this existing local request queue of all records. + + Specify \ :literal:`warm`\ to retain an existing local request queue data set in its current state. The module checks whether the specified data set exists, and if it does, leaves the data set as is. If the data set does not exist, the operation fails. + + + | **required**: True + | **type**: str + | **choices**: initial, absent, warm + + + +volumes + The volume(s) where the data set is created. Use a string to define a singular volume or a list of strings for multiple volumes. + + + | **required**: False + | **type**: raw + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Initialize a local request queue data set by using the templated location + ibm.ibm_zos_cics.local_request_queue: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "initial" + + - name: Initialize a user specified local request queue data set + ibm.ibm_zos_cics.local_request_queue: + region_data_sets: + dfhlrq: + dsn: "REGIONS.ABCD0001.DFHLRQ" + state: "initial" + + - name: Initialize a large request queue data set by using the templated location + ibm.ibm_zos_cics.local_request_queue: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + space_primary: 50 + space_type: "M" + state: "initial" + + - name: Retain the existing state of a local request queue data set defined by the template + ibm.ibm_zos_cics.local_request_queue: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "warm" + + - name: Retain the existing state of a user specified local request queue data set + ibm.ibm_zos_cics.local_request_queue: + region_data_sets: + dfhlrq: + dsn: "REGIONS.ABCD0001.DFHLRQ" + state: "warm" + + - name: Delete a local request queue data set defined by the template + ibm.ibm_zos_cics.local_request_queue: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "absent" + + - name: Delete a user specified local request queue data set + ibm.ibm_zos_cics.local_request_queue: + region_data_sets: + dfhlrq: + dsn: "REGIONS.ABCD0001.DFHLRQ" + state: "absent" + + + + + + + + + +Return Values +------------- + + + + + changed + | True if the state was changed, otherwise False. + + | **returned**: always + | **type**: bool + + + + failed + | True if the Ansible task failed, otherwise False. + + | **returned**: always + | **type**: bool + + + + start_state + | The state of the local request queue data set before the Ansible task runs. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the start of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + exists + | True if the specified local request queue data set exists. + + | **returned**: always + | **type**: bool + + + + + + end_state + | The state of the local request queue data set at the end of the Ansible task. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the end of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + exists + | True if the specified local request queue data set exists. + + | **returned**: always + | **type**: bool + + + + + + executions + | A list of program executions performed during the Ansible task. + + | **returned**: always + | **type**: list + + + + name + | A human-readable name for the program execution. + + | **returned**: always + | **type**: str + + + + rc + | The return code for the program execution. + + | **returned**: always + | **type**: int + + + + stdout + | The standard output stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + stderr + | The standard error stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + + + msg + | A string containing an error message if applicable + + | **returned**: always + | **type**: str + + diff --git a/_sources/ibm_zos_cics/docs/source/modules/region_jcl.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/region_jcl.rst.txt new file mode 100644 index 00000000..8e5728b9 --- /dev/null +++ b/_sources/ibm_zos_cics/docs/source/modules/region_jcl.rst.txt @@ -0,0 +1,3790 @@ +.. ............................................................................... +.. © Copyright IBM Corporation 2020,2023 . +.. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . +.. ............................................................................... + +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/region_jcl.py + +.. _region_jcl_module: + + +region_jcl -- Create CICS startup JCL data set +============================================== + + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- Create a data set containing the JCL to start a CICS® region. +- The JCL is generated by your input of CICS system data sets and system initialization parameters for CICS startup using the \ :literal:`DFHSIP`\ program. + + + + + +Parameters +---------- + + + +applid + The name of your z/OS Communications Server application identifier for this CICS region. + + + | **required**: True + | **type**: str + + + +cics_data_sets + The data set names of the \ :literal:`SDFHAUTH`\ , \ :literal:`SDFHLOAD`\ and \ :literal:`SDFHLIC`\ libraries, for example, \ :literal:`CICSTS61.CICS.SDFHAUTH`\ and \ :literal:`CICSTS61.CICS.SDFHLOAD`\ . + + + | **required**: True + | **type**: dict + + + + sdfhauth + The location of the \ :literal:`SDFHAUTH`\ librarty to override the template. + + + | **required**: False + | **type**: str + + + + sdfhlic + The location of the \ :literal:`SDFHLIC`\ library. If \ :literal:`cics\_data\_sets.template`\ is provided, this value overrides the template. + + + | **required**: False + | **type**: str + + + + sdfhload + The location of the \ :literal:`SDFHLOAD`\ library. If \ :literal:`cics\_data\_sets.template`\ is provided, this value overrides the template. + + + | **required**: False + | **type**: str + + + + template + The templated location of the libraries. + + + | **required**: False + | **type**: str + + + + +cpsm_data_sets + The data set names of the \ :literal:`SEYUAUTH`\ and \ :literal:`SEYULOAD`\ libraries, for example, \ :literal:`CTS610.CPSM610.SEYUAUTH`\ . + + + | **required**: False + | **type**: dict + + + + seyuauth + The location of the \ :literal:`SEYUAUTH`\ library. If \ :literal:`cpsm\_data\_sets.template`\ is provided, this value overrides the template. + + + | **required**: False + | **type**: str + + + + seyuload + The location of the \ :literal:`SEYULOAD`\ library. If \ :literal:`cpsm\_data\_sets.template`\ is provided, this value overrides the template. + + + | **required**: False + | **type**: str + + + + template + The templated location of the CICSPlex SM libraries. + + + | **required**: False + | **type**: str + + + + +dfhrpl + Any locations of additional data sets other than \ :literal:`SDFHLOAD`\ , \ :literal:`SCEECICS`\ , \ :literal:`SCEERUN`\ , or \ :literal:`SCEERUN2`\ , to be added to the DFHRPL concatenation. The DFHRPL concatenation is where you specify the libraries that contain modules loaded by CICS, for example, the libraries containing your CICS application programs, your CICS control tables, and so on. You can either add data sets at the very top of the list or append them to the bottom of the list. There are other data sets in between, as determined by the defaults or other input parameters; for example, \ :literal:`SCEERUN`\ and \ :literal:`SCEERUN2`\ as specified with \ :literal:`le\_data\_sets`\ , \ :literal:`SDFHLOAD`\ as specified with \ :literal:`cics\_data\_sets`\ , and so on. + + + | **required**: False + | **type**: dict + + + + data_sets + The \ :literal:`DFHRPL`\ data sets to be added to the bottom of the list. + + + | **required**: False + | **type**: list + + + + top_data_sets + The \ :literal:`DFHRPL`\ data sets to be added to the very top of the list. + + + | **required**: False + | **type**: list + + + + +job_parameters + Specifies various parameters to be applied to the CICS startup job. + + + | **required**: False + | **type**: dict + + + + accounting_information + Allows jobs to be grouped into a class. + + + | **required**: False + | **type**: dict + + + + cards + Specifies the estimated number of cards JES2 is to punch from this job's sysout data sets. The value is 1 through 4 decimal numbers. If you omit cards, JES2 uses an installation default specified at initialization. + + + | **required**: False + | **type**: int + + + + copies + Specifies the number of times JES2 is to print or punch this job's sysout data sets. The value is 1 through 3 decimal numbers and must not exceed an installation-specified limit. The maximum is 255. For example, code 2 for two copies. If you omit copies, JES2 assumes one copy. + + + | **required**: False + | **type**: int + + + + forms + Specifies the forms that JES2 is to use for printing this job's sysout data sets. The value is 1 through 4 alphanumeric characters. For example, code 5 for 5-part forms. If you omit forms, JES2 uses an installation default specified at initialization. + + + | **required**: False + | **type**: str + + + + linect + Specifies the number of lines JES2 is to print per page for this job's sysout data sets. The value is 1 through 3 decimal numbers. If you omit linect, JES2 uses an installation default specified at initialization. If you code a zero, JES2 does not eject to a new page when the number of lines exceeds the installation default. + + + | **required**: False + | **type**: int + + + + lines + Specifies the estimated line count, in thousands of lines, from this job's sysout data sets. The value is 1 through 4 decimal numbers. For example, code 5 for 5000 lines. If you omit lines, JES2 uses an installation default specified at initialization. + + + | **required**: False + | **type**: int + + + + log + Specifies whether JES2 is to print the job log. Code N to surpress printing of the job log. If you code any other character or omit this subparameter, JES2 prints the job log. If your installation specified NOLOG for this job's class during JES2 initialization, JES2 does not print the job log. + + + | **required**: False + | **type**: str + + + + pano + Specifies the programmer's accounting number. The value is 1 through 4 alphanumeric characters. + + + | **required**: False + | **type**: str + + + + room + Specifies the programmer's room number. The value is 1 through 4 alphanumeric characters. + + + | **required**: False + | **type**: str + + + + time + Specifies the estimated execution time in minutes. The value is 1 through 4 decimal numbers. For example, code 30 for 30 minutes. If you omit a time subparameter and a TIME parameter on the JES2 /\*JOBPARM statement, JES2 uses an installation default specified at initialization. If job execution exceeds the time, JES2 sends a message to the operator. + + + | **required**: False + | **type**: int + + + + + class + Allows jobs to be grouped into a class. + + + | **required**: False + | **type**: str + + + + job_name + The name of the CICS startup job. The default value is \ :literal:`APPLID`\ . + + + | **required**: False + | **type**: str + + + + memlimit + Use the MEMLIMIT parameter to specify the limit on the total size of usable 64-bit z/OS storage in a single address space. + + + | **required**: False + | **type**: str + + + + msgclass + Use the MSGCLASS parameter to assign the job log to an output class. The job log is a record of job-related information for the programmer. + + + | **required**: False + | **type**: str + + + + msglevel + Use the MSGLEVEL parameter to control the listing of the JCL output for the job. + + + | **required**: False + | **type**: dict + + + + messages + Indicates which messages the system is to print in the system messages portion of the JCL output. + + + | **required**: False + | **type**: int + | **choices**: 0, 1 + + + + statements + Indicates which job control statements the system is to print in the statement images portion of the JCL output. + + + | **required**: False + | **type**: int + | **choices**: 0, 1, 2 + + + + + programmer_name + Use the programmer's name parameter to identify the person or group responsible for a job. + + + | **required**: False + | **type**: str + + + + region + Use the REGION parameter to specify the amount of central or virtual storage that the job requires. The system applies the value that you code on REGION to each step of the job. + + + | **required**: False + | **type**: str + + + + user + Code the USER parameter to identify to the system the person submitting the job. The user ID is used by RACF®, the system resources manager (SRM), and other system components. + + + | **required**: False + | **type**: str + + + + +le_data_sets + The data set names of the \ :literal:`SCEECICS`\ , \ :literal:`SCEERUN`\ and \ :literal:`SCEERUN2`\ libraries. + + + | **required**: True + | **type**: dict + + + + sceecics + The location of the \ :literal:`SCEECICS`\ library. If \ :literal:`le\_data\_sets.template`\ is provided, this value overrides the template. + + + | **required**: False + | **type**: str + + + + sceerun + The location of the \ :literal:`SCEERUN`\ library. If \ :literal:`le\_data\_sets.template`\ is provided, this value overrides the template. + + + | **required**: False + | **type**: str + + + + sceerun2 + The location of the \ :literal:`SCEERUN2`\ library. If \ :literal:`le\_data\_sets.template`\ is provided, this value overrides the template. + + + | **required**: False + | **type**: str + + + + template + The templated location of the Language Enviornment runtime libraries. + + + | **required**: False + | **type**: str + + + + +output_data_sets + The system output data sets such as \ :literal:`CEEMSG`\ and \ :literal:`SYSPRINT`\ , as well as the destination class of the output. + + + | **required**: False + | **type**: dict + + + + ceemsg + Overrides the default class to use a custom class for the \ :literal:`CEEMSG`\ data set. Alternatively, omit the \ :literal:`CEEMSG`\ data set from being added to the job. + + + | **required**: False + | **type**: dict + + + + omit + Specifies whether \ :literal:`CEEMSG`\ should be excluded from being added to the list of sysout data sets. + + + | **required**: False + | **type**: bool + + + + sysout + Specify the output class to assign the \ :literal:`CEEMSG`\ data set to. + + + | **required**: False + | **type**: str + + + + + ceeout + Overrides the default class to use a custom class for the \ :literal:`CEEOUT`\ data set. Alternatively, omit the \ :literal:`CEEOUT`\ data set from being added to the job. + + + | **required**: False + | **type**: dict + + + + omit + Specifies whether \ :literal:`CEEOUT`\ should be excluded from being added to the list of sysout data sets. + + + | **required**: False + | **type**: bool + + + + sysout + Specify the output class to assign the \ :literal:`CEEOUT`\ data set to. + + + | **required**: False + | **type**: str + + + + + default_sysout_class + The class to be applied as the default for all of the output data sets. If it isn't provided and if no overrides are specified for an individual output data set, \* is applied. + + + | **required**: False + | **type**: str + + + + dfhcxrf + Overrides the default class to use a custom class for the \ :literal:`DFHCXRF`\ data set. Alternatively, omit the \ :literal:`DFHCXRF`\ data set from being added to the job. + + + | **required**: False + | **type**: dict + + + + omit + Specifies whether \ :literal:`DFHCXRF`\ should be excluded from being added to the list of sysout data sets. + + + | **required**: False + | **type**: bool + + + + sysout + Specify the output class to assign the \ :literal:`DFHCXRF`\ data set to. + + + | **required**: False + | **type**: str + + + + + logusr + Overrides the default class to use a custom class for the \ :literal:`LOGUSR`\ data set. Alternatively, omit the \ :literal:`LOGUSR`\ data set from being added to the job. + + + | **required**: False + | **type**: dict + + + + omit + Specifies whether \ :literal:`LOGUSR`\ should be excluded from being added to the list of sysout data sets. + + + | **required**: False + | **type**: bool + + + + sysout + Specify the output class to assign the \ :literal:`LOGUSR`\ data set to. + + + | **required**: False + | **type**: str + + + + + msgusr + Overrides the default class to use a custom class for the \ :literal:`MSGUSR`\ data set. Alternatively, omit the \ :literal:`MSGUSR`\ data set from being added to the job. + + + | **required**: False + | **type**: dict + + + + omit + Specifies whether \ :literal:`MSGUSR`\ should be excluded from being added to the list of sysout data sets. + + + | **required**: False + | **type**: bool + + + + sysout + Specify the output class to assign the \ :literal:`MSGUSR`\ data set to. + + + | **required**: False + | **type**: str + + + + + sysabend + Overrides the default class to use a custom class for the \ :literal:`SYSABEND`\ data set. Alternatively, omit the \ :literal:`SYSABEND`\ data set from being added to the job. + + + | **required**: False + | **type**: dict + + + + omit + Specifies whether \ :literal:`SYSABEND`\ should be excluded from being added to the list of sysout data sets. + + + | **required**: False + | **type**: bool + + + + sysout + Specify the output class to assign the \ :literal:`SYSABEND`\ data set to. + + + | **required**: False + | **type**: str + + + + + sysout + Overrides the default class to use a custom class for the \ :literal:`SYSOUT`\ data set. Alternatively, omit the \ :literal:`SYSOUT`\ data set from being added to the job. + + + | **required**: False + | **type**: dict + + + + omit + Specifies whether \ :literal:`SYSOUT`\ should be excluded from being added to the list of sysout data sets. + + + | **required**: False + | **type**: bool + + + + sysout + Specify the output class to assign the \ :literal:`SYSOUT`\ data set to. + + + | **required**: False + | **type**: str + + + + + sysprint + Overrides the default class to use a custom class for the \ :literal:`SYSPRINT`\ data set. Alternatively, omit the \ :literal:`SYSPRINT`\ data set from being added to the job. + + + | **required**: False + | **type**: dict + + + + omit + Specifies whether \ :literal:`SYSPRINT`\ should be excluded from being added to the list of sysout data sets. + + + | **required**: False + | **type**: bool + + + + sysout + Specify the output class to assign the \ :literal:`SYSPRINT`\ data set to. + + + | **required**: False + | **type**: str + + + + + sysudump + Overrides the default class to use a custom class for the \ :literal:`SYSUDUMP`\ data set. Alternatively, omit the \ :literal:`SYSUDUMP`\ data set from being added to the job. + + + | **required**: False + | **type**: dict + + + + omit + Specifies whether \ :literal:`SYSUDUMP`\ should be excluded from being added to the list of sysout data sets. + + + | **required**: False + | **type**: bool + + + + sysout + Specify the output class to assign the \ :literal:`SYSUDUMP`\ data set to. + + + | **required**: False + | **type**: str + + + + + +region_data_sets + The location of the region data sets, for example, \ :literal:`REGIONS.ABCD01.DFHAUXT`\ , \ :literal:`REGIONS.ABCD01.DFHCSD`\ and \ :literal:`REGIONS.ABCD01.DFHGCD`\ . + + + | **required**: True + | **type**: dict + + + + dfhauxt + Overrides the templated location for the auxiliary trace A data set. + + + | **required**: False + | **type**: dict + + + + dsn + The name of the auxiliary trace A data set to override the template. + + + | **required**: False + | **type**: str + + + + + dfhbuxt + Overrides the templated location for the auxiliary trace B data set. + + + | **required**: False + | **type**: dict + + + + dsn + The name of the auxiliary trace B data set to override the template. + + + | **required**: False + | **type**: str + + + + + dfhcsd + Overrides the templated location for the CSD. + + + | **required**: False + | **type**: dict + + + + dsn + The name of the CSD to override the template. + + + | **required**: False + | **type**: str + + + + + dfhdmpa + Overrides the templated location for the dump A data set. + + + | **required**: False + | **type**: dict + + + + dsn + The name of the dump A data set to override the template. + + + | **required**: False + | **type**: str + + + + + dfhdmpb + Overrides the templated location for the dump B data set. + + + | **required**: False + | **type**: dict + + + + dsn + The name of the dump B data set to override the template. + + + | **required**: False + | **type**: str + + + + + dfhgcd + Overrides the templated location for the global catalog data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of the global catalog to override the template. + + + | **required**: False + | **type**: str + + + + + dfhintra + Overrides the templated location for the intrapartition data set. + + + | **required**: False + | **type**: dict + + + + dsn + The name of the intrapartition data set to override the template. + + + | **required**: False + | **type**: str + + + + + dfhlcd + Overrides the templated location for the local catalog data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of the local catalog to override the template. + + + | **required**: False + | **type**: str + + + + + dfhlrq + Overrides the templated location for the local request queue data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of the local request queue to override the template. + + + | **required**: False + | **type**: str + + + + + dfhstart + Overrides the templated location for the CICS startup JCL data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of the CICS startup JCL data set to override the template. + + The data set name can also be set to a member of an existing PDS or PDSE. + + + | **required**: False + | **type**: str + + + + + dfhtemp + Overrides the templated location for the temporary storage data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of the temporary storage to override the template. + + + | **required**: False + | **type**: str + + + + + template + The base location of the region data sets to be created by using a template, for example, \ :literal:`REGIONS.ABCD0001.\<\< data\_set\_name \>\>`\ . This is not required if you provide the data set name (dsn) of all the data sets individually. + + + | **required**: False + | **type**: str + + + + +sit_parameters + Define the system initalization parameters for the CICS region. + + + | **required**: False + | **type**: dict + + + + adi + The ADI parameter specifies the alternate delay interval in seconds for an alternate CICS® region when you are running CICS with XRF. + + + | **required**: False + | **type**: int + + + + aibridge + The AIBRIDGE parameter specifies whether the autoinstall user replaceable module (URM) is to be called when creating bridge facilities (virtual terminals) used by the 3270 bridge mechanism. + + Specify this parameter only in the bridge router region. + + + | **required**: False + | **type**: str + | **choices**: AUTO, YES + + + + aicons + The AICONS parameter specifies whether you want autoinstall support for consoles. + + + | **required**: False + | **type**: str + | **choices**: NO, AUTO, YES + + + + aiexit + The AIEXIT parameter specifies the name of the autoinstall user-replaceable program that you want CICS® to use when autoinstalling local z/OS® Communications Server terminals, APPC connections, virtual terminals, and shipped terminals and connections. + + + | **required**: False + | **type**: str + + + + aildelay + The AILDELAY parameter specifies the delay period that elapses after all sessions between CICS® and an autoinstalled terminal, APPC device, or APPC system are ended, before the terminal or connection entry is deleted. + + + | **required**: False + | **type**: int + + + + aiqmax + The AIQMAX parameter specifies the maximum number of z/OS® Communications Server terminals and APPC connections that can be queued concurrently for autoinstall, the limit is the sum of installs and deletes. + + + | **required**: False + | **type**: int + + + + airdelay + The AIRDELAY parameter specifies the delay period that elapses after an emergency restart before autoinstalled terminal and APPC connection entries that are not in session are deleted. + + + | **required**: False + | **type**: int + + + + akpfreq + The AKPFREQ parameter specifies the number of write requests to the CICS® system log stream output buffer required before CICS writes an activity keypoint. + + + | **required**: False + | **type**: int + + + + autconn + The AUTCONN parameter specifies that the reconnection of terminals after an XRF takeover is to be delayed, to allow time for manual switching. + + + | **required**: False + | **type**: int + + + + autodst + The AUTODST parameter specifies whether CICS is to activate automatic dynamic storage tuning for application programs. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + autoresettime + The AUTORESETTIME parameter specifies the action CICS takes for automatic time changes. + + + | **required**: False + | **type**: str + | **choices**: IMMEDIATE, NO, YES + + + + auxtr + The AUXTR parameter specifies whether the auxiliary trace destination is to be activated at system initialization. + + + | **required**: False + | **type**: str + | **choices**: OFF, ON + + + + auxtrsw + The AUXTRSW parameter specifies whether you want the auxiliary trace autoswitch facility. + + + | **required**: False + | **type**: str + | **choices**: NO, NEXT, ALL + + + + bms + The BMS system initialization parameter specifies which version of basic mapping support you require in CICS. + + + | **required**: False + | **type**: str + + + + brmaxkeeptime + The BRMAXKEEPTIME parameter specifies the maximum time (in seconds) that bridge facilities (virtual terminals used by the 3270 bridge) are kept if they are not used. + + + | **required**: False + | **type**: int + + + + cdsasze + The CDSASZE system initialization parameter specifies the size of the CDSA. + + + | **required**: False + | **type**: int + + + + certexpirywarn + The CERTEXPIRYWARN parameter specifies whether CICS® warns about expiring certificates, and if so, how many days ahead of the expiry. + + + | **required**: False + | **type**: str + + + + chkstrm + The CHKSTRM parameter specifies that terminal storage-violation checking is to be activated or deactivated. + + + | **required**: False + | **type**: str + | **choices**: CURRENT, NONE + + + + chkstsk + The CHKSTSK parameter specifies that task storage-violation checking at startup is to be activated or deactivated. + + + | **required**: False + | **type**: str + | **choices**: CURRENT, NONE + + + + cicssvc + The CICSSVC parameter specifies the number that you have assigned to the CICS type 3 SVC. + + + | **required**: False + | **type**: int + + + + cilock + The CILOCK parameter specifies whether or not the control interval lock of a non-RLS VSAM file is to be kept after a successful read-for-update request. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + clintcp + The CLINTCP parameter specifies the default client code page to be used by the DFHCNV data conversion table, but only if the CLINTCP parameter in the DFHCNV macro is set to SYSDEF. + + + | **required**: False + | **type**: str + + + + clsdstp + The CLSDSTP system initialization parameter specifies the notification required for an EXEC CICS ISSUE PASS command. + + + | **required**: False + | **type**: str + | **choices**: NOTIFY, NONOTIFY + + + + clt + The CLT parameter specifies the suffix for the command list table (CLT), if this SIT is used by an alternate XRF system. + + + | **required**: False + | **type**: str + + + + cmdprot + The CMDPROT parameter specifies whether to allow or inhibit CICS validation of start addresses of storage referenced as output parameters on EXEC CICS commands. + + + | **required**: False + | **type**: str + | **choices**: YES, NO + + + + cmdsec + The CMDSEC parameter specifies whether or not you want CICS to honor the CMDSEC option specified on a transaction's resource definition. + + + | **required**: False + | **type**: str + | **choices**: ASIS, ALWAYS + + + + confdata + The CONFDATA parameter specifies whether CICS is to redact sensitive data that might otherwise appear in CICS trace entries or in dumps. + + + | **required**: False + | **type**: str + | **choices**: HIDE, SHOW + + + + conftxt + The CONFTXT system initialization parameter specifies whether CICS is to prevent z/OS Communications Server from tracing user data. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + cpsmconn + The CPSMCONN parameter specifies whether you want CICS to invoke the specified component during initialization of the region. + + + | **required**: False + | **type**: str + | **choices**: NO, CMAS, LMAS, SMSSJ, WUI + + + + crlprofile + The CRLPROFILE parameter specifies the name of the profile that is used to authorize CICS to access the certification revocation lists (CRLs) that are stored in an LDAP server. + + + | **required**: False + | **type**: str + + + + csdacc + The CSDACC parameter specifies the type of access to the CSD to be permitted to this CICS region. + + + | **required**: False + | **type**: str + | **choices**: READWRITE, READONLY + + + + csdbkup + The CSDBKUP parameter specifies whether or not the CSD is eligible for BWO. + + + | **required**: False + | **type**: str + | **choices**: STATIC, DYNAMIC + + + + csdbufnd + The CSDBUFND parameter specifies the number of buffers to be used for CSD data. + + + | **required**: False + | **type**: int + + + + csdbufni + The CSDBUFNI parameter specifies the number of buffers to be used for the CSD index. + + + | **required**: False + | **type**: int + + + + csddisp + The CSDDISP parameter specifies the disposition of the data set to be allocated to the CSD. + + + | **required**: False + | **type**: str + | **choices**: OLD, SHR + + + + csddsn + The CSDDSN parameter specifies the 1-44 character JCL data set name (DSNAME) to be used for the CSD. + + + | **required**: False + | **type**: str + + + + csdfrlog + The CSDFRLOG parameter specifies a number that corresponds to the journal name that CICS uses to identify the forward recovery log stream for the CSD. + + + | **required**: False + | **type**: int + + + + csdinteg + The CSDINTEG parameter specifies the level of read integrity for the CSD if it is accessed in RLS mode. + + + | **required**: False + | **type**: str + | **choices**: UNCOMMITTED, CONSISTENT, REPEATABLE + + + + csdjid + The CSDJID parameter specifies the journal identifier of the journal that you want CICS to use for automatic journaling of file requests against the CSD. + + + | **required**: False + | **type**: str + + + + csdlsrno + The CSDLSRNO system initialization parameter specifies whether the CSD is to be associated with a local shared resource (LSR) pool. + + + | **required**: False + | **type**: str + + + + csdrecov + The CSDRECOVsystem initialization parameter specifies whether the CSD is a recoverable file. + + + | **required**: False + | **type**: str + | **choices**: NONE, ALL, BACKOUTONLY + + + + csdrls + The CSDRLS system initialization parameter specifies whether CICS is to access the CSD in RLS mode. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + csdstrno + The CSDSTRNO system initialization parameter specifies the number of concurrent requests that can be processed against the CSD. + + + | **required**: False + | **type**: int + + + + cwakey + The CWAKEY system initialization parameter specifies the storage key for the common work area (CWA) if you are operating CICS with storage protection (STGPROT=YES). + + + | **required**: False + | **type**: str + | **choices**: USER, CICS + + + + dae + The DAE system initialization parameter specifies the default DAE action when new system dump table entries are created. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + datform + The DATFORM system initialization parameter specifies the external date display standard that you want to use for CICS date displays. + + + | **required**: False + | **type**: str + | **choices**: MMDDYY, DDMMYY, YYMMDD + + + + db2conn + The DB2CONN system initialization parameter specifies whether you want CICS to start the connection automatically during initialization. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + dbctlcon + The DBCTLCON system initialization parameter specifies whether you want CICS to start the DBCTL connection automatically during initialization. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + debugtool + The DEBUGTOOL system initialization parameter specifies whether you want to use debugging profiles to select the programs that will run under the control of a debugging tool. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + dfltuser + The DFLTUSER system initialization parameter specifies the RACF userid of the default user; that is, the user whose security attributes are used to protect CICS resources in the absence of other, more specific, user identification. + + + | **required**: False + | **type**: str + + + + dip + The DIP system initialization parameter specifies whether the batch data interchange program, DFHDIP, is to be included. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + dismacp + The DISMACP system initialization parameter specifies whether CICS is to disable any transaction that terminates abnormally with an ASRD or ASRE abend. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + doccodepage + The DOCCODEPAGE system initialization parameter specifies the default host code page to be used by the document domain. + + + | **required**: False + | **type**: str + + + + dsalim + The DSALIM system initialization parameter specifies the upper limit of the total amount of storage within which CICS® can allocate the individual dynamic storage areas (DSAs) that reside in 24-bit storage. + + + | **required**: False + | **type**: str + + + + dshipidl + The DSHIPIDL system initialization parameter specifies the minimum time, in hours, minutes, and seconds, that an inactive shipped terminal definition must remain installed in this region. + + + | **required**: False + | **type**: int + + + + dshipint + The DSHIPINT system initialization parameter specifies the interval between invocations of the timeout delete mechanism. + + + | **required**: False + | **type**: int + + + + dsrtpgm + The DSRTPGM system initialization parameter specifies the name of a distributed routing program. The distributed routing program must be specified in the DSRTPGM parameter for all routing and potential target regions. + + + | **required**: False + | **type**: str + + + + dtrpgm + The DTRPGM system initialization parameter specifies the name of a dynamic routing program. + + + | **required**: False + | **type**: str + + + + dtrtran + The DTRTRAN system initialization parameter specifies the name of the transaction definition that you want CICS to use for dynamic transaction routing. + + + | **required**: False + | **type**: str + + + + dump + The DUMP system initialization parameter specifies whether the CICS dump domain is to take SDUMPs. + + + | **required**: False + | **type**: str + | **choices**: YES, NO, TABLEONLY + + + + dumpds + The DUMPDS system initialization parameter specifies the transaction dump data set that is to be opened during CICS initialization. + + + | **required**: False + | **type**: str + | **choices**: AUTO, A, B + + + + dumpsw + The DUMPSW system initialization parameter specifies whether you want CICS to switch automatically to the next dump data set when the first is full. + + + | **required**: False + | **type**: str + | **choices**: NO, NEXT, ALL + + + + duretry + The DURETRY system initialization parameter specifies, in seconds, the total time that CICS is to continue trying to obtain a system dump using the SDUMP macro. + + + | **required**: False + | **type**: int + + + + ecdsasze + The ECDSASZE system initialization parameter specifies the size of the ECDSA. + + + | **required**: False + | **type**: str + + + + edsalim + The EDSALIM system initialization parameter specifies the upper limit of the total amount of storage within which CICS® can allocate the individual extended dynamic storage areas (ExxDSAs) that reside in 31-bit (above-the-line) storage; that is, above 16 MB but below 2 GB. + + + | **required**: False + | **type**: str + + + + eodi + The EODI system initialization parameter specifies the end-of-data indicator for input from sequential devices. + + + | **required**: False + | **type**: str + + + + epcdsasze + The EPCDSASZE parameter specifies the size of the EPCDSA dynamic storage area. Message DFHSM0136I at initialization shows the value that is set. + + + | **required**: False + | **type**: str + + + + epudsasze + The EPUDSASZE parameter specifies the size of the EPUDSA dynamic storage area. Message DFHSM0136I at initialization shows the value that is set. + + + | **required**: False + | **type**: str + + + + erdsasze + The ERDSASZE system initialization parameter specifies the size of the ERDSA. + + + | **required**: False + | **type**: str + + + + esdsasze + The ESDSASZE system initialization parameter specifies the size of the ESDSA. + + + | **required**: False + | **type**: str + + + + esmexits + The ESMEXITS system initialization parameter specifies whether installation data is to be passed through the RACROUTE interface to the external security manager (ESM) for use in exits written for the ESM. + + + | **required**: False + | **type**: str + | **choices**: NOINSTLN, INSTLN + + + + eudsasze + The EUDSASZE system initialization parameter specifies the size of the EUDSA. + + + | **required**: False + | **type**: str + + + + fcqronly + The FCQRONLY system initialization parameter specifies whether you want CICS to force all file control requests to run under the CICS QR TCB. This parameter applies to file control requests that access VSAM RLS files and local VSAM LSR files. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + fct + The FCT system initialization parameter specifies the suffix of the file control table to be used. + + + | **required**: False + | **type**: str + + + + fepi + The FEPI system initialization parameter specifies whether or not you want to use the Front End Programming Interface feature (FEPI). + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + fldsep + The FLDSEP system initialization parameter specifies 'ON'e through four field-separator characters, each of which indicates end of field in the terminal input data. + + + | **required**: False + | **type**: str + + + + fldstrt + The FLDSTRT system initialization parameter specifies a single character to be the field-name-start character for free-form input for built-in functions. + + + | **required**: False + | **type**: str + + + + forceqr + The FORCEQR system initialization parameter specifies whether you want CICS to force all CICS API user application programs that are specified as threadsafe to run under the CICS QR TCB, as if they were specified as quasi-reentrant programs. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + fsstaff + The FSSTAFF system initialization parameter prevents transactions initiated by function-shipped EXEC CICS START requests being started against incorrect terminals. + + + | **required**: False + | **type**: str + | **choices**: YES, NO + + + + ftimeout + The FTIMEOUT system initialization parameter specifies a timeout interval for requests made on files that are opened in RLS mode. + + + | **required**: False + | **type**: int + + + + gmtext + The GMTEXT system initialization parameter specifies whether the default logon message text (WELCOME TO CICS) or your own message text is to be displayed on the screen. + + + | **required**: False + | **type**: str + + + + gmtran + The GMTRAN system initialization parameter specifies the ID of a transaction. + + + | **required**: False + | **type**: str + + + + gntran + The GNTRAN system initialization parameter specifies the transaction that you want CICS to invoke when a user's terminal-timeout period expires, and instructs CICS whether to keep a pseudo-conversation in use at a terminal that is the subject of a timeout sign-off. + + + | **required**: False + | **type**: str + + + + grname + The GRNAME system initialization parameter specifies the z/OS Communications Server generic resource name, as 1 through 8 characters, under which a group of CICS terminal-owning regions in a CICSplex register to z/OS Communications Server. + + + | **required**: False + | **type**: str + + + + grplist + The GRPLIST system initialization parameter specifies the names of up to four lists of resource definition groups on the CICS system definition file (CSD). The resource definitions in all the groups in the specified lists are loaded during initialization when CICS performs a cold start. If a warm or emergency start is performed, the resource definitions are derived from the global catalog, and the GRPLIST parameter is ignored. + + + | **required**: False + | **type**: str + + + + gtftr + The GTFTR system initialization parameter specifies whether CICS can use the MVS generalized trace facility (GTF) as a destination for trace data. + + + | **required**: False + | **type**: str + | **choices**: OFF, ON + + + + hpo + The HPO system initialization parameter specifies whether you want to use the z/OS Communications Server authorized path feature of the high performance option (HPO). + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + httpserverhdr + The HTTPSERVERHDR system initialization parameter specifies the value (up to 64 characters) that CICS sets in the server header of HTTP responses. + + + | **required**: False + | **type**: str + + + + httpusragenthdr + The HTTPUSRAGENTHDR system initialization parameter specifies the value (up to 64 characters) that CICS sets in the user-agent header of HTTP requests. + + + | **required**: False + | **type**: str + + + + icp + The ICP system initialization parameter specifies that you want to perform a cold start for interval control program. + + + | **required**: False + | **type**: str + | **choices**: COLD + + + + icv + The ICV system initialization parameter specifies the region exit time interval in milliseconds. + + + | **required**: False + | **type**: int + + + + icvr + The ICVR system initialization parameter specifies the default runaway task time interval in milliseconds as a decimal number. + + + | **required**: False + | **type**: int + + + + icvtsd + The ICVTSD system initialization parameter specifies the terminal scan delay value. + + + | **required**: False + | **type**: int + + + + infocenter + The INFOCENTER system initialization parameter specifies the location of the online . If you add this parameter to the Web User Interface (WUI) CICS startup JCL, a link labeled Information Center is displayed on WUI views and menus. If you do not code this parameter, CICS does not construct links to IBM Documentation. + + + | **required**: False + | **type**: str + + + + initparm + The INITPARM system initialization parameter specifies parameters that are to be passed to application programs that use the ASSIGN INITPARM command. + + + | **required**: False + | **type**: str + + + + intrdrjobuser + The INTRDRJOBUSER system initialization parameter instructs whether to use the task user ID or the CICS® region user ID as the job user ID for a JOB card that is submitted, without a USER parameter, by using SPOOLOPEN with USERID("INTRDR") and SPOOLWRITE. The default is the task user ID unless set otherwise by INTRDRJOBUSER. + + + | **required**: False + | **type**: str + | **choices**: TASK, REGION + + + + inttr + The INTTR system initialization parameter specifies whether the internal CICS trace destination is to be activated at system initialization. + + + | **required**: False + | **type**: str + | **choices**: ON, OFF + + + + ircstrt + The IRCSTRT system initialization parameter specifies whether IRC is to be started up at system initialization. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + isc + The ISC system initialization parameter specifies whether the CICS programs required for multiregion operation (MRO) and are to be included. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + jesdi + The JESDI system initialization parameter specifies, in a SIT for an alternate XRF system, the JES delay interval. + + + | **required**: False + | **type**: int + + + + jvmprofiledir + The JVMPROFILEDIR system initialization parameter specifies the name (up to 240 characters long) of a z/OS UNIX directory that contains the JVM profiles for CICS. CICS searches this directory for the profiles it needs to configure JVMs. + + + | **required**: False + | **type**: str + + + + kerberosuser + The KERBEROSUSER system initialization parameter specifies the user ID that is associated with the Kerberos service principal for the CICS region. + + + | **required**: False + | **type**: str + + + + keyring + The KEYRING system initialization parameter specifies the fully qualified name of the key ring, within the RACF database, that contains the keys and X.509 certificates used by CICS support for the Secure Sockets Layer (SSL) and for web services security. The region user ID that will use the key ring must either own the key ring or have the authority to use the key ring if it is owned by a different region user ID. You can create an initial key ring with the DFH$RING exec in .CICS.SDFHSAMP. + + + | **required**: False + | **type**: str + + + + lgdfint + The LGDFINT system initialization parameter specifies the log defer interval to be used by CICS® log manager when determining how long to delay a forced journal write request before invoking the MVS™ system logger. + + + | **required**: False + | **type**: int + + + + lgnmsg + The LGNMSG system initialization parameter specifies whether z/OS Communications Server logon data is to be made available to an application program. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + llacopy + The LLACOPY system initialization parameter specifies the situations where CICS uses either the LLACOPY macro or the BLDL macro when locating modules in the DFHRPL or dynamic LIBRARY concatenation. + + + | **required**: False + | **type**: str + | **choices**: YES, NO, NEWCOPY + + + + localccsid + The LOCALCCSID system initialization parameter specifies the default CCSID for the local region. + + + | **required**: False + | **type**: int + + + + lpa + The LPA system initialization parameter specifies whether CICS and user modules can be used from the link pack areas. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + maxopentcbs + The MAXOPENTCBS system initialization parameter specifies the maximum number, in the range 32 through 4032, of open task control blocks (open TCBs) CICS® can create in the pool of L8 and L9 mode TCBs. + + + | **required**: False + | **type**: int + + + + maxsockets + The MAXSOCKETS system initialization parameter specifies the maximum number of IP sockets that can be managed by the CICS sockets domain. + + + | **required**: False + | **type**: int + + + + maxssltcbs + The MAXSSLTCBS system initialization parameter specifies the maximum number of S8 TCBs that can run in the SSL pool. + + + | **required**: False + | **type**: int + + + + maxtlslevel + The MAXTLSLEVEL system initialization parameter specifies the maximum TLS protocol that CICS uses for secure TCP/IP connections. + + + | **required**: False + | **type**: str + | **choices**: TLS11, TLS12, TLS13 + + + + maxxptcbs + The MAXXPTCBS system initialization parameter specifies the maximum number, in the range 1 through 2000, of open X8 and X9 TCBs that can exist concurrently in the CICS region. + + + | **required**: False + | **type**: int + + + + mct + The MCT system initialization parameter specifies the monitoring control table suffix. + + + | **required**: False + | **type**: str + + + + mintlslevel + The MINTLSLEVEL system initialization parameter specifies the minimum TLS protocol that CICS uses for secure TCP/IP connections. + + + | **required**: False + | **type**: str + | **choices**: TLS11, TLS12, TLS13 + + + + mn + The MN system initialization parameter specifies whether monitoring is to be switched 'ON' or 'OFF' at initialization. + + + | **required**: False + | **type**: str + | **choices**: OFF, ON + + + + mnconv + The MNCONV system initialization parameter specifies whether conversational tasks have separate performance class records produced for each pair of terminal control I/O requests. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + mnexc + The MNEXC system initialization parameter specifies whether the monitoring exception class is to be made active during initialization. + + + | **required**: False + | **type**: str + | **choices**: OFF, ON + + + + mnfreq + The MNFREQ system initialization parameter specifies the interval for which CICS automatically produces a transaction performance class record for any long-running transaction. + + + | **required**: False + | **type**: int + + + + mnidn + The MNIDN system initialization parameter specifies whether the monitoring identity class is to be made active during CICS initialization. + + + | **required**: False + | **type**: str + | **choices**: OFF, ON + + + + mnper + The MNPER system initialization parameter specifies whether the monitoring performance class is to be made active during CICS initialization. + + + | **required**: False + | **type**: str + | **choices**: OFF, ON + + + + mnres + The MNRES system initialization parameter specifies whether transaction resource monitoring is to be made active during CICS initialization. + + + | **required**: False + | **type**: str + | **choices**: OFF, ON + + + + mnsync + The MNSYNC system initialization parameter specifies whether you want CICS to produce a transaction performance class record when a transaction takes an implicit or explicit syncpoint (unit-of-work). + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + mntime + The MNTIME system initialization parameter specifies whether you want the time stamp fields in the performance class monitoring data to be returned to an application using the EXEC CICS COLLECT STATISTICS MONITOR(taskno) command in either GMT or local time. + + + | **required**: False + | **type**: str + | **choices**: GMT, LOCAL + + + + mqconn + The MQCONN system initialization parameter specifies whether you want CICS to start a connection to automatically during initialization. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + mrobtch + The MROBTCH system initialization parameter specifies the number of events that must occur before CICS is posted for dispatch because of the batching mechanism. + + + | **required**: False + | **type**: int + + + + mrofse + The MROFSE system initialization parameter specifies whether you want to extend the lifetime of the long-running mirror to keep it allocated until the end of the task rather than after a user syncpoint for function shipping applications. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + mrolrm + The MROLRM system initialization parameter specifies whether you want to establish an MRO long-running mirror task. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + msgcase + The MSGCASE system initialization parameter specifies how you want the message domains to display mixed case messages. + + + | **required**: False + | **type**: str + | **choices**: MIXED, UPPER + + + + msglvl + The MSGLVL system initialization parameter specifies the message level that controls the generation of messages to the console and JES message log. + + + | **required**: False + | **type**: int + | **choices**: 1, 0 + + + + mxt + The MXT system initialization parameter specifies the maximum number, in the range 10 through 2000, of user tasks that can exist in a CICS system at the same time. The MXT value does not include CICS system tasks. + + + | **required**: False + | **type**: int + + + + natlang + The NATLANG system initialization parameter specifies the single-character code for the language to be supported in this CICS run. + + + | **required**: False + | **type**: str + | **choices**: E, C, K + + + + ncpldft + The NCPLDFT system initialization parameter specifies the name of the default named counter pool to be used by the CICS region 'ON' calls it makes to a named counter server. + + + | **required**: False + | **type**: str + + + + newsit + The NEWSIT system initialization parameter specifies whether CICS is to load the specified SIT, and enforce the use of all system initialization parameters, modified by any system initialization parameters provided by PARM, SYSIN, or the system console, even in a warm start. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + nistsp800131a + The NISTSP800131A system initialization parameter specifies whether the CICS region is to check for conformance to the NIST SP800-131A standard. + + + | **required**: False + | **type**: str + | **choices**: NOCHECK, CHECK + + + + nonrlsrecov + The NONRLSRECOV system initialization parameter specifies whether VSAM catalog recovery options should override those specified on the CICS FILE resource definition for all non-RLS files. Default behavior, with NONRLSRECOV=VSAMCAT, will take recovery attributes from the catalog if they are present, and from the file definition otherwise. RLS files must always specify recovery options on the catalog. + + + | **required**: False + | **type**: str + | **choices**: VSAMCAT, FILEDEF + + + + nqrnl + The NQRNL system initialization parameter controls resource name list (RNL) processing by z/OS global resource serialization, which can cause the scope value of a resource to change. CICS uses z/OS global resource serialization to provide sysplex-wide protection of application resources. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + offsite + The 'OFF'SITE system initialization parameter specifies whether CICS is to restart in 'OFF'-site recovery mode; that is, a restart is taking place at a remote site. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + opertim + The OPERTIM system initialization parameter specifies the write-to-operator timeout value, in the range 0 through 86400 seconds (24 hours). + + + | **required**: False + | **type**: int + + + + opndlim + The OPNDLIM system initialization parameter specifies the destination and close destination request limit. + + + | **required**: False + | **type**: int + + + + parmerr + The PARMERR system initialization parameter specifies what action you want to follow if CICS detects incorrect system initialization parameter overrides during initialization. + + + | **required**: False + | **type**: str + | **choices**: INTERACT, IGNORE, ABEND + + + + pcdsasze + The PCDSASZE parameter specifies the size of the PCDSA dynamic storage area. Message DFHSM0136I at initialization shows the value that is set. + + + | **required**: False + | **type**: int + + + + pdi + The PDI system initialization parameter specifies the XRF primary delay interval, in seconds, in a SIT for an active CICS region. + + + | **required**: False + | **type**: int + + + + pdir + The PDIR system initialization parameter specifies a suffix for the PDIR list. + + + | **required**: False + | **type**: str + + + + pgaictlg + The PGAICTLG system initialization parameter specifies whether autoinstalled program definitions should be cataloged. + + + | **required**: False + | **type**: str + | **choices**: MODIFY, NONE, ALL + + + + pgaiexit + The PGAIEXIT system initialization parameter specifies the name of the program autoinstall exit program. + + + | **required**: False + | **type**: str + + + + pgaipgm + The PGAIPGM system initialization parameter specifies the state of the program autoinstall function at initialization. + + + | **required**: False + | **type**: str + | **choices**: INACTIVE, ACTIVE + + + + pgchain + The PGCHAIN system initialization parameter specifies the character string that is identified by terminal control as a BMS terminal page-chaining command. + + + | **required**: False + | **type**: str + + + + pgcopy + The PGCOPY system initialization parameter specifies the character string that is identified by terminal control as a BMS command to copy output from one terminal to another. + + + | **required**: False + | **type**: str + + + + pgpurge + The PGPURGE system initialization parameter specifies the character string that is identified by terminal control as a BMS terminal page-purge command. + + + | **required**: False + | **type**: str + + + + pgret + The PGRET system initialization parameter specifies the character string that is recognized by terminal control as a BMS terminal page-retrieval command. + + + | **required**: False + | **type**: str + + + + pltpi + The PLTPI system initialization parameter specifies the suffix for, or the full name of, a program list table that contains a list of programs to be run in the final stages of system initialization. + + + | **required**: False + | **type**: str + + + + pltpisec + The PLTPISEC system initialization parameter specifies whether you want CICS to perform command security or resource security checking for PLT programs during CICS initialization. + + + | **required**: False + | **type**: str + | **choices**: NONE, CMDSEC, RESSEC, ALL + + + + pltpiusr + The PLTPIUSR system initialization parameter specifies the user ID that CICS uses for security checking for PLT programs that run during CICS initialization. + + + | **required**: False + | **type**: str + + + + pltsd + The PLTSD system initialization parameter specifies the suffix for, or full name of, a program list table that contains a list of programs to be run during system termination. + + + | **required**: False + | **type**: str + + + + prgdlay + The PRGDLAY system initialization parameter specifies the BMS purge delay time interval that is added t the specified delivery time to determine when a message is to be considered undeliverable and therefore purged. + + + | **required**: False + | **type**: int + + + + print + The PRINT system initialization parameter specifies the method of requesting printout of the contents of a 3270 screen. + + + | **required**: False + | **type**: str + | **choices**: NO, YES, PA1, PA2, PA3 + + + + prtyage + The PRTYAGE system initialization parameter specifies the number of milliseconds to be used in the priority aging algorithm that is used to increment the priority of a task. + + + | **required**: False + | **type**: int + + + + prvmod + The PRVMOD system initialization parameter specifies the names of those modules that are not to be used from the LPA. + + + | **required**: False + | **type**: str + + + + psbchk + The PSBCHK system initialization parameter specifies whether CICS is to perform PSB authorization checks for remote terminal users who use transaction routing to initiate a transaction in this CICS region to access an attached IMS system. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + psdint + The PSDINT system initialization parameter specifies the persistent session delay interval, which states if, and for how long, z/OS CommunicationsServer holds sessions in a recovery-pending state. + + + | **required**: False + | **type**: int + + + + pstype + The PSTYPE system initialization parameter specifies whether CICS uses z/OS Communications Server single-node persistent sessions (SNPS), multinode persistent sessions (MNPS), or does not use z/OS Communications Server persistent sessions support (NOPS). + + + | **required**: False + | **type**: str + | **choices**: SNPS, MNPS, NOPS + + + + pudsasze + The PUDSASZE parameter specifies the size of the PUDSA dynamic storage area. Message DFHSM0136I at initialization shows the value that is set. + + + | **required**: False + | **type**: str + + + + pvdelay + The PVDELAY system initialization parameter specifies the persistent verification delay as a value in the range 0 through 10080 minutes (up to 7 days). + + + | **required**: False + | **type**: int + + + + quiestim + The QUIESTIM system initialization parameter specifies a timeout value for data set quiesce requests. + + + | **required**: False + | **type**: int + + + + racfsync + The RACFSYNC system initialization parameter specifies whether CICS listens for type 71 ENF events and refreshes user security. + + + | **required**: False + | **type**: str + | **choices**: YES, NO, CPSM + + + + ramax + The RAMAX system initialization parameter specifies the size in bytes of the I/O area allocated for each RECEIVE ANY issued by CICS, in the range 0 through 32767 bytes. + + + | **required**: False + | **type**: int + + + + rapool + The RAPOOL system initialization parameter specifies the number of concurrent receive-any requests that CICS is to process from the z/OS Communications Server for SNA. + + + | **required**: False + | **type**: str + + + + rdsasze + The RDSASZE system initialization parameter specifies the size of the RDSA. + + + | **required**: False + | **type**: str + + + + rentpgm + The RENTPGM system initialization parameter specifies whether you want CICS to allocate the read-only DSAs from read-only key-0 protected storage. + + + | **required**: False + | **type**: str + | **choices**: PROTECT, NOPROTECT + + + + resoverrides + The RESOVERRIDES system initialization parameter specifies the 1-64 character name of the resource overrides file. For more information, see . + + + | **required**: False + | **type**: str + + + + resp + The RESP system initialization parameter specifies the type of request that CICS terminal control receives from logical units. + + + | **required**: False + | **type**: str + | **choices**: FME, RRN + + + + ressec + The RESSEC system initialization parameter specifies whether you want CICS to honor the RESSEC option specified on a transaction's resource definition. + + + | **required**: False + | **type**: str + | **choices**: ASIS, ALWAYS + + + + rls + The RLS system initialization parameter specifies whether CICS is to support VSAM record-level sharing (RLS). + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + rlstolsr + The RLSTOLSR system initialization parameter specifies whether CICS is to include files that are to be opened in RLS mode when calculating the number of buffers, strings, and other resources for an LSR pool. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + rmtran + The RMTRAN system initialization parameter specifies the name of the transaction that you want an alternate CICS to initiate when logged-on class 1 terminals, which are defined with the attribute RECOVNOTIFY(TRANSACTION) specified, are switched following a takeover. + + + | **required**: False + | **type**: str + + + + rrms + The RRMS system initialization parameter specifies whether CICS is to register as a resource manager with recoverable resource management services (RRMS). + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + rst + The RST system initialization parameter specifies a recoverable service table suffix. + + + | **required**: False + | **type**: str + + + + rstsignoff + The RSTSIGNOFF system initialization parameter specifies whether all users signed-on to the active CICS region are to remain signed-on following a persistent sessions restart or an XRF takeover. + + + | **required**: False + | **type**: str + | **choices**: NOFORCE, FORCE + + + + rstsigntime + The RSTSIGNTIME parameter specifies the timeout delay interval for signon retention during a persistent sessions restart or an XRF takeover. + + + | **required**: False + | **type**: int + + + + ruwapool + The RUWAPOOL parameter specifies the option for allocating a storage pool the first time a program invoked by Language Environment runs in a task. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + sdsasze + The SDSASZE system initialization parameter specifies the size of the SDSA. + + + | **required**: False + | **type**: str + + + + sdtmemlimit + The SDTMEMLIMIT system initialization parameter specifies a limit to the amount of storage above the bar that is available for shared data tables to use for control information (entry descriptors, backout elements, and index nodes). The default is 4 GB. When you set this parameter, check your current setting for the z/OS MEMLIMIT parameter. + + + | **required**: False + | **type**: str + + + + sdtran + The SDTRAN system initialization parameter specifies the name of the shutdown transaction to be started at the beginning of normal and immediate shutdown. + + + | **required**: False + | **type**: str + + + + sec + The SEC system initialization parameter specifies what level of external security you want CICS to use. + + + | **required**: False + | **type**: str + | **choices**: YES, NO + + + + secprfx + The SECPRFX system initialization parameter specifies whether CICS prefixes the resource names in any authorization requests to RACF. + + + | **required**: False + | **type**: str + + + + sit + The SIT system initialization parameter specifies the suffix, if any, of the system initialization table that you want CICS to load at the start of initialization. + + + | **required**: False + | **type**: str + + + + skrxxxx + The SKRxxxx system initialization parameter specifies that a single-keystroke-retrieval operation is required. + + Provide a dictionary with the key specifying a key on the 3270 keyboard and the value identifying a page retrieval command that the 3270 key represents. For example, PF20: PGPURGE + + The valid keys you can specify are PA1 through PA3, and PF1 through PF24. + + + | **required**: False + | **type**: dict + + + + snpreset + The SNPRESET system initialization parameter specifies whether preset userid terminals share a single access control environment element (ACEE) that is associated with the userid, or a unique ACEE for every terminal. + + + | **required**: False + | **type**: str + | **choices**: UNIQUE, SHARED + + + + snscope + The SNSCOPE system initialization parameter specifies whether a userid can be signed on to CICS more than once, within the scope of a single CICS region, a single MVS image, and a sysplex. + + + | **required**: False + | **type**: str + | **choices**: NONE, CICS, MVSIMAGE, SYSPLEX + + + + sotuning + The SOTUNING system initialization parameter specifies whether performance tuning for HTTP connections will occur to protect CICS from unconstrained resource demand. + + + | **required**: False + | **type**: str + | **choices**: YES, 520 + + + + spctr + The SPCTR system initialization parameter specifies the level of special tracing required for CICS as a whole. + + + | **required**: False + | **type**: str + + + + spctrxx + The SPCTRxx system initialization parameter specifies the level of special tracing activated for a particular CICS component. When you enable special tracing for a transaction, a terminal, or both, the trace points of this component at the specified trace level are eligible to make trace calls at any given point in the process of a special tracing task. + + Provide a dictionary with the key specifying a two-letter code that represents a component and the value specifying the trace level. For example: AP=1-2 + + You can provide several dictionaries to specify the level of special tracing for several components. Each component is defined by one dictionary. + + For information about CICS components and their respetive two-letter code, see \ `Component names and abbreviations `__\ . + + + | **required**: False + | **type**: dict + + + + spool + The SPOOL system initialization parameter specifies whether the system spooling interface is required. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + srbsvc + The SRBSVC system initialization parameter specifies the number that you have assigned to the CICS type 6 SVC. + + + | **required**: False + | **type**: int + + + + srt + The SRT system initialization parameter specifies the system recovery table suffix. + + + | **required**: False + | **type**: str + + + + srvercp + The SRVERCP system initialization parameter specifies the default server code page to be used by the DFHCNV data conversion table but only if the SRVERCP parameter in the DFHCNV macro is set to SYSDEF. + + + | **required**: False + | **type**: str + + + + sslcache + The SSLCACHE system initialization parameter specifies whether session IDs for SSL sessions are to be cached locally or at sysplex level for reuse by the CICS® region. The SSL cache allows CICS to perform abbreviated handshakes with clients that it has previously authenticated. + + + | **required**: False + | **type**: str + | **choices**: CICS, SYSPLEX + + + + ssldelay + The SSLDELAY system initialization parameter specifies the length of time in seconds for which CICS retains session ids for secure socket connections. + + + | **required**: False + | **type**: int + + + + start + The START system initialization parameter specifies the type of start for the system initialization program. + + + | **required**: False + | **type**: str + | **choices**: AUTO, INITIAL, COLD, STANDBY, (INITIAL, ALL), (AUTO, ALL), (COLD, ALL), (STANDBY, ALL) + + + + starter + The STARTER system initialization parameter specifies whether the generation of starter system modules (with $ and + + + | **required**: False + | **type**: str + | **choices**: YES, NO + + + + stateod + The STATEOD system initialization parameter specifies the end-of-day time in the format hhmmss. + + + | **required**: False + | **type**: int + + + + statint + The STATINT system initialization parameter specifies the recording interval for system statistics in the format hhmmss. + + + | **required**: False + | **type**: int + + + + statrcd + The STATRCD system initialization parameter specifies the interval statistics recording status at CICS initialization. + + + | **required**: False + | **type**: str + | **choices**: OFF, ON + + + + stgprot + The STGPROT system initialization parameter specifies whether you want storage protection to operate in the CICS region. + + + | **required**: False + | **type**: str + | **choices**: YES, NO + + + + stgrcvy + The STGRCVY system initialization parameter specifies whether CICS should try to recover from a storage violation. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + stntr + The STNTR system initialization parameter specifies the level of standard tracing required for CICS as a whole. + + + | **required**: False + | **type**: str + + + + stntrxx + The STNTRxx system initialization parameter specifies the level of standard tracing for a particular CICS component. + + Provide a dictionary with the key specifying a two-letter code that represents a component and the value specifying the trace level. For example: AP=1-2 + + You can provide several dictionaries to specify the level of standard tracing for several components. Each component is defined by one dictionary. For components that are not defined here, their standard tracing levels are determined by STNTR. + + For information about CICS components and their respective two-letter code, see \ `Component names and abbreviations `__\ . + + + | **required**: False + | **type**: dict + + + + subtsks + The SUBTSKS system initialization parameter specifies the number of task control blocks (TCBs) you want CICS to use for running tasks in concurrent mode. + + + | **required**: False + | **type**: int + | **choices**: 0, 1 + + + + suffix + The SUFFIX system initialization parameter specifies the last two characters of the name of this system initialization table. + + + | **required**: False + | **type**: str + + + + sydumax + The SYDUMAX system initialization parameter specifies the limit on the number of system dumps that can be taken per dump table entry. + + + | **required**: False + | **type**: int + + + + sysidnt + The SYSIDNT system initialization parameter specifies a 1- to 4-character name that is known only to your CICS region. + + + | **required**: False + | **type**: str + + + + systr + The SYSTR system initialization parameter specifies the setting of the main system trace flag. + + + | **required**: False + | **type**: str + | **choices**: ON, OFF + + + + takeovr + The TAKEOVR system initialization parameter specifies the action to be taken by the alternate CICS region, following the apparent loss of the surveillance signal in the active CICS region. + + + | **required**: False + | **type**: str + | **choices**: MANUAL, AUTO, COMMAND + + + + tbexits + The TBEXITS system initialization parameter specifies the names of your backout exit programs for use during emergency restart backout processing. + + + | **required**: False + | **type**: str + + + + tcp + The TCP system initialization parameter specifies whether the pregenerated non-z/OS Communications Server terminal control program, DFHTCP, is to be included. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + tcpip + The TCPIP system initialization parameter specifies whether CICS TCP/IP services are to be activated at CICS startup. + + + | **required**: False + | **type**: str + | **choices**: YES, NO + + + + tcsactn + The TCSACTN system initialization parameter specifies the required action that CICS terminal control should take if the terminal control shutdown wait threshold expires. + + + | **required**: False + | **type**: str + | **choices**: NONE, UNBIND, FORCE + + + + tcswait + The TCSWAIT system initialization parameter specifies the required CICS terminal control shutdown wait threshold. + + + | **required**: False + | **type**: str + + + + tct + The TCT system initialization parameter specifies which terminal control table, if any, is to be loaded. + + + | **required**: False + | **type**: str + + + + tctuakey + The TCTUAKEY system initialization parameter specifies the storage key for the terminal control table user areas (TCTUAs) if you are operating CICS with storage protection (STGPROT=YES). + + + | **required**: False + | **type**: str + | **choices**: USER, CICS + + + + tctualoc + The TCTUALOC system initialization parameter specifies where terminal user areas (TCTUAs) are to be stored. + + + | **required**: False + | **type**: str + | **choices**: BELOW, ANY + + + + td + The TD system initialization parameter specifies the number of VSAM buffers and strings to be used for intrapartition transient data (TD). + + + | **required**: False + | **type**: str + + + + tdintra + The TDINTRA system initialization parameter specifies whether CICS is to initialize with empty intrapartition TD queues. + + + | **required**: False + | **type**: str + | **choices**: NOEMPTY, EMPTY + + + + traniso + The TRANISO system initialization parameter specifies, together with the STGPROT system initialization parameter, whether you want transaction isolation in the CICS region. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + trap + The TRAP system initialization parameter specifies whether the FE global trap exit is to be activated at system initialization. + + + | **required**: False + | **type**: str + | **choices**: OFF, ON + + + + trdumax + The TRDUMAX system initialization parameter specifies the limit on the number of transaction dumps that may be taken per Dump Table entry. + + + | **required**: False + | **type**: int + + + + trtabsz + The TRTABSZ system initialization parameter specifies the size, in kilobytes, of the internal trace table. + + + | **required**: False + | **type**: int + + + + trtransz + The TRTRANSZ system initialization parameter specifies the size, in kilobytes, of the transaction dump trace table. + + + | **required**: False + | **type**: int + + + + trtranty + The TRTRANTY system initialization parameter specifies which trace entries should be copied from the internal trace table to the transaction dump trace table. + + + | **required**: False + | **type**: str + | **choices**: TRAN, ALL + + + + ts + The TS system initialization parameter specifies whether you want to perform a cold start for temporary storage, as well as the number of VSAM buffers and strings to be used for auxiliary temporary storage. + + + | **required**: False + | **type**: str + + + + tsmainlimit + The TSMAINLIMIT system initialization parameter specifies a limit for the storage that is available for main temporary storage queues to use. You can specify an amount of storage in the range 1 - 32768 MB (32 GB), but this amount must not be greater than 25% of the value of the z/OS parameter MEMLIMIT. The default is 64 MB. + + + | **required**: False + | **type**: str + + + + tst + The TST system initialization parameter specifies the temporary storage table suffix. + + + | **required**: False + | **type**: str + + + + udsasze + The UDSASZE system initialization parameter specifies the size of the UDSA. + + + | **required**: False + | **type**: str + + + + uownetql + The UOWNETQL system initialization parameter specifies a qualifier for the NETUOWID for units of work initiated on the local CICS region. + + + | **required**: False + | **type**: str + + + + usertr + The USERTR system initialization parameter specifies whether the main user trace flag is to be set on or off. + + + | **required**: False + | **type**: str + | **choices**: ON, OFF + + + + usrdelay + The USRDELAY system initialization parameter specifies the maximum time, in the range 0 - 10080 minutes (up to seven days), that an eligible user ID and its associated attributes are cached in the CICS region after use. A user ID that is retained in the user table can be reused. + + + | **required**: False + | **type**: int + + + + ussconfig + The USSCONFIG system initialization parameter specifies the name and path of the root directory for configuration files on z/OS UNIX. + + + | **required**: False + | **type**: str + + + + usshome + The USSHOME system initialization parameter specifies the name and path of the root directory for files on z/OS UNIX. + + + | **required**: False + | **type**: str + + + + vtam + The VTAM system initialization parameter specifies whether the z/OS Communications Server access method is to be used. + + + | **required**: False + | **type**: str + | **choices**: YES, NO + + + + vtprefix + The VTPREFIX system initialization parameter specifies the first character to be used for the terminal identifiers (termids) of autoinstalled virtual terminals. + + + | **required**: False + | **type**: str + + + + webdelay + The WEBDELAY system initialization parameter specifies two Web delay periods. + + + | **required**: False + | **type**: str + + + + wlmhealth + The WLMHEALTH system initialization parameter specifies the time interval and the health adjustment value to be used by CICS® on z/OS® Workload Manager Health API (IWM4HLTH) calls, which CICS makes to inform z/OS WLM about the health state of a CICS region. + + + | **required**: False + | **type**: str + + + + wrkarea + The WRKAREA system initialization parameter specifies the number of bytes to be allocated to the common work area (CWA). + + + | **required**: False + | **type**: int + + + + xappc + The XAPPC system initialization parameter specifies whether RACF session security can be used when establishing APPC sessions. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + xcfgroup + The XCFGROUP system initialization parameter specifies the name of the cross-system coupling facility (XCF) group to be joined by this region. + + + | **required**: False + | **type**: str + + + + xcmd + The XCMD system initialization parameter specifies whether you want CICS to perform command security checking, and optionally the RACF resource class name in which you have defined the command security profiles. + + + | **required**: False + | **type**: str + + + + xdb2 + The XDB2 system initialization parameter specifies whether you want CICS to perform DB2ENTRY security checking. + + + | **required**: False + | **type**: str + + + + xdct + The XDCT system initialization parameter specifies whether you want CICS to perform resource security checking for transient data queues. + + + | **required**: False + | **type**: str + + + + xfct + The XFCT system initialization parameter specifies whether you want CICS to perform file resource security checking, and optionally specifies the RACF resource class name in which you have defined the file resource security profiles. + + + | **required**: False + | **type**: str + + + + xhfs + The XHFS system initialization parameter specifies whether CICS is to check the transaction user's ability to access files in the z/OS UNIX System Services file system. + + + | **required**: False + | **type**: str + | **choices**: YES, NO + + + + xjct + The XJCT system initialization parameter specifies whether you want CICS to perform journal resource security checking. + + + | **required**: False + | **type**: str + + + + xlt + The XLT system initialization parameter specifies a suffix for the transaction list table. + + + | **required**: False + | **type**: str + + + + xpct + The XPCT system initialization parameter specifies whether you want CICS to perform started transaction resource security checking, and optionally specifies the name of the RACF resource class name in which you have defined the started task security profiles. + + + | **required**: False + | **type**: str + + + + xppt + The XPPT system initialization parameter specifies that CICS is to perform application program resource security checks and optionally specifies the RACF resource class name in which you have defined the program resource security profiles. + + + | **required**: False + | **type**: str + + + + xpsb + The XPSB system initialization parameter specifies whether you want CICS to perform program specification block (PSB) security checking and optionally specifies the RACF resource class name in which you have defined the PSB security profiles. + + + | **required**: False + | **type**: str + + + + xptkt + The XPTKT system initialization parameter specifies whether CICS checks if a user can generate a PassTicket for the user's userid using the EXEC CICS REQUEST PASSTICKET command, the EXEC CICS REQUEST ENCRYPTPTKT command, or the EXEC FEPI REQUEST PASSTICKET command. + + + | **required**: False + | **type**: str + | **choices**: YES, NO + + + + xres + The XRES system initialization parameter specifies whether you want CICS to perform resource security checking for particular CICS resources and optionally specifies the general resource class name in which you have defined the resource security profiles. + + + | **required**: False + | **type**: str + + + + xrf + The XRF system initialization parameter specifies whether XRF support is to be included in the CICS region. + + + | **required**: False + | **type**: str + | **choices**: NO, YES + + + + xtran + The XTRAN system initialization parameter specifies whether you want CICS to perform transaction security checking and optionally specifies the RACF resource class name in which you have defined the transaction security profiles. + + + | **required**: False + | **type**: str + + + + xtst + The XTST system initialization parameter specifies whether you want CICS to perform security checking for temporary storage queues and optionally specifies the RACF resource class name in which you have defined the temporary storage security profiles. + + + | **required**: False + | **type**: str + + + + xuser + The XUSER system initialization parameter specifies whether CICS is to perform surrogate user checks. + + + | **required**: False + | **type**: str + | **choices**: YES, NO + + + + zosmoninterval + The ZOSMONINTERVAL system initialization parameter specifies the sampling interval, in seconds, for the CICS® z/OS storage monitor task. + + + | **required**: False + | **type**: int + + + + zossos24unalloc + The ZOSSOS24UNALLOC system initialization parameter specifies short-on-storage (SOS) thresholds in KB for the total amount of unallocated z/OS® user region storage and for the largest contiguous storage area available in it. + + + | **required**: False + | **type**: str + + + + zossos31unalloc + The ZOSSOS31UNALLOC system initialization parameter specifies short-on-storage (SOS) thresholds in KB for the total amount of unallocated z/OS® extended user region storage and for the largest contiguous storage area available in it. + + + | **required**: False + | **type**: str + + + + zossos64unalloc + The ZOSSOS64UNALLOC system initialization parameter specifies a short-on-storage (SOS) threshold in MB for the amount of unallocated z/OS® MEMLIMIT storage in the 64-bit addressing range. + + + | **required**: False + | **type**: int + + + + zossosnewtcb + The ZOSSOSNEWTCB system initialization parameter specifies the action that CICS® takes in response to a new open TCB that is being attached directly by CICS when the z/OS® user region storage or extended user region storage is short on storage (SOS). These open TCBs are L8, L9, X8 and X9 TCBs. + + + | **required**: False + | **type**: str + | **choices**: DELAY, NODELAY + + + + +space_primary + The size of the primary space allocated to the CICS startup JCL data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the CICS startup JCL data set is being created. If the CICS startup JCL data set already exists, the option has no effect. + + If this option is not set, the primary space is dynamically calculated based on the size of the generated CICS startup JCL. + + If the target data set is a member in a PDS or PDSE, then this value does not have any effect. + + + | **required**: False + | **type**: int + + + +space_secondary + The size of the secondary space allocated to the CICS startup JCL data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the CICS startup JCL data set is being created. If the CICS startup JCL data set already exists, the option has no effect. + + If this option is not set, the secondary space is dynamically calculated as 10% of the total size of the generated CICS startup JCL. + + If the target data set is a member in a PDS or PDSE, then this value does not have any effect. + + + | **required**: False + | **type**: int + + + +space_type + The unit portion of the CICS startup JCL data set size. Note that this is just the unit; the value for the primary space is specified with \ :literal:`space\_primary`\ and the value for the secondary space is specified with \ :literal:`space\_secondary`\ . + + This option takes effect only when the CICS startup JCL data set is being created. If the CICS startup JCL data set already exists, the option has no effect. + + The size can be specified in megabytes (\ :literal:`M`\ ), kilobytes (\ :literal:`K`\ ), cylinders (\ :literal:`CYL`\ ), or tracks (\ :literal:`TRK`\ ). + + If neither \ :literal:`space\_secondary`\ nor \ :literal:`space\_primary`\ is set, then this value does not have any effect. + + If the target data set is a member in a PDS or PDSE, then this value does not have any effect. + + + | **required**: False + | **type**: str + | **default**: M + | **choices**: M, K, CYL, TRK + + + +state + The intended state for the CICS startup JCL data set, which the module aims to achieve. + + Specify \ :literal:`absent`\ to remove the CICS startup JCL data set entirely, if it already exists. + + Specify \ :literal:`initial`\ to create the CICS startup JCL data set if it does not already exist. + + Specify \ :literal:`warm`\ to retain an existing CICS startup JCL data set in its current state. The module verifies whether the specified data set exists and whether it matches the generated startup JCL. If both conditions are met, the module leaves the data set as is. If the data set does not exist or does not match, the operation fails. + + + | **required**: True + | **type**: str + | **choices**: initial, absent, warm + + + +steplib + Any locations of additional data sets other than \ :literal:`SDFHAUTH`\ , \ :literal:`SDFHLIC`\ , \ :literal:`SCEERUN`\ , or \ :literal:`SCEERUN2`\ , to be added to the STEPLIB concatenation. The STEPLIB concatenation is where you specify the libraries that contain the modules loaded by the z/OS operating system. You can either add data sets at the very top of the list or append them to the bottom of the list. There are other data sets in between, as determined by the defaults or other input parameters; for example, \ :literal:`SEYUAUTH`\ and \ :literal:`SEYULOAD`\ as sepcified with \ :literal:`cpsm\_data\_sets`\ , \ :literal:`SCEERUN`\ and \ :literal:`SCEERUN2`\ as specified with \ :literal:`le\_data\_sets`\ , \ :literal:`SDFHAUTH`\ and \ :literal:`SDFHLIC`\ as specified with \ :literal:`cics\_data\_sets`\ , and so on. + + + | **required**: False + | **type**: dict + + + + data_sets + The \ :literal:`STEPLIB`\ data sets to be added to the bottom of the list. + + + | **required**: False + | **type**: list + + + + top_data_sets + The \ :literal:`STEPLIB`\ data sets to be added to the very top of the list. + + + | **required**: False + | **type**: list + + + + +volumes + The volume(s) where the data set is created. Use a string to define a singular volume or a list of strings for multiple volumes. + + If the target data set is a member in a PDS or PDSE, then this value does not have any effect. + + + | **required**: False + | **type**: raw + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Create CICS startup JCL data set + ibm.ibm_zos_cics.region_jcl: + applid: ABC9ABC1 + cics_data_sets: + template: 'CICSTS61.CICS.<< lib_name >>' + le_data_sets: + template: 'LANG.ENVIORNMENT.<< lib_name >>' + region_data_sets: + template: 'REGIONS.ABC9ABC1.<< data_set_name >>' + sit_parameters: + start: COLD + sit: 6$ + aicons: AUTO + auxtr: 'ON' + auxtrsw: ALL + cicssvc: 217 + csdrecov: BACKOUTONLY + edsalim: 500M + grplist: (DFHLIST,DFHTERML) + gmtext: 'ABC9ABC1. CICS Region' + icvr: 20000 + isc: 'YES' + ircstrt: 'YES' + mxt: 500 + pgaipgm: ACTIVE + sec: 'YES' + spool: 'YES' + srbsvc: 218 + tcpip: 'NO' + usshome: /usshome/directory + wlmhealth: "OFF" + wrkarea: 2048 + sysidnt: ZPY1 + + - name: Create CICS startup JCL data set with more customization + ibm.ibm_zos_cics.region_jcl: + applid: ABC9ABC1 + job_parameters: + class: A + cics_data_sets: + template: 'CICSTS61.CICS.<< lib_name >>' + sdfhauth: 'CICSTS61.OVERRDE.TEMPLT.SDFHAUTH' + le_data_sets: + template: 'LANG.ENVIORNMENT.<< lib_name >>' + region_data_sets: + template: 'REGIONS.ABC9ABC1.<< data_set_name >>' + output_data_sets: + default_sysout_class: B + ceemsg: + sysout: A + sysprint: + omit: True + steplib: + top_data_sets: + - TOP.DATA_SET.ONE + - TOP.DATA_SET.TWO + data_sets: + - BOTTOM.DATA_SET.ONE + sit_parameters: + start: COLD + sit: 6$ + aicons: AUTO + auxtr: 'ON' + auxtrsw: ALL + cicssvc: 217 + csdrecov: BACKOUTONLY + edsalim: 500M + grplist: (DFHLIST,DFHTERML) + gmtext: 'ABC9ABC1. CICS Region' + icvr: 20000 + isc: 'YES' + ircstrt: 'YES' + mxt: 500 + pgaipgm: ACTIVE + stntrxx: + ab: ALL + skrxxxx: + PA21: 'COMMAND' + sec: 'YES' + spool: 'YES' + srbsvc: 218 + tcpip: 'NO' + usshome: /usshome/directory + wlmhealth: "OFF" + wrkarea: 2048 + sysidnt: ZPY1 + + + + + + +See Also +-------- + +.. seealso:: + + - :ref:`stop_cics_module` + + + +Return Values +------------- + + + + + changed + | True if the CICS startup JCL data set was created, otherwise False. + + | **returned**: always + | **type**: bool + + + + failed + | True if the Ansible task failed, otherwise False. + + | **returned**: always + | **type**: bool + + + + start_state + | The state of the CICS startup JCL data set before the Ansible task runs. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the start of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: Sequential + + + + + + exists + | True if the CICS startup JCL data set exists. + + | **returned**: always + | **type**: bool + + + + + + end_state + | The state of the CICS startup JCL data set at the end of the Ansible task. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the end of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: Sequential + + + + + + exists + | True if the CICS startup JCL data set exists. + + | **returned**: always + | **type**: bool + + + + + + jcl + | The CICS startup JCL that is built during module execution. + + | **returned**: always + | **type**: list + + + + executions + | A list of program executions performed during the Ansible task. + + | **returned**: always + | **type**: list + + + + name + | A human-readable name for the program execution. + + | **returned**: always + | **type**: str + + + + rc + | The return code for the program execution. + + | **returned**: always + | **type**: int + + + + stdout + | The standard out stream returned by the program execution. + + | **returned**: always + | **type**: str + + + + stderr + | The standard error stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + + + msg + | A string containing an error message if applicable. + + | **returned**: always + | **type**: str + + diff --git a/_sources/ibm_zos_cics/docs/source/modules/stop_region.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/stop_region.rst.txt new file mode 100644 index 00000000..065132c0 --- /dev/null +++ b/_sources/ibm_zos_cics/docs/source/modules/stop_region.rst.txt @@ -0,0 +1,403 @@ +.. ............................................................................... +.. © Copyright IBM Corporation 2020,2023 . +.. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . +.. ............................................................................... + +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/stop_region.py + +.. _stop_region_module: + + +stop_region -- Stop a CICS region +================================= + + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- Stop a CICS region by issuing a CEMT PERFORM SHUTDOWN command, or by canceling the job through the \ :literal:`jobs.cancel`\ utility provided by Z Open Automation Utilities (ZOAU). You can choose the shutdown mode from NORMAL, IMMEDIATE, or CANCEL. +- The \ :literal:`job\_id`\ , \ :literal:`job\_name`\ , or both can be used to shut down a CICS region. If mulitple jobs are running with the same name, the \ :literal:`job\_id`\ is required. +- During a NORMAL or IMMEDIATE shutdown, a shutdown assist transaction should run to enable CICS to shut down in a controlled manner. By default, the CICS-supplied shutdown assist transaction, CESD is used. You can specify a custom shutdown assist transaction in the SDTRAN system initialization parameter. The task runs until the region has successfully shut down, or until the shutdown fails. +- You must have a console installed in the CICS region so that the stop\_region module can communicate with CICS. To define a console, you must install a terminal with the CONSNAME attribute set to your TSO user ID. For detailed instructions, see \ `Defining TSO users as console devices `__\ . Add your console definition into one of the resource lists defined on the GRPLIST system initialization parameter so that it gets installed into the CICS region. Alternatively, you can use a DFHCSDUP script to update an existing CSD. This function is provided by the csd module. +- You can specify a timeout, in seconds, for CICS shutdown processing. After a request to stop CICS is issued, if CICS shutdown processing is not completed when this timeout is reached, the module completes in a failed state. By default, the stop\_region module does not use a timeout, that is, the \ :literal:`timeout`\ parameter assumes a value of -1. + + + + + +Parameters +---------- + + + +job_id + Identifies the job ID belonging to the running CICS region. + + The stop\_region module uses this job ID to identify the state of the CICS region and shut it down. + + + | **required**: False + | **type**: str + + + +job_name + Identifies the job name belonging to the running CICS region. + + The stop\_region module uses this job name to identify the state of the CICS region and shut it down. + + The \ :literal:`job\_name`\ must be unique; if multiple jobs with the same name are running, use \ :literal:`job\_id`\ . + + + | **required**: False + | **type**: str + + + +mode + Specify the type of shutdown to be executed on the CICS region. + + Specify \ :literal:`normal`\ to perform a normal shutdown. This instructs the stop\_region module to issue a CEMT PERFORM SHUTDOWN command. + + Specify \ :literal:`immediate`\ to perform an immediate shutdown. This instructs the stop\_region module to issue a CEMT PERFORM SHUTDOWN IMMEDIATE command. + + Specify \ :literal:`cancel`\ to cancel the CICS region. This instructs the stop\_region module to use ZOAU's \ :literal:`jobs.cancel`\ utility to process the request. + + + | **required**: False + | **type**: str + | **default**: normal + | **choices**: normal, immediate, cancel + + + +no_sdtran + No shutdown assist transaction is to be run at CICS shutdown. + + + | **required**: False + | **type**: bool + + + +sdtran + The 4-character identifier of the shutdown assist transaction. + + The default shutdown transaction, if neither SDTRAN nor NOSDTRAN is specified, is CESD. + + + | **required**: False + | **type**: str + + + +timeout + The maximum time, in seconds, to wait for CICS shutdown processing to complete. + + Specify -1 to exclude a timeout. + + + | **required**: False + | **type**: int + | **default**: -1 + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: "Stop CICS region using job ID" + ibm.ibm_zos_cics.stop_region: + job_id: JOB12345 + + - name: "Stop CICS region immediately using job ID" + ibm.ibm_zos_cics.stop_region: + job_id: JOB12354 + mode: immediate + + - name: "Stop CICS region using job name and job ID" + ibm.ibm_zos_cics.stop_region: + job_id: JOB12354 + job_name: MYREG01 + + - name: "Stop CICS region using job name" + ibm.ibm_zos_cics.stop_region: + job_name: ANS1234 + mode: normal + + - name: "Cancel CICS region using job name" + ibm.ibm_zos_cics.stop_region: + job_name: ANS1234 + mode: cancel + + + + + + + + + +Return Values +------------- + + + + + changed + | True if the PERFORM SHUTDOWN or CANCEL command was executed. + + | **returned**: always + | **type**: bool + + + + failed + | True if the Ansible task failed, otherwise False. + + | **returned**: always + | **type**: bool + + + + executions + | A list of program executions performed during the Ansible task. + + | **returned**: always + | **type**: list + + + + name + | A human-readable name for the program execution. + + | **returned**: always + | **type**: str + + + + rc + | The return code for the program execution. + + | **returned**: always + | **type**: int + + + + return + | The standard output returned by the program execution. + + | **returned**: always + | **type**: dict + + + + changed + | True if the state was changed, otherwise False. + + | **returned**: always + | **type**: bool + + + + failed + | True if the module failed, otherwise False. + + | **returned**: always + | **type**: bool + + + + jobs + | The output information for a list of jobs matching the specified criteria. + + | **returned**: on zos_job_query module execution + | **type**: list + + + + job_id + | Unique job identifier assigned to the job by JES. + + | **type**: str + + + + job_name + | The name of the batch job. + + | **type**: str + + + + owner + | The owner who ran the job. + + | **type**: str + + + + ret_code + | Return code output collected from the job log. + + | **type**: dict + + + + msg + | Return code or abend resulting from the job submission. + + | **type**: str + + + + msg_code + | Return code extracted from the `msg` so that it can be evaluated. For example, ABEND(S0C4) yields "S0C4". + + | **type**: str + + + + msg_txt + | Returns additional information related to the job. + + | **type**: str + + + + code + | Return code converted to an integer value (when possible). + + | **type**: int + + + + steps + | Series of JCL steps that were executed and their return codes. + + | **type**: list + + + + step_name + | Name of the step shown as "was executed" in the DD section. + + | **type**: str + + + + step_cc + | The CC returned for this step in the DD section. + + | **type**: int + + + + + + + + + + message + | Message returned on failure. + + | **returned**: on zos_job_query module execution + | **type**: str + + + + content + | The resulting text from the command submitted. + + | **returned**: on zos_operator module execution + | **type**: list + + + + cmd + | The operator command that has been executed + + | **returned**: on zos_operator module execution + | **type**: str + + + + rc + | The return code from the operator command + + | **returned**: on zos_operator module execution + | **type**: int + + + + max_rc + | The maximum return code from the TSO status command + + | **returned**: on zos_tso_command module execution + | **type**: int + + + + output + | The output from the TSO command. + + | **returned**: on zos_tso_command module execution + | **type**: list + + + + command + | The executed TSO command. + + | **returned**: always + | **type**: str + + + + rc + | The return code from the executed TSO command. + + | **returned**: always + | **type**: int + + + + content + | The response resulting from the execution of the TSO command. + + | **returned**: always + | **type**: list + + + + lines + | The line number of the content. + + | **returned**: always + | **type**: int + + + + + + + + + + msg + | A string containing an error message if applicable. + + | **returned**: always + | **type**: str + + diff --git a/_sources/ibm_zos_cics/docs/source/modules/td_intrapartition.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/td_intrapartition.rst.txt new file mode 100644 index 00000000..bf22970c --- /dev/null +++ b/_sources/ibm_zos_cics/docs/source/modules/td_intrapartition.rst.txt @@ -0,0 +1,330 @@ +.. ............................................................................... +.. © Copyright IBM Corporation 2020,2023 . +.. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . +.. ............................................................................... + +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/td_intrapartition.py + +.. _td_intrapartition_module: + + +td_intrapartition -- Create and remove the CICS transient data intrapartition data set +====================================================================================== + + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- Create and remove the \ `transient data intrapartition `__\ data set used by a CICS® region. This data set holds all the data for intrapartition queues. +- You can use this module when provisioning or de-provisioning a CICS region. +- Use the \ :literal:`state`\ option to specify the intended state for the transient data intrapartition data set. For example, use \ :literal:`state=initial`\ to create a transient data intrapartition data set if it doesn't exist. + + + + + +Parameters +---------- + + + +region_data_sets + The location of the region data sets to be created by using a template, for example, \ :literal:`REGIONS.ABCD0001.\<\< data\_set\_name \>\>`\ . + + If you want to use a data set that already exists, ensure that the data set is a transient data intrapartition data set. + + + | **required**: True + | **type**: dict + + + + dfhintra + Overrides the templated location for the transient data intrapartition data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of the transient data intrapartition to override the template. + + + | **required**: False + | **type**: str + + + + + template + The base location of the region data sets with a template. + + + | **required**: False + | **type**: str + + + + +space_primary + The size of the primary space allocated to the transient data intrapartition data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the transient data intrapartition data set is being created. If the data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 100 + + + +space_secondary + The size of the secondary space allocated to the transient data intrapartition data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the transient data intrapartition data set is being created. If the data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 10 + + + +space_type + The unit portion of the transient data intrapartition data set size. Note that this is just the unit; the value for the primary space is specified with \ :literal:`space\_primary`\ and the value for the secondary space is specified with \ :literal:`space\_secondary`\ . + + This option takes effect only when the transient data intrapartition data set is being created. If the data set already exists, the option has no effect. + + The size can be specified in megabytes (\ :literal:`M`\ ), kilobytes (\ :literal:`K`\ ), records (\ :literal:`REC`\ ), cylinders (\ :literal:`CYL`\ ), or tracks (\ :literal:`TRK`\ ). + + + | **required**: False + | **type**: str + | **default**: REC + | **choices**: M, K, REC, CYL, TRK + + + +state + The intended state for the transient data intrapartition data set, which the module aims to achieve. + + Specify \ :literal:`absent`\ to remove the transient data intrapartition data set entirely, if it exists. + + Specify \ :literal:`initial`\ to create the transient data intrapartition data set if it does not exist. If the specified data set exists but is empty, the module leaves the data set as is. If the specified data set exists and has contents, the module deletes the data set and then creates a new, empty one. + + Specify \ :literal:`warm`\ to retain an existing transient data intrapartition data set in its current state. The module verifies whether the specified data set exists and whether it contains any records. If both conditions are met, the module leaves the data set as is. If the data set does not exist or if it is empty, the operation fails. + + + | **required**: True + | **type**: str + | **choices**: initial, absent, warm + + + +volumes + The volume(s) where the data set is created. Use a string to define a singular volume or a list of strings for multiple volumes. + + + | **required**: False + | **type**: raw + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Initialize a transient data intrapartition data set by using the templated location + ibm.ibm_zos_cics.td_intrapartition: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "initial" + + - name: Initialize a user specified transient data intrapartition data set + ibm.ibm_zos_cics.td_intrapartition: + region_data_sets: + dfhintra: + dsn: "REGIONS.ABCD0001.DFHINTRA" + state: "initial" + + - name: Initialize a large transient data intrapartition data set by using the templated location + ibm.ibm_zos_cics.td_intrapartition: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + space_primary: 50 + space_type: "M" + state: "initial" + + - name: Retain the existing state of a transient data intrapartition data set data set defined by the template + ibm.ibm_zos_cics.td_intrapartition: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "warm" + + - name: Retain the existing state of a user specified transient data intrapartition data set + ibm.ibm_zos_cics.td_intrapartition: + region_data_sets: + dfhintra: + dsn: "REGIONS.ABCD0001.DFHINTRA" + state: "warm" + + - name: Delete a transient data intrapartition data set data set defined by the template + ibm.ibm_zos_cics.td_intrapartition: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "absent" + + - name: Delete a user specified transient data intrapartition data set + ibm.ibm_zos_cics.td_intrapartition: + region_data_sets: + dfhintra: + dsn: "REGIONS.ABCD0001.DFHINTRA" + state: "absent" + + + + + + + + + +Return Values +------------- + + + + + changed + | True if the state was changed, otherwise False. + + | **returned**: always + | **type**: bool + + + + failed + | True if the Ansible task failed, otherwise False. + + | **returned**: always + | **type**: bool + + + + start_state + | The state of the transient data intrapartition data set before the Ansible task runs. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the start of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + exists + | True if the specified transient data intrapartition data set exists. + + | **returned**: always + | **type**: bool + + + + + + end_state + | The state of the transient data intrapartition data set at the end of the Ansible task. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the end of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: VSAM + + + + + + exists + | True if the specified transient data intrapartition data set exists. + + | **returned**: always + | **type**: bool + + + + + + executions + | A list of program executions performed during the Ansible task. + + | **returned**: always + | **type**: list + + + + name + | A human-readable name for the program execution. + + | **returned**: always + | **type**: str + + + + rc + | The return code for the program execution. + + | **returned**: always + | **type**: int + + + + stdout + | The standard output stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + stderr + | The standard error stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + + + msg + | A string containing an error message if applicable + + | **returned**: always + | **type**: str + + diff --git a/_sources/ibm_zos_cics/docs/source/modules/transaction_dump.rst.txt b/_sources/ibm_zos_cics/docs/source/modules/transaction_dump.rst.txt new file mode 100644 index 00000000..f8bf3d49 --- /dev/null +++ b/_sources/ibm_zos_cics/docs/source/modules/transaction_dump.rst.txt @@ -0,0 +1,413 @@ +.. ............................................................................... +.. © Copyright IBM Corporation 2020,2023 . +.. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . +.. ............................................................................... + +:github_url: https://github.com/ansible-collections/ibm_zos_cics/blob/main/plugins/modules/transaction_dump.py + +.. _transaction_dump_module: + + +transaction_dump -- Allocate transaction dump data sets +======================================================= + + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- Allocates the two \ `transaction dump `__\ data sets used by a CICS® region. +- The two data sets are referred to as transaction dump data set A (DFHDMPA) and transaction dump data set B (DFHDMPB). + + + + + +Parameters +---------- + + + +destination + Identifies which one of the transaction dump data sets is the target of the operation. If the value is left blank, A is implied, but you can specify A or B. + + Specify \ :literal:`A`\ to create or delete the A data set. + + Specify \ :literal:`B`\ to create or delete the B data set. This MUST be set for the creation of the B data set. + + + | **required**: False + | **type**: str + | **default**: A + | **choices**: A, B + + + +region_data_sets + The location of the region data sets to be created by using a template, for example, \ :literal:`REGIONS.ABCD0001.\<\< data\_set\_name \>\>`\ . + + + | **required**: True + | **type**: dict + + + + dfhdmpa + Overrides the templated location for the DFHDMPA data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of DFHDMPA to override the template. + + + | **required**: False + | **type**: str + + + + + dfhdmpb + Overrides the templated location for the DFHDMPB data set. + + + | **required**: False + | **type**: dict + + + + dsn + The data set name of DFHDMPB to override the template. + + + | **required**: False + | **type**: str + + + + + template + The base location of the region data sets with a template. + + + | **required**: False + | **type**: str + + + + +space_primary + The size of the primary space allocated to the transaction dump data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the transaction dump data set is being created. If the data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 20 + + + +space_secondary + The size of the secondary space allocated to the transaction dump data set. Note that this is just the value; the unit is specified with \ :literal:`space\_type`\ . + + This option takes effect only when the transaction dump data set is being created. If the data set already exists, the option has no effect. + + + | **required**: False + | **type**: int + | **default**: 4 + + + +space_type + The unit portion of the transaction dump data set size. Note that this is just the unit; the value for the primary space is specified with \ :literal:`space\_primary`\ and the value for the secondary space is specified with \ :literal:`space\_secondary`\ . + + This option takes effect only when the transaction dump data set is being created. If the data set already exists, the option has no effect. + + The size can be specified in megabytes (\ :literal:`M`\ ), kilobytes (\ :literal:`K`\ ), cylinders (\ :literal:`CYL`\ ), or tracks (\ :literal:`TRK`\ ). + + + | **required**: False + | **type**: str + | **default**: M + | **choices**: M, K, CYL, TRK + + + +state + The intended state for the transaction dump data set, which the module aims to achieve. + + Specify \ :literal:`absent`\ to remove the transaction dump data set entirely, if it exists. + + Specify \ :literal:`initial`\ to create the transaction dump data set if it does not exist. If the specified data set exists but is empty, the module leaves the data set as is. If the specified data set exists and has contents, the module deletes the data set and then creates a new, empty one. + + Specify \ :literal:`warm`\ to retain an existing transaction dump data set in its current state. The module verifies whether the specified data set exists and whether it contains any records. If both conditions are met, the module leaves the data set as is. If the data set does not exist or if it is empty, the operation fails. + + + | **required**: True + | **type**: str + | **choices**: initial, absent, warm + + + +volumes + The volume(s) where the data set is created. Use a string to define a singular volume or a list of strings for multiple volumes. + + + | **required**: False + | **type**: raw + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Allocate transaction dump data set A (implicit) by using the templated location + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: initial + + - name: Allocate a user specified data set as transaction dump data set A (implicit) + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + dfhdmpa: + dsn: "REGIONS.ABCD0001.DFHDMPA" + state: initial + + - name: Allocate transaction dump data set A by using the templated location + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: initial + destination: A + + - name: Allocate a user specified data set as transaction dump data set A + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + dfhdmpa: + dsn: "REGIONS.ABCD0001.DFHDMPA" + state: initial + destination: A + + - name: Allocate transaction dump data set B by using the templated location + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: initial + destination: B + + - name: Allocate a user specified data set as transaction dump data set B + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + dfhdmpb: + dsn: "REGIONS.ABCD0001.DFHDMPB" + state: initial + destination: B + + - name: Retain the existing state of transaction dump data set A (implicit) defined by the template + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "warm" + + - name: Retain the existing state of a user specified transaction dump data set A (implicit) + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + dfhdmpa: + dsn: "REGIONS.ABCD0001.DFHDMPA" + state: "warm" + + - name: Retain the existing state of transaction dump data set B defined by the template + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: "warm" + destination: B + + - name: Retain the existing state of a user specified transaction dump data set B + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + dfhdmpb: + dsn: "REGIONS.ABCD0001.DFHDMPB" + state: "warm" + destination: B + + - name: Delete transaction dump data set A (implicit) defined by the template + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: absent + + - name: Delete a user specified transaction dump data set A (implicit) + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + dfhdmpa: + dsn: "REGIONS.ABCD0001.DFHDMPA" + state: absent + + - name: Delete transaction dump data set B defined by the template + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + template: "REGIONS.ABCD0001.<< data_set_name >>" + state: absent + destination: B + + - name: Delete a user specified transaction dump data set B + ibm.ibm_zos_cics.transaction_dump: + region_data_sets: + dfhdmpb: + dsn: "REGIONS.ABCD0001.DFHDMPB" + state: absent + destination: B + + + + + + + + + +Return Values +------------- + + + + + changed + | True if the state was changed, otherwise False. + + | **returned**: always + | **type**: bool + + + + failed + | True if the Ansible task failed, otherwise False. + + | **returned**: always + | **type**: bool + + + + start_state + | The state of the transaction dump data set before the Ansible task runs. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the start of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: Sequential + + + + + + exists + | True if the specified transaction dump data set exists. + + | **returned**: always + | **type**: bool + + + + + + end_state + | The state of the transaction dump data set at the end of the Ansible task. + + | **returned**: always + | **type**: dict + + + + data_set_organization + | The organization of the data set at the end of the Ansible task. + + | **returned**: always + | **type**: str + | **sample**: Sequential + + + + + + exists + | True if the specified transaction dump data set exists. + + | **returned**: always + | **type**: bool + + + + + + executions + | A list of program executions performed during the Ansible task. + + | **returned**: always + | **type**: list + + + + name + | A human-readable name for the program execution. + + | **returned**: always + | **type**: str + + + + rc + | The return code for the program execution. + + | **returned**: always + | **type**: int + + + + stdout + | The standard output stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + stderr + | The standard error stream returned from the program execution. + + | **returned**: always + | **type**: str + + + + + + msg + | A string containing an error message if applicable + + | **returned**: always + | **type**: str + + diff --git a/_sources/ibm_zos_cics/docs/source/release_notes.rst.txt b/_sources/ibm_zos_cics/docs/source/release_notes.rst.txt index 8b26d087..6c9c2095 100644 --- a/_sources/ibm_zos_cics/docs/source/release_notes.rst.txt +++ b/_sources/ibm_zos_cics/docs/source/release_notes.rst.txt @@ -1,5 +1,5 @@ .. ............................................................................... -.. © Copyright IBM Corporation 2020,2023 . +.. © Copyright IBM Corporation 2020,2024 . .. Apache License, Version 2.0 (see https://opensource.org/licenses/Apache-2.0) . .. ............................................................................... @@ -7,6 +7,141 @@ Releases ======== +Version 2.1.0 +============= +What's New +------------------- + +**New modules** + +**General Availability of CICS provisioning modules.** You can use these Ansible modules to create automation tasks that provision or deprovision, and start or stop +a CICS region. Sample playbooks show you how to do this with the latest version of the Ansible IBM z/OS CICS collection. All modules were initially released +with Version 1.1.0-beta as noted below. Subsequent Version 1.1.0-beta releases may include enhancements and bugfixes for these modules. Refer to the What's new +of Version 1.1.0-beta releases for details. + +You can use the following modules for provisioning and managing CICS TS data sets: + +* ``aux_temp_storage`` for the CICS auxiliary temporary storage data set. This module was initially + released as ``auxiliary_temp`` with Version 1.1.0-beta.4. The module is changed to ``aux_temp_storage`` in Version 2.1.0. +* ``aux_trace`` for the CICS auxiliary trace data sets. This module was initially released as ``trace`` with Version 1.1.0-beta.4. + The module is changed to ``aux_trace`` in Version 2.1.0. +* ``csd`` for the CICS system definition data set. This module was initially released with Version 1.1.0-beta.4. +* ``global_catalog`` for the CICS global catalog data set. This module was initially released with Version 1.1.0-beta.4. +* ``local_request_queue`` for the CICS local request queue data set. This module was initially released with Version 1.1.0-beta.3. +* ``td_intrapartition`` for the CICS transient data intrapartition data set. This module was initially released as ``intrapartition`` with + Version 1.1.0-beta.4. The module is changed to ``td_intrapartition`` in Version 2.1.0. +* ``transaction_dump`` for the CICS transaction dump data sets. This module was initially released with Version 1.1.0-beta.4. + +You can use the following modules for CICS startup and shutdown operations: + +* ``region_jcl`` - Create a CICS startup JCL data set. This module replaces ``start_cics``, which was released with Version 1.1.0-beta.5. + ``region_jcl`` is significantly different from ``start_cics`` in function. ``region_jcl`` creates a data set that contains the startup JCL, but + doesn't perform the actual startup processing. ``region_jcl`` also supports definition and allocation of user data sets with the ``user_data_sets`` parameter. +* ``stop_region`` - Stop a CICS region. This module was initially released as ``stop_cics`` with Version 1.1.0-beta.5. The module is changed to ``stop_region`` + in Version 2.1.0. In Version 2.1.0, ``stop_region`` supports a new input parameter, ``job_name`` so that you can use the job name, which is typically the CICS's + APPLID, to identify a running CICS region. + +The group name for the CICS provisioning modules is ``region``. However, in the Version 1.1.0-beta releases, the group name was ``region_group``. + +CICS provisioning modules provide support for all in-service CICS TS releases including the latest CICS TS 6.2. + +**Changed modules** + +The group name for the CMCI modules is changed to ``cmci`` instead of ``cmci_group``. ``cmci_group`` is deprecated. + +**New playbooks** + +Sample playbooks are available at the `samples repository`_. The CICS provisioning playbook samples demonstrate how to configure and allocate the required +data sets to provision and start a CICS region, with or without SMSS support. The deprovisioning sample shows how to stop a running region and delete all +the associated data sets. + +Version 2.0.0 +============= +What's New +------------------- + +* **Removed support for Python 2.7.** Python 2.7 is no longer supported as the managed node runtime. + +Version 1.1.0-beta.5 +============= +What's New +------------------- + +**New modules** + +* ``start_cics`` - Start a CICS region. +* ``stop_cics`` - Stop a CICS region. + +**Changed modules** + +* ``csd`` - A new ``state`` option, ``script`` is introduced so that you can now supply a script that contains ``CSDUP`` commands to update an existing CSD. The script can be either a data set or a z/OS UNIX file. +* All modules for CICS region data sets - New option ``space_secondary`` is introduced so that you can specify the size of the secondary extent. +* All modules for CICS region data sets - Return values now use ``data_set_organization`` to indicate the organization of the data set. The ``vsam`` field has been removed from the return structure. + + +Version 1.1.0-beta.4 +============= +What's New +------------------- + +**New modules** + +* ``auxiliary_temp`` - Create and remove the CICS auxiliary temporary storage data set. +* ``csd`` - Create, remove, and manage the CICS system definition data set. +* ``intrapartition`` - Create and remove the CICS transient data intrapartition data set. +* ``trace`` - Allocate the CICS auxiliary trace data sets. +* ``transaction_dump`` - Allocate the CICS transaction dump data sets. + +**Changed modules** + +* ``local_request_queue`` - New option ``warm`` added to the ``state`` input parameter. + +**Bugfixes** + +* ``local_request_queue`` and ``local_request_queue`` - The behavior of these modules with ``state`` set to ``initial`` is updated to match documentation. + +Version 1.1.0-beta.3 +============= +What's New +------------------- + +**New modules** + +* ``local_request_queue`` - Create and remove the CICS local request queue data set. + +**Changed modules** + +* ``global_catalog`` and ``local_catalog`` - Added support for the ``region_data_sets`` and ``cics_data_sets`` defaults groups. This enhancement changes the way you specify the data set location for these modules. + +Version 1.1.0-beta.2 +============= +What's New +------------------- + +**New modules** + +* ``local_catalog`` - Create, initialize, and manage the CICS local catalog data set. + +**Changed modules** + +* ``global_catalog`` - Added return values ``start_state``, ``end_state``, and ``executions``. + +**Bugfixes** + +* ``global_catalog`` - Fixed an issue that when input parameters were lowercase, the module failed. Now these input parameters are not case sensitive. +* ``global_catalog`` - Fixed an issue that was found in the ``changed`` flag. Now the ``changed`` flag corresponds with the actions taken during the ``global_catalog`` execution. + + +Version 1.1.0-beta.1 +============= +What's New +------------------- + +**New modules** + +* ``global_catalog`` - Create, initialize, and manage the CICS global catalog data set. + + Version 1.0.5 ============= What's New @@ -48,25 +183,25 @@ Initial release of the **IBM® z/OS® CICS® collection**, also referred to as * This collection can manage CICS and CICSPlex® SM resources and definitions by calling the `CMCI REST API`_, which can be configured in a CICSplex or in a stand-alone region. -* Modules +**Modules** - * ``cmci_create`` - Create definitional CICS and CICSPlex SM resources in CICS regions, by initiating POST requests via the CMCI REST API. - * ``cmci_delete`` - Remove or discard definitional and installed CICS and CICSPlex SM resources from CICS regions, by initiating DELETE requests via the CMCI REST API. - * ``cmci_get`` - Retrieve information about installed and definitional CICS and CICSPlex SM resources from CICS regions, by initiating GET requests via the CMCI REST API. - * ``cmci_action`` - Install CICS and CICSPlex SM resources into CICS regions from definitions, by initiating PUT requests via the CMCI REST API. - * ``cmci_update`` - Make changes to CICS and CICSPlex SM resources in CICS regions, by initiating PUT requests via the CMCI REST API. +* ``cmci_create`` - Create definitional CICS and CICSPlex SM resources in CICS regions, by initiating POST requests via the CMCI REST API. +* ``cmci_delete`` - Remove or discard definitional and installed CICS and CICSPlex SM resources from CICS regions, by initiating DELETE requests via the CMCI REST API. +* ``cmci_get`` - Retrieve information about installed and definitional CICS and CICSPlex SM resources from CICS regions, by initiating GET requests via the CMCI REST API. +* ``cmci_action`` - Install CICS and CICSPlex SM resources into CICS regions from definitions, by initiating PUT requests via the CMCI REST API. +* ``cmci_update`` - Make changes to CICS and CICSPlex SM resources in CICS regions, by initiating PUT requests via the CMCI REST API. -* Documentation +**Documentation** - * Generic documentation is available at `the documentation site`_, covering guidance on installation, modules, and other reference. +* Generic documentation is available at `the documentation site`_, covering guidance on installation, modules, and other reference. - * Documentation related to playbook configuration is provided with sample playbooks at the `samples repository`_. Each playbook contains a README that explains what configurations must be made to run a sample playbook. +* Documentation related to playbook configuration is provided with sample playbooks at the `samples repository`_. Each playbook contains a README that explains what configurations must be made to run a sample playbook. -* Playbooks +**Playbooks** - * Sample playbooks are available at the `samples repository`_. Each playbook contains a README that explains what configurations must be made to run a sample playbook. +* Sample playbooks are available at the `samples repository`_. Each playbook contains a README that explains what configurations must be made to run a sample playbook. .. _samples repository: https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_subsystems/cics diff --git a/_sources/ibm_zos_cics/docs/source/requirements_managed.rst.txt b/_sources/ibm_zos_cics/docs/source/requirements_managed.rst.txt index 0f7c482d..38b6312d 100644 --- a/_sources/ibm_zos_cics/docs/source/requirements_managed.rst.txt +++ b/_sources/ibm_zos_cics/docs/source/requirements_managed.rst.txt @@ -1,10 +1,17 @@ .. ........................................................................... -.. © Copyright IBM Corporation 2020,2021 . +.. © Copyright IBM Corporation 2020,2024 . .. ........................................................................... Requirements of managed nodes ============================= +The tasks in the **IBM® z/OS® CICS® collection** can be classified into two types, +**CMCI tasks** and **provisioning tasks**, that have different requirements of the managed +node. + +CMCI tasks +---------- + The CMCI tasks in the **IBM® z/OS® CICS® collection** interact with the managed node over an HTTP connection by leveraging the `CMCI REST API`_. Therefore, an SSH connection is not required. Instead, you can delegate @@ -15,52 +22,36 @@ For more ways of delegating tasks, see `Controlling where tasks run`_. The requirements of the managed node are as follows: -* IBM CICS V4.2 or later +* z/OS Version 2.3 or later +* All IBM CICS TS releases that are in service * A `CMCI connection`_ must be set up in either a CICSplex or a stand-alone CICS region * Python module dependencies: * `requests`_ * `xmltodict`_ - * `typing`_ (For Python versions < 3.5) If you delegate the tasks to run on your localhost, the Python module dependencies need to be installed on your localhost instead. - You can install them from CLI: - - * If your Python version is no less than 3.5: - - .. code-block:: sh + You can install them from the CLI by using the following command: - pip install requests xmltodict - - * If your Python version < 3.5: - - .. code-block:: sh - - pip install requests xmltodict typing + .. code-block:: sh + pip install requests xmltodict You can also install them using the playbook. For example, this `CICS - sample playbook`_ shows how you can ensure the pre-requisites are installed before the module is executed. + sample playbook`_ shows how you can ensure that the prerequisites are installed before the module is executed. .. _requests: https://pypi.org/project/requests/ .. _xmltodict: https://pypi.org/project/xmltodict/ - -.. _typing: - https://pypi.org/project/typing/ - .. _CICS sample playbook: https://github.com/IBM/z_ansible_collections_samples/tree/main/zos_subsystems/cics/cmci/reporting - -If you use the CICS collection in conjunction with other IBM z/OS collections, -your managed node must also follow the requirements of those collections, for example, `IBM z/OS core managed node requirements`_. - -If you use the CICS collection alone but don't delegate the CICS tasks to your localhost, your managed node must also follow the `IBM z/OS core managed node requirements`_ except that IBM Z Open Automation Utilities (ZOAU) is not required. +If you use the CMCI tasks in the CICS collection but don't delegate the CMCI tasks to your localhost, your +managed node must also follow the `IBM z/OS core managed node requirements`_ except that IBM Z Open Automation Utilities (ZOAU) is not required. .. _z/OS OpenSSH: https://www.ibm.com/docs/en/zos/latest?topic=descriptions-zos-openssh @@ -75,3 +66,25 @@ If you use the CICS collection alone but don't delegate the CICS tasks to your l https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/source/requirements_managed.html .. _Controlling where tasks run: https://docs.ansible.com/ansible/latest/user_guide/playbooks_delegation.html#delegating-tasks + + +Provisioning tasks +------------------ + +The provisioning tasks in the **IBM® z/OS® CICS® collection** interact with a +z/OS managed node over SSH, and therefore have different requirements to the +CMCI tasks. The provisioning modules follow the requirements of the other z/OS +collections as documented in `IBM z/OS core managed node requirements`_. These +requirements include installation of the following components: + +* z/OS Version 2.3 or later +* z/OS OpenSSH +* IBM Open Enterprise SDK for Python (previously IBM Open Enterprise Python for z/OS) +* IBM Z Open Automation Utilities (ZOAU) 1.2.x +* The z/OS shell + +For specific versions of these dependencies and additional information, review +the `IBM z/OS core managed node requirements`_ page. + +Note that you must have z/OS core collection 1.5.0 or later installed in the control node +if you want to run the provisioning tasks. diff --git a/_sources/ibm_zos_core/docs/source/filters.rst.txt b/_sources/ibm_zos_core/docs/source/filters.rst.txt index 51e3a034..bbf24c6d 100644 --- a/_sources/ibm_zos_core/docs/source/filters.rst.txt +++ b/_sources/ibm_zos_core/docs/source/filters.rst.txt @@ -5,13 +5,9 @@ Filters ======= -Filters in Ansible are from Jinja2, and are used to transform data inside -a template expression. The templates operate on the Ansible controller, and not -on the target host. Therefore, filters execute on the controller as they augment -the data locally. - -Jinja2 ships with many filters as does Ansible, and also allows users to add -their own custom filters. +Filters are used to transform data inside a template expression. The templates +operate on the Ansible controller, not on the managed node. Therefore, +filters execute on the controller as they augment the data locally. The **IBM z/OS core collection** includes filters and their usage in sample playbooks. Unlike collections that can be identified at the top level using the diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_apf.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_apf.rst.txt index 195b3461..a94fdc95 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_apf.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_apf.rst.txt @@ -54,6 +54,7 @@ force_dynamic | **required**: False | **type**: bool + | **default**: False volume @@ -61,7 +62,7 @@ volume 1. The volume serial number. - 2. Six asterisks (******), indicating that the system must use the volume serial number of the current system residence (SYSRES) volume. + 2. Six asterisks ``******``, indicating that the system must use the volume serial number of the current system residence (SYSRES) volume. 3. *MCAT*, indicating that the system must use the volume serial number of the volume containing the master catalog. @@ -78,6 +79,7 @@ sms | **required**: False | **type**: bool + | **default**: False operation @@ -144,6 +146,7 @@ persistent | **required**: False | **type**: bool + | **default**: False backup_name @@ -186,7 +189,7 @@ batch 1. The volume serial number - 2. Six asterisks (******), indicating that the system must use the volume serial number of the current system residence (SYSRES) volume. + 2. Six asterisks ``******``, indicating that the system must use the volume serial number of the current system residence (SYSRES) volume. 3. *MCAT*, indicating that the system must use the volume serial number of the volume containing the master catalog. @@ -203,6 +206,7 @@ batch | **required**: False | **type**: bool + | **default**: False @@ -221,7 +225,7 @@ Examples - name: Add a library (cataloged) to the APF list and persistence zos_apf: library: SOME.SEQUENTIAL.DATASET - force_dynamic: True + force_dynamic: true persistent: data_set_name: SOME.PARTITIONED.DATASET(MEM) - name: Remove a library from the APF list and persistence @@ -239,7 +243,7 @@ Examples batch: - library: SOME.SEQ.DS1 - library: SOME.SEQ.DS2 - sms: True + sms: true - library: SOME.SEQ.DS3 volume: T12345 - name: Print the APF list matching library pattern or volume serial number diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_archive.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_archive.rst.txt index 03eaafba..f2971fc6 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_archive.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_archive.rst.txt @@ -78,7 +78,7 @@ format | **required**: False | **type**: str - | **choices**: PACK, SPACK + | **choices**: pack, spack xmit_log_data_set @@ -99,6 +99,7 @@ format | **required**: False | **type**: bool + | **default**: False @@ -180,6 +181,7 @@ remove | **required**: False | **type**: bool + | **default**: False dest_data_set @@ -201,8 +203,8 @@ dest_data_set | **required**: False | **type**: str - | **default**: SEQ - | **choices**: SEQ + | **default**: seq + | **choices**: seq space_primary @@ -226,21 +228,21 @@ dest_data_set space_type If the destination data set does not exist, this sets the unit of measurement to use when defining primary and secondary space. - Valid units of size are ``K``, ``M``, ``G``, ``CYL``, and ``TRK``. + Valid units of size are ``k``, ``m``, ``g``, ``cyl``, and ``trk``. | **required**: False | **type**: str - | **choices**: K, M, G, CYL, TRK + | **choices**: k, m, g, cyl, trk record_format If the destination data set does not exist, this sets the format of the data set. (e.g ``FB``) - Choices are case-insensitive. + Choices are case-sensitive. | **required**: False | **type**: str - | **choices**: FB, VB, FBA, VBA, U + | **choices**: fb, vb, fba, vba, u record_length @@ -326,6 +328,7 @@ force | **required**: False | **type**: bool + | **default**: False @@ -339,7 +342,7 @@ Examples # Simple archive - name: Archive file into a tar zos_archive: - path: /tmp/archive/foo.txt + src: /tmp/archive/foo.txt dest: /tmp/archive/foo_archive_test.tar format: name: tar @@ -347,7 +350,7 @@ Examples # Archive multiple files - name: Compress list of files into a zip zos_archive: - path: + src: - /tmp/archive/foo.txt - /tmp/archive/bar.txt dest: /tmp/archive/foo_bar_archive_test.zip @@ -357,7 +360,7 @@ Examples # Archive one data set into terse - name: Compress data set into a terse zos_archive: - path: "USER.ARCHIVE.TEST" + src: "USER.ARCHIVE.TEST" dest: "USER.ARCHIVE.RESULT.TRS" format: name: terse @@ -365,18 +368,18 @@ Examples # Use terse with different options - name: Compress data set into a terse, specify pack algorithm and use adrdssu zos_archive: - path: "USER.ARCHIVE.TEST" + src: "USER.ARCHIVE.TEST" dest: "USER.ARCHIVE.RESULT.TRS" format: name: terse format_options: - terse_pack: "SPACK" - use_adrdssu: True + terse_pack: "spack" + use_adrdssu: true # Use a pattern to store - name: Compress data set pattern using xmit zos_archive: - path: "USER.ARCHIVE.*" + src: "USER.ARCHIVE.*" exclude_sources: "USER.ARCHIVE.EXCLUDE.*" dest: "USER.ARCHIVE.RESULT.XMIT" format: diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_backup_restore.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_backup_restore.rst.txt index 7c9a8a87..69ca57cd 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_backup_restore.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_backup_restore.rst.txt @@ -103,6 +103,7 @@ full_volume | **required**: False | **type**: bool + | **default**: False temp_volume @@ -130,6 +131,7 @@ recover | **required**: False | **type**: bool + | **default**: False overwrite @@ -139,6 +141,7 @@ overwrite | **required**: False | **type**: bool + | **default**: False sms_storage_class @@ -179,13 +182,13 @@ space space_type The unit of measurement to use when defining data set space. - Valid units of size are ``K``, ``M``, ``G``, ``CYL``, and ``TRK``. + Valid units of size are ``k``, ``m``, ``g``, ``cyl``, and ``trk``. - When *full_volume=True*, *space_type* defaults to ``G``, otherwise default is ``M`` + When *full_volume=True*, *space_type* defaults to ``g``, otherwise default is ``m`` | **required**: False | **type**: str - | **choices**: K, M, G, CYL, TRK + | **choices**: k, m, g, cyl, trk hlq @@ -197,6 +200,15 @@ hlq | **type**: str +tmp_hlq + Override the default high level qualifier (HLQ) for temporary and backup data sets. + + The default HLQ is the Ansible user that executes the module and if that is not available, then the value of ``TMPHLQ`` is used. + + | **required**: False + | **type**: str + + Examples @@ -229,7 +241,7 @@ Examples data_sets: include: user.** backup_name: /tmp/temp_backup.dzp - recover: yes + recover: true - name: Backup all datasets matching the pattern USER.** to data set MY.BACKUP.DZP, allocate 100MB for data sets used in backup process. @@ -239,7 +251,7 @@ Examples include: user.** backup_name: MY.BACKUP.DZP space: 100 - space_type: M + space_type: m - name: Backup all datasets matching the pattern USER.** that are present on the volume MYVOL1 to data set MY.BACKUP.DZP, @@ -251,7 +263,7 @@ Examples volume: MYVOL1 backup_name: MY.BACKUP.DZP space: 100 - space_type: M + space_type: m - name: Backup an entire volume, MYVOL1, to the UNIX file /tmp/temp_backup.dzp, allocate 1GB for data sets used in backup process. @@ -259,9 +271,9 @@ Examples operation: backup backup_name: /tmp/temp_backup.dzp volume: MYVOL1 - full_volume: yes + full_volume: true space: 1 - space_type: G + space_type: g - name: Restore data sets from backup stored in the UNIX file /tmp/temp_backup.dzp. Use z/OS username as new HLQ. @@ -302,10 +314,10 @@ Examples zos_backup_restore: operation: restore volume: MYVOL2 - full_volume: yes + full_volume: true backup_name: MY.BACKUP.DZP space: 1 - space_type: G + space_type: g - name: Restore data sets from backup stored in the UNIX file /tmp/temp_backup.dzp. Specify DB2SMS10 for the SMS storage and management classes to use for the restored diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_blockinfile.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_blockinfile.rst.txt index e1e11486..f3eef596 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_blockinfile.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_blockinfile.rst.txt @@ -124,6 +124,7 @@ backup | **required**: False | **type**: bool + | **default**: False backup_name @@ -171,6 +172,7 @@ force | **required**: False | **type**: bool + | **default**: False indentation @@ -178,6 +180,7 @@ indentation | **required**: False | **type**: int + | **default**: 0 diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_copy.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_copy.rst.txt index 004671eb..611f5136 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_copy.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_copy.rst.txt @@ -41,6 +41,7 @@ asa_text | **required**: False | **type**: bool + | **default**: False backup @@ -52,6 +53,7 @@ backup | **required**: False | **type**: bool + | **default**: False backup_name @@ -89,6 +91,8 @@ dest If ``dest`` is a nonexistent USS file, it will be created. + If ``dest`` is a new USS file or replacement, the file will be appropriately tagged with either the system's default locale or the encoding option defined. If the USS file is a replacement, the user must have write authority to the file either through ownership, group or other permissions, else the module will fail. + If ``dest`` is a nonexistent data set, it will be created following the process outlined here and in the ``volume`` option. If ``dest`` is a nonexistent data set, the attributes assigned will depend on the type of ``src``. If ``src`` is a USS file, ``dest`` will have a Fixed Block (FB) record format and the remaining attributes will be computed. If *is_binary=true*, ``dest`` will have a Fixed Block (FB) record format with a record length of 80, block size of 32760, and the remaining attributes will be computed. If *executable=true*,``dest`` will have an Undefined (U) record format with a record length of 0, block size of 32760, and the remaining attributes will be computed. @@ -128,7 +132,7 @@ encoding to The encoding to be converted to - | **required**: True + | **required**: False | **type**: str @@ -155,6 +159,7 @@ force | **required**: False | **type**: bool + | **default**: False force_lock @@ -168,6 +173,7 @@ force_lock | **required**: False | **type**: bool + | **default**: False ignore_sftp_stderr @@ -177,6 +183,7 @@ ignore_sftp_stderr | **required**: False | **type**: bool + | **default**: False is_binary @@ -188,6 +195,7 @@ is_binary | **required**: False | **type**: bool + | **default**: False executable @@ -203,6 +211,7 @@ executable | **required**: False | **type**: bool + | **default**: False aliases @@ -214,6 +223,7 @@ aliases | **required**: False | **type**: bool + | **default**: False local_follow @@ -224,6 +234,17 @@ local_follow | **default**: True +group + Name of the group that will own the file system objects. + + When left unspecified, it uses the current group of the current user unless you are root, in which case it can preserve the previous ownership. + + This option is only applicable if ``dest`` is USS, otherwise ignored. + + | **required**: False + | **type**: str + + mode The permission of the destination file or directory. @@ -239,6 +260,17 @@ mode | **type**: str +owner + Name of the user that should own the filesystem object, as would be passed to the chown command. + + When left unspecified, it uses the current user unless you are root, in which case it can preserve the previous ownership. + + This option is only applicable if ``dest`` is USS, otherwise ignored. + + | **required**: False + | **type**: str + + remote_src If set to ``false``, the module searches for ``src`` at the local machine. @@ -246,6 +278,7 @@ remote_src | **required**: False | **type**: bool + | **default**: False src @@ -261,6 +294,8 @@ src If ``src`` is a directory and ends with "/", the contents of it will be copied into the root of ``dest``. If it doesn't end with "/", the directory itself will be copied. + If ``src`` is a directory or a file, file names will be truncated and/or modified to ensure a valid name for a data set or member. + If ``src`` is a VSAM data set, ``dest`` must also be a VSAM. Wildcards can be used to copy multiple PDS/PDSE members to another PDS/PDSE. @@ -278,6 +313,7 @@ validate | **required**: False | **type**: bool + | **default**: False volume @@ -307,7 +343,7 @@ dest_data_set | **required**: True | **type**: str - | **choices**: KSDS, ESDS, RRDS, LDS, SEQ, PDS, PDSE, MEMBER, BASIC, LIBRARY + | **choices**: ksds, esds, rrds, lds, seq, pds, pdse, member, basic, library space_primary @@ -331,21 +367,21 @@ dest_data_set space_type If the destination data set does not exist, this sets the unit of measurement to use when defining primary and secondary space. - Valid units of size are ``K``, ``M``, ``G``, ``CYL``, and ``TRK``. + Valid units of size are ``k``, ``m``, ``g``, ``cyl``, and ``trk``. | **required**: False | **type**: str - | **choices**: K, M, G, CYL, TRK + | **choices**: k, m, g, cyl, trk record_format - If the destination data set does not exist, this sets the format of the data set. (e.g ``FB``) + If the destination data set does not exist, this sets the format of the data set. (e.g ``fb``) - Choices are case-insensitive. + Choices are case-sensitive. | **required**: False | **type**: str - | **choices**: FB, VB, FBA, VBA, U + | **choices**: fb, vb, fba, vba, u record_length @@ -376,9 +412,9 @@ dest_data_set key_offset The key offset to use when creating a KSDS data set. - *key_offset* is required when *type=KSDS*. + *key_offset* is required when *type=ksds*. - *key_offset* should only be provided when *type=KSDS* + *key_offset* should only be provided when *type=ksds* | **required**: False | **type**: int @@ -387,9 +423,9 @@ dest_data_set key_length The key length to use when creating a KSDS data set. - *key_length* is required when *type=KSDS*. + *key_length* is required when *type=ksds*. - *key_length* should only be provided when *type=KSDS* + *key_length* should only be provided when *type=ksds* | **required**: False | **type**: int @@ -446,6 +482,7 @@ use_template | **required**: False | **type**: bool + | **default**: False template_parameters @@ -526,6 +563,7 @@ template_parameters | **required**: False | **type**: bool + | **default**: False trim_blocks @@ -543,6 +581,7 @@ template_parameters | **required**: False | **type**: bool + | **default**: False newline_sequence @@ -559,6 +598,7 @@ template_parameters | **required**: False | **type**: bool + | **default**: False @@ -595,7 +635,7 @@ Examples zos_copy: src: /path/to/foo.conf dest: /etc/foo.conf - mode: 0644 + mode: "0644" group: foo owner: bar @@ -725,11 +765,11 @@ Examples remote_src: true volume: '222222' dest_data_set: - type: SEQ + type: seq space_primary: 10 space_secondary: 3 - space_type: K - record_format: VB + space_type: k + record_format: vb record_length: 150 - name: Copy a Program Object and its aliases on a remote system to a new PDSE member MYCOBOL @@ -771,9 +811,13 @@ Notes For supported character sets used to encode data, refer to the `documentation `_. - `zos_copy <./zos_copy.html>`_ uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; Co:Z SFTP is not supported. In the case of Co:z SFTP, you can exempt the Ansible userid on z/OS from using Co:Z thus falling back to using standard SFTP. + This module uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; SCP (secure copy protocol) and Co:Z SFTP are not supported. In the case of Co:z SFTP, you can exempt the Ansible user id on z/OS from using Co:Z thus falling back to using standard SFTP. If the module detects SCP, it will temporarily use SFTP for transfers, if not available, the module will fail. + + Beginning in version 1.8.x, zos_copy will no longer attempt to correct a copy of a data type member into a PDSE that contains program objects. You can control this behavior using module option ``executable`` that will signify an executable is being copied into a PDSE with other executables. Mixing data type members with program objects will result in a (FSUM8976,./zos_copy.html) error. + + It is the playbook author or user's responsibility to ensure they have appropriate authority to the RACF FACILITY resource class. A user is described as the remote user, configured either for the playbook or playbook tasks, who can also obtain escalated privileges to execute as root or another user. - Beginning in version 1.8.x, zos_copy will no longer attempt to autocorrect a copy of a data type member into a PDSE that contains program objects. You can control this behavior using module option executable that will signify an executable is being copied into a PDSE with other executables. Mixing data type members with program objects will be responded with a (FSUM8976,./zos_copy.html) error. + To use this module, you must define the RACF FACILITY class profile and allow READ access to RACF FACILITY profile MVS.MCSOPER.ZOAU. If your system uses a different security product, consult that product's documentation to configure the required security classes. @@ -828,12 +872,12 @@ destination_attributes { "block_size": 32760, - "record_format": "FB", + "record_format": "fb", "record_length": 45, "space_primary": 2, "space_secondary": 1, - "space_type": "K", - "type": "PDSE" + "space_type": "k", + "type": "pdse" } block_size @@ -846,7 +890,7 @@ destination_attributes Record format of the dataset. | **type**: str - | **sample**: FB + | **sample**: fb record_length Record length of the dataset. @@ -870,13 +914,13 @@ destination_attributes Unit of measurement for space. | **type**: str - | **sample**: K + | **sample**: k type Type of dataset allocated. | **type**: str - | **sample**: PDSE + | **sample**: pdse checksum diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_data_set.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_data_set.rst.txt index ddcc97a8..34162d72 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_data_set.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_data_set.rst.txt @@ -32,7 +32,7 @@ name If *name* is not provided, a randomized data set name will be generated with the HLQ matching the module-runners username. - Required if *type=MEMBER* or *state!=present* and not using *batch*. + Required if *type=member* or *state!=present* and not using *batch*. | **required**: False | **type**: str @@ -47,7 +47,7 @@ state If *state=absent* and the data set does exist on the managed node, remove the data set, module completes successfully with *changed=True*. - If *state=absent* and *type=MEMBER* and *force=True*, the data set will be opened with *DISP=SHR* such that the entire data set can be accessed by other processes while the specified member is deleted. + If *state=absent* and *type=member* and *force=True*, the data set will be opened with *DISP=SHR* such that the entire data set can be accessed by other processes while the specified member is deleted. If *state=absent* and *volumes* is provided, and the data set is not found in the catalog, the module attempts to perform catalog using supplied *name* and *volumes*. If the attempt to catalog the data set catalog is successful, then the data set is removed. Module completes successfully with *changed=True*. @@ -68,7 +68,7 @@ state If *state=present* and *replace=False* and the data set is present on the managed node, no action taken, module completes successfully with *changed=False*. - If *state=present* and *type=MEMBER* and the member does not exist in the data set, create a member formatted to store data, module completes successfully with *changed=True*. Note, a PDSE does not allow a mixture of formats such that there is executables (program objects) and data. The member created is formatted to store data, not an executable. + If *state=present* and *type=member* and the member does not exist in the data set, create a member formatted to store data, module completes successfully with *changed=True*. Note, a PDSE does not allow a mixture of formats such that there is executables (program objects) and data. The member created is formatted to store data, not an executable. If *state=cataloged* and *volumes* is provided and the data set is already cataloged, no action taken, module completes successfully with *changed=False*. @@ -93,16 +93,16 @@ state type - The data set type to be used when creating a data set. (e.g ``pdse``) + The data set type to be used when creating a data set. (e.g ``pdse``). - ``MEMBER`` expects to be used with an existing partitioned data set. + ``member`` expects to be used with an existing partitioned data set. - Choices are case-insensitive. + Choices are case-sensitive. | **required**: False | **type**: str - | **default**: PDS - | **choices**: KSDS, ESDS, RRDS, LDS, SEQ, PDS, PDSE, LIBRARY, BASIC, LARGE, MEMBER, HFS, ZFS + | **default**: pds + | **choices**: ksds, esds, rrds, lds, seq, pds, pdse, library, basic, large, member, hfs, zfs space_primary @@ -128,25 +128,25 @@ space_secondary space_type The unit of measurement to use when defining primary and secondary space. - Valid units of size are ``K``, ``M``, ``G``, ``CYL``, and ``TRK``. + Valid units of size are ``k``, ``m``, ``g``, ``cyl``, and ``trk``. | **required**: False | **type**: str - | **default**: M - | **choices**: K, M, G, CYL, TRK + | **default**: m + | **choices**: k, m, g, cyl, trk record_format The format of the data set. (e.g ``FB``) - Choices are case-insensitive. + Choices are case-sensitive. - When *type=KSDS*, *type=ESDS*, *type=RRDS*, *type=LDS* or *type=ZFS* then *record_format=None*, these types do not have a default *record_format*. + When *type=ksds*, *type=esds*, *type=rrds*, *type=lds* or *type=zfs* then *record_format=None*, these types do not have a default *record_format*. | **required**: False | **type**: str - | **default**: FB - | **choices**: FB, VB, FBA, VBA, U, F + | **default**: fb + | **choices**: fb, vb, fba, vba, u, f sms_storage_class @@ -216,9 +216,9 @@ directory_blocks key_offset The key offset to use when creating a KSDS data set. - *key_offset* is required when *type=KSDS*. + *key_offset* is required when *type=ksds*. - *key_offset* should only be provided when *type=KSDS* + *key_offset* should only be provided when *type=ksds* | **required**: False | **type**: int @@ -227,9 +227,9 @@ key_offset key_length The key length to use when creating a KSDS data set. - *key_length* is required when *type=KSDS*. + *key_length* is required when *type=ksds*. - *key_length* should only be provided when *type=KSDS* + *key_length* should only be provided when *type=ksds* | **required**: False | **type**: int @@ -266,6 +266,7 @@ replace | **required**: False | **type**: bool + | **default**: False tmp_hlq @@ -284,10 +285,11 @@ force The *force=True* option enables sharing of data sets through the disposition *DISP=SHR*. - The *force=True* only applies to data set members when *state=absent* and *type=MEMBER*. + The *force=True* only applies to data set members when *state=absent* and *type=member*. | **required**: False | **type**: bool + | **default**: False batch @@ -303,7 +305,7 @@ batch If *name* is not provided, a randomized data set name will be generated with the HLQ matching the module-runners username. - Required if *type=MEMBER* or *state!=present* + Required if *type=member* or *state!=present* | **required**: False | **type**: str @@ -318,7 +320,7 @@ batch If *state=absent* and the data set does exist on the managed node, remove the data set, module completes successfully with *changed=True*. - If *state=absent* and *type=MEMBER* and *force=True*, the data set will be opened with *DISP=SHR* such that the entire data set can be accessed by other processes while the specified member is deleted. + If *state=absent* and *type=member* and *force=True*, the data set will be opened with *DISP=SHR* such that the entire data set can be accessed by other processes while the specified member is deleted. If *state=absent* and *volumes* is provided, and the data set is not found in the catalog, the module attempts to perform catalog using supplied *name* and *volumes*. If the attempt to catalog the data set catalog is successful, then the data set is removed. Module completes successfully with *changed=True*. @@ -339,7 +341,7 @@ batch If *state=present* and *replace=False* and the data set is present on the managed node, no action taken, module completes successfully with *changed=False*. - If *state=present* and *type=MEMBER* and the member does not exist in the data set, create a member formatted to store data, module completes successfully with *changed=True*. Note, a PDSE does not allow a mixture of formats such that there is executables (program objects) and data. The member created is formatted to store data, not an executable. + If *state=present* and *type=member* and the member does not exist in the data set, create a member formatted to store data, module completes successfully with *changed=True*. Note, a PDSE does not allow a mixture of formats such that there is executables (program objects) and data. The member created is formatted to store data, not an executable. If *state=cataloged* and *volumes* is provided and the data set is already cataloged, no action taken, module completes successfully with *changed=False*. @@ -364,16 +366,16 @@ batch type - The data set type to be used when creating a data set. (e.g ``PDSE``) + The data set type to be used when creating a data set. (e.g ``pdse``) - ``MEMBER`` expects to be used with an existing partitioned data set. + ``member`` expects to be used with an existing partitioned data set. - Choices are case-insensitive. + Choices are case-sensitive. | **required**: False | **type**: str - | **default**: PDS - | **choices**: KSDS, ESDS, RRDS, LDS, SEQ, PDS, PDSE, LIBRARY, BASIC, LARGE, MEMBER, HFS, ZFS + | **default**: pds + | **choices**: ksds, esds, rrds, lds, seq, pds, pdse, library, basic, large, member, hfs, zfs space_primary @@ -399,25 +401,25 @@ batch space_type The unit of measurement to use when defining primary and secondary space. - Valid units of size are ``K``, ``M``, ``G``, ``CYL``, and ``TRK``. + Valid units of size are ``k``, ``m``, ``g``, ``cyl``, and ``trk``. | **required**: False | **type**: str - | **default**: M - | **choices**: K, M, G, CYL, TRK + | **default**: m + | **choices**: k, m, g, cyl, trk record_format The format of the data set. (e.g ``FB``) - Choices are case-insensitive. + Choices are case-sensitive. - When *type=KSDS*, *type=ESDS*, *type=RRDS*, *type=LDS* or *type=ZFS* then *record_format=None*, these types do not have a default *record_format*. + When *type=ksds*, *type=esds*, *type=rrds*, *type=lds* or *type=zfs* then *record_format=None*, these types do not have a default *record_format*. | **required**: False | **type**: str - | **default**: FB - | **choices**: FB, VB, FBA, VBA, U, F + | **default**: fb + | **choices**: fb, vb, fba, vba, u, f sms_storage_class @@ -487,9 +489,9 @@ batch key_offset The key offset to use when creating a KSDS data set. - *key_offset* is required when *type=KSDS*. + *key_offset* is required when *type=ksds*. - *key_offset* should only be provided when *type=KSDS* + *key_offset* should only be provided when *type=ksds* | **required**: False | **type**: int @@ -498,9 +500,9 @@ batch key_length The key length to use when creating a KSDS data set. - *key_length* is required when *type=KSDS*. + *key_length* is required when *type=ksds*. - *key_length* should only be provided when *type=KSDS* + *key_length* should only be provided when *type=ksds* | **required**: False | **type**: int @@ -537,6 +539,7 @@ batch | **required**: False | **type**: bool + | **default**: False force @@ -546,10 +549,11 @@ batch The *force=True* option enables sharing of data sets through the disposition *DISP=SHR*. - The *force=True* only applies to data set members when *state=absent* and *type=MEMBER*. + The *force=True* only applies to data set members when *state=absent* and *type=member*. | **required**: False | **type**: bool + | **default**: False @@ -572,7 +576,7 @@ Examples name: someds.name.here type: pds space_primary: 5 - space_type: M + space_type: m record_format: fba record_length: 25 @@ -581,21 +585,21 @@ Examples name: someds.name.here type: pds space_primary: 5 - space_type: M + space_type: m record_format: u record_length: 25 - replace: yes + replace: true - name: Attempt to replace a data set if it exists. If not found in the catalog, check if it is available on volume 222222, and catalog if found. zos_data_set: name: someds.name.here type: pds space_primary: 5 - space_type: M + space_type: m record_format: u record_length: 25 volumes: "222222" - replace: yes + replace: true - name: Create an ESDS data set if it does not exist zos_data_set: @@ -629,43 +633,43 @@ Examples - name: Write a member to an existing PDS; replace if member exists zos_data_set: name: someds.name.here(mydata) - type: MEMBER - replace: yes + type: member + replace: true - name: Write a member to an existing PDS; do not replace if member exists zos_data_set: name: someds.name.here(mydata) - type: MEMBER + type: member - name: Remove a member from an existing PDS zos_data_set: name: someds.name.here(mydata) state: absent - type: MEMBER + type: member - name: Remove a member from an existing PDS/E by opening with disposition DISP=SHR zos_data_set: name: someds.name.here(mydata) state: absent - type: MEMBER - force: yes + type: member + force: true - name: Create multiple partitioned data sets and add one or more members to each zos_data_set: batch: - - name: someds.name.here1 - type: PDS + - name: someds.name.here1 + type: pds space_primary: 5 - space_type: M + space_type: m record_format: fb - replace: yes + replace: true - name: someds.name.here1(member1) - type: MEMBER + type: member - name: someds.name.here2(member1) - type: MEMBER - replace: yes + type: member + replace: true - name: someds.name.here2(member2) - type: MEMBER + type: member - name: Catalog a data set present on volume 222222 if it is uncataloged. zos_data_set: diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_encode.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_encode.rst.txt index 089208c5..2134b336 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_encode.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_encode.rst.txt @@ -86,6 +86,7 @@ backup | **required**: False | **type**: bool + | **default**: False backup_name @@ -110,6 +111,7 @@ backup_compress | **required**: False | **type**: bool + | **default**: False tmp_hlq @@ -141,8 +143,8 @@ Examples encoding: from: IBM-1047 to: ISO8859-1 - backup: yes - backup_compress: yes + backup: true + backup_compress: true - name: Convert file encoding from IBM-1047 to ISO8859-1 to a directory zos_encode: @@ -254,7 +256,6 @@ Examples - Notes ----- diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_fetch.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_fetch.rst.txt index 66792fa8..87a50a65 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_fetch.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_fetch.rst.txt @@ -130,6 +130,7 @@ ignore_sftp_stderr | **required**: False | **type**: bool + | **default**: False @@ -203,7 +204,7 @@ Notes For supported character sets used to encode data, refer to the `documentation `_. - `zos_fetch <./zos_fetch.html>`_ uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; Co:Z SFTP is not supported. In the case of Co:z SFTP, you can exempt the Ansible userid on z/OS from using Co:Z thus falling back to using standard SFTP. + This module uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; SCP (secure copy protocol) and Co:Z SFTP are not supported. In the case of Co:z SFTP, you can exempt the Ansible user id on z/OS from using Co:Z thus falling back to using standard SFTP. If the module detects SCP, it will temporarily use SFTP for transfers, if not available, the module will fail. diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_gather_facts.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_gather_facts.rst.txt index 63bd2270..0247ffd9 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_gather_facts.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_gather_facts.rst.txt @@ -52,6 +52,7 @@ filter | **required**: False | **type**: list | **elements**: str + | **default**: [] diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_job_submit.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_job_submit.rst.txt index e0fd8e2d..a6f55acf 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_job_submit.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_job_submit.rst.txt @@ -16,9 +16,8 @@ zos_job_submit -- Submit JCL Synopsis -------- -- Submit JCL from a data set, USS, or from the controller. -- Submit a job and optionally monitor for completion. -- Optionally, wait a designated time until the job finishes. +- Submit JCL in a data set, USS file, or file on the controller. +- Submit a job and monitor for completion. - For an uncataloged dataset, specify the volume serial number. @@ -43,29 +42,18 @@ src location - The JCL location. Supported choices are ``DATA_SET``, ``USS`` or ``LOCAL``. + The JCL location. Supported choices are ``data_set``, ``uss`` or ``local``. - DATA_SET can be a PDS, PDSE, or sequential data set. + ``data_set`` can be a PDS, PDSE, or sequential data set. - USS means the JCL location is located in UNIX System Services (USS). + ``uss`` means the JCL location is located in UNIX System Services (USS). - LOCAL means locally to the ansible control node. + ``local`` means locally to the ansible control node. | **required**: False | **type**: str - | **default**: DATA_SET - | **choices**: DATA_SET, USS, LOCAL - - -wait - Setting this option will yield no change, it is deprecated. There is no no need to set *wait*; setting *wait_times_s* is the correct way to configure the amount of tme to wait for a job to execute. - - Configuring wait used by the `zos_job_submit <./zos_job_submit.html>`_ module has been deprecated and will be removed in ibm.ibm_zos_core collection. - - See option *wait_time_s*. - - | **required**: False - | **type**: bool + | **default**: data_set + | **choices**: data_set, uss, local wait_time_s @@ -96,11 +84,11 @@ return_output volume - The volume serial (VOLSER)is where the data set resides. The option is required only when the data set is not cataloged on the system. + The volume serial (VOLSER) is where the data set resides. The option is required only when the data set is not cataloged on the system. When configured, the `zos_job_submit <./zos_job_submit.html>`_ will try to catalog the data set for the volume serial. If it is not able to, the module will fail. - Ignored for *location=USS* and *location=LOCAL*. + Ignored for *location=uss* and *location=local*. | **required**: False | **type**: str @@ -109,7 +97,7 @@ volume encoding Specifies which encoding the local JCL file should be converted from and to, before submitting the job. - This option is only supported for when *location=LOCAL*. + This option is only supported for when *location=local*. If this parameter is not provided, and the z/OS systems default encoding can not be identified, the JCL file will be converted from UTF-8 to IBM-1047 by default, otherwise the module will detect the z/OS system encoding. @@ -151,6 +139,7 @@ use_template | **required**: False | **type**: bool + | **default**: False template_parameters @@ -231,6 +220,7 @@ template_parameters | **required**: False | **type**: bool + | **default**: False trim_blocks @@ -248,6 +238,7 @@ template_parameters | **required**: False | **type**: bool + | **default**: False newline_sequence @@ -264,6 +255,7 @@ template_parameters | **required**: False | **type**: bool + | **default**: False @@ -275,22 +267,22 @@ Examples .. code-block:: yaml+jinja - - name: Submit JCL in a PDSE member + - name: Submit JCL in a PDSE member. zos_job_submit: src: HLQ.DATA.LLQ(SAMPLE) - location: DATA_SET + location: data_set register: response - name: Submit JCL in USS with no DDs in the output. zos_job_submit: src: /u/tester/demo/sample.jcl - location: USS + location: uss return_output: false - name: Convert local JCL to IBM-037 and submit the job. zos_job_submit: src: /Users/maxy/ansible-playbooks/provision/sample.jcl - location: LOCAL + location: local encoding: from: ISO8859-1 to: IBM-037 @@ -298,25 +290,25 @@ Examples - name: Submit JCL in an uncataloged PDSE on volume P2SS01. zos_job_submit: src: HLQ.DATA.LLQ(SAMPLE) - location: DATA_SET + location: data_set volume: P2SS01 - name: Submit a long running PDS job and wait up to 30 seconds for completion. zos_job_submit: src: HLQ.DATA.LLQ(LONGRUN) - location: DATA_SET + location: data_set wait_time_s: 30 - name: Submit a long running PDS job and wait up to 30 seconds for completion. zos_job_submit: src: HLQ.DATA.LLQ(LONGRUN) - location: DATA_SET + location: data_set wait_time_s: 30 - name: Submit JCL and set the max return code the module should fail on to 16. zos_job_submit: src: HLQ.DATA.LLQ - location: DATA_SET + location: data_set max_rc: 16 @@ -328,6 +320,8 @@ Notes .. note:: For supported character sets used to encode data, refer to the `documentation `_. + This module uses `zos_copy <./zos_copy.html>`_ to copy local scripts to the remote machine which uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; SCP (secure copy protocol) and Co:Z SFTP are not supported. In the case of Co:z SFTP, you can exempt the Ansible user id on z/OS from using Co:Z thus falling back to using standard SFTP. If the module detects SCP, it will temporarily use SFTP for transfers, if not available, the module will fail. + @@ -684,24 +678,52 @@ jobs } msg - Return code resulting from the job submission. Jobs that take longer to assign a value can have a value of '?'. + Job status resulting from the job submission. + + Job status `ABEND` indicates the job ended abnormally. + + Job status `AC` indicates the job is active, often a started task or job taking long. + + Job status `CAB` indicates a converter abend. + + Job status `CANCELED` indicates the job was canceled. + + Job status `CNV` indicates a converter error. + + Job status `FLU` indicates the job was flushed. + + Job status `JCLERR` or `JCL ERROR` indicates the JCL has an error. + + Job status `SEC` or `SEC ERROR` indicates the job as encountered a security error. + + Job status `SYS` indicates a system failure. + + Job status `?` indicates status can not be determined. + + Jobs where status can not be determined will result in None (NULL). | **type**: str - | **sample**: CC 0000 + | **sample**: AC msg_code - Return code extracted from the `msg` so that it can be evaluated as a string. Jobs that take longer to assign a value can have a value of '?'. + The return code from the submitted job as a string. + + Jobs which have no return code will result in None (NULL), such is the case of a job that errors or is active. | **type**: str msg_txt - Returns additional information related to the job. Jobs that take longer to assign a value can have a value of '?'. + Returns additional information related to the submitted job. + + Jobs which have no additional information will result in None (NULL). | **type**: str - | **sample**: The job completion code (CC) was not available in the job output, please review the job log." + | **sample**: The job JOB00551 was run with special job processing TYPRUN=SCAN. This will result in no completion, return code or job steps and changed will be false. code - Return code converted to an integer value (when possible). For JCL ERRORs, this will be None. + The return code converted to an integer value when available. + + Jobs which have no return code will result in None (NULL), such is the case of a job that errors or is active. | **type**: int @@ -772,10 +794,3 @@ jobs | **sample**: IEBGENER -message - This option is being deprecated - - | **returned**: success - | **type**: str - | **sample**: Submit JCL operation succeeded. - diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_lineinfile.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_lineinfile.rst.txt index e352007d..4e416f97 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_lineinfile.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_lineinfile.rst.txt @@ -83,6 +83,7 @@ backrefs | **required**: False | **type**: bool + | **default**: False insertafter @@ -140,6 +141,7 @@ backup | **required**: False | **type**: bool + | **default**: False backup_name @@ -173,6 +175,7 @@ firstmatch | **required**: False | **type**: bool + | **default**: False encoding @@ -194,6 +197,7 @@ force | **required**: False | **type**: bool + | **default**: False @@ -235,15 +239,14 @@ Examples src: /tmp/src/somefile regexp: '^(.*)User(\d+)m(.*)$' line: '\1APPUser\3' - backrefs: yes + backrefs: true - name: Add a line to a member while a task is in execution zos_lineinfile: src: SOME.PARTITIONED.DATA.SET(DATA) insertafter: EOF line: 'Should be a working test now' - force: True - + force: true diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_mount.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_mount.rst.txt index 9ff7ba10..3b30be90 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_mount.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_mount.rst.txt @@ -53,11 +53,11 @@ fs_type The physical file systems data set format to perform the logical mount. - The *fs_type* is required to be uppercase. + The *fs_type* is required to be lowercase. | **required**: True | **type**: str - | **choices**: HFS, ZFS, NFS, TFS + | **choices**: hfs, zfs, nfs, tfs state @@ -113,6 +113,7 @@ persistent | **required**: False | **type**: bool + | **default**: False backup_name @@ -148,25 +149,25 @@ unmount_opts | **required**: False | **type**: str - | **default**: NORMAL - | **choices**: DRAIN, FORCE, IMMEDIATE, NORMAL, REMOUNT, RESET + | **default**: normal + | **choices**: drain, force, immediate, normal, remount, reset mount_opts Options available to the mount. - If *mount_opts=RO* on a mounted/remount, mount is performed read-only. + If *mount_opts=ro* on a mounted/remount, mount is performed read-only. - If *mount_opts=SAME* and (unmount_opts=REMOUNT), mount is opened in the same mode as previously opened. + If *mount_opts=same* and (unmount_opts=remount), mount is opened in the same mode as previously opened. - If *mount_opts=NOWAIT*, mount is performed asynchronously. + If *mount_opts=nowait*, mount is performed asynchronously. - If *mount_opts=NOSECURITY*, security checks are not enforced for files in this file system. + If *mount_opts=nosecurity*, security checks are not enforced for files in this file system. | **required**: False | **type**: str - | **default**: RW - | **choices**: RO, RW, SAME, NOWAIT, NOSECURITY + | **default**: rw + | **choices**: ro, rw, same, nowait, nosecurity src_params @@ -183,15 +184,15 @@ tag_untagged When the file system is unmounted, the tags are lost. - If *tag_untagged=NOTEXT* none of the untagged files in the file system are automatically converted during file reading and writing. + If *tag_untagged=notext* none of the untagged files in the file system are automatically converted during file reading and writing. - If *tag_untagged=TEXT* each untagged file is implicitly marked as containing pure text data that can be converted. + If *tag_untagged=text* each untagged file is implicitly marked as containing pure text data that can be converted. If this flag is used, use of tag_ccsid is encouraged. | **required**: False | **type**: str - | **choices**: TEXT, NOTEXT + | **choices**: text, notext tag_ccsid @@ -239,23 +240,23 @@ automove These parameters apply only in a sysplex where systems are exploiting the shared file system capability. They specify what happens to the ownership of a file system when a shutdown, PFS termination, dead system takeover, or file system move occurs. The default setting is AUTOMOVE where the file system will be randomly moved to another system (no system list used). - *automove=AUTOMOVE* indicates that ownership of the file system can be automatically moved to another system participating in a shared file system. + *automove=automove* indicates that ownership of the file system can be automatically moved to another system participating in a shared file system. - *automove=NOAUTOMOVE* prevents movement of the file system's ownership in some situations. + *automove=noautomove* prevents movement of the file system's ownership in some situations. - *automove=UNMOUNT* allows the file system to be unmounted in some situations. + *automove=unmount* allows the file system to be unmounted in some situations. | **required**: False | **type**: str - | **default**: AUTOMOVE - | **choices**: AUTOMOVE, NOAUTOMOVE, UNMOUNT + | **default**: automove + | **choices**: automove, noautomove, unmount automove_list - If(automove=AUTOMOVE), this option will be checked. + If(automove=automove), this option will be checked. This specifies the list of servers to include or exclude as destinations. @@ -292,14 +293,14 @@ Examples zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted - name: Unmount a filesystem. zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: unmounted unmount_opts: REMOUNT opts: same @@ -308,7 +309,7 @@ Examples zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted mount_opts: RO @@ -316,37 +317,37 @@ Examples zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted persistent: - data_store: SYS1.PARMLIB(BPXPRMAA) - comment: For Tape2 project + data_store: SYS1.PARMLIB(BPXPRMAA) + comment: For Tape2 project - name: Mount a filesystem and record change in BPXPRMAA after backing up to BPXPRMAB. zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted persistent: - data_store: SYS1.PARMLIB(BPXPRMAA) - backup: Yes - backup_name: SYS1.PARMLIB(BPXPRMAB) - comment: For Tape2 project + data_store: SYS1.PARMLIB(BPXPRMAA) + backup: true + backup_name: SYS1.PARMLIB(BPXPRMAB) + comment: For Tape2 project - name: Mount a filesystem ignoring uid/gid values. zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted - allow_uid: no + allow_uid: false - name: Mount a filesystem asynchronously (don't wait for completion). zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted opts: nowait @@ -354,7 +355,7 @@ Examples zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted mount_opts: NOSECURITY @@ -362,7 +363,7 @@ Examples zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted automove: AUTOMOVE automove_list: I,DEV1,DEV2,DEV3,DEV9 @@ -371,7 +372,7 @@ Examples zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted automove: AUTOMOVE automove_list: EXCLUDE,DEV4,DEV5,DEV6,DEV7 @@ -379,7 +380,6 @@ Examples - Notes ----- diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_mvs_raw.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_mvs_raw.rst.txt index 33247a3e..d98c9493 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_mvs_raw.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_mvs_raw.rst.txt @@ -51,6 +51,7 @@ auth | **required**: False | **type**: bool + | **default**: False verbose @@ -60,6 +61,7 @@ verbose | **required**: False | **type**: bool + | **default**: False dds @@ -132,7 +134,7 @@ dds | **required**: False | **type**: str - | **choices**: delete, keep, catlg, catalog, uncatlg, uncatalog + | **choices**: delete, keep, catalog, uncatalog disposition_abnormal @@ -140,11 +142,11 @@ dds | **required**: False | **type**: str - | **choices**: delete, keep, catlg, catalog, uncatlg, uncatalog + | **choices**: delete, keep, catalog, uncatalog reuse - Determines if a data set should be reused if *disposition=NEW* and if a data set with a matching name already exists. + Determines if a data set should be reused if *disposition=new* and if a data set with a matching name already exists. If *reuse=true*, *disposition* will be automatically switched to ``SHR``. @@ -152,14 +154,15 @@ dds Mutually exclusive with *replace*. - *reuse* is only considered when *disposition=NEW* + *reuse* is only considered when *disposition=new* | **required**: False | **type**: bool + | **default**: False replace - Determines if a data set should be replaced if *disposition=NEW* and a data set with a matching name already exists. + Determines if a data set should be replaced if *disposition=new* and a data set with a matching name already exists. If *replace=true*, the original data set will be deleted, and a new data set created. @@ -167,21 +170,23 @@ dds Mutually exclusive with *reuse*. - *replace* is only considered when *disposition=NEW* + *replace* is only considered when *disposition=new* *replace* will result in loss of all data in the original data set unless *backup* is specified. | **required**: False | **type**: bool + | **default**: False backup - Determines if a backup should be made of an existing data set when *disposition=NEW*, *replace=true*, and a data set with the desired name is found. + Determines if a backup should be made of an existing data set when *disposition=new*, *replace=true*, and a data set with the desired name is found. *backup* is only used when *replace=true*. | **required**: False | **type**: bool + | **default**: False space_type @@ -310,7 +315,7 @@ dds encoding How the label for the key encrypting key specified by *label* is encoded by the Encryption Key Manager. - *encoding* can either be set to ``L`` for label encoding, or ``H`` for hash encoding. + *encoding* can either be set to ``l`` for label encoding, or ``h`` for hash encoding. Maps to KEYCD1 on z/OS. @@ -345,7 +350,7 @@ dds encoding How the label for the key encrypting key specified by *label* is encoded by the Encryption Key Manager. - *encoding* can either be set to ``L`` for label encoding, or ``H`` for hash encoding. + *encoding* can either be set to ``l`` for label encoding, or ``h`` for hash encoding. Maps to KEYCD2 on z/OS. @@ -384,7 +389,7 @@ dds Defaults vary depending on format: If FB/FBA 80, if VB/VBA 137, if U 0. - Valid values are (1-32760 for non-vsam, 1-32761 for vsam). + Valid values are (1-32760 for non-VSAM, 1-32761 for VSAM). Maps to LRECL on z/OS. @@ -655,10 +660,12 @@ dds Multi-line input can be provided as a multi-line string or a list of strings with 1 line per list item. - If a multi-line string is provided make sure to use the proper literal block style indicator "|". - If a list of strings is provided, newlines will be added to each of the lines when used as input. + If a multi-line string is provided, use the proper block scalar style. YAML supports both `literal `_ and `folded `_ scalars. It is recommended to use the literal style indicator "|" with a block indentation indicator, for example; *content: | 2* is a literal block style indicator with a 2 space indentation, the entire block will be indented and newlines preserved. The block indentation range is 1 - 9. While generally unnecessary, YAML does support block `chomping `_ indicators "+" and "-" as well. + + When using the *content* option for instream-data, the module will ensure that all lines contain a blank in columns 1 and 2 and add blanks when not present while retaining a maximum length of 80 columns for any line. This is true for all *content* types; string, list of strings and when using a YAML block indicator. + | **required**: True | **type**: raw @@ -862,7 +869,7 @@ dds | **required**: False | **type**: str - | **choices**: delete, keep, catlg, catalog, uncatlg, uncatalog + | **choices**: delete, keep, catalog, uncatalog disposition_abnormal @@ -870,11 +877,11 @@ dds | **required**: False | **type**: str - | **choices**: delete, keep, catlg, catalog, uncatlg, uncatalog + | **choices**: delete, keep, catalog, uncatalog reuse - Determines if data set should be reused if *disposition=NEW* and a data set with matching name already exists. + Determines if data set should be reused if *disposition=new* and a data set with matching name already exists. If *reuse=true*, *disposition* will be automatically switched to ``SHR``. @@ -882,14 +889,15 @@ dds Mutually exclusive with *replace*. - *reuse* is only considered when *disposition=NEW* + *reuse* is only considered when *disposition=new* | **required**: False | **type**: bool + | **default**: False replace - Determines if data set should be replaced if *disposition=NEW* and a data set with matching name already exists. + Determines if data set should be replaced if *disposition=new* and a data set with matching name already exists. If *replace=true*, the original data set will be deleted, and a new data set created. @@ -897,21 +905,23 @@ dds Mutually exclusive with *reuse*. - *replace* is only considered when *disposition=NEW* + *replace* is only considered when *disposition=new* *replace* will result in loss of all data in the original data set unless *backup* is specified. | **required**: False | **type**: bool + | **default**: False backup - Determines if a backup should be made of existing data set when *disposition=NEW*, *replace=true*, and a data set with the desired name is found. + Determines if a backup should be made of existing data set when *disposition=new*, *replace=true*, and a data set with the desired name is found. *backup* is only used when *replace=true*. | **required**: False | **type**: bool + | **default**: False space_type @@ -1040,7 +1050,7 @@ dds encoding How the label for the key encrypting key specified by *label* is encoded by the Encryption Key Manager. - *encoding* can either be set to ``L`` for label encoding, or ``H`` for hash encoding. + *encoding* can either be set to ``l`` for label encoding, or ``h`` for hash encoding. Maps to KEYCD1 on z/OS. @@ -1075,7 +1085,7 @@ dds encoding How the label for the key encrypting key specified by *label* is encoded by the Encryption Key Manager. - *encoding* can either be set to ``L`` for label encoding, or ``H`` for hash encoding. + *encoding* can either be set to ``l`` for label encoding, or ``h`` for hash encoding. Maps to KEYCD2 on z/OS. @@ -1181,7 +1191,7 @@ dds path The path to an existing UNIX file. - Or provide the path to an new created UNIX file when *status_group=OCREAT*. + Or provide the path to an new created UNIX file when *status_group=ocreat*. The provided path must be absolute. @@ -1371,10 +1381,12 @@ dds Multi-line input can be provided as a multi-line string or a list of strings with 1 line per list item. - If a multi-line string is provided make sure to use the proper literal block style indicator "|". - If a list of strings is provided, newlines will be added to each of the lines when used as input. + If a multi-line string is provided, use the proper block scalar style. YAML supports both `literal `_ and `folded `_ scalars. It is recommended to use the literal style indicator "|" with a block indentation indicator, for example; *content: | 2* is a literal block style indicator with a 2 space indentation, the entire block will be indented and newlines preserved. The block indentation range is 1 - 9. While generally unnecessary, YAML does support block `chomping `_ indicators "+" and "-" as well. + + When using the *content* option for instream-data, the module will ensure that all lines contain a blank in columns 1 and 2 and add blanks when not present while retaining a maximum length of 80 columns for any line. This is true for all *content* types; string, list of strings and when using a YAML block indicator. + | **required**: True | **type**: raw @@ -1452,7 +1464,7 @@ Examples dd_name: sysprint data_set_name: mypgm.output.ds disposition: new - reuse: yes + reuse: true type: seq space_primary: 5 space_secondary: 1 @@ -1476,7 +1488,7 @@ Examples dd_name: sysprint data_set_name: mypgm.output.ds disposition: new - reuse: yes + reuse: true type: seq space_primary: 5 space_secondary: 1 @@ -1521,7 +1533,7 @@ Examples dd_name: sysprint data_set_name: mypgm.output.ds disposition: new - reuse: yes + reuse: true type: seq space_primary: 5 space_secondary: 1 @@ -1549,8 +1561,8 @@ Examples dd_name: sysprint data_set_name: mypgm.output.ds disposition: new - replace: yes - backup: yes + replace: true + backup: true type: seq space_primary: 5 space_secondary: 1 @@ -1621,7 +1633,7 @@ Examples - name: Take a set of data sets and write them to an archive. zos_mvs_raw: program_name: adrdssu - auth: yes + auth: true dds: - dd_data_set: dd_name: archive @@ -1637,7 +1649,7 @@ Examples - name: Merge two sequential data sets and write them to new data set zos_mvs_raw: program_name: sort - auth: no + auth: false parm: "MSGPRT=CRITICAL,LIST" dds: - dd_data_set: @@ -1668,7 +1680,7 @@ Examples files. zos_mvs_raw: pgm: idcams - auth: yes + auth: true dds: - dd_concat: dd_name: sysprint @@ -1685,28 +1697,56 @@ Examples dd_name: sysin content: " LISTCAT ENTRIES('SYS1.*')" - - name: Drop the contents of input dataset into output dataset - using REPRO command. + - name: Drop the contents of input dataset into output dataset using REPRO command. zos_mvs_raw: pgm: idcams - auth: yes + auth: true dds: - - dd_data_set: - dd_name: INPUT - data_set_name: myhlq.ds1.input - - dd_data_set: - dd_name: OUTPUT - data_set_name: myhlq.ds1.output - - dd_input: - dd_name: sysin - content: | + - dd_data_set: + dd_name: INPUT + data_set_name: myhlq.ds1.input + - dd_data_set: + dd_name: OUTPUT + data_set_name: myhlq.ds1.output + - dd_input: + dd_name: sysin + content: | " REPRO - INFILE(INPUT) - OUTFILE(OUTPUT)" - - dd_output: - dd_name: sysprint - return_content: - type: text + - dd_output: + dd_name: sysprint + return_content: + type: text + + - name: Define a cluster using a literal block style indicator + with a 2 space indentation. + zos_mvs_raw: + program_name: idcams + auth: true + dds: + - dd_output: + dd_name: sysprint + return_content: + type: text + - dd_input: + dd_name: sysin + content: 2 + DEFINE CLUSTER - + (NAME(ANSIBLE.TEST.VSAM) - + CYL(10 10) - + FREESPACE(20 20) - + INDEXED - + KEYS(32 0) - + NOERASE - + NONSPANNED - + NOREUSE - + SHAREOPTIONS(3 3) - + SPEED - + UNORDERED - + RECORDSIZE(4086 32600) - + VOLUMES(222222) - + UNIQUE) @@ -1721,6 +1761,8 @@ Notes 2. `zos_mvs_raw <./zos_mvs_raw.html>`_ module execution fails when invoking DFSRRC00 with parm "UPB,PRECOMP", "UPB, POSTCOMP" or "UPB,PRECOMP,POSTCOMP". This issue is addressed by APAR PH28089. + 3. When executing a program, refer to the programs documentation as each programs requirments can vary fom DDs, instream-data indentation and continuation characters. + See Also diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_operator.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_operator.rst.txt index e0f65414..d05126d1 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_operator.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_operator.rst.txt @@ -33,6 +33,10 @@ cmd For example, change the command "...,P='DSN3EPX,-DBC1,S'" to "...,P=''DSN3EPX,-DBC1,S'' ". + If the command contains any special characters ($, &, etc), they must be escaped using double backslashes like \\\\\\$. + + For example, to display job by job name the command would be ``cmd:"\\$dj''HELLO''"`` + | **required**: True | **type**: str @@ -42,6 +46,7 @@ verbose | **required**: False | **type**: bool + | **default**: False wait_time_s diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_operator_action_query.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_operator_action_query.rst.txt index acb06be5..ba9398b5 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_operator_action_query.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_operator_action_query.rst.txt @@ -90,6 +90,7 @@ message_filter | **required**: False | **type**: bool + | **default**: False @@ -127,7 +128,7 @@ Examples system: mv29 message_filter: filter: ^.*IMS.*$ - use_regex: yes + use_regex: true diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_ping.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_ping.rst.txt index a9a959df..a4405b47 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_ping.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_ping.rst.txt @@ -40,10 +40,22 @@ Examples +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``. +See Also +-------- + +.. seealso:: + + - :ref:`ansible.builtin.ssh_module` + + Return Values diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_script.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_script.rst.txt index 29d9bb2d..10660d38 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_script.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_script.rst.txt @@ -102,19 +102,6 @@ removes | **type**: str -tmp_path - Directory path in the remote machine where local scripts will be temporarily copied to. - - When not specified, the module will copy local scripts to the default temporary path for the user. - - If ``tmp_path`` does not exist in the remote machine, the module will not create it. - - All scripts copied to ``tmp_path`` will be removed from the managed node before the module finishes executing. - - | **required**: False - | **type**: str - - use_template Whether the module should treat ``src`` as a Jinja2 template and render it before continuing with the rest of the module. @@ -126,6 +113,7 @@ use_template | **required**: False | **type**: bool + | **default**: False template_parameters @@ -206,6 +194,7 @@ template_parameters | **required**: False | **type**: bool + | **default**: False trim_blocks @@ -223,6 +212,7 @@ template_parameters | **required**: False | **type**: bool + | **default**: False newline_sequence @@ -239,6 +229,7 @@ template_parameters | **required**: False | **type**: bool + | **default**: False @@ -264,11 +255,10 @@ Examples remote_src: true chdir: /u/user/output_dir - - name: Run a local Python script that uses a custom tmp_path. + - name: Run a local Python script in the temporary directory specified in the Ansible environment variable 'remote_tmp'. zos_script: cmd: ./scripts/program.py executable: /usr/bin/python3 - tmp_path: /usr/tmp/ibm_zos_core - name: Run a local script made from a template. zos_script: @@ -285,6 +275,12 @@ Examples cmd: ./scripts/PROGRAM removes: /u/user/pgm_input.txt + - name: Run a shell script on the remote system + zos_script: + cmd: ./scripts/program.sh + executable: /bin/sh + remote_src: true + @@ -294,6 +290,10 @@ Notes .. note:: When executing local scripts, temporary storage will be used on the remote z/OS system. The size of the temporary storage will correspond to the size of the file being copied. + The location in the z/OS system where local scripts will be copied to can be configured through Ansible's ``remote_tmp`` option. Refer to `Ansible's documentation `_ for more information. + + All local scripts copied to a remote z/OS system will be removed from the managed node before the module finishes executing. + Execution permissions for the group assigned to the script will be added to remote scripts. The original permissions for remote scripts will be restored by the module before the task ends. The module will only add execution permissions for the file owner. @@ -302,9 +302,7 @@ Notes For supported character sets used to encode data, refer to the `documentation `_. - This module uses `zos_copy <./zos_copy.html>`_ to copy local scripts to the remote machine. - - `zos_copy <./zos_copy.html>`_ uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; Co:Z SFTP is not supported. In the case of Co:z SFTP, you can exempt the Ansible userid on z/OS from using Co:Z thus falling back to using standard SFTP. + This module uses `zos_copy <./zos_copy.html>`_ to copy local scripts to the remote machine which uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; SCP (secure copy protocol) and Co:Z SFTP are not supported. In the case of Co:z SFTP, you can exempt the Ansible user id on z/OS from using Co:Z thus falling back to using standard SFTP. If the module detects SCP, it will temporarily use SFTP for transfers, if not available, the module will fail. This module executes scripts inside z/OS UNIX System Services. For running REXX scripts contained in data sets or CLISTs, consider issuing a TSO command with `zos_tso_command <./zos_tso_command.html>`_. diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_tso_command.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_tso_command.rst.txt index d11cc8a9..4af6b1b5 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_tso_command.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_tso_command.rst.txt @@ -44,6 +44,7 @@ max_rc | **required**: False | **type**: int + | **default**: 0 @@ -54,23 +55,34 @@ Examples .. code-block:: yaml+jinja - - name: Execute TSO commands to allocate a new dataset + - name: Execute TSO commands to allocate a new dataset. zos_tso_command: - commands: - - alloc da('TEST.HILL3.TEST') like('TEST.HILL3') - - delete 'TEST.HILL3.TEST' + commands: + - alloc da('TEST.HILL3.TEST') like('TEST.HILL3') + - delete 'TEST.HILL3.TEST' - - name: Execute TSO command list user TESTUSER to obtain TSO information + - name: Execute TSO command List User (LU) for TESTUSER to obtain TSO information. zos_tso_command: - commands: - - LU TESTUSER + commands: + - LU TESTUSER - - name: Execute TSO command to list dataset data (allow 4 for no dataset listed or cert found) + - name: Execute TSO command List Dataset (LISTDSD) and allow for maximum return code of 4. zos_tso_command: - commands: - - LISTDSD DATASET('HLQ.DATA.SET') ALL GENERIC - max_rc: 4 + commands: + - LISTDSD DATASET('HLQ.DATA.SET') ALL GENERIC + max_rc: 4 + - name: Execute TSO command to run a REXX script explicitly from a data set. + zos_tso_command: + commands: + - EXEC HLQ.DATASET.REXX exec + + - name: Chain multiple TSO commands into one invocation using semicolons. + zos_tso_command: + commands: >- + ALLOCATE DDNAME(IN1) DSNAME('HLQ.PDSE.DATA.SRC(INPUT)') SHR; + ALLOCATE DDNAME(OUT1) DSNAME('HLQ.PDSE.DATA.DEST(OUTPUT)') SHR; + OCOPY INDD(IN1) OUTDD(OUT1) BINARY; diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_unarchive.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_unarchive.rst.txt index ae3b9251..f2d7aba8 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_unarchive.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_unarchive.rst.txt @@ -83,6 +83,7 @@ format | **required**: False | **type**: bool + | **default**: False dest_volumes @@ -172,6 +173,7 @@ list | **required**: False | **type**: bool + | **default**: False dest_data_set @@ -193,8 +195,8 @@ dest_data_set | **required**: False | **type**: str - | **default**: SEQ - | **choices**: SEQ, PDS, PDSE + | **default**: seq + | **choices**: seq, pds, pdse space_primary @@ -218,21 +220,21 @@ dest_data_set space_type If the destination data set does not exist, this sets the unit of measurement to use when defining primary and secondary space. - Valid units of size are ``K``, ``M``, ``G``, ``CYL``, and ``TRK``. + Valid units of size are ``k``, ``m``, ``g``, ``cyl``, and ``trk``. | **required**: False | **type**: str - | **choices**: K, M, G, CYL, TRK + | **choices**: k, m, g, cyl, trk record_format - If the destination data set does not exist, this sets the format of the data set. (e.g ``FB``) + If the destination data set does not exist, this sets the format of the data set. (e.g ``fb``) - Choices are case-insensitive. + Choices are case-sensitive. | **required**: False | **type**: str - | **choices**: FB, VB, FBA, VBA, U + | **choices**: fb, vb, fba, vba, u record_length @@ -263,9 +265,9 @@ dest_data_set key_offset The key offset to use when creating a KSDS data set. - *key_offset* is required when *type=KSDS*. + *key_offset* is required when *type=ksds*. - *key_offset* should only be provided when *type=KSDS* + *key_offset* should only be provided when *type=ksds* | **required**: False | **type**: int @@ -274,9 +276,9 @@ dest_data_set key_length The key length to use when creating a KSDS data set. - *key_length* is required when *type=KSDS*. + *key_length* is required when *type=ksds*. - *key_length* should only be provided when *type=KSDS* + *key_length* should only be provided when *type=ksds* | **required**: False | **type**: int @@ -336,6 +338,7 @@ force | **required**: False | **type**: bool + | **default**: False remote_src @@ -345,6 +348,7 @@ remote_src | **required**: False | **type**: bool + | **default**: False @@ -358,14 +362,14 @@ Examples # Simple extract - name: Copy local tar file and unpack it on the managed z/OS node. zos_unarchive: - path: "./files/archive_folder_test.tar" + src: "./files/archive_folder_test.tar" format: name: tar # use include - name: Unarchive a bzip file selecting only a file to unpack. zos_unarchive: - path: "/tmp/test.bz2" + src: "/tmp/test.bz2" format: name: bz2 include: @@ -374,7 +378,7 @@ Examples # Use exclude - name: Unarchive a terse data set and excluding data sets from unpacking. zos_unarchive: - path: "USER.ARCHIVE.RESULT.TRS" + src: "USER.ARCHIVE.RESULT.TRS" format: name: terse exclude: @@ -384,12 +388,12 @@ Examples # List option - name: List content from XMIT zos_unarchive: - path: "USER.ARCHIVE.RESULT.XMIT" + src: "USER.ARCHIVE.RESULT.XMIT" format: name: xmit format_options: - use_adrdssu: True - list: True + use_adrdssu: true + list: true @@ -400,6 +404,8 @@ Notes .. note:: VSAMs are not supported. + This module uses `zos_copy <./zos_copy.html>`_ to copy local scripts to the remote machine which uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; SCP (secure copy protocol) and Co:Z SFTP are not supported. In the case of Co:z SFTP, you can exempt the Ansible user id on z/OS from using Co:Z thus falling back to using standard SFTP. If the module detects SCP, it will temporarily use SFTP for transfers, if not available, the module will fail. + See Also @@ -407,7 +413,7 @@ See Also .. seealso:: - - :ref:`zos_unarchive_module` + - :ref:`zos_archive_module` @@ -416,14 +422,14 @@ Return Values ------------- -path - File path or data set name unarchived. +src + File path or data set name unpacked. | **returned**: always | **type**: str dest_path - Destination path where archive was extracted. + Destination path where archive was unpacked. | **returned**: always | **type**: str diff --git a/_sources/ibm_zos_core/docs/source/modules/zos_volume_init.rst.txt b/_sources/ibm_zos_core/docs/source/modules/zos_volume_init.rst.txt index 19543592..5647ad99 100644 --- a/_sources/ibm_zos_core/docs/source/modules/zos_volume_init.rst.txt +++ b/_sources/ibm_zos_core/docs/source/modules/zos_volume_init.rst.txt @@ -159,14 +159,14 @@ Examples zos_volume_init: address: "1234" volid: "DEMO01" - sms_managed: no + sms_managed: false - name: Initialize non-SMS managed target volume with all the default options and override the default high level qualifier (HLQ). zos_volume_init: address: 1234 volid: DEMO01 - sms_managed: no + sms_managed: false tmp_hlq: TESTUSR - name: Initialize a new SMS managed DASD volume with new volume serial 'e8d8' with 30 track VTOC, an index, as long as @@ -175,12 +175,12 @@ Examples zos_volume_init: address: e8d8 vtoc_size: 30 - index: yes - sms_managed: yes + index: true + sms_managed: true volid: ine8d8 verify_volid: ine8d8 - verify_volume_empty: yes - verify_offline: no + verify_volume_empty: true + verify_offline: false - name: Initialize 3 new DASD volumes (0901, 0902, 0903) for use on a z/OS system as 'DEMO01', 'DEMO02', 'DEMO03' using Ansible loops. diff --git a/_sources/ibm_zos_core/docs/source/plugins.rst.txt b/_sources/ibm_zos_core/docs/source/plugins.rst.txt index 5c8605ad..b2634ab5 100644 --- a/_sources/ibm_zos_core/docs/source/plugins.rst.txt +++ b/_sources/ibm_zos_core/docs/source/plugins.rst.txt @@ -5,30 +5,34 @@ Plugins ======= -Plugins that come with the **IBM z/OS core collection** augment Ansible's core +Plugins that come with the **IBM z/OS core collection** complement Ansible's core functionality. Ansible uses a plugin architecture to enable a rich, flexible and expandable feature set. Action ------ -* ``zos_ping``: Manages the REXX source transferred to the z/OS managed node for - `zos_ping`_. -* ``zos_copy``: Used to `copy data`_ from the controller to the z/OS managed - node. -* ``zos_fetch``: Used to `fetch data`_ from the z/OS managed node to the - controller. -* ``zos_job_submit``: Used to `submit a job`_ from the controller and optionally - monitor the job completion. +Action plugins integrate local processing and local data with module functionality. +Action plugins are executed by default when an associated module is used; no additional +user action is required, this documentation is reference only. -.. _normal: - https://github.com/ansible/ansible/blob/devel/lib/ansible/plugins/action/normal.py -.. _zos_ping: - modules/zos_ping.html -.. _copy data: +* `zos_copy`_: Used to copy data from the controller to the z/OS manage node. +* `zos_fetch`_: Used to fetch data from the z/OS managed node to the controller. +* `zos_job_submit`_: Used to submit a job from the controller to the z/OS manage node. +* `zos_ping`_: Used to transfer the modules REXX source to the z/OS managed node. +* `zos_script`_: Used to transfer scripts from the controller to the z/OS manage node. +* `zos_unarchive`_: Used to transfer archives from the controller to the z/OS manage node. + +.. _zos_copy: modules/zos_copy.html -.. _fetch data: +.. _zos_fetch: modules/zos_fetch.html -.. _submit a job: +.. _zos_job_submit: modules/zos_job_submit.html - +.. _zos_ping: + modules/zos_ping.html +.. _zos_script: + modules/zos_script.html +.. _zos_unarchive: + modules/zos_unarchive.html + diff --git a/_sources/ibm_zos_core/docs/source/reference/community.rst.txt b/_sources/ibm_zos_core/docs/source/reference/community.rst.txt new file mode 100644 index 00000000..9c09aeea --- /dev/null +++ b/_sources/ibm_zos_core/docs/source/reference/community.rst.txt @@ -0,0 +1,17 @@ +.. ........................................................................... +.. © Copyright IBM Corporation 2020, 2021 . +.. ........................................................................... + +============ +Contributing +============ + +Contributing to collections as a member of the open source community varies for +each collection. Although the collections come together as a unified solution, +each offering operates on its own; therefore, review the individual collections to learn +how to contribute. + +.. toctree:: + :maxdepth: 1 + + z/OS core \ No newline at end of file diff --git a/_sources/ibm_zos_core/docs/source/reference/documentation.rst.txt b/_sources/ibm_zos_core/docs/source/reference/documentation.rst.txt new file mode 100644 index 00000000..9e16806b --- /dev/null +++ b/_sources/ibm_zos_core/docs/source/reference/documentation.rst.txt @@ -0,0 +1,18 @@ +.. ........................................................................... +.. © Copyright IBM Corporation 2024 . +.. ........................................................................... + +============= +Documentation +============= + +In addition to the common reference material included in Helpful Links, +each collection in the **Red Hat® Ansible Certified Content for IBM Z** +includes supplementary documentation specific to the collection. Examples of +such documentation include Web Services APIs, guidelines for development and +testing the modules, offering-specific reading, etc. + +.. toctree:: + :maxdepth: 1 + + z/OS core <../resources/resources> diff --git a/_sources/ibm_zos_core/docs/source/release_notes.rst.txt b/_sources/ibm_zos_core/docs/source/release_notes.rst.txt index 10150952..82539a0d 100644 --- a/_sources/ibm_zos_core/docs/source/release_notes.rst.txt +++ b/_sources/ibm_zos_core/docs/source/release_notes.rst.txt @@ -1,13 +1,299 @@ .. ........................................................................... -.. © Copyright IBM Corporation 2020, 2021, 2023 . +.. © Copyright IBM Corporation 2020, 2024 . .. ........................................................................... ======== Releases ======== -Version 1.8.0-beta.1 -==================== +Version 1.10.0 +============== + +Major Changes +------------- + +- Starting with IBM Ansible z/OS core version 1.10.x, ZOAU version 1.3.0 will be required. +- Starting with IBM Ansible z/OS core version 1.10.x, all module options are case sensitive, + review the porting guide for specifics. +- The README has been updated with a new template. +- The **Reference** section has been renamed to **Requirements** and now includes a support matrix. + +Minor Changes +------------- + +- ``zos_apf`` - Enhanced error messages when an exception is caught. +- ``zos_backup_restore`` - Added option **tmp_hlq** to the user module to override the default high level qualifier (HLQ) for temporary and backup data sets. +- ``zos_copy`` - Documented module options `group` and `owner`. + +Bugfixes +-------- + +- ``zos_apf`` - Option **list** previously only returned one data set, now it returns a list of retrieved data sets. +- ``zos_blockinfile`` - Option **block** when containing double double quotation marks results in a task failure (failed=True); now the module handles this case to avoid failure. +- ``zos_find`` - Option **size** failed if a PDS/E matched the pattern, now filtering on utilized size for a PDS/E is supported. + +- ``zos_job_submit`` + + - Did not default to **location=DATA_SET** when no location was defined, now the location defaults to DATA_SET. + - Option **max_rc** previously did not influence a modules status, now the option value influences the tasks failure status. + +- ``zos_mvs_raw`` - Option **tmp_hlq** when creating temporary data sets was previously ignored, now the option honors the High Level Qualifier for temporary data sets created during the module execution. + +Porting Guide +------------- + +This section discusses the behavioral changes between ``ibm_zos_core`` v1.9.0 and ``ibm_zos_core`` v1.10.0-beta.1. +It is intended to assist in updating your playbooks so this collection will continue to work. + +- ``zos_archive`` + + - option **terse_pack** no longer accepts uppercase choices, users should replace them with lowercase ones. + - suboption **record_format** of **dest_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + - suboption **space_type** of **dest_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + - suboption **type** of **dest_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + +- ``zos_backup_restore`` - option **space_type** no longer accepts uppercase choices, users should replace them with lowercase ones. + +- ``zos_copy`` + + - suboption **record_format** of **dest_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + - suboption **space_type** of **dest_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + - suboption **type** of **dest_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + +- ``zos_data_set`` + + - option **record_format** no longer accepts uppercase choices, users should replace them with lowercase ones. + - option **space_type** no longer accepts uppercase choices, users should replace them with lowercase ones. + - option **type** no longer accepts uppercase choices, users should replace them with lowercase ones. + - options inside **batch** no longer accept uppercase choices, users should replace them with lowercase ones. + +- ``zos_job_submit`` - option **location** no longer accepts uppercase choices, users should replace them with lowercase ones. + +- ``zos_mount`` + + - option **automove** no longer accepts uppercase choices, users should replace them with lowercase ones. + - option **fs_type** no longer accepts uppercase choices, users should replace them with lowercase ones. + - option **mount_opts** no longer accepts uppercase choices, users should replace them with lowercase ones. + - option **tag_untagged** no longer accepts uppercase choices, users should replace them with lowercase ones. + - option **unmount_opts** no longer accepts uppercase choices, users should replace them with lowercase ones. + +- ``zos_mvs_raw`` + + - options inside **dd_concat** no longer accept uppercase choices, users should replace them with lowercase ones. + - suboption **record_format** of **dd_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + - suboption **record_format** of **dd_unix** no longer accepts uppercase choices, users should replace them with lowercase ones. + - suboption **space_type** of **dd_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + - suboption **type** of **dd_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + - suboptions **disposition_normal** and **disposition_abnormal** of **dd_data_set** no longer accept **catlg** and **uncatlg** as choices. This also applies when defining a **dd_data_set** inside **dd_concat**. + +- ``zos_unarchive`` + + - suboption **record_format** of **dest_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + - suboption **space_type** of **dest_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + - suboption **type** of **dest_data_set** no longer accepts uppercase choices, users should replace them with lowercase ones. + +Availability +------------ + +* `Automation Hub`_ +* `Galaxy`_ +* `GitHub`_ + +Requirements +------------ + +The IBM z/OS core collection has several dependencies, please review the `z/OS core support matrix`_ to understand both the +controller and z/OS managed node dependencies. + +Known Issues +------------ +- ``zos_job_submit`` - when setting 'location' to 'local' and not specifying the from and to encoding, the modules defaults are not read leaving the file in its original encoding; explicitly set the encodings instead of relying on the default. +- ``zos_job_submit`` - when submitting JCL, the response value returned for **byte_count** is incorrect. +- ``zos_data_set`` - When data set creation fails, exception can throw a bad import error instead of data set creation error. +- ``zos_copy`` - To use this module, you must define the RACF FACILITY class profile and allow READ access to RACF FACILITY profile MVS.MCSOPER.ZOAU. If your system uses a different security product, consult that product's documentation to configure the required security classes. +- ``zos_job_submit``, ``zos_job_output``, ``zos_operator_action_query`` - encounters JSON decoding (DecodeError, TypeError, KeyError) errors when interacting with results that contain non-printable UTF-8 characters in the response. This will be addressed in **ZOAU version 1.3.2** and later. + + - Some options to work around this known issue are: + + - Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters. + - Ignore module errors by using **ignore_errors:true** for a specific playbook task. + - If the error is resulting from a batch job, add **ignore_errors:true** to the task and capture the output into a registered variable to extract the + job ID with a regular expression. Then use ``zos_job_output`` to display the DD without the non-printable character such as the DD **JESMSGLG**. + - If the error is the result of a batch job, set option **return_output** to false so that no DDs are read which could contain the non-printable UTF-8 characters. + +- In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, this is so that the collection can continue to maintain certified status. +- Use of special characters (#, @, $, \- ) in different options like data set names and commands is not fully supported, some modules support them but is the user responsibility to escape them. Read each module documentation for further details. + + +Version 1.9.1 +============= + +Bugfixes +-------- + +- ``zos_find`` - Option size failed if a PDS/E matched the pattern, now filtering on utilized size for a PDS/E is supported. +- ``zos_mvs_raw`` - Option **tmp_hlq** when creating temporary data sets was previously ignored, now the option honors the High Level Qualifier for temporary data sets created during the module execution. + +Availability +------------ + +* `Automation Hub`_ +* `Galaxy`_ +* `GitHub`_ + +Requirements +------------ + +The IBM z/OS core collection has several dependencies, please review the `z/OS core support matrix`_ to understand both the +controller and z/OS managed node dependencies. + +Known Issues +------------ + +- ``zos_job_submit`` - when setting 'location' to 'local' and not specifying the from and to encoding, the modules defaults are not read leaving the file in its original encoding; explicitly set the encodings instead of relying on the default. +- ``zos_job_submit`` - when submitting JCL, the response value returned for **byte_count** is incorrect. + +- ``zos_job_submit``, ``zos_job_output``, ``zos_operator_action_query`` - encounters UTF-8 decoding errors when interacting with results that contain non-printable UTF-8 characters in the response. This has been addressed in this release and corrected with **ZOAU version 1.2.5.6** or later. + + - If the appropriate level of ZOAU can not be installed, some options are to: + + - Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters. + - Ignore module errors by using **ignore_errors:true** for a specific playbook task. + - If the error is resulting from a batch job, add **ignore_errors:true** to the task and capture the output into a registered variable to extract the + job ID with a regular expression. Then use ``zos_job_output`` to display the DD without the non-printable character such as the DD **JESMSGLG**. + - If the error is the result of a batch job, set option **return_output** to false so that no DDs are read which could contain the non-printable UTF-8 characters. + +- ``zos_data_set`` - An undocumented option **size** was defined in module **zos_data_set**, this has been removed to satisfy collection certification, use the intended and documented **space_primary** option. + +- In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, this is so that the collection can continue to maintain certified status. + +Version 1.9.0 +============= + +Major Changes +------------- + - IBM Ansible z/OS core collection (**ibm_zos_core**) version 1.9.0 will be the last release to support ZOAU 1.2.x. + + - IBM Ansible z/OS core version 1.9.0 will continue to receive security updates and bug fixes. + + - Starting with IBM Ansible z/OS core version 1.10.0, ZOAU version 1.3.0 will be required. + - IBM Open Enterprise SDK for Python version 3.9.x is no longer supported. + +Minor Changes +------------- +- ``zos_apf`` - Improved exception handling when the module is unable to process a response originating as a batch update. +- ``zos_copy`` - Improved performance when copying multiple members from one PDS/E to another PDS/E. +- ``zos_job_output`` - Has been enhanced to allow for both a job ID and owner to be selected when obtaining job output, removing the prior mutual exclusivity. +- ``zos_operator`` - Improved the modules handling of ZOAU import errors allowing for the traceback to flow back to the source. +- ``zos_job_query`` - Improved the modules handling of ZOAU import errors allowing for the traceback to flow back to the source. +- ``zos_job_submit`` + + - Improved messages in the action plugin. + - Improved the action plugin performance, flow and use of undocumented variables. + - Improved the modules handling of ZOAU import errors allowing for the traceback to flow back to the source. + - Improved job status support, now the supported statuses for property **ret_code[msg]** are: + + - Job status **ABEND** indicates the job ended abnormally. + - Job status **AC** indicates the job is active, often a started task or job taking long. + - Job status **CAB** indicates a converter abend. + - Job status **CANCELED** indicates the job was canceled. + - Job status **CNV** indicates a converter error. + - Job status **FLU** indicates the job was flushed. + - Job status **JCLERR** or **JCL ERROR** indicates the JCL has an error. + - Job status **SEC** or **SEC ERROR** indicates the job as encountered a security error. + - Job status **SYS** indicates a system failure. + - Job status **?** indicates status can not be determined. + +- ``zos_tso_command`` + + - Has been updated with a new example demonstrating how to explicitly execute a REXX script in a data set. + - Has been updated with a new example demonstrating how to chain multiple TSO commands into one invocation using semicolons. + +- ``zos_mvs_raw`` + + - Has been enhanced to ensure that **instream-data** for option **dd_input** contain blanks in columns 1 and 2 while retaining a maximum length + of 80 columns for strings and a list of strings. This is generally the requirement for most z/OS programs. + - Has been updated with new examples demonstrating a YAML block indicator, often helpful when wanting to control the + **instream-data** formatting. + + +Bugfixes +-------- + +- ``zos_apf`` - Fixed an issue that when **operation=list** was selected and more than one data set entry was fetched, only one + data set was returned, now the complete list is returned. + +- ``zos_copy`` + + - Fixed an issue that when copying an aliased executable from a data set to a non-existent data set, the destination + datasets primary and secondary extents would not match the source data set extent sizes. + - Fixed an issue when performing a copy operation to an existing file, the copied file resulted in having corrupted contents. + +- ``zos_job_submit`` + + - Fixed an issue that when no **location** is set, the default is not correctly configured to **location=DATA_SET**. + - Fixed an issue that when a JCL error is encountered, the **ret_code[msg_code]** no longer will contain the multi line marker used to coordinate errors. + - Fixed an issue that when a response was returned, the property **ret_code[msg_text]** was incorrectly returned over **ret_code[msg_txt]**. + - Fixed an issue that when JCL contained **TYPRUN=SCAN**, the module would fail. The module no longer fails and an appropriate message and response is returned. + - Fixed an issue that when JCL contained either **TYPRUN=COPY**, **TYPRUN=HOLD**, or **TYPRUN=JCLHOLD** an improper message was returned and the job submission failed. + Now the job will fail under the condition that the module has exceeded its wait time and return a proper message. + - Fixed an issue where when option **wait_time_s** was used, the duration would be approximately 5 seconds longer than what was reported in the duration. + Now the duration is from when the job is submitted to when the module reads the job output. + +- ``zos_job_output`` - Fixed an issue that when using a job ID with less than 8 characters, would result in a traceback. The fix + supports shorter job IDs as well as the use of wildcards. + +- ``zos_job_query`` - Fixed an issue that when using a job ID with less than 8 characters, would result in a traceback. The fix + supports shorter job IDs as well as the use of wildcards. + +- ``zos_unarchive`` + + - Fixed an issue that when using a local file with the USS format option, the module would fail to send the archive to the managed node. + - Fixed an issue that occurred when unarchiving USS files, the module would leave temporary files behind on the managed node. + +- ``module_utils`` + + - ``job.py`` - Improved exception handling and added a message inside the **content** of the **ddname** when a non-printable + character (character that can not be converted to UTF-8) is encountered. + - ``data_set.py`` - Fixed an issue that when a volser name less than 6 characters was encountered, the volser name was padded with hyphens to have length 6. + + +Known Issues +------------ + +Several modules have reported UTF-8 decoding errors when interacting with results that contain non-printable UTF-8 characters in the response. + +- This occurs when a module receives content that does not correspond to a UTF-8 value. These include modules ``zos_job_submit``, ``zos_job_output``, + ``zos_operator_action_query``` but are not limited to this list. This has been addressed in this release and corrected with **ZOAU version 1.2.5.6**. +- If the appropriate level of ZOAU can not be installed, some options are to: + + - Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters. + - Ignore module errors by using **ignore_errors:true** for a specific playbook task. + - If the error is resulting from a batch job, add **ignore_errors:true** to the task and capture the output into a registered variable to extract the + job ID with a regular expression. Then use ``zos_job_output`` to display the DD without the non-printable character such as the DD **JESMSGLG**. + - If the error is the result of a batch job, set option **return_output** to false so that no DDs are read which could contain the non-printable UTF-8 characters. + +An undocumented option **size** was defined in module **zos_data_set**, this has been removed to satisfy collection certification, use the intended +and documented **space_primary** option. + +In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, +this is so that the collection can continue to maintain certified status. + +Availability +------------ + +* `Automation Hub`_ +* `Galaxy`_ +* `GitHub`_ + +Requirements +------------ + +The IBM z/OS core collection has several dependencies, please review the `z/OS core support matrix`_ to understand both the +controller and z/OS managed node dependencies. + +Version 1.8.0 +============= New Modules ----------- @@ -22,49 +308,73 @@ Minor Changes - Enhanced test cases to use test lines the same length of the record length. - ``zos_copy`` - - Add validation into path joins to detect unauthorized path traversals. + - Add validation into path joins to detect unauthorized path traversals. - Add new option `force_lock` that can copy into data sets that are already in use by other processes (DISP=SHR). User needs to use with caution because this is subject to race conditions and can lead to data loss. - - includes a new option `executable` that enables copying of executables such as load modules or program objects to both USS and partitioned data sets. When the `dest` option contains a non-existent data set, `zos_copy` will create a data set with the appropriate attributes for an executable. - - introduces a new option 'aliases' to enable preservation of member aliases when copying data to partitioned data sets (PDS) destinations from USS or other PDS sources. Copying aliases of text based members to/from USS is not supported. - - add support in zos_copy for text files and data sets containing ASA control characters. + - Includes a new option `executable` that enables copying of executables such as load modules or program objects to both USS and partitioned data sets. When the `dest` option contains a non-existent data set, `zos_copy` will create a data set with the appropriate attributes for an executable. + - Introduces a new option 'aliases' to enable preservation of member aliases when copying data to partitioned data sets (PDS) destinations from USS or other PDS sources. Copying aliases of text based members to/from USS is not supported. + - Add support in zos_copy for text files and data sets containing ASA control characters. - ``zos_fetch`` - Add validation into path joins to detect unauthorized path traversals. -- ``zos_job_submit`` - Change action plugin call from copy to zos_copy. -- ``zos_operator`` - Changed system to call 'wait=true' parameter to zoau call. Requires zoau 1.2.5 or later. +- ``zos_job_submit`` + + - Change action plugin call from copy to zos_copy. + - Previous code did not return output, but still requested job data from the target system. This changes to honor `return_output=false` by not querying the job dd segments at all. +- ``zos_operator`` - Changed system to call `wait=true` parameter to zoau call. Requires zoau 1.2.5 or later. - ``zos_operator_action_query`` - Add a max delay of 5 seconds on each part of the operator_action_query. Requires zoau 1.2.5 or later. - ``zos_unarchive`` - - Add validation into path joins to detect unauthorized path traversals. + - Add validation into path joins to detect unauthorized path traversals. - Enhanced test cases to use test lines the same length of the record length. - ``module_utils/template`` - Add validation into path joins to detect unauthorized path traversals. +- ``zos_tso_command`` - Add example for executing explicitly a REXX script from a data set. +- ``zos_script`` - Add support for remote_tmp from the Ansible configuration to setup where temporary files will be created, replacing the module option tmp_path. Bugfixes -------- -- ``zos_copy`` - Update option limit to include LIBRARY as dest_dataset/suboption value. Documentation updated to reflect this change. -- ``zos_job_submit`` - Temporary files were created in tmp directory. Fix now ensures the deletion of files every time the module run. -- ``zos_job_submit`` - The last line of the jcl was missing in the input. Fix now ensures the presence of the full input in job_submit. +- ``zos_copy`` + + - Update option to include `LIBRARY` as dest_dataset/suboption value. Documentation updated to reflect this change. + - When copying an executable data set from controller to managed node, copy operation failed with an encoding error. Fix now avoids encoding when `executable` option is selected. + - When copying an executable data set with aliases and destination did not exist, destination data set was created with wrong attributes. Fix now creates destination data set with the same attributes as the source. + - When performing a copy operation to an existing file, the copied file resulted in having corrupted contents. Fix now implements a workaround to not use the specific copy routine that corrupts the file contents. +- ``zos_job_submit`` + + - Temporary files were created in tmp directory. Fix now ensures the deletion of files every time the module run. + - The last line of the jcl was missing in the input. Fix now ensures the presence of the full input in job_submit. - ``zos_lineinfile`` - A duplicate entry was made even if line was already present in the target file. Fix now prevents a duplicate entry if the line already exists in the target file. -- ``zos_operator`` - The last line of the operator was missing in the response of the module. The fix now ensures the presence of the full output of the operator. +- ``zos_operator`` + + - The last line of the operator was missing in the response of the module. The fix now ensures the presence of the full output of the operator. + - The module was ignoring the wait time argument. The module now passes the wait time argument to ZOAU. +- ``zos_operator_action_query`` - The module was ignoring the wait time argument. The module now passes the wait time argument to ZOAU. +- ``zos_unarchive`` - When zos_unarchive fails during unpack either with xmit or terse it does not clean the temporary data sets created. Fix now removes the temporary data sets. Known Issues ------------ -- Several modules have reported UTF8 decoding errors when interacting with results that contain non-printable UTF8 characters in the response. This occurs when a module receives content that does not correspond to a UTF-8 value. These include modules `zos_job_submit`, `zos_job_output`, `zos_operator_action_query` but are not limited to this list. This will be addressed in `ibm_zos_core` version 1.10.0-beta.1. Each case is unique, some options to work around the error are below. - Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters. - Add `ignore_errors:true` to the playbook task so the task error will not fail the playbook. - If the error is resulting from a batch job, add `ignore_errors:true` to the task and capture the output into a variable and extract the job ID with a regular expression and then use `zos_job_output` to display the DD without the non-printable character such as the DD `JESMSGLG`. -- With later versions of `ansible-core` used with `ibm_zos_core` collection a warning has started to appear "Module "ansible.builtin.command" returned non UTF-8 data in the JSON response" that is currently being reviewed. There are no recommendations at this point. +Several modules have reported UTF-8 decoding errors when interacting with results that contain non-printable UTF-8 characters in the response. + +This occurs when a module receives content that does not correspond to a UTF-8 value. These include modules ``zos_job_submit``, ``zos_job_output``, +``zos_operator_action_query``` but are not limited to this list. This will be addressed in **ibm_zos_core** version 1.10.0-beta.1. Each case is +unique, some options to work around the error are below. + +- Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters. +- Add **ignore_errors:true** to the playbook task so the task error will not fail the playbook. +- If the error is resulting from a batch job, add **ignore_errors:true** to the task and capture the output into a variable and extract the job ID with + a regular expression and then use ``zos_job_output`` to display the DD without the non-printable character such as the DD **JESMSGLG**. Availability ------------ +* `Automation Hub`_ * `Galaxy`_ * `GitHub`_ -Reference ---------- +Requirements +------------ -* Supported by `z/OS®`_ V2R4 or later -* Supported by the `z/OS® shell`_ -* Supported by `IBM Open Enterprise SDK for Python`_ `3.9`_ - `3.11`_ -* Supported by IBM `Z Open Automation Utilities 1.2.4`_ (or later) but prior to version 1.3. +The IBM z/OS core collection has several dependencies, please review the `z/OS core support matrix`_ to understand both the +controller and z/OS managed node dependencies. Version 1.7.0 ============= @@ -125,13 +435,11 @@ Availability * `Galaxy`_ * `GitHub`_ -Reference ---------- +Requirements +------------ -* Supported by `z/OS®`_ V2R4 or later -* Supported by the `z/OS® shell`_ -* Supported by `IBM Open Enterprise SDK for Python`_ `3.9`_ - `3.11`_ -* Supported by IBM `Z Open Automation Utilities 1.2.3`_ (or later) but prior to version 1.3. +The IBM z/OS core collection has several dependencies, please review the `z/OS core support matrix`_ to understand both the +controller and z/OS managed node dependencies. Version 1.6.0 ============= @@ -188,13 +496,11 @@ Availability * `Galaxy`_ * `GitHub`_ -Reference ---------- +Requirements +------------ -* Supported by `z/OS®`_ V2R4 or later -* Supported by the `z/OS® shell`_ -* Supported by `IBM Open Enterprise SDK for Python`_ `3.9`_ - `3.11`_ -* Supported by IBM `Z Open Automation Utilities 1.2.2`_ (or later) but prior to version 1.3. +The IBM z/OS core collection has several dependencies, please review the `z/OS core support matrix`_ to understand both the +controller and z/OS managed node dependencies. Version 1.5.0 ============= @@ -304,562 +610,11 @@ Availability * `Galaxy`_ * `GitHub`_ -Reference ---------- - -* Supported by `z/OS®`_ V2R4 or later -* Supported by the `z/OS® shell`_ -* Supported by `IBM Open Enterprise SDK for Python`_ `3.9`_ - `3.11`_ -* Supported by IBM `Z Open Automation Utilities 1.2.2`_ (or later) but prior to version 1.3. - -Version 1.4.1 -============= - -Bug fixes ---------- - -* ``zos_copy`` - - * Copy failed from a loadlib member to another loadlib member. Fix - now looks for error in stdout in the if statement to use -X option. - * Fixes a bug where files not encoded in IBM-1047 would trigger an - error while computing the record length for a new destination dataset. - * Fixes a bug where the code for fixing an issue with newlines in - files. - * fixed wrongful creation of destination backups when module option - `force` is true, creating emergency backups meant to restore the system to - its initial state in case of a module failure only when force is false. - * fixes a bug where the computed record length for a new destination - dataset would include newline characters. - -* ``zos_job_query`` - - * fixes a bug where a boolean was not being properly compared. - -Availability ------------- - -* `Automation Hub`_ -* `Galaxy`_ -* `GitHub`_ - -Reference ---------- - -* Supported by `z/OS®`_ V2R4 or later -* Supported by the `z/OS® shell`_ -* Supported by `IBM Open Enterprise SDK for Python`_ `3.9`_ -* Supported by IBM `Z Open Automation Utilities 1.1.0`_ and - `Z Open Automation Utilities 1.1.1`_ - -Version 1.4.0 -============= - -* Modules - - * ``zos_mount`` can manage mount operations for a - z/OS UNIX System Services (USS) file system data set. - -* Plugins - - * ``zos_ssh`` connection plugin has been removed from this release and is no - longer a dependency for the ``zos_ping`` module. - -* Bug fixes and enhancements - - * Modules - - * ``zos_copy`` - - * introduced an updated creation policy referred to as precedence rules - that if `dest_data_set` is set, it will take precedence. If - `dest` is an empty data set, the empty data set will be written with the - expectation its attributes satisfy the copy. If no precedent rule - has been exercised, `dest` will be created with the same attributes of - `src`. - * introduced new computation capabilities that if `dest` is a nonexistent - data set, the attributes assigned will depend on the type of `src`. If - `src` is a USS file, `dest` will have a Fixed Block (FB) record format - and the remaining attributes will be computed. If `src` is binary, - `dest` will have a Fixed Block (FB) record format with a record length - of 80, block size of 32760, and the remaining attributes will be - computed. - * enhanced the force option when `force=true` and the remote file or - data set `dest`` is NOT empty, the `dest` will be deleted and recreated - with the `src` data set attributes, otherwise it will be recreated with - the `dest` data set attributes. - * was enhanced for when `src` is a directory and ends with "/", - the contents of it will be copied into the root of `dest`. It it doesn't - end with "/", the directory itself will be copied. - * option `dest_dataset` has been deprecated and removed in favor - of the new option `dest_data_set`. - * fixes a bug that when a directory is copied from the controller to the - managed node and a mode is set, the mode is applied to the directory - on the managed node. If the directory being copied contains files and - mode is set, mode will only be applied to the files being copied not the - pre-existing files. - * fixes a bug that did not create a data set on the specified volume. - * fixes a bug where a number of attributes were not an option when using - `dest_data_set`. - * fixes a bug where options were not defined in the module - argument spec that will result in error when running `ansible-core` - v2.11 and using options `force` or `mode`. - * was enhanced to support the ``ansible.builtin.ssh`` connection options; - for further reference refer to the `SSH plugin`_ documentation. - * was enhanced to take into account the record length when the - source is a USS file and the destination is a data set with a record - length. This is done by inspecting the destination data set attributes - and using these attributes to create a new data set. - * was updated with the capabilities to define destination data sets from - within the ``zos_copy`` module. In the case where you are copying to - data set destination that does not exist, you can now do so using the - new ``zos_copy`` module option ``destination_dataset``. - - * ``zos_operator`` - - * enhanced to allow for MVS operator `SET` command, `SET` is - equivalent to the abbreviated `T` command. - - * ``zos_mount`` fixed option `tag_ccsid` to correctly allow for type int. - - * ``module_utils`` - - * jobs.py - fixes a utility used by module `zos_job_output` that would - truncate the DD content. - - * ``zos_ping`` was enhanced to remove the need for the ``zos_ssh`` - connection plugin dependency. - - * ``zos_fetch`` was enhanced to support the ``ansible.builtin.ssh`` - connection options; for further reference refer to the - `SSH plugin`_ documentation. - - * ``zos_job_output`` - - * was updated to correct possible truncated responses for - the **ddname** content. This would occur for jobs with very large amounts - of content from a **ddname**. - * was enhanced to to include the completion code (CC) for each individual - jop step as part of the ``ret_code`` response. - - * ``zos_job_query`` - - * was enhanced to support a 7 digit job number ID for when there are - greater than 99,999 jobs in the history. - * was enhanced to handle when an invalid job ID or job name is used with - the module and returns a proper response. - - * ``zos_job_submit`` - - * was enhanced to fail fast when a submitted job fails instead of waiting - a predetermined time. - * was enhanced to check for 'JCL ERROR' when jobs are submitted and result - in a proper module response. - - * ``zos_operator_action_query`` response messages were improved with more - diagnostic information in the event an error is encountered. - -* Deprecated or removed - - * ``zos_copy`` module option **destination_dataset** has been renamed to - **dest_data_set**. - * ``zos_ssh`` connection plugin has been removed, it is no longer required. - Remove all playbook references, ie ``connection: ibm.ibm_zos_core.zos_ssh``. - * ``zos_ssh`` connection plugin has been removed, it is no longer required. - You must remove the zos_ssh connection plugin from all playbooks that - reference the plugin, for example connection: ibm.ibm_zos_core.zos_ssh. - * ``zos_copy`` module option **model_ds** has been removed. The model_ds logic - is now automatically managed and data sets are either created based on the - ``src`` data set or overridden by the new option ``destination_dataset``. - * ``zos_copy`` and ``zos_fetch`` option **sftp_port** has been deprecated. To - set the SFTP port, use the supported options in the ``ansible.builtin.ssh`` - plugin. Refer to the `SSH port`_ option to configure the port used during - the modules SFTP transport. - -* Documentation - - * Noteworthy documentation updates have been made to: - - * ``zos_copy`` and ``zos_fetch`` about Co:Z SFTP support. - * ``zos_mvs_raw`` removed a duplicate example. - * all action plugins are documented - * update hyperlinks embedded in documentation. - * ``zos_operator`` to explains how to use single quotes in operator commands. - -Availability ------------- - -* `Automation Hub`_ -* `Galaxy`_ -* `GitHub`_ - -Reference ---------- - -* Supported by `z/OS®`_ V2R4 or later -* Supported by the `z/OS® shell`_ -* Supported by `IBM Open Enterprise SDK for Python`_ `3.8`_` - `3.9`_ -* Supported by IBM `Z Open Automation Utilities 1.1.0`_ and - `Z Open Automation Utilities 1.1.1`_ - -Known Issues ------------- - -* If a playbook includes the deprecated ``zos_ssh`` connection plugin, for - example ``connection: ibm.ibm_zos_core.zos_ssh``, it will - encounter this error which can corrected by safely removing the plugin: - - .. code-block:: - - "msg": "the connection plugin 'ibm.ibm_zos_core.zos_ssh' was not found" - -* When using the ``zos_ssh`` plugin with **Ansible 2.11** and earlier versions - of this collection, you will encounter the exception: - - .. code-block:: - - AttributeError: module 'ansible.constants' has no attribute 'ANSIBLE_SSH_CONTROL_PATH_DIR'. - - This is resolved in this release by deprecating the ``zos_ssh`` connection - plugin and removing all ``connection: ibm.ibm_zos_core.zos_ssh`` references - from playbooks. -* When using module ``zos_copy`` and option ``force`` with ansible versions - greater than **Ansbile 2.10** and earlier versions of this collection, an - unsupported option exception would occur. This is resolved in this release. -* When using the ``zos_copy`` or ``zos_fetch`` modules in earlier versions of - this collection without 'passwordless' SSH configured such that you are using - ``--ask-pass`` or passing an ``ansible_password`` in a configuration; during - the playbook execution a second password prompt for SFTP would appear pausing - the playbook execution. This is resolved in this release. -* When using the ``zos_copy`` or ``zos_fetch`` modules, if you tried to use - Ansible connection options such as ``host_key_checking`` or ``port``, they - were not included as part of the modules execution. This is resolved in this - release by ensuring compatibility with the ``ansible.builtin.ssh`` plugin - options. Refer to the `SSH plugin`_ documentation to enable supported options. -* Known issues for modules can be found in the **Notes** section of a modules - documentation. - - -Deprecation Notices -------------------- -Features and functions are marked as deprecated when they are enhanced and an -alternative is available. In most cases, the deprecated item will remain -available unless the deprecated function interferes with the offering. -Deprecated functions are no longer supported, and will be removed in a future -release. - -.. _SSH plugin: - https://docs.ansible.com/ansible/latest/collections/ansible/builtin/ssh_connection.html - -.. _SSH port: - https://docs.ansible.com/ansible/latest/collections/ansible/builtin/ssh_connection.html#parameter-port - -Version 1.3.6 -============= - -What's New ----------- - -* Bug Fixes - - * Modules - - * ``zos_copy`` fixes a bug that when a directory is copied from the - controller to the managed node and a mode is set, the mode is now applied - to the directory on the controller. If the directory being copied contains - files and mode is set, mode will only be applied to the files being copied - not the pre-existing files. - * ``zos_copy`` - fixes a bug where options were not defined in the module - argument spec that will result in error when running `ansible-core` v2.11 - and using options `force` or `mode`. - * ``zos_copy`` - was enhanced for when `src` is a directory and ends with "/", - the contents of it will be copied into the root of `dest`. It it doesn't - end with "/", the directory itself will be copied. - * ``zos_fetch`` - fixes a bug where an option was not defined in the module - argument spec that will result in error when running `ansible-core` v2.11 - and using option `encoding`. - * ``zos_job_submit`` - fixes a bug where an option was not defined in the - module argument spec that will result in error when running - `ansible-core` v2.11 and using option `encoding`. - * ``jobs.py`` - fixes a utility used by module `zos_job_output` that would - truncate the DD content. - * ``zos_ssh`` connection plugin was updated to correct a bug that causes - an `ANSIBLE_SSH_CONTROL_PATH_DIR` attribute error only when using - ansible-core v2.11. - -Availability ------------- - -* `Automation Hub`_ -* `Galaxy`_ -* `GitHub`_ - -Reference ---------- - -* Supported by `z/OS®`_ V2R4 or later -* Supported by the `z/OS® shell`_ -* Supported by `IBM Open Enterprise SDK for Python`_ v3.8.2 - - `IBM Open Enterprise SDK for Python`_ v3.9.5 -* Supported by IBM `Z Open Automation Utilities 1.1.0`_ and - `Z Open Automation Utilities 1.1.1`_ - -Version 1.3.5 -============= - -What's New ----------- - -* Bug Fixes - - * Modules - - * ``zos_ssh`` connection plugin was updated to correct a bug in Ansible that - would result in playbook task ``retries`` overriding the SSH connection - ``retries``. This is resolved by renaming the ``zos_ssh`` option - ``retries`` to ``reconnection_retries``. The update addresses users of - ``ansible-core`` v2.9 which continues to use ``retries`` and users of - ``ansible-core`` v2.11 or later which uses ``reconnection_retries``. This - also resolves a bug in the connection that referenced a deprecated - constant. - * ``zos_job_output`` fixes a bug that returned all ddname's when a specific - ddname was provided. Now a specific ddname can be returned and all others - ignored. - * ``zos_copy`` fixes a bug that would not copy subdirectories. If the source - is a directory with sub directories, all sub directories will now be copied. - -Availability +Requirements ------------ -* `Automation Hub`_ -* `Galaxy`_ -* `GitHub`_ - -Reference ---------- - -* Supported by `z/OS®`_ V2R4 or later -* Supported by the `z/OS® shell`_ -* Supported by `IBM Open Enterprise SDK for Python`_ 3.8.2 or later -* Supported by IBM `Z Open Automation Utilities 1.1.0`_ and - `Z Open Automation Utilities 1.1.1`_ - -Version 1.3.3 -============= - -What's New ----------- - -* Bug Fixes - - * Modules - - * ``zos_copy`` was updated to correct deletion of all temporary files and - unwarranted deletes. - - * When the module would complete, a cleanup routine did not take into - account that other processes had open temporary files and thus would - error when trying to remove them. - * When the module would copy a directory (source) from USS to another - USS directory (destination), any files currently in the destination - would be deleted. - The modules behavior has changed such that files are no longer deleted - unless the ``force`` option is set to ``true``. When ``force=true``, - copying files or a directory to a USS destination will continue if it - encounters existing files or directories and overwrite any - corresponding files. - * ``zos_job_query`` was updated to correct a boolean condition that always - evaluated to "CANCELLED". - - * When querying jobs that are either **CANCELLED** or have **FAILED**, - they were always treated as **CANCELLED**. - -Availability ------------- - -* `Automation Hub`_ -* `Galaxy`_ -* `GitHub`_ - -Reference ---------- - -* Supported by `z/OS®`_ V2R4 or later -* Supported by the `z/OS® shell`_ -* Supported by `IBM Open Enterprise SDK for Python`_ 3.8.2 or later -* Supported by IBM `Z Open Automation Utilities 1.1.0`_ and - `Z Open Automation Utilities 1.1.1`_ - -Version 1.3.1 -============= - -What's New ----------- - -* Bug Fixes - - * Modules - - * Connection plugin ``zos_ssh`` was updated to prioritize the execution of - modules written in REXX over other implementations such is the case for - ``zos_ping``. - * ``zos_ping`` was updated to support Automation Hub documentation - generation. - -Availability ------------- - -* `Automation Hub`_ -* `Galaxy`_ -* `GitHub`_ - -Reference ---------- - -* Supported by `z/OS®`_ V2R4 or later -* Supported by the `z/OS® shell`_ -* Supported by `IBM Open Enterprise SDK for Python`_ 3.8.2 or later -* Supported by IBM `Z Open Automation Utilities 1.1.0`_ and - `Z Open Automation Utilities 1.1.1`_ - -Known issues ------------- - -* Modules - - * When executing programs using ``zos_mvs_raw``, you may encounter errors - that originate in the implementation of the programs. Two such known issues - are noted below of which one has been addressed with an APAR. - - #. ``zos_mvs_raw`` module execution fails when invoking - Database Image Copy 2 Utility or Database Recovery Utility in conjunction - with FlashCopy or Fast Replication. - #. ``zos_mvs_raw`` module execution fails when invoking DFSRRC00 with parm - "UPB,PRECOMP", "UPB, POSTCOMP" or "UPB,PRECOMP,POSTCOMP". This issue is - addressed by APAR PH28089. - -Version 1.3.0 -============= - -What's New ----------- - -* Modules - - * ``zos_apf`` - Add or remove libraries to and from Authorized Program Facility (APF). - * ``zos_backup_restore`` - Backup and restore data sets and volumes. - * ``zos_blockinfile`` - Manage block of multi-line textual data on z/OS. - * ``zos_find`` - Find matching data sets. - * ``zos_data_set`` - added support to allocate and format zFS data sets - * ``zos_operator`` - supports new options **wait** and **wait_time_s** such - that you can specify that ``zos_operator`` wait the full **wait_time_s** or - return as soon as the first operator command executes. - * All modules support relative paths and remove choice case sensitivity. - -* Bug Fixes - - * Modules - - * Action plugin ``zos_copy`` was updated to support Python 2.7. - * Module ``zos_copy`` was updated to fail gracefully when a it - encounters a non-zero return code. - * Module ``zos_copy`` was updated to support copying data set members that - are program objects to a PDSE. Prior to this update, copying data set - members would yield an error: - **FSUM8976 Error writing to PDSE member - ** - * Job utility is an internal library used by several modules. It has been - updated to use a custom written parsing routine capable of handling - special characters to prevent job related reading operations from failing - when a special character is encountered. - * Module ``zos_job_submit`` was updated to remove all trailing **\r** from - jobs that are submitted from the controller. - * Module ``zos_job_submit`` referenced a non-existent option and was - corrected to **wait_time_s**. - * Module ``zos_tso_command`` support was added for when the command output - contained special characters. - - * Playbooks - - * Playbook `zos_operator_basics.yaml`_ - has been updated to use `end` in the WTO reply over the previous use of - `cancel`. Using `cancel` is not a valid reply and results in an execution - error. - -* Playbooks - - * In each release, we continue to expand on use cases and deliver them as - playbooks in the `playbook repository`_ that can be easily tailored to any - system. - - * Authorize and - `synchronize APF authorized libraries on z/OS from a configuration file cloned from GitHub`_ - * Automate program execution with - `copy, sort and fetch data sets on z/OS playbook`_. - * Automate user management with add, remove, grant permission, - generate passwords, create zFS, mount zFS and send email - notifications when deployed to Ansible Tower or AWX with the - `manage z/OS Users Using Ansible`_ playbook. - * Use the `configure Python and ZOAU Installation`_ playbook to scan the - **z/OS** target to find the latest supported configuration and generate - `inventory`_ and a `variables`_ configuration. - * Automate software management with `SMP/E Playbooks`_ - * All playbooks have been updated to use our temporary data set feature - to avoid any concurrent data set name problems. - * In the prior release, all sample playbooks previously included with the - collection were migrated to the `playbook repository`_. The - `playbook repository`_ categorizes playbooks into **z/OS concepts** and - **topics**, it also covers `playbook configuration`_ as well as provide - additional community content such as **blogs** and where to open - `support tickets`_ for the playbooks. - -* Documentation - - * All documentation related to `playbook configuration`_ has been - migrated to the `playbook repository`_. Each playbook contains a README - that explains what configurations must be made to run a sample playbook. - * We have been carefully reviewing our users feedback and over time we have - compiled a list of information that we feel would help everyone and have - released this information in our new `FAQs`_. - * Learn about the latest features and experience them before you try - them through the blogs that discuss playbooks, modules, and use cases: - - * `Running Batch Jobs on z/OS using Ansible`_ details how - to write and execute batch jobs without having to deal with JCL. - - * `z/OS User Management With Ansible`_ explains all about the user management - playbook and its optional integration into AWX. - -Availability ------------- - -* `Galaxy`_ -* `GitHub`_ - -Reference ---------- - -* Supported by `z/OS®`_ V2R4 or later -* Supported by the `z/OS® shell`_ -* Supported by `IBM Open Enterprise SDK for Python`_ 3.8.2 or later -* Supported by IBM `Z Open Automation Utilities 1.1.0`_ and - `Z Open Automation Utilities 1.1.1`_ - -Known issues ------------- - -* Modules - - * When executing programs using ``zos_mvs_raw``, you may encounter errors - that originate in the implementation of the programs. Two such known issues - are noted below of which one has been addressed with an APAR. - - #. ``zos_mvs_raw`` module execution fails when invoking - Database Image Copy 2 Utility or Database Recovery Utility in conjunction - with FlashCopy or Fast Replication. - #. ``zos_mvs_raw`` module execution fails when invoking DFSRRC00 with parm - "UPB,PRECOMP", "UPB, POSTCOMP" or "UPB,PRECOMP,POSTCOMP". This issue is - addressed by APAR PH28089. +The IBM z/OS core collection has several dependencies, please review the `z/OS core support matrix`_ to understand both the +controller and z/OS managed node dependencies. .. ............................................................................. .. Global Links @@ -880,6 +635,10 @@ Known issues https://www.ibm.com/docs/en/python-zos/3.10 .. _3.11: https://www.ibm.com/docs/en/python-zos/3.11 +.. _3.12: + https://www.ibm.com/docs/en/python-zos/3.12 +.. _Z Open Automation Utilities: + https://www.ibm.com/docs/en/zoau/latest .. _Z Open Automation Utilities 1.1.0: https://www.ibm.com/docs/en/zoau/1.1.x .. _Z Open Automation Utilities 1.1.1: @@ -890,6 +649,10 @@ Known issues https://www.ibm.com/docs/en/zoau/1.2.x .. _Z Open Automation Utilities 1.2.4: https://www.ibm.com/docs/en/zoau/1.2.x +.. _Z Open Automation Utilities 1.2.5: + https://www.ibm.com/docs/en/zoau/1.2.x +.. _Z Open Automation Utilities 1.3.0: + https://www.ibm.com/docs/en/zoau/1.3.x .. _z/OS® shell: https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.4.0/com.ibm.zos.v2r4.bpxa400/part1.htm .. _z/OS®: @@ -902,6 +665,8 @@ Known issues https://www.ibm.com/docs/en/zos .. _FAQs: https://ibm.github.io/z_ansible_collections_doc/faqs/faqs.html +.. _z/OS core support matrix: + https://ibm.github.io/z_ansible_collections_doc/ibm_zos_core/docs/build/html/resources/releases_maintenance.html .. ............................................................................. .. Playbook Links diff --git a/_sources/ibm_zos_core/docs/source/requirements_managed.rst.txt b/_sources/ibm_zos_core/docs/source/requirements_managed.rst.txt index 8be71981..24cb80f4 100644 --- a/_sources/ibm_zos_core/docs/source/requirements_managed.rst.txt +++ b/_sources/ibm_zos_core/docs/source/requirements_managed.rst.txt @@ -6,126 +6,87 @@ Managed node ============ The managed z/OS node is the host that is managed by Ansible, as identified in -the Ansible inventory. -The managed node has dependencies that are specific to each release of the -**IBM z/OS core collection**. Review the details of the dependencies before you -proceed to install the IBM z/OS core collection. +the Ansible inventory. For the **IBM z/OS core collection** to manage the z/OS node, +some dependencies are required to be installed on z/OS such as: -* z/OS `V2R3`_ or `later`_ +* `z/OS`_ * `z/OS OpenSSH`_ -* Supported by `IBM Open Enterprise SDK for Python`_ - (previously `IBM Open Enterprise Python for z/OS`_) 3.8.2 or later -* `IBM Z Open Automation Utilities`_ (ZOAU) +* `z/OS® shell`_ +* `IBM Open Enterprise SDK for Python`_ +* `IBM Z Open Automation Utilities`_ - .. note:: - IBM z/OS core collection is dependent on specific versions of - Z Open Automation Utilities (ZOAU). For information about the required - version of ZOAU, review the `release notes`_. For detailed instructions on - installation and configuration of ZOAU, - `Installing and Configuring ZOA Utilities`_. - -* The `z/OS® shell`_ - - .. note:: - Currently, only ``z/OS® shell`` is supported. Using - ``ansible_shell_executable`` to change the default shell is discouraged. - For more information, see `Ansible documentation`_. Shells such as ``bash`` - are not supported because they handle the reading and writing of untagged - files differently. Please review the README.ZOS guide included with the - ported ``bash`` shell for further configurations. - -.. _Ansible documentation: - https://docs.ansible.com/ansible/2.7/user_guide/intro_inventory.html - -.. _Python on z/OS: - requirements_managed.html#id1 - -.. _Installing and Configuring ZOA Utilities: - https://www.ibm.com/support/knowledgecenter/en/SSKFYE_1.1.0/install.html - -.. _V2R3: - https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3/en/homepage.html - -.. _later: - https://www.ibm.com/support/knowledgecenter/SSLTBW - -.. _IBM Z Open Automation Utilities: - requirements_managed.html#zoau - -.. _z/OS OpenSSH: - https://www.ibm.com/support/knowledgecenter/SSLTBW_2.2.0/com.ibm.zos.v2r2.e0za100/ch1openssh.htm - -.. _release notes: - release_notes.html - -.. _playbook configuration: - https://github.com/IBM/z_ansible_collections_samples/blob/main/docs/share/configuration_guide.md +.. note:: -.. _z/OS® shell: - https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.4.0/com.ibm.zos.v2r4.bpxa400/part1.htm + Each release of the IBM z/OS core collection depends on specific dependency + versions. For information on the dependencies or the versions, review the + `release notes`_ reference section. -.. _Z Open Automation Utilities 1.1.0: - https://www.ibm.com/support/knowledgecenter/SSKFYE_1.1.0/install.html +z/OS shell +---------- -.. _configured IBM Open Enterprise Python on z/OS: - https://www.ibm.com/support/knowledgecenter/SSCH7P_3.8.0/install.html +Currently, only the `z/OS® shell`_ is supported. Using ``ansible_shell_executable`` +to change the default shell is discouraged. Shells such as ``bash`` are not supported +because it handles the reading and writing of untagged files differently. -Python on z/OS --------------- +Open Enterprise SDK for Python +------------------------------ -If the Ansible target is z/OS, you must install -**IBM Open Enterprise Python for z/OS** which is ported for the z/OS platform -and required by **IBM z/OS core collection**. +The **IBM z/OS core collection** requires that the **IBM Open Enterprise SDK for Python** +be installed on z/OS. **Installation** -* Visit the `IBM Open Enterprise Python for z/OS`_ product page for FMID, +* Visit the `IBM Open Enterprise SDK for Python`_ product page for the FMID, program directory, fix list, latest PTF, installation and configuration instructions. * For reference, the Program IDs are: * 5655-PYT for the base product * 5655-PYS for service and support -* Optionally, download **IBM Open Enterprise Python for z/OS**, `here`_ -* For the supported Python version, refer to the `release notes`_. - -.. _IBM Open Enterprise Python for z/OS: - http://www.ibm.com/products/open-enterprise-python-zos -.. _IBM Open Enterprise SDK for Python: - https://www.ibm.com/products/open-enterprise-python-zos +* Optionally, `download the IBM Open Enterprise SDK for Python`_ no cost + addition for installation. -.. _here: - https://www-01.ibm.com/marketing/iwm/platform/mrs/assets?source=swg-ibmoep - -.. note:: - - Currently, IBM Open Enterprise Python for z/OS is the supported and - recommended Python distribution for use with Ansible and ZOAU. If - Rocket Python is the only available Python on the target, review the - `recommended environment variables`_ for Rocket Python. - -.. _recommended environment variables: - https://github.com/IBM/z_ansible_collections_samples/blob/main/docs/share/configuration_guide.md#variables - -ZOAU ----- +IBM Z Open Automation Utilities +------------------------------- IBM Z Open Automation Utilities provide support for executing automation tasks -on z/OS. With ZOAU, you can run traditional MVS commands such as IEBCOPY, -IDCAMS, and IKJEFT01, as well as perform a number of data set operations -in the scripting language of your choice. +on z/OS. It can run z/OS programs such as IEBCOPY, IDCAMS and IKJEFT01, perform +data set operations and much more in the scripting language of your choice. **Installation** -* Visit the `ZOAU`_ product page for the FMID, program directory, fix list, - latest PTF, installation, and configuration instructions. +* Visit the `IBM Z Open Automation Utilities`_ product page for the FMID, + program directory, fix list, latest PTF, installation, and configuration + instructions. * For reference, the Program IDs are: * 5698-PA1 for the base product * 5698-PAS for service and support -* For ZOAU supported version, refer to the `release notes`_. +* Optionally, `download the IBM Z Open Automation Utilities`_ no cost + addition for installation. + + +.. _z/OS: + https://www.ibm.com/docs/en/zos + +.. _z/OS OpenSSH: + https://www.ibm.com/docs/en/zos/latest?topic=zbed-zos-openssh + +.. _z/OS® shell: + https://www.ibm.com/docs/en/zos/latest?topic=guide-zos-shells + +.. _IBM Open Enterprise SDK for Python: + https://www.ibm.com/products/open-enterprise-python-zos + +.. _IBM Z Open Automation Utilities: + https://www.ibm.com/docs/en/zoau + +.. _release notes: + release_notes.html -.. _ZOAU: - https://www.ibm.com/support/knowledgecenter/en/SSKFYE +.. _download the IBM Open Enterprise SDK for Python: + https://www.ibm.com/account/reg/us-en/signup?formid=urx-49465 +.. _download the IBM Z Open Automation Utilities: + https://ibm.github.io/mainframe-downloads/downloads.html#devops \ No newline at end of file diff --git a/_sources/ibm_zos_core/docs/source/resources/releases_maintenance.rst.txt b/_sources/ibm_zos_core/docs/source/resources/releases_maintenance.rst.txt new file mode 100644 index 00000000..70fa46e0 --- /dev/null +++ b/_sources/ibm_zos_core/docs/source/resources/releases_maintenance.rst.txt @@ -0,0 +1,102 @@ +.. ........................................................................... +.. © Copyright IBM Corporation 2024 . +.. ........................................................................... + +======================== +Releases and maintenance +======================== + +This table describes the collections release dates, dependency versions and End of Life dates (EOL). + +The ``ibm_zos_core`` collection is developed and released on a flexible release cycle; generally, each quarter +a beta is released followed by a GA version. Occasionally, the cycle may be extended to properly implement and +test larger changes before a new release is made available. + +End of Life for this collection is generally a 2-year cycle unless a dependency reaches EOL prior to the 2 years. +For example, if a collection has released and its dependency reaches EOL 1 year later, then the collection will EOL +at the same time as the dependency, 1 year later. + +These are the component versions available when the collection was made generally available (GA). The underlying +component version is likely to change as it reaches EOL, thus components must be a version that is +currently supported. + +For example, if a collection releases with a minimum version of ``ansible-core`` 2.14.0 (Ansible 7.0) and later this +enters into EOL, then a newer supported version of ``ansible-core`` (Ansible) must be selected. When choosing a newer +``ansible-core`` (Ansible) version, review the `ansible-core support matrix`_ to select the appropriate dependencies. +This is important to note, different releases of ``ansible-core`` can require newer control node and managed node +dependencies such as is the case with Python. + +If the control node is Ansible Automation Platform (AAP), review the `Red Hat Ansible Automation Platform Life Cycle`_ +to select a supported AAP version. + +For IBM product lifecycle information, you can search for products using a product name, version or ID. For example, +to view IBM's `Open Enterprise SDK for Python lifecycle`_, search on product ID `5655-PYT`_, and for +`Z Open Automation Utilities lifecycle`_, search on product ID `5698-PA1`_. + +Support Matrix +============== ++---------+----------------------------+---------------------------------------------------+---------------+---------------+ +| Version | Controller | Managed Node | GA | End of Life | ++=========+============================+===================================================+===============+===============+ +| 1.10.x |- `ansible-core`_ >=2.15.x |- `z/OS`_ V2R4 - V2Rx | 21 June 2024 | 21 June 2026 | +| |- `Ansible`_ >=8.0.x |- `z/OS shell`_ | | | +| |- `AAP`_ >=2.4 |- IBM `Open Enterprise SDK for Python`_ | | | +| | |- IBM `Z Open Automation Utilities`_ >=1.3.0 | | | ++---------+----------------------------+---------------------------------------------------+---------------+---------------+ +| 1.9.x |- `ansible-core`_ >=2.14 |- `z/OS`_ V2R4 - V2Rx | 05 Feb 2024 | 30 April 2025 | +| |- `Ansible`_ >=7.0.x |- `z/OS shell`_ | | | +| |- `AAP`_ >=2.3 |- IBM `Open Enterprise SDK for Python`_ | | | +| | |- IBM `Z Open Automation Utilities`_ 1.2.5 - 1.2.x | | | ++---------+----------------------------+---------------------------------------------------+---------------+---------------+ +| 1.8.x |- `ansible-core`_ >=2.14 |- `z/OS`_ V2R4 - V2Rx | 13 Dec 2023 | 30 April 2025 | +| |- `Ansible`_ >=7.0.x |- `z/OS shell`_ | | | +| |- `AAP`_ >=2.3 |- IBM `Open Enterprise SDK for Python`_ | | | +| | |- IBM `Z Open Automation Utilities`_ 1.2.4 - 1.2.x | | | ++---------+----------------------------+---------------------------------------------------+---------------+---------------+ +| 1.7.x |- `ansible-core`_ >=2.14 |- `z/OS`_ V2R4 - V2Rx | 10 Oct 2023 | 30 April 2025 | +| |- `Ansible`_ >=7.0.x |- `z/OS shell`_ | | | +| |- `AAP`_ >=2.3 |- IBM `Open Enterprise SDK for Python`_ | | | +| | |- IBM `Z Open Automation Utilities`_ 1.2.3 - 1.2.x | | | ++---------+----------------------------+---------------------------------------------------+---------------+---------------+ +| 1.6.x |- `ansible-core`_ >=2.9.x |- `z/OS`_ V2R3 - V2Rx | 28 June 2023 | 30 April 2025 | +| |- `Ansible`_ >=2.9.x |- `z/OS shell`_ | | | +| |- `AAP`_ >=1.2 |- IBM `Open Enterprise SDK for Python`_ | | | +| | |- IBM `Z Open Automation Utilities`_ 1.2.2 - 1.2.x | | | ++---------+----------------------------+---------------------------------------------------+---------------+---------------+ +| 1.5.x |- `ansible-core`_ >=2.9.x |- `z/OS`_ V2R3 - V2Rx | 25 April 2023 | 25 April 2025 | +| |- `Ansible`_ >=2.9.x |- `z/OS shell`_ | | | +| |- `AAP`_ >=1.2 |- IBM `Open Enterprise SDK for Python`_ | | | +| | |- IBM `Z Open Automation Utilities`_ 1.2.2 - 1.2.x | | | ++---------+----------------------------+---------------------------------------------------+---------------+---------------+ + +.. ............................................................................. +.. Global Links +.. ............................................................................. +.. _ansible-core support matrix: + https://docs.ansible.com/ansible/latest/reference_appendices/release_and_maintenance.html#ansible-core-support-matrix +.. _AAP: + https://access.redhat.com/support/policy/updates/ansible-automation-platform +.. _Red Hat Ansible Automation Platform Life Cycle: + https://access.redhat.com/support/policy/updates/ansible-automation-platform +.. _Automation Hub: + https://www.ansible.com/products/automation-hub +.. _Open Enterprise SDK for Python: + https://www.ibm.com/products/open-enterprise-python-zos +.. _Z Open Automation Utilities: + https://www.ibm.com/docs/en/zoau/latest +.. _z/OS shell: + https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.4.0/com.ibm.zos.v2r4.bpxa400/part1.htm +.. _z/OS: + https://www.ibm.com/docs/en/zos +.. _Open Enterprise SDK for Python lifecycle: + https://www.ibm.com/support/pages/lifecycle/search?q=5655-PYT +.. _5655-PYT: + https://www.ibm.com/support/pages/lifecycle/search?q=5655-PYT +.. _Z Open Automation Utilities lifecycle: + https://www.ibm.com/support/pages/lifecycle/search?q=5698-PA1 +.. _5698-PA1: + https://www.ibm.com/support/pages/lifecycle/search?q=5698-PA1 +.. _ansible-core: + https://docs.ansible.com/ansible/latest/reference_appendices/release_and_maintenance.html#ansible-core-support-matrix +.. _Ansible: + https://docs.ansible.com/ansible/latest/reference_appendices/release_and_maintenance.html#ansible-core-support-matrix \ No newline at end of file diff --git a/_sources/ibm_zos_core/docs/source/resources/resources.rst.txt b/_sources/ibm_zos_core/docs/source/resources/resources.rst.txt index 8b595194..8bdb16a6 100644 --- a/_sources/ibm_zos_core/docs/source/resources/resources.rst.txt +++ b/_sources/ibm_zos_core/docs/source/resources/resources.rst.txt @@ -1,5 +1,5 @@ .. ........................................................................... -.. © Copyright IBM Corporation 2020, 2021 . +.. © Copyright IBM Corporation 2024 . .. ........................................................................... ========= @@ -10,3 +10,4 @@ Resources :maxdepth: 1 character_set + releases_maintenance diff --git a/_sources/ibm_zos_ims/docs/ansible_content.rst.txt b/_sources/ibm_zos_ims/docs/ansible_content.rst.txt index 7680d064..cbea90b2 100644 --- a/_sources/ibm_zos_ims/docs/ansible_content.rst.txt +++ b/_sources/ibm_zos_ims/docs/ansible_content.rst.txt @@ -14,7 +14,8 @@ Ansible® Automation to IBM Z through the offering The **IBM z/OS IMS collection** supports tasks such as generating IMS Database Descriptors (DBD), Program Specification Blocks (PSB), Application Control Blocks (ACB), running IMS commands -(type-1, type-2, DBRC), and interacting with the IMS Catalog. +(type-1, type-2, DBRC), interacting with the IMS Catalog, and +the IMS Data Definition Language Utility (DDL). The Ansible modules in this collection are written in Python and interact with the `IBM z/OS core collection`_ and diff --git a/_sources/ibm_zos_ims/docs/source/modules/ims_acb_gen.rst.txt b/_sources/ibm_zos_ims/docs/source/modules/ims_acb_gen.rst.txt index e887ac4d..2827b3c1 100644 --- a/_sources/ibm_zos_ims/docs/source/modules/ims_acb_gen.rst.txt +++ b/_sources/ibm_zos_ims/docs/source/modules/ims_acb_gen.rst.txt @@ -43,11 +43,13 @@ command_input compression PRECOMP,POSTCOMP, in any combination, cause the required in-place compression. + The choices are not mutually exclusive -- PRECOMP or POSTCOMP or PRECOMP,POSTCOMP can be used + The default is none. | **required**: False | **type**: str - | **choices**: precomp, postcomp, precomp,postcomp, PRECOMP, POSTCOMP, PRECOMP,POSTCOMP + | **choices**: PRECOMP, POSTCOMP psb_name diff --git a/_sources/ibm_zos_ims/docs/source/modules/ims_catalog_populate.rst.txt b/_sources/ibm_zos_ims/docs/source/modules/ims_catalog_populate.rst.txt index 6f4cf553..4c5f5915 100644 --- a/_sources/ibm_zos_ims/docs/source/modules/ims_catalog_populate.rst.txt +++ b/_sources/ibm_zos_ims/docs/source/modules/ims_catalog_populate.rst.txt @@ -86,6 +86,13 @@ buffer_pool_param_dataset | **type**: str +dfsdf_member + The DFSDFxxx member in the IMS.PROCLIB data set where the CATALOG section is defined. For example, dfsdf_member is "CAT" specifies the DFSDFCAT member of the PROCLIB data set. + + | **required**: False + | **type**: str + + primary_log_dataset Defines the primary IMS log data set. This is required if dbrc is set to true or if mode 'UPDATE' is selected. @@ -986,6 +993,7 @@ Examples psb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG @@ -1005,6 +1013,7 @@ Examples psb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" control_statements: managed_acbs: setup: true @@ -1025,6 +1034,7 @@ Examples psb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG control_statements: diff --git a/_sources/ibm_zos_ims/docs/source/modules/ims_catalog_purge.rst.txt b/_sources/ibm_zos_ims/docs/source/modules/ims_catalog_purge.rst.txt index 97a01644..bdef6c57 100644 --- a/_sources/ibm_zos_ims/docs/source/modules/ims_catalog_purge.rst.txt +++ b/_sources/ibm_zos_ims/docs/source/modules/ims_catalog_purge.rst.txt @@ -79,6 +79,13 @@ buffer_pool_param_dataset | **type**: str +dfsdf_member + The DFSDFxxx member in the IMS.PROCLIB data set where the CATALOG section is defined. For example, dfsdf_member is "CAT" specifies the DFSDFCAT member of the PROCLIB data set. + + | **required**: False + | **type**: str + + primary_log_dataset Defines the primary IMS log data set. This option is required if you are running the utility as a DLI. @@ -481,6 +488,7 @@ Examples psb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS1.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG1 mode: PURGE @@ -502,6 +510,7 @@ Examples psb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS1.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG1 mode: PURGE @@ -524,6 +533,7 @@ Examples psb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS1.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG1 mode: ANALYSIS @@ -543,6 +553,7 @@ Examples psb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS1.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG1 mode: ANALYSIS diff --git a/_sources/ibm_zos_ims/docs/source/modules/ims_dbd_gen.rst.txt b/_sources/ibm_zos_ims/docs/source/modules/ims_dbd_gen.rst.txt index 1452a9e5..6e78e033 100644 --- a/_sources/ibm_zos_ims/docs/source/modules/ims_dbd_gen.rst.txt +++ b/_sources/ibm_zos_ims/docs/source/modules/ims_dbd_gen.rst.txt @@ -68,7 +68,7 @@ member_list Elements are of the list are str or dict with single key-value pair | **required**: False - | **type**: list + | **type**: raw dbd_name @@ -130,7 +130,7 @@ batch Elements are of the list are str or dict with single key-value pair | **required**: False - | **type**: list + | **type**: raw dbd_name diff --git a/_sources/ibm_zos_ims/docs/source/modules/ims_ddl.rst.txt b/_sources/ibm_zos_ims/docs/source/modules/ims_ddl.rst.txt new file mode 100644 index 00000000..a3b7e9b6 --- /dev/null +++ b/_sources/ibm_zos_ims/docs/source/modules/ims_ddl.rst.txt @@ -0,0 +1,249 @@ + +:github_url: https://github.com/ansible-collections/ibm_zos_core/blob/dev/plugins/modules/ims_ddl.py + +.. _ims_ddl_module: + + +ims_ddl -- Submits Data Definition Language (DDL) SQL statements. +================================================================= + + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- The IMS Data Definition utility (DFS3ID00) utility writes the metadata for your application programs (PSBs) and databases definitions to the IMS Catalog records and the runtime blocks to the staging directory dataset. + + + + + +Parameters +---------- + + +online + Indicates if this utility is to be run in a BMP region. + + If online is true, its BMP enabled. + + online is false is DLI that is not supported currently. + + | **required**: False + | **type**: bool + | **default**: True + + +ims_id + The identifier of the IMS system on which the job is to be run. + + Required if online is true. + + | **required**: False + | **type**: str + + +reslib + Points to an authorized library that contains the IMS SVC modules. + + | **required**: False + | **type**: list + | **elements**: str + + +proclib + Defines the IMS.PROCLIB data set that contains the DFSDFxxx member. The DFSDFxxx member defines various attributes of the IMS catalog that are required by the utility. + + | **required**: True + | **type**: list + | **elements**: str + + +steplib + Points to IMS.SDFSRESL, which contains the IMS nucleus and required IMS modules. + + The steplib parameter can also be specified in the target inventory's environment_vars. + + The steplib input parameter to the module will take precedence over the value specified in the environment_vars. + + | **required**: False + | **type**: list + | **elements**: str + + +sql_input + Defines the SQL DDL statements to be run. + + Can specify the DDL statements in a dataset or dataset member. + + The following concatenations are not supported - Cannot mix FB and VB data sets. - Cannot have concatenated FB data sets with different LRECLs. + + | **required**: True + | **type**: str + + +verbose + Specifies that the DFS3ID00 utility will print full text of the DDL statements in the job log. + + If VERBOSE control option is not specified, then utility will only print full text of failing DDL statement. + + | **required**: False + | **type**: bool + + +auto_commit + Specifies that the DFS3ID00 utility will perform auto Commit if no COMMIT DDL statement is provided by the user. + + If user does not specify AUTOCOMMIT control option or COMMIT DDL statement, then utility will perform auto ROLLBACK DDL. + + | **required**: False + | **type**: bool + + +simulate + Specifies that the DFS3ID00 utility will perform simulation of DDL statements which includes parser validations, commit level validations, block builder validations, and DROP DDL cross-reference validations. + + | **required**: False + | **type**: bool + + +dynamic_programview + Directly maps to DYNAMICPROGRAMVIEW=(CREATEYES | CREATENO) of IMS Data Definition utility utility. + + Specifies that the DFS3ID00 utility will automatically import all the input CREATE PROGRAMVIEWs. + + If CREATEYES is specified, then PDIR will be created with the DOPT flag ON. + + If CREATENO is specified, then PDIR will not be created. + + | **required**: False + | **type**: bool + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: Example of DDL statements are in a dataset + ims_data_definition: + online: True + ims_id: IMS1 + reslib: + - SOME.IMS.SDFSRESL + steplib: + - SOME.IMS.SDFSRESL + proclib: + - SOME.IMS.PROCLIB + sql_input: SOME.IMS.SQL + - name: Example of DDL statements in which VERBOSE and AUTOCOMMIT control options are specified + ims_data_definition: + online: True + ims_id: IMS1 + reslib: + - SOME.IMS.SDFSRESL + steplib: + - SOME.IMS.SDFSRESL + proclib: + - SOME.IMS.PROCLIB + sql_input: SOME.IMS.SQL + verbose: true + auto_commit: true + + - name: Example of DDL statements in which SIMULATE control options is specified + ims_data_definition: + online: True + ims_id: IMS1 + reslib: + - SOME.IMS.SDFSRESL + steplib: + - SOME.IMS.SDFSRESL + proclib: + - SOME.IMS.PROCLIB + sql_input: SOME.IMS.SQL + simulate: true + + - name: Example of DDL statements in which DYNAMIC_PROGRAMVIEW control option is specified + ims_data_definition: + online: True + ims_id: IMS1 + reslib: + - SOME.IMS.SDFSRESL + steplib: + - SOME.IMS.SDFSRESL + proclib: + - SOME.IMS.PROCLIB + sql_input: SOME.IMS.SQL + dynamic_programview: true + + + + + +Notes +----- + +.. note:: + The *steplib* parameter can also be specified in the target inventory's environment_vars. + + The *steplib* input parameter to the module will take precedence over the value specified in the environment_vars. + + If only the *steplib* parameter is specified, then only the *steplib* concatenation will be used to resolve the IMS RESLIB data set. + + Specifying only *reslib* without *steplib* is not supported. + + Currently ddl error messages are returned within the content block of the module response. + + Currently this module only supports running the DDL utility in a BMP region (online is true). + + + + + + + +Return Values +------------- + + +content + The standard output returned running the Data Definition module. + + | **returned**: sometimes + | **type**: str + | **sample**: entire block + +rc + The return code from the Data Definition utility. + + | **returned**: sometimes + | **type**: str + | **sample**: 1 + +changed + Indicates if any changes were made during module execution. + + True is always returned unless a module or failure has occurred. + + | **returned**: always + | **type**: bool + +stderr + The standard error output returned from running the Data Definition utility. + + | **returned**: sometimes + | **type**: str + +msg + Messages returned from the Data Definition Ansible module. + + | **returned**: sometimes + | **type**: str + diff --git a/_sources/ibm_zos_ims/docs/source/modules/ims_psb_gen.rst.txt b/_sources/ibm_zos_ims/docs/source/modules/ims_psb_gen.rst.txt index 46c813bb..5c639b70 100644 --- a/_sources/ibm_zos_ims/docs/source/modules/ims_psb_gen.rst.txt +++ b/_sources/ibm_zos_ims/docs/source/modules/ims_psb_gen.rst.txt @@ -64,7 +64,7 @@ member_list Elements are of the list are str or dict with single key-value pair | **required**: False - | **type**: list + | **type**: raw psb_name @@ -126,7 +126,7 @@ batch Elements are of the list are str or dict with single key-value | **required**: False - | **type**: list + | **type**: raw psb_name diff --git a/_sources/ibm_zos_ims/docs/source/release_notes.rst.txt b/_sources/ibm_zos_ims/docs/source/release_notes.rst.txt index 1cc55b29..f02bbee1 100644 --- a/_sources/ibm_zos_ims/docs/source/release_notes.rst.txt +++ b/_sources/ibm_zos_ims/docs/source/release_notes.rst.txt @@ -6,6 +6,56 @@ Releases ======== +Version 1.3.0-beta.1 +==================== + +Notes +----- + +* Update recommended +* New module + + * ``ims_ddl`` +* Bug fixes and enhancements + + * Added new member ``dfsdf_member`` in the ``ims_catalog_populate`` and ``ims_catalog_purge`` modules. + The DFSDFxxx member is in the IMS.PROCLIB data set where the CATALOG section is defined. + +* Documentation updates + + * Minor updates to ``compression`` parameter in the ``ims_acbgen`` module where PRECOMP,POSTCOMP, in any combination, cause the required in-place compression. + The choices are not mutually exclusive -- PRECOMP or POSTCOMP or PRECOMP,POSTCOMP can be used. +* Improved test and ansible-sanity coverage. +* Subset of the test cases were updated to support for Ansible 2.15. +* Additional support for test cases in ``ims_catalog_populate`` and ``ims_catalog_purge`` modules to support ``dfsdf_member`` parameter. + +* This update also has updated prerequisites for Ansible 2.14 or newer and ZOAU 1.2.2 or newer but prior to version 1.3. + +Availability +------------ + +* `Galaxy`_ +* `GitHub`_ + +Reference +--------- + +* Supported by IBM z/OS core collection v1.5.0 or later +* Supported by IBM Z Open Enterprise Python for z/OS: 3.9 or later +* Supported by IBM Z Open Automation Utilities 1.2.2 or later (but prior to 1.3) +* Supported by z/OS V2R4 +* The z/OS® shell + +.. _centralized content: + https://ibm.github.io/z_ansible_collections_doc/index.html + +.. _GitHub: + https://github.com/ansible-collections/ibm_zos_ims + +.. _Galaxy: + https://galaxy.ansible.com/ibm/ibm_zos_ims + + Version 1.2.0 ==================== diff --git a/_sources/ibm_zosmf/docs/ansible_content.rst.txt b/_sources/ibm_zosmf/docs/ansible_content.rst.txt index 5409c790..400d5116 100644 --- a/_sources/ibm_zosmf/docs/ansible_content.rst.txt +++ b/_sources/ibm_zosmf/docs/ansible_content.rst.txt @@ -16,7 +16,7 @@ workflows, provisioning and managing z/OS middlewares/softwares, via z/OSMF RESTful services. .. _ibm_zosmf: - https://galaxy.ansible.com/ibm/ibm_zosmf + https://galaxy.ansible.com/ui/repo/published/ibm/ibm_zosmf .. toctree:: :maxdepth: 1 diff --git a/_sources/ibm_zosmf/docs/source/modules/zmf_authenticate.rst.txt b/_sources/ibm_zosmf/docs/source/modules/zmf_authenticate.rst.txt index fd1d759a..07f753fc 100644 --- a/_sources/ibm_zosmf/docs/source/modules/zmf_authenticate.rst.txt +++ b/_sources/ibm_zosmf/docs/source/modules/zmf_authenticate.rst.txt @@ -122,10 +122,10 @@ Examples vars_prompt: - name: zmf_user prompt: "Enter your zOSMF username" - private: no + private: false - name: zmf_password prompt: "Enter your zOSMF password" - private: yes + private: true tasks: - zmf_authenticate: zmf_host: "{{ zmf_host }}" diff --git a/_sources/ibm_zosmf/docs/source/modules/zmf_sca.rst.txt b/_sources/ibm_zosmf/docs/source/modules/zmf_sca.rst.txt index df892662..419b69a5 100644 --- a/_sources/ibm_zosmf/docs/source/modules/zmf_sca.rst.txt +++ b/_sources/ibm_zosmf/docs/source/modules/zmf_sca.rst.txt @@ -102,7 +102,7 @@ expected_result zmf_credential - Authentication credentials, returned by module :ref:`zmf_authenticate `, for successful authentication with the z/OSMF server. + Authentication credentials, returned by module **zmf_authenticate**, for successful authentication with the z/OSMF server. If *zmf_credential* is supplied, *zmf_host*, *zmf_port*, *zmf_user*, *zmf_password*, *zmf_crt* and *zmf_key* are ignored. diff --git a/_sources/ibm_zosmf/docs/source/modules/zmf_workflow.rst.txt b/_sources/ibm_zosmf/docs/source/modules/zmf_workflow.rst.txt index 83e015f2..c36e831d 100644 --- a/_sources/ibm_zosmf/docs/source/modules/zmf_workflow.rst.txt +++ b/_sources/ibm_zosmf/docs/source/modules/zmf_workflow.rst.txt @@ -29,7 +29,7 @@ Parameters zmf_credential - Authentication credentials, returned by module :ref:`zmf_authenticate `, for successful authentication with the z/OSMF server. + Authentication credentials, returned by module **zmf_authenticate**, for successful authentication with the z/OSMF server. If *zmf_credential* is supplied, *zmf_host*, *zmf_port*, *zmf_user*, *zmf_password*, *zmf_crt* and *zmf_key* are ignored. diff --git a/_sources/ibm_zosmf/docs/source/release_notes.rst.txt b/_sources/ibm_zosmf/docs/source/release_notes.rst.txt index a486ac50..7c8c9577 100644 --- a/_sources/ibm_zosmf/docs/source/release_notes.rst.txt +++ b/_sources/ibm_zosmf/docs/source/release_notes.rst.txt @@ -6,6 +6,59 @@ Releases ======== +Version 1.5.0 +============= + +Notes +----- + +* Added new roles for z/OSMF Software Management +* Updated the z/OSMF Software Management roles from a previous release to support UUID + +* New roles + + * `zmf_swmgmt_csi_query`_ + * `zmf_swmgmt_system_uuid`_ + +Availability +------------ + +* `Automation Hub`_ +* `Galaxy`_ +* `GitHub`_ + +Version 1.4.2 +============= + +Notes +----- + +* The README has been updated with a new template. +* Fixed role `zmf_workflow_complete` which previously failed to return final_result. + +Availability +------------ + +* `Automation Hub`_ +* `Galaxy`_ +* `GitHub`_ + +Version 1.4.1 +============= + +Notes +----- + +* Documentation updates +* Fixed ansible-lint issues + +Availability +------------ + +* `Automation Hub`_ +* `Galaxy`_ +* `GitHub`_ + Version 1.4.0 ============= @@ -249,11 +302,17 @@ Reference .. _zmf_zmsc_run_management_service: roles/zmf_zmsc_run_management_service.html +.. _zmf_swmgmt_csi_query: + roles/zmf_swmgmt_csi_query.html + +.. _zmf_swmgmt_system_uuid: + roles/zmf_swmgmt_system_uuid.html + .. _Automation Hub: https://www.ansible.com/products/automation-hub .. _Galaxy: - https://galaxy.ansible.com/ibm/ibm_zosmf + https://galaxy.ansible.com/ui/repo/published/ibm/ibm_zosmf .. _GitHub: https://github.com/IBM/ibm_zosmf diff --git a/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_csi_query.rst.txt b/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_csi_query.rst.txt new file mode 100644 index 00000000..1f87ec90 --- /dev/null +++ b/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_csi_query.rst.txt @@ -0,0 +1,311 @@ + +:github_url: https://github.com/IBM/ibm_zosmf/tree/master/plugins/roles/zmf_swmgmt_csi_query + +.. _zmf_swmgmt_csi_query_module: + + +zmf_swmgmt_csi_query -- Query a SMP/E CSI data set +================================================== + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- The \ :strong:`IBM z/OSMF collection`\ provides an Ansible role, referred to as \ :strong:`zmf\_swmgmt\_csi\_query`\ , to query a SMP/E global zone CSI data set directly or to query the CSI associated with a software instance. + + + + + + + +Variables +--------- + + + + +zmf_host + Hostname of the z/OSMF server, specified in the inventory file or as an argument on the playbook command. + + + | **required**: True + | **type**: str + + + + +zmf_port + Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify a value for this parameter in the inventory file or as an argument on the playbook command. + + + | **required**: False + | **type**: str + | **default**: 443 + + + + +zmf_user + User ID for authenticating with the z/OSMF server. + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: True + | **type**: str + + + + +zmf_password + Password to be used for authenticating with z/OSMF server. + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: True + | **type**: str + + + + +software_instance_name + Name of the software instance. + + A software instance name must be specified when a software instance UUID or a CSI data set name are not specified. If a software instance UUID is specified in addition to a software instance and system nickname, then the software instance UUID is used by default. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: False + | **type**: str + + + + +system_nickname + Nickname of the z/OSMF host system that has access to the volumes and data sets where the software instance resides. + + + A system nickname name must be specified when a software instance UUID or a CSI data set name are not specified. If a software instance UUID is specified in addition to a software instance and system nickname, then the software instance UUID is used by default. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: False + | **type**: str + + + + +software_instance_uuid + A UUID of a software instance. A UUID is assigned to every software instance and can be obtained using the "List the software instances defined to z/OSMF" REST API. + + + A UUID can also be obtained using the zmf\_swmgmt\_zos\_system\_uuid Ansible role which retrieves the UUID for the software instance that represents the installed software for the specified z/OSMF host system. + + + A software instance UUID name must be specified when a software instance or a CSI data set name are not specified. If a software instance or a CSI data set name are specified, then the software instance UUID is used by default. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: False + | **type**: str + + + + +csi_data_set_name + A global zone CSI data set to query when it is not associated with a defined software instance object. + + + A CSI data set name must be specified when a software instance or a software instance UUID are not specified. If a software instance UUID is specified in addition to a CSI data set name, then the software instance UUID is used by default. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: False + | **type**: str + + + + +zones + The list of zones to be queried. You may provide one or more specific zone names, or any of these values: + + + GLOBAL (To query the global zone) + + + ALLTZONES (To query all target zones) + + + ALLDZONES (To query all DLIB zones) + + + \* (To query the global zone and all zones defined in the global zone's ZONEINDEX) + + + Zone names are accepted in mixed case and are folded to uppercase automatically. This list variable needs to be in following format: \ :literal:`'"GLOBAL","ALLTZONES","ALLDZONES"'`\ + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: True + | **type**: arr + + + + +entries + The list of entry types to be queried. You may provide one or more entry types, or asterisk ('\*') can be used to indicate all entry types will be queried. Entry types are accepted in mixed case and are folded to uppercase automatically. + + + Refer to https://www.ibm.com/docs/en/zos/3.1.0?topic=command-valid-entry-types for the list of valid types. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: True + | **type**: arr + + + + +subentries + The list of subentry types to be returned. You may provide one or more subentry types, or asterisk ('\*') can be used to indicate all subentry types will be returned. Subentry types are accepted in mixed case and are folded to uppercase automatically. If no subentries are provided, then only the entry name and zone will be returned for matching entries. + + + Refer to https://www.ibm.com/docs/en/zos/3.1.0?topic=command-valid-subentry-types for the list of valid types. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: False + | **type**: arr + + + + +filter + The list of conditions with which to limit the entries to be returned. A condition is in the form: subentry operator 'value' For example, FMID = 'HP10230' or INSTALLDATE \>= '23203'. The subentry type of a filter condition is accepted in mixed case and is folded to uppercase automatically. The value of a filter condition is case sensitive and is not folded to uppercase. If a filter is not provided then all entries of the specified type in the specified zones will be returned. + + + Refer to https://www.ibm.com/docs/en/zos/3.1.0?topic=command-filter-parameter-syntax for a detailed description of the syntax for the filter. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: False + | **type**: str + + + + +csi_query_response_file + The path to the file that will contain the results from the csi query operation. + + The directory must already exist otherwise there will be an error writing the results to the file. If the file exists in the directory already, it will be overwritten by the new response when the playbook is executed. If the file doesn't exist in the directory, it will be created. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: True + | **type**: str + + + + +remote_zmf_user + User ID for authenticating with a remote z/OSMF server. Used only if the csi data set resides on a remote z/OSMF server. + + + | **required**: False + | **type**: str + + + + +remote_zmf_password + Password for authenticating with a remote z/OSMF server. + + | **required**: False + | **type**: str + + + + +proxy_zmf_user + User ID for authenticating with an HTTP proxy server. + + | **required**: False + | **type**: str + + + + +proxy_zmf_password + Password for authenticating with an HTTP proxy server. + + | **required**: False + | **type**: str + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: sample of querying a CSI data set + hosts: sampleHost + gather_facts: no + collections: + - ibm.ibm_zosmf + + tasks: + - include_role : + name: zmf_swmgmt_csi_query + + + + +Notes +----- + +.. note:: + - The given example assumes you have an inventory file \ :emphasis:`inventory.yml`\ that contains the values for the variables described above, such as z/OSMF host server, userid, password, software instance name and system, and response file name. + + + - Command syntax to call a playbook using an inventory file: \ :literal:`ansible-playbook -i inventory software\_management\_csi\_query\_CICDtest1.yml`\ + + + - Command syntax to call a playbook using command arguments: \ :literal:`ansible-playbook software\_management\_csi\_query\_CICDtest1.yml -e zmf\_user=zosmf\*\* -e zmf\_password=zosmf\*\*`\ + + + - When the role is executed, a message shown in following example is displayed, \ :literal:`"msg": "Output filename= /tmp/xxx/csi\_query\_response.json"`\ . This message includes a file path and file name where the csi query information for the requested software instance is returned. + + + + + + + + diff --git a/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates.rst.txt b/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates.rst.txt index 0be88318..03a147cb 100644 --- a/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates.rst.txt +++ b/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates.rst.txt @@ -15,7 +15,7 @@ zmf_swmgmt_identify_missing_critical_updates -- Identify Missing Critical Softwa Synopsis -------- -- The **IBM z/OSMF collection** provides an Ansible role, referred to as **zmf_swmgmt_identify_missing_critical_updates**, to determine if a software instance is missing software updates to resolve PE PTFs, HIPER fixes, or other exception SYSMODs identified by ERROR HOLDDATA. It also helps you identify the SYSMODs that resolve those exceptions. +- The \ :strong:`IBM z/OSMF collection`\ provides an Ansible role, referred to as \ :strong:`zmf\_swmgmt\_identify\_missing\_critical\_updates`\ , to determine if a software instance is missing software updates to resolve PE PTFs, HIPER fixes, or other exception SYSMODs identified by ERROR HOLDDATA. It also helps you identify the SYSMODs that resolve those exceptions. @@ -40,7 +40,7 @@ zmf_host zmf_port - Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify value for this parameter in the inventory file or as an argument on the playbook command. + Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify a value for this parameter in the inventory file or as an argument on the playbook command. | **required**: False @@ -51,7 +51,7 @@ zmf_port zmf_user - User name to be used for authenticating with the z/OSMF server. + User ID for authenticating with the z/OSMF server. This variable can be specified in the inventory file or as an argument on the playbook command. @@ -77,10 +77,13 @@ zmf_password software_instance_name Name of the software instance. + A software instance name must be specified when a software instance UUID is not specified. If both a software instance name and UUID are specified, then the software instance UUID is used by default. + + This variable can be specified in the inventory file or as an argument on the playbook command. - | **required**: True + | **required**: False | **type**: str @@ -90,10 +93,32 @@ system_nickname Nickname of the z/OSMF host system that has access to the volumes and data sets where the software instance resides. + A system nickname must be specified when a software instance UUID is not specified. If a software instance UUID is specified in addition to a software instance and system nickname, then the software instance UUID is used by default. + + This variable can be specified in the inventory file or as an argument on the playbook command. - | **required**: True + | **required**: False + | **type**: str + + + + +software_instance_uuid + A UUID of a software instance. A UUID is assigned to every software instance and can be obtained using the "List the software instances defined to z/OSMF" REST API. + + + A UUID can also be obtained using the zmf\_swmgmt\_zos\_system\_uuid Ansible role which retrieves the UUID for the software instance that represents the installed software for the specified z/OSMF host system. + + + A software instance UUID must be specified when a software instance name is not specified. If both a software instance UUID and name are specified, then the software instance UUID is used by default. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: False | **type**: str @@ -174,10 +199,19 @@ Notes ----- .. note:: - - The given example assumes you have an inventory file *inventory.yml* that contains the values for the variables described above, such as z/OSMF host server, userid, password, software instance name and system, and response file name. + - The given example assumes you have an inventory file \ :emphasis:`inventory.yml`\ that contains the values for the variables described above, such as z/OSMF host server, userid, password, software instance name and system, and response file name. + + + - Command syntax to call a playbook using an inventory file: \ :literal:`ansible-playbook -i inventory software\_management\_reports\_CICDtest1.yml`\ + + + - Command syntax to call a playbook using command arguments: \ :literal:`ansible-playbook software\_management\_reports\_CICDtest1.yml -e zmf\_user=zosmf\*\* -e zmf\_password=zosmf\*\*`\ + + + - When the role is executed, a message shown in following example is displayed, \ :literal:`"msg": "Output filename= /tmp/xxx/missing\_critical\_updates\_response.json"`\ . This message includes a file path and file name where the missing critical updates report for the requested software instance is returned. - - When the role is executed, a message shown in following example is displayed, ``"msg": "Output filename= /tmp/xxx/missing_critical_updates_response.json"``. This message includes a file path and file name where the missing critical updates report for the requested software instance is returned. + - Refer to https://www.ibm.com/docs/en/zos/3.1.0?topic=services-missing-critical-updates for more information on the REST API's request and response JSON. diff --git a/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates.rst.txt b/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates.rst.txt index f264e16d..4db10f3f 100644 --- a/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates.rst.txt +++ b/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates.rst.txt @@ -15,7 +15,7 @@ zmf_swmgmt_identify_missing_fixcat_updates -- Identify Missing Fixcat Software U Synopsis -------- -- The **IBM z/OSMF collection** provides an Ansible role, referred to as **zmf_swmgmt_identify_missing_fixcat_updates**, to determine if a software instance is missing updates for fix categories that might be applicable to the software instance. It also helps you identify the SYSMODs that resolve the missing updates. +- The \ :strong:`IBM z/OSMF collection`\ provides an Ansible role, referred to as \ :strong:`zmf\_swmgmt\_identify\_missing\_fixcat\_updates`\ , to determine if a software instance is missing updates for fix categories that might be applicable to the software instance. It also helps you identify the SYSMODs that resolve the missing updates. @@ -40,7 +40,7 @@ zmf_host zmf_port - Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify value for this parameter in the inventory file or as an argument on the playbook command. + Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify a value for this parameter in the inventory file or as an argument on the playbook command. | **required**: False @@ -51,7 +51,7 @@ zmf_port zmf_user - User name to be used for authenticating with the z/OSMF server. + User ID for authenticating with the z/OSMF server. This variable can be specified in the inventory file or as an argument on the playbook command. @@ -77,10 +77,13 @@ zmf_password software_instance_name Name of the software instance. + A software instance name must be specified when a software instance UUID is not specified. If both a software instance name and UUID are specified, then the software instance UUID is used by default. + + This variable can be specified in the inventory file or as an argument on the playbook command. - | **required**: True + | **required**: False | **type**: str @@ -90,10 +93,32 @@ system_nickname Nickname of the z/OSMF host system that has access to the volumes and data sets where the software instance resides. + A system nickname must be specified when a software instance UUID is not specified. If a software instance UUID is specified in addition to a software instance and system nickname, then the software instance UUID is used by default. + + This variable can be specified in the inventory file or as an argument on the playbook command. - | **required**: True + | **required**: False + | **type**: str + + + + +software_instance_uuid + A UUID of a software instance. A UUID is assigned to every software instance and can be obtained using the "List the software instances defined to z/OSMF" REST API. + + + A UUID can also be obtained using the zmf\_swmgmt\_zos\_system\_uuid Ansible role which retrieves the UUID for the software instance that represents the installed software for the specified z/OSMF host system. + + + A software instance UUID must be specified when a software instance name is not specified. If both a software instance UUID and name are specified, then the software instance UUID is used by default. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: False | **type**: str @@ -174,10 +199,19 @@ Notes ----- .. note:: - - The given example assumes you have an inventory file *inventory.yml* that contains the values for the variables described above, such as z/OSMF host server, userid, password, software instance name and system, and response file name. + - The given example assumes you have an inventory file \ :emphasis:`inventory.yml`\ that contains the values for the variables described above, such as z/OSMF host server, userid, password, software instance name and system, and response file name. + + + - Command syntax to call a playbook using an inventory file: \ :literal:`ansible-playbook -i inventory software\_management\_reports\_CICDtest1.yml`\ + + + - Command syntax to call a playbook using command arguments: \ :literal:`ansible-playbook software\_management\_reports\_CICDtest1.yml -e zmf\_user=zosmf\*\* -e zmf\_password=zosmf\*\*`\ + + + - When the role is executed, a message shown in following example is displayed, \ :literal:`"msg": "Output filename= /tmp/xxx/missing\_fixcat\_updates\_response.json"`\ . This message includes a file path and file name where the missing fixcat updates report for the requested software instance is returned. - - When the role is executed, a message shown in following example is displayed, ``"msg": "Output filename= /tmp/xxx/missing_fixcat_updates_response.json"``. This message includes a file path and file name where the missing fixcat updates report for the requested software instance is returned. + - Refer to https://www.ibm.com/docs/en/zos/3.1.0?topic=services-missing-fixcat-updates for more information on the REST API's request and response JSON. diff --git a/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates.rst.txt b/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates.rst.txt index 2cfd0736..3d6bc657 100644 --- a/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates.rst.txt +++ b/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates.rst.txt @@ -15,7 +15,7 @@ zmf_swmgmt_search_software_updates -- Search a Software Instance for Software Up Synopsis -------- -- The **IBM z/OSMF collection** provides an Ansible role, referred to as **zmf_swmgmt_search_software_updates**, to search a software instance for one or more software updates to determine which updates are installed or updates that need to be installed. +- The \ :strong:`IBM z/OSMF collection`\ provides an Ansible role, referred to as \ :strong:`zmf\_swmgmt\_search\_software\_updates`\ , to search a software instance for one or more software updates to determine which updates are installed or updates that need to be installed. @@ -40,7 +40,7 @@ zmf_host zmf_port - Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify value for this parameter in the inventory file or as an argument on the playbook command. + Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify a value for this parameter in the inventory file or as an argument on the playbook command. | **required**: False @@ -51,7 +51,7 @@ zmf_port zmf_user - User name to be used for authenticating with the z/OSMF server. + User ID for authenticating with the z/OSMF server. This variable can be specified in the inventory file or as an argument on the playbook command. @@ -77,10 +77,13 @@ zmf_password software_instance_name Name of the software instance. + A software instance name must be specified when a software instance UUID is not specified. If both a software instance name and UUID are specified, then the software instance UUID is used by default. + + This variable can be specified in the inventory file or as an argument on the playbook command. - | **required**: True + | **required**: False | **type**: str @@ -90,10 +93,32 @@ system_nickname Nickname of the z/OSMF host system that has access to the volumes and data sets where the software instance resides. + A system nickname must be specified when a software instance UUID is not specified. If a software instance UUID is specified in addition to a software instance and system nickname, then the software instance UUID is used by default. + + This variable can be specified in the inventory file or as an argument on the playbook command. - | **required**: True + | **required**: False + | **type**: str + + + + +software_instance_uuid + A UUID of a software instance. A UUID is assigned to every software instance and can be obtained using the "List the software instances defined to z/OSMF" REST API. + + + A UUID can also be obtained using the zmf\_swmgmt\_zos\_system\_uuid Ansible role which retrieves the UUID for the software instance that represents the installed software for the specified z/OSMF host system. + + + A software instance UUID must be specified when a software instance name is not specified. If both a software instance UUID and name are specified, then the software instance UUID is used by default. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: False | **type**: str @@ -118,7 +143,7 @@ updates The list of software update (SYSMOD) IDs to be searched in the subject software instance. - This list variable needs to be in following format: ``'"SYSMOD1","SYSMOD2","SYSMOD3"'`` + This list variable needs to be in following format: \ :literal:`'"SYSMOD1","SYSMOD2","SYSMOD3"'`\ | **required**: True @@ -187,10 +212,19 @@ Notes ----- .. note:: - - The given example assumes you have an inventory file *inventory.yml* that contains the values for the variables described above, such as z/OSMF host server, userid, password, software instance name and system, and response file name. + - The given example assumes you have an inventory file \ :emphasis:`inventory.yml`\ that contains the values for the variables described above, such as z/OSMF host server, userid, password, software instance name and system, and response file name. + + + - Command syntax to call a playbook using an inventory file: \ :literal:`ansible-playbook -i inventory software\_management\_reports\_CICDtest1.yml`\ + + + - Command syntax to call a playbook using command arguments: \ :literal:`ansible-playbook software\_management\_reports\_CICDtest1.yml -e zmf\_user=zosmf\*\* -e zmf\_password=zosmf\*\*`\ + + + - When the role is executed, a message shown in following example is displayed, \ :literal:`"msg": "Output filename= /tmp/xxx/search\_software\_updates\_response.json"`\ . This message includes a file path and file name where the search software updates report for the requested software instance is returned. - - When the role is executed, a message shown in following example is displayed, ``"msg": "Output filename= /tmp/xxx/search_software_updates_response.json"``. This message includes a file path and file name where the search software updates report for the requested software instance is returned. + - Refer to https://www.ibm.com/docs/en/zos/3.1.0?topic=services-software-update-search for more information on the REST API's request and response JSON. diff --git a/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_zos_system_uuid.rst.txt b/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_zos_system_uuid.rst.txt new file mode 100644 index 00000000..1a18e451 --- /dev/null +++ b/_sources/ibm_zosmf/docs/source/roles/zmf_swmgmt_zos_system_uuid.rst.txt @@ -0,0 +1,170 @@ + +:github_url: https://github.com/IBM/ibm_zosmf/tree/master/plugins/roles/zmf_swmgmt_zos_system_uuid + +.. _zmf_swmgmt_zos_system_uuid_module: + + +zmf_swmgmt_zos_system_uuid -- Retrieve the z/OS system UUID +=========================================================== + + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- The \ :strong:`IBM z/OSMF collection`\ provides an Ansible role, referred to as \ :strong:`zmf\_swmgmt\_zos\_system\_uuid`\ , to retrieve the z/OS system UUID for the specified system nickname. The UUID identifies the software instance object that corresponds to the installed software for the specified z/OSMF host system. The UUID can be used to uniquely identify a software instance object to be acted upon by other Ansible roles. + + + + + + + +Variables +--------- + + + + +zmf_host + Hostname of the z/OSMF server, specified in the inventory file or as an argument on the playbook command. + + + | **required**: True + | **type**: str + + + + +zmf_port + Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify a value for this parameter in the inventory file or as an argument on the playbook command. + + + | **required**: False + | **type**: str + | **default**: 443 + + + + +zmf_user + User ID for authenticating with the z/OSMF server. + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: True + | **type**: str + + + + +zmf_password + Password to be used for authenticating with z/OSMF server. + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: True + | **type**: str + + + + +system_nickname + Nickname of the z/OSMF host system. + + + This variable can be specified in the inventory file or as an argument on the playbook command. + + + | **required**: True + | **type**: str + + + + +remote_zmf_user + User ID for authenticating with a remote z/OSMF server. Used only to retrieve the UUID of a remote z/OSMF server. + + + | **required**: False + | **type**: str + + + + +remote_zmf_password + Password for authenticating with a remote z/OSMF server. + + | **required**: False + | **type**: str + + + + +proxy_zmf_user + User ID for authenticating with an HTTP proxy server. + + | **required**: False + | **type**: str + + + + +proxy_zmf_password + Password for authenticating with an HTTP proxy server. + + | **required**: False + | **type**: str + + + + +Examples +-------- + +.. code-block:: yaml+jinja + + + - name: sample of retrieving the z/OS system UUID + hosts: sampleHost + gather_facts: no + collections: + - ibm.ibm_zosmf + + tasks: + - include_role : + name: zmf_swmgmt_zos_system_uuid + + + + +Notes +----- + +.. note:: + - The given example assumes you have an inventory file \ :emphasis:`inventory.yml`\ that contains the values for the variables described above, such as z/OSMF host server, userid, password, system, and response file name. + + + - Command syntax to call a playbook using an inventory file: \ :literal:`ansible-playbook -i inventory software\_management\_system\_uuid\_CICDtest1.yml`\ + + + - Command syntax to call a playbook using command arguments: \ :literal:`ansible-playbook software\_management\_system\_uuid\_CICDtest1.yml -e zmf\_user=zosmf\*\* -e zmf\_password=zosmf\*\*`\ + + + - When the role is executed, a message shown in following example is displayed, \ :literal:`"msg": "Output filename= /tmp/xxx/zos\_system\_uuid\_response.json"`\ . This message includes a file path and file name where the z/OS system UUID is saved. + + + - Refer to https://www.ibm.com/docs/en/zos/3.1.0?topic=services-retrieve-zos-system-uuid for more information on the REST API's request and response JSON. + + + + + + + + diff --git a/ibm_zos_cics/docs/ansible_content.html b/ibm_zos_cics/docs/ansible_content.html index edf0ba15..09c3ea43 100644 --- a/ibm_zos_cics/docs/ansible_content.html +++ b/ibm_zos_cics/docs/ansible_content.html @@ -180,16 +180,19 @@

z/OS CICS

The IBM® z/OS® CICS® collection, also represented as -ibm_zos_cics in this document, is part of the broader +ibm_zos_cics in this document, is part of the broader initiative to bring Ansible® Automation to IBM Z® through the offering Red Hat® Ansible Certified Content for IBM Z.

-

The IBM® z/OS® CICS® collection supports automation tasks that can -define, install, and perform actions on CICS definitions and resources such as -creating a PROGRAM definition, installing and updating it, and deleting the -definition.

-

The Ansible modules in this collection are written in Python and interact with -the CMCI REST API of the CICS® management client interface (CMCI) for system -management.

+

The IBM® z/OS® CICS® collection provides modules for automation tasks that +perform operations on CICS and CICSPlex SM resources and definitions, for example, +creating and installing a PROGRAM definition, then updating or deleting the definition. +These modules interact with the CMCI REST API of the CICS® management client +interface (CMCI) for system management.

+

The IBM® z/OS® CICS® collection also provides modules for provisioning and managing +CICS TS data sets and utilities. You can use these Ansible modules to create automation +tasks that provision or deprovision a CICS region and tasks for CICS startup and +shutdown.

+

The Ansible modules in this collection are written in Python.

Collection Content

diff --git a/ibm_zos_cics/docs/source/modules/aux_temp_storage.html b/ibm_zos_cics/docs/source/modules/aux_temp_storage.html new file mode 100644 index 00000000..dab5c459 --- /dev/null +++ b/ibm_zos_cics/docs/source/modules/aux_temp_storage.html @@ -0,0 +1,520 @@ + + + + + + + + + + + aux_temp_storage – Create and remove the CICS auxiliary temporary storage data set — Red Hat Ansible Certified Content for IBM Z documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + + +
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
    + +
  • Docs »
    • + +
  • z/OS CICS »
    • + +
  • Modules »
    • + +
  • aux_temp_storage – Create and remove the CICS auxiliary temporary storage data set
    • + + + +
+ + +
+
+
+
+ +
+

aux_temp_storage – Create and remove the CICS auxiliary temporary storage data set

+ +
+

Synopsis

+
    +

  • Create and remove the auxiliary temporary storage data set used by a CICS® region.

    • +

  • You can use this module when provisioning or de-provisioning a CICS region.

    • +

  • Use the state option to specify the intended state for the auxiliary temporary storage data set. For example, use state=initial to create an auxiliary temporary storage data set if it doesn’t exist.

    • +
+
+
+

Parameters

+
+
region_data_sets

The location of the region data sets to be created by using a template, for example, REGIONS.ABCD0001.<< data_set_name >>.

+

If you want to use a data set that already exists, ensure that the data set is an auxiliary temporary storage data set.

+
+
required: True
+
type: dict
+
+
+
dfhtemp

Overrides the templated location for the auxiliary temporary storage data set.

+
+
required: False
+
type: dict
+
+
+
dsn

The data set name of the auxiliary temporary storage to override the template.

+
+
required: False
+
type: str
+
+
+
+
+
template

The base location of the region data sets with a template.

+
+
required: False
+
type: str
+
+
+
+
+
space_primary

The size of the primary space allocated to the auxiliary temporary storage data set. Note that this is just the value; the unit is specified with space_type.

+

This option takes effect only when the auxiliary temporary storage data set is being created. If the data set already exists, the option has no effect.

+
+
required: False
+
type: int
+
default: 200
+
+
+
space_secondary

The size of the secondary space allocated to the auxiliary temporary storage data set. Note that this is just the value; the unit is specified with space_type.

+

This option takes effect only when the auxiliary temporary storage data set is being created. If the data set already exists, the option has no effect.

+
+
required: False
+
type: int
+
default: 10
+
+
+
space_type

The unit portion of the auxiliary temporary storage data set size. Note that this is just the unit; the value for the primary space is specified with space_primary and the value for the secondary space is specified with space_secondary.

+

This option takes effect only when the auxiliary temporary storage data set is being created. If the data set already exists, the option has no effect.

+

The size can be specified in megabytes (M), kilobytes (K), records (REC), cylinders (CYL), or tracks (TRK).

+
+
required: False
+
type: str
+
default: REC
+
choices: M, K, REC, CYL, TRK
+
+
+
state

The intended state for the auxiliary temporary storage data set, which the module aims to achieve.

+

Specify absent to remove the auxiliary temporary storage data set entirely, if it already exists.

+

Specify initial to create the auxiliary temporary storage data set, if it does not exist. If the specified data set exists but is empty, the module leaves the data set as is. If the specified data set exists and has contents, the module deletes the data set and then creates a new, empty data set.

+

Specify warm to retain an existing auxiliary temporary storage data set in its current state. The module checks whether the specified data set exists, and if it does, leaves the data set as is. If the data set does not exist, the operation fails.

+
+
required: True
+
type: str
+
choices: initial, absent, warm
+
+
+
volumes

The volume(s) where the data set is created. Use a string to define a singular volume or a list of strings for multiple volumes.

+
+
required: False
+
type: raw
+
+
+
+
+
+

Examples

+
- name: Initialize an auxiliary temporary storage data set by using the templated location
+  ibm.ibm_zos_cics.aux_temp_storage:
+    region_data_sets:
+      template: "REGIONS.ABCD0001.<< data_set_name >>"
+    state: "initial"
+
+- name: Initialize a user specified auxiliary temporary storage data set
+  ibm.ibm_zos_cics.aux_temp_storage:
+    region_data_sets:
+      dfhtemp:
+        dsn: "REGIONS.ABCD0001.DFHTEMP"
+    state: "initial"
+
+- name: Initialize a large auxiliary temporary storage data set by using the templated location
+  ibm.ibm_zos_cics.aux_temp_storage:
+    region_data_sets:
+      template: "REGIONS.ABCD0001.<< data_set_name >>"
+    space_primary: 50
+    space_type: "M"
+    state: "initial"
+
+- name: Retain the existing state of an auxiliary temporary storage data set defined by the template
+  ibm.ibm_zos_cics.aux_temp_storage:
+    region_data_sets:
+      template: "REGIONS.ABCD0001.<< data_set_name >>"
+    state: "warm"
+
+- name: Retain the existing state of a user specified auxiliary temporary storage data set
+  ibm.ibm_zos_cics.aux_temp_storage:
+    region_data_sets:
+      dfhtemp:
+        dsn: "REGIONS.ABCD0001.DFHTEMP"
+    state: "warm"
+
+- name: Delete an existing auxiliary temporary storage data set defined by the template
+  ibm.ibm_zos_cics.aux_temp_storage:
+    region_data_sets:
+      template: "REGIONS.ABCD0001.<< data_set_name >>"
+    state: "absent"
+
+- name: Delete an existing user specified auxiliary temporary storage data set
+  ibm.ibm_zos_cics.aux_temp_storage:
+    region_data_sets:
+      dfhtemp:
+        dsn: "REGIONS.ABCD0001.DFHTEMP"
+    state: "absent"
+
+
+
+
+

Return Values

+
+
+
changed
+
True if the state was changed, otherwise False.
+
+
+
returned: always
+
type: bool
+
+
+
failed
+
True if the Ansible task failed, otherwise False.
+
+
+
returned: always
+
type: bool
+
+
+
start_state
+
The state of the auxiliary temporary storage data set before the Ansible task runs.
+
+
+
returned: always
+
type: dict
+
+
+
data_set_organization
+
The organization of the data set at the start of the Ansible task.
+
+
+
returned: always
+
type: str
+
sample: VSAM
+
+
+
exists
+
True if the specified auxiliary temporary storage data set exists.
+
+
+
returned: always
+
type: bool
+
+
+
+
+
end_state
+
The state of the auxiliary temporary storage data set at the end of the Ansible task.
+
+
+
returned: always
+
type: dict
+
+
+
data_set_organization
+
The organization of the data set at the end of the Ansible task.
+
+
+
returned: always
+
type: str
+
sample: VSAM
+
+
+
exists
+
True if the specified auxiliary temporary storage data set exists.
+
+
+
returned: always
+
type: bool
+
+
+
+
+
executions
+
A list of program executions performed during the Ansible task.
+
+
+
returned: always
+
type: list
+
+
+
name
+
A human-readable name for the program execution.
+
+
+
returned: always
+
type: str
+
+
+
rc
+
The return code for the program execution.
+
+
+
returned: always
+
type: int
+
+
+
stdout
+
The standard output stream returned from the program execution.
+
+
+
returned: always
+
type: str
+
+
+
stderr
+
The standard error stream returned from the program execution.
+
+
+
returned: always
+
type: str
+
+
+
+
+
msg
+
A string containing an error message if applicable
+
+
+
returned: always
+
type: str
+
+
+
+
+
+
+ + +
+ +
+
+ + +
+ +
+

+ © Copyright IBM Corp. 2020, 2023 + +

+
+ +
+ +
+
+ +
+ +
+ + + + + + + + + + + + \ No newline at end of file diff --git a/ibm_zos_cics/docs/source/modules/aux_trace.html b/ibm_zos_cics/docs/source/modules/aux_trace.html new file mode 100644 index 00000000..9b913269 --- /dev/null +++ b/ibm_zos_cics/docs/source/modules/aux_trace.html @@ -0,0 +1,595 @@ + + + + + + + + + + + aux_trace – Allocate auxiliary trace data sets — Red Hat Ansible Certified Content for IBM Z documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + + +
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
    + +
  • Docs »
    • + +
  • z/OS CICS »
    • + +
  • Modules »
    • + +
  • aux_trace – Allocate auxiliary trace data sets
    • + + + +
+ + +
+
+
+
+ +
+

aux_trace – Allocate auxiliary trace data sets

+ +
+

Synopsis

+
    +

  • Allocates the two auxiliary trace data sets used by a CICS® region. When CICS auxiliary trace is activated, trace entries produced by CICS are written to the auxiliary trace data sets. These data sets can hold large amounts of trace data.

    • +

  • The two data sets are referred to as auxiliary trace data set A (DFHAUXT) and auxiliary trace data set B (DFHBUXT).

    • +
+
+
+

Parameters

+
+
destination

Identify which one of the auxiliary trace data sets is the target of the operation. If the value is left blank, A is implied, but you can specify A or B.

+

Specify A to create or delete the A data set.

+

Specify B to create or delete the B data set. This MUST be set for the creation of the B data set.

+
+
required: False
+
type: str
+
default: A
+
choices: A, B
+
+
+
region_data_sets

The location of the region data sets to be created by using a template, for example, REGIONS.ABCD0001.<< data_set_name >>.

+

If you want to use a data set that already exists, ensure that the data set is an auxiliary trace data set.

+
+
required: True
+
type: dict
+
+
+
dfhauxt

Overrides the templated location for the DFHAUXT data set.

+
+
required: False
+
type: dict
+
+
+
dsn

The data set name of DFHAUXT to override the template.

+
+
required: False
+
type: str
+
+
+
+
+
dfhbuxt

Overrides the templated location for the DFHBUXT data set.

+
+
required: False
+
type: dict
+
+
+
dsn

The data set name of DFHBUXT to override the template.

+
+
required: False
+
type: str
+
+
+
+
+
template

The base location of the region data sets with a template.

+
+
required: False
+
type: str
+
+
+
+
+
space_primary

The size of the primary space allocated to the auxiliary trace data set. Note that this is just the value; the unit is specified with space_type.

+

This option takes effect only when the auxiliary trace data set is being created. If the data set already exists, the option has no effect.

+
+
required: False
+
type: int
+
default: 20
+
+
+
space_secondary

The size of the secondary space allocated to the auxiliary trace data set. Note that this is just the value; the unit is specified with space_type.

+

This option takes effect only when the auxiliary trace data set is being created. If the data set already exists, the option has no effect.

+
+
required: False
+
type: int
+
default: 4
+
+
+
space_type

The unit portion of the auxiliary trace data set size. Note that this is just the unit; the value for the primary space is specified with space_primary and the value for the secondary space is specified with space_secondary.

+

This option takes effect only when the auxiliary trace data set is being created. If the data set already exists, the option has no effect.

+

The size can be specified in megabytes (M), kilobytes (K), cylinders (CYL), or tracks (TRK).

+
+
required: False
+
type: str
+
default: M
+
choices: M, K, CYL, TRK
+
+
+
state

The intended state for the auxiliary trace data set, which the module aims to achieve.

+

Specify absent to remove the auxiliary trace data set data set entirely, if it exists.

+

Specify initial to create the auxiliary trace data set if it does not exist. If the specified data set exists but is empty, the module leaves the data set as is. If the specified data set exists and has contents, the module deletes the data set and then creates a new, empty one.

+

Specify warm to retain an existing auxiliary trace data set in its current state. The module checks whether the specified data set exists, and if it does, leaves the data set as is. If the data set does not exist, the operation fails.

+
+
required: True
+
type: str
+
choices: initial, absent, warm
+
+
+
volumes

The volume(s) where the data set is created. Use a string to define a singular volume or a list of strings for multiple volumes.

+
+
required: False
+
type: raw
+
+
+
+
+
+

Examples

+
- name: Allocate auxiliary trace data set A (implicit) by using the templated location
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      template: "REGIONS.ABCD0001.<< data_set_name >>"
+    state: initial
+
+- name: Allocate a user specified data set as auxiliary trace data set A (implicit)
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      dfhauxt:
+        dsn: "REGIONS.ABCD0001.DFHAUXT"
+    state: initial
+
+- name: Allocate auxiliary trace data set A by using the templated location
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      template: "REGIONS.ABCD0001.<< data_set_name >>"
+    state: initial
+    destination: A
+
+- name: Allocate a user specified data set as auxiliary trace data set A
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      dfhauxt:
+        dsn: "REGIONS.ABCD0001.DFHAUXT"
+    state: initial
+    destination: A
+
+- name: Allocate auxiliary trace data set B by using the templated location
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      template: "REGIONS.ABCD0001.<< data_set_name >>"
+    state: initial
+    destination: B
+
+- name: Allocate a user specified data set as auxiliary trace data set B
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      dfhbuxt:
+        dsn: "REGIONS.ABCD0001.DFHBUXT"
+    state: initial
+    destination: B
+
+- name: Retain the existing state of auxiliary trace data set A (implicit) defined by the template
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      template: "REGIONS.ABCD0001.<< data_set_name >>"
+    state: "warm"
+
+- name: Retain the existing state of a user specified auxiliary trace data set A (implicit)
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      dfhauxt:
+        dsn: "REGIONS.ABCD0001.DFHAUXT"
+    state: "warm"
+
+- name: Retain the existing state of auxiliary trace data set B defined by the template
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      template: "REGIONS.ABCD0001.<< data_set_name >>"
+    state: "warm"
+    destination: B
+
+- name: Retain the existing state of a user specified auxiliary trace data set B
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      dfhbuxt:
+        dsn: "REGIONS.ABCD0001.DFHBUXT"
+    state: "warm"
+    destination: B
+
+- name: Delete auxiliary trace data set A (implicit) defined by the template
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      template: "REGIONS.ABCD0001.<< data_set_name >>"
+    state: absent
+
+- name: Delete a user specified auxiliary trace data set A (implicit)
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      dfhauxt:
+        dsn: "REGIONS.ABCD0001.DFHBUXT"
+    state: absent
+
+- name: Delete auxiliary trace data set B defined by the template
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      template: "REGIONS.ABCD0001.<< data_set_name >>"
+    state: absent
+    destination: B
+
+- name: Delete a user specified auxiliary trace data set B
+  ibm.ibm_zos_cics.aux_trace:
+    region_data_sets:
+      dfhbuxt:
+        dsn: "REGIONS.ABCD0001.DFHBUXT"
+    state: absent
+    destination: B
+
+
+
+
+

Return Values

+
+
+
changed
+
True if the state was changed, otherwise False.
+
+
+
returned: always
+
type: bool
+
+
+
failed
+
True if the Ansible task failed, otherwise False.
+
+
+
returned: always
+
type: bool
+
+
+
start_state
+
The state of the auxiliary trace data set before the Ansible task runs.
+
+
+
returned: always
+
type: dict
+
+
+
data_set_organization
+
The organization of the data set at the start of the Ansible task.
+
+
+
returned: always
+
type: str
+
sample: Sequential
+
+
+
exists
+
True if the specified auxiliary trace data set exists.
+
+
+
returned: always
+
type: bool
+
+
+
+
+
end_state
+
The state of the auxiliary trace data set at the end of the Ansible task.
+
+
+
returned: always
+
type: dict
+
+
+
data_set_organization
+
The organization of the data set at the end of the Ansible task.
+
+
+
returned: always
+
type: str
+
sample: Sequential
+
+
+
exists
+
True if the specified auxiliary trace data set exists.
+
+
+
returned: always
+
type: bool
+
+
+
+
+
executions
+
A list of program executions performed during the Ansible task.
+
+
+
returned: always
+
type: list
+
+
+
name
+
A human-readable name for the program execution.
+
+
+
returned: always
+
type: str
+
+
+
rc
+
The return code for the program execution.
+
+
+
returned: always
+
type: int
+
+
+
stdout
+
The standard output stream returned from the program execution.
+
+
+
returned: always
+
type: str
+
+
+
stderr
+
The standard error stream returned from the program execution.
+
+
+
returned: always
+
type: str
+
+
+
+
+
msg
+
A string containing an error message if applicable
+
+
+
returned: always
+
type: str
+
+
+
+
+
+
+ + +
+ +
+
+ + +
+ +
+

+ © Copyright IBM Corp. 2020, 2023 + +

+
+ +
+ +
+
+ +
+ +
+ + + + + + + + + + + + \ No newline at end of file diff --git a/ibm_zos_cics/docs/source/modules/cmci_action.html b/ibm_zos_cics/docs/source/modules/cmci_action.html index 1e893b63..1ac5d5ac 100644 --- a/ibm_zos_cics/docs/source/modules/cmci_action.html +++ b/ibm_zos_cics/docs/source/modules/cmci_action.html @@ -36,7 +36,7 @@ - + @@ -91,17 +91,25 @@
  • z/OS core
  • z/OS CICS
    • force_lock

    By default, when dest is a MVS data set and is being used by another process with DISP=SHR or DISP=OLD the module will fail. Use force_lock to bypass this check and continue with copy.

    @@ -338,6 +342,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    ignore_sftp_stderr

    During data transfer through SFTP, the module fails if the SFTP command directs any content to stderr. The user is able to override this behavior by setting this parameter to true. By doing so, the module would essentially ignore the stderr stream produced by SFTP and continue execution.

    @@ -345,6 +350,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    is_binary

    If set to true, indicates that the file or data set to be copied is a binary file or data set.

    @@ -353,6 +359,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    executable

    If set to true, indicates that the file or library to be copied is an executable.

    @@ -363,6 +370,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    aliases

    If set to true, indicates that any aliases found in the source (USS file, USS dir, PDS/E library or member) are to be preserved during the copy operation.

    @@ -371,6 +379,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    local_follow

    This flag indicates that any existing filesystem links in the source tree should be followed.

    @@ -380,6 +389,14 @@

    Parametersdefault: True

    +
    group

    Name of the group that will own the file system objects.

    +

    When left unspecified, it uses the current group of the current user unless you are root, in which case it can preserve the previous ownership.

    +

    This option is only applicable if dest is USS, otherwise ignored.

    +
    +
    required: False
    +
    type: str
    +
    +
    mode

    The permission of the destination file or directory.

    If dest is USS, this will act as Unix file mode, otherwise ignored.

    It should be noted that modes are octal numbers. The user must either add a leading zero so that Ansible’s YAML parser knows it is an octal number (like 0644 or 01777)or quote it (like '644' or '1777') so Ansible receives a string and can do its own conversion from string into number. Giving Ansible a number without following one of these rules will end up with a decimal number which will have unexpected results.

    @@ -390,11 +407,20 @@

    Parameterstype: str

    +
    owner

    Name of the user that should own the filesystem object, as would be passed to the chown command.

    +

    When left unspecified, it uses the current user unless you are root, in which case it can preserve the previous ownership.

    +

    This option is only applicable if dest is USS, otherwise ignored.

    +
    +
    required: False
    +
    type: str
    +
    +
    remote_src

    If set to false, the module searches for src at the local machine.

    If set to true, the module goes to the remote/target machine for src.

    required: False
    type: bool
    +
    default: False
    src

    Path to a file/directory or name of a data set to copy to remote z/OS system.

    @@ -403,6 +429,7 @@

    ParametersIf src is a directory, dest must be a partitioned data set or a USS directory.

    If src is a file and dest ends with “/” or is a directory, the file is copied to the directory with the same filename as src.

    If src is a directory and ends with “/”, the contents of it will be copied into the root of dest. If it doesn’t end with “/”, the directory itself will be copied.

    +

    If src is a directory or a file, file names will be truncated and/or modified to ensure a valid name for a data set or member.

    If src is a VSAM data set, dest must also be a VSAM.

    Wildcards can be used to copy multiple PDS/PDSE members to another PDS/PDSE.

    Required unless using content.

    @@ -416,6 +443,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    volume

    If dest does not exist, specify which volume dest should be allocated to.

    @@ -438,7 +466,7 @@

    Parameters
    required: True
    type: str
    -
    choices: KSDS, ESDS, RRDS, LDS, SEQ, PDS, PDSE, MEMBER, BASIC, LIBRARY
    +
    choices: ksds, esds, rrds, lds, seq, pds, pdse, member, basic, library

    space_primary

    If the destination dest data set does not exist , this sets the primary space allocated for the data set.

    @@ -456,19 +484,19 @@

    Parameters

    space_type

    If the destination data set does not exist, this sets the unit of measurement to use when defining primary and secondary space.

    -

    Valid units of size are K, M, G, CYL, and TRK.

    +

    Valid units of size are k, m, g, cyl, and trk.

    required: False
    type: str
    -
    choices: K, M, G, CYL, TRK
    +
    choices: k, m, g, cyl, trk
    -
    record_format

    If the destination data set does not exist, this sets the format of the data set. (e.g FB)

    -

    Choices are case-insensitive.

    +
    record_format

    If the destination data set does not exist, this sets the format of the data set. (e.g fb)

    +

    Choices are case-sensitive.

    required: False
    type: str
    -
    choices: FB, VB, FBA, VBA, U
    +
    choices: fb, vb, fba, vba, u
    record_length

    The length of each record in the data set, in bytes.

    @@ -492,16 +520,16 @@

    Parameters

    key_offset

    The key offset to use when creating a KSDS data set.

    -

    key_offset is required when type=KSDS.

    -

    key_offset should only be provided when type=KSDS

    +

    key_offset is required when type=ksds.

    +

    key_offset should only be provided when type=ksds

    required: False
    type: int
    key_length

    The key length to use when creating a KSDS data set.

    -

    key_length is required when type=KSDS.

    -

    key_length should only be provided when type=KSDS

    +

    key_length is required when type=ksds.

    +

    key_length should only be provided when type=ksds

    required: False
    type: int
    @@ -543,6 +571,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    template_parameters

    Options to set the way Jinja2 will process templates.

    @@ -611,6 +640,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    trim_blocks

    Whether Jinja2 should remove the first newline after a block is removed.

    @@ -625,6 +655,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    newline_sequence

    Sequence that starts a newline in a template.

    @@ -639,6 +670,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    @@ -646,7 +678,7 @@

    Parameters
    -

    Examples

    +

    Examples

    - name: Copy a local file to a sequential data set
   zos_copy:
     src: /path/to/sample_seq_data_set
@@ -672,7 +704,7 @@ 
    Exampleszos_copy:
     src: /path/to/foo.conf
     dest: /etc/foo.conf
-    mode: 0644
+    mode: "0644"
     group: foo
     owner: bar
 
@@ -802,11 +834,11 @@ 
    Examplesremote_src: true
     volume: '222222'
     dest_data_set:
-      type: SEQ
+      type: seq
       space_primary: 10
       space_secondary: 3
-      space_type: K
-      record_format: VB
+      space_type: k
+      record_format: vb
       record_length: 150
 
 - name: Copy a Program Object and its aliases on a remote system to a new PDSE member MYCOBOL
@@ -834,7 +866,7 @@ 
    Examples
-
    Notes
    
+
    Notes
    
 
    
 
    Note
    
 
    Destination data sets are assumed to be in catalog. When trying to copy to an uncataloged data set, the module assumes that the data set does not exist and will create it.
    
@@ -842,12 +874,14 @@ 
    Notesdocumentation.
    
-
    zos_copy uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; Co:Z SFTP is not supported. In the case of Co:z SFTP, you can exempt the Ansible userid on z/OS from using Co:Z thus falling back to using standard SFTP.
    
-
    Beginning in version 1.8.x, zos_copy will no longer attempt to autocorrect a copy of a data type member into a PDSE that contains program objects. You can control this behavior using module option executable that will signify an executable is being copied into a PDSE with other executables. Mixing data type members with program objects will be responded with a (FSUM8976,./zos_copy.html) error.
    
+
    This module uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; SCP (secure copy protocol) and Co:Z SFTP are not supported. In the case of Co:z SFTP, you can exempt the Ansible user id on z/OS from using Co:Z thus falling back to using standard SFTP. If the module detects SCP, it will temporarily use SFTP for transfers, if not available, the module will fail.
    
+
    Beginning in version 1.8.x, zos_copy will no longer attempt to correct a copy of a data type member into a PDSE that contains program objects. You can control this behavior using module option executable that will signify an executable is being copied into a PDSE with other executables. Mixing data type members with program objects will result in a (FSUM8976,./zos_copy.html) error.
    
+
    It is the playbook author or user’s responsibility to ensure they have appropriate authority to the RACF FACILITY resource class. A user is described as the remote user, configured either for the playbook or playbook tasks, who can also obtain escalated privileges to execute as root or another user.
    
+
    To use this module, you must define the RACF FACILITY class profile and allow READ access to RACF FACILITY profile MVS.MCSOPER.ZOAU. If your system uses a different security product, consult that product’s documentation to configure the required security classes.
    -

    See Also

    +

    See Also

    See also

    -
    type

    The data set type to be used when creating a data set. (e.g pdse)

    -

    MEMBER expects to be used with an existing partitioned data set.

    -

    Choices are case-insensitive.

    +
    type

    The data set type to be used when creating a data set. (e.g pdse).

    +

    member expects to be used with an existing partitioned data set.

    +

    Choices are case-sensitive.

    required: False
    type: str
    -
    default: PDS
    -
    choices: KSDS, ESDS, RRDS, LDS, SEQ, PDS, PDSE, LIBRARY, BASIC, LARGE, MEMBER, HFS, ZFS
    +
    default: pds
    +
    choices: ksds, esds, rrds, lds, seq, pds, pdse, library, basic, large, member, hfs, zfs
    space_primary

    The amount of primary space to allocate for the dataset.

    @@ -294,22 +294,22 @@

    Parameters

    space_type

    The unit of measurement to use when defining primary and secondary space.

    -

    Valid units of size are K, M, G, CYL, and TRK.

    +

    Valid units of size are k, m, g, cyl, and trk.

    required: False
    type: str
    -
    default: M
    -
    choices: K, M, G, CYL, TRK
    +
    default: m
    +
    choices: k, m, g, cyl, trk
    record_format

    The format of the data set. (e.g FB)

    -

    Choices are case-insensitive.

    -

    When type=KSDS, type=ESDS, type=RRDS, type=LDS or type=ZFS then record_format=None, these types do not have a default record_format.

    +

    Choices are case-sensitive.

    +

    When type=ksds, type=esds, type=rrds, type=lds or type=zfs then record_format=None, these types do not have a default record_format.

    required: False
    type: str
    -
    default: FB
    -
    choices: FB, VB, FBA, VBA, U, F
    +
    default: fb
    +
    choices: fb, vb, fba, vba, u, f
    sms_storage_class

    The storage class for an SMS-managed dataset.

    @@ -360,16 +360,16 @@

    Parameters

    key_offset

    The key offset to use when creating a KSDS data set.

    -

    key_offset is required when type=KSDS.

    -

    key_offset should only be provided when type=KSDS

    +

    key_offset is required when type=ksds.

    +

    key_offset should only be provided when type=ksds

    required: False
    type: int
    key_length

    The key length to use when creating a KSDS data set.

    -

    key_length is required when type=KSDS.

    -

    key_length should only be provided when type=KSDS

    +

    key_length is required when type=ksds.

    +

    key_length should only be provided when type=ksds

    required: False
    type: int
    @@ -392,6 +392,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    tmp_hlq

    Override the default high level qualifier (HLQ) for temporary and backup datasets.

    @@ -404,10 +405,11 @@

    Parametersforce

    Specifies that the data set can be shared with others during a member delete operation which results in the data set you are updating to be simultaneously updated by others.

    This is helpful when a data set is being used in a long running process such as a started task and you are wanting to delete a member.

    The force=True option enables sharing of data sets through the disposition DISP=SHR.

    -

    The force=True only applies to data set members when state=absent and type=MEMBER.

    +

    The force=True only applies to data set members when state=absent and type=member.

    required: False
    type: bool
    +
    default: False
    batch

    Batch can be used to perform operations on multiple data sets in a single module call.

    @@ -419,7 +421,7 @@

    Parameters
    name

    The name of the data set being managed. (e.g USER.TEST)

    If name is not provided, a randomized data set name will be generated with the HLQ matching the module-runners username.

    -

    Required if type=MEMBER or state!=present

    +

    Required if type=member or state!=present

    required: False
    type: str
    @@ -428,14 +430,14 @@

    Parametersstate

    The final state desired for specified data set.

    If state=absent and the data set does not exist on the managed node, no action taken, module completes successfully with changed=False.

    If state=absent and the data set does exist on the managed node, remove the data set, module completes successfully with changed=True.

    -

    If state=absent and type=MEMBER and force=True, the data set will be opened with DISP=SHR such that the entire data set can be accessed by other processes while the specified member is deleted.

    +

    If state=absent and type=member and force=True, the data set will be opened with DISP=SHR such that the entire data set can be accessed by other processes while the specified member is deleted.

    If state=absent and volumes is provided, and the data set is not found in the catalog, the module attempts to perform catalog using supplied name and volumes. If the attempt to catalog the data set catalog is successful, then the data set is removed. Module completes successfully with changed=True.

    If state=absent and volumes is provided, and the data set is not found in the catalog, the module attempts to perform catalog using supplied name and volumes. If the attempt to catalog the data set catalog fails, then no action is taken. Module completes successfully with changed=False.

    If state=absent and volumes is provided, and the data set is found in the catalog, the module compares the catalog volume attributes to the provided volumes. If they volume attributes are different, the cataloged data set will be uncataloged temporarily while the requested data set be deleted is cataloged. The module will catalog the original data set on completion, if the attempts to catalog fail, no action is taken. Module completes successfully with changed=False.

    If state=present and the data set does not exist on the managed node, create and catalog the data set, module completes successfully with changed=True.

    If state=present and replace=True and the data set is present on the managed node the existing data set is deleted, and a new data set is created and cataloged with the desired attributes, module completes successfully with changed=True.

    If state=present and replace=False and the data set is present on the managed node, no action taken, module completes successfully with changed=False.

    -

    If state=present and type=MEMBER and the member does not exist in the data set, create a member formatted to store data, module completes successfully with changed=True. Note, a PDSE does not allow a mixture of formats such that there is executables (program objects) and data. The member created is formatted to store data, not an executable.

    +

    If state=present and type=member and the member does not exist in the data set, create a member formatted to store data, module completes successfully with changed=True. Note, a PDSE does not allow a mixture of formats such that there is executables (program objects) and data. The member created is formatted to store data, not an executable.

    If state=cataloged and volumes is provided and the data set is already cataloged, no action taken, module completes successfully with changed=False.

    If state=cataloged and volumes is provided and the data set is not cataloged, module attempts to perform catalog using supplied name and volumes. If the attempt to catalog the data set catalog is successful, module completes successfully with changed=True.

    If state=cataloged and volumes is provided and the data set is not cataloged, module attempts to perform catalog using supplied name and volumes. If the attempt to catalog the data set catalog fails, returns failure with changed=False.

    @@ -448,14 +450,14 @@

    Parameterschoices: present, absent, cataloged, uncataloged

    -
    type

    The data set type to be used when creating a data set. (e.g PDSE)

    -

    MEMBER expects to be used with an existing partitioned data set.

    -

    Choices are case-insensitive.

    +
    type

    The data set type to be used when creating a data set. (e.g pdse)

    +

    member expects to be used with an existing partitioned data set.

    +

    Choices are case-sensitive.

    required: False
    type: str
    -
    default: PDS
    -
    choices: KSDS, ESDS, RRDS, LDS, SEQ, PDS, PDSE, LIBRARY, BASIC, LARGE, MEMBER, HFS, ZFS
    +
    default: pds
    +
    choices: ksds, esds, rrds, lds, seq, pds, pdse, library, basic, large, member, hfs, zfs
    space_primary

    The amount of primary space to allocate for the dataset.

    @@ -475,22 +477,22 @@

    Parameters

    space_type

    The unit of measurement to use when defining primary and secondary space.

    -

    Valid units of size are K, M, G, CYL, and TRK.

    +

    Valid units of size are k, m, g, cyl, and trk.

    required: False
    type: str
    -
    default: M
    -
    choices: K, M, G, CYL, TRK
    +
    default: m
    +
    choices: k, m, g, cyl, trk
    record_format

    The format of the data set. (e.g FB)

    -

    Choices are case-insensitive.

    -

    When type=KSDS, type=ESDS, type=RRDS, type=LDS or type=ZFS then record_format=None, these types do not have a default record_format.

    +

    Choices are case-sensitive.

    +

    When type=ksds, type=esds, type=rrds, type=lds or type=zfs then record_format=None, these types do not have a default record_format.

    required: False
    type: str
    -
    default: FB
    -
    choices: FB, VB, FBA, VBA, U, F
    +
    default: fb
    +
    choices: fb, vb, fba, vba, u, f
    sms_storage_class

    The storage class for an SMS-managed dataset.

    @@ -541,16 +543,16 @@

    Parameters

    key_offset

    The key offset to use when creating a KSDS data set.

    -

    key_offset is required when type=KSDS.

    -

    key_offset should only be provided when type=KSDS

    +

    key_offset is required when type=ksds.

    +

    key_offset should only be provided when type=ksds

    required: False
    type: int
    key_length

    The key length to use when creating a KSDS data set.

    -

    key_length is required when type=KSDS.

    -

    key_length should only be provided when type=KSDS

    +

    key_length is required when type=ksds.

    +

    key_length should only be provided when type=ksds

    required: False
    type: int
    @@ -573,15 +575,17 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    force

    Specifies that the data set can be shared with others during a member delete operation which results in the data set you are updating to be simultaneously updated by others.

    This is helpful when a data set is being used in a long running process such as a started task and you are wanting to delete a member.

    The force=True option enables sharing of data sets through the disposition DISP=SHR.

    -

    The force=True only applies to data set members when state=absent and type=MEMBER.

    +

    The force=True only applies to data set members when state=absent and type=member.

    required: False
    type: bool
    +
    default: False
    @@ -601,7 +605,7 @@

    Examplesname: someds.name.here type: pds space_primary: 5 - space_type: M + space_type: m record_format: fba record_length: 25 @@ -610,21 +614,21 @@

    Examplesname: someds.name.here type: pds space_primary: 5 - space_type: M + space_type: m record_format: u record_length: 25 - replace: yes + replace: true - name: Attempt to replace a data set if it exists. If not found in the catalog, check if it is available on volume 222222, and catalog if found. zos_data_set: name: someds.name.here type: pds space_primary: 5 - space_type: M + space_type: m record_format: u record_length: 25 volumes: "222222" - replace: yes + replace: true - name: Create an ESDS data set if it does not exist zos_data_set: @@ -658,43 +662,43 @@

    Examples- name: Write a member to an existing PDS; replace if member exists zos_data_set: name: someds.name.here(mydata) - type: MEMBER - replace: yes + type: member + replace: true - name: Write a member to an existing PDS; do not replace if member exists zos_data_set: name: someds.name.here(mydata) - type: MEMBER + type: member - name: Remove a member from an existing PDS zos_data_set: name: someds.name.here(mydata) state: absent - type: MEMBER + type: member - name: Remove a member from an existing PDS/E by opening with disposition DISP=SHR zos_data_set: name: someds.name.here(mydata) state: absent - type: MEMBER - force: yes + type: member + force: true - name: Create multiple partitioned data sets and add one or more members to each zos_data_set: batch: - - name: someds.name.here1 - type: PDS + - name: someds.name.here1 + type: pds space_primary: 5 - space_type: M + space_type: m record_format: fb - replace: yes + replace: true - name: someds.name.here1(member1) - type: MEMBER + type: member - name: someds.name.here2(member1) - type: MEMBER - replace: yes + type: member + replace: true - name: someds.name.here2(member2) - type: MEMBER + type: member - name: Catalog a data set present on volume 222222 if it is uncataloged. zos_data_set: diff --git a/ibm_zos_core/docs/source/modules/zos_encode.html b/ibm_zos_core/docs/source/modules/zos_encode.html index 405e5d7f..9919be9c 100644 --- a/ibm_zos_core/docs/source/modules/zos_encode.html +++ b/ibm_zos_core/docs/source/modules/zos_encode.html @@ -284,6 +284,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    backup_name

    Specify the USS file name or data set name for the dest backup.

    @@ -301,6 +302,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    tmp_hlq

    Override the default high level qualifier (HLQ) for temporary and backup datasets.

    @@ -326,8 +328,8 @@

    Examplesencoding: from: IBM-1047 to: ISO8859-1 - backup: yes - backup_compress: yes + backup: true + backup_compress: true - name: Convert file encoding from IBM-1047 to ISO8859-1 to a directory zos_encode: diff --git a/ibm_zos_core/docs/source/modules/zos_fetch.html b/ibm_zos_core/docs/source/modules/zos_fetch.html index 601d7cbb..c936de5f 100644 --- a/ibm_zos_core/docs/source/modules/zos_fetch.html +++ b/ibm_zos_core/docs/source/modules/zos_fetch.html @@ -326,6 +326,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    @@ -389,7 +390,7 @@

    Notesdocumentation.

    -

    zos_fetch uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; Co:Z SFTP is not supported. In the case of Co:z SFTP, you can exempt the Ansible userid on z/OS from using Co:Z thus falling back to using standard SFTP.

    +

    This module uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; SCP (secure copy protocol) and Co:Z SFTP are not supported. In the case of Co:z SFTP, you can exempt the Ansible user id on z/OS from using Co:Z thus falling back to using standard SFTP. If the module detects SCP, it will temporarily use SFTP for transfers, if not available, the module will fail.

    diff --git a/ibm_zos_core/docs/source/modules/zos_gather_facts.html b/ibm_zos_core/docs/source/modules/zos_gather_facts.html index aa041916..e061b84f 100644 --- a/ibm_zos_core/docs/source/modules/zos_gather_facts.html +++ b/ibm_zos_core/docs/source/modules/zos_gather_facts.html @@ -255,6 +255,7 @@

    Parametersrequired: False

    type: list
    elements: str
    +
    default: []
    diff --git a/ibm_zos_core/docs/source/modules/zos_job_submit.html b/ibm_zos_core/docs/source/modules/zos_job_submit.html index 29906f79..2eee8285 100644 --- a/ibm_zos_core/docs/source/modules/zos_job_submit.html +++ b/ibm_zos_core/docs/source/modules/zos_job_submit.html @@ -221,24 +221,23 @@

    zos_job_submit – Submit JCL

    -

    Synopsis

    +

    Synopsis

      -

    • Submit JCL from a data set, USS, or from the controller.

      • -

    • Submit a job and optionally monitor for completion.

      • -

    • Optionally, wait a designated time until the job finishes.

      • +

    • Submit JCL in a data set, USS file, or file on the controller.

      • +

    • Submit a job and monitor for completion.

    • For an uncataloged dataset, specify the volume serial number.

    -

    Parameters

    +

    Parameters

    src

    The source file or data set containing the JCL to submit.

    It could be a physical sequential data set, a partitioned data set qualified by a member or a path. (e.g “USER.TEST”,”USER.JCL(TEST)”)

    @@ -249,23 +248,15 @@

    Parameterstype: str

    -
    location

    The JCL location. Supported choices are DATA_SET, USS or LOCAL.

    -

    DATA_SET can be a PDS, PDSE, or sequential data set.

    -

    USS means the JCL location is located in UNIX System Services (USS).

    -

    LOCAL means locally to the ansible control node.

    +
    location

    The JCL location. Supported choices are data_set, uss or local.

    +

    data_set can be a PDS, PDSE, or sequential data set.

    +

    uss means the JCL location is located in UNIX System Services (USS).

    +

    local means locally to the ansible control node.

    required: False
    type: str
    -
    default: DATA_SET
    -
    choices: DATA_SET, USS, LOCAL
    -
    -
    -
    wait

    Setting this option will yield no change, it is deprecated. There is no no need to set wait; setting wait_times_s is the correct way to configure the amount of tme to wait for a job to execute.

    -

    Configuring wait used by the zos_job_submit module has been deprecated and will be removed in ibm.ibm_zos_core collection.

    -

    See option wait_time_s.

    -
    -
    required: False
    -
    type: bool
    +
    default: data_set
    +
    choices: data_set, uss, local
    wait_time_s

    Option wait_time_s is the total time that module zos_job_submit will wait for a submitted job to complete. The time begins when the module is executed on the managed node.

    @@ -290,16 +281,16 @@

    Parametersdefault: True

    -
    volume

    The volume serial (VOLSER)is where the data set resides. The option is required only when the data set is not cataloged on the system.

    +
    volume

    The volume serial (VOLSER) is where the data set resides. The option is required only when the data set is not cataloged on the system.

    When configured, the zos_job_submit will try to catalog the data set for the volume serial. If it is not able to, the module will fail.

    -

    Ignored for location=USS and location=LOCAL.

    +

    Ignored for location=uss and location=local.

    required: False
    type: str
    encoding

    Specifies which encoding the local JCL file should be converted from and to, before submitting the job.

    -

    This option is only supported for when location=LOCAL.

    +

    This option is only supported for when location=local.

    If this parameter is not provided, and the z/OS systems default encoding can not be identified, the JCL file will be converted from UTF-8 to IBM-1047 by default, otherwise the module will detect the z/OS system encoding.

    required: False
    @@ -332,6 +323,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    template_parameters

    Options to set the way Jinja2 will process templates.

    @@ -400,6 +392,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    trim_blocks

    Whether Jinja2 should remove the first newline after a block is removed.

    @@ -414,6 +407,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    newline_sequence

    Sequence that starts a newline in a template.

    @@ -428,6 +422,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    @@ -435,23 +430,23 @@

    Parameters
    -

    Examples

    -
    - name: Submit JCL in a PDSE member
+
    Examples
    
+
    - name: Submit JCL in a PDSE member.
   zos_job_submit:
     src: HLQ.DATA.LLQ(SAMPLE)
-    location: DATA_SET
+    location: data_set
   register: response
 
 - name: Submit JCL in USS with no DDs in the output.
   zos_job_submit:
     src: /u/tester/demo/sample.jcl
-    location: USS
+    location: uss
     return_output: false
 
 - name: Convert local JCL to IBM-037 and submit the job.
   zos_job_submit:
     src: /Users/maxy/ansible-playbooks/provision/sample.jcl
-    location: LOCAL
+    location: local
     encoding:
       from: ISO8859-1
       to: IBM-037
@@ -459,38 +454,39 @@ 
    Examples- name: Submit JCL in an uncataloged PDSE on volume P2SS01.
   zos_job_submit:
     src: HLQ.DATA.LLQ(SAMPLE)
-    location: DATA_SET
+    location: data_set
     volume: P2SS01
 
 - name: Submit a long running PDS job and wait up to 30 seconds for completion.
   zos_job_submit:
     src: HLQ.DATA.LLQ(LONGRUN)
-    location: DATA_SET
+    location: data_set
     wait_time_s: 30
 
 - name: Submit a long running PDS job and wait up to 30 seconds for completion.
   zos_job_submit:
     src: HLQ.DATA.LLQ(LONGRUN)
-    location: DATA_SET
+    location: data_set
     wait_time_s: 30
 
 - name: Submit JCL and set the max return code the module should fail on to 16.
   zos_job_submit:
     src: HLQ.DATA.LLQ
-    location: DATA_SET
+    location: data_set
     max_rc: 16
    -

    Notes

    +

    Notes

    Note

    For supported character sets used to encode data, refer to the documentation.

    +

    This module uses zos_copy to copy local scripts to the remote machine which uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; SCP (secure copy protocol) and Co:Z SFTP are not supported. In the case of Co:z SFTP, you can exempt the Ansible user id on z/OS from using Co:Z thus falling back to using standard SFTP. If the module detects SCP, it will temporarily use SFTP for transfers, if not available, the module will fail.

    -

    Return Values

    +

    Return Values

    jobs

    List of jobs output. If no job status is found, this will return an empty ret_code with msg_txt explanation.

    @@ -841,24 +837,38 @@

    Return Values

    -
    msg

    Return code resulting from the job submission. Jobs that take longer to assign a value can have a value of ‘?’.

    +
    msg

    Job status resulting from the job submission.

    +

    Job status ABEND indicates the job ended abnormally.

    +

    Job status AC indicates the job is active, often a started task or job taking long.

    +

    Job status CAB indicates a converter abend.

    +

    Job status CANCELED indicates the job was canceled.

    +

    Job status CNV indicates a converter error.

    +

    Job status FLU indicates the job was flushed.

    +

    Job status JCLERR or JCL ERROR indicates the JCL has an error.

    +

    Job status SEC or SEC ERROR indicates the job as encountered a security error.

    +

    Job status SYS indicates a system failure.

    +

    Job status ? indicates status can not be determined.

    +

    Jobs where status can not be determined will result in None (NULL).

    type: str
    -
    sample: CC 0000
    +
    sample: AC
    -
    msg_code

    Return code extracted from the msg so that it can be evaluated as a string. Jobs that take longer to assign a value can have a value of ‘?’.

    +
    msg_code

    The return code from the submitted job as a string.

    +

    Jobs which have no return code will result in None (NULL), such is the case of a job that errors or is active.

    type: str
    -
    msg_txt

    Returns additional information related to the job. Jobs that take longer to assign a value can have a value of ‘?’.

    +
    msg_txt

    Returns additional information related to the submitted job.

    +

    Jobs which have no additional information will result in None (NULL).

    type: str
    -
    sample: The job completion code (CC) was not available in the job output, please review the job log.”
    +
    sample: The job JOB00551 was run with special job processing TYPRUN=SCAN. This will result in no completion, return code or job steps and changed will be false.
    -
    code

    Return code converted to an integer value (when possible). For JCL ERRORs, this will be None.

    +
    code

    The return code converted to an integer value when available.

    +

    Jobs which have no return code will result in None (NULL), such is the case of a job that errors or is active.

    type: int
    @@ -933,13 +943,6 @@

    Return Values

    -
    message

    This option is being deprecated

    -
    -
    returned: success
    -
    type: str
    -
    sample: Submit JCL operation succeeded.
    -
    -
    diff --git a/ibm_zos_core/docs/source/modules/zos_lineinfile.html b/ibm_zos_core/docs/source/modules/zos_lineinfile.html index 8edf6788..50705faf 100644 --- a/ibm_zos_core/docs/source/modules/zos_lineinfile.html +++ b/ibm_zos_core/docs/source/modules/zos_lineinfile.html @@ -279,6 +279,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    insertafter

    Used with state=present.

    @@ -315,6 +316,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    backup_name

    Specify the USS file name or data set name for the destination backup.

    @@ -339,6 +341,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    encoding

    The character set of the source src. zos_lineinfile requires to be provided with correct encoding to read the content of USS file or data set. If this parameter is not provided, this module assumes that USS file or data set is encoded in IBM-1047.

    @@ -355,6 +358,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    @@ -392,14 +396,14 @@

    Examplessrc: /tmp/src/somefile regexp: '^(.*)User(\d+)m(.*)$' line: '\1APPUser\3' - backrefs: yes + backrefs: true - name: Add a line to a member while a task is in execution zos_lineinfile: src: SOME.PARTITIONED.DATA.SET(DATA) insertafter: EOF line: 'Should be a working test now' - force: True + force: true diff --git a/ibm_zos_core/docs/source/modules/zos_mount.html b/ibm_zos_core/docs/source/modules/zos_mount.html index 8f155ddc..acf564e0 100644 --- a/ibm_zos_core/docs/source/modules/zos_mount.html +++ b/ibm_zos_core/docs/source/modules/zos_mount.html @@ -258,11 +258,11 @@

    Parameters
    fs_type

    The type of file system that will be mounted.

    The physical file systems data set format to perform the logical mount.

    -

    The fs_type is required to be uppercase.

    +

    The fs_type is required to be lowercase.

    required: True
    type: str
    -
    choices: HFS, ZFS, NFS, TFS
    +
    choices: hfs, zfs, nfs, tfs
    state

    The desired status of the described mount (choice).

    @@ -298,6 +298,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    backup_name

    Specify the USS file name or data set name for the destination backup.

    @@ -325,20 +326,20 @@

    Parameters
    required: False
    type: str
    -
    default: NORMAL
    -
    choices: DRAIN, FORCE, IMMEDIATE, NORMAL, REMOUNT, RESET
    +
    default: normal
    +
    choices: drain, force, immediate, normal, remount, reset

    mount_opts

    Options available to the mount.

    -

    If mount_opts=RO on a mounted/remount, mount is performed read-only.

    -

    If mount_opts=SAME and (unmount_opts=REMOUNT), mount is opened in the same mode as previously opened.

    -

    If mount_opts=NOWAIT, mount is performed asynchronously.

    -

    If mount_opts=NOSECURITY, security checks are not enforced for files in this file system.

    +

    If mount_opts=ro on a mounted/remount, mount is performed read-only.

    +

    If mount_opts=same and (unmount_opts=remount), mount is opened in the same mode as previously opened.

    +

    If mount_opts=nowait, mount is performed asynchronously.

    +

    If mount_opts=nosecurity, security checks are not enforced for files in this file system.

    required: False
    type: str
    -
    default: RW
    -
    choices: RO, RW, SAME, NOWAIT, NOSECURITY
    +
    default: rw
    +
    choices: ro, rw, same, nowait, nosecurity
    src_params

    Specifies a parameter string to be passed to the file system type.

    @@ -350,13 +351,13 @@

    Parameters
    tag_untagged

    If present, tags get written to any untagged file.

    When the file system is unmounted, the tags are lost.

    -

    If tag_untagged=NOTEXT none of the untagged files in the file system are automatically converted during file reading and writing.

    -

    If tag_untagged=TEXT each untagged file is implicitly marked as containing pure text data that can be converted.

    +

    If tag_untagged=notext none of the untagged files in the file system are automatically converted during file reading and writing.

    +

    If tag_untagged=text each untagged file is implicitly marked as containing pure text data that can be converted.

    If this flag is used, use of tag_ccsid is encouraged.

    required: False
    type: str
    -
    choices: TEXT, NOTEXT
    +
    choices: text, notext
    tag_ccsid

    Identifies the coded character set identifier (ccsid) to be implicitly set for the untagged file.

    @@ -386,17 +387,17 @@

    Parameters

    automove

    These parameters apply only in a sysplex where systems are exploiting the shared file system capability. They specify what happens to the ownership of a file system when a shutdown, PFS termination, dead system takeover, or file system move occurs. The default setting is AUTOMOVE where the file system will be randomly moved to another system (no system list used).

    -

    automove=AUTOMOVE indicates that ownership of the file system can be automatically moved to another system participating in a shared file system.

    -

    automove=NOAUTOMOVE prevents movement of the file system’s ownership in some situations.

    -

    automove=UNMOUNT allows the file system to be unmounted in some situations.

    +

    automove=automove indicates that ownership of the file system can be automatically moved to another system participating in a shared file system.

    +

    automove=noautomove prevents movement of the file system’s ownership in some situations.

    +

    automove=unmount allows the file system to be unmounted in some situations.

    required: False
    type: str
    -
    default: AUTOMOVE
    -
    choices: AUTOMOVE, NOAUTOMOVE, UNMOUNT
    +
    default: automove
    +
    choices: automove, noautomove, unmount
    -
    automove_list

    If(automove=AUTOMOVE), this option will be checked.

    +
    automove_list

    If(automove=automove), this option will be checked.

    This specifies the list of servers to include or exclude as destinations.

    None is a valid value, meaning ‘move anywhere’.

    Indicator is either INCLUDE or EXCLUDE, which can also be abbreviated as I or E.

    @@ -420,14 +421,14 @@

    Exampleszos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted - name: Unmount a filesystem. zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: unmounted unmount_opts: REMOUNT opts: same @@ -436,7 +437,7 @@

    Exampleszos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted mount_opts: RO @@ -444,37 +445,37 @@

    Exampleszos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted persistent: - data_store: SYS1.PARMLIB(BPXPRMAA) - comment: For Tape2 project + data_store: SYS1.PARMLIB(BPXPRMAA) + comment: For Tape2 project - name: Mount a filesystem and record change in BPXPRMAA after backing up to BPXPRMAB. zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted persistent: - data_store: SYS1.PARMLIB(BPXPRMAA) - backup: Yes - backup_name: SYS1.PARMLIB(BPXPRMAB) - comment: For Tape2 project + data_store: SYS1.PARMLIB(BPXPRMAA) + backup: true + backup_name: SYS1.PARMLIB(BPXPRMAB) + comment: For Tape2 project - name: Mount a filesystem ignoring uid/gid values. zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted - allow_uid: no + allow_uid: false - name: Mount a filesystem asynchronously (don't wait for completion). zos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted opts: nowait @@ -482,7 +483,7 @@

    Exampleszos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted mount_opts: NOSECURITY @@ -490,7 +491,7 @@

    Exampleszos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted automove: AUTOMOVE automove_list: I,DEV1,DEV2,DEV3,DEV9 @@ -499,7 +500,7 @@

    Exampleszos_mount: src: SOMEUSER.VVV.ZFS path: /u/omvsadm/core - fs_type: ZFS + fs_type: zfs state: mounted automove: AUTOMOVE automove_list: EXCLUDE,DEV4,DEV5,DEV6,DEV7 diff --git a/ibm_zos_core/docs/source/modules/zos_mvs_raw.html b/ibm_zos_core/docs/source/modules/zos_mvs_raw.html index 3be92575..4ebc3b35 100644 --- a/ibm_zos_core/docs/source/modules/zos_mvs_raw.html +++ b/ibm_zos_core/docs/source/modules/zos_mvs_raw.html @@ -222,16 +222,16 @@

    zos_mvs_raw – Run a z/OS program.

    -

    Synopsis

    +

    Synopsis

    dds

    The input data source.

    @@ -323,42 +325,45 @@

    Parameters
    required: False
    type: str
    -
    choices: delete, keep, catlg, catalog, uncatlg, uncatalog
    +
    choices: delete, keep, catalog, uncatalog

    disposition_abnormal

    disposition_abnormal indicates what to do with the data set after an abnormal termination of the program.

    required: False
    type: str
    -
    choices: delete, keep, catlg, catalog, uncatlg, uncatalog
    +
    choices: delete, keep, catalog, uncatalog
    -
    reuse

    Determines if a data set should be reused if disposition=NEW and if a data set with a matching name already exists.

    +
    reuse

    Determines if a data set should be reused if disposition=new and if a data set with a matching name already exists.

    If reuse=true, disposition will be automatically switched to SHR.

    If reuse=false, and a data set with a matching name already exists, allocation will fail.

    Mutually exclusive with replace.

    -

    reuse is only considered when disposition=NEW

    +

    reuse is only considered when disposition=new

    required: False
    type: bool
    +
    default: False
    -
    replace

    Determines if a data set should be replaced if disposition=NEW and a data set with a matching name already exists.

    +
    replace

    Determines if a data set should be replaced if disposition=new and a data set with a matching name already exists.

    If replace=true, the original data set will be deleted, and a new data set created.

    If replace=false, and a data set with a matching name already exists, allocation will fail.

    Mutually exclusive with reuse.

    -

    replace is only considered when disposition=NEW

    +

    replace is only considered when disposition=new

    replace will result in loss of all data in the original data set unless backup is specified.

    required: False
    type: bool
    +
    default: False
    -
    backup

    Determines if a backup should be made of an existing data set when disposition=NEW, replace=true, and a data set with the desired name is found.

    +
    backup

    Determines if a backup should be made of an existing data set when disposition=new, replace=true, and a data set with the desired name is found.

    backup is only used when replace=true.

    required: False
    type: bool
    +
    default: False
    space_type

    The unit of measurement to use when allocating space for a new data set using space_primary and space_secondary.

    @@ -454,7 +459,7 @@

    Parameters

    encoding

    How the label for the key encrypting key specified by label is encoded by the Encryption Key Manager.

    -

    encoding can either be set to L for label encoding, or H for hash encoding.

    +

    encoding can either be set to l for label encoding, or h for hash encoding.

    Maps to KEYCD1 on z/OS.

    required: True
    @@ -481,7 +486,7 @@

    Parameters

    encoding

    How the label for the key encrypting key specified by label is encoded by the Encryption Key Manager.

    -

    encoding can either be set to L for label encoding, or H for hash encoding.

    +

    encoding can either be set to l for label encoding, or h for hash encoding.

    Maps to KEYCD2 on z/OS.

    required: True
    @@ -510,7 +515,7 @@

    Parametersrecord_length

    The logical record length. (e.g 80).

    For variable data sets, the length must include the 4-byte prefix area.

    Defaults vary depending on format: If FB/FBA 80, if VB/VBA 137, if U 0.

    -

    Valid values are (1-32760 for non-vsam, 1-32761 for vsam).

    +

    Valid values are (1-32760 for non-VSAM, 1-32761 for VSAM).

    Maps to LRECL on z/OS.

    required: False
    @@ -721,8 +726,9 @@

    Parameterscontent

    The input contents for the DD.

    dd_input supports single or multiple lines of input.

    Multi-line input can be provided as a multi-line string or a list of strings with 1 line per list item.

    -

    If a multi-line string is provided make sure to use the proper literal block style indicator “|”.

    If a list of strings is provided, newlines will be added to each of the lines when used as input.

    +

    If a multi-line string is provided, use the proper block scalar style. YAML supports both literal and folded scalars. It is recommended to use the literal style indicator “|” with a block indentation indicator, for example; content: | 2 is a literal block style indicator with a 2 space indentation, the entire block will be indented and newlines preserved. The block indentation range is 1 - 9. While generally unnecessary, YAML does support block chomping indicators “+” and “-” as well.

    +

    When using the content option for instream-data, the module will ensure that all lines contain a blank in columns 1 and 2 and add blanks when not present while retaining a maximum length of 80 columns for any line. This is true for all content types; string, list of strings and when using a YAML block indicator.

    required: True
    type: raw
    @@ -895,42 +901,45 @@

    Parameters
    required: False
    type: str
    -
    choices: delete, keep, catlg, catalog, uncatlg, uncatalog
    +
    choices: delete, keep, catalog, uncatalog

    disposition_abnormal

    disposition_abnormal indicates what to do with the data set after abnormal termination of the program.

    required: False
    type: str
    -
    choices: delete, keep, catlg, catalog, uncatlg, uncatalog
    +
    choices: delete, keep, catalog, uncatalog
    -
    reuse

    Determines if data set should be reused if disposition=NEW and a data set with matching name already exists.

    +
    reuse

    Determines if data set should be reused if disposition=new and a data set with matching name already exists.

    If reuse=true, disposition will be automatically switched to SHR.

    If reuse=false, and a data set with a matching name already exists, allocation will fail.

    Mutually exclusive with replace.

    -

    reuse is only considered when disposition=NEW

    +

    reuse is only considered when disposition=new

    required: False
    type: bool
    +
    default: False
    -
    replace

    Determines if data set should be replaced if disposition=NEW and a data set with matching name already exists.

    +
    replace

    Determines if data set should be replaced if disposition=new and a data set with matching name already exists.

    If replace=true, the original data set will be deleted, and a new data set created.

    If replace=false, and a data set with a matching name already exists, allocation will fail.

    Mutually exclusive with reuse.

    -

    replace is only considered when disposition=NEW

    +

    replace is only considered when disposition=new

    replace will result in loss of all data in the original data set unless backup is specified.

    required: False
    type: bool
    +
    default: False
    -
    backup

    Determines if a backup should be made of existing data set when disposition=NEW, replace=true, and a data set with the desired name is found.

    +
    backup

    Determines if a backup should be made of existing data set when disposition=new, replace=true, and a data set with the desired name is found.

    backup is only used when replace=true.

    required: False
    type: bool
    +
    default: False
    space_type

    The unit of measurement to use when allocating space for a new data set using space_primary and space_secondary.

    @@ -1026,7 +1035,7 @@

    Parameters

    encoding

    How the label for the key encrypting key specified by label is encoded by the Encryption Key Manager.

    -

    encoding can either be set to L for label encoding, or H for hash encoding.

    +

    encoding can either be set to l for label encoding, or h for hash encoding.

    Maps to KEYCD1 on z/OS.

    required: True
    @@ -1053,7 +1062,7 @@

    Parameters

    encoding

    How the label for the key encrypting key specified by label is encoded by the Encryption Key Manager.

    -

    encoding can either be set to L for label encoding, or H for hash encoding.

    +

    encoding can either be set to l for label encoding, or h for hash encoding.

    Maps to KEYCD2 on z/OS.

    required: True
    @@ -1138,7 +1147,7 @@

    Parameters
    path

    The path to an existing UNIX file.

    -

    Or provide the path to an new created UNIX file when status_group=OCREAT.

    +

    Or provide the path to an new created UNIX file when status_group=ocreat.

    The provided path must be absolute.

    required: True
    @@ -1281,8 +1290,9 @@

    Parameterscontent

    The input contents for the DD.

    dd_input supports single or multiple lines of input.

    Multi-line input can be provided as a multi-line string or a list of strings with 1 line per list item.

    -

    If a multi-line string is provided make sure to use the proper literal block style indicator “|”.

    If a list of strings is provided, newlines will be added to each of the lines when used as input.

    +

    If a multi-line string is provided, use the proper block scalar style. YAML supports both literal and folded scalars. It is recommended to use the literal style indicator “|” with a block indentation indicator, for example; content: | 2 is a literal block style indicator with a 2 space indentation, the entire block will be indented and newlines preserved. The block indentation range is 1 - 9. While generally unnecessary, YAML does support block chomping indicators “+” and “-” as well.

    +

    When using the content option for instream-data, the module will ensure that all lines contain a blank in columns 1 and 2 and add blanks when not present while retaining a maximum length of 80 columns for any line. This is true for all content types; string, list of strings and when using a YAML block indicator.

    required: True
    type: raw
    @@ -1340,7 +1350,7 @@

    Parameters

    -

    Examples

    +

    Examples

    - name: List data sets matching pattern in catalog,
     save output to a new sequential data set and return output as text.
   zos_mvs_raw:
@@ -1351,7 +1361,7 @@ 
    Examplesdd_name: sysprint
           data_set_name: mypgm.output.ds
           disposition: new
-          reuse: yes
+          reuse: true
           type: seq
           space_primary: 5
           space_secondary: 1
@@ -1375,7 +1385,7 @@ 
    Examplesdd_name: sysprint
           data_set_name: mypgm.output.ds
           disposition: new
-          reuse: yes
+          reuse: true
           type: seq
           space_primary: 5
           space_secondary: 1
@@ -1420,7 +1430,7 @@ 
    Examplesdd_name: sysprint
           data_set_name: mypgm.output.ds
           disposition: new
-          reuse: yes
+          reuse: true
           type: seq
           space_primary: 5
           space_secondary: 1
@@ -1448,8 +1458,8 @@ 
    Examplesdd_name: sysprint
           data_set_name: mypgm.output.ds
           disposition: new
-          replace: yes
-          backup: yes
+          replace: true
+          backup: true
           type: seq
           space_primary: 5
           space_secondary: 1
@@ -1520,7 +1530,7 @@ 
    Examples- name: Take a set of data sets and write them to an archive.
   zos_mvs_raw:
     program_name: adrdssu
-    auth: yes
+    auth: true
     dds:
       - dd_data_set:
           dd_name: archive
@@ -1536,7 +1546,7 @@ 
    Examples- name: Merge two sequential data sets and write them to new data set
   zos_mvs_raw:
     program_name: sort
-    auth: no
+    auth: false
     parm: "MSGPRT=CRITICAL,LIST"
     dds:
       - dd_data_set:
@@ -1567,7 +1577,7 @@ 
    Examplesfiles.
   zos_mvs_raw:
     pgm: idcams
-    auth: yes
+    auth: true
     dds:
       - dd_concat:
           dd_name: sysprint
@@ -1584,44 +1594,73 @@ 
    Examplesdd_name: sysin
           content: " LISTCAT ENTRIES('SYS1.*')"
 
-- name: Drop the contents of input dataset into output dataset
-      using REPRO command.
+- name: Drop the contents of input dataset into output dataset using REPRO command.
   zos_mvs_raw:
     pgm: idcams
-    auth: yes
+    auth: true
     dds:
-    - dd_data_set:
-        dd_name: INPUT
-        data_set_name: myhlq.ds1.input
-    - dd_data_set:
-        dd_name: OUTPUT
-        data_set_name: myhlq.ds1.output
-    - dd_input:
-        dd_name: sysin
-        content: |
+      - dd_data_set:
+          dd_name: INPUT
+          data_set_name: myhlq.ds1.input
+      - dd_data_set:
+          dd_name: OUTPUT
+          data_set_name: myhlq.ds1.output
+      - dd_input:
+          dd_name: sysin
+          content: |
             " REPRO -
               INFILE(INPUT) -
               OUTFILE(OUTPUT)"
-    - dd_output:
-        dd_name: sysprint
-        return_content:
-          type: text
+      - dd_output:
+          dd_name: sysprint
+          return_content:
+            type: text
+
+- name: Define a cluster using a literal block style indicator
+      with a 2 space indentation.
+  zos_mvs_raw:
+    program_name: idcams
+    auth: true
+    dds:
+      - dd_output:
+          dd_name: sysprint
+          return_content:
+            type: text
+      - dd_input:
+          dd_name: sysin
+          content: 2
+            DEFINE CLUSTER -
+                      (NAME(ANSIBLE.TEST.VSAM) -
+                      CYL(10 10)  -
+                      FREESPACE(20 20) -
+                      INDEXED -
+                      KEYS(32 0) -
+                      NOERASE -
+                      NONSPANNED -
+                      NOREUSE -
+                      SHAREOPTIONS(3 3) -
+                      SPEED -
+                      UNORDERED -
+                      RECORDSIZE(4086 32600) -
+                      VOLUMES(222222) -
+                      UNIQUE)
    -

    Notes

    +

    Notes

    Note

    When executing programs using zos_mvs_raw, you may encounter errors that originate in the programs implementation. Two such known issues are noted below of which one has been addressed with an APAR.

    1. zos_mvs_raw module execution fails when invoking Database Image Copy 2 Utility or Database Recovery Utility in conjunction with FlashCopy or Fast Replication.

    2. zos_mvs_raw module execution fails when invoking DFSRRC00 with parm “UPB,PRECOMP”, “UPB, POSTCOMP” or “UPB,PRECOMP,POSTCOMP”. This issue is addressed by APAR PH28089.

      3. +

    3. When executing a program, refer to the programs documentation as each programs requirments can vary fom DDs, instream-data indentation and continuation characters.

    -

    See Also

    +

    See Also

    See also

    diff --git a/ibm_zos_core/docs/source/modules/zos_ping.html b/ibm_zos_core/docs/source/modules/zos_ping.html index bb97d3ab..aedfac69 100644 --- a/ibm_zos_core/docs/source/modules/zos_ping.html +++ b/ibm_zos_core/docs/source/modules/zos_ping.html @@ -112,6 +112,8 @@
  • zos_ping – Ping z/OS and check dependencies.
    • @@ -221,7 +223,9 @@

    @@ -241,8 +245,24 @@

    Examples +

    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.

    +
    +

    +
    +

    See Also

    +
    +

    See also

    +
      +

    • ansible.builtin.ssh_module

      • +
    +
    +
    -

    Return Values

    +

    Return Values

    ping

    Should contain the value “pong” on success.

    diff --git a/ibm_zos_core/docs/source/modules/zos_script.html b/ibm_zos_core/docs/source/modules/zos_script.html index 7defbfdb..c7b3b260 100644 --- a/ibm_zos_core/docs/source/modules/zos_script.html +++ b/ibm_zos_core/docs/source/modules/zos_script.html @@ -222,22 +222,22 @@

    zos_script – Run scripts in z/OS

    -

    Synopsis

    +

    Synopsis

    • The zos_script module runs a local or remote script in the remote machine.

    -

    Parameters

    +

    Parameters

    chdir

    Change the script’s working directory to this path.

    When not specified, the script will run in the user’s home directory on the remote machine.

    @@ -301,15 +301,6 @@

    Parameterstype: str

    -
    tmp_path

    Directory path in the remote machine where local scripts will be temporarily copied to.

    -

    When not specified, the module will copy local scripts to the default temporary path for the user.

    -

    If tmp_path does not exist in the remote machine, the module will not create it.

    -

    All scripts copied to tmp_path will be removed from the managed node before the module finishes executing.

    -
    -
    required: False
    -
    type: str
    -
    -
    use_template

    Whether the module should treat src as a Jinja2 template and render it before continuing with the rest of the module.

    Only valid when src is a local file or directory.

    All variables defined in inventory files, vars files and the playbook will be passed to the template engine, as well as Ansible special variables, such as playbook_dir, ansible_version, etc.

    @@ -317,6 +308,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    template_parameters

    Options to set the way Jinja2 will process templates.

    @@ -385,6 +377,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    trim_blocks

    Whether Jinja2 should remove the first newline after a block is removed.

    @@ -399,6 +392,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    newline_sequence

    Sequence that starts a newline in a template.

    @@ -413,6 +407,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    @@ -420,7 +415,7 @@

    Parameters
    -

    Notes

    +

    Notes

    Note

    When executing local scripts, temporary storage will be used on the remote z/OS system. The size of the temporary storage will correspond to the size of the file being copied.

    +

    The location in the z/OS system where local scripts will be copied to can be configured through Ansible’s remote_tmp option. Refer to Ansible’s documentation for more information.

    +

    All local scripts copied to a remote z/OS system will be removed from the managed node before the module finishes executing.

    Execution permissions for the group assigned to the script will be added to remote scripts. The original permissions for remote scripts will be restored by the module before the task ends.

    The module will only add execution permissions for the file owner.

    If executing REXX scripts, make sure to include a newline character on each line of the file. Otherwise, the interpreter may fail and return error BPXW0003I.

    For supported character sets used to encode data, refer to the documentation.

    -

    This module uses zos_copy to copy local scripts to the remote machine.

    -

    zos_copy uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; Co:Z SFTP is not supported. In the case of Co:z SFTP, you can exempt the Ansible userid on z/OS from using Co:Z thus falling back to using standard SFTP.

    +

    This module uses zos_copy to copy local scripts to the remote machine which uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; SCP (secure copy protocol) and Co:Z SFTP are not supported. In the case of Co:z SFTP, you can exempt the Ansible user id on z/OS from using Co:Z thus falling back to using standard SFTP. If the module detects SCP, it will temporarily use SFTP for transfers, if not available, the module will fail.

    This module executes scripts inside z/OS UNIX System Services. For running REXX scripts contained in data sets or CLISTs, consider issuing a TSO command with zos_tso_command.

    The community script module does not rely on Python to execute scripts on a managed node, while this module does. Python must be present on the remote machine.

    -

    See Also

    +

    See Also

    See also

    Examples

    -
    - name: Execute TSO commands to allocate a new dataset
+
    - name: Execute TSO commands to allocate a new dataset.
   zos_tso_command:
-      commands:
-          - alloc da('TEST.HILL3.TEST') like('TEST.HILL3')
-          - delete 'TEST.HILL3.TEST'
+    commands:
+      - alloc da('TEST.HILL3.TEST') like('TEST.HILL3')
+      - delete 'TEST.HILL3.TEST'
 
-- name: Execute TSO command list user TESTUSER to obtain TSO information
+- name: Execute TSO command List User (LU) for TESTUSER to obtain TSO information.
   zos_tso_command:
-      commands:
-           - LU TESTUSER
+    commands:
+      - LU TESTUSER
 
-- name: Execute TSO command to list dataset data (allow 4 for no dataset listed or cert found)
+- name: Execute TSO command List Dataset (LISTDSD) and allow for maximum return code of 4.
   zos_tso_command:
-      commands:
-           - LISTDSD DATASET('HLQ.DATA.SET') ALL GENERIC
-      max_rc: 4
+    commands:
+      - LISTDSD DATASET('HLQ.DATA.SET') ALL GENERIC
+    max_rc: 4
+
+- name: Execute TSO command to run a REXX script explicitly from a data set.
+  zos_tso_command:
+    commands:
+      - EXEC HLQ.DATASET.REXX exec
+
+- name: Chain multiple TSO commands into one invocation using semicolons.
+  zos_tso_command:
+    commands: >-
+      ALLOCATE DDNAME(IN1) DSNAME('HLQ.PDSE.DATA.SRC(INPUT)') SHR;
+      ALLOCATE DDNAME(OUT1) DSNAME('HLQ.PDSE.DATA.DEST(OUTPUT)') SHR;
+      OCOPY INDD(IN1) OUTDD(OUT1) BINARY;
    diff --git a/ibm_zos_core/docs/source/modules/zos_unarchive.html b/ibm_zos_core/docs/source/modules/zos_unarchive.html index c46ed46a..95f368cc 100644 --- a/ibm_zos_core/docs/source/modules/zos_unarchive.html +++ b/ibm_zos_core/docs/source/modules/zos_unarchive.html @@ -284,6 +284,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    dest_volumes

    When use_adrdssu=True, specify the volume the data sets will be written to.

    @@ -353,6 +354,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    dest_data_set

    Data set attributes to customize a dest data set that the archive will be copied into.

    @@ -371,8 +373,8 @@

    Parameters
    required: False
    type: str
    -
    default: SEQ
    -
    choices: SEQ, PDS, PDSE
    +
    default: seq
    +
    choices: seq, pds, pdse

    space_primary

    If the destination dest data set does not exist , this sets the primary space allocated for the data set.

    @@ -390,19 +392,19 @@

    Parameters

    space_type

    If the destination data set does not exist, this sets the unit of measurement to use when defining primary and secondary space.

    -

    Valid units of size are K, M, G, CYL, and TRK.

    +

    Valid units of size are k, m, g, cyl, and trk.

    required: False
    type: str
    -
    choices: K, M, G, CYL, TRK
    +
    choices: k, m, g, cyl, trk
    -
    record_format

    If the destination data set does not exist, this sets the format of the data set. (e.g FB)

    -

    Choices are case-insensitive.

    +
    record_format

    If the destination data set does not exist, this sets the format of the data set. (e.g fb)

    +

    Choices are case-sensitive.

    required: False
    type: str
    -
    choices: FB, VB, FBA, VBA, U
    +
    choices: fb, vb, fba, vba, u
    record_length

    The length of each record in the data set, in bytes.

    @@ -426,16 +428,16 @@

    Parameters

    key_offset

    The key offset to use when creating a KSDS data set.

    -

    key_offset is required when type=KSDS.

    -

    key_offset should only be provided when type=KSDS

    +

    key_offset is required when type=ksds.

    +

    key_offset should only be provided when type=ksds

    required: False
    type: int
    key_length

    The key length to use when creating a KSDS data set.

    -

    key_length is required when type=KSDS.

    -

    key_length should only be provided when type=KSDS

    +

    key_length is required when type=ksds.

    +

    key_length should only be provided when type=ksds

    required: False
    type: int
    @@ -481,6 +483,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    remote_src

    If set to true, zos_unarchive retrieves the archive from the remote system.

    @@ -488,6 +491,7 @@

    Parameters
    required: False
    type: bool
    +
    default: False

    @@ -497,14 +501,14 @@

    Examples
    # Simple extract
 - name: Copy local tar file and unpack it on the managed z/OS node.
   zos_unarchive:
-    path: "./files/archive_folder_test.tar"
+    src: "./files/archive_folder_test.tar"
     format:
       name: tar
 
 # use include
 - name: Unarchive a bzip file selecting only a file to unpack.
   zos_unarchive:
-    path: "/tmp/test.bz2"
+    src: "/tmp/test.bz2"
     format:
       name: bz2
     include:
@@ -513,7 +517,7 @@ 
    Examples# Use exclude
 - name: Unarchive a terse data set and excluding data sets from unpacking.
   zos_unarchive:
-    path: "USER.ARCHIVE.RESULT.TRS"
+    src: "USER.ARCHIVE.RESULT.TRS"
     format:
       name: terse
     exclude:
@@ -523,12 +527,12 @@ 
    Examples# List option
 - name: List content from XMIT
   zos_unarchive:
-    path: "USER.ARCHIVE.RESULT.XMIT"
+    src: "USER.ARCHIVE.RESULT.XMIT"
     format:
       name: xmit
       format_options:
-        use_adrdssu: True
-    list: True
+        use_adrdssu: true
+    list: true
    @@ -537,6 +541,7 @@

    Notes

    Note

    VSAMs are not supported.

    +

    This module uses zos_copy to copy local scripts to the remote machine which uses SFTP (Secure File Transfer Protocol) for the underlying transfer protocol; SCP (secure copy protocol) and Co:Z SFTP are not supported. In the case of Co:z SFTP, you can exempt the Ansible user id on z/OS from using Co:Z thus falling back to using standard SFTP. If the module detects SCP, it will temporarily use SFTP for transfers, if not available, the module will fail.

    Return Values

    -
    path

    File path or data set name unarchived.

    +
    src

    File path or data set name unpacked.

    returned: always
    type: str
    -
    dest_path

    Destination path where archive was extracted.

    +
    dest_path

    Destination path where archive was unpacked.

    returned: always
    type: str
    diff --git a/ibm_zos_core/docs/source/modules/zos_volume_init.html b/ibm_zos_core/docs/source/modules/zos_volume_init.html index c92e6196..713ddb4d 100644 --- a/ibm_zos_core/docs/source/modules/zos_volume_init.html +++ b/ibm_zos_core/docs/source/modules/zos_volume_init.html @@ -341,14 +341,14 @@

    Exampleszos_volume_init: address: "1234" volid: "DEMO01" - sms_managed: no + sms_managed: false - name: Initialize non-SMS managed target volume with all the default options and override the default high level qualifier (HLQ). zos_volume_init: address: 1234 volid: DEMO01 - sms_managed: no + sms_managed: false tmp_hlq: TESTUSR - name: Initialize a new SMS managed DASD volume with new volume serial 'e8d8' with 30 track VTOC, an index, as long as @@ -357,12 +357,12 @@

    Exampleszos_volume_init: address: e8d8 vtoc_size: 30 - index: yes - sms_managed: yes + index: true + sms_managed: true volid: ine8d8 verify_volid: ine8d8 - verify_volume_empty: yes - verify_offline: no + verify_volume_empty: true + verify_offline: false - name: Initialize 3 new DASD volumes (0901, 0902, 0903) for use on a z/OS system as 'DEMO01', 'DEMO02', 'DEMO03' using Ansible loops. diff --git a/ibm_zos_core/docs/source/plugins.html b/ibm_zos_core/docs/source/plugins.html index 961b691e..a843db64 100644 --- a/ibm_zos_core/docs/source/plugins.html +++ b/ibm_zos_core/docs/source/plugins.html @@ -186,20 +186,21 @@

    Plugins

    -

    Plugins that come with the IBM z/OS core collection augment Ansible’s core +

    Plugins that come with the IBM z/OS core collection complement Ansible’s core functionality. Ansible uses a plugin architecture to enable a rich, flexible and expandable feature set.

    Action

    +

    Action plugins integrate local processing and local data with module functionality. +Action plugins are executed by default when an associated module is used; no additional +user action is required, this documentation is reference only.

      -

    • zos_ping: Manages the REXX source transferred to the z/OS managed node for -zos_ping.

      • -

    • zos_copy: Used to copy data from the controller to the z/OS managed -node.

      • -

    • zos_fetch: Used to fetch data from the z/OS managed node to the -controller.

      • -

    • zos_job_submit: Used to submit a job from the controller and optionally -monitor the job completion.

      • +

    • zos_copy: Used to copy data from the controller to the z/OS manage node.

      • +

    • zos_fetch: Used to fetch data from the z/OS managed node to the controller.

      • +

    • zos_job_submit: Used to submit a job from the controller to the z/OS manage node.

      • +

    • zos_ping: Used to transfer the modules REXX source to the z/OS managed node.

      • +

    • zos_script: Used to transfer scripts from the controller to the z/OS manage node.

      • +

    • zos_unarchive: Used to transfer archives from the controller to the z/OS manage node.

    diff --git a/ibm_zos_core/docs/source/reference/community.html b/ibm_zos_core/docs/source/reference/community.html new file mode 100644 index 00000000..1f594fcb --- /dev/null +++ b/ibm_zos_core/docs/source/reference/community.html @@ -0,0 +1,224 @@ + + + + + + + + + + + Contributing — Red Hat Ansible Certified Content for IBM Z documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + +
    + + + + + +
    + +
    + + + + + + + + + + + + + + + + + +
    + +
      + +
    • Docs »
      • + +
    • Contributing
      • + + + +
    + + +
    +
    +
    +
    + +
    +

    Contributing

    +

    Contributing to collections as a member of the open source community varies for +each collection. Although the collections come together as a unified solution, +each offering operates on its own; therefore, review the individual collections to learn +how to contribute.

    +
    +
    +
    + + +
    + +
    +
    + + +
    + +
    +

    + © Copyright IBM Corp. 2020, 2023 + +

    +
    + +
    + +
    +
    + +
    + +
    + + + + + + + + + + + + \ No newline at end of file diff --git a/ibm_zos_core/docs/source/reference/documentation.html b/ibm_zos_core/docs/source/reference/documentation.html new file mode 100644 index 00000000..aa72b601 --- /dev/null +++ b/ibm_zos_core/docs/source/reference/documentation.html @@ -0,0 +1,228 @@ + + + + + + + + + + + Documentation — Red Hat Ansible Certified Content for IBM Z documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + +
    + + + + + +
    + +
    + + + + + + + + + + + + + + + + + +
    + +
      + +
    • Docs »
      • + +
    • Documentation
      • + + + +
    + + +
    +
    +
    +
    + +
    +

    Documentation

    +

    In addition to the common reference material included in Helpful Links, +each collection in the Red Hat® Ansible Certified Content for IBM Z +includes supplementary documentation specific to the collection. Examples of +such documentation include Web Services APIs, guidelines for development and +testing the modules, offering-specific reading, etc.

    +
    + +
    +
    + + +
    + +
    +
    + + +
    + +
    +

    + © Copyright IBM Corp. 2020, 2023 + +

    +
    + +
    + +
    +
    + +
    + +
    + + + + + + + + + + + + \ No newline at end of file diff --git a/ibm_zos_core/docs/source/release_notes.html b/ibm_zos_core/docs/source/release_notes.html index 0f88a9d0..6fcb2adf 100644 --- a/ibm_zos_core/docs/source/release_notes.html +++ b/ibm_zos_core/docs/source/release_notes.html @@ -99,85 +99,66 @@
    • Releases
      • z/OS core
          -
        • Version 1.8.0-beta.1
            -
          • New Modules
            • +
          • Version 1.10.0
            • -
          • Version 1.7.0
              -
            • New Modules
              • -
            • Major Changes
              • -
            • Minor Changes
              • -
            • Bugfixes
              • -
            • Availability
              • -
            • Reference
              • +
            • Version 1.9.1
              • -
            • Version 1.6.0
                -
              • New Modules
                • -
              • Minor Changes
                • -
              • Bugfixes
                • +
              • Version 1.9.0 -
                • -
              • Version 1.5.0 -
                • -
              • Version 1.4.1
                • -
              • Version 1.4.0
                  -
                • Availability
                  • -
                • Reference
                  • -
                • Known Issues
                  • -
                • Deprecation Notices
                  • +
                • Version 1.8.0
                  • -
                • Version 1.3.6
                    -
                  • What’s New
                    • -
                  • Availability
                    • -
                  • Reference
                    • +
                  • Version 1.7.0
                    • -
                  • Version 1.3.5
                      -
                    • What’s New
                      • +
                    • Version 1.6.0
                      • -
                    • Version 1.3.3 -
                      • -
                    • Version 1.3.1 @@ -269,16 +250,353 @@

                      Releases

                      -
                      -

                      Version 1.8.0-beta.1

                      +
                      +

                      Version 1.10.0

                      +
                      +

                      Major Changes

                      +
                        +

                      • Starting with IBM Ansible z/OS core version 1.10.x, ZOAU version 1.3.0 will be required.

                        • +

                      • Starting with IBM Ansible z/OS core version 1.10.x, all module options are case sensitive, +review the porting guide for specifics.

                        • +

                      • The README has been updated with a new template.

                        • +

                      • The Reference section has been renamed to Requirements and now includes a support matrix.

                        • +
                      +
                      +
                      +

                      Minor Changes

                      +
                        +

                      • zos_apf - Enhanced error messages when an exception is caught.

                        • +

                      • zos_backup_restore - Added option tmp_hlq to the user module to override the default high level qualifier (HLQ) for temporary and backup data sets.

                        • +

                      • zos_copy - Documented module options group and owner.

                        • +
                      +
                      +
                      +

                      Bugfixes

                      +
                        +

                      • zos_apf - Option list previously only returned one data set, now it returns a list of retrieved data sets.

                        • +

                      • zos_blockinfile - Option block when containing double double quotation marks results in a task failure (failed=True); now the module handles this case to avoid failure.

                        • +

                      • zos_find - Option size failed if a PDS/E matched the pattern, now filtering on utilized size for a PDS/E is supported.

                        • +

                      • zos_job_submit

                        +
                          +

                        • Did not default to location=DATA_SET when no location was defined, now the location defaults to DATA_SET.

                          • +

                        • Option max_rc previously did not influence a modules status, now the option value influences the tasks failure status.

                          • +
                        +
                        • +

                      • zos_mvs_raw - Option tmp_hlq when creating temporary data sets was previously ignored, now the option honors the High Level Qualifier for temporary data sets created during the module execution.

                        • +
                      +
                      +
                      +

                      Porting Guide

                      +

                      This section discusses the behavioral changes between ibm_zos_core v1.9.0 and ibm_zos_core v1.10.0-beta.1. +It is intended to assist in updating your playbooks so this collection will continue to work.

                      +
                        +

                      • zos_archive

                        +
                          +

                        • option terse_pack no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboption record_format of dest_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboption space_type of dest_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboption type of dest_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +
                        +
                        • +

                      • zos_backup_restore - option space_type no longer accepts uppercase choices, users should replace them with lowercase ones.

                        • +

                      • zos_copy

                        +
                          +

                        • suboption record_format of dest_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboption space_type of dest_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboption type of dest_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +
                        +
                        • +

                      • zos_data_set

                        +
                          +

                        • option record_format no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • option space_type no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • option type no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • options inside batch no longer accept uppercase choices, users should replace them with lowercase ones.

                          • +
                        +
                        • +

                      • zos_job_submit - option location no longer accepts uppercase choices, users should replace them with lowercase ones.

                        • +

                      • zos_mount

                        +
                          +

                        • option automove no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • option fs_type no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • option mount_opts no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • option tag_untagged no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • option unmount_opts no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +
                        +
                        • +

                      • zos_mvs_raw

                        +
                          +

                        • options inside dd_concat no longer accept uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboption record_format of dd_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboption record_format of dd_unix no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboption space_type of dd_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboption type of dd_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboptions disposition_normal and disposition_abnormal of dd_data_set no longer accept catlg and uncatlg as choices. This also applies when defining a dd_data_set inside dd_concat.

                          • +
                        +
                        • +

                      • zos_unarchive

                        +
                          +

                        • suboption record_format of dest_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboption space_type of dest_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +

                        • suboption type of dest_data_set no longer accepts uppercase choices, users should replace them with lowercase ones.

                          • +
                        +
                        • +
                      +
                      +
                      +

                      Availability

                      + +
                      +
                      +

                      Requirements

                      +

                      The IBM z/OS core collection has several dependencies, please review the z/OS core support matrix to understand both the +controller and z/OS managed node dependencies.

                      +
                      +
                      +

                      Known Issues

                      +
                        +

                      • zos_job_submit - when setting ‘location’ to ‘local’ and not specifying the from and to encoding, the modules defaults are not read leaving the file in its original encoding; explicitly set the encodings instead of relying on the default.

                        • +

                      • zos_job_submit - when submitting JCL, the response value returned for byte_count is incorrect.

                        • +

                      • zos_data_set - When data set creation fails, exception can throw a bad import error instead of data set creation error.

                        • +

                      • zos_copy - To use this module, you must define the RACF FACILITY class profile and allow READ access to RACF FACILITY profile MVS.MCSOPER.ZOAU. If your system uses a different security product, consult that product’s documentation to configure the required security classes.

                        • +

                      • zos_job_submit, zos_job_output, zos_operator_action_query - encounters JSON decoding (DecodeError, TypeError, KeyError) errors when interacting with results that contain non-printable UTF-8 characters in the response. This will be addressed in ZOAU version 1.3.2 and later.

                        +
                        +
                          +

                        • Some options to work around this known issue are:

                          +
                          +
                            +

                          • Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters.

                            • +

                          • Ignore module errors by using ignore_errors:true for a specific playbook task.

                            • +

                          • If the error is resulting from a batch job, add ignore_errors:true to the task and capture the output into a registered variable to extract the +job ID with a regular expression. Then use zos_job_output to display the DD without the non-printable character such as the DD JESMSGLG.

                            • +

                          • If the error is the result of a batch job, set option return_output to false so that no DDs are read which could contain the non-printable UTF-8 characters.

                            • +
                          +
                          +
                          • +
                        +
                        +
                        • +

                      • In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, this is so that the collection can continue to maintain certified status.

                        • +

                      • Use of special characters (#, @, $, - ) in different options like data set names and commands is not fully supported, some modules support them but is the user responsibility to escape them. Read each module documentation for further details.

                        • +
                      +
                      +
                      +
                      +

                      Version 1.9.1

                      +
                      +

                      Bugfixes

                      +
                        +

                      • zos_find - Option size failed if a PDS/E matched the pattern, now filtering on utilized size for a PDS/E is supported.

                        • +

                      • zos_mvs_raw - Option tmp_hlq when creating temporary data sets was previously ignored, now the option honors the High Level Qualifier for temporary data sets created during the module execution.

                        • +
                      +
                      +
                      +

                      Availability

                      + +
                      +
                      +

                      Requirements

                      +

                      The IBM z/OS core collection has several dependencies, please review the z/OS core support matrix to understand both the +controller and z/OS managed node dependencies.

                      +
                      +
                      +

                      Known Issues

                      +
                        +

                      • zos_job_submit - when setting ‘location’ to ‘local’ and not specifying the from and to encoding, the modules defaults are not read leaving the file in its original encoding; explicitly set the encodings instead of relying on the default.

                        • +

                      • zos_job_submit - when submitting JCL, the response value returned for byte_count is incorrect.

                        • +

                      • zos_job_submit, zos_job_output, zos_operator_action_query - encounters UTF-8 decoding errors when interacting with results that contain non-printable UTF-8 characters in the response. This has been addressed in this release and corrected with ZOAU version 1.2.5.6 or later.

                        +
                        +
                          +

                        • If the appropriate level of ZOAU can not be installed, some options are to:

                          +
                          +
                            +

                          • Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters.

                            • +

                          • Ignore module errors by using ignore_errors:true for a specific playbook task.

                            • +

                          • If the error is resulting from a batch job, add ignore_errors:true to the task and capture the output into a registered variable to extract the +job ID with a regular expression. Then use zos_job_output to display the DD without the non-printable character such as the DD JESMSGLG.

                            • +

                          • If the error is the result of a batch job, set option return_output to false so that no DDs are read which could contain the non-printable UTF-8 characters.

                            • +
                          +
                          +
                          • +
                        +
                        +
                        • +

                      • zos_data_set - An undocumented option size was defined in module zos_data_set, this has been removed to satisfy collection certification, use the intended and documented space_primary option.

                        • +

                      • In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, this is so that the collection can continue to maintain certified status.

                        • +
                      +
                      +
                      +
                      +

                      Version 1.9.0

                      +
                      +

                      Major Changes

                      +
                      +
                        +

                      • IBM Ansible z/OS core collection (ibm_zos_core) version 1.9.0 will be the last release to support ZOAU 1.2.x.

                        +
                          +

                        • IBM Ansible z/OS core version 1.9.0 will continue to receive security updates and bug fixes.

                          • +
                        +
                        • +

                      • Starting with IBM Ansible z/OS core version 1.10.0, ZOAU version 1.3.0 will be required.

                        • +

                      • IBM Open Enterprise SDK for Python version 3.9.x is no longer supported.

                        • +
                      +
                      +
                      +
                      +

                      Minor Changes

                      +
                        +

                      • zos_apf - Improved exception handling when the module is unable to process a response originating as a batch update.

                        • +

                      • zos_copy - Improved performance when copying multiple members from one PDS/E to another PDS/E.

                        • +

                      • zos_job_output - Has been enhanced to allow for both a job ID and owner to be selected when obtaining job output, removing the prior mutual exclusivity.

                        • +

                      • zos_operator - Improved the modules handling of ZOAU import errors allowing for the traceback to flow back to the source.

                        • +

                      • zos_job_query - Improved the modules handling of ZOAU import errors allowing for the traceback to flow back to the source.

                        • +

                      • zos_job_submit

                        +
                        +
                          +

                        • Improved messages in the action plugin.

                          • +

                        • Improved the action plugin performance, flow and use of undocumented variables.

                          • +

                        • Improved the modules handling of ZOAU import errors allowing for the traceback to flow back to the source.

                          • +

                        • Improved job status support, now the supported statuses for property ret_code[msg] are:

                          +
                            +

                          • Job status ABEND indicates the job ended abnormally.

                            • +

                          • Job status AC indicates the job is active, often a started task or job taking long.

                            • +

                          • Job status CAB indicates a converter abend.

                            • +

                          • Job status CANCELED indicates the job was canceled.

                            • +

                          • Job status CNV indicates a converter error.

                            • +

                          • Job status FLU indicates the job was flushed.

                            • +

                          • Job status JCLERR or JCL ERROR indicates the JCL has an error.

                            • +

                          • Job status SEC or SEC ERROR indicates the job as encountered a security error.

                            • +

                          • Job status SYS indicates a system failure.

                            • +

                          • Job status ? indicates status can not be determined.

                            • +
                          +
                          • +
                        +
                        +
                        • +

                      • zos_tso_command

                        +
                        +
                          +

                        • Has been updated with a new example demonstrating how to explicitly execute a REXX script in a data set.

                          • +

                        • Has been updated with a new example demonstrating how to chain multiple TSO commands into one invocation using semicolons.

                          • +
                        +
                        +
                        • +

                      • zos_mvs_raw

                        +
                        +
                          +

                        • Has been enhanced to ensure that instream-data for option dd_input contain blanks in columns 1 and 2 while retaining a maximum length +of 80 columns for strings and a list of strings. This is generally the requirement for most z/OS programs.

                          • +

                        • Has been updated with new examples demonstrating a YAML block indicator, often helpful when wanting to control the +instream-data formatting.

                          • +
                        +
                        +
                        • +
                      +
                      +
                      +

                      Bugfixes

                      +
                        +

                      • zos_apf - Fixed an issue that when operation=list was selected and more than one data set entry was fetched, only one +data set was returned, now the complete list is returned.

                        • +

                      • zos_copy

                        +
                        +
                          +

                        • Fixed an issue that when copying an aliased executable from a data set to a non-existent data set, the destination +datasets primary and secondary extents would not match the source data set extent sizes.

                          • +

                        • Fixed an issue when performing a copy operation to an existing file, the copied file resulted in having corrupted contents.

                          • +
                        +
                        +
                        • +

                      • zos_job_submit

                        +
                        +
                          +

                        • Fixed an issue that when no location is set, the default is not correctly configured to location=DATA_SET.

                          • +

                        • Fixed an issue that when a JCL error is encountered, the ret_code[msg_code] no longer will contain the multi line marker used to coordinate errors.

                          • +

                        • Fixed an issue that when a response was returned, the property ret_code[msg_text] was incorrectly returned over ret_code[msg_txt].

                          • +

                        • Fixed an issue that when JCL contained TYPRUN=SCAN, the module would fail. The module no longer fails and an appropriate message and response is returned.

                          • +

                        • Fixed an issue that when JCL contained either TYPRUN=COPY, TYPRUN=HOLD, or TYPRUN=JCLHOLD an improper message was returned and the job submission failed. +Now the job will fail under the condition that the module has exceeded its wait time and return a proper message.

                          • +

                        • Fixed an issue where when option wait_time_s was used, the duration would be approximately 5 seconds longer than what was reported in the duration. +Now the duration is from when the job is submitted to when the module reads the job output.

                          • +
                        +
                        +
                        • +

                      • zos_job_output - Fixed an issue that when using a job ID with less than 8 characters, would result in a traceback. The fix +supports shorter job IDs as well as the use of wildcards.

                        • +

                      • zos_job_query - Fixed an issue that when using a job ID with less than 8 characters, would result in a traceback. The fix +supports shorter job IDs as well as the use of wildcards.

                        • +

                      • zos_unarchive

                        +
                        +
                          +

                        • Fixed an issue that when using a local file with the USS format option, the module would fail to send the archive to the managed node.

                          • +

                        • Fixed an issue that occurred when unarchiving USS files, the module would leave temporary files behind on the managed node.

                          • +
                        +
                        +
                        • +

                      • module_utils

                        +
                        +
                          +

                        • job.py - Improved exception handling and added a message inside the content of the ddname when a non-printable +character (character that can not be converted to UTF-8) is encountered.

                          • +

                        • data_set.py - Fixed an issue that when a volser name less than 6 characters was encountered, the volser name was padded with hyphens to have length 6.

                          • +
                        +
                        +
                        • +
                      +
                      +
                      +

                      Known Issues

                      +

                      Several modules have reported UTF-8 decoding errors when interacting with results that contain non-printable UTF-8 characters in the response.

                      +
                        +

                      • This occurs when a module receives content that does not correspond to a UTF-8 value. These include modules zos_job_submit, zos_job_output, +zos_operator_action_query` but are not limited to this list. This has been addressed in this release and corrected with ZOAU version 1.2.5.6.

                        • +

                      • If the appropriate level of ZOAU can not be installed, some options are to:

                        +
                          +

                        • Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters.

                          • +

                        • Ignore module errors by using ignore_errors:true for a specific playbook task.

                          • +

                        • If the error is resulting from a batch job, add ignore_errors:true to the task and capture the output into a registered variable to extract the +job ID with a regular expression. Then use zos_job_output to display the DD without the non-printable character such as the DD JESMSGLG.

                          • +

                        • If the error is the result of a batch job, set option return_output to false so that no DDs are read which could contain the non-printable UTF-8 characters.

                          • +
                        +
                        • +
                      +

                      An undocumented option size was defined in module zos_data_set, this has been removed to satisfy collection certification, use the intended +and documented space_primary option.

                      +

                      In the past, choices could be defined in either lower or upper case. Now, only the case that is identified in the docs can be set, +this is so that the collection can continue to maintain certified status.

                      +
                      +
                      +

                      Availability

                      + +
                      +
                      +

                      Requirements

                      +

                      The IBM z/OS core collection has several dependencies, please review the z/OS core support matrix to understand both the +controller and z/OS managed node dependencies.

                      +
                      +
                      +
                      +

                      Version 1.8.0

                      New Modules

                      • zos_script - Run scripts in z/OS

                      -
                      -

                      Minor Changes

                      +
                      +

                      Minor Changes

                    • zos_fetch - Add validation into path joins to detect unauthorized path traversals.

                      • -

                    • zos_job_submit - Change action plugin call from copy to zos_copy.

                      • -

                    • zos_operator - Changed system to call ‘wait=true’ parameter to zoau call. Requires zoau 1.2.5 or later.

                      • +

                    • zos_job_submit

                      +
                      +
                        +

                      • Change action plugin call from copy to zos_copy.

                        • +

                      • Previous code did not return output, but still requested job data from the target system. This changes to honor return_output=false by not querying the job dd segments at all.

                        • +
                      +
                      +
                      • +

                    • zos_operator - Changed system to call wait=true parameter to zoau call. Requires zoau 1.2.5 or later.

                    • zos_operator_action_query - Add a max delay of 5 seconds on each part of the operator_action_query. Requires zoau 1.2.5 or later.

                    • zos_unarchive

                      @@ -312,57 +637,86 @@

                      Minor Changesmodule_utils/template - Add validation into path joins to detect unauthorized path traversals.

                      • +

                    • zos_tso_command - Add example for executing explicitly a REXX script from a data set.

                      • +

                    • zos_script - Add support for remote_tmp from the Ansible configuration to setup where temporary files will be created, replacing the module option tmp_path.

    -
    -

    Bugfixes

    -
      -

    • zos_copy - Update option limit to include LIBRARY as dest_dataset/suboption value. Documentation updated to reflect this change.

      • -

    • zos_job_submit - Temporary files were created in tmp directory. Fix now ensures the deletion of files every time the module run.

      • -

    • zos_job_submit - The last line of the jcl was missing in the input. Fix now ensures the presence of the full input in job_submit.

      • +
      +

      Bugfixes

      +
        +

      • zos_copy

        +
        +
          +

        • Update option to include LIBRARY as dest_dataset/suboption value. Documentation updated to reflect this change.

          • +

        • When copying an executable data set from controller to managed node, copy operation failed with an encoding error. Fix now avoids encoding when executable option is selected.

          • +

        • When copying an executable data set with aliases and destination did not exist, destination data set was created with wrong attributes. Fix now creates destination data set with the same attributes as the source.

          • +

        • When performing a copy operation to an existing file, the copied file resulted in having corrupted contents. Fix now implements a workaround to not use the specific copy routine that corrupts the file contents.

          • +
        +
        +
        • +

      • zos_job_submit

        +
        +
          +

        • Temporary files were created in tmp directory. Fix now ensures the deletion of files every time the module run.

          • +

        • The last line of the jcl was missing in the input. Fix now ensures the presence of the full input in job_submit.

          • +
        +
        +

      • zos_lineinfile - A duplicate entry was made even if line was already present in the target file. Fix now prevents a duplicate entry if the line already exists in the target file.

        • -

      • zos_operator - The last line of the operator was missing in the response of the module. The fix now ensures the presence of the full output of the operator.

        • +

      • zos_operator

        +
        +
          +

        • The last line of the operator was missing in the response of the module. The fix now ensures the presence of the full output of the operator.

          • +

        • The module was ignoring the wait time argument. The module now passes the wait time argument to ZOAU.

          • +
        +
        +
        • +

      • zos_operator_action_query - The module was ignoring the wait time argument. The module now passes the wait time argument to ZOAU.

        • +

      • zos_unarchive - When zos_unarchive fails during unpack either with xmit or terse it does not clean the temporary data sets created. Fix now removes the temporary data sets.

      -
      -

      Known Issues

      +
      +

      Known Issues

      +

      Several modules have reported UTF-8 decoding errors when interacting with results that contain non-printable UTF-8 characters in the response.

      +

      This occurs when a module receives content that does not correspond to a UTF-8 value. These include modules zos_job_submit, zos_job_output, +zos_operator_action_query` but are not limited to this list. This will be addressed in ibm_zos_core version 1.10.0-beta.1. Each case is +unique, some options to work around the error are below.

        -

      • Several modules have reported UTF8 decoding errors when interacting with results that contain non-printable UTF8 characters in the response. This occurs when a module receives content that does not correspond to a UTF-8 value. These include modules zos_job_submit, zos_job_output, zos_operator_action_query but are not limited to this list. This will be addressed in ibm_zos_core version 1.10.0-beta.1. Each case is unique, some options to work around the error are below. - Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters. - Add ignore_errors:true to the playbook task so the task error will not fail the playbook. - If the error is resulting from a batch job, add ignore_errors:true to the task and capture the output into a variable and extract the job ID with a regular expression and then use zos_job_output to display the DD without the non-printable character such as the DD JESMSGLG.

        • -

      • With later versions of ansible-core used with ibm_zos_core collection a warning has started to appear “Module “ansible.builtin.command” returned non UTF-8 data in the JSON response” that is currently being reviewed. There are no recommendations at this point.

        • +

      • Specify that the ASA assembler option be enabled to instruct the assembler to use ANSI control characters instead of machine code control characters.

        • +

      • Add ignore_errors:true to the playbook task so the task error will not fail the playbook.

        • +

      • If the error is resulting from a batch job, add ignore_errors:true to the task and capture the output into a variable and extract the job ID with +a regular expression and then use zos_job_output to display the DD without the non-printable character such as the DD JESMSGLG.

      -
      -

      Availability

      +
      +

      Availability

      -
      -

      Reference

      - +
      +

      Requirements

      +

      The IBM z/OS core collection has several dependencies, please review the z/OS core support matrix to understand both the +controller and z/OS managed node dependencies.

      Version 1.7.0

      -
      -

      New Modules

      +
      +

      New Modules

      • zos_archive - archive files, data sets and extend archives on z/OS. Formats include, bz2, gz, tar, zip, terse, xmit and pax.

      • zos_unarchive - unarchive files and data sets on z/OS. Formats include, bz2, gz, tar, zip, terse, xmit and pax.

      -
      -

      Major Changes

      +
      +

      Major Changes

      – zos_copy and zos_job_submit - supports Jinja2 templating which is essential for handling tasks that require advanced file modifications such as JCL.

      -
      -

      Minor Changes

      +
      +

      Minor Changes

      • zos_copy

        @@ -401,8 +755,8 @@

        Minor Changes -

        Bugfixes

        +
        +

        Bugfixes

        -
        -

        Availability

        + -
        -

        Reference

        - +
        +

        Requirements

        +

        The IBM z/OS core collection has several dependencies, please review the z/OS core support matrix to understand both the +controller and z/OS managed node dependencies.

        Version 1.6.0

        -
        -

        New Modules

        +
        +

        New Modules

        • zos_volume_init - Can initialize volumes or minidisks on target z/OS systems which includes creating a volume label and an entry into the volume table of contents (VTOC).

        -
        -

        Minor Changes

        +
        +

        Minor Changes

        • zos_blockinfile - Adds an enhancement to allow double quotes within a block.

        • zos_copy

          @@ -473,8 +823,8 @@

          Minor Changes -

          Bugfixes

          + -
          -

          Availability

          + -
          -

          Reference

          - +
          +

          Requirements

          +

          The IBM z/OS core collection has several dependencies, please review the z/OS core support matrix to understand both the +controller and z/OS managed node dependencies.

          Version 1.5.0

          -
          -

          New Modules

          +
          +

          New Modules

          • zos_gather_facts - can retrieve variables from target z/OS systems that are then available to playbooks through the ansible_facts dictionary and managed using filters.

          -
          -

          Major Changes

          +
          +

          Major Changes

          • ibm_zos_core - Updates the entire collection in that the collection no longer depends on the managed node having installed System Display and Search Facility (SDSF). Remove SDSF dependency from ibm_zos_core collection.

          -
          -

          Minor Changes

          +
          +

          Minor Changes

          -
          -

          Version 1.4.1

          -
          -

          Bug fixes

          -
            -

          • zos_copy

            -
            -
              -

            • Copy failed from a loadlib member to another loadlib member. Fix -now looks for error in stdout in the if statement to use -X option.

              • -

            • Fixes a bug where files not encoded in IBM-1047 would trigger an -error while computing the record length for a new destination dataset.

              • -

            • Fixes a bug where the code for fixing an issue with newlines in -files.

              • -

            • fixed wrongful creation of destination backups when module option -force is true, creating emergency backups meant to restore the system to -its initial state in case of a module failure only when force is false.

              • -

            • fixes a bug where the computed record length for a new destination -dataset would include newline characters.

              • -
            -
            -
            • -

          • zos_job_query

            -
            -
              -

            • fixes a bug where a boolean was not being properly compared.

              • -
            -
            -
            • -
          -
          -
          -

          Availability

          - -
          -
          -

          Reference

          - -
          -
          -
          -

          Version 1.4.0

          -
            -

          • Modules

            -
              -

            • zos_mount can manage mount operations for a -z/OS UNIX System Services (USS) file system data set.

              • -
            -
            • -

          • Plugins

            -
              -

            • zos_ssh connection plugin has been removed from this release and is no -longer a dependency for the zos_ping module.

              • -
            -
            • -

          • Bug fixes and enhancements

            -
              -

            • Modules

              -
                -

              • zos_copy

                -
                  -

                • introduced an updated creation policy referred to as precedence rules -that if dest_data_set is set, it will take precedence. If -dest is an empty data set, the empty data set will be written with the -expectation its attributes satisfy the copy. If no precedent rule -has been exercised, dest will be created with the same attributes of -src.

                  • -

                • introduced new computation capabilities that if dest is a nonexistent -data set, the attributes assigned will depend on the type of src. If -src is a USS file, dest will have a Fixed Block (FB) record format -and the remaining attributes will be computed. If src is binary, -dest will have a Fixed Block (FB) record format with a record length -of 80, block size of 32760, and the remaining attributes will be -computed.

                  • -

                • enhanced the force option when force=true and the remote file or -data set dest` is NOT empty, the dest will be deleted and recreated -with the src data set attributes, otherwise it will be recreated with -the dest data set attributes.

                  • -

                • was enhanced for when src is a directory and ends with “/”, -the contents of it will be copied into the root of dest. It it doesn’t -end with “/”, the directory itself will be copied.

                  • -

                • option dest_dataset has been deprecated and removed in favor -of the new option dest_data_set.

                  • -

                • fixes a bug that when a directory is copied from the controller to the -managed node and a mode is set, the mode is applied to the directory -on the managed node. If the directory being copied contains files and -mode is set, mode will only be applied to the files being copied not the -pre-existing files.

                  • -

                • fixes a bug that did not create a data set on the specified volume.

                  • -

                • fixes a bug where a number of attributes were not an option when using -dest_data_set.

                  • -

                • fixes a bug where options were not defined in the module -argument spec that will result in error when running ansible-core -v2.11 and using options force or mode.

                  • -

                • was enhanced to support the ansible.builtin.ssh connection options; -for further reference refer to the SSH plugin documentation.

                  • -

                • was enhanced to take into account the record length when the -source is a USS file and the destination is a data set with a record -length. This is done by inspecting the destination data set attributes -and using these attributes to create a new data set.

                  • -

                • was updated with the capabilities to define destination data sets from -within the zos_copy module. In the case where you are copying to -data set destination that does not exist, you can now do so using the -new zos_copy module option destination_dataset.

                  • -
                -
                • -

              • zos_operator

                -
                  -

                • enhanced to allow for MVS operator SET command, SET is -equivalent to the abbreviated T command.

                  • -
                -
                • -

              • zos_mount fixed option tag_ccsid to correctly allow for type int.

                • -

              • module_utils

                -
                  -

                • jobs.py - fixes a utility used by module zos_job_output that would -truncate the DD content.

                  • -
                -
                • -

              • zos_ping was enhanced to remove the need for the zos_ssh -connection plugin dependency.

                • -

              • zos_fetch was enhanced to support the ansible.builtin.ssh -connection options; for further reference refer to the -SSH plugin documentation.

                • -

              • zos_job_output

                -
                  -

                • was updated to correct possible truncated responses for -the ddname content. This would occur for jobs with very large amounts -of content from a ddname.

                  • -

                • was enhanced to to include the completion code (CC) for each individual -jop step as part of the ret_code response.

                  • -
                -
                • -

              • zos_job_query

                -
                  -

                • was enhanced to support a 7 digit job number ID for when there are -greater than 99,999 jobs in the history.

                  • -

                • was enhanced to handle when an invalid job ID or job name is used with -the module and returns a proper response.

                  • -
                -
                • -

              • zos_job_submit

                -
                  -

                • was enhanced to fail fast when a submitted job fails instead of waiting -a predetermined time.

                  • -

                • was enhanced to check for ‘JCL ERROR’ when jobs are submitted and result -in a proper module response.

                  • -
                -
                • -

              • zos_operator_action_query response messages were improved with more -diagnostic information in the event an error is encountered.

                • -
              -
              • -
            -
            • -

          • Deprecated or removed

            -
              -

            • zos_copy module option destination_dataset has been renamed to -dest_data_set.

              • -

            • zos_ssh connection plugin has been removed, it is no longer required. -Remove all playbook references, ie connection: ibm.ibm_zos_core.zos_ssh.

              • -

            • zos_ssh connection plugin has been removed, it is no longer required. -You must remove the zos_ssh connection plugin from all playbooks that -reference the plugin, for example connection: ibm.ibm_zos_core.zos_ssh.

              • -

            • zos_copy module option model_ds has been removed. The model_ds logic -is now automatically managed and data sets are either created based on the -src data set or overridden by the new option destination_dataset.

              • -

            • zos_copy and zos_fetch option sftp_port has been deprecated. To -set the SFTP port, use the supported options in the ansible.builtin.ssh -plugin. Refer to the SSH port option to configure the port used during -the modules SFTP transport.

              • -
            -
            • -

          • Documentation

            -
              -

            • Noteworthy documentation updates have been made to:

              -
                -

              • zos_copy and zos_fetch about Co:Z SFTP support.

                • -

              • zos_mvs_raw removed a duplicate example.

                • -

              • all action plugins are documented

                • -

              • update hyperlinks embedded in documentation.

                • -

              • zos_operator to explains how to use single quotes in operator commands.

                • -
              -
              • -
            -
            • -
          -
          -

          Availability

          - -
          -
          -

          Reference

          - -
          -
          -

          Known Issues

          -
            -

          • If a playbook includes the deprecated zos_ssh connection plugin, for -example connection: ibm.ibm_zos_core.zos_ssh, it will -encounter this error which can corrected by safely removing the plugin:

            -
            "msg": "the connection plugin 'ibm.ibm_zos_core.zos_ssh' was not found"
-
            -
            -
            • -

          • When using the zos_ssh plugin with Ansible 2.11 and earlier versions -of this collection, you will encounter the exception:

            -
            AttributeError: module 'ansible.constants' has no attribute 'ANSIBLE_SSH_CONTROL_PATH_DIR'.
-
            -
            -

            This is resolved in this release by deprecating the zos_ssh connection -plugin and removing all connection: ibm.ibm_zos_core.zos_ssh references -from playbooks.

            -
            • -

          • When using module zos_copy and option force with ansible versions -greater than Ansbile 2.10 and earlier versions of this collection, an -unsupported option exception would occur. This is resolved in this release.

            • -

          • When using the zos_copy or zos_fetch modules in earlier versions of -this collection without ‘passwordless’ SSH configured such that you are using ---ask-pass or passing an ansible_password in a configuration; during -the playbook execution a second password prompt for SFTP would appear pausing -the playbook execution. This is resolved in this release.

            • -

          • When using the zos_copy or zos_fetch modules, if you tried to use -Ansible connection options such as host_key_checking or port, they -were not included as part of the modules execution. This is resolved in this -release by ensuring compatibility with the ansible.builtin.ssh plugin -options. Refer to the SSH plugin documentation to enable supported options.

            • -

          • Known issues for modules can be found in the Notes section of a modules -documentation.

            • -
          -
          -
          -

          Deprecation Notices

          -

          Features and functions are marked as deprecated when they are enhanced and an -alternative is available. In most cases, the deprecated item will remain -available unless the deprecated function interferes with the offering. -Deprecated functions are no longer supported, and will be removed in a future -release.

          -
          -
          -
          -

          Version 1.3.6

          -
          -

          What’s New

          -
            -

          • Bug Fixes

            -
              -

            • Modules

              -
                -

              • zos_copy fixes a bug that when a directory is copied from the -controller to the managed node and a mode is set, the mode is now applied -to the directory on the controller. If the directory being copied contains -files and mode is set, mode will only be applied to the files being copied -not the pre-existing files.

                • -

              • zos_copy - fixes a bug where options were not defined in the module -argument spec that will result in error when running ansible-core v2.11 -and using options force or mode.

                • -

              • zos_copy - was enhanced for when src is a directory and ends with “/”, -the contents of it will be copied into the root of dest. It it doesn’t -end with “/”, the directory itself will be copied.

                • -

              • zos_fetch - fixes a bug where an option was not defined in the module -argument spec that will result in error when running ansible-core v2.11 -and using option encoding.

                • -

              • zos_job_submit - fixes a bug where an option was not defined in the -module argument spec that will result in error when running -ansible-core v2.11 and using option encoding.

                • -

              • jobs.py - fixes a utility used by module zos_job_output that would -truncate the DD content.

                • -

              • zos_ssh connection plugin was updated to correct a bug that causes -an ANSIBLE_SSH_CONTROL_PATH_DIR attribute error only when using -ansible-core v2.11.

                • -
              -
              • -
            -
            • -
          -
          -
          -

          Availability

          - -
          -
          -

          Reference

          - -
          -
          -
          -

          Version 1.3.5

          -
          -

          What’s New

          -
            -

          • Bug Fixes

            -
              -

            • Modules

              -
                -

              • zos_ssh connection plugin was updated to correct a bug in Ansible that -would result in playbook task retries overriding the SSH connection -retries. This is resolved by renaming the zos_ssh option -retries to reconnection_retries. The update addresses users of -ansible-core v2.9 which continues to use retries and users of -ansible-core v2.11 or later which uses reconnection_retries. This -also resolves a bug in the connection that referenced a deprecated -constant.

                • -

              • zos_job_output fixes a bug that returned all ddname’s when a specific -ddname was provided. Now a specific ddname can be returned and all others -ignored.

                • -

              • zos_copy fixes a bug that would not copy subdirectories. If the source -is a directory with sub directories, all sub directories will now be copied.

                • -
              -
              • -
            -
            • -
          -
          -
          -

          Availability

          - -
          -
          -

          Reference

          - -
          -
          -
          -

          Version 1.3.3

          -
          -

          What’s New

          -
            -

          • Bug Fixes

            -
              -

            • Modules

              -
                -

              • zos_copy was updated to correct deletion of all temporary files and -unwarranted deletes.

                -
                -
                  -

                • When the module would complete, a cleanup routine did not take into -account that other processes had open temporary files and thus would -error when trying to remove them.

                  • -

                • When the module would copy a directory (source) from USS to another -USS directory (destination), any files currently in the destination -would be deleted. -The modules behavior has changed such that files are no longer deleted -unless the force option is set to true. When force=true, -copying files or a directory to a USS destination will continue if it -encounters existing files or directories and overwrite any -corresponding files.

                  • -
                -
                -
                • -

              • zos_job_query was updated to correct a boolean condition that always -evaluated to “CANCELLED”.

                -
                -
                  -

                • When querying jobs that are either CANCELLED or have FAILED, -they were always treated as CANCELLED.

                  • -
                -
                -
                • -
              -
              • -
            -
            • -
          -
          -
          -

          Availability

          - -
          -
          -

          Reference

          - -
          -
          -
          -

          Version 1.3.1

          -
          -

          What’s New

          -
            -

          • Bug Fixes

            -
              -

            • Modules

              -
                -

              • Connection plugin zos_ssh was updated to prioritize the execution of -modules written in REXX over other implementations such is the case for -zos_ping.

                • -

              • zos_ping was updated to support Automation Hub documentation -generation.

                • -
              -
              • -
            -
            • -
          -

          Availability

          -
          -

          Known issues

          -
            -

          • Modules

            -
              -

            • When executing programs using zos_mvs_raw, you may encounter errors -that originate in the implementation of the programs. Two such known issues -are noted below of which one has been addressed with an APAR.

              -
                -

              1. zos_mvs_raw module execution fails when invoking -Database Image Copy 2 Utility or Database Recovery Utility in conjunction -with FlashCopy or Fast Replication.

                2. -

              2. zos_mvs_raw module execution fails when invoking DFSRRC00 with parm -“UPB,PRECOMP”, “UPB, POSTCOMP” or “UPB,PRECOMP,POSTCOMP”. This issue is -addressed by APAR PH28089.

                3. -
              -
              • -
            -
            • -
          -
          -
          -
          -

          Version 1.3.0

          -
          -

          What’s New

          -
            -

          • Modules

            -
              -

            • zos_apf - Add or remove libraries to and from Authorized Program Facility (APF).

              • -

            • zos_backup_restore - Backup and restore data sets and volumes.

              • -

            • zos_blockinfile - Manage block of multi-line textual data on z/OS.

              • -

            • zos_find - Find matching data sets.

              • -

            • zos_data_set - added support to allocate and format zFS data sets

              • -

            • zos_operator - supports new options wait and wait_time_s such -that you can specify that zos_operator wait the full wait_time_s or -return as soon as the first operator command executes.

              • -

            • All modules support relative paths and remove choice case sensitivity.

              • -
            -
            • -

          • Bug Fixes

            -
              -

            • Modules

              -
                -

              • Action plugin zos_copy was updated to support Python 2.7.

                • -

              • Module zos_copy was updated to fail gracefully when a it -encounters a non-zero return code.

                • -

              • Module zos_copy was updated to support copying data set members that -are program objects to a PDSE. Prior to this update, copying data set -members would yield an error: -FSUM8976 Error writing <src_data_set_member> to PDSE member -<dest_data_set_member>

                • -

              • Job utility is an internal library used by several modules. It has been -updated to use a custom written parsing routine capable of handling -special characters to prevent job related reading operations from failing -when a special character is encountered.

                • -

              • Module zos_job_submit was updated to remove all trailing r from -jobs that are submitted from the controller.

                • -

              • Module zos_job_submit referenced a non-existent option and was -corrected to wait_time_s.

                • -

              • Module zos_tso_command support was added for when the command output -contained special characters.

                • -
              -
              • -

            • Playbooks

              -
                -

              • Playbook zos_operator_basics.yaml -has been updated to use end in the WTO reply over the previous use of -cancel. Using cancel is not a valid reply and results in an execution -error.

                • -
              -
              • -
            -
            • -

          • Playbooks

            - -
            • -

          • Documentation

            -
              -

            • All documentation related to playbook configuration has been -migrated to the playbook repository. Each playbook contains a README -that explains what configurations must be made to run a sample playbook.

              • -

            • We have been carefully reviewing our users feedback and over time we have -compiled a list of information that we feel would help everyone and have -released this information in our new FAQs.

              • -

            • Learn about the latest features and experience them before you try -them through the blogs that discuss playbooks, modules, and use cases:

              - -
              • -
            -
            • -
          -
          -
          -

          Availability

          - -
          -
          -

          Reference

          - -
          -
          -

          Known issues

          -
            -

          • Modules

            -
              -

            • When executing programs using zos_mvs_raw, you may encounter errors -that originate in the implementation of the programs. Two such known issues -are noted below of which one has been addressed with an APAR.

              -
                -

              1. zos_mvs_raw module execution fails when invoking -Database Image Copy 2 Utility or Database Recovery Utility in conjunction -with FlashCopy or Fast Replication.

                2. -

              2. zos_mvs_raw module execution fails when invoking DFSRRC00 with parm -“UPB,PRECOMP”, “UPB, POSTCOMP” or “UPB,PRECOMP,POSTCOMP”. This issue is -addressed by APAR PH28089.

                3. -
              -
              • -
            -
            • -
          +

          Requirements

          +

          The IBM z/OS core collection has several dependencies, please review the z/OS core support matrix to understand both the +controller and z/OS managed node dependencies.

          diff --git a/ibm_zos_core/docs/source/requirements_managed.html b/ibm_zos_core/docs/source/requirements_managed.html index a8369dc1..3dfb8f59 100644 --- a/ibm_zos_core/docs/source/requirements_managed.html +++ b/ibm_zos_core/docs/source/requirements_managed.html @@ -86,8 +86,9 @@
        • Control node
        • Managed node
          • @@ -203,6 +204,7 @@

          Modulesims_command – Submit IMS Commands

        • ims_dbd_gen – Generate IMS DBD
        • ims_dbrc – Submit IMS DBRC Commands
          • +
        • ims_ddl – Submits Data Definition Language (DDL) SQL statements.
        • ims_psb_gen – Generate IMS PSB
        diff --git a/ibm_zos_ims/docs/source/modules/ims_acb_gen.html b/ibm_zos_ims/docs/source/modules/ims_acb_gen.html index 7f641fc9..2f0328d6 100644 --- a/ibm_zos_ims/docs/source/modules/ims_acb_gen.html +++ b/ibm_zos_ims/docs/source/modules/ims_acb_gen.html @@ -105,6 +105,7 @@
      • ims_command – Submit IMS Commands
      • ims_dbd_gen – Generate IMS DBD
      • ims_dbrc – Submit IMS DBRC Commands
        • +
      • ims_ddl – Submits Data Definition Language (DDL) SQL statements.
      • ims_psb_gen – Generate IMS PSB

      @@ -231,11 +232,12 @@

      Parameters

    compression

    PRECOMP,POSTCOMP, in any combination, cause the required in-place compression.

    +

    The choices are not mutually exclusive – PRECOMP or POSTCOMP or PRECOMP,POSTCOMP can be used

    The default is none.

    required: False
    type: str
    -
    choices: precomp, postcomp, precomp,postcomp, PRECOMP, POSTCOMP, PRECOMP,POSTCOMP
    +
    choices: PRECOMP, POSTCOMP
    psb_name

    The name of the PS**s**. Specifies that blocks are built or deleted for all PSBs that are named on this control statement.

    diff --git a/ibm_zos_ims/docs/source/modules/ims_catalog_populate.html b/ibm_zos_ims/docs/source/modules/ims_catalog_populate.html index 4352cec9..15f60a41 100644 --- a/ibm_zos_ims/docs/source/modules/ims_catalog_populate.html +++ b/ibm_zos_ims/docs/source/modules/ims_catalog_populate.html @@ -105,6 +105,7 @@
  • ims_command – Submit IMS Commands
  • ims_dbd_gen – Generate IMS DBD
  • ims_dbrc – Submit IMS DBRC Commands
    • +
  • ims_ddl – Submits Data Definition Language (DDL) SQL statements.
  • ims_psb_gen – Generate IMS PSB
    • @@ -270,6 +271,12 @@

    Parameterstype: str

    +
    dfsdf_member

    The DFSDFxxx member in the IMS.PROCLIB data set where the CATALOG section is defined. For example, dfsdf_member is “CAT” specifies the DFSDFCAT member of the PROCLIB data set.

    +
    +
    required: False
    +
    type: str
    +
    +
    primary_log_dataset

    Defines the primary IMS log data set. This is required if dbrc is set to true or if mode ‘UPDATE’ is selected.

    required: False
    @@ -1043,6 +1050,7 @@

    Examplespsb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG @@ -1062,6 +1070,7 @@

    Examplespsb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" control_statements: managed_acbs: setup: true @@ -1082,6 +1091,7 @@

    Examplespsb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG control_statements: diff --git a/ibm_zos_ims/docs/source/modules/ims_catalog_purge.html b/ibm_zos_ims/docs/source/modules/ims_catalog_purge.html index a25a0e34..418dbfe7 100644 --- a/ibm_zos_ims/docs/source/modules/ims_catalog_purge.html +++ b/ibm_zos_ims/docs/source/modules/ims_catalog_purge.html @@ -105,6 +105,7 @@
  • ims_command – Submit IMS Commands
  • ims_dbd_gen – Generate IMS DBD
  • ims_dbrc – Submit IMS DBRC Commands
    • +
  • ims_ddl – Submits Data Definition Language (DDL) SQL statements.
  • ims_psb_gen – Generate IMS PSB
    • @@ -264,6 +265,12 @@

    Parameterstype: str

    +
    dfsdf_member

    The DFSDFxxx member in the IMS.PROCLIB data set where the CATALOG section is defined. For example, dfsdf_member is “CAT” specifies the DFSDFCAT member of the PROCLIB data set.

    +
    +
    required: False
    +
    type: str
    +
    +
    primary_log_dataset

    Defines the primary IMS log data set. This option is required if you are running the utility as a DLI.

    required: True
    @@ -614,6 +621,7 @@

    Examplespsb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS1.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG1 mode: PURGE @@ -635,6 +643,7 @@

    Examplespsb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS1.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG1 mode: PURGE @@ -657,6 +666,7 @@

    Examplespsb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS1.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG1 mode: ANALYSIS @@ -676,6 +686,7 @@

    Examplespsb_lib: - SOME.IMS.PSBLIB buffer_pool_param_dataset: "SOME.IMS1.PROCLIB(DFSVSMHP)" + dfsdf_member: "CAT" primary_log_dataset: dataset_name: SOME.IMS.LOG1 mode: ANALYSIS diff --git a/ibm_zos_ims/docs/source/modules/ims_command.html b/ibm_zos_ims/docs/source/modules/ims_command.html index 8ed0da4b..048e99ce 100644 --- a/ibm_zos_ims/docs/source/modules/ims_command.html +++ b/ibm_zos_ims/docs/source/modules/ims_command.html @@ -105,6 +105,7 @@
  • ims_dbd_gen – Generate IMS DBD
  • ims_dbrc – Submit IMS DBRC Commands
    • +
  • ims_ddl – Submits Data Definition Language (DDL) SQL statements.
  • ims_psb_gen – Generate IMS PSB
    • diff --git a/ibm_zos_ims/docs/source/modules/ims_dbd_gen.html b/ibm_zos_ims/docs/source/modules/ims_dbd_gen.html index 07498442..d8579b23 100644 --- a/ibm_zos_ims/docs/source/modules/ims_dbd_gen.html +++ b/ibm_zos_ims/docs/source/modules/ims_dbd_gen.html @@ -105,6 +105,7 @@
  • ims_dbrc – Submit IMS DBRC Commands
    • +
  • ims_ddl – Submits Data Definition Language (DDL) SQL statements.
  • ims_psb_gen – Generate IMS PSB
    • @@ -251,7 +252,7 @@

    ParametersElements are of the list are str or dict with single key-value pair

    required: False
    -
    type: list
    +
    type: raw

    dbd_name

    Target name of the generated DBD member.

    @@ -299,7 +300,7 @@

    ParametersElements are of the list are str or dict with single key-value pair

    required: False
    -
    type: list
    +
    type: raw

    dbd_name

    Target name of the generated DBD member.

    diff --git a/ibm_zos_ims/docs/source/modules/ims_dbrc.html b/ibm_zos_ims/docs/source/modules/ims_dbrc.html index 258e084b..aee991cc 100644 --- a/ibm_zos_ims/docs/source/modules/ims_dbrc.html +++ b/ibm_zos_ims/docs/source/modules/ims_dbrc.html @@ -35,7 +35,7 @@ - + @@ -105,6 +105,7 @@
  • Return Values
    • +
  • ims_ddl – Submits Data Definition Language (DDL) SQL statements.
  • ims_psb_gen – Generate IMS PSB
    • diff --git a/ibm_zos_ims/docs/source/modules/ims_ddl.html b/ibm_zos_ims/docs/source/modules/ims_ddl.html new file mode 100644 index 00000000..3c948cc1 --- /dev/null +++ b/ibm_zos_ims/docs/source/modules/ims_ddl.html @@ -0,0 +1,447 @@ + + + + + + + + + + + ims_ddl – Submits Data Definition Language (DDL) SQL statements. — Red Hat Ansible Certified Content for IBM Z documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + +
    + + + + + +
    + +
    + + + + + + + + + + + + + + + + + + + +
    + +
      + +
    • Docs »
      • + +
    • z/OS IMS »
      • + +
    • Modules »
      • + +
    • ims_ddl – Submits Data Definition Language (DDL) SQL statements.
      • + + + +
    + + +
    +
    +
    +
    + +
    +

    ims_ddl – Submits Data Definition Language (DDL) SQL statements.

    + +
    +

    Synopsis

    +
      +

    • The IMS Data Definition utility (DFS3ID00) utility writes the metadata for your application programs (PSBs) and databases definitions to the IMS Catalog records and the runtime blocks to the staging directory dataset.

      • +
    +
    +
    +

    Parameters

    +
    +
    online

    Indicates if this utility is to be run in a BMP region.

    +

    If online is true, its BMP enabled.

    +

    online is false is DLI that is not supported currently.

    +
    +
    required: False
    +
    type: bool
    +
    default: True
    +
    +
    +
    ims_id

    The identifier of the IMS system on which the job is to be run.

    +

    Required if online is true.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    reslib

    Points to an authorized library that contains the IMS SVC modules.

    +
    +
    required: False
    +
    type: list
    +
    elements: str
    +
    +
    +
    proclib

    Defines the IMS.PROCLIB data set that contains the DFSDFxxx member. The DFSDFxxx member defines various attributes of the IMS catalog that are required by the utility.

    +
    +
    required: True
    +
    type: list
    +
    elements: str
    +
    +
    +
    steplib

    Points to IMS.SDFSRESL, which contains the IMS nucleus and required IMS modules.

    +

    The steplib parameter can also be specified in the target inventory’s environment_vars.

    +

    The steplib input parameter to the module will take precedence over the value specified in the environment_vars.

    +
    +
    required: False
    +
    type: list
    +
    elements: str
    +
    +
    +
    sql_input

    Defines the SQL DDL statements to be run.

    +

    Can specify the DDL statements in a dataset or dataset member.

    +

    The following concatenations are not supported - Cannot mix FB and VB data sets. - Cannot have concatenated FB data sets with different LRECLs.

    +
    +
    required: True
    +
    type: str
    +
    +
    +
    verbose

    Specifies that the DFS3ID00 utility will print full text of the DDL statements in the job log.

    +

    If VERBOSE control option is not specified, then utility will only print full text of failing DDL statement.

    +
    +
    required: False
    +
    type: bool
    +
    +
    +
    auto_commit

    Specifies that the DFS3ID00 utility will perform auto Commit if no COMMIT DDL statement is provided by the user.

    +

    If user does not specify AUTOCOMMIT control option or COMMIT DDL statement, then utility will perform auto ROLLBACK DDL.

    +
    +
    required: False
    +
    type: bool
    +
    +
    +
    simulate

    Specifies that the DFS3ID00 utility will perform simulation of DDL statements which includes parser validations, commit level validations, block builder validations, and DROP DDL cross-reference validations.

    +
    +
    required: False
    +
    type: bool
    +
    +
    +
    dynamic_programview

    Directly maps to DYNAMICPROGRAMVIEW=(CREATEYES | CREATENO) of IMS Data Definition utility utility.

    +

    Specifies that the DFS3ID00 utility will automatically import all the input CREATE PROGRAMVIEWs.

    +

    If CREATEYES is specified, then PDIR will be created with the DOPT flag ON.

    +

    If CREATENO is specified, then PDIR will not be created.

    +
    +
    required: False
    +
    type: bool
    +
    +
    +
    +
    +
    +

    Examples

    +
    - name: Example of DDL statements are in a dataset
+  ims_data_definition:
+    online: True
+    ims_id: IMS1
+    reslib:
+      - SOME.IMS.SDFSRESL
+    steplib:
+      - SOME.IMS.SDFSRESL
+    proclib:
+      - SOME.IMS.PROCLIB
+    sql_input: SOME.IMS.SQL
+- name: Example of DDL statements in which VERBOSE and AUTOCOMMIT control options are specified
+  ims_data_definition:
+    online: True
+    ims_id: IMS1
+    reslib:
+      - SOME.IMS.SDFSRESL
+    steplib:
+      - SOME.IMS.SDFSRESL
+    proclib:
+      - SOME.IMS.PROCLIB
+    sql_input: SOME.IMS.SQL
+    verbose: true
+    auto_commit: true
+
+- name: Example of DDL statements in which SIMULATE control options is specified
+  ims_data_definition:
+    online: True
+    ims_id: IMS1
+    reslib:
+      - SOME.IMS.SDFSRESL
+    steplib:
+      - SOME.IMS.SDFSRESL
+    proclib:
+      - SOME.IMS.PROCLIB
+    sql_input: SOME.IMS.SQL
+    simulate: true
+
+- name: Example of DDL statements in which DYNAMIC_PROGRAMVIEW control option is specified
+  ims_data_definition:
+    online: True
+    ims_id: IMS1
+    reslib:
+      - SOME.IMS.SDFSRESL
+    steplib:
+      - SOME.IMS.SDFSRESL
+    proclib:
+      - SOME.IMS.PROCLIB
+    sql_input: SOME.IMS.SQL
+    dynamic_programview: true
+
    +
    +
    +
    +

    Notes

    +
    +

    Note

    +

    The steplib parameter can also be specified in the target inventory’s environment_vars.

    +

    The steplib input parameter to the module will take precedence over the value specified in the environment_vars.

    +

    If only the steplib parameter is specified, then only the steplib concatenation will be used to resolve the IMS RESLIB data set.

    +

    Specifying only reslib without steplib is not supported.

    +

    Currently ddl error messages are returned within the content block of the module response.

    +

    Currently this module only supports running the DDL utility in a BMP region (online is true).

    +
    +
    +
    +

    Return Values

    +
    +
    content

    The standard output returned running the Data Definition module.

    +
    +
    returned: sometimes
    +
    type: str
    +
    sample: entire block
    +
    +
    +
    rc

    The return code from the Data Definition utility.

    +
    +
    returned: sometimes
    +
    type: str
    +
    sample: 1
    +
    +
    +
    changed

    Indicates if any changes were made during module execution.

    +

    True is always returned unless a module or failure has occurred.

    +
    +
    returned: always
    +
    type: bool
    +
    +
    +
    stderr

    The standard error output returned from running the Data Definition utility.

    +
    +
    returned: sometimes
    +
    type: str
    +
    +
    +
    msg

    Messages returned from the Data Definition Ansible module.

    +
    +
    returned: sometimes
    +
    type: str
    +
    +
    +
    +
    +
    + + +
    + +
    +
    + + +
    + +
    +

    + © Copyright IBM Corp. 2020, 2023 + +

    +
    + +
    + +
    +
    + +
    + +
    + + + + + + + + + + + + \ No newline at end of file diff --git a/ibm_zos_ims/docs/source/modules/ims_psb_gen.html b/ibm_zos_ims/docs/source/modules/ims_psb_gen.html index 21572b3e..0e758e90 100644 --- a/ibm_zos_ims/docs/source/modules/ims_psb_gen.html +++ b/ibm_zos_ims/docs/source/modules/ims_psb_gen.html @@ -36,7 +36,7 @@ - + @@ -98,6 +98,7 @@
  • ims_command – Submit IMS Commands
  • ims_dbd_gen – Generate IMS DBD
  • ims_dbrc – Submit IMS DBRC Commands
    • +
  • ims_ddl – Submits Data Definition Language (DDL) SQL statements.
  • ims_psb_gen – Generate IMS PSB
    • psb_name

    Target name of the generated PSB member.

    @@ -296,7 +297,7 @@

    ParametersElements are of the list are str or dict with single key-value

    required: False
    -
    type: list
    +
    type: raw

    psb_name

    Target name of the generated PSB member.

    diff --git a/ibm_zos_ims/docs/source/release_notes.html b/ibm_zos_ims/docs/source/release_notes.html index 842f9671..a73f2f33 100644 --- a/ibm_zos_ims/docs/source/release_notes.html +++ b/ibm_zos_ims/docs/source/release_notes.html @@ -101,42 +101,48 @@
  • z/OS core
  • z/OS CICS
  • z/OS IMS
    • -
    zmf_credential

    Authentication credentials, returned by module zmf_authenticate, for successful authentication with the z/OSMF server.

    +
    zmf_credential

    Authentication credentials, returned by module zmf_authenticate, for successful authentication with the z/OSMF server.

    If zmf_credential is supplied, zmf_host, zmf_port, zmf_user, zmf_password, zmf_crt and zmf_key are ignored.

    required: False
    diff --git a/ibm_zosmf/docs/source/modules/zmf_workflow.html b/ibm_zosmf/docs/source/modules/zmf_workflow.html index 24302425..c620adec 100644 --- a/ibm_zosmf/docs/source/modules/zmf_workflow.html +++ b/ibm_zosmf/docs/source/modules/zmf_workflow.html @@ -217,7 +217,7 @@

    Synopsis

    Parameters

    -
    zmf_credential

    Authentication credentials, returned by module zmf_authenticate, for successful authentication with the z/OSMF server.

    +
    zmf_credential

    Authentication credentials, returned by module zmf_authenticate, for successful authentication with the z/OSMF server.

    If zmf_credential is supplied, zmf_host, zmf_port, zmf_user, zmf_password, zmf_crt and zmf_key are ignored.

    required: False
    diff --git a/ibm_zosmf/docs/source/release_notes.html b/ibm_zosmf/docs/source/release_notes.html index c7f2fb2c..488cae77 100644 --- a/ibm_zosmf/docs/source/release_notes.html +++ b/ibm_zosmf/docs/source/release_notes.html @@ -103,39 +103,54 @@
  • z/OS IMS
  • z/OS Sys Auto
  • z/OS z/OSMF diff --git a/ibm_zosmf/docs/source/roles/zmf_cpm_provision_software_service.html b/ibm_zosmf/docs/source/roles/zmf_cpm_provision_software_service.html index 70a3c9da..b83e0acf 100644 --- a/ibm_zosmf/docs/source/roles/zmf_cpm_provision_software_service.html +++ b/ibm_zosmf/docs/source/roles/zmf_cpm_provision_software_service.html @@ -107,9 +107,11 @@
  • zmf_cpm_remove_software_instance – Role removes a z/OS software instance
    • +
  • zmf_swmgmt_csi_query – Query a SMP/E CSI data set
  • zmf_swmgmt_identify_missing_critical_updates – Identify Missing Critical Software Updates for a Software Instance
  • zmf_swmgmt_identify_missing_fixcat_updates – Identify Missing Fixcat Software Updates for a Software Instance
  • zmf_swmgmt_search_software_updates – Search a Software Instance for Software Updates
    • +
  • zmf_swmgmt_zos_system_uuid – Retrieve the z/OS system UUID
  • zmf_workflow_complete – Role completes a z/OS workflow
  • zmf_zmsc_run_management_service – Role runs a z/OS management service
    • diff --git a/ibm_zosmf/docs/source/roles/zmf_cpm_remove_software_instance.html b/ibm_zosmf/docs/source/roles/zmf_cpm_remove_software_instance.html index ae581649..e13fa7c5 100644 --- a/ibm_zosmf/docs/source/roles/zmf_cpm_remove_software_instance.html +++ b/ibm_zosmf/docs/source/roles/zmf_cpm_remove_software_instance.html @@ -35,7 +35,7 @@ - + @@ -107,9 +107,11 @@
  • Notes
    • +
  • zmf_swmgmt_csi_query – Query a SMP/E CSI data set
  • zmf_swmgmt_identify_missing_critical_updates – Identify Missing Critical Software Updates for a Software Instance
  • zmf_swmgmt_identify_missing_fixcat_updates – Identify Missing Fixcat Software Updates for a Software Instance
  • zmf_swmgmt_search_software_updates – Search a Software Instance for Software Updates
    • +
  • zmf_swmgmt_zos_system_uuid – Retrieve the z/OS system UUID
  • zmf_workflow_complete – Role completes a z/OS workflow
  • zmf_zmsc_run_management_service – Role runs a z/OS management service
    • diff --git a/ibm_zosmf/docs/source/roles/zmf_swmgmt_csi_query.html b/ibm_zosmf/docs/source/roles/zmf_swmgmt_csi_query.html new file mode 100644 index 00000000..5a7b7f01 --- /dev/null +++ b/ibm_zosmf/docs/source/roles/zmf_swmgmt_csi_query.html @@ -0,0 +1,424 @@ + + + + + + + + + + + zmf_swmgmt_csi_query – Query a SMP/E CSI data set — Red Hat Ansible Certified Content for IBM Z documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + +
    + + + + + +
    + +
    + + + + + + + + + + + + + + + + + + + +
    + +
      + +
    • Docs »
      • + +
    • IBM z/OSMF »
      • + +
    • Roles »
      • + +
    • zmf_swmgmt_csi_query – Query a SMP/E CSI data set
      • + + + +
    + + +
    +
    +
    +
    + +
    +

    zmf_swmgmt_csi_query – Query a SMP/E CSI data set

    + +
    +

    Synopsis

    +
      +

    • The IBM z/OSMF collection provides an Ansible role, referred to as zmf_swmgmt_csi_query, to query a SMP/E global zone CSI data set directly or to query the CSI associated with a software instance.

      • +
    +
    +
    +

    Variables

    +
    +
    zmf_host

    Hostname of the z/OSMF server, specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: True
    +
    type: str
    +
    +
    +
    zmf_port

    Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify a value for this parameter in the inventory file or as an argument on the playbook command.

    +
    +
    required: False
    +
    type: str
    +
    default: 443
    +
    +
    +
    zmf_user

    User ID for authenticating with the z/OSMF server.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: True
    +
    type: str
    +
    +
    +
    zmf_password

    Password to be used for authenticating with z/OSMF server.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: True
    +
    type: str
    +
    +
    +
    software_instance_name

    Name of the software instance.

    +

    A software instance name must be specified when a software instance UUID or a CSI data set name are not specified. If a software instance UUID is specified in addition to a software instance and system nickname, then the software instance UUID is used by default.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    system_nickname

    Nickname of the z/OSMF host system that has access to the volumes and data sets where the software instance resides.

    +

    A system nickname name must be specified when a software instance UUID or a CSI data set name are not specified. If a software instance UUID is specified in addition to a software instance and system nickname, then the software instance UUID is used by default.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    software_instance_uuid

    A UUID of a software instance. A UUID is assigned to every software instance and can be obtained using the “List the software instances defined to z/OSMF” REST API.

    +

    A UUID can also be obtained using the zmf_swmgmt_zos_system_uuid Ansible role which retrieves the UUID for the software instance that represents the installed software for the specified z/OSMF host system.

    +

    A software instance UUID name must be specified when a software instance or a CSI data set name are not specified. If a software instance or a CSI data set name are specified, then the software instance UUID is used by default.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    csi_data_set_name

    A global zone CSI data set to query when it is not associated with a defined software instance object.

    +

    A CSI data set name must be specified when a software instance or a software instance UUID are not specified. If a software instance UUID is specified in addition to a CSI data set name, then the software instance UUID is used by default.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    zones

    The list of zones to be queried. You may provide one or more specific zone names, or any of these values:

    +

    GLOBAL (To query the global zone)

    +

    ALLTZONES (To query all target zones)

    +

    ALLDZONES (To query all DLIB zones)

    +

    * (To query the global zone and all zones defined in the global zone’s ZONEINDEX)

    +

    Zone names are accepted in mixed case and are folded to uppercase automatically. This list variable needs to be in following format: '"GLOBAL","ALLTZONES","ALLDZONES"'

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: True
    +
    type: arr
    +
    +
    +
    entries

    The list of entry types to be queried. You may provide one or more entry types, or asterisk (‘*’) can be used to indicate all entry types will be queried. Entry types are accepted in mixed case and are folded to uppercase automatically.

    +

    Refer to https://www.ibm.com/docs/en/zos/3.1.0?topic=command-valid-entry-types for the list of valid types.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: True
    +
    type: arr
    +
    +
    +
    subentries

    The list of subentry types to be returned. You may provide one or more subentry types, or asterisk (‘*’) can be used to indicate all subentry types will be returned. Subentry types are accepted in mixed case and are folded to uppercase automatically. If no subentries are provided, then only the entry name and zone will be returned for matching entries.

    +

    Refer to https://www.ibm.com/docs/en/zos/3.1.0?topic=command-valid-subentry-types for the list of valid types.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: False
    +
    type: arr
    +
    +
    +
    filter

    The list of conditions with which to limit the entries to be returned. A condition is in the form: subentry operator ‘value’ For example, FMID = ‘HP10230’ or INSTALLDATE >= ‘23203’. The subentry type of a filter condition is accepted in mixed case and is folded to uppercase automatically. The value of a filter condition is case sensitive and is not folded to uppercase. If a filter is not provided then all entries of the specified type in the specified zones will be returned.

    +

    Refer to https://www.ibm.com/docs/en/zos/3.1.0?topic=command-filter-parameter-syntax for a detailed description of the syntax for the filter.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    csi_query_response_file

    The path to the file that will contain the results from the csi query operation.

    +

    The directory must already exist otherwise there will be an error writing the results to the file. If the file exists in the directory already, it will be overwritten by the new response when the playbook is executed. If the file doesn’t exist in the directory, it will be created.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: True
    +
    type: str
    +
    +
    +
    remote_zmf_user

    User ID for authenticating with a remote z/OSMF server. Used only if the csi data set resides on a remote z/OSMF server.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    remote_zmf_password

    Password for authenticating with a remote z/OSMF server.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    proxy_zmf_user

    User ID for authenticating with an HTTP proxy server.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    proxy_zmf_password

    Password for authenticating with an HTTP proxy server.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    +
    +
    +

    Examples

    +
    - name: sample of querying a CSI data set
+  hosts: sampleHost
+  gather_facts: no
+  collections:
+    - ibm.ibm_zosmf
+
+  tasks:
+    - include_role :
+        name: zmf_swmgmt_csi_query
+
    +
    +
    +
    +

    Notes

    +
    +

    Note

    +
      +

    • The given example assumes you have an inventory file inventory.yml that contains the values for the variables described above, such as z/OSMF host server, userid, password, software instance name and system, and response file name.

      • +

    • Command syntax to call a playbook using an inventory file: ansible-playbook -i inventory software_management_csi_query_CICDtest1.yml

      • +

    • Command syntax to call a playbook using command arguments: ansible-playbook software_management_csi_query_CICDtest1.yml -e zmf_user=zosmf** -e zmf_password=zosmf**

      • +

    • When the role is executed, a message shown in following example is displayed, "msg": "Output filename= /tmp/xxx/csi_query_response.json". This message includes a file path and file name where the csi query information for the requested software instance is returned.

      • +
    +
    +
    +
    + + +
    + +
    +
    + + +
    + +
    +

    + © Copyright IBM Corp. 2020, 2023 + +

    +
    + +
    + +
    +
    + +
    + +
    + + + + + + + + + + + + \ No newline at end of file diff --git a/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates.html b/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates.html index 28f37e0c..6e85635f 100644 --- a/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates.html +++ b/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates.html @@ -36,7 +36,7 @@ - + @@ -101,6 +101,7 @@
  • zmf_cpm_manage_software_instance – Role manages a provisioned z/OS software instance
  • zmf_cpm_provision_software_service – Role provisions a z/OS software service
  • zmf_cpm_remove_software_instance – Role removes a z/OS software instance
    • +
  • zmf_swmgmt_csi_query – Query a SMP/E CSI data set
  • zmf_swmgmt_identify_missing_critical_updates – Identify Missing Critical Software Updates for a Software Instance @@ -228,14 +230,14 @@

    Variablestype: str

    • -
    zmf_port

    Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify value for this parameter in the inventory file or as an argument on the playbook command.

    +
    zmf_port

    Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify a value for this parameter in the inventory file or as an argument on the playbook command.

    required: False
    type: str
    default: 443
    -
    zmf_user

    User name to be used for authenticating with the z/OSMF server.

    +
    zmf_user

    User ID for authenticating with the z/OSMF server.

    This variable can be specified in the inventory file or as an argument on the playbook command.

    required: True
    @@ -250,16 +252,27 @@

    Variables -
    required: True
    +
    required: False
    type: str

    system_nickname

    Nickname of the z/OSMF host system that has access to the volumes and data sets where the software instance resides.

    +

    A system nickname must be specified when a software instance UUID is not specified. If a software instance UUID is specified in addition to a software instance and system nickname, then the software instance UUID is used by default.

    This variable can be specified in the inventory file or as an argument on the playbook command.

    -
    required: True
    +
    required: False
    +
    type: str
    +
    +
    +
    software_instance_uuid

    A UUID of a software instance. A UUID is assigned to every software instance and can be obtained using the “List the software instances defined to z/OSMF” REST API.

    +

    A UUID can also be obtained using the zmf_swmgmt_zos_system_uuid Ansible role which retrieves the UUID for the software instance that represents the installed software for the specified z/OSMF host system.

    +

    A software instance UUID must be specified when a software instance name is not specified. If both a software instance UUID and name are specified, then the software instance UUID is used by default.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: False
    type: str
    @@ -317,7 +330,10 @@

    NotesNote

     diff --git a/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates.html b/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates.html index 3751adde..413ef104 100644 --- a/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates.html +++ b/ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates.html @@ -101,6 +101,7 @@
  • zmf_cpm_manage_software_instance – Role manages a provisioned z/OS software instance
  • zmf_cpm_provision_software_service – Role provisions a z/OS software service
  • zmf_cpm_remove_software_instance – Role removes a z/OS software instance
    • +
  • zmf_swmgmt_csi_query – Query a SMP/E CSI data set
  • zmf_swmgmt_identify_missing_critical_updates – Identify Missing Critical Software Updates for a Software Instance
  • zmf_swmgmt_identify_missing_fixcat_updates – Identify Missing Fixcat Software Updates for a Software Instance
  • zmf_swmgmt_search_software_updates – Search a Software Instance for Software Updates
    • +
  • zmf_swmgmt_zos_system_uuid – Retrieve the z/OS system UUID
  • zmf_workflow_complete – Role completes a z/OS workflow
  • zmf_zmsc_run_management_service – Role runs a z/OS management service
    • @@ -228,14 +230,14 @@

    Variablestype: str -
    zmf_port

    Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify value for this parameter in the inventory file or as an argument on the playbook command.

    +
    zmf_port

    Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify a value for this parameter in the inventory file or as an argument on the playbook command.

    required: False
    type: str
    default: 443
    -
    zmf_user

    User name to be used for authenticating with the z/OSMF server.

    +
    zmf_user

    User ID for authenticating with the z/OSMF server.

    This variable can be specified in the inventory file or as an argument on the playbook command.

    required: True
    @@ -250,16 +252,27 @@

    Variables -
    required: True
    +
    required: False
    type: str

    system_nickname

    Nickname of the z/OSMF host system that has access to the volumes and data sets where the software instance resides.

    +

    A system nickname must be specified when a software instance UUID is not specified. If a software instance UUID is specified in addition to a software instance and system nickname, then the software instance UUID is used by default.

    This variable can be specified in the inventory file or as an argument on the playbook command.

    -
    required: True
    +
    required: False
    +
    type: str
    +
    +
    +
    software_instance_uuid

    A UUID of a software instance. A UUID is assigned to every software instance and can be obtained using the “List the software instances defined to z/OSMF” REST API.

    +

    A UUID can also be obtained using the zmf_swmgmt_zos_system_uuid Ansible role which retrieves the UUID for the software instance that represents the installed software for the specified z/OSMF host system.

    +

    A software instance UUID must be specified when a software instance name is not specified. If both a software instance UUID and name are specified, then the software instance UUID is used by default.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: False
    type: str
    @@ -317,7 +330,10 @@

    NotesNote

     diff --git a/ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates.html b/ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates.html index 54ea71e6..ed42c0fc 100644 --- a/ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates.html +++ b/ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates.html @@ -35,7 +35,7 @@ - + @@ -101,6 +101,7 @@
  • zmf_cpm_manage_software_instance – Role manages a provisioned z/OS software instance
  • zmf_cpm_provision_software_service – Role provisions a z/OS software service
  • zmf_cpm_remove_software_instance – Role removes a z/OS software instance
    • +
  • zmf_swmgmt_csi_query – Query a SMP/E CSI data set
  • zmf_swmgmt_identify_missing_critical_updates – Identify Missing Critical Software Updates for a Software Instance
  • zmf_swmgmt_identify_missing_fixcat_updates – Identify Missing Fixcat Software Updates for a Software Instance
  • zmf_swmgmt_search_software_updates – Search a Software Instance for Software Updates
      @@ -110,6 +111,7 @@
    • Notes
    • +
  • zmf_swmgmt_zos_system_uuid – Retrieve the z/OS system UUID
  • zmf_workflow_complete – Role completes a z/OS workflow
  • zmf_zmsc_run_management_service – Role runs a z/OS management service
    • @@ -228,14 +230,14 @@

    Variablestype: str -
    zmf_port

    Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify value for this parameter in the inventory file or as an argument on the playbook command.

    +
    zmf_port

    Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify a value for this parameter in the inventory file or as an argument on the playbook command.

    required: False
    type: str
    default: 443
    -
    zmf_user

    User name to be used for authenticating with the z/OSMF server.

    +
    zmf_user

    User ID for authenticating with the z/OSMF server.

    This variable can be specified in the inventory file or as an argument on the playbook command.

    required: True
    @@ -250,16 +252,27 @@

    Variables -
    required: True
    +
    required: False
    type: str

    system_nickname

    Nickname of the z/OSMF host system that has access to the volumes and data sets where the software instance resides.

    +

    A system nickname must be specified when a software instance UUID is not specified. If a software instance UUID is specified in addition to a software instance and system nickname, then the software instance UUID is used by default.

    This variable can be specified in the inventory file or as an argument on the playbook command.

    -
    required: True
    +
    required: False
    +
    type: str
    +
    +
    +
    software_instance_uuid

    A UUID of a software instance. A UUID is assigned to every software instance and can be obtained using the “List the software instances defined to z/OSMF” REST API.

    +

    A UUID can also be obtained using the zmf_swmgmt_zos_system_uuid Ansible role which retrieves the UUID for the software instance that represents the installed software for the specified z/OSMF host system.

    +

    A software instance UUID must be specified when a software instance name is not specified. If both a software instance UUID and name are specified, then the software instance UUID is used by default.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: False
    type: str
    @@ -324,7 +337,10 @@

    NotesNote

     diff --git a/ibm_zosmf/docs/source/roles/zmf_swmgmt_zos_system_uuid.html b/ibm_zosmf/docs/source/roles/zmf_swmgmt_zos_system_uuid.html new file mode 100644 index 00000000..9a6a2526 --- /dev/null +++ b/ibm_zosmf/docs/source/roles/zmf_swmgmt_zos_system_uuid.html @@ -0,0 +1,355 @@ + + + + + + + + + + + zmf_swmgmt_zos_system_uuid – Retrieve the z/OS system UUID — Red Hat Ansible Certified Content for IBM Z documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + +
    + + + + + +
    + +
    + + + + + + + + + + + + + + + + + + + +
    + +
      + +
    • Docs »
      • + +
    • IBM z/OSMF »
      • + +
    • Roles »
      • + +
    • zmf_swmgmt_zos_system_uuid – Retrieve the z/OS system UUID
      • + + + +
    + + +
    +
    +
    +
    + +
    +

    zmf_swmgmt_zos_system_uuid – Retrieve the z/OS system UUID

    + +
    +

    Synopsis

    +
      +

    • The IBM z/OSMF collection provides an Ansible role, referred to as zmf_swmgmt_zos_system_uuid, to retrieve the z/OS system UUID for the specified system nickname. The UUID identifies the software instance object that corresponds to the installed software for the specified z/OSMF host system. The UUID can be used to uniquely identify a software instance object to be acted upon by other Ansible roles.

      • +
    +
    +
    +

    Variables

    +
    +
    zmf_host

    Hostname of the z/OSMF server, specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: True
    +
    type: str
    +
    +
    +
    zmf_port

    Port number of the z/OSMF server. If z/OSMF is not using the default port, you need to specify a value for this parameter in the inventory file or as an argument on the playbook command.

    +
    +
    required: False
    +
    type: str
    +
    default: 443
    +
    +
    +
    zmf_user

    User ID for authenticating with the z/OSMF server.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: True
    +
    type: str
    +
    +
    +
    zmf_password

    Password to be used for authenticating with z/OSMF server.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: True
    +
    type: str
    +
    +
    +
    system_nickname

    Nickname of the z/OSMF host system.

    +

    This variable can be specified in the inventory file or as an argument on the playbook command.

    +
    +
    required: True
    +
    type: str
    +
    +
    +
    remote_zmf_user

    User ID for authenticating with a remote z/OSMF server. Used only to retrieve the UUID of a remote z/OSMF server.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    remote_zmf_password

    Password for authenticating with a remote z/OSMF server.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    proxy_zmf_user

    User ID for authenticating with an HTTP proxy server.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    proxy_zmf_password

    Password for authenticating with an HTTP proxy server.

    +
    +
    required: False
    +
    type: str
    +
    +
    +
    +
    +
    +

    Examples

    +
    - name: sample of retrieving the z/OS system UUID
+  hosts: sampleHost
+  gather_facts: no
+  collections:
+    - ibm.ibm_zosmf
+
+  tasks:
+    - include_role :
+        name: zmf_swmgmt_zos_system_uuid
+
    +
    +
    +
    +

    Notes

    +
    +

    Note

    +
      +

    • The given example assumes you have an inventory file inventory.yml that contains the values for the variables described above, such as z/OSMF host server, userid, password, system, and response file name.

      • +

    • Command syntax to call a playbook using an inventory file: ansible-playbook -i inventory software_management_system_uuid_CICDtest1.yml

      • +

    • Command syntax to call a playbook using command arguments: ansible-playbook software_management_system_uuid_CICDtest1.yml -e zmf_user=zosmf** -e zmf_password=zosmf**

      • +

    • When the role is executed, a message shown in following example is displayed, "msg": "Output filename= /tmp/xxx/zos_system_uuid_response.json". This message includes a file path and file name where the z/OS system UUID is saved.

      • +

    • Refer to https://www.ibm.com/docs/en/zos/3.1.0?topic=services-retrieve-zos-system-uuid for more information on the REST API’s request and response JSON.

      • +
    +
    +
    +
    + + +
    + +
    +
    + + +
    + +
    +

    + © Copyright IBM Corp. 2020, 2023 + +

    +
    + +
    + +
    +
    + +
    + +
    + + + + + + + + + + + + \ No newline at end of file diff --git a/ibm_zosmf/docs/source/roles/zmf_workflow_complete.html b/ibm_zosmf/docs/source/roles/zmf_workflow_complete.html index a7b1ce3c..29c309bb 100644 --- a/ibm_zosmf/docs/source/roles/zmf_workflow_complete.html +++ b/ibm_zosmf/docs/source/roles/zmf_workflow_complete.html @@ -36,7 +36,7 @@ - + @@ -101,9 +101,11 @@
  • zmf_cpm_manage_software_instance – Role manages a provisioned z/OS software instance
  • zmf_cpm_provision_software_service – Role provisions a z/OS software service
  • zmf_cpm_remove_software_instance – Role removes a z/OS software instance
    • +
  • zmf_swmgmt_csi_query – Query a SMP/E CSI data set
  • zmf_swmgmt_identify_missing_critical_updates – Identify Missing Critical Software Updates for a Software Instance
  • zmf_swmgmt_identify_missing_fixcat_updates – Identify Missing Fixcat Software Updates for a Software Instance
  • zmf_swmgmt_search_software_updates – Search a Software Instance for Software Updates
    • +
  • zmf_swmgmt_zos_system_uuid – Retrieve the z/OS system UUID
  • zmf_workflow_complete – Role completes a z/OS workflow
    • Synopsis
    • Dependencies
      • diff --git a/ibm_zosmf/docs/source/roles/zmf_zmsc_run_management_service.html b/ibm_zosmf/docs/source/roles/zmf_zmsc_run_management_service.html index b6677d75..10481285 100644 --- a/ibm_zosmf/docs/source/roles/zmf_zmsc_run_management_service.html +++ b/ibm_zosmf/docs/source/roles/zmf_zmsc_run_management_service.html @@ -101,9 +101,11 @@
    • zmf_cpm_manage_software_instance – Role manages a provisioned z/OS software instance
    • zmf_cpm_provision_software_service – Role provisions a z/OS software service
    • zmf_cpm_remove_software_instance – Role removes a z/OS software instance
      • +
    • zmf_swmgmt_csi_query – Query a SMP/E CSI data set
    • zmf_swmgmt_identify_missing_critical_updates – Identify Missing Critical Software Updates for a Software Instance
    • zmf_swmgmt_identify_missing_fixcat_updates – Identify Missing Fixcat Software Updates for a Software Instance
    • zmf_swmgmt_search_software_updates – Search a Software Instance for Software Updates
      • +
    • zmf_swmgmt_zos_system_uuid – Retrieve the z/OS system UUID
    • zmf_workflow_complete – Role completes a z/OS workflow
    • zmf_zmsc_run_management_service – Role runs a z/OS management service
      • Synopsis
        • diff --git a/objects.inv b/objects.inv index 40ef8eee..f1a6fbf7 100644 Binary files a/objects.inv and b/objects.inv differ diff --git a/searchindex.js b/searchindex.js index f7b8d623..a66dcfe1 100644 --- a/searchindex.js +++ b/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["faqs/faqs","ibm_zos_cics/docs/ansible_content","ibm_zos_cics/docs/source/community_guides","ibm_zos_cics/docs/source/modules","ibm_zos_cics/docs/source/modules/cmci_action","ibm_zos_cics/docs/source/modules/cmci_create","ibm_zos_cics/docs/source/modules/cmci_delete","ibm_zos_cics/docs/source/modules/cmci_get","ibm_zos_cics/docs/source/modules/cmci_update","ibm_zos_cics/docs/source/release_notes","ibm_zos_cics/docs/source/requirements_managed","ibm_zos_core/docs/ansible_content","ibm_zos_core/docs/source/community_guides","ibm_zos_core/docs/source/community_guides_docs/better_arg_parser","ibm_zos_core/docs/source/community_guides_docs/zos_ansible_module_testing","ibm_zos_core/docs/source/filters","ibm_zos_core/docs/source/modules","ibm_zos_core/docs/source/modules/zos_apf","ibm_zos_core/docs/source/modules/zos_archive","ibm_zos_core/docs/source/modules/zos_backup_restore","ibm_zos_core/docs/source/modules/zos_blockinfile","ibm_zos_core/docs/source/modules/zos_copy","ibm_zos_core/docs/source/modules/zos_data_set","ibm_zos_core/docs/source/modules/zos_encode","ibm_zos_core/docs/source/modules/zos_fetch","ibm_zos_core/docs/source/modules/zos_find","ibm_zos_core/docs/source/modules/zos_gather_facts","ibm_zos_core/docs/source/modules/zos_job_output","ibm_zos_core/docs/source/modules/zos_job_query","ibm_zos_core/docs/source/modules/zos_job_submit","ibm_zos_core/docs/source/modules/zos_lineinfile","ibm_zos_core/docs/source/modules/zos_mount","ibm_zos_core/docs/source/modules/zos_mvs_raw","ibm_zos_core/docs/source/modules/zos_operator","ibm_zos_core/docs/source/modules/zos_operator_action_query","ibm_zos_core/docs/source/modules/zos_ping","ibm_zos_core/docs/source/modules/zos_script","ibm_zos_core/docs/source/modules/zos_tso_command","ibm_zos_core/docs/source/modules/zos_unarchive","ibm_zos_core/docs/source/modules/zos_volume_init","ibm_zos_core/docs/source/plugins","ibm_zos_core/docs/source/release_notes","ibm_zos_core/docs/source/requirements_managed","ibm_zos_core/docs/source/resources/character_set","ibm_zos_core/docs/source/resources/resources","ibm_zos_ims/docs/ansible_content","ibm_zos_ims/docs/source/community_guides","ibm_zos_ims/docs/source/community_guides_docs/zos_ansible_module_testing","ibm_zos_ims/docs/source/modules","ibm_zos_ims/docs/source/modules/ims_acb_gen","ibm_zos_ims/docs/source/modules/ims_catalog_populate","ibm_zos_ims/docs/source/modules/ims_catalog_purge","ibm_zos_ims/docs/source/modules/ims_command","ibm_zos_ims/docs/source/modules/ims_dbd_gen","ibm_zos_ims/docs/source/modules/ims_dbrc","ibm_zos_ims/docs/source/modules/ims_psb_gen","ibm_zos_ims/docs/source/release_notes","ibm_zos_ims/docs/source/requirements_managed","ibm_zos_sysauto/docs/ansible_content","ibm_zos_sysauto/docs/source/community_guides","ibm_zos_sysauto/docs/source/release_notes","ibm_zos_sysauto/docs/source/requirements_managed","ibm_zos_sysauto/docs/source/roles","ibm_zos_sysauto/docs/source/roles/sa_create_dynamic_resource","ibm_zos_sysauto/docs/source/roles/sa_delete_dynamic_resource","ibm_zosmf/docs/ansible_content","ibm_zosmf/docs/source/community_guides","ibm_zosmf/docs/source/modules","ibm_zosmf/docs/source/modules/zmf_authenticate","ibm_zosmf/docs/source/modules/zmf_sca","ibm_zosmf/docs/source/modules/zmf_workflow","ibm_zosmf/docs/source/release_notes","ibm_zosmf/docs/source/requirements_control","ibm_zosmf/docs/source/requirements_managed","ibm_zosmf/docs/source/resources","ibm_zosmf/docs/source/roles","ibm_zosmf/docs/source/roles/zmf_cpm_create_software_instance","ibm_zosmf/docs/source/roles/zmf_cpm_get_software_instance","ibm_zosmf/docs/source/roles/zmf_cpm_list_software_templates","ibm_zosmf/docs/source/roles/zmf_cpm_manage_software_instance","ibm_zosmf/docs/source/roles/zmf_cpm_provision_software_service","ibm_zosmf/docs/source/roles/zmf_cpm_remove_software_instance","ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates","ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates","ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates","ibm_zosmf/docs/source/roles/zmf_workflow_complete","ibm_zosmf/docs/source/roles/zmf_zmsc_run_management_service","index","installation/installation","playbooks/playbooks","reference/community","reference/documentation","reference/helpful_links","release/release","requirements/requirements","troubleshooting/errorsandmessages","zhmc-ansible-modules/docs/ansible_content","zhmc-ansible-modules/docs/source/bibliography","zhmc-ansible-modules/docs/source/development","zhmc-ansible-modules/docs/source/modules","zhmc-ansible-modules/docs/source/modules/zhmc_adapter","zhmc-ansible-modules/docs/source/modules/zhmc_adapter_list","zhmc-ansible-modules/docs/source/modules/zhmc_console","zhmc-ansible-modules/docs/source/modules/zhmc_cpc","zhmc-ansible-modules/docs/source/modules/zhmc_cpc_list","zhmc-ansible-modules/docs/source/modules/zhmc_crypto_attachment","zhmc-ansible-modules/docs/source/modules/zhmc_hba","zhmc-ansible-modules/docs/source/modules/zhmc_lpar","zhmc-ansible-modules/docs/source/modules/zhmc_lpar_list","zhmc-ansible-modules/docs/source/modules/zhmc_nic","zhmc-ansible-modules/docs/source/modules/zhmc_nic_list","zhmc-ansible-modules/docs/source/modules/zhmc_partition","zhmc-ansible-modules/docs/source/modules/zhmc_partition_list","zhmc-ansible-modules/docs/source/modules/zhmc_password_rule","zhmc-ansible-modules/docs/source/modules/zhmc_password_rule_list","zhmc-ansible-modules/docs/source/modules/zhmc_session","zhmc-ansible-modules/docs/source/modules/zhmc_storage_group","zhmc-ansible-modules/docs/source/modules/zhmc_storage_group_attachment","zhmc-ansible-modules/docs/source/modules/zhmc_storage_volume","zhmc-ansible-modules/docs/source/modules/zhmc_user","zhmc-ansible-modules/docs/source/modules/zhmc_user_list","zhmc-ansible-modules/docs/source/modules/zhmc_user_role","zhmc-ansible-modules/docs/source/modules/zhmc_user_role_list","zhmc-ansible-modules/docs/source/modules/zhmc_virtual_function","zhmc-ansible-modules/docs/source/release_notes","zhmc-ansible-modules/docs/source/requirements_managed","zhmc-ansible-modules/docs/source/troubleshooting"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":2,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["faqs/faqs.rst","ibm_zos_cics/docs/ansible_content.rst","ibm_zos_cics/docs/source/community_guides.rst","ibm_zos_cics/docs/source/modules.rst","ibm_zos_cics/docs/source/modules/cmci_action.rst","ibm_zos_cics/docs/source/modules/cmci_create.rst","ibm_zos_cics/docs/source/modules/cmci_delete.rst","ibm_zos_cics/docs/source/modules/cmci_get.rst","ibm_zos_cics/docs/source/modules/cmci_update.rst","ibm_zos_cics/docs/source/release_notes.rst","ibm_zos_cics/docs/source/requirements_managed.rst","ibm_zos_core/docs/ansible_content.rst","ibm_zos_core/docs/source/community_guides.rst","ibm_zos_core/docs/source/community_guides_docs/better_arg_parser.rst","ibm_zos_core/docs/source/community_guides_docs/zos_ansible_module_testing.rst","ibm_zos_core/docs/source/filters.rst","ibm_zos_core/docs/source/modules.rst","ibm_zos_core/docs/source/modules/zos_apf.rst","ibm_zos_core/docs/source/modules/zos_archive.rst","ibm_zos_core/docs/source/modules/zos_backup_restore.rst","ibm_zos_core/docs/source/modules/zos_blockinfile.rst","ibm_zos_core/docs/source/modules/zos_copy.rst","ibm_zos_core/docs/source/modules/zos_data_set.rst","ibm_zos_core/docs/source/modules/zos_encode.rst","ibm_zos_core/docs/source/modules/zos_fetch.rst","ibm_zos_core/docs/source/modules/zos_find.rst","ibm_zos_core/docs/source/modules/zos_gather_facts.rst","ibm_zos_core/docs/source/modules/zos_job_output.rst","ibm_zos_core/docs/source/modules/zos_job_query.rst","ibm_zos_core/docs/source/modules/zos_job_submit.rst","ibm_zos_core/docs/source/modules/zos_lineinfile.rst","ibm_zos_core/docs/source/modules/zos_mount.rst","ibm_zos_core/docs/source/modules/zos_mvs_raw.rst","ibm_zos_core/docs/source/modules/zos_operator.rst","ibm_zos_core/docs/source/modules/zos_operator_action_query.rst","ibm_zos_core/docs/source/modules/zos_ping.rst","ibm_zos_core/docs/source/modules/zos_script.rst","ibm_zos_core/docs/source/modules/zos_tso_command.rst","ibm_zos_core/docs/source/modules/zos_unarchive.rst","ibm_zos_core/docs/source/modules/zos_volume_init.rst","ibm_zos_core/docs/source/plugins.rst","ibm_zos_core/docs/source/release_notes.rst","ibm_zos_core/docs/source/requirements_managed.rst","ibm_zos_core/docs/source/resources/character_set.rst","ibm_zos_core/docs/source/resources/resources.rst","ibm_zos_ims/docs/ansible_content.rst","ibm_zos_ims/docs/source/community_guides.rst","ibm_zos_ims/docs/source/community_guides_docs/zos_ansible_module_testing.rst","ibm_zos_ims/docs/source/modules.rst","ibm_zos_ims/docs/source/modules/ims_acb_gen.rst","ibm_zos_ims/docs/source/modules/ims_catalog_populate.rst","ibm_zos_ims/docs/source/modules/ims_catalog_purge.rst","ibm_zos_ims/docs/source/modules/ims_command.rst","ibm_zos_ims/docs/source/modules/ims_dbd_gen.rst","ibm_zos_ims/docs/source/modules/ims_dbrc.rst","ibm_zos_ims/docs/source/modules/ims_psb_gen.rst","ibm_zos_ims/docs/source/release_notes.rst","ibm_zos_ims/docs/source/requirements_managed.rst","ibm_zos_sysauto/docs/ansible_content.rst","ibm_zos_sysauto/docs/source/community_guides.rst","ibm_zos_sysauto/docs/source/release_notes.rst","ibm_zos_sysauto/docs/source/requirements_managed.rst","ibm_zos_sysauto/docs/source/roles.rst","ibm_zos_sysauto/docs/source/roles/sa_create_dynamic_resource.rst","ibm_zos_sysauto/docs/source/roles/sa_delete_dynamic_resource.rst","ibm_zosmf/docs/ansible_content.rst","ibm_zosmf/docs/source/community_guides.rst","ibm_zosmf/docs/source/modules.rst","ibm_zosmf/docs/source/modules/zmf_authenticate.rst","ibm_zosmf/docs/source/modules/zmf_sca.rst","ibm_zosmf/docs/source/modules/zmf_workflow.rst","ibm_zosmf/docs/source/release_notes.rst","ibm_zosmf/docs/source/requirements_control.rst","ibm_zosmf/docs/source/requirements_managed.rst","ibm_zosmf/docs/source/resources.rst","ibm_zosmf/docs/source/roles.rst","ibm_zosmf/docs/source/roles/zmf_cpm_create_software_instance.rst","ibm_zosmf/docs/source/roles/zmf_cpm_get_software_instance.rst","ibm_zosmf/docs/source/roles/zmf_cpm_list_software_templates.rst","ibm_zosmf/docs/source/roles/zmf_cpm_manage_software_instance.rst","ibm_zosmf/docs/source/roles/zmf_cpm_provision_software_service.rst","ibm_zosmf/docs/source/roles/zmf_cpm_remove_software_instance.rst","ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates.rst","ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates.rst","ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates.rst","ibm_zosmf/docs/source/roles/zmf_workflow_complete.rst","ibm_zosmf/docs/source/roles/zmf_zmsc_run_management_service.rst","index.rst","installation/installation.rst","playbooks/playbooks.rst","reference/community.rst","reference/documentation.rst","reference/helpful_links.rst","release/release.rst","requirements/requirements.rst","troubleshooting/errorsandmessages.rst","zhmc-ansible-modules/docs/ansible_content.rst","zhmc-ansible-modules/docs/source/bibliography.rst","zhmc-ansible-modules/docs/source/development.rst","zhmc-ansible-modules/docs/source/modules.rst","zhmc-ansible-modules/docs/source/modules/zhmc_adapter.rst","zhmc-ansible-modules/docs/source/modules/zhmc_adapter_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_console.rst","zhmc-ansible-modules/docs/source/modules/zhmc_cpc.rst","zhmc-ansible-modules/docs/source/modules/zhmc_cpc_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_crypto_attachment.rst","zhmc-ansible-modules/docs/source/modules/zhmc_hba.rst","zhmc-ansible-modules/docs/source/modules/zhmc_lpar.rst","zhmc-ansible-modules/docs/source/modules/zhmc_lpar_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_nic.rst","zhmc-ansible-modules/docs/source/modules/zhmc_nic_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_partition.rst","zhmc-ansible-modules/docs/source/modules/zhmc_partition_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_password_rule.rst","zhmc-ansible-modules/docs/source/modules/zhmc_password_rule_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_session.rst","zhmc-ansible-modules/docs/source/modules/zhmc_storage_group.rst","zhmc-ansible-modules/docs/source/modules/zhmc_storage_group_attachment.rst","zhmc-ansible-modules/docs/source/modules/zhmc_storage_volume.rst","zhmc-ansible-modules/docs/source/modules/zhmc_user.rst","zhmc-ansible-modules/docs/source/modules/zhmc_user_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_user_role.rst","zhmc-ansible-modules/docs/source/modules/zhmc_user_role_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_virtual_function.rst","zhmc-ansible-modules/docs/source/release_notes.rst","zhmc-ansible-modules/docs/source/requirements_managed.rst","zhmc-ansible-modules/docs/source/troubleshooting.rst"],objects:{},objnames:{},objtypes:{},terms:{"0000000bba01":39,"000c":33,"000d":33,"000e":33,"000f":33,"00106f237ab1":119,"00106f239c31":[100,103,105,109,111,116,118],"00106f239d19":[103,109,111,116,118],"00106f25b43c":121,"009c0f4c":[116,118],"01a0":29,"023f":109,"033f":123,"0706c00180000000000000000070e050":107,"083c":29,"0c99":119,"0f03":29,"0ick00703i":39,"0ick01314i":39,"0ick04000i":39,"0xc1":43,"100088947155a1e9":[100,116],"100mb":19,"1036k":29,"1048k":29,"10c":[101,103],"10fa8489":107,"10m":27,"11548k":27,"11740k":29,"11896k":29,"11e8":[100,103,105,109,111,116],"11e9":[103,113,116,118,119],"11ea":[103,109,111],"11eb":119,"11ec":121,"11m":29,"123f":106,"12c":100,"14m":29,"15t02":[4,5,6,7,8],"16s":[100,116],"1768k":29,"1876480k":29,"19e90e27":119,"1appus":30,"1cae":119,"1data":27,"1gb":19,"1ickdsf":39,"200a":[116,118],"20a6":103,"240k":[27,29],"252k":29,"2535b19e":70,"256k":29,"2gb":0,"2mb":25,"32323df4":[109,111],"351b":103,"358a":116,"3dc87062":121,"3e7ed5ca28d7":[100,103,105,111,116],"3f99":[100,103,105,111,116],"422c":119,"4947c6d0":[103,111],"4a00003c":39,"4a14":[100,103,105,111,116],"4a52":70,"4a7e":113,"4e06":107,"4f01576a":107,"4gb":0,"50m":[14,47],"518ac1d8":119,"520c0138":113,"5695df18658i10001000":69,"58e41a42":103,"5956e97a":[109,111],"600507681081001d4800000000000083":[116,118],"60k":27,"6a46d18a":103,"8bb3":113,"8d320d5f68b048fc97559d771ede68b37a71e8374d1d678d96dcfa2b2da7a64":[21,24],"8dfc":103,"8e5b":121,"8ea3":121,"8f73":[103,111],"91773b88":119,"91ba":119,"92k":29,"9d77":70,"9fbb":103,"boolean":[13,39,41,111,116,119,124],"byte":[18,21,22,25,27,29,32,38,50,51,95],"case":[2,4,5,6,7,8,10,12,13,14,18,21,22,24,31,36,38,39,41,46,47,69,70,71,73,76,77,78,80,85,86,92,95,100,107,113,115,124],"class":[17,18,19,21,22,27,28,29,32,38,39,41,50,51,69,100,105,107,109,111,113,116,118,119,121],"default":[0,4,5,6,7,8,9,14,17,18,19,20,21,22,23,24,25,26,28,29,30,31,32,33,36,38,39,41,42,47,49,50,51,53,55,57,60,63,64,69,70,73,76,77,78,79,80,81,82,83,84,85,86,88,95,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],"export":[14,20,47],"final":[22,69,70,85,98],"float":[33,124],"function":[4,5,6,7,8,12,27,29,32,39,40,41,43,46,71,73,98,99,111,116,124],"import":[12,14,41,47,50,98,111,116],"int":[4,5,6,7,8,13,17,18,19,20,21,22,24,25,27,28,29,30,31,32,33,34,36,37,38,39,41,50,51,53,54,55,63,64,68,69,70,79,80,85,86,105,116],"long":[13,20,21,22,28,29,30,31,39],"new":[8,13,14,19,20,21,22,29,32,37,39,47,50,51,52,56,57,63,70,71,82,83,84,85,88,93,100,103,107,111,115,124],"null":[25,28,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],"public":[14,32,47,70,76,85],"return":[3,13,14,16,41,47,48,56,67,71,76,77,78,80,82,83,84,85,86,95,99,124],"short":[63,98,100,111,116],"static":17,"switch":[32,96,109,111,116,117,118],"throw":[14,41,47],"transient":[76,77,78,80,86],"true":[4,5,6,7,8,9,13,14,17,18,19,20,21,22,23,24,25,28,29,30,31,32,33,34,36,37,38,39,41,47,49,50,51,52,53,54,55,63,64,68,69,70,76,77,78,79,80,81,82,83,84,85,86,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],"try":[14,21,29,36,41,47],"var":[0,14,20,21,29,30,36,47,61,63,64,73,76,77,78,79,80,81,85,86,124],"while":[14,16,21,22,25,30,31,32,36,41,47,48,51,67,70],ACS:19,ADDED:50,AND:[25,27,29,39],ARE:51,Added:[9,71,124],Age:25,BAS:5,Bus:106,But:[14,47],CTS:7,DDs:[29,41],FOR:[20,27,29,39,51],For:[0,2,3,4,5,6,7,8,10,12,13,15,17,18,20,21,22,23,24,25,27,28,29,30,31,32,33,36,38,42,43,46,49,50,57,59,61,66,69,70,71,76,85,88,89,94,95,98,100,101,102,103,104,105,106,107,108,109,111,112,113,115,116,117,118,119,121,123],HAS:29,HFS:[22,24,31],IDs:[42,57,84],IMS:[0,25,34,48,56,57,76,79,80,81,87,90,93,94,95],Its:70,JES:[27,28,29,70,85],LDS:[21,22,50,51],MVS:[17,18,20,21,23,24,25,27,30,31,38,39,41,42,57],NFS:31,NOS:29,NOT:[14,21,24,29,41,47],Not:[18,21,22,32,38,50,51],ONE:[13,27],One:[25,37,74],PAS:[42,57],PDS:[13,18,20,21,22,23,24,25,29,30,38,41,50,51,53,54,55],PFS:31,PRs:124,PYS:[42,57],SMS:[17,18,19,21,22,32,38,39,50,51],SYS:[27,29],Such:[70,85,94],Sys:[0,87,90,93,94,95],TFS:31,THAT:[27,29,51],THE:[27,29,50,51],TIS:43,TRS:[18,38],That:[21,70,98],The:[0,1,3,4,5,6,7,8,9,10,11,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,36,37,38,39,41,42,43,45,47,48,49,50,51,52,53,54,55,56,57,58,61,62,63,64,65,67,68,69,70,71,73,75,76,77,78,79,80,81,82,83,84,85,86,88,89,92,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126],Then:[85,98],There:[0,19,29,41,89,98,126],These:[0,4,6,7,8,14,21,29,31,36,41,47,53,55,62,98,124],UCS:43,USING:29,Use:[0,14,18,19,21,25,32,38,41,47,50,51,54,88,89,100,119],Used:[19,30,40,82,83,84,109,113,116,118,119,121],Uses:[26,28],Using:[7,17,20,21,41,42,57],VFs:124,WAS:[27,29,39,50],WILL:[27,29],WITH:29,Will:[17,36,38,106,109,111,123],With:[14,32,41,42,47,57,71,73],YES:[21,31],Yes:[0,31],ZFS:[20,22,24,31],ZOS:[42,57],_________________________________________:29,__dict__:[14,47],__future__:[14,47],__init__:[14,47],__metaclass__:[14,47],_bpxk_autocvt:[14,47],_cee_runopt:[14,47],_encode_file_exist:57,_encode_file_new:57,_export_:[14,47],_keydata:[4,5,6,7,8],_play_context:41,_tag_redir_err:[14,47],_tag_redir_in:[14,47],_tag_redir_out:[14,47],_text:41,a13b:109,a142:[116,118],a14b:[100,105,116],a87c:[100,103,105,111,116],a8c3:70,a951:107,aap:[94,107],abbrev:29,abbrevi:[31,41],abc:[21,25,123],abcdefabcdef:111,abend:[27,28],abil:[4,6,7,8,87,100],abl:[21,24,29,71,73],abnorm:[32,50,51],abnormal_disposit:[50,51],about:[0,4,5,6,7,8,9,14,41,42,47,54,57,61,71,73,76,80,86,88,89,93,94,95,98,99,100,103,105,106,107,109,111,113,116,117,118,119,121,123,124],abov:[13,63,64,71,82,83,84,95,121,124],absenc:124,absent:[17,18,20,22,30,31,41,100,106,109,111,113,116,118,119,121,123,124],absolut:[13,14,17,18,20,21,23,24,30,31,32,38,47,69,107,111,116],absolute_import:[14,47],acb:[45,48,50,51],acb_lib:[49,50],acbgen:49,acblib:[49,50],acc:[100,105],acceler:123,accent:41,accept:[0,2,3,4,6,7,8,12,13,14,22,32,37,46,47,54,59,66,67,76,77,78,80,86,99,104,107,108,111,112,116],acceptable_statu:[103,124],access:[0,14,16,22,27,29,32,39,41,47,67,68,69,70,71,82,83,84,85,88,89,95,99,100,101,102,103,104,105,106,107,108,109,110,111,112,114,116,117,118,119,120,122,123],access_group:32,access_mod:[105,111],accomod:124,accord:[4,5,6,7,8],accordingli:[34,124],account:[13,41,70,85,98],achiev:[14,47,70],across:[99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123,124],act:[13,18,21,38,41],action:[1,3,5,6,7,8,11,14,16,22,38,41,47,50,51,54,69,76,79,80,86,98,115,116,117,118,124],action_nam:4,action_paramet:4,actionobjectid:69,activ:[27,28,29,33,39,49,52,58,73,89,98,100,101,103,104,105,107,108,111,112,116,117,118,124],activation_mod:108,activation_profile_nam:[103,107],actual:[13,31,41,117],adapt:[96,99,103,105,106,109,111,116,121,123,124],adapter1:[100,101,111],adapter2:111,adapter_count:105,adapter_famili:101,adapter_id:[100,101],adapter_list:101,adapter_nam:[105,106,109,123],adapter_port:[106,109],adapter_port_uri:106,adapter_uri:123,add:[15,16,18,20,21,22,30,31,36,38,41,48,56,60,71,88,95,98,107,124],add_stylesheet:124,added:[14,17,18,21,25,26,29,30,31,32,33,36,41,47,50,56,57,89,95,105,111,124],adding:[17,50,124],addit:[12,13,19,26,27,28,29,39,41,46,49,69,72,89,91,92,94,98,100,102,103,104,105,106,107,109,111,113,116,118,119,121,123,124,125,126],addition:[14,39,47,88],additionalinfo:69,address:[13,27,28,29,32,39,41,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],adequ:[18,38],adher:88,adhoc:[14,47],adjust:[89,124],admin:28,administr:[21,38,69,89,119],adrdssu:[18,19,32,38],advanc:41,advis:54,aes:[111,116],affect:[49,124],after:[13,14,18,20,21,24,26,29,30,31,32,36,38,41,47,50,51,56,70,85,86,89,98,105,106,107,109,111,115,116,117,118,123,124],afterward:41,again:[70,98,124],against:[0,14,25,47,95,98,116,117,118,124],age:[13,25],age_stamp:25,agil:0,algorithm:[0,18],alia:21,alias:[13,14,21,41,47],align:[41,94],all:[0,7,9,13,14,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,36,37,38,39,41,43,47,49,51,52,53,54,55,69,71,73,75,87,88,89,94,95,98,100,101,103,105,106,107,108,109,111,112,113,116,117,118,119,121,123,124],alloc:[18,19,21,22,25,27,29,32,33,36,37,38,41,49,50,51,54,107],allow:[12,13,14,15,22,29,31,32,37,41,43,47,54,75,79,80,86,100,103,107,113,116,119,124],allow_uid:31,aloadtim:[4,5,6,7,8],alon:[4,5,6,7,8,9,10],along:[41,51,52,71,85,124],alpha:[32,98,124],alphabet:[43,113],alphanumer:39,alreadi:[17,21,22,24,29,32,36,41,50,70,82,83,84,100,103,106,107,109,111,113,116,118,119,121,123,124],also:[0,1,4,5,6,7,8,9,10,11,15,16,17,19,23,30,41,43,45,49,50,51,54,56,58,63,64,65,67,69,70,71,75,82,83,88,96,98,99,103,106,107,109,113,116,118,119,121,123,124,126],alter:69,altern:[12,13,14,41,47,95,124],although:[0,89,90],alwai:[4,5,6,7,8,13,15,17,18,20,21,22,23,24,28,30,31,32,33,34,35,37,38,41,49,51,52,53,54,55,68,69,70,88,89,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],am2:124,amaters:19,amod:29,amount:[19,22,29,32,41,50,51],analog:32,analysi:51,analysis_mod:51,analyz:51,angel:107,ani:[4,5,6,7,8,13,14,18,20,21,24,25,26,27,28,29,31,32,33,34,35,38,39,41,47,49,50,51,52,68,69,70,76,78,79,80,81,85,86,88,94,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],anoth:[13,17,20,21,23,30,31,32,33,41,124],ansbil:41,ansi:[21,41],ansibl:[1,3,7,9,10,11,13,14,15,16,17,18,19,20,21,22,23,24,29,30,31,32,36,38,39,40,41,42,45,47,48,55,56,57,58,60,61,63,64,65,67,68,69,70,71,73,76,77,78,79,80,81,82,83,84,85,86,89,91,92,93,94,96,98,99,106,109,111,116,123,124],ansible_collect:[0,88],ansible_collections_ibm_zos_cor:14,ansible_collections_ibm_zos_im:47,ansible_collections_ibm_zos_ims:47,ansible_config:[0,88],ansible_date_tim:20,ansible_fact:[14,26,41,47],ansible_hostnam:20,ansible_password:41,ansible_python_interpret:95,ansible_sample_workflow_:[70,85],ansible_sample_workflow_sy1:70,ansible_shell_execut:[42,57],ansible_ssh_control_path_dir:41,ansible_vers:[21,29,36],ansible_workflowname_:70,ansiblemodul:[14,47],ansitest:[4,5,6,7,8],anymor:98,anyth:92,anywher:[30,31],apar:[32,41,61,71],apf:[11,16,31,32,39,41,49],apfadm:17,apg:63,api:[0,1,4,5,6,7,8,9,10,14,17,20,30,31,32,41,47,58,61,63,64,69,71,73,88,91,94,96,97,100,101,102,103,104,105,106,107,108,109,111,112,113,116,118,119,121,123,124,125],api_polling_interval_second:[79,80,86],api_polling_retry_count:[79,80,86],api_vers:102,apist:[4,5,6,7,8],appear:[4,6,7,8,32,41,95],append:[17,20,21,23,24,25,30,31,88,89],appli:[19,21,22,26,29,31,36,37,41,53,55,61,105,107,124,126],applianc:[111,116],applic:[0,4,5,6,7,8,18,21,24,25,31,32,38,45,49,50,53,55,63,71,76,78,79,80,81,83,87,89,94,121],applid:[4,5,6,7,8],applmajorv:[4,5,6,7,8],applmicrov:[4,5,6,7,8],applminorv:[4,5,6,7,8],approach:[73,111,116],appropri:[0,4,17,41,63,64,71,76,77,78,79,80,81,86,88,95],approv:98,approxim:18,appveyor:124,arch_level:26,architectur:[40,41,92],archiv:[0,16,19,32,38,41,88,98,124],archive_folder_test:38,arcroot:18,area:[18,21,22,32,38],arg:[14,36,47],arg_def:13,arg_typ:12,argpars:[12,13],argument:[12,32,36,41,56,70,82,83,84],around:[14,31,41,47],arr:84,arrai:[69,76,79],artifact:[0,89],artifici:[100,106,109,111,116,119,121,123,124],as_resourc:4,asa:[21,41],asa_text:21,ascii:[21,57],asid:[27,28,29,41],asif:13,ask:[41,95],asm:98,asma90:29,assembl:[41,53],assert:[14,47],assert_called_with:[14,47],assign:[4,5,6,7,8,14,21,27,28,29,36,39,41,47,70,85,111],assist:[69,71],associ:[4,5,6,7,8,17,21,32,33,38,49,52,63,70,71,76,77,79,80,85,86,103,116,117,118,121],associated_system_defined_user_role_nam:121,associated_system_defined_user_role_uri:121,assum:[4,6,7,8,14,20,21,23,24,30,31,32,34,36,47,63,64,76,77,78,79,80,81,82,83,84,86,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],asterisk:[17,19,28,34],asynchron:31,atb:[27,29],attach:[34,99,111,116,118,124],attempt:[21,22,29,79,80,86],attent:[69,98],attribut:[4,5,6,7,8,18,21,22,31,32,38,39,41,50,51,124],attribute1:[4,5,6,7,8],attribute2:[4,5,6,7,8],attribute3:[4,5,6,7,8],attribute4:[4,5,6,7,8],attribute5:[4,5,6,7,8],attribute6:[4,5,6,7,8],attributeerror:[41,124],audit:[69,71],augment:[15,40],auth:[32,88,124],auth_url:[0,88],authent:[4,5,6,7,8,14,47,61,67,69,70,73,76,77,78,79,80,81,82,83,84,85,86,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],authentication_typ:[119,124],author:[0,11,16,20,23,30,32,39,41,49,50,51,89,98],auto:[0,87,90,93,94,95,107,111,116],auto_reload:[21,29,36],autocorrect:21,autocvt:[14,47],autodb:[50,51],autogener:[111,116],autom:[0,1,3,9,10,11,14,16,23,26,27,28,29,41,42,45,47,48,56,57,60,61,62,63,64,65,67,70,71,85,87,89,92,93,94,96,98,124],automat:[19,21,24,31,32,34,41,69,70,71,73,75,98,106,111,124],automation_hub:88,automationhub:[98,124],automov:31,automove_list:31,autotag:[14,47],avail:[0,4,5,6,7,8,13,17,18,19,20,21,22,23,24,26,29,30,31,32,38,39,42,52,57,87,88,89,93,98,111,116,124],available_features_list:124,ave:13,avoid:[0,12,13,20,23,30,41,124],await:34,awar:[20,26],awx:[0,41],b1bf361886a4:107,b352:29,b447:103,b4d3:119,b67c:[109,111],b9dd:119,b_text:29,back:[3,7,11,16,17,19,20,21,24,30,31,32,36,39,48,106,109,123,124],backref:30,backrefer:30,backup:[0,16,17,20,21,22,23,24,30,31,32,39,41],backup_compress:23,backup_nam:[17,19,20,21,23,30,31,32],bad3:[116,118],bailei:13,bak:[17,20,21,23,30,31],bar:[18,21],basdefinev:[4,5,6,7,8],base64:32,base:[0,17,18,20,21,25,29,30,36,37,39,41,42,51,54,57,69,71,73,75,98,104,108,112,120,124],bash:[42,57],basi:[43,98],basic:[4,5,6,7,8,14,21,22,25,32,47,50,51,53,55,89,111,114,116,119],batch:[17,22,27,28,29,37,41,49,50,52,53,55,70,85],batch_result:[53,55],bc93:116,bd0a:[109,111],bdfeb245fc36:113,bear:41,becaus:[13,31,41,42,50,57,70,76,77,78,80,86,89,100,106,109,111,113,116,118,119,121,123,124,125],becom:[14,31,47,95,106,109,123],become_us:95,been:[0,12,14,19,21,23,28,29,32,38,41,47,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],befor:[10,13,14,17,18,20,21,29,30,32,36,39,41,42,47,49,50,51,57,73,79,80,86,88,89,94,95,98,111,124],beforehand:21,beg:28,begin:[13,17,20,21,28,29,30,34,36,50,51,60,70,85],beginnendn:20,behavior:[0,21,24,41,95,124],behind:[14,41,47],being:[4,5,6,7,8,13,17,19,20,21,22,24,29,30,31,36,41,53,55,86,98,106,109,111,113,115,116,118,119,121,123,124],below:[14,32,41,43,47,69,85,95,111,116,124],benefici:[14,47],benefit:[14,47],besid:98,beta:[60,88,124],better:124,better_arg_pars:13,betterarg:12,between:[13,31,32,50,51,85,100,124],beyond:12,bf98:119,bgysc1310:17,bgysc1311:[20,30],bibliographi:124,big5:43,bin:[13,14,20,30,36,47,95],binari:[20,21,23,24,25,30,32,38,41,95],binconr:[4,5,6,7,8],binconsc:[4,5,6,7,8],bind:53,binder:29,binsterr:[4,5,6,7,8],bit:31,blake:13,blank:39,blklgth:32,blksize:[18,29,38],block:[16,17,18,21,22,29,32,36,38,41,45,49,50,51,53,55,107],block_end_str:[21,29,36],block_siz:[18,21,22,32,38,50,51],block_start_str:[21,29,36],blog:[0,41,71],bmp:[50,51],bodi:[4,5,6,7,8,20],bof:[20,30],book:[97,100,102,103,105,106,107,109,111,113,116,118,119,121,123],bool:[4,5,6,7,8,13,17,18,19,20,21,22,23,24,27,28,29,30,31,32,33,34,36,38,39,49,50,51,52,53,55,68,69,70,85,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],boot:[107,111,116,118,124],boot_devic:111,boot_load_paramet:124,boot_logical_unit_numb:111,boot_network_devic:111,boot_network_nic_nam:111,boot_storage_devic:111,boot_storage_device_hba_nam:111,boot_storage_hba_nam:111,boot_storage_volum:124,boot_storage_volume_nam:124,boot_world_wide_port_nam:111,bootabl:111,bootstrap:50,bootstrap_dataset:50,both:[0,13,14,19,21,30,41,47,49,51,53,55,57,95,97],bound:[63,64],box:[14,47],bpxprm00:20,bpxprmaa:31,bpxprmab:31,bpxprmxx:31,bpxw0003i:36,branch:[98,124],brief:0,bring:[1,11,45,58,65,96,124],broaden:124,broader:[1,9,11,45,56,58,60,65,71,96],broken:[14,47,60],browser:98,buffer:[32,33,50,51],buffer_pool_param_dataset:[50,51],bug:[0,2,9,12,46,56,59,66,93,98,124],bugfix:0,build:[0,4,6,7,8,14,47,49,87,124],build_ignor:88,build_psb:49,built:[0,9,12,49,88,98,124],builtin:41,bundl:[4,5,6,8],bundledir:5,busi:33,buster:124,button:98,bypass:[21,95],byte_count:[27,29,32],bz2:[18,38,41],bzip:38,c05076d24d80016e:116,c1d5e2c9e3c5e2e3:[4,5,6,7,8],c3f6:107,c44338de:103,ca_cert:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],cach:7,cadenc:0,calcul:18,call:[9,14,17,20,22,27,30,31,41,43,47,49,52,53,54,55,56,61,63,64,68],callabl:32,can:[1,3,4,5,6,7,8,9,10,13,14,15,16,17,18,19,20,21,22,23,24,25,27,28,29,30,31,32,33,36,38,39,41,42,43,47,48,49,50,51,53,54,55,56,57,61,62,67,68,69,70,71,73,76,77,78,79,80,81,82,83,84,85,86,87,88,89,94,96,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],cancel:[28,41],candid:[4,5,6,7,8,116],candidateassign:[4,5,6,7,8],candidatedescript:[4,5,6,7,8],candidategroup:[4,5,6,7,8],candidatenam:[4,5,6,7,8],candidateoverrid:[4,5,6,7,8],candidatesystemgroup:[4,5,6,7,8],candidatetyp:[4,5,6,7,8],candidateusag:[4,5,6,7,8],candidatevers:[4,5,6,7,8],cannot:[13,20,30,32,39,50,51,70,95,98,100,103,106,107,109,111,113,116,118,119,121,123,124],canon:103,cap:[107,111,116],capabl:[31,41],capac:[0,41,100,107,116],captur:[30,41,76,78,80,86],card:[27,29,41,100,105,109,116,124],carefulli:[41,95],cat:[0,20],catalog:[17,20,21,22,23,24,25,29,30,31,32,41,45,48,71,73,78,80,86],catalog_service_nam:86,catalog_service_namm:86,catalogu:41,categor:41,categori:[0,69,70,71,83,86],category_nam:86,catlg4:37,catlg:[32,50,51],caus:[14,27,29,41,49,51,56,98,124],caution:[21,41],cbp:107,cca:[100,105],ccg:37,cchh:39,ccsid:[31,43],cctext:52,cedf:[4,5,6,7,8],cedfstatu:[4,5,6,7,8],central:[56,107],cert:37,certain:[14,47,50,54,62,67,75,113,116,119,121,124],certif:[4,5,6,7,8,68,69,70,85,94,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],certifi:[1,9,11,45,56,58,60,65,71,88,89,91,92,94,96,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],cf79:103,cfg:[0,88,89],chain:[4,5,6,7,8,68,69,70,85],chang:[4,5,6,7,8,9,13,14,17,20,21,22,23,27,28,29,30,31,32,33,34,36,42,47,49,50,56,57,60,68,69,70,86,88,95,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],change_record_numb:86,changeag:[4,5,6,7,8],changeagrel:[4,5,6,7,8],changedataset:69,changetim:[4,5,6,7,8],changeusrid:[4,5,6,7,8],channel:[92,100,105,107,116],charact:[4,5,6,7,8,13,17,18,19,20,21,23,24,25,28,29,30,31,32,34,36,39,41,44,51,113,124],characterist:32,charset:[20,21,23,24,30,36],chdir:36,check:[13,14,16,21,22,24,31,38,39,41,47,50,69,70,85,98,117,124],check_format:17,check_req:98,check_timestamp:[50,56],checkout:98,checkpoint:[50,51],checksum:[21,24],child:[103,111,124],chmod:32,choic:[4,5,6,7,8,13,17,18,19,20,21,22,25,29,30,31,32,36,38,41,42,49,50,51,53,55,57,69,70,85,100,102,103,105,106,107,109,111,113,115,116,117,118,119,121,123],choos:[14,25,47,88],chosen:43,chown:[18,38],cic:[2,3,9,10,17,76,78,79,80,81,87,90,93,94,95],cics13:25,cicsapi:[4,5,6,7,8],cicsbundl:[4,6],cicsdefinitionbundl:[5,6,8],cicsdefinitionprogram:7,cicslocalfil:7,cicsplex:[3,9,10],cicsprogram:4,cicsregion:7,cicssi:[4,6,7,8],circumv:124,circumvent:124,citi:13,clarifi:124,classic:[99,101,103,104,107,112,121,124],clean:[0,41,89,98],clean_staging_dataset:50,cleanup:[41,98,124],clear:[14,47,95,107,124],cli:[10,21,24],click:[98,124],client:[1,4,5,6,7,8,35,68,69,70,85,87,88],clist:36,clone:[0,41,88,98],close:[20,98],cloud:[71,73,74,76,77,78,80,81,88],cluster:[25,41,107],cma:[4,5,6,7,8],cmci:[1,4,5,6,7,8,9,10],cmci_:0,cmci_act:[3,9],cmci_cert:[4,5,6,7,8],cmci_creat:[3,9],cmci_delet:[3,9],cmci_get:[0,3,4,6,8,9],cmci_group:9,cmci_host:[4,5,6,7,8],cmci_kei:[4,5,6,7,8],cmci_password:[4,5,6,7,8],cmci_port:[4,5,6,7,8],cmci_upd:[3,9],cmci_us:[4,5,6,7,8],cmd:[20,21,30,31,32,33,36,41],cna:124,cobolsrc:21,coboltyp:[4,5,6,7,8],cobu:25,code:[4,5,6,7,8,14,17,20,21,24,25,27,28,29,31,32,33,36,37,39,41,43,47,49,50,51,52,53,54,55,69],codec:95,cogpsbl2:55,cogpsbl:55,colleciton:124,collect:[1,2,3,9,10,11,14,15,16,26,27,28,29,40,41,42,45,47,48,54,56,57,58,60,61,62,63,64,65,67,71,72,73,75,76,77,78,79,80,81,82,83,84,86,87,88,90,91,92,93,94,96,98,99,119,124,125,126],colo:[111,116],colon:[53,55],column:98,com:[4,5,6,7,8,68,88,98,124],combin:[4,6,7,8,13,32,49,98,100],come:[26,40,87,90],comma:25,command:[0,4,5,6,7,8,11,14,16,17,18,20,21,24,25,31,32,34,36,38,39,41,42,43,45,47,48,49,57,67,69,82,83,84,88,89,92,94,95,98,99,105,111,116],command_input:49,comment:[0,2,12,21,29,30,31,36,46,59,63,66],comment_end_str:[21,29,36],comment_start_str:[21,29,36],commit:98,common:[17,19,20,23,24,29,30,41,89,91,92,124],commun:[2,12,36,41,46,59,66,87,88,89,90],comn01:17,comnuc:25,compar:[22,25,41,70,124],compat:[18,41,124],compil:[34,41,53,54,55],complet:[4,6,14,21,22,27,28,29,31,33,36,39,40,41,47,52,54,70,71,75,76,77,78,79,80,86,103,116,118],complete_check_delai:85,complete_check_tim:85,complex:[0,4,6,7,8,13,18],complex_filt:[4,6,7,8],complianc:56,compliant:124,complic:[4,6,7,8],compon:[25,41,58,61],compos:[4,5,6,7,8],compress:[18,19,23,38,49],comput:[18,21,26,41],concaten:[32,49,50,51],concept:[41,100],concurr:[4,5,6,7,8,41,49],cond:[27,29],condit:[0,21,34,39,41,124],condition:41,conf:[21,98],config:[14,47],configur:[4,5,6,7,8,9,12,13,17,20,23,29,30,31,41,42,46,57,61,63,64,69,70,71,73,76,86,87,88,89,94,95,96,100,105,111,116,117,118,121,124],conflict:[0,70,85,124],conform:50,conjunct:[0,10,12,32,41],connect:[0,4,5,6,7,8,10,14,34,41,47,61,73,87,88,95,116],connect_vers:[4,5,6,7,8],consecut:[51,113],consid:[13,14,25,31,32,36,47,50,51,70,98,105],consist:[41,70,85,88,89,102,124],consol:[33,88,89,96,97,98,102,113,116,119,121],consolid:49,constant:[14,41,47],constraint:98,construct:[20,30,111],consult:4,contact:[14,47,95],contain:[0,3,4,5,6,7,8,9,13,14,16,17,18,19,20,21,24,25,27,28,29,30,31,32,33,34,35,36,39,41,47,48,49,50,51,54,56,62,67,69,71,75,76,82,83,84,89,98,99,106,107,109,111,113,115,116,118,119,121,123,124],content:[1,2,9,11,12,13,14,19,20,21,22,24,25,27,29,30,31,32,33,34,37,38,39,41,45,46,47,49,50,51,53,55,56,58,59,60,65,66,70,71,75,85,88,89,91,92,94,95,96,98],content_typ:[27,29],context:[4,5,6,7,8],continu:[0,21,24,29,36,41,95],contribut:[87,89],control:[0,3,4,5,8,10,15,16,18,21,24,29,31,32,36,38,39,40,41,45,48,49,50,51,53,54,57,69,70,71,76,78,79,80,81,85,88,95,105,107,111,116,119,124],control_domain:105,control_stat:50,convent:[19,21,50,88],convers:[18,19,20,21,23,24,30,38,124],convert:[20,21,23,24,27,28,29,30,31,36,41,43],coordin:87,copi:[4,5,6,7,8,11,14,16,18,24,27,31,32,36,38,40,41,43,47,53,55,88],coprocessor:[105,111,116],core:[0,10,15,16,31,40,41,42,45,56,87,90,91,93,94,95,98,107,124],corp:26,correct:[20,29,30,41],correctli:[36,41,95,124],correspond:[4,18,21,24,31,36,38,41,51,54,89,92,93,98,107,124],could:[0,14,21,27,28,29,36,39,47,70,124],count:[7,27,29,34,100,113,115,116,124],counter:[111,116],countri:13,coupl:0,cover:[9,41,71,96,97,98,124],coverag:[56,98,124],coveral:124,cpc1:[101,103,108,110,112,121],cpc2:121,cpc:[99,100,101,105,106,107,108,109,110,111,112,116,117,118,121,123,124],cpc_list:[104,115],cpc_name:[100,101,105,106,107,108,109,110,111,112,116,117,118,123],cpca:[101,103,104,108,110,111,112,116],cpca_sg_mgmt1:116,cpca_sg_part1:103,cpca_sg_part2:103,cpid:107,cpm_template_nam:80,cpsm:[4,5,6,7,8],cpsm_reason:[4,5,6,7,8],cpsm_reason_cod:[4,5,6,7,8],cpsm_respons:[4,5,6,7,8],cpsm_response_cod:[4,5,6,7,8],cpu:[26,27,29,96],creat:[0,1,3,8,9,11,14,17,18,19,20,21,22,23,25,27,28,29,30,31,32,34,36,38,39,41,47,49,50,52,55,58,62,70,71,73,75,77,82,83,84,85,88,89,98,99,101,102,103,104,105,107,108,110,112,114,115,117,120,122,124],create_dataset:[14,47],create_paramet:5,createinstancedirectori:70,creation:[22,41,63,70,85,98,115,124],creation_d:[25,27,28,29],creation_tim:[27,28,29],credenti:[60,68,69,70,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],creslib:54,cresp1:[4,5,6,7,8],cresp2:[4,5,6,7,8],criteria:[4,6,7,8,25,27,28,51],critic:[32,75],cross:[111,116],crt:68,cryp00:105,cryp01:105,crypto1:105,crypto:[99,100,111,116,124],crypto_adapter_nam:111,crypto_adapter_uri:111,crypto_configur:[105,111],crypto_domain_configur:111,crypto_numb:124,crypto_typ:[100,105],cryptograph:121,cryptographi:124,cryptographydeprecationwarn:124,crystal:13,csd:[5,7,8],csdapi:[4,5,6,7,8],csdcopi:4,csdgroup:[4,5,6,7,8],csp:37,cspf1:[105,111],csvapf:17,ctl:52,cull:25,curl_ca_bundl:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],currency_symbol:13,currency_typ:13,current:[0,2,12,13,17,18,21,24,25,28,32,38,39,41,42,46,53,55,57,58,59,66,69,70,76,80,85,86,88,94,98,101,104,107,108,111,112,116,117,119,124],currentloc:[4,5,6,7,8],currtask:7,custom:[12,15,17,18,20,21,36,38,41,54,62,76,78,79,80,81,107,113],customiz:20,cve:124,cycl:94,cyl:[18,19,21,22,29,32,38,39],cylind:39,cyp:[14,47],d0000101:[27,29],d0000102:[27,29],d0000103:27,d112:100,d113:116,d17:37,d52:37,d67:37,dai:[25,51,98],darv1:32,dasd:39,data:[4,5,6,7,8,11,12,13,15,16,17,23,27,29,31,32,36,37,39,40,41,42,43,49,50,51,52,53,54,55,57,77,82,83,84,95,100,101,102,103,104,105,106,107,108,109,111,112,113,116,118,119,121,123,124],data_class:[50,51],data_set:[13,19,25,29,41,53,55],data_set_bas:13,data_set_memb:13,data_set_nam:[17,32],data_set_or_path:13,data_set_typ:24,data_stor:31,databas:[21,32,41,45,49,50,51,53,54],datacla:29,dataloc:[4,5,6,7,8],dataset:[14,17,18,19,20,21,22,23,24,25,29,30,31,32,37,38,39,41,47,49,54],dataset_nam:[50,51],datasetcreateerror:[14,47],date:[13,17,25,27,28,29,41,98],db2:[76,78,79,80,81],db2f0bec:[109,111],db2run:20,db2sms10:19,db2ssid:20,db682456:116,dbc1:33,dbd1:[49,53],dbd2:[49,53],dbd3:[49,53],dbd4:49,dbd5:49,dbd6:49,dbd:[45,48,49,50,51,54],dbd_lib:[49,50,51,54],dbd_name:[49,53],dbdgen00:29,dbdgen:[29,53,56],dbdlib1:49,dbdlib2:49,dbdlib3:49,dbdlib:[29,49,50,51,53,54],dbdname:49,dbdsrc:29,dbf000:51,dbrc:[45,48,50,51],dbrc_output:54,dbrm:21,dbver:51,dcb:27,dd_concat:32,dd_data_set:32,dd_dummi:32,dd_input:32,dd_name:32,dd_output:32,dd_unix:32,dd_vio:32,ddde026c:103,ddnama:41,ddname:[27,29,41,53,55],dds:[32,41],deactiv:[103,107,124],dead:31,deal:41,debug1:[70,85],debug:[14,47,49,77,124],decid:41,decim:[18,21,31,38,100,103,106,107,109,111,113,116,118,119,121,123,124],decod:[41,95],decompress:19,dedbjn21:53,dedbjnv1:53,def:[13,14,47],default_group_nam:119,default_group_uri:119,defin:[1,5,12,17,18,19,20,21,22,29,31,32,36,38,39,41,43,50,51,53,58,69,70,77,89,95,98,100,103,106,107,109,111,113,116,118,119,120,121,122,123,124],definesourc:[4,5,6,7,8],definetim:[4,5,6,7,8],definit:[1,3,4,6,9,13,27,29,32,53,70,85,113,119,124],degrad:[111,116],delai:[32,41,119],deleg:[0,10,94],delegate_to:[10,73],delet:[1,3,9,17,18,19,21,22,24,29,32,37,38,41,49,50,51,54,56,58,62,70,85,98,100,106,107,109,111,113,115,116,118,119,121,123,124],delete_dbd_by_vers:51,delimit:21,deliv:[0,41],demetri:13,demo01:39,demo02:39,demo03:39,demo0:39,demo:[29,71],demonstr:[89,115],deni:[14,47],denot:88,depend:[0,10,12,16,18,21,22,26,32,38,41,42,46,57,70,71,73,79,88,93,94,95,98,124],deploi:41,deploy:[0,87,89],deprec:[29,95,98,119,124],deprovis:[76,79,81],depth:13,des:[111,116],describ:[0,17,20,23,30,31,33,50,51,52,53,79,82,83,84,97,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],descript:[4,5,6,7,8,13,14,41,47,49,54,63,69,70,76,85,98,100,103,104,105,106,107,108,109,111,112,113,116,118,119,121,123,124],descriptor:[27,28,29,39,45,49,53,69,71,73],design:[12,13,14,29,47],desir:[13,14,18,22,31,32,38,41,47,69,70,100,102,103,105,106,107,109,111,113,115,116,117,118,119,121,123],desktop:94,dest:[18,21,23,24,38,41,53,55],dest_creat:21,dest_data_set:[18,21,38,41],dest_data_set_memb:41,dest_dataset:41,dest_path:38,dest_stat:18,dest_volum:38,destin:[17,18,19,20,21,23,24,29,30,31,36,38,41,43],destination_attribut:21,destination_dataset:41,destinatt:31,destmem:21,detach:[105,117],detail:[0,4,6,7,8,15,21,41,42,57,61,71,73,89,93,94,98,100,101,103,104,105,106,107,108,109,111,112,117,123,124],detect:[29,41,70,85,100,105,116],determin:[0,4,5,6,7,8,13,19,21,23,25,31,32,36,38,41,43,50,51,69,70,71,82,83,84,88,89,94,107,124],dev1:[31,98],dev2:31,dev3:31,dev4:31,dev5:31,dev6:31,dev7:31,dev9:31,dev:[88,98,111,116,124],develop:[87,91,124],devic:[19,21,31,32,33,39,109,111,116,118],device_numb:[106,109,123],dfb2147a:[100,103],dfh:[7,17],dfs3139i:34,dfs3pu00:50,dfs3pu10:51,dfs4434i:50,dfs4810i:51,dfs671i:51,dfscp001:50,dfsdfxxx:[50,51],dfsmsdss:[18,19,38],dfsmsrmm:69,dfsort:32,dfsrrc00:[32,41],dfsvsmhp:[50,51],diagnost:[4,5,6,7,8,33,41,111,116],dialog:98,dict:[4,5,6,7,8,13,17,18,19,21,22,23,24,26,27,28,29,31,32,34,36,37,38,39,50,51,52,53,54,55,69,70,76,79,80,85,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],dictionari:[4,6,7,8,13,14,17,26,27,28,41,47,76,79,80,100,103,106,107,109,111,113,116,118,119,121,123,124],did:[31,41,69,98,124],differ:[0,4,6,7,8,13,16,18,21,22,24,29,36,41,42,48,50,57,67,70,85,107,121,124],difficulti:124,digit:[28,39,41,50,51],dir:[20,21,30],direct:[14,21,24,32,39,47,116],directli:[14,21,47,49,50,119],directori:[0,13,15,18,21,22,23,24,25,29,30,31,32,36,38,41,42,50,51,57,70,76,77,78,79,80,81,82,83,84,86,88,95,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],directory_block:[18,21,22,32,38],directory_dataset:50,directory_staging_dataset:50,disabl:[4,5,6,7,8,119,124],discard:[6,9],discord:92,discourag:[42,57],discov:98,discuss:[41,89,92],disk:[39,41,107],disp:[20,21,22,29,30,41],displai:[16,17,33,41,71,73,76,77,78,80,82,83,84,86,98,124],disposit:[20,22,30,32,50,51],disposition_abnorm:32,disposition_norm:32,disrupt:[47,119],dist:98,distribut:[42,57,87,88,95,98,124],divis:[14,47],dli:[50,51],dlord6:29,dmod:[20,41],dmp:103,dmy:27,dns:[107,111,116],doc:[0,14,16,41,47,60,67,95,98,99,124],docker:124,docs_build:98,docs_loc:98,docsloc:98,doctor_appointment_d:13,document:[1,3,4,6,7,8,9,11,15,16,20,21,23,24,29,30,31,34,36,41,42,45,48,49,56,57,58,60,61,62,65,67,69,71,73,74,75,87,89,92,95,96,99,124],doe:[0,13,14,15,18,21,22,24,25,30,32,36,38,39,41,47,49,50,53,55,69,70,85,98,100,106,107,109,111,113,115,116,117,118,119,121,123,124],doesn:[4,5,8,21,41,82,83,84,95],doing:[21,24],domain:[80,105,111,124],domain_config:105,domain_index:111,domain_nam:80,domain_rang:105,don:[10,24,31,32],done:[17,20,21,24,26,30,31,41,73,98,111,124],dopt:50,dot:88,dotal:34,doubl:[19,20,41],download:[42,57],dpm:[99,100,103,104,105,106,108,109,111,116,117,118,121,123,124],dpm_enabl:104,draft:98,drain:31,drive:[0,14,47,69,73],drop:[32,124],dropdown:88,ds1:[17,32],ds2:17,ds3:17,ds_name:[14,20,47],ds_name_2:20,dsed:30,dsedhelp:30,dsi:34,dskeylbl:32,dsmembr1:53,dsmembr2:53,dsmembr3:53,dsmembr4:53,dsn120:37,dsn130:37,dsn210:37,dsn3epx:33,dsn:[20,29],dsname:[7,14,47],dsncat:37,dsntep12:20,dsntep2:20,dsntype:32,due:[0,14,47,124],dummi:[27,29],dummy_dict:[14,47],dump:[19,50,111],dupact:4,duplic:[41,50,56,124],duplist:50,durat:[27,29,41],dure:[13,14,19,20,21,22,24,27,30,31,32,33,34,38,41,47,49,61,68,69,70,73,89,124],dynalloc:[41,54],dynam:[17,50,54,58,62,100,105,106,109,111,116,117,118,123],dynamic_allocation_dataset:54,dynamstatu:[4,5,6,7,8],dzp:19,e03d413a:116,e0ea33d6:116,e1274d16:105,e30bb920f912:70,e3a63476c2f8:121,e578:[100,103,105,109,111,116],e730:[4,5,6,7,8],e8c098cb:121,e8d8:39,each:[0,3,4,5,6,7,8,9,14,16,18,20,21,22,31,32,36,37,38,41,42,43,47,48,50,53,54,55,57,62,67,71,73,75,79,80,85,86,87,88,89,90,91,92,94,98,99,100,103,108,112,115,121,124],earlier:[41,88,124],easi:[0,71,73,75,87,89,98],easiest:0,easili:[0,31,41,89,124],ebcdic:[27,29,43],ec33017a:33,ec33018a:26,ecosystem:87,edc5129i:95,edd782f2:[116,118],edg:69,edit:[11,20,70,98],eee82e26937c:107,effect:[14,32,98,124],effort:87,eibfn:[4,5,6,7,8],eibfn_alt:[4,5,6,7,8],eight:21,either:[4,6,7,8,10,13,17,18,19,20,21,23,24,25,30,31,32,33,34,38,41,49,50,51,56,68,70,71,73,85,89,94,98],elaps:[33,41],element:[4,6,7,8,13,17,18,22,25,26,27,28,29,31,32,34,35,37,38,39,43,49,50,51,52,53,54,55,56,69,100,101,103,104,105,106,107,108,109,110,111,112,113,114,116,118,120,121,122,123,124],elev:95,elig:[4,5,6,7,8,51],email:[41,119],embed:41,emerg:41,empti:[18,21,26,29,36,41,50,52,53,55,98,100,106,109,111,113,116,118,119,121,123,124],emul:29,enabl:[0,20,22,30,32,35,40,41,50,51,87,88,89,94,105,107,111,116,121,124,125],encapsul:[31,125],enclos:36,encod:[11,13,16,20,21,24,29,30,32,36,38,41,43,57],encount:[32,41,95],encourag:[0,2,12,31,46,59,66,89,92],encrypt:[32,68,69,70],encryption_key_1:32,encryption_key_2:32,end2end:[98,124],end2end_mock:[98,124],end:[4,6,7,8,13,14,17,18,20,21,27,28,29,30,32,36,38,39,41,47,63,64,76,77,78,79,80,81,86,115],endpoint:94,enforc:[19,31,41],engin:[21,29,36],enhanc:[39,41,56,57,98,124],enrich:124,ensur:[10,14,17,18,20,23,24,30,31,38,39,41,47,95,100,103,105,106,107,109,111,113,116,117,118,119,121,123],enter:[0,63,64,68],enterpris:[0,14,41,42,47,56,57,87,95],entir:[19,22,41,51],entiti:17,entitl:0,entri:[4,5,6,7,8,17,27,29,31,32,39,41,124],entrypoint:[4,5,6,7,8],env:124,environ:[4,5,6,7,8,14,18,21,24,38,42,47,57,58,62,88,89,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],environment_var:[49,50,51,54],environmenterror:[14,47],eod:27,eof:[20,30],ep11:[100,105],equal:[4,6,7,8,25,31],equival:[4,5,6,7,8,14,41,47,50,54],errno:[14,47,95],error:[4,5,6,7,8,14,17,19,20,21,25,27,29,30,31,32,36,41,47,50,51,53,55,56,69,71,82,83,84,87,89,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],errorcod:[4,5,6,7,8],errormax:50,erroroper:[4,5,6,7,8],esa:39,escal:[17,20,23,30],escap:[33,34,36],esd:[21,22,32,50,51],essenti:[21,24,41],establish:[4,5,6,7,8],estim:27,etc:[13,20,21,24,25,29,30,32,36,71,85,88,91,98],euccn:43,eucjc:43,eucjp:43,euckr:43,euctw:43,evalu:[27,28,29,41],even:[15,19,21,41,102],event:41,everi:[20,30,41,124],everyon:41,everyth:18,exact:64,exactli:19,examin:[25,95,124],exampl:[0,3,10,12,16,41,43,57,88,89,91,95,98,99,124],example1:52,exampledbd:53,exce:17,exceed:27,except:[10,13,14,31,41,47,71,82,100,106,109,111,113,116,118,119,121,123,124],excl:[50,51],exclam:[27,29],exclud:[18,19,25,31,38,41,121,124],exclude_sourc:18,exclus:[4,6,7,8,12,17,32,38,49,50,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123],exec:[27,29,70,85],execkei:[4,5,6,7,8],execut:[0,3,10,11,13,14,15,16,17,18,20,21,22,23,24,25,27,28,29,30,31,32,34,36,38,39,41,42,47,48,49,51,53,54,55,57,67,82,83,84,85,89,98,107,124],executionset:[4,5,6,7,8],exempt:[21,24,36],exercis:[21,41],exist:[0,4,5,6,7,8,13,18,19,20,21,22,24,30,32,36,38,39,41,47,50,53,55,57,69,70,82,83,84,85,89,100,106,107,109,111,113,115,116,118,119,121,123,124],existingassign:[4,5,6,7,8],existingdescript:[4,5,6,7,8],existinggroup:[4,5,6,7,8],existingnam:[4,5,6,7,8],existingoverrid:[4,5,6,7,8],existingsystemgroup:[4,5,6,7,8],existingtyp:[4,5,6,7,8],existingusag:[4,5,6,7,8],existingvalu:[70,85],existingvers:[4,5,6,7,8],exit:[18,21,41,79,80,86],exitlib:54,expand:[18,29,30,40,41,49,107,111,116,119,124],expand_crypto_adapt:[111,124],expand_storage_group:[111,124],expanded_exclude_sourc:18,expanded_sourc:18,expans:18,expect:[13,14,21,22,25,39,41,47,53,55,67,69,79,80,86],expected_result:69,experi:41,expir:[113,119],explain:[9,12,14,41,47,71],explan:[0,29],explanatori:35,explicitli:124,exploit:31,express:[4,6,7,8,15,20,25,30,34,41,100,101,105,116,124],ext:[27,29],extend:[18,23,31,32,41,102,111,116,124],extens:[19,98,102],extern:[4,5,6,7,8,32,76,77,88],external_nam:[76,77,80],external_software_nam:77,extpref:25,extract:[27,28,29,38,41],extreq:25,eyj0b2tlmvhcmvyiiwici:68,eyj0exaioijkv1qilcjhbgcioijsuzi1nij9:68,eyu_cicsnam:[4,5,6,7,8],eyu_cicsrel:[4,5,6,7,8],eyu_reserv:[4,5,6,7,8],eyuda:[4,5,6,7,8],eyup2ki:[4,5,6,7,8],eyup2kv:[4,5,6,7,8],eyup2kw:[4,5,6,7,8],eyup2kx:[4,5,6,7,8],f02e2632:[116,118],f1b97ed8:111,f433:[103,109,111],f651:121,f76ac7fb8b82:119,f920:29,fabric:[100,116],face:0,facil:[16,18,38,39,41,49,50,51,65,69,71,72],fact:[0,16,19,20,99,100,103,105,106,107,109,111,113,116,117,118,119,121,123,124],factor:[0,119],fail:[4,5,6,7,8,9,17,20,21,22,24,26,28,29,30,32,36,41,52,69,70,71,89,116,117,119,124],fail_on_miss:24,fail_on_nodata:9,failur:[0,12,13,17,20,21,22,23,24,25,26,28,30,31,32,33,34,35,36,37,39,41,49,53,55,79,80,86,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],fall:[21,24,36],fallback:41,fals:[4,5,6,7,8,13,14,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,36,37,38,39,41,47,49,50,51,52,53,54,55,56,63,64,68,69,70,76,77,78,79,80,81,82,83,84,85,86,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],famili:[100,101,103,105,109,116],faq:[41,87],far:[14,47],fast:[26,32,41],favor:41,fba:[18,21,22,32,38,50,51],fcp:[100,103,106,111,116,118],fcp_120_san1_02:[100,103],fcp_124_san1_03:116,featur:[0,2,12,40,46,59,66,106,111,116,117,118],feb:27,februari:27,feedback:[4,5,6,7,8,9,41],feel:41,fetch:[11,16,18,21,31,40,41],fetchcnt:[4,5,6,7,8],fetchtim:[4,5,6,7,8],few:[0,124],ff000000:[4,5,6,7,8],ficon:[100,101,103,111,116,124],field:[0,29,32,41,49,52,53,54,55,69,111,124],fifo:32,file:[4,5,6,7,8,9,11,14,16,17,19,20,21,23,24,25,27,29,30,32,36,41,42,43,47,53,55,56,57,63,64,68,69,70,71,73,75,76,77,78,79,80,81,82,83,84,85,86,88,89,95,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],file_data_typ:32,file_nam:[17,20,21,23,30,31],file_with_your_certificate_chain:68,file_with_your_private_kei:68,filedata:32,filenam:[21,82,83,84],filenotfounderror:[21,31],filesi:31,filesystem:[13,20,21,31,38,85],filetag:[14,47],fill:[32,76,77,79,80,86],filter:[0,4,6,7,8,11,17,25,26,27,28,34,41,100,101,124],filter_wtor_messag:15,find:[4,11,16,21,29,36,41,70,95,124],fine:13,finish:[29,36,124],firmwar:[106,107,116,117,118],first:[7,13,19,20,21,23,24,25,29,30,31,32,36,37,41,50,51,89,92,107,124],firstmatch:30,fit:124,fix:[9,21,42,56,57,60,71,82,83,93,98,124],fixcat:75,fixtur:[14,47],flag:[14,18,21,31,34,47],flake8:[98,124],flashcopi:[32,41],flat:24,flexibl:[40,71,73,89,124],flow:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],fmid:[42,57],fnmatch:26,folder:[0,14,18,47],follow:[0,10,13,14,15,16,17,18,19,20,21,26,28,32,36,38,39,47,48,50,67,69,73,76,77,78,79,80,82,83,84,86,88,89,94,95,97,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],foo:[18,21,25,31,38],foo_archive_test:18,foo_bar_archive_test:18,foobar:119,forc:[0,17,18,20,21,22,30,31,38,41,88,107,119],force_complet:85,force_dynam:17,force_lock:[21,41],forcibl:85,fork:[0,124],format:[4,5,6,7,8,13,14,17,18,21,22,28,31,32,38,41,47,49,50,51,52,53,54,55,60,68,69,70,71,73,76,77,78,79,80,84,85,86,87,88,107,111,124],format_opt:[18,38],found:[4,5,6,7,8,9,18,20,21,22,24,25,27,28,29,30,32,37,38,39,41,70,85,88,95],four:[0,98],fqn:31,framework:[14,47,73],fridai:29,from:[0,4,5,6,7,8,9,10,13,14,15,16,17,18,19,20,21,22,23,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,43,47,48,49,50,52,53,54,55,56,57,58,63,67,70,71,77,78,79,80,81,82,83,84,85,86,87,88,93,94,95,98,99,102,105,111,115,116,117,121,124],from_encod:41,fs_type:31,fsum8976:[21,41],ftp:[111,116],fulfil:[103,116,118],full:[19,25,33,41,79,81,95,98,116,119,124],full_volum:19,fullapi:[4,5,6,7,8],fulli:[15,21,31,100,103,105,106,109,111,113,116,117,118,119,121,123],function_numb:124,function_rang:124,further:[12,41,42,57,89],futur:[2,12,14,41,46,47,59,66,69],ga1:97,ga2:97,galaxi:[0,9,41,56,60,71,87,93,95,98,124],galaxy_serv:88,gap:107,gatewai:[107,111,116],gather:[0,16,21,25,31,50,95,100,102,103,105,106,107,109,111,113,116,117,118,119,121,123,124],gather_fact:[63,64,76,77,78,79,80,81,82,83,84,86],gather_subset:26,gener:[9,14,17,20,21,22,23,27,30,31,32,37,41,45,47,48,50,51,52,54,69,70,71,76,79,80,81,86,87,95,98,106,116,117,118,124],genjcl:54,genjcl_input_dataset:54,genjcl_output_dataset:54,get:[0,4,6,7,8,9,13,14,17,30,31,34,47,75,87,88,89,92,98,99,106,109,111,113,116,118,119,121,123,124],get_cpc_io:124,get_fact:124,get_paramet:[4,6,7,8],gid:[21,31],gigabyt:25,git:[0,2,12,46,59,66,88,98,124],github:[0,9,41,56,60,71,87,88,89,95,98,124],give:[18,21,38],given:[18,21,25,27,30,33,34,38,39,41,63,64,70,76,77,78,79,80,81,82,83,84,86,98],glob:18,global:[69,70,85,111,116],goe:[12,21],going:41,good:89,gov:124,gracefulli:41,grant:41,granular:[71,73],greater:[4,6,7,8,21,23,24,25,28,29,41],greatli:62,grep:0,group:[0,4,5,6,7,8,9,18,21,27,29,30,32,36,38,63,69,75,89,99,103,107,111,118,119,121,124],group_var:89,gsam:50,gsamdbd:50,gsampcb:50,guaranteed_spac:21,guest:[14,47],guid:[0,2,42,57,92,95],guidanc:[9,71],guidelin:91,had:[41,124],halt:13,hamgmt0:[109,111],hamgmt:[109,111],handl:[13,14,20,32,36,41,42,47,57,70,85,124],handler:[75,124],happen:[31,95,107],hardwar:[96,97,121],has:[0,4,5,6,7,8,12,13,14,17,18,19,20,21,23,28,29,30,32,33,34,36,38,39,41,42,47,49,53,55,56,57,70,73,82,83,84,85,89,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],has_il:13,has_unacceptable_statu:[104,108,112],hash:32,hasp373:[27,29],hasp375:27,hasp395:[27,29],hat:[0,1,9,11,45,56,58,60,65,71,88,89,91,92,94,96],have:[13,14,17,18,21,22,25,29,30,32,34,38,41,47,49,50,63,64,69,76,77,78,79,80,81,82,83,84,86,88,94,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125],hba1:[106,111],hba:[99,111,116,124],head:39,held:19,hello:[13,20,25,27,28,29,36],help:[20,22,30,33,41,56,71,82,83,87,89,91,98],henc:51,here1:22,here2:22,here:[21,22,42,57,88,92],hexadecim:[39,107],hidden:124,hierarchi:31,high:[17,18,20,21,22,23,24,25,30,31,32,38,39,41],higher:[108,112],highest:[0,39],highlight:41,hill3:37,hint:126,hiper:[71,82],hipersocket:[99,101,109,124],hisoclass:121,histori:[41,113],hlq:[17,18,19,20,21,22,23,24,25,29,30,31,32,37,38,39,41],hmc1:102,hmc:[0,87,90,91,93,94,95,97,98,99,100,101,103,104,105,106,107,108,109,110,111,112,114,116,117,118,123,124,125,126],hmc_auth:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],hmc_host:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],hmc_verify_cert:124,hmrest:[111,116],hoc:95,hold:[19,76,79,80,81,86],holddata:[71,82],holdstatu:[4,5,6,7,8],home:[14,21,36,47,69,88],honor:[30,31],host1:20,host2:20,host3:20,host:[0,4,5,6,7,8,14,15,20,35,42,47,57,61,63,64,73,76,77,78,79,80,81,82,83,84,85,86,88,89,94,106,107,111,116,124],host_key_check:41,host_var:89,hostnam:[24,68,69,70,73,76,77,78,79,80,81,82,83,84,85,86,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],how:[2,4,5,6,7,8,10,12,14,25,31,32,41,43,46,47,54,57,59,62,66,70,75,85,89,90,92,124],howev:[0,2,12,14,19,31,46,47,59,66,94],html:[4,5,6,7,8,20,21,98,100],http:[0,4,5,6,7,8,10,30,63,64,68,69,70,82,83,84,85,88,98,100,124],http_statu:[4,5,6,7,8],http_status_cod:[4,5,6,7,8],httpd:21,httpstatu:69,hub:[0,9,41,56,60,71,74,87,93,98,124],hub_token:88,hurslei:[4,5,6,7,8],hw_name:26,hwsc0000i:34,hyperlink:41,hyphen:[88,100,102,103,105,106,107,109,111,113,116,118,119,121,123,124],i15rtsmm:[29,54,55],ibm:[1,2,3,4,5,6,7,8,9,10,11,13,14,15,16,20,21,23,24,25,26,29,30,31,32,39,40,41,42,43,45,47,48,56,57,60,61,62,63,64,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,86,88,89,91,92,94,96,97,98,99,124,125,126],ibm_zhmc:[88,96,98,99,115,124],ibm_zos_c:[1,9,88],ibm_zos_cor:[0,11,15,16,26,29,36,41,88,95],ibm_zos_im:[45,56,88],ibm_zos_sysauto:[58,60,63,64,88],ibm_zosmf:[65,67,69,70,71,76,77,78,79,80,81,82,83,84,86],ibmus:[5,7,27,69],ich70001i:[27,29],ick00001i:39,ick00002i:39,ick00091i:39,ick00700i:39,ick03091i:39,ick03096i:39,ick:39,ickdsf:39,iconv:[20,23,24,30,35,43],icsf:32,idcam:[32,42,57],idempot:[30,70,85,100,103,105,106,109,111,113,115,116,117,118,119,121,123,124],identif:34,identifi:[4,5,6,7,8,15,17,18,20,21,23,27,28,29,31,32,34,36,41,42,43,50,51,57,61,63,64,70,71,73,75,76,77,78,79,80,81,86,88,100,107],idl:119,ieb352i:27,iebcopi:[42,57],iebgen:[27,28,29,32],iee094d:15,iee457i:33,ief032i:[27,29],ief033i:[27,29],ief142i:[27,29],ief236i:[27,29],ief237i:[27,29],ief285i:[27,29],ief373i:[27,29],ief375i:[27,29],iefbr14:32,iefc001i:29,iefc653i:29,iefrder:50,iew2008i:29,iew2231i:29,iew2278i:29,iew2650i:29,iew2850i:29,iewl:29,ifl:[107,111,116],ifl_processor:111,igd100i:29,ignor:[0,17,18,19,21,24,25,29,30,31,32,36,38,41,50,68,69,70,85,88,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],ignore_error:41,ignore_sftp_stderr:[21,24,95],ikjeft01:[42,57],illustr:95,im5:34,im5h:34,im5hconn:34,im5hctrl:34,imag:[32,41,107,111,116],immedi:[31,88],immut:124,impact:18,implement:[32,41,98,124],impli:41,implicitli:[4,6,7,8,21,31],import_nam:[14,47],importlib:124,improv:[9,18,19,41,56,124],ims1501:54,ims15r:54,ims1:[14,29,47,50,51,52,54,55],ims2:52,ims3:52,ims_acb_gen:[48,56],ims_catalog_popul:[48,56],ims_catalog_purg:[48,56],ims_command:[48,56],ims_command_util:56,ims_dbd_gen:[48,49,56],ims_dbrc:[48,56],ims_id:[50,51],ims_member_data:52,ims_member_messag:52,ims_output:52,ims_psb_gen:[48,49,56],imsbank:[14,47,55],imsbg2:29,imsbld:[29,54,55],imsdb1:52,imsgrp1:37,imsgrp2:37,imsgrp3:37,imsplex:52,imsrc:52,imssun:25,imstest:25,imstestg:54,imstestl:[25,29,54],imstestu:[54,55],imsv:37,inact:[103,107,111,119,124],includ:[0,4,6,7,8,9,13,14,15,17,18,19,21,22,23,24,28,30,31,32,34,36,38,41,42,43,47,50,57,60,70,76,77,78,80,82,83,84,86,87,88,89,91,96,98,100,103,104,111,116,121,124],include_memb:121,include_modul:[76,77,78,79,80,81,86],include_rol:[63,64,82,83,84,85],include_unmanaged_cpc:104,inclus:105,incompat:[98,124],incomplet:18,inconsist:124,inconsistentscop:[4,5,6,7,8],inconsistentset:[4,5,6,7,8],incorrect:[41,95,124],incorrectli:[12,13,95,124],increas:[41,89,124],indataset:21,indent:[20,41],independ:[98,119,124],index:[7,20,25,39,41,53,98,100,105,106,109,111,116,124],indic:[7,17,18,19,20,21,24,27,28,29,30,31,32,33,34,49,50,51,52,68,69,70,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],indirectli:[49,119],individu:[0,21,24,31,36,41,53,55,71,73,76,80,90],ine8d8:39,infil:32,info:[69,73,77,79,89,107,116],inform:[0,2,4,5,6,7,8,9,12,14,17,21,23,25,27,28,29,30,31,33,34,36,37,39,41,42,46,47,49,50,52,54,57,59,61,66,70,71,73,76,78,79,80,81,85,86,88,89,106,107,109,111,121,123,124],infrastructur:124,inherit:121,init:[27,29,39,54],initi:[1,4,5,6,7,8,9,11,14,16,30,34,41,45,47,56,58,60,65,71,96,107,111,116,124],initial_memori:111,initial_processing_weight:107,inject:[14,47],inlin:21,inline_copi:21,input:[14,18,23,27,31,32,37,41,43,47,49,50,51,53,54,55,68,70,71,79,80,85,86,106,107,109,111,113,115,116,118,119,121,123,124],input_var:[79,80,86],input_vari:80,ins:[111,116],insecur:[4,5,6,7,8],insensit:[13,18,21,22,38,70],insert:[17,20,30,41,50,98],insertaft:[20,30,41],insertbefor:[20,30],insfil:[111,116],insid:[13,15,20,21,27,29,36,88],inspect:[14,41,47],instal:[1,4,5,6,7,8,9,10,31,39,41,42,57,61,71,73,84,87,89,94,95,98,107,124],installag:[4,5,6,7,8],installerror:[4,5,6,7,8],installtim:[4,5,6,7,8],installusrid:[4,5,6,7,8],instanc:[0,4,5,6,7,8,50,51,52,63,64,70,71,73,75,80,85,86,95],instance_action_nam:79,instance_descript:76,instance_info_json:77,instance_info_json_path:[77,79,81],instance_own:76,instance_provid:76,instance_record_dir:[76,77,78,80,86],instance_var_json_path:76,instance_variable_record:76,instead:[10,20,21,30,41,56,76,80,100,103,106,107,109,111,113,116,118,119,121,123,124],instream:29,instruct:[0,33,41,42,57,76,89,124],insuffici:95,integ:[7,13,27,28,29,43,100,103,105,106,107,109,111,113,116,118,119,121,123,124],integr:[0,24,41,61,89,92],intend:[0,18],interact:[1,10,11,41,45,58,73,96,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],interfac:[1,4,5,6,7,8,16,21,24,48,52,67,71,73,109,119],interfer:41,intern:[41,43,49,95],internation:43,internet:92,interpret:[14,36,41,47,95],interrupt:[50,107],interv:[79,80,85,86],intial:39,introduc:[33,41,124],introduct:92,invalid:[13,21,27,29,36,41,53,55,56,95],inventori:[14,21,29,36,41,42,47,49,50,51,54,57,60,61,63,64,69,70,73,76,77,78,79,80,81,82,83,84,85,86,124],inventory_hostnam:[70,85],investig:98,invoc:[29,52,98,115,124],invok:[32,36,41,52,119,124],invreq:[4,5,6,7,8],iodf:26,ioerror:95,ipl:[26,31,107,111,116],ipl_volum:26,ipv4:[111,116],ipv6:[111,116],irc:92,irlm:[50,51],irlm_id:[50,51],irr010i:[27,29],is_binari:[21,24],is_manag:104,isf031i:33,isinst:13,iso8601:20,iso8859:[23,24,29,32,43],iso:[20,30,43,111,116],isrtlist:50,issu:[2,12,21,32,34,36,46,59,66,95,98,124],item1:[14,47],item2:[14,47],item3:[14,47],item:[13,14,20,32,39,41,47,69,98,100,103,105,119,121],itemcategori:69,itemdescript:69,itemid:69,itemtyp:69,iter:20,its:[0,18,20,21,24,29,30,36,38,41,54,70,90,93,98,100,103,104,106,107,108,109,111,112,116,117,118,119,121,123,124,125],itself:[21,32,41,125],iycwemw2:[4,5,6,7,8],iyk3z0r9:[4,5,6,7,8,28],izuwf0145:70,izuwf0162i:70,j09:37,j42:37,j91:37,j93:37,j97:37,jcl:[11,16,20,21,27,28,32,36,41,54,70,85],jclout:54,jclpd:54,jes2:[26,27,29],jesjcl:[27,29],jesmsglg:[27,29,41],jesysmsg:[27,29],jinja2:[15,20,21,29,36,41,124],jm00:[27,29],job00134:[27,29],job00361:29,job01427:28,job12345:28,job12:28,job16577:28,job:[0,4,5,6,7,8,11,13,16,29,32,33,34,40,41,50,51,63,70,85,86],job_class:[27,28,29],job_id:[27,28,29,34,41],job_nam:[27,28,29,34,41],job_stat:86,job_submit:41,jobparm:29,join:[41,77],jop:41,jose:13,jrm:[27,29],json:[0,20,41,56,68,69,70,71,73,76,77,78,79,80,81,82,83,84,85,86],json_queri:77,just:[98,115,124],jvmclass:[4,5,6,7,8],jvmgrp:[4,5,6,8],jvmserver:[4,5,6,7,8],jwt_token:[68,69,70],jycqqfni:36,kbyte:[27,29],keep:[21,29,30,32,36,50,51],keep_trailing_newlin:[21,29,36],kei:[4,5,6,7,8,13,21,22,32,38,53,55,56,68,69,70,85,88,95,100,103,106,107,109,111,113,116,118,119,121,123],kept:29,ket678:39,ket987:39,key_label:32,key_length:[21,22,32,38],key_offset:[21,22,32,38],keycd1:32,keycd2:32,keydata:[4,5,6,7,8],keygen:[14,47],keylab1:32,keylab2:32,keyword:[0,15,41,51],kilobyt:25,kind:[32,98],know:[18,21,38,98],knowledg:[116,117,118],knowledgecent:[4,5,6,7,8],known:[32,75,87,88,89,98,111],ksd:[21,22,23,24,32,38,50,51],kwarg:13,label:[32,39,41,88],lang:[14,47],languag:[4,5,6,7,8,42,43,57],laps:29,laptop:94,larg:[22,25,32,41,50,51],last:[7,19,20,25,27,28,29,30,41,107,124],lastli:21,later:[0,9,10,14,27,28,29,41,42,47,50,56,57,69,70,71,73,88,94,106,116,117,118,124],latest:[2,12,18,41,42,46,50,57,59,66,88,92,95,98,124],latin:43,lba:[111,116],ldap:[119,124],ldap_server_definition_nam:119,ldap_server_definition_uri:119,lds:32,lead:[18,19,21,29,36,38,41,101,108,112,124],learn:[0,2,12,41,46,59,66,71,88,89,90,92,93,94,95],least:[25,27,61,73,98,107,124],leav:[38,39,41,52],leaveconflict:[70,85],left:[0,18,30,38],length:[4,5,6,7,8,17,18,21,22,23,32,38,41,50,51,63,64,113],less:[4,6,7,8,10,25,29,31,39,102,124],letter:[25,43,89],level:[13,15,17,18,20,21,22,23,24,25,30,31,32,38,39,41,60,63,64,69,89,98,107,124],leverag:[10,13,41,94],lg09:105,lib:[14,20,25,47],liberti:30,libnam:17,libpath:[14,47],librari:[4,5,6,7,8,11,14,16,18,20,21,22,25,32,41,47,49,50,51,53,55,56,71,100],librarydsn:[4,5,6,7,8],life:94,lifecycl:[96,119],lightweight:[68,69,70],like:[0,14,18,19,21,27,37,38,47,71,88,95],limit:[4,5,6,7,8,14,31,41,47,100,103,105,106,109,111,113,116,117,118,119,121,123,124],line:[0,14,16,17,21,24,27,29,30,31,32,36,37,41,47,52,67,99,124],line_comment_prefix:[21,29,36],line_statement_prefix:[21,29,36],linear:[18,21,22,38],link:[0,21,28,39,53,55,60,87,91,98,124],linkcbl:28,linkcheck:98,linkjob:28,linklib:17,linux:[103,108],linuxon:[96,124],lise:124,list:[4,5,6,7,8,13,14,17,18,19,21,22,24,25,26,27,28,29,31,32,33,34,35,36,37,38,39,41,42,43,47,49,50,51,52,53,54,55,56,57,69,71,75,84,88,89,92,94,98,99,100,102,103,105,106,107,109,111,113,115,116,117,118,119,121,123,124],listcat:32,listdsd:37,listen:30,liter:32,littl:89,llq:[20,29],load:[20,21,41,50,75,105,107,111,116],loadlib:[21,41],loadpoint:[4,5,6,7,8],local:[0,4,14,15,21,24,27,28,29,34,36,38,47,53,55,69,79,98,119,124],local_file_backup:21,local_follow:21,localfil:7,localhost:[10,73,94,124],locat:[0,4,5,6,7,8,20,21,22,23,27,28,29,30,31,39,53,55,68,69,70,80,85,86,88,89,100,105,116],locfil:7,lock:[107,111,116,119,121],log1:51,log:[18,21,24,27,28,29,33,38,41,43,50,51,89,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],log_fil:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],logger:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],logic:[4,5,6,7,8,19,31,32,41,49,50,51,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],login:119,logon:69,longer:[18,21,29,41,115,124],longrun:29,look:[14,30,41,47,70],lookup:[20,77],loop:[20,39,119,124],loss:[21,32,41],lossless:18,lost:[22,31],low:25,lower:41,lowest:0,lpar1:[107,108],lpar2:107,lpar:[99,103,121,124],lpar_list:108,lpar_nam:26,lpastat:[4,5,6,7,8],lpp:[13,14,47,95],lrecl:[18,29,32,38],lstrip_block:[21,29,36],ltpa:[68,69,70],ltpa_token_2:[68,69,70],luke:13,lun:111,m12:37,m32:37,m63:37,m82:37,mac:[109,111],mac_address:124,machin:[21,24,36,38,39,41,94,96,124],maclib:[53,55],maco:124,macro:[53,55],made:[4,5,6,7,8,9,27,32,33,34,36,41,43,49,60,68,69,70,85,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],magicmock:[14,47],mai:[0,13,14,17,18,20,21,26,30,32,33,36,38,39,41,47,69,70,76,77,78,80,86,88,98,100,103,106,107,109,111,113,116,118,119,121,123],mail:92,main:[32,98],maintain:[49,124],mainten:[49,73],maintenenac:49,major:[98,124],make:[0,2,8,9,12,14,18,32,34,36,46,47,49,56,59,66,95,98,124],manag:[0,1,4,5,6,7,8,9,16,17,18,19,21,24,25,29,31,32,36,38,39,40,41,43,50,51,52,54,65,69,70,71,72,74,75,76,77,78,80,81,85,87,89,96,97,99,100,101,102,104,105,106,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123,124],managed_acb:[50,51],managedacb:50,management_class:[50,51],mani:[0,15,43,61,76,77,78,80,86,89],manifest:0,manner:115,manual:[70,76],manullai:76,map:[4,5,6,7,8,20,32,54,88],mar:29,march:29,margin:32,mark:[14,17,19,20,31,41,47],markdown:124,marker:[17,20,21,29,31,36,54],marker_begin:20,marker_end:20,mask:[109,111],mass:37,master:[17,98,107,111,116,124],match:[16,17,18,19,20,21,22,24,26,27,28,30,32,34,38,39,41,51,53,55,69,100,101,107,124],materi:[62,67,75,91,99],matrix:98,max:[29,41,105,113,116,119],max_error_msg:50,max_rc:[29,37,41,54],maxi:29,maximum:[19,29,32,33,37,39,41,54,63,64,85,100,105,107,111,116],maximum_memori:111,mbr:29,mc2cnam:25,mcat:17,mean:[0,7,18,21,26,29,31,32,34,38,52,105],meant:[13,41],measur:[18,19,21,22,29,32,38],mechan:[0,98],media:[111,116],mediacent:71,meet:[13,21,60],megabyt:25,mem:[17,20],member1:22,member2:22,member:[13,17,20,21,22,23,24,25,29,30,31,32,41,50,51,53,54,55,90,121],member_list:[53,55,56],member_nam:51,memlimit:29,memori:[96,107,111,116],merg:[32,49,98,124],messag:[4,5,6,7,8,16,17,20,21,24,25,28,29,30,31,33,35,36,39,41,49,50,51,52,53,54,55,69,70,76,77,78,80,82,83,84,86,87,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],message_filt:34,message_id:34,message_text:34,messageid:69,messagetext:69,met:[14,47,69],metadata:[50,98,124],method:[4,5,6,7,8,24,32,69,124],methodolog:0,mgmt1:116,mgmt1_mgmt1:[116,118],middl:19,middlewar:[65,78,79,80,81],might:[43,49,71,83],migrat:[41,124],mileston:98,min:[27,29,105,113,119],minidisk:[16,41],minim:[14,47,94],minimum:[0,94,98,107,111,116,124],minor:[60,98,124],minor_chang:41,minu:39,minut:[27,29],miss:[14,18,21,24,35,36,38,41,47,71,75,98,124],missing_critical_updates_respons:82,missing_critical_updates_response_fil:82,missing_fixcat_updates_respons:83,missing_fixcat_updates_response_fil:83,mitig:124,mix:[21,38],mixtur:22,mlq:20,mnew:98,mnu:98,mock:[98,124],mocked_hmc_z14:124,mocked_inventori:124,mocked_vault:124,mocked_z14_class:124,mocked_z14_dpm:124,mocker:[14,47],mod:32,mode:[18,20,21,24,31,32,38,39,41,50,51,70,89,99,100,101,103,104,105,106,107,108,109,111,112,116,117,118,121,123,124],model:[37,39,100,101,102,103,104,105,106,107,108,109,111,112,113,116,118,119,121,123],model_d:41,modif:[13,41,49,89],modifi:[0,20,30,41,50,95,98,107],modstat:50,modul:[1,9,10,11,13,17,18,19,20,21,22,23,24,25,26,27,29,30,31,32,33,34,35,36,38,39,43,45,49,50,51,52,53,54,55,56,65,68,69,70,71,73,85,87,88,91,92,93,94,96,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],module_path:[14,47],module_stderr:[14,47],module_util:[13,14,41,47],moment:126,monitor:[29,40],month:25,more:[0,4,5,6,7,8,10,12,13,15,20,21,22,25,27,28,29,31,33,34,35,36,37,41,42,49,50,56,57,60,61,70,71,79,84,85,88,89,93,94,95,98,102,103,124],most:[0,18,20,23,24,29,30,41,71,73,92,95,98],mount:[16,20,41],mount_opt:31,mountpoint:[20,31],move:[31,32,124],movement:31,mozilla:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],msg:[17,20,21,24,25,27,28,29,30,31,36,39,41,49,50,51,53,54,55,69,76,77,78,80,82,83,84,86,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],msg_code:[27,28,29],msg_txt:[27,28,29],msgclass:[27,29],msglevel:[27,29],msgprt:32,multi:[16,32,41,119],multipl:[4,6,7,8,13,14,18,21,22,25,28,32,47,50,51,52,53,54,55,73,80,86,89,115,124],must:[0,4,5,6,7,8,9,10,13,14,15,17,18,19,20,21,22,23,25,28,29,30,31,32,33,36,38,39,41,42,47,49,50,51,57,61,69,73,80,82,83,84,85,86,88,89,94,98,100,101,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123,125],mustgath:95,mutual:[4,6,7,8,12,17,32,38,50,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123],mutually_exclus:13,mv27:34,mv29:34,mv2h:34,mvscmdauth:95,mvscmdmsg:95,mvssys01:31,my_:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],my_adapter_nam:100,my_certs_dir:115,my_cpc_nam:[100,103,105,106,107,109,111,116,117,118,123],my_first_partition_nam:105,my_hba_nam:106,my_hmc_auth:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123],my_hmc_host:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],my_hmc_password:115,my_hmc_userid:115,my_lpar_nam:107,my_nic_nam:109,my_partition_nam:[105,106,109,111,117,123],my_password_rule_nam:113,my_second_partition_nam:105,my_storage_group_nam:[116,117,118],my_storage_volume_nam:118,my_us:115,my_user_nam:119,my_user_role_nam:121,my_vfunction_nam:123,mycobol:21,mydata:22,mygrp:7,myhlq:[19,32],mypgm:32,myprog:7,myuser:[14,32,47],myvar:76,myvol1:19,myvol2:19,myworkflow:[70,85],name:[0,4,5,6,7,8,9,12,13,14,15,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,41,43,47,49,50,51,52,53,54,55,61,63,64,68,69,70,76,77,78,79,80,81,82,83,84,85,86,88,89,95,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],namespac:[15,88,98],nation:39,navig:[0,14,47,93],necessari:[13,49,73,89],ned:39,need:[10,13,14,20,23,24,25,26,29,30,31,32,36,41,47,50,53,55,57,69,70,71,76,77,78,79,80,81,82,83,84,85,86,88,89,94,98,105,106,107,109,111,115,121,123,124],neg:[7,25],neither:[19,21,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],nest:[4,6,7,8,13],netview:[63,64],network:[100,107,109,111,116,125],network_adapter_port_uri:109,never:41,newcopi:4,newcopycnt:[4,5,6,7,8],newcpc:104,newer:[41,124],newli:50,newlin:[21,29,32,34,36,41],newline_sequ:[21,29,36],newslett:92,next:[70,103,107],nic1:[109,110],nic:[99,111,116,124],nic_list:110,nicknam:[70,80,82,83,84,85,86],nist:124,nnew:98,no_log:115,noautomov:31,nocopi:[4,5,6,7,8],nod:39,node:[0,3,16,18,22,29,36,38,40,41,48,67,69,70,71,85,88,89,95],nodeck:29,noindex:39,nolimit:29,nolist:29,non:[18,21,22,24,25,31,32,38,39,41,76,77,78,80,86,124],nonblock:32,none:[4,5,6,7,8,13,14,17,22,28,29,31,39,47,49,107,111,116,124],nonexist:[18,19,21,41],nonresid:[4,5,6,7,8],nonvsam:25,nonzero:52,noqa:124,normal:[31,32,41,50,51,95,107,124],normal_disposit:[50,51],nosecur:31,nosetuid:31,notappl:[4,5,6,7,8],notdefin:[4,5,6,7,8],notdynam:[4,5,6,7,8],note:[0,13,14,19,22,26,27,39,41,42,47,57,87,88,89,93,95,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,119,120,121,122,123,124],noteworthi:41,notext:31,notic:24,notif:[41,70,85],notifi:[27,29,89],notrequir:[4,5,6,7,8],noverifi:39,noverifyofflin:39,now:[14,20,30,41,47,98,124],nowait:31,nrd:33,nucleu:[49,50,51,54],number:[0,4,5,6,7,8,13,17,18,20,21,22,25,26,27,29,30,32,33,34,37,38,39,41,42,50,51,57,61,68,69,70,73,76,77,78,79,80,81,82,83,84,85,86,105,107,109,111,115,116,118,124,125],numer:[4,5,6,7,8,13,27,28,29,32,43,50,51,113],nvd:124,oa59461:61,oappend:32,object:[12,14,21,22,38,41,47,69,76,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123,124],objectid:86,obtain:[17,20,23,30,37,71,77,78,89,124],occasion:41,occur:[4,5,6,7,8,21,31,33,34,39,41,49],ocreat:32,octal:[18,21,32,38],ocur:36,oexcl:32,off:[0,51],offer:[1,9,11,41,43,45,56,58,60,65,71,87,90,91,94,96],offici:[0,21,29,34,36],offlin:[33,39,50,51],offset:[21,22,29,32,38],often:[0,12,13,41,94],old:[21,29,32,50,51,124],older:[95,101,102,108,110,112],omit:[4,5,8,50,70,85,100,103,106,107,109,111,113,116,118,119,121,123],ommit:50,omvs0000:33,omvsadm8:51,omvsadm:[27,29,31,37,55],onc:[98,111,115,116,119,124],one:[0,4,5,6,7,8,9,13,14,17,18,19,20,21,22,25,27,32,34,35,37,38,41,47,60,61,70,71,73,84,85,87,88,94,102,111,115,124],ones:[107,124],onli:[0,8,13,14,18,19,21,22,23,25,26,27,29,30,31,32,36,38,41,42,47,49,50,51,53,54,55,57,69,70,71,73,76,82,83,84,85,98,99,100,101,102,103,104,105,107,108,110,111,112,116,117,118,119,121,124],onlin:[39,50,100,105,116],online_batch:[50,51],onoctti:32,ononblock:32,onto:31,open:[2,10,11,12,14,18,20,21,22,23,27,28,29,30,31,32,41,42,45,46,47,56,57,59,66,74,90,95,98],openid:88,openssh:[14,42,47,57,94],oper:[4,5,6,7,8,11,13,14,15,16,17,18,19,21,22,27,29,30,31,34,39,41,42,47,52,53,55,57,58,61,62,63,64,65,67,68,69,82,83,84,85,87,89,90,96,98,99,100,102,103,105,106,107,109,111,116,117,118,121,123,124],operand:15,operator_action_queri:41,opercmd:17,oprat:[108,112],opt:31,optim:24,option:[0,4,5,6,7,8,9,12,14,17,18,20,21,22,23,26,29,30,31,32,33,35,36,37,38,39,40,41,42,43,47,49,50,51,52,53,55,57,61,70,73,79,80,85,86,88,89,98,104,107,115,121,124],orchestr:[0,87],order:[0,21,22,29,36,41,88,98,100,115,124],ordonli:32,ordwr:32,org:98,organ:[18,21,38,89],origin:[17,21,22,23,30,31,32,36,41,54,98,107],original_nam:32,orphan:41,os_ipl_token:[107,124],os_setup:124,osa:[101,103,109],osd:[101,109,111],osd_128_mgmt_net2_30:[109,111],osm1:103,osm:103,osmf:[0,67,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,90,91,93,94,95],osync:32,other:[4,6,7,8,9,10,13,14,19,20,21,22,27,29,30,32,39,41,47,51,61,69,71,75,76,78,79,80,81,82,87,88,95,100,102,103,105,107,115,119,121,124],otherwis:[4,5,6,7,8,14,18,19,20,21,25,28,29,30,36,38,39,41,47,51,70,82,83,84,100,107,116,117],otrunc:32,our:[0,14,30,41,47,89,95,106,109,124],out1:32,out2:32,out3:32,out:[0,14,23,26,32,47],outcom:52,outdataset:21,outfil:32,outlin:[12,21,46],output:[11,14,16,17,18,23,24,28,29,32,33,37,38,39,41,47,50,51,52,53,54,55,56,70,82,83,84,85,88,95,124],output_dir:36,outputfil:32,outputfilevalu:[70,85],outstand:34,over:[0,10,14,21,41,47,49,50,51,54,69,102],overal:124,overflowout:32,overlap:13,overrid:[0,4,5,6,7,8,17,18,20,21,22,23,24,30,31,32,38,39,41,51],overridden:[0,41],overview:[0,14,47],overwitten:[53,55],overwrit:[19,23,41,113,119,121],overwritten:[20,24,50,82,83,84],own:[0,14,15,18,21,30,38,47,88,90,119,124,125],owner:[18,21,27,28,29,31,32,36,38,70,76,85],ownership:[18,31,38],owronli:32,p000a218:121,p2ss01:29,pa1:[42,57],pack:18,packag:[88,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],pad:39,page:[0,27,31,32,39,42,43,57,92,98,124],pair:[14,36,47,53,55,56],paramet:[0,3,9,13,14,41,47,48,60,67,76,77,78,79,80,81,82,83,84,86,98,99,124],parametererror:124,parametr:[14,47],parent:[18,21,38,100,101,105,107,108,109,110,111,112,113,116,118,119,121],parm:[27,29,32,41],parmlib:[20,26,31],pars:[13,14,20,41,47,54],parsabl:56,parse_arg:13,parser:[12,13,18,21,38],part1:[103,110,111,121],part2:[103,121],part:[1,9,11,14,19,29,41,45,47,56,58,60,65,71,96,124],parti:[68,69,70],particip:31,particular:[4,5,6,7,8,13,19,20,27,29,30,31,34,43,47,95],particularli:41,partit:[17,20,21,22,23,24,25,29,30,32,41,53,55,96,99,100,103,107,108,110,116,118,121,124],partition1:[110,112],partition_link_uri:124,partition_list:112,partition_nam:[105,106,109,110,117,123],pass:[4,5,6,7,8,13,14,18,21,29,30,31,36,38,41,47,53,55,69,76,80,95,124],passthrough:41,password:[4,5,6,7,8,41,63,64,68,69,70,76,77,78,79,80,81,82,83,84,85,86,99,100,101,102,103,104,105,106,107,108,109,110,111,112,115,116,117,118,119,120,121,122,123,124,125],password_rul:[113,114],password_rule_nam:119,password_rule_uri:119,passwordless:41,past:[41,102],patch:[14,47,88],patched_method:[14,47],path:[13,14,17,18,20,21,23,24,29,30,31,32,36,38,41,47,53,55,69,76,77,78,79,80,81,82,83,84,86,88,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],path_of_security_requir:69,path_to_inventori:[14,47],path_to_modul:[14,47],pathmod:32,pathnam:[20,23,30,32],pathopt:32,pattern:[13,14,15,16,17,18,19,20,25,26,27,30,32,34,41,47,48,67,89,101,119,120,124],paus:[41,70,111,124],pax:[18,38,41],pbr:124,pchid:[101,103,124],pds:[14,22,32,47],pds_pattern:25,pdse:[18,20,21,22,23,24,25,29,30,32,38,41,50,51,53,55],pem:[4,5,6,7,8,68,69,70,85],pend:[29,107],peopl:98,pep8:[56,124],pep:124,per:[0,20,32,111,116],percent:[19,70],perform:[0,1,3,5,6,7,8,13,14,16,18,19,21,22,24,26,27,29,31,32,35,38,39,41,42,47,48,50,51,53,55,57,67,69,70,76,79,80,81,85,86,95,98,105,107,111,115,116,117,118,124],perform_import:[14,47],period:[2,12,21,46,59,66,85],perman:32,permiss:[14,18,19,21,36,38,41,47,69,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123],permit:[7,39,41,101,108,111,112,115,116],permit_ecc_key_import_funct:124,persist:[17,31,32],person:13,pgm:[27,28,29,32,52],pgm_input:36,pgm_result:36,pgrjusecount:[4,5,6,7,8],ph12143:71,ph28089:[32,41],ph41248:71,ph47050:71,ph47746:71,ph52813:71,physic:[19,29,31,39,41,49,100,105,116],pick:124,pin:124,ping:[11,13,16,95],pip3:[14,47],pip:[10,14,47,98,124],place:[4,6,7,8,13,19,24,39,41,49,50,51,55,88],placement:[41,50],plai:19,plain:21,plan:20,platform:[0,4,5,6,7,8,29,42,57,87,94,96],playbook:[3,9,10,15,16,17,20,21,23,26,29,30,36,41,48,56,60,61,62,67,71,73,75,76,77,78,79,80,81,82,83,84,85,86,87,88,92,94,99,124],playbook_dir:[21,29,36],pleas:[0,19,29,42,57,70,71],plex1:[4,5,6,7,8,52],plex2:52,plex:[52,61],plu:[100,116,119],plugin:[0,11,14,41,47,73,87,88,92,124],point:[20,27,29,41,43,49,50,51,63,64,76,77,78,79,80,81,86,88],polici:[41,58],poll:[79,80,86],pong:[5,35,95],pongalt:[4,5,6,8],pongbundle_1:5,pool:[50,51],pop:98,popul:[30,50],port:[4,5,6,7,8,13,30,41,42,57,61,63,64,68,69,70,73,76,77,78,79,80,81,82,83,84,85,86,100,106,107,109,111,116,118,124],portabl:[18,38],portion:39,posit:[27,28,29,30,32,41,95],posix:[14,47],possibl:[25,27,28,29,41,100,103,106,107,109,111,113,115,116,118,119,121,123,124],post2:124,post:[5,9,124],postcomp:[32,41,49],potenti:[4,6,7,8,19],pp0l6p:17,pprint:[14,47],practic:89,pre:[0,10,39,41,70,85],prealloc:20,prebuilt:49,preced:[21,29,36,41,49,50,51,54],precend:21,precomp:[32,41,49],predefin:20,predetermin:41,preexist:50,prefix:[18,21,22,29,32,36,38,109,111],prepackag:88,prepar:98,prepend:[20,41],prerequisit:[12,46,56,98,124],presenc:[35,41,124],present:[13,14,17,18,19,20,21,22,25,30,31,36,41,47,100,106,109,113,116,118,119,121,123],preserv:[18,21,22,38,41],pretti:98,prevent:[9,31,41,50],preview:124,previou:[18,38,41,88,98],previous:[31,39,41,42,50,60,77,88,115,124],primari:[18,21,22,32,38,39,50,51],primarili:[20,30],primary_j:26,primary_log_dataset:[50,51],primary_spac:41,primary_unit:[50,51],print:[14,17,21,27,29,36,47],print_duplicate_resourc:50,print_inserted_resourc:50,printabl:41,prior:[22,41,98],priorit:41,prioriti:[27,28,29,41],prioritis:[4,5,6,7,8],privat:[0,4,5,6,7,8,13,19,32,63,64,68,69,70,76,85],private_galaxi:88,private_token:88,privileg:[17,20,23,30,32],prmaabak:31,problem:[32,41,111,116],proc1:[27,29],proc:29,proce:[42,54,57,73],procedur:[29,63,88],proceed:[34,53,55],process:[12,13,14,19,20,21,22,27,29,30,32,36,37,39,41,46,47,50,51,53,55,70,79,85,88,107,111,116,124],processor:[107,111,116],procl8b:13,proclib:[13,24,50,51],procstep:[27,29],produc:[0,18,21,24],product:[0,42,57,61,71,73,76,95],product_mod_level:26,product_nam:26,product_own:26,product_releas:26,product_vers:[26,76],profil:[17,20,24,30,39,69,103,107],prog001:17,prog00:20,progdef:[4,5,6,7,8],program:[0,1,4,5,6,7,8,11,13,16,18,20,21,22,27,28,29,31,36,38,39,41,42,45,49,50,52,53,55,57,107],program_nam:[27,28,29,32],programm:[69,100,116,117,118,119],progress:[70,88],progtyp:[4,5,6,7,8],proivd:76,project:[31,88,98,124],promot:[56,124],prompt:[41,61,63,64,68,73,76,77,78,79,80,81,85,86],promptli:22,propag:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],proper:[14,32,41,47,71],properli:[41,71,73,95],properti:[25,41,70,71,77,85,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123,124],proport:25,protect:[17,32,39,69,115],protocol:[21,24,36,63,64,88],provid:[0,3,4,5,6,7,8,9,12,13,14,17,18,19,20,21,22,23,24,25,26,27,29,30,31,32,36,37,38,41,42,47,50,51,52,54,57,60,61,62,63,64,67,70,71,73,75,76,77,78,79,80,81,82,83,84,86,87,88,96,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],provis:[0,14,29,47,65,67,71,73,74,75,76,77,78,81,87,89],proxi:[82,83,84],proxy_zmf_password:[82,83,84],proxy_zmf_us:[82,83,84],psb1:49,psb2:49,psb3:49,psb:[45,48,49,50,51],psb_lib:[49,50,51],psb_name:[49,55],psbgen02:55,psbgen:[55,56],psbgenl:55,psblib1:49,psblib2:49,psblib:[49,50,51,55],psw:[107,111],ptf:[42,56,57,61,71,82],publish:[0,71,75,80,86,98,124],pull:98,punch:[27,29],pure:31,purg:[33,41,48],purpos:[14,47,98],push:98,put:[4,5,6,7,8,9,21],pwrule_list:114,pycodestyl:124,pycrypto:124,pyflak:124,pylint:[98,124],pypi:124,pyt:[42,57],pytest:[12,46,98,124],python3:[14,36,47],python:[1,10,11,13,14,18,34,35,36,41,45,47,56,71,73,94,96,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],python_path:[14,47],pythonpath:[14,47],pyyaml:124,pyz:[14,47],quaiti:124,qualifi:[13,15,17,18,19,20,21,22,23,24,25,29,30,31,32,38,39,41],qualifier_pattern:13,quasir:[4,5,6,7,8],queri:[3,4,5,6,8,11,16,34,41,52,102],question:19,queue:[27,28,29,41],queue_posit:[27,28,29],quickli:88,quot:[14,18,20,21,33,36,38,41,47],quotat:[14,20,33,47],r0101894:29,r0101895:29,ra000:29,race:[21,41],racf:17,rad:37,rain:13,rais:[0,13,14,26,41,47,95,124],ran:[14,27,28,29,47],random:[17,20,22,23,30,31],randomli:[20,21,31],rang:[4,6,7,8,28,39,88,105],rather:70,raw:[19,22,32,37,39,56],reach:41,read:[14,20,23,27,29,30,31,32,39,41,42,43,47,50,57,69,70,85,89,91,98],read_onli:32,read_writ:32,readabl:19,readi:[32,34],readm:[9,41,42,57,71],readonli:31,readthedoc:100,real:[27,29,124],realloc:41,realm:88,reason:[4,5,6,7,8,52],rebuild:49,receiv:[13,18,21,33,37,38,41,49,54,70,85],recent:124,recfm:[18,29,38],reclgth:32,recogn:124,recommend:[0,12,13,14,26,39,41,42,47,56,57,70,76,77,78,80,86,98],recon1:54,recon2:54,recon3:54,recon:54,reconnection_retri:41,record:[4,5,6,7,8,9,18,21,22,27,29,31,32,36,38,41,48,53,54,55,76,77,79,80,86,107,111,116],record_count:[4,5,6,7,8,27,29,32],record_format:[18,21,22,32,38,50,51],record_length:[18,21,22,32,38,50,51],recov:19,recover:19,recoveri:[17,20,30,31,32,41,50,51,54],recreat:[18,21,41,50],red:[0,1,9,11,45,56,58,60,65,71,88,89,91,92,94,96],redhat:[88,98],redirect:95,reduc:[26,41,115,124],ref_dat:25,refer:[0,4,5,6,7,8,14,20,21,23,24,25,26,27,29,30,32,36,39,42,47,49,53,55,57,60,61,62,63,64,67,75,76,77,78,79,80,81,82,83,84,86,87,88,89,91,94,95,98,99,124],referenc:[25,30,32,41,51,80,86,119,121,124],reflect:41,regardless:[13,21,34,107],regex:[20,30,34],regexp:30,region:[4,5,6,7,8,9,10,29,50,51],regist:[29,35,69,70,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],registri:[71,76,77,79,81],regular:[20,25,30,32,34,41,101],regularli:89,reject:[107,124],rel:[21,31,41],relai:92,relat:[0,4,5,6,7,8,9,21,27,28,29,32,41,70,85,95,124],relatedassign:[4,5,6,7,8],relateddescript:[4,5,6,7,8],relatedscop:[4,5,6,7,8],relationship:[49,53],releas:[14,42,47,57,73,87,95],release_:98,release_m:98,release_not:98,relev:[52,98],reli:[20,23,24,29,30,36,43,94],reload:[21,29,36],remain:[18,21,31,38,39,41,100,103,105,106,109,111,113,116,118,119,121,123,124],remot:[0,17,18,20,21,23,24,29,30,36,38,41,53,55,67,69,73,82,83,84,95,98,119],remote_cmd:36,remote_src:[21,36,38,41],remote_zmf_password:[82,83,84],remote_zmf_us:[82,83,84],remotenam:[4,5,6,7,8],remotesystem:[4,5,6,7,8],remount:31,remov:[6,9,16,18,20,21,22,29,30,31,36,41,51,71,75,76,98,111,116,124],removecnt:[4,5,6,7,8],renam:[17,20,30,31,39,41,100,124],render:[21,29,36],renov:124,repeat:0,repeatedli:[17,20],replac:[14,17,20,21,22,30,32,41,47,53,55,56,119],replace_acb:50,repli:[34,41],replic:[32,41,113,119,121],repo:[98,124],report:[29,41,73,82,83,84,124],repositori:[0,5,9,32,41,60,71,74,88,89,92,95,124],repres:[1,4,6,7,8,11,14,20,30,43,45,47,51,58,65,87,96,98,102,121],represent:[43,107],repro:[21,32],req:[0,98],request:[0,2,4,5,6,7,8,9,10,12,14,21,22,31,32,34,46,47,59,66,69,71,77,79,80,82,83,84,86,98,107,117,124],requestmethod:69,requests_ca_bundl:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],requesturi:69,requir:[4,5,6,7,8,9,12,14,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,35,36,37,38,39,41,42,43,47,49,50,51,52,53,54,55,57,60,61,63,64,67,68,70,71,72,73,76,77,78,79,80,81,82,83,84,85,86,87,88,89,93,95,98,115,124,125],requisit:10,res820:26,rescount:[4,5,6,7,8],reserv:[0,13,111,116],reset:[31,103,107,115,124],reset_clear:[107,124],reset_norm:[107,124],resgroup:[4,5,6,7,8],resid:[4,5,6,7,8,17,27,28,29,32,39,70,82,83,84,85],reslib:[49,50,51],resolv:[0,13,41,49,50,51,71,82,83,124],resourc:[0,1,3,5,9,17,25,35,41,50,51,53,58,62,69,89,92,95,96,99,100,101,103,104,106,107,108,109,111,112,113,116,118,119,121,123,124,125],resource_chkp_freq:[50,51],resource_typ:25,resourceclass:69,resourceitem:69,resourceprofil:69,resp2:[4,5,6,7,8],resp:[4,5,6,7,8],resp_alt:[4,5,6,7,8],respect:[18,25,119,124],respond:[14,21,47],respons:[4,5,6,7,8,16,17,20,23,24,29,30,32,33,37,41,48,49,54,67,82,83,84],response_encod:32,ressnam:[4,5,6,7,8],rest:[1,4,5,6,7,8,9,10,21,29,36,58,61,62,63,64,65,69,70,71,73,94],restart:[34,111],restor:[11,16,36,39,41],restore_backup:41,restrict:[25,26,70,85,124],result:[3,7,13,14,16,17,18,20,21,22,24,27,28,29,30,32,33,35,36,37,38,41,47,48,49,52,53,55,69,70,82,83,84,85,101,104,107,115,119,124],result_auth:[69,70],resum:62,resver:[4,5,6,7,8],ret_cod:[27,28,29,32,41],retain:[21,51],retent:51,retri:[41,79,80,86],retriev:[9,11,17,18,20,21,23,26,30,31,38,41,71,77,124],return_cod:52,return_cont:[30,32],return_output:29,return_text:[53,55],return_valu:[14,47],reus:[21,32],revert:41,review:[0,2,12,15,29,31,41,42,46,57,59,66,73,88,89,90,94,95,98],rexx:[11,25,36,40,41,70,85],rich:40,right:98,rload:[4,5,6,7,8],rlse:29,rmode:29,roce:109,rocket:[42,57,95],role:[19,58,60,65,68,71,73,82,83,84,87,88,99,119,124],root:[14,17,18,20,21,23,30,38,41,47,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],round:107,rout:52,routin:[19,41],rplid:[4,5,6,7,8],rrd:[21,22,32,50,51],rremov:[4,5,6,7,8],rsdnt:33,rsn:52,rst:98,rsusr:13,rule1:[113,121],rule:[18,21,22,38,41,70,98,99,100,119,124,125],run:[2,4,5,6,7,8,9,10,11,12,16,17,19,20,21,22,28,29,30,31,39,41,42,43,45,46,49,50,51,52,53,55,57,61,70,71,73,75,76,77,78,79,80,81,85,88,92,94,98,124],runlib:20,runner:22,runth:13,runtim:[4,5,6,7,8,13,50],ruse:[4,5,6,7,8],rwx:[18,21,38],s0c4:[27,28],s0jm:[27,29],sa_create_dynamic_resourc:62,sa_delete_dynamic_resourc:62,sa_rest_api_timeout:[63,64],sa_service_hostnam:[63,64],sa_service_port:[63,64],sa_service_protocol:[63,64],saf:[69,71,73],safe:41,safeti:[115,124],same:[13,18,20,21,22,23,24,26,29,31,32,36,38,41,50,69,70,73,85,86,88,98,115,119,124],same_workflow_inst:70,sampl:[4,5,6,7,8,9,10,15,17,20,21,23,24,25,26,27,28,29,30,31,33,34,35,36,37,39,41,48,49,50,51,53,54,55,56,60,68,69,70,71,77,82,83,84,85,88,89,95,100,101,102,103,104,105,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,124],sample2:56,sample_seq_data_set:21,samplehost:[63,64,76,77,78,79,80,81,82,83,84,86],samplenam:13,san:[13,111,116,117,118],saniti:[56,98,124],sanitis:9,sass:37,satisfi:[21,41,69],save:[26,29,32,50,71,76,77,78,80,86],save_acb:50,sc27:97,sca:[69,71,73],scan:41,scenario:21,scene:[14,47],schedul:49,scheme:[4,5,6,7,8],sci:52,scope:[4,5,6,7,8,14,21,29,36,47,121],scr002:32,scr013:13,scr03:25,scratch:50,script:[16,20,41,42,57,70,85,124],sdesc:63,sdfhauth:17,sdfjauth:17,sdfsmac:[29,53,55],sdfsresl1:49,sdfsresl2:49,sdfsresl:[49,50,51,54],sdk:[0,41,42,56,95],sdsf:41,se_vers:[104,108,112],seamless:[0,87],search:[13,21,25,32,36,38,41,71,75,88],search_software_updates_respons:84,search_software_updates_response_fil:84,sec:[7,27,29,41],second:[9,13,29,33,41,63,64,79,80,85,86,98],secondari:[18,21,22,32,38,50,51],secondary_log_dataset:50,secondary_unit:[50,51],secret:119,sect:29,section:[4,5,8,12,13,14,27,28,29,41,46,47,88,89,94,98,124,126],secur:[21,24,31,36,41,56,67,71,73],secure_boot:124,secure_execut:124,see:[0,2,4,5,6,7,8,10,12,13,22,29,42,46,57,59,66,88,95,98,103,104,107,108,116,119,124],seen:41,segment:[25,49,50,51,53],segment_chkp_freq:50,select:[0,14,19,25,38,47,50,51,89,93,94,98,111,116],selector:[111,116],self:124,semant:[88,98],semver:98,send:[18,41],senseg:49,sensit:[4,5,6,7,8,31,41,49,85,113],sent:[4,5,6,7,8,32,38],separ:[20,25,88,89,111,115,124],seq:[17,18,21,22,25,32,38,50,51,53,55],sequenc:[21,29,32,36,115],sequenti:[17,18,20,21,22,23,24,25,29,30,32,53,55],ser:29,seri:[27,28,29,43,88],serial:[13,17,21,29,39,50,51],serv01:31,serv02:31,serv03:31,serv04:31,serv:12,server:[0,31,58,61,62,63,64,67,69,70,73,76,77,78,79,80,81,82,83,84,85,86,92,94,95,111,116,119,124],server_list:88,servic:[11,18,20,21,23,24,27,28,29,30,31,32,36,38,41,42,43,53,55,57,62,63,64,65,70,71,73,75,78,79,81,85,89,91,96,97,119,125],session:[14,47,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123,124],session_id:[100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],set:[0,4,5,6,7,8,10,11,12,13,14,16,17,20,21,23,24,26,27,28,29,30,31,32,33,34,36,37,39,40,41,42,44,47,49,50,51,53,54,55,57,73,82,83,84,88,94,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],set_dynam:17,set_fact:[20,77],set_stat:17,setgid:31,setprog:17,setuid:31,setup:[50,73,124],setuptool:124,sever:[14,29,41,47,67,75,99,124],sftp:[21,24,36,41,95],sftp_port:41,sg1:116,sga1:117,sha256:[21,24],share:[20,21,22,29,30,31,36,41,50,75,107,111,116,119],share_mod:50,sharestatu:[4,5,6,7,8],shell:[14,20,26,30,36,41,42,47,56,57,70,85,95,98],ship:15,shortli:124,should:[13,14,18,19,20,21,22,23,24,25,29,30,31,32,33,35,36,38,41,47,50,51,70,71,73,98,115,124],shouldn:[14,47],show:[0,10,27,33,36,52,88,98,107,124],shown:[4,5,8,27,28,29,76,77,78,80,82,83,84,86,98,107],shr:[20,21,22,29,30,32,41,50,51],shrd:[27,29],shutdown:31,side:14,sign:[19,124],signifi:21,similar:[16,32,48,67,89,113],similarli:[14,32,47],simpl:[18,38],simplex:39,simplifi:[14,47,62,124],simultan:[0,20,22,30,41],sinc:[19,22,32,43,56,70,98,115,124],singl:[4,5,6,7,8,14,18,19,22,30,32,33,37,41,47,52,53,54,55,121],site:[0,9,71,98],situat:[13,31,32,89],six:[4,5,6,7,8,17],size:[14,18,19,21,22,24,25,27,29,32,33,36,38,39,41,47,50,51,116,118],skelet:54,skip:[36,39,70],slightli:30,slot:[27,29],smaller:18,smf000i:[27,29],smf_name:26,smp:41,sms:17,sms_data_class:[18,21,22,32,38],sms_manag:39,sms_management_class:[18,19,21,22,32,38],sms_storage_class:[18,19,21,22,32,38],smss:[4,5,6,7,8],snippet:13,socket:[60,63,64],softar:76,softwar:[41,65,71,73,75,89,93,94],software_instance_nam:[82,83,84],software_typ:76,sole:[14,47],solut:[87,90],some:[14,17,18,20,21,22,24,25,30,31,32,39,41,47,49,50,51,53,55,70,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],somedirectori:20,somefil:[24,30,53,55],somefile1:53,somefile2:53,someobject:[14,47],sometim:[50,51,52,54],someus:31,soon:41,sort:[32,41],sortin01:32,sortin02:32,sortout:32,sortpgmoutput:32,sourc:[0,17,18,20,21,23,24,29,30,31,32,38,40,41,43,53,55,87,88,90,98],source_memb:[53,55],source_nam:[53,55],space:[0,4,5,6,7,8,18,19,20,21,22,27,28,29,32,36,38,39,41,50,51,89],space_primari:[18,21,22,32,38],space_secondari:[18,21,22,32,38],space_typ:[18,19,21,22,32,38],spack:18,spe:61,spec:41,special:[18,20,21,29,30,32,34,36,38,39,41,105,113],special_nam:13,special_names_get_uppercas:13,specif:[14,18,21,25,26,27,32,38,41,42,45,47,49,51,52,55,57,71,73,75,76,79,80,86,88,91,93,94,95,98,99,101,102,105,107,108,110,111,112,116,124],specifi:[0,4,5,6,7,8,9,10,13,15,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,34,36,37,38,39,41,49,50,51,52,53,54,55,63,64,69,70,73,76,77,78,79,80,81,82,83,84,85,86,88,95,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],speed:124,sphinx:[98,124],spool:[27,29,41,70,85],sql:21,srb:[27,29],src:[18,20,21,23,24,29,30,31,36,38,41,53,55],src_data_set_memb:41,src_encod:32,src_param:31,srcmem:21,ssc:[103,107,109,111,116],ssc_dns_server:124,ssc_ipv4_gatewai:124,ssc_ipv6_gatewai:124,ssgmcp_5:[4,5,6,7,8],ssh:[0,10,41,73],ssl:[4,5,6,7,8],sso:88,stabl:[98,100,124],stable_:98,stable_m:[98,124],stack:41,stage:[50,69],stand:[4,5,6,7,8,9,10],standard:[21,24,36,50,51,53,55,98,113,114,119,120,122,124],start:[7,14,20,21,22,25,27,29,30,36,41,47,70,71,79,85,87,88,92,103,111,116,124],start_:98,start_m:98,state:[4,5,6,7,8,14,17,18,20,21,22,28,30,31,39,41,47,69,70,76,100,102,103,105,106,107,109,111,113,115,116,117,118,119,121,123,124],statement:[14,17,21,27,29,32,36,41,47,49,50,51,54,70,73,85,86,124],statist:[27,29],statu:[4,5,6,7,8,16,23,27,29,31,32,33,41,50,51,52,53,54,55,69,70,85,98,100,101,103,104,105,107,108,111,112,116,117,124],status:111,status_group:32,stc00143:51,stc01533:34,stc01537:34,stc02560:27,stc:[27,28],stderr:[17,20,21,24,25,31,35,36,41,50,51,53,55,95],stderr_lin:[21,24,31,36],stdout:[17,20,21,24,25,31,36,41,53,55],stdout_lin:[21,24,31,36],step0001:[27,28,29],step1:51,step:[14,27,28,29,32,41,47,53,70,71,85,98],step_cc:[27,28,29],step_nam:[27,28,29,70],step_numb:70,step_titl:70,steplib:[49,50,51,54],stepnam:[27,29,70],stgadmin:[39,69],still:[70,98,124],stl1:[27,29],stmt:29,stop:[27,29,37,41,52,70,74,79,103,111,124],stor:32,storag:[17,18,19,21,22,24,32,36,38,39,50,51,99,100,103,106,107,111,121,124],storage_class:[50,51],storage_group:[116,121],storage_group_attach:117,storage_group_nam:[117,118],storage_group_templ:121,storage_group_uri:124,storage_volum:118,storageadmin:121,store:[4,5,6,7,8,18,19,22,24,31,32,38,39,50,54,63,64,89,95],str:[4,5,6,7,8,13,14,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,47,49,50,51,52,53,54,55,56,63,64,68,69,70,76,77,78,79,80,81,82,83,84,85,86,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],strategi:[0,87],stream:[21,24,32],streamlin:73,street:13,string:[4,5,6,7,8,13,14,18,21,22,24,25,29,31,32,34,36,37,38,41,43,47,52,56,70,100,103,104,106,107,109,111,113,116,118,119,121,123,124],strip:[21,29,36],strong:[68,69,70],structur:[14,37,47,49,52,75,115,124],style:[26,32],sub:[41,124],subdirectori:41,subgroup:37,subgroup_info:52,subject:[21,41,84,121],submiss:[27,28,29,41],submit:[11,16,33,37,40,41,48,51,70,85],subopt:41,subscript:89,subsequ:[17,20,70,85,124],subset:[4,5,6,7,8,26,101,103,104,108,110,112,114,120,122,124],substep3:70,substitut:[29,33],substr:34,subsystem:[17,18,27,29,38,63,64,89,107,116,117,118],succe:[95,98],succeed:[29,41,68,98],succesfulli:54,success:[4,5,6,7,8,17,18,20,21,22,23,24,25,27,28,29,30,31,32,33,34,35,38,49,53,55,68,69,70,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],success_count:[4,6],successfulli:[4,6,22,24,31,32,98],sudo:124,suffici:119,suffix:98,summari:29,supplementari:[91,92],suppli:[4,5,6,7,8,14,22,32,47,68,69,70,85],support:[1,4,5,6,7,8,9,11,13,14,18,20,21,23,24,25,29,30,32,34,36,38,39,41,42,43,45,47,49,50,51,53,55,56,57,58,65,68,69,70,71,73,79,85,87,93,94,98,99,100,105,111,124],supprt:124,sure:[0,18,32,36,95,98],surround:[20,31],sv1:118,svc:[49,50,51],svc_class:[27,28,29],svllab01:26,svplex1:26,sy1:70,symbol:[18,21,29,33,38,43,53,55],sync:124,synchron:41,syntax:[20,41,88,89,100,103,106,107,109,111,113,116,118,119,121,123],sys1:[20,31,32,53,55],sys20073:29,sys:[14,26,47],sys_lib:[53,55],sys_nam:26,sysabend:50,sysaff:29,sysctlg:37,sysda:29,sysexec:36,sysin:[27,29,32],syslib:29,syslin:29,syslmod:29,sysmod1:84,sysmod2:84,sysmod3:84,sysmod:[71,82,83,84],sysnam:31,sysout:[27,29,32],sysplex:[31,73,76,107],sysplex_nam:[26,76],sysprint:[27,29,32],sysr:17,system:[0,1,4,5,6,7,8,11,14,16,17,18,19,20,21,22,23,24,25,27,28,29,30,32,33,34,36,37,38,39,41,43,47,49,50,51,52,53,55,60,61,62,63,64,70,71,73,76,77,78,79,80,81,82,83,84,85,86,88,89,97,98,100,101,103,104,105,106,107,108,109,110,111,112,113,116,117,118,119,120,121,122,123,125],system_nam:76,system_nicknam:[80,82,83,84,86],systems_nam:[76,86],systems_nicknam:80,sysut1:[27,29,51],sysut2:[27,29],sysut3:49,sysut4:49,syszd6:26,t043jm:[27,29],t12345:17,t125008:29,tabl:[4,5,6,7,8,22,39,41,80,86,98],tag:[31,41,57,98,124],tag_ccsid:[31,41],tag_untag:31,tailor:[41,89],take:[13,18,21,24,29,32,41,49,50,51,54],taken:[22,25],takeov:31,tape2:31,tape_link_uri:124,tar:[17,18,20,21,23,30,31,38,41,88,98],tarfil:18,target1:55,target2:[53,55],target3:55,target4:[53,55],target:[0,3,4,5,6,7,8,12,13,14,15,16,19,21,26,27,28,29,35,37,38,39,41,42,47,48,49,50,51,52,53,54,55,57,63,64,67,70,73,76,77,78,79,80,81,85,86,94,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123,124,125],target_userid:69,targetassign:[4,5,6,7,8],targetdescript:[4,5,6,7,8],task:[0,1,3,10,11,16,17,20,21,22,23,24,29,30,36,39,41,42,45,48,50,57,58,60,61,63,64,65,67,68,70,73,75,76,77,78,79,80,81,82,83,84,85,86,92,94,95,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123,124],tcp:[4,5,6,7,8,27],tcpip:27,team:[89,95,98],tell:[14,47],temp_acb_dataset:50,temp_backup:19,temp_volum:19,tempdir:56,templat:[0,15,17,20,21,29,36,41,58,63,71,75,80,119,120,121],template_paramet:[21,29,36],templatenam:63,tempnam:29,temporari:[0,14,17,18,19,20,21,22,23,24,30,31,32,36,38,39,41,47,124],temporarili:[19,22,36,124],tenant:80,tenant_nam:80,tend:95,terabyt:25,term:[89,94],termin:[21,29,31,32,50,51,111,124],termuacc:37,ters:[18,38,41],terse_pack:18,test01:[14,47],test1:[14,23,38,47],test2:38,test:[2,18,19,20,21,22,23,24,25,29,30,37,38,41,56,91,121,124],test_config:[14,47],test_create_dataset_arg_expans:[14,47],test_create_dataset_exception_receiving_nam:[14,47],test_create_dataset_missing_all_arg:[14,47],test_create_dataset_missing_second_arg:[14,47],test_create_dataset_various_arg:[14,47],test_data:[14,47],test_dataset_cr:[14,47],test_partit:98,test_zhmc_password_rul:124,test_zhmc_us:124,testcas:[56,98,124],testdata:23,testdb:54,testdsn:[14,47],tester:[14,29,47],testhmc:[98,124],testinventori:124,testnam:[13,14,47],testopt:98,testpgm:21,testus:37,testusr:39,testutil:124,testvault:124,text:[4,5,6,7,8,20,21,29,31,32,33,34,41,52,69,98,119,124],textual:[11,16,41],than:[4,6,7,8,10,18,21,23,24,25,28,29,31,37,39,41,50,70,98,107,124],thei:[0,13,14,15,17,18,19,21,22,24,31,38,41,42,47,57,67,124],them:[10,13,18,21,29,32,34,36,41,51,76,80,89,98,124,125],therefor:[10,14,15,17,32,47,71,73,90],thi:[0,1,2,4,6,7,8,9,10,11,12,13,14,15,17,18,19,20,21,22,24,25,26,27,28,29,30,31,32,33,36,38,39,41,45,46,47,49,50,51,52,53,54,55,56,57,58,59,60,61,63,64,65,66,69,70,71,73,76,77,78,79,80,81,82,83,84,85,86,87,88,89,96,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],thin:[14,47],thing:98,third:[68,69,70],those:[0,10,25,38,67,71,82,121,124],though:[21,31,41,102],thread:[111,116],three:25,through:[1,11,20,21,22,24,27,28,29,30,41,45,49,58,65,70,87,96,98,119],throughout:41,thu:[21,24,36,41,57,94,124],ticket:41,time:[4,6,7,8,13,14,18,25,26,27,28,29,32,33,39,41,47,53,55,70,79,80,85,86,98,119,124],time_stamp:51,timeout:[9,60,63,64,111,116,119],timestamp:[17,20,21,23,30,31,50,51],tinad:25,tip:[12,46],titl:70,tke:105,tme:29,tmp:[0,18,19,20,21,24,25,30,31,32,36,38,41,53,55,76,77,78,80,82,83,84,86,95],tmp_hlq:[17,18,20,21,22,23,24,30,31,32,38,39,41],tmp_path:36,tmphlq:[17,18,20,21,22,23,24,30,31,32,38,39],to_csdgroup:4,to_encod:[23,41],to_expand:[14,47],todai:98,togeth:[25,27,29,87,90],token:[0,68,69,70,88,107],toler:[115,124],tool:124,toolkit:35,top:[15,18,98],topic:[0,31,41,89,98],total:[29,34,79,80,86,100,116],tower:[0,41],trace:41,track:[39,41],tracker:98,tradit:[42,57,89],trail:[19,21,29,34,36,41],tran:52,transact:52,transfer:[21,24,36,38,40,43,95],transform:15,transid:[4,5,6,7,8],transmit:18,transport:[18,41],travers:[24,41],travi:124,treat:[21,29,32,36,41,53,55],tree:[18,21],tri:41,trigger:41,trim_block:[21,29,36],trk:[18,19,21,22,32,38,39],troubleshoot:[87,124],truncat:[23,32,41],trust:[4,5,6,7,8],tso:[11,16,25,36],tsocmd_to_issu:[70,85],tstre:54,tsu:28,tuesdai:[13,27],tupl:105,turn:0,two:[13,14,18,19,20,25,32,36,41,47,49,50,53,62,98,105,124],txt:[9,14,18,20,21,30,32,36,38,47,98,124],type:[4,5,6,7,8,10,12,14,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,41,45,47,49,50,51,52,53,54,55,56,63,64,68,69,70,76,77,78,79,80,81,82,83,84,85,86,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],type_2_data:52,typeerror:[14,47,124],typic:[12,14,30,47,73],typrun:41,u0026mbr:29,u00270000:39,u0027:[21,24,27,29,31,39],u0027hello:[27,29],u0027i:31,u0027object:29,u0027sourc:31,u0027un:24,u0027us:24,u0027xref:29,udx:105,ui66511:71,ui66512:71,ui70435:56,uid:[21,31],unabl:95,unaccept:[104,107,108,111,112,116],unarch:[16,18,41],unarchiv:38,unassign:116,unauthent:[4,5,6,7,8],unauthor:[32,41,49],uncatalog:[20,21,22,23,24,25,29,30,31,32,41,50],uncatalogu:41,uncatlg:[32,50,51],unchang:[30,31,39,100,103,105,106,109,111,113,116,118,119,121,123],uncompress:38,uncond:50,uncondition:50,unconfigur:[100,124],undefin:21,under:[0,4,5,6,7,8,14,15,18,26,27,47,54,79,88],undercov:69,undergo:94,underli:[21,24,32,36],underscor:[56,100,103,106,107,109,111,113,116,118,119,121,123,124],understand:[89,92,95,98],understood:31,undo:[14,47],unew:98,unexpect:[18,21,38,41],unformat:54,unformatted_output:54,unicod:[43,124],unicodedecodeerror:95,unidentifi:41,unifi:[0,87,90,124],uniform:53,uniqu:[20,21,27,28,29,31,41,70,80,86],unit:[12,18,19,21,22,29,32,33,38,39,46,50,51,88,98,107,111,116,118],unittest:[14,47],unix:[11,18,19,20,21,23,24,29,30,31,32,36,38,41,43,53,55,70,85],unknown:[4,5,6,7,8,33,69,88],unless:[18,21,29,32,33,34,36,38,41,49,88,107,116,117],unlik:15,unmanag:104,unmount:31,unmount_opt:31,unnecessari:[12,13,41,124],unpack:[18,38],unpin:124,unqualifi:25,unspecifi:[18,38],unsuccess:88,unsupport:[26,41],untag:[31,42,57],until:[29,32],unusu:124,unvers:98,unwarr:41,upb:[32,41],updat:[1,3,5,9,13,17,20,22,30,31,41,50,51,52,56,60,69,71,75,89,95,98,99,101,103,106,107,109,111,113,116,118,119,121,123,124],update_paramet:8,update_retention_criteria:51,upgrad:[95,124],upload:[98,124],upper:13,uppercas:31,uppercase_str:13,upstream:98,uri:[60,69,100,103,105,107,109,111,113,116,118,119,121,124],url:[4,5,6,7,8,70,85,88,124],urole_list:122,usag:[0,4,5,6,7,8,13,15,41,56,105,111,116,118,124],usage_domain:105,use:[0,4,5,6,7,8,10,12,14,17,18,19,21,22,29,30,31,32,38,39,41,42,47,50,51,54,57,62,69,70,71,75,87,88,89,92,94,95,98,115,124],use_adrdssu:[18,38],use_qualifi:24,use_regex:34,use_templ:[21,29,36],useagelstat:[4,5,6,7,8],usecount:[4,5,6,7,8],used:[0,3,4,5,6,7,8,12,13,14,15,16,17,18,19,20,21,22,23,24,25,27,29,30,31,32,33,36,38,39,41,43,47,48,49,50,51,53,54,55,61,62,63,67,68,69,70,71,73,76,77,78,79,80,81,82,83,84,85,86,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],usefetch:[4,5,6,7,8],useful:[20,30,92],user03:29,user1:119,user:[4,5,6,7,8,13,14,15,17,18,19,20,21,22,23,24,25,29,30,31,32,36,37,38,39,41,47,51,52,63,64,68,69,70,71,75,76,77,78,79,80,81,82,83,84,85,86,88,89,98,99,101,108,112,124,125],user_list:120,user_nam:95,user_pattern_nam:119,user_pattern_uri:119,user_rol:[119,121,122],user_role_nam:119,user_to_list:[70,85],userexeckei:[4,5,6,7,8],userid:[21,24,27,29,36,82,83,84,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],userlib:[25,54],usernam:[14,19,22,47,63,64,68,69,70,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],uses:[0,14,18,21,24,27,29,36,38,39,40,41,47,76,77,78,80,86,98,115,124],using:[4,5,6,7,8,9,10,14,15,16,18,19,20,21,22,24,25,28,30,31,32,36,38,39,41,47,49,50,58,67,72,73,76,77,78,79,80,81,82,83,84,86,88,99,100,106,107,109,111,115,121,123,124],usr0010:17,usr:[13,14,36,47,95],uss:[14,17,18,20,21,23,24,25,29,30,31,32,38,41,43,47,53,55],usual:[0,27,31,67],utf8:41,utf:[13,21,29,41,43,95],util:[0,10,11,14,20,23,24,27,28,29,30,32,41,42,45,47,49,50,51,54,55,56,57,95],uuid:[116,118],v15:57,v2r2:43,v2r3:[14,42,47,56,57,71,73,74],v2r4:[41,71],v2r5:71,v3r8:[14,47],v5r3m0:17,v7k:106,valid:[4,5,6,7,8,9,12,13,14,18,19,21,22,24,25,29,31,32,34,36,38,41,47,50,51,67,70,71,73,98,100,115,116,124],validate_checksum:24,validatedid:69,valu:[3,9,12,13,14,41,47,48,56,60,63,64,67,71,76,77,78,79,80,81,82,83,84,85,86,89,124],value1:[14,47,86],value2:[14,47,86],value3:[14,47],value_specified_in_no_log_paramet:119,valueerror:13,var1:[76,77,79,80,86],var1_valu:[76,79,80],var2:[76,86],var2_valu:76,varaibl:85,vari:[0,17,18,21,22,32,38,39,41,43,53,89,90,94],variabl:[0,4,5,6,7,8,9,13,14,17,18,20,21,22,24,26,29,30,32,36,38,41,42,47,50,57,69,70,88,95,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],variable_end_str:[21,29,36],variable_start_str:[21,29,36],variant:98,variou:[50,51,71,76,79,80,86,89,96],vars_fil:[63,64,75],vars_prompt:[63,64,68],vault:124,vba:[18,21,22,32,38,50,51],vcat:37,vendor:[70,76],vendor_nam:76,verbos:[21,24,32,33,41,89,98],veri:41,verif:[4,5,6,7,8,17,20,30,39,124],verifi:[13,24,35,39,69,95,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],verify_offlin:39,verify_volid:39,verify_volume_empti:39,verison:124,versa:98,version:[4,5,6,7,8,10,14,18,20,21,23,24,26,29,30,42,43,47,51,57,69,70,76,85,93,94,95,97,102,104,108,111,112,116,121],version_ad:124,version_numb:51,vfm:107,vfunction1:123,vhba_cpca_sg_mgmt12:116,via:[4,5,6,7,8,9,65,98,106,119],vice:98,video:92,view:[0,14,47,50,70,93,121],view_onli:121,vio:32,virt:[27,29],virtual:[39,96,98,99,106,109,111,116,124],virtual_funct:123,virtual_switch_uri:109,visibl:[21,76,98,125],visit:[0,42,57,92],vlan:[109,111],vlan_typ:124,vm_name:26,vol033:21,vol:[17,29],volid:39,volser:[29,33,39],volstat:33,volum:[11,13,16,17,21,22,25,29,32,38,41,50,51,82,83,84,99,111,116,124],volupt:124,vsam:[18,21,22,23,24,25,32,38,39,41,54],vsamdset:37,vtoc:[39,41],vtoc_siz:39,vuln:124,vulner:124,vvd:39,vvv:[31,89],vvvv:[21,24,89],wai:[0,10,21,29,36,41,75,88,124],wait:[29,31,32,33,41,70,79,80,86,98],wait_time_:[29,33,41],wait_times_:29,want:[18,20,22,30,51,63,64,88,89,95,98],warn:[14,27,29,35,41,47,88,89],weakli:70,weather:13,web:[35,68,69,70,91,96,97,98,119,125],webspher:[76,78,79,80,81],week:25,weekli:98,weheth:104,weight:[107,111,116],welcom:20,well:[0,20,21,29,30,36,41,42,51,52,54,57,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],were:[13,18,27,28,29,31,33,34,41,49,51,105,107,121,124],what:[31,32,39,67,70,88,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],wheel:124,when:[2,4,5,6,7,8,12,13,14,15,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,35,36,38,39,41,46,47,50,51,53,55,59,61,66,68,69,70,72,73,76,77,78,79,80,81,82,83,84,85,86,88,89,94,98,103,106,107,109,111,113,115,116,118,119,121,123,124],whenev:[31,98],where:[10,13,14,18,19,21,22,23,24,27,28,29,31,32,34,36,38,41,47,51,53,56,61,63,76,77,78,80,82,83,84,86,89,106,107,109,111,113,116,118,119,121,123,124],whether:[0,4,5,6,7,8,13,20,21,24,29,30,31,32,36,38,41,49,51,69,70,76,85,95,98,104,107,108,111,112,116,117,119,121,124],which:[4,5,6,7,8,9,13,14,18,19,20,21,22,23,24,25,29,30,31,32,34,36,38,41,42,47,49,50,51,52,54,55,56,57,60,63,64,68,69,70,71,73,84,85,88,89,94,98,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124],whitespac:56,who:[17,20,23,27,28,30,69,71,76,80],whoneedsaccess:69,whose:[19,25,34,110,111],why:98,wide:[107,111,116,118],wider:87,wih:28,wild:41,wildcard:[4,6,7,8,18,21,25,28,34,51],win:124,window:94,winmvs2c:[4,5,6,7,8],with_:20,within:[0,25,27,28,29,41,43,52,53,55,98,100,103,105,106,109,111,113,116,117,118,119,121,123,124],without:[11,13,14,17,18,20,21,24,27,32,38,41,47,49,50,51,53,55,88,89,124],won:0,word:[25,107],work:[14,21,27,29,30,36,41,47,50,71,88,89,95,98,108,112,124],workflow:[0,65,67,71,73,74,75,87,98,124],workflow_access_typ:[70,85],workflow_account_info:[70,85],workflow_assign_to_own:[70,85],workflow_categori:70,workflow_com:[70,85],workflow_complet:70,workflow_def:[70,85],workflow_delete_completed_job:[70,85],workflow_failed_step:70,workflow_fil:[70,85],workflow_file_system:[70,85],workflow_host:70,workflow_job_stat:[70,85],workflow_kei:70,workflow_nam:[70,85],workflow_notification_url:[70,85],workflow_own:[70,85],workflow_perform_subsequ:[70,85],workflow_resolve_conflict_by_us:[70,85],workflow_resolve_global_conflict_by_us:[70,85],workflow_sample_automation_step:[70,85],workflow_step_nam:[70,85],workflow_var:[70,85],workflow_vars_fil:[70,85],workflow_vendor:70,workflow_wait:70,workload:107,world:[13,20,27,29,107,111,116,118],worri:[14,47],would:[13,14,18,21,24,27,28,32,38,41,47,51,56,88,95],wrap:[14,47],wrapper:[14,47],write:[22,23,31,32,41,42,51,57,82,83,84,98],write_onli:32,writeabl:[100,103,106,107,109,111,113,116,118,119,121,123,124],written:[1,11,21,23,24,31,32,38,41,45,50,51,58,89,96,124],wrong:41,wto:41,wwpn:111,www:[4,5,6,7,8,20],xiaopin:7,xmit:[18,38,41],xmit_log_data_set:[18,38],xml:[4,5,6,7,8,70,85],xmltodict:10,xref:29,xxx:[76,77,78,80,82,83,84,86,95],xyz:[25,115],yaml:[14,18,21,25,38,41,47,60,63,64,89,100,103,106,107,109,111,113,116,118,119,121,123,124],yds7ujxqrd3h8v5wxq9pf1yptztq4jzrozn3xqkf26zicxghc7mdzgycmca:68,year:25,yes:[19,22,23,30,32,34,39,63,64,68,95],yet:[32,98,111,124],yield:[27,28,29,41],yml:[14,47,76,77,78,79,80,81,82,83,84,86,88,98,124],you:[0,2,4,6,7,8,10,12,13,14,16,17,18,20,21,22,23,24,25,29,30,31,32,36,38,39,41,42,43,46,47,49,50,51,54,57,59,63,64,66,67,70,71,73,76,77,78,79,80,81,82,83,84,86,87,88,89,92,94,95,98,99,102],your:[0,4,5,6,7,8,10,14,20,21,38,39,42,47,50,57,62,63,64,68,69,70,73,75,85,88,89,92,95,98],your_password:68,your_usernam:68,yqchen:[4,5,6,7,8],z114:124,z13:[101,106,108,112],z14:[106,116,117,118,124],z15:[111,124],z16:124,z196:124,zFS:41,z_ansible_collections_sampl:124,z_python_interpret:[14,47],zaa:119,zawar:107,zbc12:124,zec12:124,zero:[7,18,21,27,28,29,32,38,41],zeroiz:100,zhmc:[98,111,121,124],zhmc_adapt:[99,101,111,124],zhmc_adapter_list:[99,100,124],zhmc_consol:[99,124],zhmc_cpc:[99,124],zhmc_cpc_list:[99,115],zhmc_crypto_attach:[99,124],zhmc_hba:[99,111],zhmc_inventori:124,zhmc_lpar:[99,124],zhmc_lpar_list:[99,124],zhmc_nic:[99,110,111,124],zhmc_nic_list:[99,124],zhmc_partit:[99,106,109,112,123,124],zhmc_partition_list:[99,111,124],zhmc_password_rul:[99,124],zhmc_password_rule_list:[99,124],zhmc_session:[99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123,124],zhmc_storage_group:[99,111,124],zhmc_storage_group_attach:[99,116,124],zhmc_storage_volum:[99,124],zhmc_test_role_1:121,zhmc_user:[99,124],zhmc_user_list:[99,124],zhmc_user_rol:[99,124],zhmc_user_role_list:[99,124],zhmc_vault:124,zhmc_virtual_funct:[99,111],zhmcclient:[98,100,124,126],zhmcclient_mock:124,ziip:107,zinventori:[14,47],zip:[18,38,41],zmf_authent:[67,69,70,71],zmf_bodi:[76,80],zmf_cpm_create_software_inst:[71,73,75],zmf_cpm_get_software_inst:[71,73,75],zmf_cpm_list_software_templ:[71,73,75],zmf_cpm_manage_software_inst:[71,73,75,76,80],zmf_cpm_provision_software_servic:[71,73,75,79,81],zmf_cpm_remove_software_inst:[71,73,75,76,80],zmf_credenti:[69,70],zmf_crt:[68,69,70,85],zmf_host:[68,69,70,76,77,78,79,80,81,82,83,84,85,86],zmf_kei:[68,69,70,85],zmf_password:[68,69,70,76,77,78,79,80,81,82,83,84,85,86],zmf_port:[68,69,70,76,77,78,79,80,81,82,83,84,85,86],zmf_sca:[67,71,73],zmf_swmgmt_identify_missing_critical_upd:[71,73,75],zmf_swmgmt_identify_missing_fixcat_upd:[71,73,75],zmf_swmgmt_search_software_upd:[71,73,75],zmf_user:[68,69,70,76,77,78,79,80,81,82,83,84,85,86],zmf_workflow:[67,71,73,85],zmf_workflow_complet:[71,73,75],zmf_zmsc_run_management_servic:[71,73,75],zmsc:73,zoa:[0,42],zoau:[10,14,17,19,20,26,27,28,29,30,31,41,47,49,56,95],zoau_dir:20,zoau_hom:[14,47],zoau_root:[14,47],zoautil:[14,47],zoautil_dir:[14,47],zoautil_pi:[14,47],zos:[88,95],zos_apf:[16,41],zos_arch:[16,38,41],zos_backup_restor:[16,39,41],zos_blockinfil:[16,41],zos_copi:[16,18,24,36,40,41],zos_data_set:[0,16,20,21,24,25,31,32,41],zos_dataset:[14,47],zos_datset:[14,47],zos_encod:[16,41],zos_encode_out:23,zos_fetch:[16,18,21,40,41],zos_find:[16,41],zos_gather_fact:[16,41],zos_job_output:[16,41],zos_job_queri:[0,16,41],zos_job_submit:[16,40,41],zos_lineinfil:[16,41],zos_mount:[16,41],zos_mvs_raw:[0,16,41],zos_oper:[16,34,41],zos_operator_action_queri:[16,41],zos_operator_bas:41,zos_p:[16,40,41,95],zos_raw:32,zos_script:[16,41],zos_ssh:[41,95],zos_tso_command:[16,36,41],zos_unarch:[16,18,41],zos_volume_init:[16,41],zosmf:[68,69,70,85]},titles:["General","z/OS CICS","Contributing","Modules","cmci_action \u2013 Perform actions on CICS and CICSPlex SM resources","cmci_create \u2013 Create CICS and CICSPlex SM definitions","cmci_delete \u2013 Delete CICS and CICSPlex SM resources","cmci_get \u2013 Query CICS and CICSPlex SM resources and definitions","cmci_update \u2013 Update CICS and CICSPlex resources and definitions","Releases","Requirements of managed nodes","z/OS Core","Contributing","Features","Prerequisites","Filters","Modules","zos_apf \u2013 Add or remove libraries to Authorized Program Facility (APF)","zos_archive \u2013 Archive files and data sets on z/OS.","zos_backup_restore \u2013 Backup and restore data sets and volumes","zos_blockinfile \u2013 Manage block of multi-line textual data on z/OS","zos_copy \u2013 Copy data to z/OS","zos_data_set \u2013 Manage data sets","zos_encode \u2013 Perform encoding operations.","zos_fetch \u2013 Fetch data from z/OS","zos_find \u2013 Find matching data sets","zos_gather_facts \u2013 Gather z/OS system facts.","zos_job_output \u2013 Display job output","zos_job_query \u2013 Query job status","zos_job_submit \u2013 Submit JCL","zos_lineinfile \u2013 Manage textual data on z/OS","zos_mount \u2013 Mount a z/OS file system.","zos_mvs_raw \u2013 Run a z/OS program.","zos_operator \u2013 Execute operator command","zos_operator_action_query \u2013 Display messages requiring action","zos_ping \u2013 Ping z/OS and check dependencies.","zos_script \u2013 Run scripts in z/OS","zos_tso_command \u2013 Execute TSO commands","zos_unarchive \u2013 Unarchive files and data sets in z/OS.","zos_volume_init \u2013 Initialize volumes or minidisks.","Plugins","Releases","Managed node","Character Sets","Resources","z/OS IMS","Contributing","Prerequisites","Modules","ims_acb_gen \u2013 Generate IMS ACB","ims_catalog_populate \u2013 Add records to the IMS Catalog","ims_catalog_purge \u2013 Purge records from the IMS Catalog","ims_command \u2013 Submit IMS Commands","ims_dbd_gen \u2013 Generate IMS DBD","ims_dbrc \u2013 Submit IMS DBRC Commands","ims_psb_gen \u2013 Generate IMS PSB","Releases","Managed node","IBM Z System Automation","Contributing","Releases","Managed node","Roles","sa_create_dynamic_resource \u2013 Role creates and resumes a dynamic resource","sa_delete_dynamic_resource \u2013 Role deletes a dynamic resource","IBM z/OSMF","Contributing","Modules","zmf_authenticate \u2013 Authenticate with z/OSMF server","zmf_sca \u2013 Automate z/OS security requirements validation and provision","zmf_workflow \u2013 Operate z/OS workflows","Releases","Control node","Managed node","Resources","Roles","zmf_cpm_create_software_instance \u2013 Role creates a z/OS software instance","zmf_cpm_get_software_instance \u2013 Role get specific z/OS software instance","zmf_cpm_list_software_templates \u2013 Role lists all published z/OS software templates","zmf_cpm_manage_software_instance \u2013 Role manages a provisioned z/OS software instance","zmf_cpm_provision_software_service \u2013 Role provisions a z/OS software service","zmf_cpm_remove_software_instance \u2013 Role removes a z/OS software instance","zmf_swmgmt_identify_missing_critical_updates \u2013 Identify Missing Critical Software Updates for a Software Instance","zmf_swmgmt_identify_missing_fixcat_updates \u2013 Identify Missing Fixcat Software Updates for a Software Instance","zmf_swmgmt_search_software_updates \u2013 Search a Software Instance for Software Updates","zmf_workflow_complete \u2013 Role completes a z/OS workflow","zmf_zmsc_run_management_service \u2013 Role runs a z/OS management service","Red Hat Ansible Certified Content for IBM Z","Installation","Playbooks","Contributing","Documentation","Helpful Links","Releases","Requirements","Errors and Messages","Z HMC","Resources","Development","Modules","zhmc_adapter \u2013 Update adapters and create Hipersocket adapters","zhmc_adapter_list \u2013 List adapters","zhmc_console \u2013 Get facts about the HMC","zhmc_cpc \u2013 Manage CPCs","zhmc_cpc_list \u2013 List CPCs","zhmc_crypto_attachment \u2013 Attach crypto resources to partitions","zhmc_hba \u2013 Create HBAs in partitions","zhmc_lpar \u2013 Manage LPARs","zhmc_lpar_list \u2013 List LPARs","zhmc_nic \u2013 Create NICs in partitions","zhmc_nic_list \u2013 List NICs","zhmc_partition \u2013 Create partitions","zhmc_partition_list \u2013 List partitions","zhmc_password_rule \u2013 Create HMC password rules","zhmc_password_rule_list \u2013 List Password Rules","zhmc_session \u2013 Manage HMC sessions across tasks","zhmc_storage_group \u2013 Create storage groups","zhmc_storage_group_attachment \u2013 Attach storage groups to partitions","zhmc_storage_volume \u2013 Create storage volumes","zhmc_user \u2013 Create HMC users","zhmc_user_list \u2013 List HMC users","zhmc_user_role \u2013 Create HMC user roles","zhmc_user_role_list \u2013 List HMC user roles","zhmc_virtual_function \u2013 Create virtual functions in partitions","Releases","Managed node","Troubleshooting"],titleterms:{"default":13,"function":[13,14,47,123],"import":13,"new":[0,9,41,60,98],"return":[4,5,6,7,8,17,18,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,49,50,51,52,53,54,55,68,69,70,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],Are:0,IMS:[45,49,50,51,52,53,54,55],abl:95,about:102,acb:49,across:115,action:[4,34,40],adapt:[100,101],add:[14,17,47,50],addit:[0,14,47],affect:95,after:0,all:78,also:[18,20,21,24,25,31,32,34,36,38,39,85,100,101,110,111,112],ani:[0,95],ansibl:[0,12,46,87,88,95],ansible_librari:[14,47],ansible_zos_modul:[14,47],apf:17,archiv:18,arg_typ:13,argument:[13,14,47],askpass:95,attach:[105,117],authent:[68,95],author:17,autom:[58,69,88],avail:[9,41,56,60,71],backup:19,befor:0,behind:0,best:0,beta1:56,beta2:56,beta3:56,beta:[41,56],betterargpars:[12,13],block:20,bug:41,bugfix:41,build:[88,98],built:13,can:[0,95],catalog:[50,51],caus:95,certifi:[0,87],chang:41,charact:43,check:[0,35],cic:[0,1,4,5,6,7,8],cicsplex:[4,5,6,7,8],cli:[14,47],cmci_act:4,cmci_creat:5,cmci_delet:6,cmci_get:7,cmci_upd:8,collect:[0,95],command:[33,37,52,54],commun:0,complet:[0,85],concept:89,configur:[0,14,47],content:[0,87],contribut:[0,2,12,46,59,66,90],control:[14,47,72,94],copi:21,core:11,cpc:[103,104],creat:[5,63,76,100,106,109,111,113,116,118,119,121,123],critic:82,crypto:105,custom:[0,13],data:[18,19,20,21,22,24,25,30,38],dbd:53,dbrc:54,debug:89,defin:[0,13],definit:[5,7,8],delet:[6,64],depend:[13,14,35,47,85],deprec:41,detail:[14,47],develop:[0,2,12,14,46,47,98],directori:[14,47],displai:[27,34],document:[0,91,98],doe:95,download:0,dure:95,dynam:[63,64],encod:23,environ:[0,98],error:95,exampl:[4,5,6,7,8,13,14,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,47,49,50,51,52,53,54,55,63,64,68,69,70,76,77,78,79,80,81,82,83,84,85,86,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],exclus:13,execut:[33,37,95],exist:88,facil:17,fact:[26,102],fail:[0,95],featur:[13,41],fetch:24,file:[0,18,31,38],filter:15,find:[0,25],fix:[41,95],fixcat:83,frequent:0,fresh:88,from:[24,51],galaxi:88,gather:26,gener:[0,49,53,55],get:[77,95,102],group:[116,117],hat:87,have:[0,95],hba:106,help:92,hipersocket:100,hmc:[96,102,113,115,119,120,121,122],host:95,how:[0,95],hub:88,ibm:[0,58,65,87,95],idempot:0,identifi:[82,83],ims_acb_gen:49,ims_catalog_popul:50,ims_catalog_purg:51,ims_command:52,ims_dbd_gen:53,ims_dbrc:54,ims_psb_gen:55,initi:39,instal:[0,14,47,88],instanc:[76,77,79,81,82,83,84],instead:95,inventori:89,issu:[0,41],jcl:29,job:[27,28],kei:[14,47],know:0,known:41,latest:0,leav:0,librari:17,line:20,link:92,list:[78,101,104,108,110,112,114,120,122],local:88,login:95,lpar:[107,108],major:41,manag:[10,14,20,22,30,42,47,57,61,73,79,86,94,95,103,107,115,125],match:25,memori:0,messag:[34,95],method:[14,47],minidisk:39,minor:41,miss:[82,83],mock:[14,47],mode:0,modul:[0,3,12,14,16,41,46,47,48,67,95,99],mount:31,much:0,multi:20,mutual:13,need:[0,95],nic:[109,110],node:[10,14,42,47,57,61,72,73,94,125],note:[17,18,20,21,23,24,25,29,30,31,32,36,38,49,50,51,52,53,54,55,56,60,63,64,70,71,76,77,78,79,80,81,82,83,84,85,86,116,117,118],notic:41,object:0,offer:0,open:0,oper:[0,23,33,70],option:13,osmf:[65,68],other:0,output:27,overrid:88,packag:[14,47],paramet:[4,5,6,7,8,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,36,37,38,39,49,50,51,52,53,54,55,63,64,68,69,70,95,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],pars:12,part:0,particular:0,partit:[105,106,109,111,112,117,123],password:[113,114],perform:[4,23],ping:35,playbook:[0,89,95],plugin:40,practic:0,pre:[88,95],preced:0,prerequisit:[14,47],privat:88,privileg:95,problem:[0,95],program:[17,32],prompt:95,provis:[69,79,80],psb:55,publish:78,purg:51,pytest:[14,47],python:[0,42,57,95],queri:[7,28],ram:0,reach:95,record:[50,51],red:87,redhat:0,refer:[9,41,56,71],releas:[0,9,41,56,60,71,88,93,98,124],remov:[17,81],repositori:98,requir:[0,10,13,34,69,94,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,116,117,118,119,120,121,122,123],resourc:[4,6,7,8,14,44,47,63,64,74,97,105],restor:19,resum:63,role:[62,63,64,75,76,77,78,79,80,81,85,86,121,122],rule:[0,113,114],run:[0,14,32,36,47,86,89,95],sa_create_dynamic_resourc:63,sa_delete_dynamic_resourc:64,sampl:0,script:36,search:84,secur:69,see:[18,20,21,24,25,31,32,34,36,38,39,85,100,101,110,111,112],seek:[0,95],server:[68,88],servic:[80,86],session:115,set:[18,19,22,25,38,43,98],should:[0,95],softwar:[76,77,78,79,80,81,82,83,84],special:95,specif:[0,77],ssh:[14,47,95],start:98,statu:28,storag:[116,117,118],submit:[29,52,54],support:[0,95],synopsi:[4,5,6,7,8,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,49,50,51,52,53,54,55,63,64,68,69,70,76,77,78,79,80,81,82,83,84,85,86,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],system:[26,31,58,95],target:95,task:115,templat:78,test:[0,12,14,46,47,95,98],textual:[20,30],them:0,thi:95,tip:[14,47],track:0,troubleshoot:[95,126],tso:37,type:13,unarch:38,unit:[14,47],unsupport:95,updat:[0,8,82,83,84,100],upgrad:0,usag:[14,47],user:[95,119,120,121,122],using:[0,95],uss:95,valid:69,valu:[4,5,6,7,8,17,18,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,49,50,51,52,53,54,55,68,69,70,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123],variabl:[76,77,78,79,80,81,82,83,84,85,86,89],version:[0,9,41,56,60,71,88,98,124],virtual:123,volum:[19,39,118],warn:95,what:[0,9,41,60,95],when:[0,95],where:0,which:[0,95],why:95,workflow:[70,85],zhmc_adapt:100,zhmc_adapter_list:101,zhmc_consol:102,zhmc_cpc:103,zhmc_cpc_list:104,zhmc_crypto_attach:105,zhmc_hba:106,zhmc_lpar:107,zhmc_lpar_list:108,zhmc_nic:109,zhmc_nic_list:110,zhmc_partit:111,zhmc_partition_list:112,zhmc_password_rul:113,zhmc_password_rule_list:114,zhmc_session:115,zhmc_storage_group:116,zhmc_storage_group_attach:117,zhmc_storage_volum:118,zhmc_user:119,zhmc_user_list:120,zhmc_user_rol:121,zhmc_user_role_list:122,zhmc_virtual_funct:123,zmf_authent:68,zmf_cpm_create_software_inst:76,zmf_cpm_get_software_inst:77,zmf_cpm_list_software_templ:78,zmf_cpm_manage_software_inst:79,zmf_cpm_provision_software_servic:80,zmf_cpm_remove_software_inst:81,zmf_sca:69,zmf_swmgmt_identify_missing_critical_upd:82,zmf_swmgmt_identify_missing_fixcat_upd:83,zmf_swmgmt_search_software_upd:84,zmf_workflow:70,zmf_workflow_complet:85,zmf_zmsc_run_management_servic:86,zoau:[0,42,57],zos_apf:17,zos_arch:18,zos_backup_restor:19,zos_blockinfil:20,zos_copi:[21,95],zos_data_set:22,zos_encod:23,zos_fetch:[24,95],zos_find:25,zos_gather_fact:26,zos_import_mock:[14,47],zos_job_output:27,zos_job_queri:28,zos_job_submit:29,zos_lineinfil:30,zos_mount:31,zos_mvs_raw:32,zos_oper:33,zos_operator_action_queri:34,zos_p:35,zos_script:36,zos_tso_command:37,zos_unarch:38,zos_volume_init:39}}) \ No newline at end of file +Search.setIndex({docnames:["faqs/faqs","ibm_zos_cics/docs/ansible_content","ibm_zos_cics/docs/source/community_guides","ibm_zos_cics/docs/source/modules","ibm_zos_cics/docs/source/modules/aux_temp_storage","ibm_zos_cics/docs/source/modules/aux_trace","ibm_zos_cics/docs/source/modules/cmci_action","ibm_zos_cics/docs/source/modules/cmci_create","ibm_zos_cics/docs/source/modules/cmci_delete","ibm_zos_cics/docs/source/modules/cmci_get","ibm_zos_cics/docs/source/modules/cmci_update","ibm_zos_cics/docs/source/modules/csd","ibm_zos_cics/docs/source/modules/global_catalog","ibm_zos_cics/docs/source/modules/local_catalog","ibm_zos_cics/docs/source/modules/local_request_queue","ibm_zos_cics/docs/source/modules/region_jcl","ibm_zos_cics/docs/source/modules/stop_region","ibm_zos_cics/docs/source/modules/td_intrapartition","ibm_zos_cics/docs/source/modules/transaction_dump","ibm_zos_cics/docs/source/release_notes","ibm_zos_cics/docs/source/requirements_managed","ibm_zos_core/docs/ansible_content","ibm_zos_core/docs/source/community_guides","ibm_zos_core/docs/source/community_guides_docs/better_arg_parser","ibm_zos_core/docs/source/community_guides_docs/zos_ansible_module_testing","ibm_zos_core/docs/source/filters","ibm_zos_core/docs/source/modules","ibm_zos_core/docs/source/modules/zos_apf","ibm_zos_core/docs/source/modules/zos_archive","ibm_zos_core/docs/source/modules/zos_backup_restore","ibm_zos_core/docs/source/modules/zos_blockinfile","ibm_zos_core/docs/source/modules/zos_copy","ibm_zos_core/docs/source/modules/zos_data_set","ibm_zos_core/docs/source/modules/zos_encode","ibm_zos_core/docs/source/modules/zos_fetch","ibm_zos_core/docs/source/modules/zos_find","ibm_zos_core/docs/source/modules/zos_gather_facts","ibm_zos_core/docs/source/modules/zos_job_output","ibm_zos_core/docs/source/modules/zos_job_query","ibm_zos_core/docs/source/modules/zos_job_submit","ibm_zos_core/docs/source/modules/zos_lineinfile","ibm_zos_core/docs/source/modules/zos_mount","ibm_zos_core/docs/source/modules/zos_mvs_raw","ibm_zos_core/docs/source/modules/zos_operator","ibm_zos_core/docs/source/modules/zos_operator_action_query","ibm_zos_core/docs/source/modules/zos_ping","ibm_zos_core/docs/source/modules/zos_script","ibm_zos_core/docs/source/modules/zos_tso_command","ibm_zos_core/docs/source/modules/zos_unarchive","ibm_zos_core/docs/source/modules/zos_volume_init","ibm_zos_core/docs/source/plugins","ibm_zos_core/docs/source/reference/community","ibm_zos_core/docs/source/reference/documentation","ibm_zos_core/docs/source/release_notes","ibm_zos_core/docs/source/requirements_managed","ibm_zos_core/docs/source/resources/character_set","ibm_zos_core/docs/source/resources/releases_maintenance","ibm_zos_core/docs/source/resources/resources","ibm_zos_ims/docs/ansible_content","ibm_zos_ims/docs/source/community_guides","ibm_zos_ims/docs/source/community_guides_docs/zos_ansible_module_testing","ibm_zos_ims/docs/source/modules","ibm_zos_ims/docs/source/modules/ims_acb_gen","ibm_zos_ims/docs/source/modules/ims_catalog_populate","ibm_zos_ims/docs/source/modules/ims_catalog_purge","ibm_zos_ims/docs/source/modules/ims_command","ibm_zos_ims/docs/source/modules/ims_dbd_gen","ibm_zos_ims/docs/source/modules/ims_dbrc","ibm_zos_ims/docs/source/modules/ims_ddl","ibm_zos_ims/docs/source/modules/ims_psb_gen","ibm_zos_ims/docs/source/release_notes","ibm_zos_ims/docs/source/requirements_managed","ibm_zos_sysauto/docs/ansible_content","ibm_zos_sysauto/docs/source/community_guides","ibm_zos_sysauto/docs/source/release_notes","ibm_zos_sysauto/docs/source/requirements_managed","ibm_zos_sysauto/docs/source/roles","ibm_zos_sysauto/docs/source/roles/sa_create_dynamic_resource","ibm_zos_sysauto/docs/source/roles/sa_delete_dynamic_resource","ibm_zosmf/docs/ansible_content","ibm_zosmf/docs/source/community_guides","ibm_zosmf/docs/source/modules","ibm_zosmf/docs/source/modules/zmf_authenticate","ibm_zosmf/docs/source/modules/zmf_sca","ibm_zosmf/docs/source/modules/zmf_workflow","ibm_zosmf/docs/source/release_notes","ibm_zosmf/docs/source/requirements_control","ibm_zosmf/docs/source/requirements_managed","ibm_zosmf/docs/source/resources","ibm_zosmf/docs/source/roles","ibm_zosmf/docs/source/roles/zmf_cpm_create_software_instance","ibm_zosmf/docs/source/roles/zmf_cpm_get_software_instance","ibm_zosmf/docs/source/roles/zmf_cpm_list_software_templates","ibm_zosmf/docs/source/roles/zmf_cpm_manage_software_instance","ibm_zosmf/docs/source/roles/zmf_cpm_provision_software_service","ibm_zosmf/docs/source/roles/zmf_cpm_remove_software_instance","ibm_zosmf/docs/source/roles/zmf_swmgmt_csi_query","ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates","ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates","ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates","ibm_zosmf/docs/source/roles/zmf_swmgmt_zos_system_uuid","ibm_zosmf/docs/source/roles/zmf_workflow_complete","ibm_zosmf/docs/source/roles/zmf_zmsc_run_management_service","index","installation/installation","playbooks/playbooks","reference/community","reference/documentation","reference/helpful_links","release/release","requirements/requirements","troubleshooting/errorsandmessages","zhmc-ansible-modules/docs/ansible_content","zhmc-ansible-modules/docs/source/bibliography","zhmc-ansible-modules/docs/source/development","zhmc-ansible-modules/docs/source/modules","zhmc-ansible-modules/docs/source/modules/zhmc_adapter","zhmc-ansible-modules/docs/source/modules/zhmc_adapter_list","zhmc-ansible-modules/docs/source/modules/zhmc_console","zhmc-ansible-modules/docs/source/modules/zhmc_cpc","zhmc-ansible-modules/docs/source/modules/zhmc_cpc_list","zhmc-ansible-modules/docs/source/modules/zhmc_crypto_attachment","zhmc-ansible-modules/docs/source/modules/zhmc_hba","zhmc-ansible-modules/docs/source/modules/zhmc_lpar","zhmc-ansible-modules/docs/source/modules/zhmc_lpar_list","zhmc-ansible-modules/docs/source/modules/zhmc_nic","zhmc-ansible-modules/docs/source/modules/zhmc_nic_list","zhmc-ansible-modules/docs/source/modules/zhmc_partition","zhmc-ansible-modules/docs/source/modules/zhmc_partition_list","zhmc-ansible-modules/docs/source/modules/zhmc_password_rule","zhmc-ansible-modules/docs/source/modules/zhmc_password_rule_list","zhmc-ansible-modules/docs/source/modules/zhmc_session","zhmc-ansible-modules/docs/source/modules/zhmc_storage_group","zhmc-ansible-modules/docs/source/modules/zhmc_storage_group_attachment","zhmc-ansible-modules/docs/source/modules/zhmc_storage_volume","zhmc-ansible-modules/docs/source/modules/zhmc_user","zhmc-ansible-modules/docs/source/modules/zhmc_user_list","zhmc-ansible-modules/docs/source/modules/zhmc_user_role","zhmc-ansible-modules/docs/source/modules/zhmc_user_role_list","zhmc-ansible-modules/docs/source/modules/zhmc_virtual_function","zhmc-ansible-modules/docs/source/release_notes","zhmc-ansible-modules/docs/source/requirements_managed","zhmc-ansible-modules/docs/source/troubleshooting"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":2,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["faqs/faqs.rst","ibm_zos_cics/docs/ansible_content.rst","ibm_zos_cics/docs/source/community_guides.rst","ibm_zos_cics/docs/source/modules.rst","ibm_zos_cics/docs/source/modules/aux_temp_storage.rst","ibm_zos_cics/docs/source/modules/aux_trace.rst","ibm_zos_cics/docs/source/modules/cmci_action.rst","ibm_zos_cics/docs/source/modules/cmci_create.rst","ibm_zos_cics/docs/source/modules/cmci_delete.rst","ibm_zos_cics/docs/source/modules/cmci_get.rst","ibm_zos_cics/docs/source/modules/cmci_update.rst","ibm_zos_cics/docs/source/modules/csd.rst","ibm_zos_cics/docs/source/modules/global_catalog.rst","ibm_zos_cics/docs/source/modules/local_catalog.rst","ibm_zos_cics/docs/source/modules/local_request_queue.rst","ibm_zos_cics/docs/source/modules/region_jcl.rst","ibm_zos_cics/docs/source/modules/stop_region.rst","ibm_zos_cics/docs/source/modules/td_intrapartition.rst","ibm_zos_cics/docs/source/modules/transaction_dump.rst","ibm_zos_cics/docs/source/release_notes.rst","ibm_zos_cics/docs/source/requirements_managed.rst","ibm_zos_core/docs/ansible_content.rst","ibm_zos_core/docs/source/community_guides.rst","ibm_zos_core/docs/source/community_guides_docs/better_arg_parser.rst","ibm_zos_core/docs/source/community_guides_docs/zos_ansible_module_testing.rst","ibm_zos_core/docs/source/filters.rst","ibm_zos_core/docs/source/modules.rst","ibm_zos_core/docs/source/modules/zos_apf.rst","ibm_zos_core/docs/source/modules/zos_archive.rst","ibm_zos_core/docs/source/modules/zos_backup_restore.rst","ibm_zos_core/docs/source/modules/zos_blockinfile.rst","ibm_zos_core/docs/source/modules/zos_copy.rst","ibm_zos_core/docs/source/modules/zos_data_set.rst","ibm_zos_core/docs/source/modules/zos_encode.rst","ibm_zos_core/docs/source/modules/zos_fetch.rst","ibm_zos_core/docs/source/modules/zos_find.rst","ibm_zos_core/docs/source/modules/zos_gather_facts.rst","ibm_zos_core/docs/source/modules/zos_job_output.rst","ibm_zos_core/docs/source/modules/zos_job_query.rst","ibm_zos_core/docs/source/modules/zos_job_submit.rst","ibm_zos_core/docs/source/modules/zos_lineinfile.rst","ibm_zos_core/docs/source/modules/zos_mount.rst","ibm_zos_core/docs/source/modules/zos_mvs_raw.rst","ibm_zos_core/docs/source/modules/zos_operator.rst","ibm_zos_core/docs/source/modules/zos_operator_action_query.rst","ibm_zos_core/docs/source/modules/zos_ping.rst","ibm_zos_core/docs/source/modules/zos_script.rst","ibm_zos_core/docs/source/modules/zos_tso_command.rst","ibm_zos_core/docs/source/modules/zos_unarchive.rst","ibm_zos_core/docs/source/modules/zos_volume_init.rst","ibm_zos_core/docs/source/plugins.rst","ibm_zos_core/docs/source/reference/community.rst","ibm_zos_core/docs/source/reference/documentation.rst","ibm_zos_core/docs/source/release_notes.rst","ibm_zos_core/docs/source/requirements_managed.rst","ibm_zos_core/docs/source/resources/character_set.rst","ibm_zos_core/docs/source/resources/releases_maintenance.rst","ibm_zos_core/docs/source/resources/resources.rst","ibm_zos_ims/docs/ansible_content.rst","ibm_zos_ims/docs/source/community_guides.rst","ibm_zos_ims/docs/source/community_guides_docs/zos_ansible_module_testing.rst","ibm_zos_ims/docs/source/modules.rst","ibm_zos_ims/docs/source/modules/ims_acb_gen.rst","ibm_zos_ims/docs/source/modules/ims_catalog_populate.rst","ibm_zos_ims/docs/source/modules/ims_catalog_purge.rst","ibm_zos_ims/docs/source/modules/ims_command.rst","ibm_zos_ims/docs/source/modules/ims_dbd_gen.rst","ibm_zos_ims/docs/source/modules/ims_dbrc.rst","ibm_zos_ims/docs/source/modules/ims_ddl.rst","ibm_zos_ims/docs/source/modules/ims_psb_gen.rst","ibm_zos_ims/docs/source/release_notes.rst","ibm_zos_ims/docs/source/requirements_managed.rst","ibm_zos_sysauto/docs/ansible_content.rst","ibm_zos_sysauto/docs/source/community_guides.rst","ibm_zos_sysauto/docs/source/release_notes.rst","ibm_zos_sysauto/docs/source/requirements_managed.rst","ibm_zos_sysauto/docs/source/roles.rst","ibm_zos_sysauto/docs/source/roles/sa_create_dynamic_resource.rst","ibm_zos_sysauto/docs/source/roles/sa_delete_dynamic_resource.rst","ibm_zosmf/docs/ansible_content.rst","ibm_zosmf/docs/source/community_guides.rst","ibm_zosmf/docs/source/modules.rst","ibm_zosmf/docs/source/modules/zmf_authenticate.rst","ibm_zosmf/docs/source/modules/zmf_sca.rst","ibm_zosmf/docs/source/modules/zmf_workflow.rst","ibm_zosmf/docs/source/release_notes.rst","ibm_zosmf/docs/source/requirements_control.rst","ibm_zosmf/docs/source/requirements_managed.rst","ibm_zosmf/docs/source/resources.rst","ibm_zosmf/docs/source/roles.rst","ibm_zosmf/docs/source/roles/zmf_cpm_create_software_instance.rst","ibm_zosmf/docs/source/roles/zmf_cpm_get_software_instance.rst","ibm_zosmf/docs/source/roles/zmf_cpm_list_software_templates.rst","ibm_zosmf/docs/source/roles/zmf_cpm_manage_software_instance.rst","ibm_zosmf/docs/source/roles/zmf_cpm_provision_software_service.rst","ibm_zosmf/docs/source/roles/zmf_cpm_remove_software_instance.rst","ibm_zosmf/docs/source/roles/zmf_swmgmt_csi_query.rst","ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_critical_updates.rst","ibm_zosmf/docs/source/roles/zmf_swmgmt_identify_missing_fixcat_updates.rst","ibm_zosmf/docs/source/roles/zmf_swmgmt_search_software_updates.rst","ibm_zosmf/docs/source/roles/zmf_swmgmt_zos_system_uuid.rst","ibm_zosmf/docs/source/roles/zmf_workflow_complete.rst","ibm_zosmf/docs/source/roles/zmf_zmsc_run_management_service.rst","index.rst","installation/installation.rst","playbooks/playbooks.rst","reference/community.rst","reference/documentation.rst","reference/helpful_links.rst","release/release.rst","requirements/requirements.rst","troubleshooting/errorsandmessages.rst","zhmc-ansible-modules/docs/ansible_content.rst","zhmc-ansible-modules/docs/source/bibliography.rst","zhmc-ansible-modules/docs/source/development.rst","zhmc-ansible-modules/docs/source/modules.rst","zhmc-ansible-modules/docs/source/modules/zhmc_adapter.rst","zhmc-ansible-modules/docs/source/modules/zhmc_adapter_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_console.rst","zhmc-ansible-modules/docs/source/modules/zhmc_cpc.rst","zhmc-ansible-modules/docs/source/modules/zhmc_cpc_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_crypto_attachment.rst","zhmc-ansible-modules/docs/source/modules/zhmc_hba.rst","zhmc-ansible-modules/docs/source/modules/zhmc_lpar.rst","zhmc-ansible-modules/docs/source/modules/zhmc_lpar_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_nic.rst","zhmc-ansible-modules/docs/source/modules/zhmc_nic_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_partition.rst","zhmc-ansible-modules/docs/source/modules/zhmc_partition_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_password_rule.rst","zhmc-ansible-modules/docs/source/modules/zhmc_password_rule_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_session.rst","zhmc-ansible-modules/docs/source/modules/zhmc_storage_group.rst","zhmc-ansible-modules/docs/source/modules/zhmc_storage_group_attachment.rst","zhmc-ansible-modules/docs/source/modules/zhmc_storage_volume.rst","zhmc-ansible-modules/docs/source/modules/zhmc_user.rst","zhmc-ansible-modules/docs/source/modules/zhmc_user_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_user_role.rst","zhmc-ansible-modules/docs/source/modules/zhmc_user_role_list.rst","zhmc-ansible-modules/docs/source/modules/zhmc_virtual_function.rst","zhmc-ansible-modules/docs/source/release_notes.rst","zhmc-ansible-modules/docs/source/requirements_managed.rst","zhmc-ansible-modules/docs/source/troubleshooting.rst"],objects:{},objnames:{},objtypes:{},terms:{"0000000bba01":49,"000c":43,"000d":43,"000e":43,"000f":43,"00106f237ab1":135,"00106f239c31":[116,119,121,125,127,132,134],"00106f239d19":[119,125,127,132,134],"00106f25b43c":137,"009c0f4c":[132,134],"01a0":39,"023f":125,"033f":139,"0706c00180000000000000000070e050":123,"083c":39,"0c99":135,"0f03":39,"0ick00703i":49,"0ick01314i":49,"0ick04000i":49,"0xc1":55,"100088947155a1e9":[116,132],"100mb":29,"1036k":39,"1048k":39,"10c":[117,119],"10fa8489":123,"10m":37,"11548k":37,"11740k":39,"11896k":39,"11e8":[116,119,121,125,127,132],"11e9":[119,129,132,134,135],"11ea":[119,125,127],"11eb":135,"11ec":137,"11m":39,"123f":122,"12c":116,"131a":15,"14m":39,"15t02":[6,7,8,9,10],"16s":[116,132],"1768k":39,"1876480k":39,"19e90e27":135,"1appus":40,"1cae":135,"1data":37,"1gb":29,"1ickdsf":49,"200a":[132,134],"20a6":119,"240k":[37,39],"252k":39,"2535b19e":84,"256k":39,"2gb":0,"2mb":35,"32323df4":[125,127],"351b":119,"358a":132,"3dc87062":137,"3e7ed5ca28d7":[116,119,121,127,132],"3f99":[116,119,121,127,132],"422c":135,"4947c6d0":[119,127],"4a00003c":49,"4a14":[116,119,121,127,132],"4a52":84,"4a7e":129,"4e06":123,"4f01576a":123,"4gb":0,"500m":15,"50m":[24,60],"518ac1d8":135,"520c0138":129,"5695df18658i10001000":83,"58e41a42":119,"5956e97a":[125,127],"600507681081001d4800000000000083":[132,134],"60k":37,"6a46d18a":119,"8bb3":129,"8d320d5f68b048fc97559d771ede68b37a71e8374d1d678d96dcfa2b2da7a64":[31,34],"8dfc":119,"8e5b":137,"8ea3":137,"8f73":[119,127],"91773b88":135,"91ba":135,"92k":39,"9d77":84,"9fbb":119,"boolean":[23,49,53,127,132,135,140],"byte":[15,28,31,32,35,37,39,42,48,63,64,111],"case":[2,6,7,8,9,10,12,15,19,20,22,23,24,28,31,32,34,39,41,46,48,49,53,56,59,60,70,83,84,85,87,90,91,92,94,96,101,102,108,111,116,123,129,131,140],"class":[15,27,28,29,31,32,37,38,39,42,48,49,53,63,64,83,116,121,123,125,127,129,132,134,135,137],"default":[0,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,24,27,28,29,30,31,32,33,34,35,36,38,39,40,41,42,43,44,45,46,47,48,49,50,53,54,60,62,63,64,66,68,69,71,74,77,78,83,84,87,90,91,92,93,94,95,96,97,98,99,100,101,102,104,111,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],"export":[24,30,60],"final":[15,32,83,84,101,114],"float":[43,140],"function":[6,7,8,9,10,15,16,19,22,37,39,42,49,50,53,55,59,85,87,114,115,127,132,140],"import":[22,24,53,56,60,63,68,114,127,132],"int":[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,23,27,28,29,30,31,32,34,35,37,38,39,40,41,42,43,44,46,47,48,49,53,63,64,66,67,69,77,78,82,83,84,93,94,101,102,121,132],"long":[15,23,30,31,32,38,39,40,41,49,53],"new":[4,5,10,15,17,18,23,24,29,30,31,32,39,42,47,49,56,60,63,64,65,70,71,77,84,85,96,97,98,99,101,104,109,116,119,123,127,131,140],"null":[35,38,39,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],"public":[24,42,60,84,90,101],"return":[3,19,23,24,26,53,60,61,70,81,85,90,91,92,94,96,97,98,99,101,102,111,115,140],"short":[15,77,114,116,127,132],"static":[15,27],"switch":[15,42,45,112,125,127,132,133,134],"throw":[24,53,60],"transient":[3,15,19,90,91,92,94,102],"true":[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,23,24,27,28,29,30,31,32,33,34,35,38,39,40,41,42,43,44,46,47,48,49,53,60,62,63,64,65,66,67,68,69,77,78,82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],"try":[15,24,31,39,46,53,60],"var":[0,24,30,31,39,40,46,60,75,77,78,87,90,91,92,93,94,95,101,102,140],"while":[24,26,31,32,35,40,41,42,46,53,60,61,64,81,84],ACS:29,ADDED:63,AND:[35,37,39,49],ARE:64,Added:[19,53,70,85,140],Age:35,BAS:7,BMS:15,BTS:14,Bus:122,But:[24,60],CTS:9,DDs:[39,42,53],FOR:[30,37,39,49,64],For:[0,2,3,4,6,7,8,9,10,11,12,13,14,15,16,17,20,22,23,25,27,28,30,31,32,33,34,35,37,38,39,40,41,42,43,46,48,54,55,56,59,62,63,64,71,73,75,80,83,84,85,90,96,101,104,105,110,111,114,116,117,118,119,120,121,122,123,124,125,127,128,129,131,132,133,134,135,137,139],HAS:39,HFS:34,Has:53,IDs:[15,53,54,71,99],IMS:[0,15,35,44,61,68,70,71,90,93,94,95,103,106,109,110,111],Its:84,JES:[15,16,37,38,39,84,101],LDS:[31,63,64],MVS:[15,27,28,30,31,33,34,35,37,40,41,48,49,53,71],NOS:39,NOT:[24,31,34,39,53,60],Not:[28,31,32,42,48,63,64],ONE:[15,23,37],One:[35,47,88],PAS:[54,71],PDS:[11,15,23,28,30,31,32,33,34,35,39,40,48,53,63,64,66,67,69],PFS:41,PRs:140,PYS:[54,71],RLS:15,SMS:[27,28,29,31,32,42,48,49,63,64],SOS:15,SYS:[37,39,53],Such:[84,101,110],Sys:[0,103,106,109,110,111],THAT:[37,39,64],THE:[37,39,63,64],TIS:55,TLS:15,TRS:[28,48],That:[31,84,114],The:[0,1,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,46,47,48,49,53,54,55,56,58,60,61,62,63,64,65,66,67,68,69,70,71,72,75,76,77,78,79,81,82,83,84,85,87,89,90,91,92,93,94,95,96,97,98,99,100,101,102,104,105,108,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142],Then:[53,101,114],There:[0,15,29,105,114,142],These:[0,1,3,5,6,8,9,10,15,20,24,31,39,41,46,53,56,60,66,69,76,114,140],UCS:55,USING:39,Use:[0,4,5,11,12,13,14,15,17,18,24,28,29,31,35,42,48,53,60,63,64,67,104,105,116,135],Used:[29,40,50,96,97,98,99,100,125,129,132,134,135,137],Uses:[36,38],Using:[9,27,30,31,54,71],VFs:140,WAS:[37,39,49,63],WILL:[37,39],WITH:39,Will:[27,46,48,122,125,127,139],With:[24,42,60,71,85,87],YES:[15,31,41],Yes:0,ZFS:[30,34,41],ZOS:71,_________________________________________:39,__dict__:[24,60],__future__:[24,60],__init__:[24,60],__metaclass__:[24,60],_bpxk_autocvt:[24,60],_cee_runopt:[24,60],_encode_file_exist:71,_encode_file_new:71,_export_:[24,60],_keydata:[6,7,8,9,10],_play_context:53,_tag_redir_err:[24,60],_tag_redir_in:[24,60],_tag_redir_out:[24,60],_text:53,a13b:125,a142:[132,134],a14b:[116,121,132],a87c:[116,119,121,127,132],a8c3:84,a951:123,aap:[56,110,123],abbrev:39,abbrevi:[15,41],abc9abc1:15,abc:[31,35,139],abcd0001:[3,4,5,11,12,13,14,15,17,18],abcd01:15,abcdefabcdef:127,abend:[15,16,37,38,39,53],abil:[6,8,9,10,15,103,116],abl:[31,34,39,85,87],abnorm:[15,39,42,53,63,64],abnormal_disposit:[63,64],about:[0,6,7,8,9,10,15,19,24,53,60,67,71,75,85,87,90,94,102,104,105,109,110,111,114,115,116,119,121,122,123,125,127,129,132,133,134,135,137,139,140],abov:[3,15,23,77,78,85,96,97,98,99,100,111,137,140],absenc:[15,140],absent:[4,5,11,12,13,14,15,17,18,27,28,30,32,40,41,53,116,122,125,127,129,132,134,135,137,139,140],absolut:[23,24,27,28,30,31,33,34,40,41,42,48,60,83,123,127,132],absolute_import:[24,60],acb:[58,61,63,64],acb_lib:[62,63],acbgen:62,acblib:[62,63],acc:[116,121],acceler:139,accent:53,accept:[0,2,3,6,8,9,10,22,23,24,32,42,47,53,59,60,67,73,80,81,90,91,92,94,96,102,115,120,123,124,127,128,132],acceptable_statu:[119,140],access:[0,15,24,26,31,32,37,39,42,49,53,60,81,82,83,84,85,96,97,98,99,101,104,105,111,115,116,117,118,119,120,121,122,123,124,125,126,127,128,130,132,133,134,135,136,138,139],access_group:42,access_mod:[121,127],accomod:140,accord:[6,7,8,9,10],accordingli:[44,140],account:[15,23,84,101,114],accounting_inform:15,ace:15,achiev:[4,5,11,12,13,14,15,17,18,24,60,84],across:[13,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139,140],act:[23,28,31,48,53,100],action:[3,7,8,9,10,15,19,21,24,26,32,48,53,60,63,64,67,83,90,93,94,102,114,131,132,133,134,140],action_nam:6,action_paramet:6,actionobjectid:83,activ:[5,15,37,38,39,43,49,53,62,65,72,87,105,114,116,117,119,120,121,123,124,127,128,132,133,134,140],activation_mod:124,activation_profile_nam:[119,123],actual:[19,23,41,53,133],adapt:[112,115,119,121,122,125,127,132,137,139,140],adapter1:[116,117,127],adapter2:127,adapter_count:121,adapter_famili:117,adapter_id:[116,117],adapter_list:117,adapter_nam:[121,122,125,139],adapter_port:[122,125],adapter_port_uri:122,adapter_uri:139,add:[15,16,26,28,30,31,32,40,41,42,46,48,53,61,70,74,85,104,111,114,123,140],add_stylesheet:140,added:[15,19,24,27,28,31,35,36,39,40,41,42,43,46,53,60,63,70,71,105,111,121,127,140],adding:[27,45,63,140],addit:[3,15,16,20,22,23,29,36,37,38,39,49,50,52,54,59,62,70,83,86,96,97,98,99,105,107,108,110,114,116,118,119,120,121,122,123,125,127,129,132,134,135,137,139,140,141,142],addition:[24,49,60,104],additionalinfo:83,address:[15,23,37,38,39,42,49,53,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],adequ:[28,48],adher:104,adhoc:[24,60],adi:15,adjust:[15,105,140],admin:38,administr:[31,48,83,105,135],adrdssu:[28,29,42,48],advanc:53,advis:67,aes:[127,132],affect:[62,140],after:[15,16,23,24,28,30,31,34,36,39,40,41,42,46,48,53,60,63,64,70,84,101,102,105,114,121,122,123,125,127,131,132,133,134,139,140],afterward:53,again:[84,114,140],against:[0,15,24,35,60,111,114,132,133,134,140],age:[23,35],age_stamp:35,agent:15,agil:0,aging:15,ahead:15,aibridg:15,aicon:15,aiexit:15,aildelai:15,aim:[4,5,11,12,13,14,15,17,18],aiqmax:15,airdelai:15,akpfreq:15,algorithm:[0,15,28],alia:31,alias:[23,24,31,53,60],align:[53,110],all:[0,3,9,11,13,14,15,17,19,20,23,24,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,46,47,48,49,53,55,60,62,64,65,66,67,68,69,83,85,87,89,96,103,104,105,110,111,114,116,117,119,121,122,123,124,125,127,128,129,132,133,134,135,137,139,140],alldzon:96,alloc:[3,4,11,12,13,14,15,17,19,28,29,31,32,35,37,39,42,43,46,47,48,62,63,64,67,123],allow:[11,15,22,23,24,31,32,39,41,42,47,53,55,60,67,89,93,94,102,116,119,123,129,132,135,140],allow_uid:41,alltzon:96,aloadtim:[6,7,8,9,10],alon:[6,7,8,9,10,19,20],along:[53,64,65,85,101,140],alpha:[42,114,140],alphabet:[6,7,8,9,10,55,129],alphanumer:[15,49],alreadi:[4,5,11,12,13,14,15,17,18,27,31,32,34,39,42,46,53,63,84,96,97,98,99,116,119,122,123,125,127,129,132,134,135,137,139,140],also:[0,1,6,7,8,9,10,11,19,20,21,26,27,29,33,40,53,55,58,62,63,64,67,68,70,72,77,78,79,81,83,84,85,89,96,97,98,99,104,112,114,115,119,122,123,125,129,132,134,135,137,139,140,142],alter:83,altern:[15,16,22,23,24,60,111,140],although:[0,51,105,106],alwai:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,23,25,27,28,30,31,32,33,34,38,40,41,42,43,44,45,47,48,53,62,64,65,66,67,68,69,82,83,84,104,105,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],am2:140,amaters:29,amod:39,amount:[5,15,29,32,42,63,64],analog:42,analysi:64,analysis_mod:64,analyz:64,angel:123,ani:[6,7,8,9,10,11,12,13,15,17,18,23,24,28,30,31,34,35,36,37,38,39,41,42,43,44,45,48,49,53,60,62,63,64,65,68,70,82,83,84,90,92,93,94,95,96,101,102,104,110,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],anoth:[15,23,27,30,31,33,40,41,42,43,53,140],ans1234:16,ansi:[31,53],ansibl:[1,3,4,5,9,11,12,13,14,15,16,17,18,19,20,21,23,24,25,26,27,28,29,30,31,32,33,34,39,40,41,42,45,46,48,49,50,52,53,54,56,58,60,61,68,69,70,71,72,74,75,77,78,79,81,82,83,84,85,87,90,91,92,93,94,95,96,97,98,99,100,101,102,105,107,108,109,110,112,114,115,122,125,127,132,139,140],ansible_collect:[0,104],ansible_collections_ibm_zos_cor:24,ansible_collections_ibm_zos_im:60,ansible_collections_ibm_zos_ims:60,ansible_config:[0,104],ansible_date_tim:30,ansible_fact:[24,36,53,60],ansible_hostnam:30,ansible_python_interpret:111,ansible_sample_workflow_:[84,101],ansible_sample_workflow_sy1:84,ansible_shell_execut:[54,71],ansible_vers:[31,39,46],ansible_workflowname_:84,ansiblemodul:[24,60],ansitest:[6,7,8,9,10],anymor:114,anyth:108,anywher:[40,41],apar:[42,75,85],apf:[21,26,41,42,49,62],apfadm:27,apg:77,api:[0,1,3,6,7,8,9,10,15,19,20,24,27,30,40,41,42,52,53,60,72,75,77,78,83,85,87,96,97,98,99,100,104,107,110,112,113,116,117,118,119,120,121,122,123,124,125,127,128,129,132,134,135,137,139,140,141],api_polling_interval_second:[93,94,102],api_polling_retry_count:[93,94,102],api_vers:118,apist:[6,7,8,9,10],appar:15,appc:15,appear:[6,8,9,10,15,42,53,111],append:[15,27,30,31,33,34,35,40,41,104,105],appli:[15,29,31,32,36,39,41,46,47,53,66,69,75,121,123,140,142],applianc:[127,132],applic:[0,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,28,31,34,35,41,42,48,58,62,63,66,68,69,77,85,90,92,93,94,95,98,103,105,110,137],applid:[6,7,8,9,10,15,19],applmajorv:[6,7,8,9,10],applmicrov:[6,7,8,9,10],applminorv:[6,7,8,9,10],approach:[87,127,132],appropri:[0,6,27,31,53,56,77,78,85,90,91,92,93,94,95,102,104,111],approv:114,approxim:[28,53],appveyor:140,april:56,arch_level:36,architectur:[50,53,108],archiv:[0,26,29,42,48,50,53,104,114,140],archive_folder_test:48,arcroot:28,area:[15,28,31,32,42,48],arg:[24,46,60],arg_def:23,arg_typ:22,argpars:[22,23],argument:[22,42,46,53,70,84,96,97,98,99,100],around:[24,41,53,60],arr:[96,99],arrai:[83,90,93],artifact:[0,105],artifici:[116,122,125,127,132,135,137,139,140],as_resourc:6,asa:[31,53],asa_text:31,ascii:[31,71],asi:15,asid:[37,38,39,53],asif:23,ask:111,asm:114,asma90:39,asr:15,asrd:15,assembl:[53,66],assert:[24,60],assert_called_with:[24,60],assign:[6,7,8,9,10,15,16,24,31,37,38,39,46,49,60,84,96,97,98,99,101,127],assist:[16,53,83,85],associ:[6,7,8,9,10,15,19,27,31,42,43,48,50,62,65,77,84,85,90,91,93,94,96,101,102,119,132,133,134,137],associated_system_defined_user_role_nam:137,associated_system_defined_user_role_uri:137,assum:[6,8,9,10,15,16,24,30,31,33,34,40,41,42,44,46,60,77,78,90,91,92,93,94,95,96,97,98,99,100,102,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],asterisk:[27,29,38,44,96],asynchron:41,atb:[37,39],attach:[15,44,115,127,132,134,140],attempt:[31,32,39,93,94,102],attent:[83,114],attribut:[6,7,8,9,10,11,15,16,28,31,32,41,42,48,49,53,63,64,68,140],attribute1:[6,7,8,9,10],attribute2:[6,7,8,9,10],attribute3:[6,7,8,9,10],attribute4:[6,7,8,9,10],attribute5:[6,7,8,9,10],attribute6:[6,7,8,9,10],attributeerror:140,audit:[83,85],augment:25,autconn:15,auth:[42,104,140],auth_url:[0,104],authent:[6,7,8,9,10,15,24,60,75,81,83,84,87,90,91,92,93,94,95,96,97,98,99,100,101,102,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],authentication_typ:[135,140],author:[0,15,21,26,30,31,33,40,42,49,62,63,64,68,105,114],auto:[0,12,15,68,103,106,109,110,111,123,127,132],auto_commit:68,auto_reload:[31,39,46],autoasi:12,autocold:12,autocommit:68,autocvt:[24,60],autodb:[63,64],autodst:15,autogener:[127,132],autoinit:12,autoinstal:15,autom:[0,1,3,16,19,20,21,24,26,33,36,37,38,39,53,56,58,60,61,70,71,74,75,76,77,78,79,81,84,85,101,103,105,108,109,110,112,114,140],automat:[15,29,31,34,41,42,44,53,68,83,84,85,87,89,96,114,122,127,140],automation_hub:104,automationhub:[114,140],automov:[41,53],automove_list:41,autoresettim:15,autostart:12,autostart_overrid:12,autoswitch:15,autotag:[24,60],aux_temp_storag:[3,19],aux_trac:[3,19],auxiliari:[3,15,19],auxiliary_temp:19,auxtr:15,auxtrsw:15,avail:[0,6,7,8,9,10,15,23,27,28,29,30,31,32,33,34,36,39,40,41,42,46,48,49,56,65,71,103,104,105,109,114,127,132,140],available_features_list:140,ave:23,avoid:[0,22,23,30,33,40,53,140],await:44,awar:[30,36],awx:0,b1bf361886a4:123,b352:39,b447:119,b4d3:135,b67c:[125,127],b9dd:135,b_text:39,back:[3,9,21,26,27,29,30,31,34,39,40,41,42,46,48,49,53,61,122,125,139,140],backout:[11,15],backoutonli:15,backref:40,backrefer:40,backslash:43,backup:[0,26,27,30,31,32,33,34,40,41,42,49,53],backup_compress:33,backup_nam:[27,29,30,31,33,40,41,42],bad3:[132,134],bad:53,bailei:23,bak:[27,30,31,33,40,41],bar:[15,28,31],basdefinev:[6,7,8,9,10],base64:42,base:[0,4,5,11,12,13,14,15,17,18,27,28,30,31,35,39,40,46,47,49,53,54,64,67,71,83,85,87,89,114,120,124,128,136,140],bash:[54,71],basi:[55,114],basic:[6,7,8,9,10,15,24,31,32,35,42,60,63,64,66,69,105,127,130,132,135],batch:[15,16,27,32,37,38,39,47,53,62,63,65,66,69,84,101],batch_result:[66,69],bc93:132,bd0a:[125,127],bdfeb245fc36:129,bear:53,becaus:[15,23,41,53,54,63,71,84,90,91,92,94,102,105,116,122,125,127,129,132,134,135,137,139,140,141],becom:[24,41,60,111,122,125,139],become_us:111,been:[0,16,19,22,24,29,31,33,38,39,42,48,53,60,85,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],befor:[4,5,11,12,13,14,15,17,18,20,23,24,27,28,30,31,39,40,42,46,49,53,56,60,62,63,64,71,87,93,94,102,104,105,110,111,114,127,140],beforehand:31,beg:38,begin:[15,23,27,30,31,38,39,40,44,46,63,64,74,84,101],beginnendn:30,behavior:[0,15,19,31,34,53,111,140],behaviour:9,behind:[24,53,60],being:[4,5,6,7,8,9,10,11,12,13,14,15,17,18,23,27,29,30,31,32,34,39,40,41,46,53,66,69,102,114,122,125,127,129,131,132,134,135,137,139,140],belong:16,below:[3,15,19,24,42,53,55,60,83,101,111,127,132,140],benefici:[24,60],benefit:[24,60],besid:114,beta:[53,56,74,104,140],better:140,better_arg_pars:23,betterarg:22,between:[13,15,23,41,42,53,63,64,101,116,140],beyond:22,bf98:135,bgysc1310:27,bgysc1311:[30,40],bibliographi:140,big5:55,bin:[23,24,30,40,46,60,111],binari:[30,31,33,34,35,40,42,45,47,48,53,111],binconr:[6,7,8,9,10],binconsc:[6,7,8,9,10],bind:66,binder:39,binsterr:[6,7,8,9,10],bit:[15,41],blake:23,blank:[5,18,42,49,53],bldl:15,blklgth:42,blksize:[28,39,48],block:[15,26,27,28,31,32,39,42,46,48,53,58,62,63,64,66,68,69,123],block_end_str:[31,39,46],block_siz:[28,31,32,42,48,63,64],block_start_str:[31,39,46],blog:[0,85],bmp:[63,64,68],bms:15,bodi:[6,7,8,9,10,30],bof:[30,40],book:[113,116,118,119,121,122,123,125,127,129,132,134,135,137,139],bool:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,23,27,28,29,30,31,32,33,34,37,38,39,40,41,42,43,44,46,48,49,62,63,64,65,66,68,69,82,83,84,101,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],boot:[123,127,132,134,140],boot_devic:127,boot_load_paramet:140,boot_logical_unit_numb:127,boot_network_devic:127,boot_network_nic_nam:127,boot_storage_devic:127,boot_storage_device_hba_nam:127,boot_storage_hba_nam:127,boot_storage_volum:140,boot_storage_volume_nam:140,boot_world_wide_port_nam:127,bootabl:127,bootstrap:63,bootstrap_dataset:63,both:[0,11,13,15,16,17,18,23,24,29,31,40,42,53,60,62,64,66,69,71,97,98,99,111,113],bottom:15,bound:[77,78],box:[24,60],bpxprm00:30,bpxprmaa:41,bpxprmab:41,bpxprmxx:41,bpxw0003i:46,branch:[114,140],bridg:15,brief:0,bring:[1,21,58,72,79,112,140],brmaxkeeptim:15,broaden:140,broader:[1,19,21,58,70,72,74,79,85,112],broken:[24,60,74],browser:114,buffer:[15,42,43,63,64],buffer_pool_param_dataset:[63,64],bug:[0,2,19,22,53,59,70,73,80,109,114,140],bugfix:[0,19],build:[0,6,8,9,10,24,60,62,103,140],build_ignor:104,build_psb:62,builder:68,built:[0,15,19,22,62,104,114,140],builtin:45,bundl:[6,7,8,9,10],bundledir:7,busi:43,buster:140,button:114,bwo:15,bypass:[31,111],byte_count:[37,39,42,53],bz2:[28,48,53],bzip:48,c05076d24d80016e:132,c1d5e2c9e3c5e2e3:[6,7,8,9,10],c3f6:123,c44338de:119,ca_cert:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],cab:[39,53],cach:[9,15],cadenc:0,calcul:[15,28],call:[15,19,24,27,30,32,37,40,41,53,55,60,62,65,66,67,69,70,75,77,78,82,96,97,98,99,100],callabl:42,can:[1,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,23,24,25,26,27,28,29,30,31,32,33,34,35,37,38,39,40,41,42,43,45,46,48,49,53,54,55,56,60,61,62,63,64,66,67,68,69,70,71,75,76,81,82,83,84,85,87,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,110,112,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],cancel:[16,38,39,53],candid:[6,7,8,9,10,132],candidateassign:[6,7,8,9,10],candidatedescript:[6,7,8,9,10],candidategroup:[6,7,8,9,10],candidatenam:[6,7,8,9,10],candidateoverrid:[6,7,8,9,10],candidatesystemgroup:[6,7,8,9,10],candidatetyp:[6,7,8,9,10],candidateusag:[6,7,8,9,10],candidatevers:[6,7,8,9,10],cannot:[23,30,40,42,49,63,64,68,84,111,114,116,119,122,123,125,127,129,132,134,135,137,139,140],canon:119,cap:[123,127,132],capabl:41,capac:[0,53,116,123,132],captur:[40,53,90,92,94,102],card:[15,37,39,53,116,121,125,132,140],carefulli:111,cat:[0,30,63,64],catalog:[3,15,19,27,30,31,32,33,34,35,39,40,41,42,53,58,61,68,70,85,87,92,94,102],catalog_service_nam:102,catalog_service_namm:102,catalogu:53,categori:[0,3,83,84,85,98,102],category_nam:102,catlg4:47,catlg:[53,63,64],caught:53,caus:[15,24,37,39,53,62,64,70,114,140],caution:[31,53],cbp:123,cca:[116,121],ccg:47,cchh:49,ccsid:[15,41,55],cctext:65,cdsa:15,cdsasz:15,cedf:[6,7,8,9,10],cedfstatu:[6,7,8,9,10],ceemsg:15,ceeout:15,cemt:16,center:15,central:[15,70,123],certain:[24,60,63,67,76,81,89,129,132,135,137,140],certexpirywarn:15,certif:[6,7,8,9,10,15,53,82,83,84,101,110,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],certifi:[1,19,21,52,53,58,70,72,74,79,85,104,105,107,108,110,112,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],cesd:16,cf79:119,cfg:[0,45,104,105],chain:[6,7,8,9,10,15,47,53,82,83,84,101],chang:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,23,24,27,30,31,32,33,37,38,39,40,41,42,43,44,46,54,56,60,62,63,68,70,71,74,82,83,84,102,104,111,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],change_record_numb:102,changeag:[6,7,8,9,10],changeagrel:[6,7,8,9,10],changedataset:83,changetim:[6,7,8,9,10],changeusrid:[6,7,8,9,10],channel:[108,116,121,123,132],charact:[6,7,8,9,10,11,15,16,23,27,28,29,30,31,33,34,35,38,39,40,41,42,43,44,46,49,53,57,64,129,140],characterist:42,charset:[30,31,33,34,40,46],chdir:46,check:[4,5,14,15,23,24,26,31,32,34,41,48,49,53,60,63,83,84,101,114,133,140],check_format:27,check_req:114,check_timestamp:[63,70],checkout:114,checkpoint:[63,64],checksum:[31,34],child:[119,127,140],chkstrm:15,chkstsk:15,chmod:42,choic:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,23,27,28,29,30,31,32,35,39,40,41,42,46,48,53,54,62,63,64,66,69,70,71,83,84,101,116,118,119,121,122,123,125,127,129,131,132,133,134,135,137,139],chomp:42,choos:[16,24,35,56,60,104],chosen:55,chown:[28,31,48],cic:[2,5,18,19,20,27,90,92,93,94,95,103,106,109,110,111],cics13:35,cics_data_set:[3,11,12,13,15,19],cicsapi:[6,7,8,9,10],cicsbundl:[6,8],cicsdefinitionbundl:[7,8,9,10],cicsdefinitionprogram:9,cicslocalfil:9,cicsplex:[1,3,15,19,20],cicsprogram:6,cicsregion:9,cicssi:[6,8,9,10],cicssvc:15,cicsts61:[3,11,12,13,15],cilock:15,circumv:140,circumvent:140,citi:23,clarifi:140,classic:[115,117,119,120,123,128,137,140],classifi:20,clean:[0,53,105,114],clean_staging_dataset:63,cleanup:[114,140],clear:[24,60,111,123,140],cli:[20,31,34],click:[114,140],client:[1,6,7,8,9,10,15,45,82,83,84,101,103,104],clintcp:15,clist:46,clone:[0,104,114],close:[15,30,114],cloud:[85,87,88,90,91,92,94,95,104],clsdstp:15,clt:15,cluster:[35,42,53,123],cma:[6,7,8,9,10,15],cmci:[1,3,6,7,8,9,10,19],cmci_:0,cmci_act:[3,19],cmci_cert:[6,7,8,9,10],cmci_creat:[3,19],cmci_delet:[3,19],cmci_get:[0,3,6,8,10,19],cmci_group:19,cmci_host:[6,7,8,9,10],cmci_kei:[6,7,8,9,10],cmci_password:[6,7,8,9,10],cmci_port:[6,7,8,9,10],cmci_upd:[3,19],cmci_us:[6,7,8,9,10],cmd:[16,30,31,40,41,42,43,46,53],cmdprot:15,cmdsec:15,cna:140,cnv:[39,53],cobolsrc:31,coboltyp:[6,7,8,9,10],cobu:35,code:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,24,27,30,31,34,35,37,38,39,41,42,43,46,47,49,53,55,60,62,63,64,65,66,67,68,69,83],codec:111,cogpsbl2:69,cogpsbl:69,cold:[12,13,15],colleciton:140,collect:[1,2,3,11,15,16,19,20,21,24,25,26,36,37,38,39,50,51,52,53,54,56,58,60,61,67,70,71,72,74,75,76,77,78,79,81,85,86,87,89,90,91,92,93,94,95,96,97,98,99,100,102,103,104,106,107,108,109,110,112,114,115,135,140,141,142],colo:[127,132],colon:[66,69],column:[42,53,114],com:[6,7,8,9,10,82,96,97,98,99,100,104,114,140],combin:[6,8,9,10,23,42,62,70,114,116],come:[36,50,51,103,106],comma:35,command:[0,6,7,8,9,10,15,16,19,20,21,24,26,27,28,30,31,34,35,41,42,44,46,48,49,53,55,58,60,61,62,71,81,83,96,97,98,99,100,104,105,108,110,111,114,115,121,127,132],command_input:62,comment:[0,2,22,31,39,40,41,46,59,73,77,80],comment_end_str:[31,39,46],comment_start_str:[31,39,46],commit:[68,114],common:[15,27,29,30,33,34,39,40,52,53,105,107,108,140],commun:[2,15,16,22,46,51,59,73,80,103,104,105,106],communicationsserv:15,comn01:27,comnuc:35,compar:[32,35,84,140],compat:[28,140],compil:[44,66,67,69],complement:50,complet:[6,8,16,24,31,32,37,38,39,41,43,46,49,53,60,65,67,84,85,89,90,91,92,93,94,102,119,132,134],complete_check_delai:101,complete_check_tim:101,complex:[0,6,8,9,10,23,28],complex_filt:[6,8,9,10],complianc:70,compliant:140,complic:[6,8,9,10],compon:[15,20,35,53,56,72,75],compos:[6,7,8,9,10],compress:[28,29,33,48,62,70],comput:[28,31,36,53],concaten:[15,42,62,63,64,68],concept:116,concurr:[6,7,8,9,10,15,62],cond:[37,39],condit:[0,11,12,13,15,17,18,31,44,49,53,96,140],condition:53,conf:[31,114],confdata:15,config:[24,60],configur:[6,7,8,9,10,15,19,22,23,27,30,31,33,39,40,41,46,53,54,59,71,75,77,78,83,84,85,87,90,102,103,104,105,110,111,112,116,121,127,132,133,134,137,140],conflict:[0,84,101,140],conform:[15,63],conftxt:15,conjunct:[0,22,42],connect:[0,3,6,7,8,9,10,15,20,24,44,60,75,87,103,104,111,132],connect_vers:[6,7,8,9,10],consecut:[64,129],consid:[15,23,24,35,41,42,46,60,63,64,84,114,121],consist:[15,53,84,101,104,105,118,140],consnam:16,consol:[15,16,43,104,105,112,113,114,118,129,132,135,137],consolid:62,constant:[24,60],constraint:114,construct:[15,30,40,127],consult:[6,31,53],contact:[24,60,111],contain:[0,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,23,24,26,27,28,29,30,31,34,35,37,38,39,40,41,42,43,44,45,46,49,53,60,61,62,63,64,67,68,70,76,81,83,85,89,90,96,97,98,99,100,105,114,115,122,123,125,127,129,131,132,134,135,137,139,140],content:[1,2,4,5,11,15,16,17,18,19,21,22,23,24,29,30,31,32,34,35,37,39,40,41,42,43,44,47,48,49,52,53,58,59,60,62,63,64,66,68,69,70,72,73,74,79,80,84,85,89,101,104,105,107,108,110,111,112,114],content_typ:[37,39],context:[6,7,8,9,10],contigu:15,continu:[0,15,31,34,39,42,46,53,111],contribut:[103,105],control:[0,3,6,7,10,11,12,15,16,20,25,26,28,31,34,39,41,42,46,48,49,50,53,56,58,61,62,63,64,66,67,68,71,83,84,85,90,92,93,94,95,101,104,111,121,123,127,132,135,140],control_domain:121,control_stat:63,convent:[29,31,63,104],convers:[15,28,29,30,31,33,34,40,48,140],convert:[16,30,31,33,34,37,38,39,40,41,46,53,55],coordin:[53,103],copi:[6,7,8,9,10,15,21,24,26,28,34,37,39,41,42,46,48,50,53,55,60,66,69,104],coprocessor:[121,127,132],core:[0,20,25,26,41,50,52,53,54,56,58,70,103,106,107,109,110,111,114,123,140],corp:36,correct:[30,31,40,53],correctli:[46,53,111,140],correspond:[6,15,19,28,31,34,41,46,48,53,64,67,100,105,108,109,114,123,140],corrupt:53,cost:54,could:[0,24,31,37,38,39,46,49,53,60,84,140],count:[9,15,37,39,44,116,129,131,132,140],counter:[15,127,132],countri:23,coupl:[0,15],cover:[19,85,112,113,114,140],coverag:[70,114,140],coveral:140,cpc1:[117,119,124,126,128,137],cpc2:137,cpc:[115,116,117,121,122,123,124,125,126,127,128,132,133,134,137,139,140],cpc_list:[120,131],cpc_name:[116,117,121,122,123,124,125,126,127,128,132,133,134,139],cpca:[117,119,120,124,126,127,128,132],cpca_sg_mgmt1:132,cpca_sg_part1:119,cpca_sg_part2:119,cpid:123,cpm_template_nam:94,cpsm610:15,cpsm:[6,7,8,9,10,15],cpsm_data_set:15,cpsm_reason:[6,7,8,9,10],cpsm_reason_cod:[6,7,8,9,10],cpsm_respons:[6,7,8,9,10],cpsm_response_cod:[6,7,8,9,10],cpsmconn:15,cpu:[36,37,39,112],creat:[0,1,3,5,10,18,19,21,24,27,28,29,30,31,32,33,35,37,38,39,40,41,42,44,46,48,49,53,60,62,63,65,68,69,72,76,84,85,87,89,91,96,97,98,99,101,104,105,114,115,117,118,119,120,121,123,124,126,128,130,131,133,136,138,140],create_dataset:[24,60],create_paramet:7,createinstancedirectori:84,createno:68,createy:68,creation:[5,18,32,53,77,84,101,114,131,140],creation_d:[35,37,38,39],creation_tim:[37,38,39],credenti:[74,82,83,84,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],creslib:67,cresp1:[6,7,8,9,10],cresp2:[6,7,8,9,10],criteria:[6,8,9,10,16,35,37,38,64],critic:[42,89],crl:15,crlprofil:15,cross:[15,68,127,132],crt:82,cryp00:121,cryp01:121,crypto1:121,crypto:[115,116,127,132,140],crypto_adapter_nam:127,crypto_adapter_uri:127,crypto_configur:[121,127],crypto_domain_configur:127,crypto_numb:140,crypto_typ:[116,121],cryptograph:137,cryptographi:140,cryptographydeprecationwarn:140,crystal:23,csd:[3,7,9,10,15,16,19],csdacc:15,csdapi:[6,7,8,9,10],csdbkup:15,csdbufnd:15,csdbufni:15,csdcopi:6,csddisp:15,csddsn:15,csdfrlog:15,csdgroup:[6,7,8,9,10],csdinteg:15,csdjid:15,csdlsrno:15,csdrecov:15,csdrecovsystem:15,csdrl:15,csdstrno:15,csdup:[11,19],csi:89,csi_data_set_nam:96,csi_query_respons:96,csi_query_response_fil:96,csp:47,cspf1:[121,127],csvapf:27,ctl:65,cts610:15,cull:35,curl_ca_bundl:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],currency_symbol:23,currency_typ:23,current:[0,2,4,5,11,12,13,14,15,17,18,22,23,27,28,31,34,35,38,42,48,49,54,56,59,66,68,69,71,72,73,80,83,84,90,94,101,102,104,110,114,117,120,123,124,127,128,132,133,135,140],currentloc:[6,7,8,9,10],currtask:9,custom:[3,15,16,22,27,28,30,31,48,67,76,90,92,93,94,95,123,129],customiz:30,cve:140,cwa:15,cwakei:15,cycl:[56,110],cyl:[4,5,11,12,13,14,15,17,18,28,29,31,32,39,42,48,49],cylind:[4,5,11,12,13,14,15,17,18,49],cyp:[24,60],d0000101:[37,39],d0000102:[37,39],d0000103:37,d112:116,d113:132,d17:47,d52:47,d67:47,dae:15,dai:[15,35,64,114],darv1:42,dasd:49,data:[1,3,6,7,8,9,10,11,12,13,14,19,21,22,23,25,26,27,33,37,39,41,42,46,47,49,50,53,54,55,58,61,62,63,64,65,66,67,69,70,71,89,91,97,98,99,111,116,117,118,119,120,121,122,123,124,125,127,128,129,132,134,135,137,139,140],data_class:[63,64],data_set:[11,15,23,29,35,39,53,66,69],data_set_bas:23,data_set_memb:23,data_set_nam:[3,4,5,11,12,13,14,15,17,18,27,42],data_set_or_path:23,data_set_organ:[4,5,11,12,13,14,15,17,18,19],data_set_typ:34,data_stor:41,databas:[15,31,42,58,62,63,64,66,67,68],datacla:39,dataloc:[6,7,8,9,10],dataset:[24,27,28,29,30,31,32,33,34,35,39,40,41,42,47,48,49,53,60,62,67,68],dataset_nam:[63,64],datasetcreateerror:[24,60],date:[15,23,27,35,37,38,39,53,56,114],datform:15,db2:[90,92,93,94,95],db2conn:15,db2entri:15,db2f0bec:[125,127],db2run:30,db2sms10:29,db2ssid:30,db682456:132,dbc1:43,dbctl:15,dbctlcon:15,dbd1:[62,66],dbd2:[62,66],dbd3:[62,66],dbd4:62,dbd5:62,dbd6:62,dbd:[58,61,62,63,64,67],dbd_lib:[62,63,64,67],dbd_name:[62,66],dbdgen00:39,dbdgen:[39,66,70],dbdlib1:62,dbdlib2:62,dbdlib3:62,dbdlib:[39,62,63,64,66,67],dbdname:62,dbdsrc:39,dbf000:64,dbrc:[58,61,63,64],dbrc_output:67,dbrm:31,dbver:64,dcb:37,dd_concat:[42,53],dd_data_set:[42,53],dd_dummi:42,dd_input:[42,53],dd_name:42,dd_output:42,dd_unix:[42,53],dd_vio:42,ddde026c:119,ddl:[58,61],ddmmyi:15,ddnama:53,ddname:[37,39,47,53,66,69],dds:[42,53],deactiv:[15,119,123,140],dead:41,debug1:[84,101],debug:[15,24,60,62,91,140],debugtool:15,dec:56,decid:53,decim:[15,28,31,41,48,116,119,122,123,125,127,129,132,134,135,137,139,140],declar:3,decod:[53,111],decodeerror:53,decompress:29,dedbjn21:66,dedbjnv1:66,def:[11,23,24,60],default_group_nam:135,default_group_uri:135,default_sysout_class:15,defer:15,defin:[4,5,7,11,12,13,14,15,16,17,18,22,27,28,29,30,31,32,39,41,42,46,48,49,53,55,63,64,66,68,70,72,83,84,91,96,97,98,99,105,111,114,116,119,122,123,125,127,129,132,134,135,136,137,138,139,140],definesourc:[6,7,8,9,10],definetim:[6,7,8,9,10],definit:[1,3,6,8,11,12,15,16,19,23,37,39,42,58,61,66,84,101,129,135,140],degrad:[127,132],delai:[15,42,53,135],deleg:[0,20,110],delegate_to:[20,87],delet:[1,3,4,5,11,12,13,14,15,17,18,19,27,28,29,31,32,34,39,42,47,48,53,62,63,64,67,70,72,76,84,101,114,116,122,123,125,127,129,131,132,134,135,137,139,140],delete_dbd_by_vers:64,delimit:31,deliv:0,deliveri:15,demand:15,demetri:23,demo01:49,demo02:49,demo03:49,demo0:49,demo:[39,85],demonstr:[19,53,105,131],deni:[24,60],denot:104,depend:[0,20,22,26,28,31,32,36,42,48,53,54,56,59,71,84,85,87,93,104,109,110,111,114,140],deploy:[0,103,105],deprec:[19,111,114,135,140],deprovis:[1,3,19,90,93,95],depth:23,deriv:15,des:[127,132],describ:[0,27,30,31,33,40,41,43,56,63,64,65,66,93,96,97,98,99,100,113,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],descript:[6,7,8,9,10,23,24,53,60,62,67,77,83,84,90,96,101,114,116,119,120,121,122,123,124,125,127,128,129,132,134,135,137,139,140],descriptor:[15,37,38,39,49,58,62,66,83,85,87],design:[22,23,24,60],desir:[23,24,28,32,41,42,48,53,60,83,84,116,118,119,121,122,123,125,127,129,131,132,133,134,135,137,139],desktop:110,dest:[28,31,33,34,47,48,53,66,69],dest_creat:31,dest_data_set:[28,31,48,53],dest_dataset:53,dest_path:48,dest_stat:28,dest_volum:48,destin:[5,15,18,27,28,29,30,31,33,34,39,40,41,46,48,53,55],destination_attribut:31,destinatt:41,destmem:31,detach:[121,133],detail:[0,3,6,8,9,10,16,19,25,31,53,71,75,85,87,96,105,109,110,114,116,117,119,120,121,122,123,124,125,127,128,133,139,140],detect:[15,31,34,39,46,48,53,84,101,116,121,132],determin:[0,6,7,8,9,10,15,23,29,31,33,35,39,41,42,46,48,53,55,63,64,83,84,85,97,98,99,104,105,110,123,140],dev1:[41,114],dev2:41,dev3:41,dev4:41,dev5:41,dev6:41,dev7:41,dev9:41,dev:[104,114,127,132,140],develop:[52,56,103,107,140],devic:[15,16,29,31,41,42,43,49,125,127,132,134],device_numb:[122,125,139],dfb2147a:[116,119],dfh:[9,15,27],dfhauxt:[5,15],dfhbuxt:[5,15],dfhccutl:13,dfhcnv:15,dfhcsd:[11,15],dfhcsdup:[11,16],dfhcxrf:15,dfhdip:15,dfhdmpa:[15,18],dfhdmpb:[15,18],dfhgcd:[3,12,15],dfhintra:[15,17],dfhlcd:[13,15],dfhlist:15,dfhlrq:[14,15],dfhrmutl:12,dfhrpl:15,dfhsip:15,dfhsm0136i:15,dfhstart:15,dfhtcp:15,dfhtemp:[4,15],dfhterml:15,dfltuser:15,dfs3139i:44,dfs3id00:68,dfs3pu00:63,dfs3pu10:64,dfs4434i:63,dfs4810i:64,dfs671i:64,dfscp001:63,dfsdf_member:[63,64,70],dfsdfcat:[63,64],dfsdfxxx:[63,64,68,70],dfsmsdss:[28,29,48],dfsmsrmm:83,dfsort:42,dfsrrc00:42,dfsvsmhp:[63,64],diagnost:[6,7,8,9,10,43,127,132],dialog:114,dict:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,23,27,28,29,31,32,33,34,36,37,38,39,41,42,44,46,47,48,49,63,64,65,66,67,69,83,84,90,93,94,101,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],dictionari:[6,8,9,10,15,23,24,27,36,37,38,53,60,90,93,94,116,119,122,123,125,127,129,132,134,135,137,139,140],did:[41,53,83,114,140],differ:[0,3,6,8,9,10,15,19,20,23,26,28,31,32,34,39,46,53,54,56,61,63,68,71,81,84,101,123,137,140],difficulti:140,digit:[38,49,63,64],dip:15,dir:[30,31,40],direct:[24,31,34,42,49,60,132],directli:[11,15,24,31,60,62,63,68,96,135],directori:[0,15,23,25,28,31,32,33,34,35,39,40,41,42,46,48,53,54,63,64,68,71,84,90,91,92,93,94,95,96,97,98,99,102,104,111,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],directory_block:[28,31,32,42,48],directory_dataset:63,directory_staging_dataset:63,disabl:[6,7,8,9,10,15,135,140],discard:[8,19],discord:108,discourag:[54,71],discov:114,discuss:[53,105,108],disk:[49,53,123],dismacp:15,disp:[30,31,32,39,40,53],dispatch:15,displai:[15,26,27,43,53,85,87,90,91,92,94,96,97,98,99,100,102,114,140],disposit:[15,30,32,40,42,63,64],disposition_abnorm:[42,53],disposition_norm:[42,53],disrupt:[60,135],dist:114,distribut:[15,71,103,104,111,114,140],divis:[24,60],dli:[63,64,68],dlib:96,dlord6:39,dmod:[30,53],dmp:119,dmy:37,dns:[123,127,132],doc:[0,6,7,8,9,10,24,26,53,60,74,81,96,97,98,99,100,111,114,115,140],doccodepag:15,docker:140,docs_build:114,docs_loc:114,docsloc:114,doctor_appointment_d:23,document:[1,3,6,8,9,10,15,19,20,21,25,26,30,31,33,34,39,40,41,42,44,46,50,53,58,61,62,70,71,72,74,75,76,79,81,83,85,87,88,89,103,105,108,111,112,115,140],doe:[0,4,5,11,12,13,14,15,16,17,18,23,24,28,31,32,34,35,40,42,46,48,49,53,60,62,63,66,68,69,83,84,101,114,116,122,123,125,127,129,131,132,133,134,135,137,139,140],doesn:[4,6,7,10,11,12,13,14,17,19,31,96,97,98,99,111],doing:[31,34],domain:[13,15,94,121,127,140],domain_config:121,domain_index:127,domain_nam:94,domain_rang:121,don:[20,34,41,42],done:[27,30,31,34,36,40,41,87,114,127,140],dopt:[63,68],dot:104,dotal:44,doubl:[29,30,43,53],down:16,download:[54,71],dpm:[115,116,119,120,121,122,124,125,127,132,133,134,137,139,140],dpm_enabl:120,draft:114,drain:41,drive:[0,24,60,83,87],drop:[42,68,140],dropdown:104,ds1:[27,42],ds2:27,ds3:27,ds_name:[24,30,60],ds_name_2:30,dsa:15,dsalim:15,dsed:40,dsedhelp:40,dshipidl:15,dshipint:15,dsi:44,dskeylbl:42,dsmembr1:66,dsmembr2:66,dsmembr3:66,dsmembr4:66,dsn120:47,dsn130:47,dsn210:47,dsn3epx:43,dsn:[3,4,5,11,12,13,14,15,17,18,30,39],dsname:[9,15,24,47,60],dsncat:47,dsntep12:30,dsntep2:30,dsntype:42,dsrtpgm:15,dtrpgm:15,dtrtran:15,due:[0,24,60,140],dummi:[37,39],dummy_dict:[24,60],dump:[3,15,19,29,63,127],dumpd:15,dumpsw:15,dupact:6,duplic:[53,63,70,140],duplist:63,durat:[37,39,53],dure:[4,5,11,12,13,14,15,16,17,18,19,23,24,29,30,31,32,34,37,40,41,42,43,44,48,53,60,62,68,75,82,83,84,87,105,140],duretri:15,dynalloc:[53,67],dynam:[15,27,63,67,72,76,116,121,122,125,127,132,133,134,139],dynamic_allocation_dataset:67,dynamic_programview:68,dynamicprogramview:68,dynamstatu:[6,7,8,9,10],dzp:29,e03d413a:132,e0ea33d6:132,e1274d16:121,e30bb920f912:84,e3a63476c2f8:137,e578:[116,119,121,125,127,132],e730:[6,7,8,9,10],e8c098cb:137,e8d8:49,each:[0,3,6,7,8,9,10,15,19,24,26,28,30,31,32,41,42,46,47,48,51,52,53,54,55,56,60,61,63,66,67,69,71,76,81,85,87,89,93,94,101,102,103,104,105,106,107,108,110,114,115,116,119,124,128,131,137,140],earlier:[104,140],easi:[0,85,87,89,103,105,114],easiest:0,easili:[0,41,105,140],ebcdic:[37,39,55],ec33017a:43,ec33018a:36,ecdsa:15,ecdsasz:15,ecosystem:103,edc5129i:111,edd782f2:[132,134],edg:83,edit:[21,30,84,114],edsalim:15,eee82e26937c:123,effect:[4,5,11,12,13,14,15,17,18,24,42,114,140],effort:103,eibfn:[6,7,8,9,10],eibfn_alt:[6,7,8,9,10],eight:31,either:[6,8,9,10,12,15,19,20,23,27,28,29,30,31,33,34,35,40,41,42,43,44,48,53,62,63,64,70,82,84,85,87,101,105,110,114],eject:15,elaps:[15,43,53],element:[6,8,9,10,15,23,27,28,32,35,36,37,38,39,41,42,44,45,47,48,49,55,62,63,64,65,66,67,68,69,70,83,116,117,119,120,121,122,123,124,125,126,127,128,129,130,132,134,136,137,138,139,140],elev:111,elig:[6,7,8,9,10,15,64],els:31,email:135,embed:53,emerg:[15,53],empti:[4,5,11,13,14,15,17,18,28,31,36,39,46,53,63,65,66,69,114,116,122,125,127,129,132,134,135,137,139,140],emul:39,enabl:[0,15,16,30,32,40,42,45,50,53,63,64,68,103,104,105,110,121,123,127,132,137,140,141],encapsul:[41,141],enclos:46,encod:[21,23,26,30,31,34,39,40,42,45,46,48,53,55,71],encount:[39,42,53,111],encourag:[0,2,22,41,59,73,80,105,108],encrypt:[42,82,83,84],encryption_key_1:42,encryption_key_2:42,encryptptkt:15,end2end:[114,140],end2end_mock:[114,140],end:[4,5,6,8,9,10,11,12,13,14,15,17,18,23,24,27,28,30,31,37,38,39,40,42,46,48,49,53,56,60,77,78,90,91,92,93,94,95,102,131],end_stat:[4,5,11,12,13,14,15,17,18,19],endpoint:110,enf:15,enforc:[15,29,41,53],engin:[31,39,46],enhanc:[19,49,53,70,71,114,140],enrich:140,ensur:[4,5,12,13,14,17,20,24,27,28,30,31,33,34,40,41,42,48,49,53,60,111,116,119,121,122,123,125,127,129,132,133,134,135,137,139],enter:[0,56,77,78,82],enterpris:[0,20,24,53,56,60,70,71,103,111],entir:[4,5,11,12,13,14,15,17,18,29,32,42,53,64,68],entiti:27,entitl:0,entri:[5,6,7,8,9,10,15,27,37,39,41,42,45,49,53,96,140],entrypoint:[6,7,8,9,10],env:140,enviorn:15,environ:[6,7,8,9,10,15,24,28,31,34,46,48,60,71,72,76,104,105,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],environment_var:[62,63,64,67,68],environmenterror:[24,60],eod:37,eodi:15,eof:[30,40],eol:56,ep11:[116,121],epcdsa:15,epcdsasz:15,epudsa:15,epudsasz:15,equal:[6,8,9,10,35,41],equival:[6,7,8,9,10,24,60,63,67],erdsa:15,erdsasz:15,errno:[24,60,111],error:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,24,27,29,30,31,35,37,39,40,41,42,46,53,60,63,64,66,68,69,70,83,85,96,97,98,99,103,105,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],errorcod:[6,7,8,9,10],errormax:63,erroroper:[6,7,8,9,10],esa:49,escal:[27,30,31,33,40],escap:[43,44,46,53],esd:[31,32,42,63,64],esdsa:15,esdsasz:15,esm:15,esmexit:15,essenti:[31,34,53],establish:[6,7,8,9,10,15],estim:[15,37],etc:[23,30,31,34,35,39,40,42,43,46,52,85,101,104,107,114],euccn:55,eucjc:55,eucjp:55,euckr:55,euctw:55,eudsa:15,eudsasz:15,evalu:[16,37,38,53],even:[9,15,25,29,31,53,118],event:[15,53],everi:[15,30,40,53,96,97,98,99,140],everyth:28,exact:78,exactli:29,examin:[35,111,140],exampl:[0,1,3,20,22,26,52,53,55,56,71,104,105,107,111,114,115,140],example1:65,exampledbd:66,exce:[15,27],exceed:[37,53],except:[15,20,23,24,41,53,60,85,97,116,122,125,127,129,132,134,135,137,139,140],excl:[63,64],exclam:[37,39],exclud:[15,16,28,29,35,41,48,53,137,140],exclude_sourc:28,exclus:[6,8,9,10,22,27,42,48,53,62,63,70,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139],exec:[15,37,39,47,84,101],execkei:[6,7,8,9,10],execut:[0,3,4,5,11,12,13,14,15,16,17,18,19,20,21,23,24,25,26,27,28,29,30,31,32,33,34,35,37,38,39,40,41,42,44,46,48,49,50,53,54,60,61,62,64,66,67,68,69,71,81,96,97,98,99,100,101,105,114,123,140],executionset:[6,7,8,9,10],exempt:[31,34,39,46,48],exercis:31,exist:[0,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,23,28,29,30,31,32,34,40,42,46,48,49,53,60,63,66,69,71,83,84,96,97,98,99,101,105,116,122,123,125,127,129,131,132,134,135,137,139,140],existingassign:[6,7,8,9,10],existingdescript:[6,7,8,9,10],existinggroup:[6,7,8,9,10],existingnam:[6,7,8,9,10],existingoverrid:[6,7,8,9,10],existingsystemgroup:[6,7,8,9,10],existingtyp:[6,7,8,9,10],existingusag:[6,7,8,9,10],existingvalu:[84,101],existingvers:[6,7,8,9,10],exit:[15,28,31,53,93,94,102],exitlib:67,expand:[28,39,40,50,62,123,127,132,135,140],expand_crypto_adapt:[127,140],expand_storage_group:[127,140],expanded_exclude_sourc:28,expanded_sourc:28,expans:28,expect:[23,24,31,32,35,49,60,66,69,81,83,93,94,102],expected_result:83,expir:[15,129,135],expiri:15,explain:[19,22,24,60,85],explan:[0,39],explanatori:45,explicit:15,explicitli:[47,53,140],exploit:41,express:[6,8,9,10,25,30,35,40,44,53,116,117,121,132,140],ext:[37,39],extend:[15,28,33,41,42,53,56,118,127,132,140],extens:[29,114,118],extent:[19,53],extern:[6,7,8,9,10,15,42,90,91,104],external_nam:[90,91,94],external_software_nam:91,extpref:35,extract:[16,37,38,48,53],extreq:35,exxdsa:15,eyj0b2tlmvhcmvyiiwici:82,eyj0exaioijkv1qilcjhbgcioijsuzi1nij9:82,eyu_cicsnam:[6,7,8,9,10],eyu_cicsrel:[6,7,8,9,10],eyu_reserv:[6,7,8,9,10],eyuda:[6,7,8,9,10],f02e2632:[132,134],f1b97ed8:127,f433:[119,125,127],f651:137,f76ac7fb8b82:135,f920:39,fabric:[116,132],face:0,facil:[15,26,28,31,48,49,53,62,63,64,79,83,85,86],fact:[0,26,29,30,115,116,119,121,122,123,125,127,129,132,133,134,135,137,139,140],factor:[0,135],fail:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,27,30,31,32,34,36,38,39,40,42,46,48,53,65,68,83,84,85,105,132,133,135,140],fail_on_miss:34,fail_on_nodata:[9,19],failur:[0,16,22,23,27,30,31,32,33,34,35,36,38,39,40,41,42,43,44,45,46,47,49,53,62,66,68,69,93,94,102,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],fall:[31,34,39,46,48],fallback:53,fals:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,23,24,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,46,47,48,49,53,60,62,63,64,65,66,67,68,69,70,77,78,82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],famili:[116,117,119,121,125,132],faq:103,far:[24,60],fast:[36,42],fba:[28,31,32,42,48,63,64],fcp:[116,119,122,127,132,134],fcp_120_san1_02:[116,119],fcp_124_san1_03:132,fcqronli:15,fct:15,featur:[0,2,15,22,50,59,73,80,122,127,132,133,134],feb:[37,56],februari:37,feedback:[6,7,8,9,10,19],fepi:15,fetch:[21,26,28,31,41,50,53],fetchcnt:[6,7,8,9,10],fetchtim:[6,7,8,9,10],few:[0,140],ff000000:[6,7,8,9,10],ficon:[116,117,119,127,132,140],field:[0,15,19,39,42,53,62,65,66,67,69,83,127,140],fifo:42,file:[6,7,8,9,10,11,15,19,21,24,26,27,29,30,31,33,34,35,37,39,40,42,45,46,53,54,55,60,66,69,70,71,77,78,82,83,84,85,87,89,90,91,92,93,94,95,96,97,98,99,100,101,102,104,105,111,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],file_data_typ:42,file_nam:[27,30,31,33,40,41],file_with_your_certificate_chain:82,file_with_your_private_kei:82,filedata:42,filedef:15,filenam:[31,96,97,98,99,100],filenotfounderror:[31,41],filesi:41,filesystem:[23,30,31,41,48,101],filetag:[24,60],fill:[42,90,91,93,94,102],filter:[0,6,8,9,10,21,27,35,36,37,38,44,53,96,116,117,140],filter_wtor_messag:25,final_result:85,find:[6,21,26,31,39,46,53,84,111,140],fine:23,finish:[46,140],firmwar:[122,123,132,133,134],first:[9,15,23,29,30,31,33,34,35,39,40,41,42,46,47,53,63,64,105,108,123,140],firstmatch:40,fit:140,fix:[19,31,53,54,70,71,74,85,97,98,109,114,140],fixcat:89,fixtur:[24,60],flag:[15,19,24,28,31,41,44,60,68],flake8:[114,140],flashcopi:42,flat:34,fldsep:15,fldstrt:15,flexibl:[50,56,85,87,105,140],flow:[53,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],flu:[39,53],flush:[39,53],fme:15,fmid:[54,71,96],fnmatch:36,fold:[42,96],folder:[0,24,28,60],follow:[0,11,15,19,20,23,24,25,26,27,28,29,30,31,36,38,42,46,48,49,56,60,61,63,68,81,83,87,90,91,92,93,94,96,97,98,99,100,102,104,105,110,111,113,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],fom:42,foo:[28,31,35,41,48],foo_archive_test:28,foo_bar_archive_test:28,foobar:135,forc:[0,15,27,28,30,31,32,40,41,48,53,104,123,135],force_complet:101,force_dynam:27,force_lock:[31,53],forceqr:15,forcibl:101,fork:[0,140],form:[15,96],format:[6,7,8,9,10,15,23,24,27,28,31,32,38,41,42,48,53,60,62,63,64,65,66,67,69,74,82,83,84,85,87,90,91,92,93,94,96,99,101,102,103,104,123,127,140],format_opt:[28,48],forward:[11,15],found:[3,6,7,8,9,10,12,13,19,28,30,31,32,34,35,37,38,39,40,42,48,49,53,84,101,104,111],four:[0,15,114],fqn:41,framework:[24,60,87],free:15,freespac:42,fridai:39,from:[0,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,23,24,26,27,28,29,30,31,32,33,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,53,55,60,61,62,63,65,66,67,68,69,70,71,72,77,81,84,85,91,92,93,94,95,96,97,98,99,101,102,103,104,109,110,111,114,115,118,121,127,131,132,133,137,140],from_encod:53,front:15,fs_type:[41,53],fsstaff:15,fsum8976:31,ftimeout:15,ftp:[127,132],fulfil:[119,132,134],full:[15,29,35,43,53,68,93,95,111,114,132,135,140],full_volum:29,fullapi:[6,7,8,9,10],fulli:[15,25,31,41,53,116,119,121,122,125,127,129,132,133,134,135,137,139],function_numb:140,function_rang:140,further:[22,53,71,105],futur:[2,22,24,59,60,73,80,83],ga1:113,ga2:113,galaxi:[0,19,53,70,74,85,103,109,111,114,140],galaxy_serv:104,gap:123,gatewai:[123,127,132],gather:[0,26,31,35,41,63,111,116,118,119,121,122,123,125,127,129,132,133,134,135,137,139,140],gather_fact:[77,78,90,91,92,93,94,95,96,97,98,99,100,102],gather_subset:36,gener:[15,19,24,27,30,31,32,33,37,40,41,42,47,53,56,58,60,61,63,64,65,67,83,84,85,90,93,94,95,102,103,111,114,122,132,133,134,140],genjcl:67,genjcl_input_dataset:67,genjcl_output_dataset:67,get:[0,6,8,9,10,16,19,23,24,27,40,41,44,60,89,103,104,105,108,114,115,122,125,127,129,132,134,135,137,139,140],get_cpc_io:140,get_fact:140,get_paramet:[6,8,9,10],gid:[31,41],gigabyt:35,git:[0,2,22,59,73,80,104,114,140],github:[0,19,53,70,74,85,103,104,105,111,114,140],give:[28,31,48],given:[15,28,31,35,37,40,43,44,48,49,53,77,78,84,90,91,92,93,94,95,96,97,98,99,100,102,114],glob:28,global:[3,13,15,19,83,84,96,101,127,132],global_catalog:[3,13,19],gmt:15,gmtext:15,gmtran:15,gntran:15,goe:[22,31],going:53,good:105,gov:140,granular:[85,87],greater:[6,8,9,10,15,31,33,34,35,38,39],greatli:76,grep:0,grname:15,group:[0,6,7,8,9,10,11,15,19,28,31,37,39,40,42,46,48,53,77,83,89,105,115,119,123,127,134,135,137,140],group_var:105,grplist:[15,16],gsam:63,gsamdbd:63,gsampcb:63,gtf:15,gtftr:15,guaranteed_spac:31,guest:[24,60],guid:[0,2,71,108,111],guidanc:[19,85],guidelin:[52,107],had:140,halt:23,hamgmt0:[125,127],hamgmt:[125,127],handl:[23,24,30,42,46,53,54,60,71,84,101,140],handler:[89,140],handshak:15,happen:[41,111,123],hardwar:[112,113,137],has:[0,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,22,23,24,27,28,29,30,31,33,38,39,40,42,43,44,46,48,49,53,56,60,62,66,68,69,70,71,84,85,87,96,97,98,99,101,105,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],has_il:23,has_unacceptable_statu:[120,124,128],hash:42,hasp373:[37,39],hasp375:37,hasp395:[37,39],hat:[0,1,19,21,52,56,58,70,72,74,79,85,104,105,107,108,110,112],have:[3,15,16,20,23,24,27,28,31,32,35,39,40,42,44,48,53,60,62,63,68,77,78,83,90,91,92,93,94,95,96,97,98,99,100,102,104,110,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141],hba1:[122,127],hba:[115,127,132,140],head:49,header:15,health:15,held:29,hello:[23,30,35,37,38,39,43,46],help:[30,32,40,43,52,53,70,85,97,98,103,105,107,114],henc:64,here1:32,here2:32,here:[15,31,32,71,104,108],hexadecim:[49,123],hfs:[32,41],hhmmss:15,hidden:140,hide:15,hierarchi:41,high:[3,15,27,28,29,30,31,32,33,34,35,40,41,42,48,49,53],higher:[124,128],highest:[0,49],highlight:53,hill3:47,hint:142,hiper:[85,97],hipersocket:[115,117,125,140],hisoclass:137,histori:129,hlq:[27,28,29,30,31,32,33,34,35,39,40,41,42,47,48,49,53],hmc1:118,hmc:[0,103,106,107,109,110,111,113,114,115,116,117,119,120,121,122,123,124,125,126,127,128,130,132,133,134,139,140,141,142],hmc_auth:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],hmc_host:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],hmc_verify_cert:140,hmrest:[127,132],hoc:111,hold:[5,15,17,29,53,90,93,94,95,102],holddata:[85,97],holdstatu:[6,7,8,9,10],home:[24,31,46,60,83,104],honor:[15,40,41,53],host1:30,host2:30,host3:30,host:[0,6,7,8,9,10,15,24,30,45,54,60,71,75,77,78,87,90,91,92,93,94,95,96,97,98,99,100,101,102,104,105,110,122,123,127,132,140],host_var:105,hostnam:[34,82,83,84,87,90,91,92,93,94,95,96,97,98,99,100,101,102,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],hour:15,how:[2,3,6,7,8,9,10,15,19,20,22,24,35,41,42,51,53,55,59,60,67,71,73,76,80,84,89,101,105,106,108,140],howev:[0,2,19,22,24,29,41,59,60,73,80,110],hp10230:96,hpo:15,html:[30,31,114,116],http:[0,3,6,7,8,9,10,15,20,40,77,78,82,83,84,96,97,98,99,100,101,104,114,116,140],http_statu:[6,7,8,9,10],http_status_cod:[6,7,8,9,10],httpd:31,httpserverhdr:15,httpstatu:83,httpusragenthdr:15,hub:[0,19,53,70,74,85,88,103,109,114,140],hub_token:104,human:[4,5,11,12,13,14,15,16,17,18],hurslei:[6,7,8,9,10],hw_name:36,hwsc0000i:44,hyphen:[53,104,116,118,119,121,122,123,125,127,129,132,134,135,137,139,140],i15rtsmm:[39,67,69],ibm:[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,23,24,25,26,30,31,33,34,35,36,39,40,41,42,45,49,50,52,53,55,56,58,60,61,70,71,74,75,76,77,78,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,102,104,105,107,108,110,112,113,114,115,140,141,142],ibm_zhmc:[104,112,114,115,131,140],ibm_zos_c:[1,3,4,5,6,8,9,10,11,12,13,14,15,16,17,18,19,104],ibm_zos_cor:[0,21,25,26,36,53,56,104,111],ibm_zos_im:[58,70,104],ibm_zos_sysauto:[72,74,77,78,104],ibm_zosmf:[79,81,83,84,85,90,91,92,93,94,95,96,97,98,99,100,102],ibmus:[7,9,37,83],ich70001i:[37,39],ick00001i:49,ick00002i:49,ick00091i:49,ick00700i:49,ick03091i:49,ick03096i:49,ick:49,ickdsf:49,iconv:[30,33,34,40,45,55],icp:15,icsf:42,icv:15,icvr:15,icvtsd:15,idcam:[42,54,71],idempot:[40,84,101,116,119,121,122,125,127,129,131,132,133,134,135,137,139,140],ident:15,identif:[15,44],identifi:[5,6,7,8,9,10,11,15,16,18,19,25,27,28,30,31,33,37,38,39,41,42,44,46,53,54,55,63,64,68,71,75,77,78,84,85,87,89,90,91,92,93,94,95,100,102,104,116,123],idl:135,ids:15,ieb352i:37,iebcopi:[54,71],iebgen:[37,38,39,42],iee094d:25,iee457i:43,ief032i:[37,39],ief033i:[37,39],ief142i:[37,39],ief236i:[37,39],ief237i:[37,39],ief285i:[37,39],ief373i:[37,39],ief375i:[37,39],iefbr14:42,iefc001i:39,iefc653i:39,iefrder:63,iew2008i:39,iew2231i:39,iew2278i:39,iew2650i:39,iew2850i:39,iewl:39,ifl:[123,127,132],ifl_processor:127,igd100i:39,ignor:[0,15,27,28,29,31,34,35,39,40,41,42,46,48,53,63,82,83,84,101,104,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],ignore_error:53,ignore_sftp_stderr:[31,34,111],ikjeft01:[54,71],illustr:111,im5:44,im5h:44,im5hconn:44,im5hctrl:44,imag:[15,42,123,127,132],immedi:[15,16,41,104],immut:140,impact:28,implement:[42,53,56,114,140],impli:[5,18,53],implicit:[5,15,18],implicitli:[6,8,9,10,31,41],import_nam:[24,60],importlib:140,improp:53,improv:[19,28,29,53,70,140],ims1501:67,ims15r:67,ims1:[24,39,60,63,64,65,67,68,69],ims2:65,ims3:65,ims_acb_gen:[61,70],ims_acbgen:70,ims_catalog_popul:[61,70],ims_catalog_purg:[61,70],ims_command:[61,70],ims_command_util:70,ims_data_definit:68,ims_dbd_gen:[61,62,70],ims_dbrc:[61,70],ims_ddl:[61,70],ims_id:[63,64,68],ims_member_data:65,ims_member_messag:65,ims_output:65,ims_psb_gen:[61,62,70],imsbank:[24,60,69],imsbg2:39,imsbld:[39,67,69],imsdb1:65,imsgrp1:47,imsgrp2:47,imsgrp3:47,imsplex:65,imsrc:65,imssun:35,imstest:35,imstestg:67,imstestl:[35,39,67],imstestu:[67,69],imsv:47,in1:47,inact:[15,119,123,127,135,140],includ:[0,6,8,9,10,15,19,20,23,24,25,27,28,29,31,32,33,34,38,40,41,42,44,46,48,52,53,55,60,63,68,71,74,84,90,91,92,94,96,97,98,99,100,102,103,104,105,107,112,114,116,119,120,127,132,137,140],include_memb:137,include_modul:[90,91,92,93,94,95,102],include_rol:[77,78,96,97,98,99,100,101],include_unmanaged_cpc:120,inclus:121,incompat:[114,140],incomplet:28,inconsist:140,inconsistentscop:[6,7,8,9,10],inconsistentset:[6,7,8,9,10],incorrect:[15,53,111,140],incorrectli:[22,23,53,111,140],increas:[53,105,140],increment:15,indataset:31,indd:47,indent:[30,42,53],independ:[114,135,140],index:[9,15,30,35,42,49,53,66,114,116,121,122,125,127,132,140],indic:[9,15,19,27,28,29,30,31,34,37,38,39,40,41,42,43,44,53,62,63,64,65,68,82,83,84,96,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],indirectli:[62,135],individu:[0,15,31,34,41,46,51,66,69,85,87,90,94,106],ine8d8:49,infil:42,influenc:53,info:[83,87,91,93,105,123,132],infocent:15,inform:[0,2,6,7,8,9,10,12,13,15,16,19,20,22,24,27,31,33,35,37,38,39,40,41,43,44,46,47,49,53,54,56,59,60,62,63,65,67,71,73,75,80,84,85,87,90,92,93,94,95,96,97,98,99,100,101,102,104,105,122,123,125,127,137,139,140],infrastructur:140,inherit:137,inhibit:15,ini:45,init:[15,37,39,49,67],initi:[1,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,21,24,26,40,44,53,58,60,70,72,74,79,85,112,123,127,132,140],initial_memori:127,initial_processing_weight:123,initparm:15,inject:[24,60],inlin:[11,31],inline_copi:31,input:[15,19,24,28,33,37,41,42,47,53,55,60,62,63,64,66,67,68,69,82,84,85,93,94,101,102,122,123,125,127,129,131,132,134,135,137,139,140],input_cont:11,input_loc:11,input_src:11,input_var:[93,94,102],input_vari:94,ins:[127,132],insecur:[6,7,8,9,10],insensit:[23,84],insert:[27,30,40,53,63,114],insertaft:[30,40,53],insertbefor:[30,40],insfil:[127,132],insid:[23,25,30,31,37,39,46,53,104],inspect:[24,60],instal:[1,3,6,7,8,9,10,11,12,13,15,16,19,20,41,49,53,54,71,75,85,87,96,97,98,99,100,103,105,110,111,114,123,140],installag:[6,7,8,9,10],installd:96,installerror:[6,7,8,9,10],installtim:[6,7,8,9,10],installusrid:[6,7,8,9,10],instanc:[0,6,7,8,9,10,63,64,65,77,78,84,85,87,89,94,96,100,101,102,111],instance_action_nam:93,instance_descript:90,instance_info_json:91,instance_info_json_path:[91,93,95],instance_own:90,instance_provid:90,instance_record_dir:[90,91,92,94,102],instance_var_json_path:90,instance_variable_record:90,instead:[19,20,30,31,40,53,70,90,94,116,119,122,123,125,127,129,132,134,135,137,139,140],instln:15,instream:[39,42,53],instruct:[0,11,15,16,43,45,53,54,71,90,105,140],insuffici:111,integ:[9,16,23,37,38,39,55,116,119,121,122,123,125,127,129,132,134,135,137,139,140],integr:[0,15,34,50,75,105,108],intend:[0,4,5,11,12,13,14,15,17,18,28,53],interact:[1,3,15,20,21,53,58,72,87,112,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],interchang:15,interfac:[1,6,7,8,9,10,15,26,31,34,61,65,81,85,87,125,135],intern:[12,13,15,55,62,111],internation:55,internet:108,interpret:[24,46,53,60,111],interrupt:[63,123],interv:[15,93,94,101,102],intial:49,intrapartit:[3,15,19],intrdr:15,intrdrjobus:15,introduc:[19,43,53,140],introduct:108,inttr:15,invalid:[23,31,37,39,46,53,66,69,70,111],inventori:[24,31,39,46,54,60,62,63,64,67,68,71,74,75,77,78,83,84,87,90,91,92,93,94,95,96,97,98,99,100,101,102,140],inventory_hostnam:[84,101],investig:114,invoc:[15,39,47,53,65,114,131,140],invok:[15,42,46,65,135,140],invreq:[6,7,8,9,10],iodf:36,ioerror:111,ipl:[36,41,123,127,132],ipl_volum:36,ipv4:[127,132],ipv6:[127,132],irc:[15,108],ircstrt:15,irlm:[63,64],irlm_id:[63,64],irr010i:[37,39],is_binari:[31,34],is_manag:120,isc:15,isf031i:43,isinst:23,isn:15,iso8601:30,iso8859:[33,34,39,42,55],iso:[30,40,55,127,132],isol:15,isrtlist:63,issu:[2,15,16,19,22,31,42,44,46,59,73,80,85,111,114,140],item1:[24,60],item2:[24,60],item3:[24,60],item:[23,24,30,42,49,60,83,114,116,119,121,135,137],itemcategori:83,itemdescript:83,itemid:83,itemtyp:83,iter:30,its:[0,4,5,11,13,14,15,17,18,28,30,31,34,39,40,46,48,51,53,56,67,68,84,106,109,114,116,119,120,122,123,124,125,127,128,132,133,134,135,137,139,140,141],itself:[31,42,141],iwm4hlth:15,iycwemw2:[6,7,8,9,10],iyk3z0r9:[6,7,8,9,10,38],izuwf0145:84,izuwf0162i:84,j09:47,j42:47,j91:47,j93:47,j97:47,jcl:[3,16,19,21,26,30,31,37,38,42,46,53,67,84,101],jclerr:[39,53],jclhold:53,jclout:67,jclpd:67,jes2:[15,36,37,39],jesdi:15,jesjcl:[37,39],jesmsglg:[37,39,53],jesysmsg:[37,39],jinja2:[30,31,39,46,53,140],jm00:[37,39],job00134:[37,39],job00361:39,job00551:39,job01427:38,job12345:[16,38],job12354:16,job12:38,job16577:38,job:[0,6,7,8,9,10,15,16,19,21,23,26,39,42,43,44,50,53,63,64,68,77,84,101,102],job_class:[37,38,39],job_id:[16,37,38,39,44,53],job_nam:[15,16,19,37,38,39,44,53],job_paramet:15,job_stat:102,job_submit:53,jobparm:[15,39],join:[15,53,91],jose:23,journal:15,jrm:[37,39],json:[0,30,53,70,82,83,84,85,87,90,91,92,93,94,95,96,97,98,99,100,101,102],json_queri:91,june:56,just:[4,5,9,11,12,13,14,15,17,18,114,131,140],jvm:15,jvmclass:[6,7,8,9,10],jvmgrp:[6,7,8,10],jvmprofiledir:15,jvmserver:[6,7,8,9,10],jwt_token:[82,83,84],jycqqfni:46,kbyte:[37,39],keep:[15,31,39,40,42,46,63,64],keep_trailing_newlin:[31,39,46],kei:[6,7,8,9,10,15,23,31,32,42,48,66,69,70,82,83,84,101,104,111,116,119,122,123,125,127,129,132,134,135,137,139],kept:[15,39],kerbero:15,kerberosus:15,ket678:49,ket987:49,key_label:42,key_length:[31,32,42,48],key_offset:[31,32,42,48],keyboard:15,keycd1:42,keycd2:42,keydata:[6,7,8,9,10],keyerror:53,keygen:[24,60],keylab1:42,keylab2:42,keypoint:15,keyr:15,keystrok:15,keyword:[0,25,53,64],kilobyt:[4,5,11,12,13,14,15,17,18,35],kind:[42,114],know:[28,31,48,114],knowledg:[132,133,134],known:[15,42,89,103,104,105,114,127],ksd:[31,32,33,34,42,48,63,64],kwarg:23,label:[15,42,49,53,104],lang:[15,24,60],languag:[6,7,8,9,10,15,54,55,58,61,71],laps:39,laptop:110,larg:[4,5,11,12,13,14,17,32,35,42,63,64],larger:56,largest:15,last:[9,15,29,30,35,37,38,39,40,53,123,140],lastli:31,later:[0,19,20,24,37,38,39,45,53,56,60,63,70,71,83,84,85,87,104,110,122,132,133,134,140],latest:[2,6,7,8,9,10,19,22,28,53,54,59,63,71,73,80,104,108,111,114,140],latin:55,layer:15,lba:[127,132],ldap:[15,135,140],ldap_server_definition_nam:135,ldap_server_definition_uri:135,lds:[31,32,42],le_data_set:15,lead:[28,29,31,39,46,48,53,117,124,128,140],learn:[0,2,22,51,59,73,80,85,104,105,106,108,109,110,111],least:[35,37,75,87,114,123,140],leav:[4,5,11,13,14,15,17,18,48,49,53,65],leaveconflict:[84,101],left:[0,5,18,28,31,40,48],length:[6,7,8,9,10,15,27,28,31,32,33,42,48,53,63,64,77,78,129],less:[6,8,9,10,35,39,41,49,53,118,140],letter:[15,35,55,105],level:[3,15,23,25,27,28,29,30,31,32,33,34,35,40,41,42,48,49,53,68,74,77,78,83,105,114,123,140],leverag:[3,20,23,53,110],lg09:121,lgdfint:15,lgnmsg:15,lib:[24,30,35,60],lib_nam:[3,11,12,13,15],liberti:40,libnam:27,libpath:[24,60],librari:[3,6,7,8,9,10,11,12,13,15,21,24,26,28,30,31,32,35,42,53,60,62,63,64,66,68,69,70,85,116],librarti:15,librarydsn:[6,7,8,9,10],life:[56,110],lifecycl:[56,112,135],lifetim:15,lightweight:[82,83,84],like:[0,24,28,29,31,37,43,47,48,53,56,60,85,104,111],limit:[6,7,8,9,10,11,15,24,41,53,60,96,116,119,121,122,125,127,129,132,133,134,135,137,139,140],line:[0,15,16,24,26,27,31,34,37,39,40,41,42,46,47,53,60,65,81,115,140],line_comment_prefix:[31,39,46],line_statement_prefix:[31,39,46],linear:[28,31,32,48],linect:15,link:[0,15,31,38,49,52,66,69,74,103,107,114,140],linkcbl:38,linkcheck:114,linkjob:38,linklib:27,lint:85,linux:[119,124],linuxon:[112,140],lise:140,list:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,23,24,27,28,29,31,32,34,35,36,37,38,39,41,42,43,44,45,46,47,48,49,53,54,55,60,62,63,64,65,66,67,68,69,70,71,83,85,89,96,97,98,99,104,105,108,110,114,115,116,118,119,121,122,123,125,127,129,131,132,133,134,135,137,139,140],listcat:42,listdsd:47,listen:[15,40],liter:42,littl:105,llacopi:15,llq:[30,39],lma:15,load:[3,11,15,30,31,53,63,89,121,123,127,132],loadlib:[31,53],loadpoint:[6,7,8,9,10],local:[0,3,6,11,12,15,19,24,25,31,34,37,38,39,44,46,48,50,53,60,66,69,83,93,114,135,140],local_catalog:[3,12,19],local_file_backup:31,local_follow:31,local_request_queu:[3,19],localccsid:15,localfil:9,localhost:[20,87,110,140],locat:[0,3,4,5,6,7,8,9,10,11,12,13,14,15,17,18,19,30,31,32,33,37,38,39,40,41,46,49,53,66,69,82,83,84,94,101,102,104,105,116,121,132],locfil:9,lock:[15,123,127,132,135,137],log1:64,log:[11,12,15,16,28,31,34,37,38,39,43,48,53,55,63,64,68,105,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],log_fil:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],logger:[15,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],logic:[6,7,8,9,10,15,29,41,42,53,62,63,64,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],login:135,logon:[15,83],logstream_id:11,logstreamid:11,logusr:15,longer:[19,28,31,45,53,131,140],longrun:39,look:[24,40,53,60,84],lookup:[30,91],loop:[30,49,135,140],loss:[15,31,42,53],lossless:28,lost:[14,32,41],low:35,lower:53,lowercas:[19,41,53],lowest:0,lpa:15,lpar1:[123,124],lpar2:123,lpar:[115,119,137,140],lpar_list:124,lpar_nam:36,lpastat:[6,7,8,9,10],lpp:[23,24,60,111],lrecl:[28,39,42,48,68],lsr:15,lstrip_block:[31,39,46],ltpa:[82,83,84],ltpa_token_2:[82,83,84],luke:23,lun:127,m12:47,m32:47,m63:47,m82:47,mac:[125,127],mac_address:140,machin:[31,34,39,46,48,49,53,110,112,140],maclib:[66,69],maco:140,macro:[15,66,69],made:[6,7,8,9,10,15,19,37,42,43,44,46,53,55,56,62,68,74,82,83,84,101,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],magicmock:[24,60],mai:[0,15,19,23,24,27,28,30,31,36,40,42,43,46,48,49,56,60,83,84,90,91,92,94,96,102,104,114,116,119,122,123,125,127,129,132,134,135,137,139],mail:108,main:[15,42,114],maintain:[53,62,140],mainten:[57,62,87],maintenenac:62,major:[114,140],make:[0,2,10,15,19,22,24,28,42,44,46,59,60,62,70,73,80,111,114,140],manag:[0,1,3,6,7,8,9,10,15,19,25,26,27,28,29,31,34,35,39,41,42,45,46,48,49,50,53,55,56,63,64,65,67,79,83,84,85,86,88,89,90,91,92,94,95,101,103,105,112,113,115,116,117,118,120,121,122,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139,140],managed_acb:[63,64],managedacb:63,management_class:[63,64],mani:[0,15,55,75,90,91,92,94,102,105],manifest:0,manner:[16,131],manual:[15,84,90],manullai:90,map:[6,7,8,9,10,15,30,42,67,68,104],mar:39,march:39,margin:42,mark:[24,27,29,30,41,53,60],markdown:140,marker:[27,30,31,39,41,46,53,67],marker_begin:30,marker_end:30,mask:[125,127],mass:47,master:[27,114,123,127,132,140],match:[15,16,19,26,27,28,29,30,31,32,34,36,37,38,40,42,44,48,49,53,64,66,69,83,96,116,117,123,140],materi:[52,76,81,89,107,115],matrix:[53,114],max:[39,53,121,129,132,135],max_error_msg:63,max_rc:[16,39,47,53,67],maxi:39,maximum:[15,16,29,39,42,43,47,49,53,67,77,78,101,116,121,123,127,132],maximum_memori:127,maxopentcb:15,maxsocket:15,maxssltcb:15,maxtlslevel:15,maxxptcb:15,mbr:39,mc2cnam:35,mcat:27,mcsoper:[31,53],mct:15,mean:[0,3,9,28,31,36,39,41,42,44,45,48,65,121],meant:[23,53],measur:[28,29,31,32,39,42,48],mechan:[0,15,114],media:[127,132],mediacent:85,meet:[23,31,74],megabyt:[4,5,11,12,13,14,15,17,18,35],mem:[27,30],member1:32,member2:32,member:[15,23,27,30,31,32,33,34,35,39,40,41,42,51,53,63,64,66,67,68,69,70,106,137],member_list:[66,69,70],member_nam:64,memlimit:[15,39],memori:[112,123,127,132],menu:15,merg:[42,62,114,140],messag:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,26,27,30,31,34,35,38,39,40,41,43,45,46,49,53,62,63,64,65,66,67,68,69,83,84,90,91,92,94,96,97,98,99,100,102,103,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],message_filt:44,message_id:44,message_text:44,messageid:83,messagetext:83,met:[11,12,13,15,17,18,24,60,83],metadata:[63,68,114,140],method:[6,7,8,9,10,15,34,42,83,140],methodolog:0,mgmt1:132,mgmt1_mgmt1:[132,134],middl:29,middlewar:[79,92,93,94,95],might:[15,55,62,85,98],migrat:140,mileston:114,millisecond:15,min:[37,39,121,129,135],minidisk:[26,53],minim:[24,60,110],minimum:[0,15,56,110,114,123,127,132,140],minor:[70,74,114,140],minor_chang:53,mintlslevel:15,minu:49,minut:[15,37,39],mirror:15,miss:[24,28,31,34,45,46,48,53,60,85,89,114,140],missing_critical_updates_respons:97,missing_critical_updates_response_fil:97,missing_fixcat_updates_respons:98,missing_fixcat_updates_response_fil:98,mitig:140,mix:[15,31,48,68,96],mixtur:32,mlq:30,mmddyi:15,mnconv:15,mnew:114,mnexc:15,mnfreq:15,mnidn:15,mnp:15,mnper:15,mnre:15,mnsync:15,mntime:15,mnu:114,mock:[114,140],mocked_hmc_z14:140,mocked_inventori:140,mocked_vault:140,mocked_z14_class:140,mocked_z14_dpm:140,mocker:[24,60],mod:42,mode:[15,16,28,30,31,34,41,42,48,49,53,63,64,84,105,115,116,117,119,120,121,122,123,124,125,127,128,132,133,134,137,139,140],model:[47,49,116,117,118,119,120,121,122,123,124,125,127,128,129,132,134,135,137,139],modif:[23,53,62,105],modifi:[0,15,30,31,40,53,63,111,114,123],modstat:63,modul:[1,4,5,9,11,12,13,14,15,16,17,18,19,20,21,23,27,28,29,30,31,32,33,34,35,36,37,39,40,41,42,43,44,45,46,48,49,50,52,55,58,62,63,64,65,66,67,68,69,70,79,82,83,84,85,87,101,103,104,107,108,109,110,112,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],module_default:3,module_path:[24,60],module_stderr:[24,60],module_util:[23,24,53,60],moment:142,monitor:[15,39],month:35,more:[0,6,7,8,9,10,15,20,22,23,25,30,31,32,35,37,38,39,41,43,44,45,46,47,53,54,62,63,70,71,74,75,84,85,93,96,97,98,99,100,101,104,105,109,110,111,114,118,119,140],most:[0,28,30,33,34,39,40,53,85,87,108,111,114],mount:[26,30],mount_opt:[41,53],mountpoint:[30,41],move:[41,42,140],movement:41,mozilla:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],mqconn:15,mro:15,mrobtch:15,mrofs:15,mrolrm:15,msg:[4,5,11,12,13,14,15,16,17,18,27,30,31,34,35,37,38,39,40,41,46,49,53,62,63,64,66,67,68,69,83,90,91,92,94,96,97,98,99,100,102,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],msg_code:[16,37,38,39,53],msg_text:53,msg_txt:[16,37,38,39,53],msgcase:15,msgclass:[15,37,39],msglevel:[15,37,39],msglvl:15,msgprt:42,msgusr:15,much:54,mulitpl:16,multi:[26,42,53,135],multinod:15,multipl:[4,5,6,8,9,10,11,12,13,14,15,16,17,18,23,24,28,31,32,35,38,42,47,53,60,63,64,65,66,67,69,87,94,102,105,131,140],multiregion:15,must:[0,5,6,7,8,9,10,11,15,16,18,19,20,23,24,25,27,28,29,30,31,32,33,35,38,39,40,41,42,43,46,48,49,53,56,60,62,63,64,71,75,83,87,94,96,97,98,99,101,102,104,105,110,114,116,117,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139,141],mustgath:111,mutual:[6,8,9,10,22,27,42,48,53,62,63,70,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139],mutually_exclus:23,mv27:44,mv29:44,mv2h:44,mvscmdauth:111,mvscmdmsg:111,mvsimag:15,mvssys01:41,mxt:15,my_:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],my_adapter_nam:116,my_certs_dir:131,my_cpc_nam:[116,119,121,122,123,125,127,132,133,134,139],my_first_partition_nam:121,my_hba_nam:122,my_hmc_auth:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139],my_hmc_host:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],my_hmc_password:131,my_hmc_userid:131,my_lpar_nam:123,my_nic_nam:125,my_partition_nam:[121,122,125,127,133,139],my_password_rule_nam:129,my_second_partition_nam:121,my_storage_group_nam:[132,133,134],my_storage_volume_nam:134,my_us:131,my_user_nam:135,my_user_role_nam:137,my_vfunction_nam:139,mybundl:9,mycobol:31,mydata:32,mygrp:9,myhlq:[29,42],mypgm:42,myprog:9,myreg01:16,myuser:[24,42,60],myvar:90,myvol1:29,myvol2:29,myworkflow:[84,101],name:[0,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,22,23,24,25,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,53,55,56,60,62,63,64,65,66,67,68,69,75,77,78,82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102,104,105,111,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],namespac:[25,104,114],nation:49,natlang:15,navig:[0,24,60,109],ncpldft:15,necessari:[23,62,87,105],ned:49,need:[15,20,23,24,30,33,34,35,36,40,41,42,46,53,60,63,66,69,71,83,84,85,90,91,92,93,94,95,96,97,98,99,100,101,102,104,105,110,114,121,122,123,125,127,131,137,139,140],neg:[9,35],neither:[15,16,29,31,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],nest:[6,8,9,10,23],netuowid:15,netview:[77,78],network:[116,123,125,127,132,141],network_adapter_port_uri:125,never:53,newcopi:[6,15],newcopycnt:[6,7,8,9,10],newcpc:120,newer:[53,56,70,140],newli:63,newlin:[31,39,42,44,46,53],newline_sequ:[31,39,46],newsit:15,newslett:108,next:[12,15,84,119,123],next_start:12,nfs:41,nic1:[125,126],nic:[115,127,132,140],nic_list:126,nicknam:[84,94,96,97,98,99,100,101,102],nist:[15,140],nistsp800131a:15,nnew:114,no_log:131,no_sdtran:16,noautomov:41,nocheck:15,nocopi:[6,7,8,9,10],nod:49,node:[0,3,11,15,19,25,26,28,32,39,45,46,48,50,53,56,61,81,83,84,85,101,104,105,111],nodeck:39,nodelai:15,noempti:15,noeras:42,noforc:15,noindex:49,noinstln:15,nolimit:39,nolist:39,nolog:15,non:[15,28,31,32,34,35,41,42,48,49,53,90,91,92,94,102,140],nonblock:42,none:[6,7,8,9,10,11,15,23,24,27,32,38,39,41,49,60,62,123,127,132,140],nonexist:[28,29,31],nonotifi:15,nonrecover:11,nonresid:[6,7,8,9,10],nonrlsrecov:15,nonspan:42,nonvsam:35,nonzero:65,nop:15,noprotect:15,noqa:140,nor:[15,16],noreus:42,normal:[15,16,41,42,53,63,64,111,123,140],normal_disposit:[63,64],nosdtran:16,nosecur:41,nosetuid:41,notappl:[6,7,8,9,10],notdefin:[6,7,8,9,10],notdynam:[6,7,8,9,10],note:[0,4,5,11,12,13,14,15,17,18,19,20,23,24,29,32,36,37,49,54,56,60,71,103,104,105,109,111,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,135,136,137,138,139,140],notext:41,notic:34,notif:[15,84,101],notifi:[15,37,39,105],notrequir:[6,7,8,9,10],noverifi:49,noverifyofflin:49,now:[19,24,30,40,53,60,114,140],nowait:41,nqrnl:15,nrd:43,nucleu:[62,63,64,67,68],number:[0,6,7,8,9,10,15,16,23,27,28,30,31,32,35,36,37,39,40,42,43,44,47,48,49,53,63,64,71,75,82,83,84,87,90,91,92,93,94,95,96,97,98,99,100,101,102,121,123,125,127,131,132,134,140,141],numer:[6,7,8,9,10,23,37,38,39,42,55,63,64,129],nvd:140,oa59461:75,oappend:42,object:[22,24,31,32,48,53,60,83,90,96,100,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139,140],objectid:102,obtain:[15,27,30,31,33,40,47,53,85,91,92,96,97,98,99,105,140],occasion:[53,56],occur:[6,7,8,9,10,15,31,41,43,44,49,53,62,68],ocopi:47,ocreat:42,oct:56,octal:[28,31,42,48],ocur:46,oexcl:42,off:[0,15,64],offer:[1,19,21,51,52,55,58,70,72,74,79,85,103,106,107,110,112],offici:[0,31,39,44,46],offlin:[43,49,63,64],offset:[31,32,39,42,48],offsit:15,often:[0,22,23,39,53,110],old:[15,31,39,42,63,64,140],older:[111,117,118,124,126,128],omit:[6,7,10,15,63,84,101,116,119,122,123,125,127,129,132,134,135,137,139],ommit:63,omvs0000:43,omvsadm8:64,omvsadm:[37,39,41,47,69],onc:[3,15,114,127,131,132,135,140],one:[0,5,6,7,8,9,10,15,16,17,18,19,23,24,27,28,29,30,31,32,35,37,42,44,45,47,48,53,60,74,75,84,85,87,96,99,101,103,104,110,118,127,131,140],ones:[53,123,140],onli:[0,3,4,5,10,11,12,13,14,15,17,18,23,24,28,29,31,32,33,35,36,37,39,40,41,42,46,48,50,53,54,60,62,63,64,66,67,68,69,71,83,84,85,87,90,96,97,98,99,100,101,114,115,116,117,118,119,120,121,123,124,126,127,128,132,133,134,135,137,140],onlin:[15,49,63,68,116,121,132],online_batch:[63,64],onoctti:42,ononblock:42,onto:41,open:[2,15,16,20,21,22,24,28,30,31,32,33,37,38,39,40,41,42,51,53,56,58,59,60,70,71,73,80,88,106,111,114],openid:104,openssh:[20,24,45,54,60,71,110],oper:[1,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,21,23,24,25,26,27,28,29,31,32,37,39,40,41,44,49,51,53,54,60,65,66,69,71,72,75,76,77,78,79,81,82,83,96,97,98,99,101,103,105,106,112,114,115,116,118,119,121,122,123,125,127,132,133,134,137,139,140],operand:25,operator_action_queri:53,opercmd:27,opertim:15,opndlim:15,oprat:[124,128],opt:41,optim:34,option:[0,4,5,6,7,8,9,10,11,12,13,14,15,17,18,19,22,24,27,28,30,31,32,33,36,39,40,41,42,43,45,46,47,48,49,53,54,55,60,62,63,64,65,66,68,69,71,75,84,87,93,94,101,102,104,105,114,120,123,131,137,140],orchestr:[0,103],order:[0,6,7,8,9,10,31,32,39,46,53,104,114,116,131,140],ordonli:42,ordwr:42,org:114,organ:[4,5,11,12,13,14,15,17,18,19,28,31,48,105],origin:[27,31,32,33,40,41,42,46,53,67,114,123],original_nam:42,orphan:53,os_ipl_token:[123,140],os_setup:140,osa:[117,119,125],osd:[117,125,127],osd_128_mgmt_net2_30:[125,127],osm1:119,osm:119,osmf:[0,81,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,106,107,109,110,111],osync:42,other:[6,8,9,10,15,19,20,23,24,29,30,31,32,37,39,40,42,49,53,60,64,75,83,85,89,90,92,93,94,95,97,100,103,104,111,116,118,119,121,123,131,135,137,140],otherwis:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,24,28,29,30,31,35,38,39,40,46,48,49,60,64,84,96,97,98,99,116,123,132,133],otrunc:42,our:[0,24,40,60,105,111,122,125,140],out1:[42,47],out2:42,out3:42,out:[0,15,24,33,36,42,60],outcom:65,outdataset:31,outdd:47,outfil:42,outlin:[22,31,59],output:[4,5,11,12,13,14,15,16,17,18,21,24,26,27,28,33,34,38,39,42,43,47,48,49,53,60,63,64,65,66,67,68,69,70,84,96,97,98,99,100,101,104,111,140],output_data_set:15,output_dir:46,outputfil:42,outputfilevalu:[84,101],outstand:44,over:[0,3,20,24,31,53,60,62,63,64,67,68,83,118],overal:140,overflowout:42,overlap:23,overrd:15,overrid:[0,3,4,5,6,7,8,9,10,11,12,13,14,15,17,18,27,28,29,30,31,32,33,34,40,41,42,48,49,53,64],overridden:0,overview:[0,24,60],overwitten:[66,69],overwrit:[29,33,129,135,137],overwritten:[30,34,63,96,97,98,99],own:[0,15,24,28,31,40,48,51,60,104,106,135,140,141],owner:[16,28,31,37,38,39,41,42,46,48,53,84,90,101],ownership:[28,31,41,48],owronli:42,p000a218:137,p2ss01:39,pa1:[15,54,56,71],pa21:15,pa2:15,pa3:15,pack:[15,28],packag:[104,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],pad:[49,53],page:[0,15,20,37,41,42,49,54,55,71,108,114,140],pair:[15,24,46,60,66,69,70],pano:15,paramet:[0,3,19,23,24,53,60,61,70,74,81,90,91,92,93,94,95,96,97,98,99,100,102,114,115,140],parametererror:140,parametr:[24,60],parent:[28,31,48,116,117,121,123,124,125,126,127,128,129,132,134,135,137],parm:[15,37,39,42],parmerr:15,parmlib:[30,36,41],pars:[23,24,30,60,67],parsabl:70,parse_arg:23,parser:[22,23,28,31,48,68],part1:[119,126,127,137],part2:[119,137],part:[1,15,19,21,24,29,39,53,58,60,70,72,74,79,85,112,140],parti:[82,83,84],particip:41,particular:[3,6,7,8,9,10,15,23,29,30,37,39,40,41,44,55,60,111],particularli:53,partit:[27,30,31,32,33,34,35,39,40,42,53,66,69,112,115,116,119,123,124,126,132,134,137,140],partition1:[126,128],partition_link_uri:140,partition_list:128,partition_nam:[121,122,125,126,133,139],pass:[6,7,8,9,10,11,15,23,24,28,31,39,40,41,46,48,53,60,66,69,83,90,94,111,140],passthrough:53,passticket:15,password:[6,7,8,9,10,77,78,82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102,115,116,117,118,119,120,121,122,123,124,125,126,127,128,131,132,133,134,135,136,137,138,139,140,141],password_rul:[129,130],password_rule_nam:135,password_rule_uri:135,past:[53,118],patch:[24,60,104],patched_method:[24,60],path:[11,15,23,24,27,28,30,31,33,34,39,40,41,42,46,48,53,60,66,69,83,90,91,92,93,94,95,96,97,98,99,100,102,104,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],path_of_security_requir:83,path_to_inventori:[24,60],path_to_modul:[24,60],pathmod:42,pathnam:[30,33,40,42],pathopt:42,pattern:[23,24,25,26,27,28,29,30,35,36,37,40,42,44,53,60,61,81,105,117,135,136,140],paus:[84,127,140],pax:[28,48,53],pbr:140,pcdsa:15,pcdsasz:15,pchid:[117,119,140],pdi:15,pdir:[15,68],pds:[24,31,32,42,48,60],pds_pattern:35,pdse:[11,15,28,30,31,32,33,34,35,39,40,42,47,48,53,63,64,66,69],pem:[6,7,8,9,10,82,83,84,101],pend:[14,15,39,123],peopl:114,pep8:[70,140],pep:140,per:[0,15,30,42,127,132],percent:[29,84],perform:[0,1,3,4,5,7,8,9,10,11,12,13,14,15,16,17,18,19,23,24,26,28,29,31,32,34,36,37,39,41,42,45,48,49,53,54,60,61,63,64,66,68,69,71,81,83,84,90,93,94,95,101,102,111,114,121,123,127,131,132,133,134,140],perform_import:[24,60],period:[2,15,22,31,59,73,80,101],perman:42,permiss:[24,28,29,31,46,48,53,60,83,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139],permit:[9,15,49,53,117,124,127,128,131,132],permit_ecc_key_import_funct:140,persist:[15,27,41,42],person:[15,23],pf1:15,pf20:15,pf24:15,pgaictlg:15,pgaiexit:15,pgaipgm:15,pgchain:15,pgcopi:15,pgm:[37,38,39,42,65],pgm_input:46,pgm_result:46,pgpurg:15,pgret:15,pgrjusecount:[6,7,8,9,10],ph12143:85,ph28089:42,ph41248:85,ph47050:85,ph47746:85,ph52813:85,physic:[29,39,41,49,53,62,116,121,132],pick:140,pin:140,ping:[21,23,26,111],pip3:[24,60],pip:[20,24,60,114,140],place:[3,6,8,9,10,15,23,29,34,49,53,62,63,64,69,70,104],placement:[53,63],plai:29,plain:31,plan:30,platform:[0,6,7,8,9,10,39,56,71,103,110,112],playbook:[3,19,20,25,26,27,30,31,33,36,39,40,46,53,61,70,74,75,76,81,85,87,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,108,110,115,140],playbook_dir:[31,39,46],pleas:[0,29,53,71,84,85],plex1:[6,7,8,9,10,65],plex2:65,plex:[65,75],plt:15,pltpi:15,pltpisec:15,pltpiusr:15,pltsd:15,plu:[116,132,135],plugin:[0,21,24,53,60,87,103,104,108,140],point:[15,30,37,39,55,62,63,64,68,77,78,90,91,92,93,94,95,102,104],polici:72,poll:[93,94,102],pong:[7,45,111],pongalt:[6,7,8,10],pongbundle_1:7,pool:[15,63,64],pop:114,popul:[40,63],port:[6,7,8,9,10,23,40,71,75,77,78,82,83,84,87,90,91,92,93,94,95,96,97,98,99,100,101,102,116,122,123,125,127,132,134,140],portabl:[28,48],portion:[4,5,11,12,13,14,15,17,18,49],posit:[37,38,39,40,42,53,111],posix:[24,60],possibl:[16,35,37,38,53,116,119,122,123,125,127,129,131,132,134,135,137,139,140],post2:140,post:[7,15,19,140],postcomp:[42,62,70],potenti:[6,8,9,10,15,29],pp0l6p:27,pprint:[24,60],practic:105,pre:[0,49,84,101],prealloc:30,prebuilt:62,preced:[31,39,46,62,63,64,67,68],precend:31,precomp:[42,62,70],predefin:30,preexist:63,prefix:[15,28,31,32,39,42,46,48,125,127],pregener:15,prepackag:104,prepar:114,prepend:[30,53],prerequisit:[20,22,59,70,114,140],presenc:[45,53,140],present:[15,23,24,27,28,29,30,31,32,35,40,41,42,46,53,60,116,122,125,129,132,134,135,137,139],preserv:[13,28,31,32,42,45,48,53],preset:15,pretti:114,prevent:[15,19,41,53,63],preview:140,previou:[12,28,31,48,53,85,104,114],previous:[15,20,41,49,53,63,74,85,91,104,131,140],prgdlai:15,primari:[4,5,11,12,13,14,15,17,18,28,31,32,42,48,49,53,63,64],primarili:[30,40],primary_j:36,primary_log_dataset:[63,64],primary_spac:53,primary_unit:[63,64],princip:15,print:[15,24,27,31,37,39,46,60,68],print_duplicate_resourc:63,print_inserted_resourc:63,printabl:53,printout:15,prior:[32,53,56,70,114],prioriti:[15,37,38,39,53],prioritis:[6,7,8,9,10],privat:[0,6,7,8,9,10,23,29,42,77,78,82,83,84,90,101],private_galaxi:104,private_token:104,privileg:[27,30,31,33,40,42],prmaabak:41,problem:[42,127,132],proc1:[37,39],proc:39,proce:[67,71,87],procedur:[39,77,104],proceed:[44,66,69],process:[15,16,19,22,23,24,29,30,31,32,37,39,40,42,46,47,49,50,53,59,60,63,64,66,69,84,93,101,104,123,127,132,140],processor:[123,127,132],procl8b:23,proclib:[23,34,63,64,68,70],procstep:[37,39],produc:[0,5,15,28,31,34],product:[0,31,53,54,56,71,75,85,87,90,111],product_mod_level:36,product_nam:36,product_own:36,product_releas:36,product_vers:[36,90],profil:[12,15,27,30,31,34,40,49,53,83,119,123],prog001:27,prog00:30,progdef:[6,7,8,9,10],program:[0,1,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,21,23,26,28,30,31,32,37,38,39,41,46,48,49,53,54,58,62,63,65,66,68,69,71,123],program_nam:[37,38,39,42],programm:[15,83,116,132,133,134,135],programmer_nam:15,programview:68,progress:[84,104],progtyp:[6,7,8,9,10],proivd:90,project:[41,104,114,140],promot:[70,140],prompt:[75,77,78,82,87,90,91,92,93,94,95,101,102],promptli:32,propag:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],proper:[24,42,53,60,85],properli:[56,85,87,111],properti:[35,53,84,85,91,101,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139,140],proport:35,protect:[15,27,42,49,83,131],protocol:[15,31,34,39,45,46,48,77,78,104],provid:[0,1,3,6,7,8,9,10,11,12,13,15,16,19,22,23,24,27,28,29,30,31,32,33,34,35,36,37,39,40,41,42,46,47,48,53,54,60,63,64,65,67,68,71,74,75,76,77,78,81,84,85,87,89,90,91,92,93,94,95,96,97,98,99,100,102,103,104,112,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],provis:[0,1,4,11,12,13,14,17,19,24,39,60,79,81,85,87,88,89,90,91,92,95,103,105],proxi:[96,97,98,99,100],proxy_zmf_password:[96,97,98,99,100],proxy_zmf_us:[96,97,98,99,100],prtyag:15,prvmod:15,psb1:62,psb2:62,psb3:62,psb:[15,58,61,62,63,64,68],psb_lib:[62,63,64],psb_name:[62,69],psbchk:15,psbgen02:69,psbgen:[69,70],psbgenl:69,psblib1:62,psblib2:62,psblib:[62,63,64,69],psdint:15,pseudo:15,pstype:15,psw:[123,127],ptf:[54,70,71,75,85,97],publish:[0,85,89,94,102,114,140],pudsa:15,pudsasz:15,pull:114,punch:[15,37,39],pure:41,purg:[15,43,53,61],purpos:[3,24,60,114],push:114,put:[6,7,8,9,10,19,31],pvdelai:15,pwrule_list:130,pycodestyl:140,pycrypto:140,pyflak:140,pylint:[114,140],pypi:140,pyt:[54,56,71],pytest:[22,59,114,140],python3:[24,46,60],python:[1,19,20,21,23,24,28,44,45,46,53,56,58,60,70,85,87,110,112,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],python_path:[24,60],pythonpath:[24,60],pyyaml:140,pyz:[24,60],quaiti:140,qualifi:[3,15,23,25,27,28,29,30,31,32,33,34,35,39,40,41,42,48,49,53],qualifier_pattern:23,quarter:56,quasi:15,quasir:[6,7,8,9,10],queri:[3,6,7,8,10,21,26,44,53,65,89,118],question:29,queu:15,queue:[3,15,17,19,37,38,39,53],queue_posit:[37,38,39],quickli:104,quiesc:15,quiestim:15,quot:[24,28,30,31,43,46,48,53,60],quotat:[24,30,43,53,60],r0101894:39,r0101895:39,ra000:39,race:[31,53],racf:[15,27,31,53],racfsync:15,racrout:15,rad:47,rain:23,rais:[0,23,24,36,53,60,111,140],ramax:15,ran:[16,24,37,38,39,60],random:[27,30,32,33,40,41],randomli:[30,31,41],rang:[6,8,9,10,15,38,42,49,104,121],rapool:15,rather:[15,84],raw:[4,5,11,12,13,14,15,17,18,29,32,42,47,49,66,69,70],rdsa:15,rdsasz:15,reach:[16,53,56],read:[15,24,30,31,33,37,39,40,41,42,49,52,53,54,55,60,63,71,83,84,101,105,107,114],read_onli:42,read_writ:42,readabl:[4,5,11,12,13,14,15,16,17,18,29],readi:[42,44],readm:[19,53,71,85],readonli:[15,41],readthedoc:116,readwrit:15,real:[37,39,140],realloc:53,realm:104,reason:[6,7,8,9,10,65],rebuild:62,rec:[4,11,12,13,14,17],receiv:[15,23,28,31,43,47,48,53,62,67,84,101],recent:140,recfm:[28,39,48],reclgth:42,recogn:[15,140],recommend:[0,22,23,24,36,42,49,60,70,71,84,90,91,92,94,102,114],recon1:67,recon2:67,recon3:67,recon:67,reconnect:15,record:[4,6,7,8,9,10,11,12,13,14,15,17,18,19,28,31,32,37,39,41,42,46,48,53,61,66,67,68,69,90,91,93,94,102,123,127,132],record_count:[6,7,8,9,10,37,39,42],record_format:[28,31,32,42,48,53,63,64],record_length:[28,31,32,42,48,63,64],records:42,recov:[15,29],recover:[15,29],recoveri:[11,15,27,30,40,41,42,63,64,67],recovnotifi:15,recreat:[28,31,63],red:[0,1,19,21,52,56,58,70,72,74,79,85,104,105,107,108,110,112],redact:15,redhat:[104,114],redirect:111,reduc:[36,53,131,140],reentrant:15,ref_dat:35,refer:[0,5,6,7,8,9,10,18,24,30,31,33,34,35,36,37,39,40,42,46,49,50,52,53,54,60,62,66,68,69,71,74,75,76,77,78,81,89,90,91,92,93,94,95,96,97,98,99,100,102,103,104,105,107,110,111,114,115,140],referenc:[15,35,40,42,64,94,102,135,137,140],reflect:53,refresh:15,regardless:[23,31,44,123],regex:[30,40,44],regexp:40,region:[1,3,4,5,6,7,8,9,10,11,12,13,14,15,17,18,19,20,39,63,64,68],region_data_set:[3,4,5,11,12,13,14,15,17,18,19],region_group:19,region_jcl:[3,19],regist:[15,39,45,53,83,84,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],registri:[85,90,91,93,95],regular:[30,35,40,42,44,53,117],regularli:105,reject:[123,140],rel:[31,41],relai:108,relat:[0,6,7,8,9,10,15,16,19,31,37,38,39,42,84,101,111,140],relatedassign:[6,7,8,9,10],relateddescript:[6,7,8,9,10],relatedscop:[6,7,8,9,10],relationship:[62,66],releas:[20,24,54,57,60,71,87,103,111],release_:114,release_m:114,release_not:114,relev:[65,114],reli:[30,33,34,39,40,45,46,53,55,110],reload:[31,39,46],remain:[15,28,31,41,48,49,53,116,119,121,122,125,127,129,132,134,135,137,139,140],remot:[0,15,27,28,30,31,33,34,39,40,46,48,66,69,81,83,87,96,97,98,99,100,111,114,135],remote_cmd:46,remote_src:[31,46,48,53],remote_tmp:[46,53],remote_zmf_password:[96,97,98,99,100],remote_zmf_us:[96,97,98,99,100],remotenam:[6,7,8,9,10],remotesystem:[6,7,8,9,10],remount:41,remov:[3,5,8,15,18,19,26,28,30,31,32,39,40,41,46,53,64,85,89,90,114,127,132,140],removecnt:[6,7,8,9,10],renam:[27,30,40,41,49,53,116,140],render:[31,39,46],renov:140,rentpgm:15,repeat:[0,15],repeatedli:[27,30],replac:[15,19,24,27,30,31,32,40,42,53,60,66,69,70,135],replace_acb:63,repli:44,replic:[42,53,129,135,137],repo:[114,140],report:[39,53,87,97,98,99,140],repositori:[0,7,19,42,74,85,88,104,105,108,111,140],repres:[1,6,8,9,10,15,21,24,30,40,55,58,60,64,72,79,96,97,98,99,103,112,114,118,137],represent:[55,123],repro:[31,42],req:[0,114],request:[0,2,3,6,7,8,9,10,15,16,19,20,22,24,31,32,41,42,44,53,59,60,73,80,83,85,91,93,94,96,97,98,99,100,102,114,123,133,140],requestmethod:83,requests_ca_bundl:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],requesturi:83,requir:[3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,22,24,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,45,46,47,48,49,50,54,55,56,60,62,63,64,65,66,67,68,69,70,71,74,75,77,78,81,82,84,85,86,87,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,109,111,114,131,140,141],res820:36,rescount:[6,7,8,9,10],reserv:[0,23,127,132],reset:[41,119,123,131,140],reset_clear:[123,140],reset_norm:[123,140],resgroup:[6,7,8,9,10],resid:[6,7,8,9,10,15,27,37,38,39,42,49,84,96,97,98,99,101],reslib:[62,63,64,68],resolv:[0,23,62,63,64,68,85,97,98,140],resourc:[0,1,3,7,12,15,16,19,27,31,35,45,53,63,64,66,72,76,83,105,108,111,112,115,116,117,119,120,122,123,124,125,127,128,129,132,134,135,137,139,140,141],resource_chkp_freq:[63,64],resource_typ:35,resourceclass:83,resourceitem:83,resourceprofil:83,resoverrid:15,resp2:[6,7,8,9,10],resp:[6,7,8,9,10,15],resp_alt:[6,7,8,9,10],respect:[15,28,35,135,140],respet:15,respond:[24,60],respons:[6,7,8,9,10,15,16,26,27,30,31,33,34,39,40,42,43,47,53,61,62,67,68,81,96,97,98,99,100],response_encod:42,ressec:15,ressnam:[6,7,8,9,10],rest:[1,3,6,7,8,9,10,19,20,31,39,46,72,75,76,77,78,79,83,84,85,87,96,97,98,99,100,110],restart:[11,12,13,15,44,127],restor:[21,26,46,49,53],restore_backup:53,restrict:[35,36,84,101,140],result:[3,9,16,23,24,26,27,28,30,31,32,34,37,38,39,40,42,43,45,46,47,48,53,60,61,62,65,66,69,83,84,96,97,98,99,101,117,120,123,131,135,140],result_auth:[83,84],resum:76,resver:[6,7,8,9,10],ret_cod:[16,37,38,39,42,53],retain:[4,5,11,13,14,15,17,18,31,42,53,64],retent:[15,64],retri:[93,94,102],retriev:[15,19,21,27,28,30,31,33,36,40,41,48,53,85,89,91,96,97,98,99,140],return_cod:65,return_cont:[40,42],return_output:[39,53],return_text:[66,69],return_valu:[24,60],reus:[15,31,42],revert:53,review:[0,2,20,22,25,41,51,53,54,56,59,71,73,80,87,104,105,106,110,111,114],revoc:15,rexx:[21,35,45,46,47,50,53,84,101],rich:50,right:114,ring:15,rload:[6,7,8,9,10],rls:15,rlse:39,rlstolsr:15,rmode:39,rmtran:15,rnl:15,roce:125,rocket:[71,111],role:[29,72,74,79,82,85,87,96,97,98,99,100,103,104,115,135,140],rollback:68,room:15,root:[15,24,27,28,30,31,33,40,48,60,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],round:123,rout:[15,65],router:15,routin:[29,53],rplid:[6,7,8,9,10],rrd:[31,32,42,63,64],rremov:[6,7,8,9,10],rrm:15,rrn:15,rsdnt:43,rsn:65,rst:[15,114],rstsignoff:15,rstsigntim:15,rsusr:23,rule1:[129,137],rule:[28,31,32,48,84,114,115,116,135,140,141],run:[2,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,26,27,29,30,31,32,38,39,40,41,47,49,53,54,55,58,59,62,63,64,65,66,68,69,71,75,84,85,87,89,90,91,92,93,94,95,101,104,108,110,114,140],runawai:15,runlib:30,runner:32,runth:23,runtim:[6,7,8,9,10,15,19,23,63,68],ruse:[6,7,8,9,10],ruwapool:15,rwx:[28,31,48],s0c4:[16,37,38],s0jm:[37,39],sa_create_dynamic_resourc:76,sa_delete_dynamic_resourc:76,sa_rest_api_timeout:[77,78],sa_service_hostnam:[77,78],sa_service_port:[77,78],sa_service_protocol:[77,78],saf:[83,85,87],safeti:[131,140],same:[3,15,16,23,28,30,31,32,33,34,36,39,41,42,46,48,53,56,63,83,84,87,101,102,104,114,131,135,140],same_workflow_inst:84,sampl:[4,5,6,7,8,9,10,11,12,13,14,15,17,18,19,20,25,27,30,31,33,34,35,36,37,38,39,40,41,43,44,45,46,47,49,61,62,63,64,66,67,68,69,70,74,82,83,84,85,91,96,97,98,99,100,101,104,105,111,116,117,118,119,120,121,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,140],sample2:70,sample_seq_data_set:31,samplehost:[77,78,90,91,92,93,94,95,96,97,98,99,100,102],samplenam:23,san:[23,127,132,133,134],saniti:[70,114,140],sanitis:19,sass:47,satisfi:[31,53,83],save:[13,36,39,42,63,85,90,91,92,94,100,102],save_acb:63,sc27:113,sca:[83,85,87],scalar:42,scan:[15,39,53],sceecic:15,sceerun2:15,sceerun:15,scenario:31,scene:[24,60],schedul:62,scheme:[6,7,8,9,10],sci:65,scope:[6,7,8,9,10,15,24,31,39,46,60,137],scp:[31,34,39,45,46,48],scp_extra_arg:45,scr002:42,scr013:23,scr03:35,scratch:63,screen:15,script:[11,16,19,26,30,39,47,48,50,53,54,71,84,101,140],sdesc:77,sdfhauth:[15,27],sdfhlic:15,sdfhload:[3,11,12,13,15],sdfhsamp:15,sdfjauth:27,sdfsmac:[39,66,69],sdfsresl1:62,sdfsresl2:62,sdfsresl:[62,63,64,67,68],sdk:[0,20,53,56,70,111],sdsa:15,sdsasz:15,sdsf:53,sdtmemlimit:15,sdtran:[15,16],sdump:15,se_vers:[120,124,128],seamless:[0,103],search:[15,23,31,35,42,46,48,53,56,85,89,104],search_software_updates_respons:99,search_software_updates_response_fil:99,sec:[9,15,37,39,53],second:[6,7,8,9,10,15,16,19,23,39,43,53,77,78,93,94,101,102,114],secondari:[4,5,11,12,13,14,15,17,18,19,28,31,32,42,48,53,63,64],secondary_log_dataset:63,secondary_unit:[63,64],secprfx:15,secret:135,sect:39,section:[3,6,7,10,16,22,23,24,37,38,39,53,54,59,60,63,64,70,104,105,110,114,140,142],secur:[15,31,34,39,41,46,48,53,70,81,85,87],secure_boot:140,secure_execut:140,see:[0,2,3,6,7,8,9,10,16,20,22,23,32,39,59,71,73,80,104,111,114,119,120,123,124,132,135,140],seen:53,segment:[35,53,62,63,64,66],segment_chkp_freq:63,select:[0,15,24,29,35,48,53,56,60,63,64,105,109,110,114,127,132],selector:[127,132],self:140,semant:[104,114],semicolon:[47,53],semver:114,send:[15,28,53],senseg:62,sensit:[6,7,8,9,10,15,19,28,31,32,41,48,53,62,96,101,129],sent:[6,7,8,9,10,42,48],separ:[15,30,35,104,105,127,131,140],sepcifi:15,seq:[27,28,31,32,35,42,48,63,64,66,69],sequenc:[31,39,42,46,131],sequenti:[5,11,15,18,27,28,30,31,32,33,34,35,39,40,42,66,69],ser:39,seri:[16,37,38,39,55,104],serial:[15,23,27,31,39,49,63,64],serv01:41,serv02:41,serv03:41,serv04:41,serv:22,server:[0,15,41,72,75,76,77,78,81,83,84,87,90,91,92,93,94,95,96,97,98,99,100,101,102,108,110,111,127,132,135,140],server_list:104,servic:[11,15,19,20,21,28,30,31,33,34,37,38,39,40,41,42,46,48,52,53,54,55,66,69,71,76,77,78,79,84,85,87,89,92,93,95,97,98,99,100,101,105,107,112,113,135,141],session:[15,24,60,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139,140],session_id:[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],set:[0,1,3,6,7,8,9,10,11,12,13,14,16,19,20,21,22,23,24,26,27,30,31,33,34,36,37,38,39,40,41,42,43,44,46,47,49,50,53,54,57,60,62,63,64,66,67,68,69,70,71,87,89,97,98,99,104,110,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],set_dynam:27,set_fact:[30,91],set_stat:27,setgid:41,setprog:27,setuid:41,setup:[53,63,87,140],setuptool:140,seven:15,sever:[3,15,24,39,53,60,81,89,115,140],seyuauth:15,seyuload:15,sftp:[31,34,39,45,46,48,111],sg1:132,sga1:133,sha256:[31,34],share:[15,30,31,32,39,40,41,46,53,63,89,123,127,132,135],share_mod:63,shareopt:42,sharestatu:[6,7,8,9,10],shell:[20,24,30,36,40,46,56,60,70,71,84,101,111,114],ship:15,shorter:53,shortli:140,should:[9,15,16,23,24,28,29,30,31,32,33,34,35,39,40,41,42,43,45,46,48,53,60,63,64,84,85,87,114,131,140],shouldn:[24,60],show:[0,3,15,19,20,37,43,46,65,104,114,123,140],shown:[3,6,7,10,16,37,38,39,90,91,92,94,96,97,98,99,100,102,114,123],shr:[15,30,31,32,39,40,42,47,53,63,64],shrd:[37,39],shut:16,shutdown:[1,3,15,16,19,41],side:24,sign:[15,29,140],signal:15,signifi:31,significantli:19,signon:15,similar:[26,42,61,81,105,129],similarli:[24,42,60],simpl:[28,48],simplex:49,simplifi:[24,60,76,140],simul:68,simultan:[0,30,32,40,53],sinc:[29,32,42,55,70,84,114,131,140],singl:[3,6,7,8,9,10,15,24,28,29,32,40,42,43,47,60,65,66,67,69,137],singular:[4,5,11,12,13,14,15,17,18],sit:15,sit_paramet:15,site:[0,15,19,85,114],situat:[15,23,41,42,105],six:[6,7,8,9,10,27],size:[4,5,11,12,13,14,15,17,18,19,24,28,29,31,32,34,35,37,39,42,43,46,48,49,53,60,63,64,132,134],skelet:67,skip:[46,49,84],skrxxxx:15,slightli:40,slot:[37,39],smaller:28,smf000i:[37,39],smf_name:36,smp:89,sms:27,sms_data_class:[28,31,32,42,48],sms_manag:49,sms_management_class:[28,29,31,32,42,48],sms_storage_class:[28,29,31,32,42,48],smss:[6,7,8,9,10,19],smssj:15,sna:15,snippet:23,snp:15,snpreset:15,snscope:15,socket:[15,74,77,78],softar:90,softwar:[79,85,87,89,96,100,105,109,110],software_instance_nam:[96,97,98,99],software_instance_uuid:[96,97,98,99],software_management_csi_query_cicdtest1:96,software_management_reports_cicdtest1:[97,98,99],software_management_system_uuid_cicdtest1:100,software_typ:90,sole:[24,60],solut:[51,103,106],some:[13,24,27,28,30,31,32,34,35,40,41,42,49,53,54,60,62,63,64,66,68,69,84,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],somedirectori:30,somefil:[34,40,66,69],somefile1:66,somefile2:66,someobject:[24,60],sometim:[63,64,65,67,68],someus:41,sort:42,sortin01:42,sortin02:42,sortout:42,sortpgmoutput:42,sotun:15,sourc:[0,11,27,28,30,31,33,34,39,40,41,42,45,48,50,51,53,55,66,69,103,104,106,114],source_memb:[66,69],source_nam:[66,69],sp800:15,space:[0,4,5,6,7,8,9,10,11,12,13,14,15,17,18,28,29,30,31,32,37,38,39,42,46,48,49,53,63,64,105],space_primari:[4,5,11,12,13,14,15,17,18,28,31,32,42,48,53],space_secondari:[4,5,11,12,13,14,15,17,18,19,28,31,32,42,48],space_typ:[4,5,11,12,13,14,15,17,18,28,29,31,32,42,48,53],spack:28,spctr:15,spctrxx:15,spe:75,special:[15,28,30,31,39,40,42,43,44,46,48,49,53,121,129],special_nam:23,special_names_get_uppercas:23,specif:[3,15,20,24,28,31,35,36,37,42,48,52,53,54,58,60,62,64,65,69,71,85,87,89,90,93,94,96,102,104,107,109,110,111,114,115,117,118,121,123,124,126,127,128,132,140],specifi:[0,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,23,25,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,44,46,47,48,49,53,62,63,64,65,66,67,68,69,77,78,83,84,87,90,91,92,93,94,95,96,97,98,99,100,101,102,104,111,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],speed:[42,140],sphinx:[114,140],spool:[15,37,39,53,84,101],spoolopen:15,spoolwrit:15,sql:[31,61],sql_input:68,srb:[37,39],srbsvc:15,src:[28,30,31,33,34,39,40,41,46,47,48,53,66,69],src_encod:42,src_param:41,srcmem:31,srm:15,srt:15,srvercp:15,ssc:[119,123,125,127,132],ssc_dns_server:140,ssc_ipv4_gatewai:140,ssc_ipv6_gatewai:140,ssh:[0,20,45,87],ssh_modul:45,ssl:[6,7,8,9,10,15],sslcach:15,ssldelai:15,sso:104,stabl:[114,116,140],stable_:114,stable_m:[114,140],stack:53,stage:[15,63,68,83],stamp:15,stand:[6,7,8,9,10,19,20],standard:[4,5,11,12,13,14,15,16,17,18,31,34,39,46,48,63,64,66,68,69,114,129,130,135,136,138,140],standbi:15,start:[4,5,9,11,12,13,14,15,17,18,19,24,30,31,32,35,37,39,40,45,46,53,60,84,85,93,101,103,104,108,119,127,132,140],start_:114,start_cic:19,start_m:114,start_stat:[4,5,11,12,13,14,15,17,18,19],starter:15,startup:[1,3,19],state:[3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,24,27,28,30,31,32,38,40,41,49,53,60,83,84,90,116,118,119,121,122,123,125,127,129,131,132,133,134,135,137,139,140],statement:[15,24,27,31,37,39,42,46,53,60,61,62,63,64,67,84,87,101,102,140],stateod:15,statint:15,statist:[15,37,39],statrcd:15,statu:[6,7,8,9,10,15,16,26,33,37,39,41,42,43,53,63,64,65,66,67,69,83,84,101,114,116,117,119,120,121,123,124,127,128,132,133,140],status:[53,127],status_group:42,stc00143:64,stc01533:44,stc01537:44,stc02560:37,stc:[37,38],stderr:[4,5,11,12,13,14,15,17,18,27,30,31,34,35,41,45,46,53,63,64,66,68,69,111],stderr_lin:[31,34,41,46],stdout:[4,5,11,12,13,14,15,17,18,27,30,31,34,35,41,46,53,66,69],stdout_lin:[31,34,41,46],step0001:[37,38,39],step1:64,step:[15,16,24,37,38,39,42,60,66,84,85,101,114],step_cc:[16,37,38,39],step_nam:[16,37,38,39,84],step_numb:84,step_titl:84,steplib:[15,62,63,64,67,68],stepnam:[37,39,84],stgadmin:[49,83],stgprot:15,stgrcvy:15,still:[53,84,114,140],stl1:[37,39],stmt:39,stntr:15,stntrxx:15,stop:[3,19,37,39,47,53,65,84,88,93,119,127,140],stop_cic:19,stop_cics_modul:15,stop_region:[3,19],stor:42,storag:[3,15,19,27,28,29,31,32,34,42,46,48,49,63,64,115,116,119,122,123,127,137,140],storage_class:[63,64],storage_group:[132,137],storage_group_attach:133,storage_group_nam:[133,134],storage_group_templ:137,storage_group_uri:140,storage_volum:134,storageadmin:137,store:[6,7,8,9,10,12,14,15,28,29,32,34,41,42,48,49,63,67,77,78,105,111],str:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,23,24,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,60,62,63,64,65,66,67,68,69,70,77,78,82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],strategi:[0,103],stream:[4,5,11,12,13,14,15,17,18,31,34,42],streamlin:87,street:23,string:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,23,24,28,31,32,34,35,39,41,42,44,46,47,48,53,55,60,65,70,84,116,119,120,122,123,125,127,129,132,134,135,137,139,140],strip:[31,39,46],strong:[82,83,84],structur:[19,24,47,60,62,65,89,131,140],style:[36,42],sub:140,subdirectori:53,subentri:96,subgroup:47,subgroup_info:65,subject:[15,31,53,99,137],submiss:[16,37,38,39,53],submit:[11,15,16,21,26,43,47,50,53,61,64,84,101],subopt:53,subparamet:15,subscript:105,subsequ:[19,27,30,84,101,140],subset:[6,7,8,9,10,36,70,117,119,120,124,126,128,130,136,138,140],substep3:84,substitut:[39,43],substr:44,subsystem:[27,28,37,39,48,77,78,105,123,132,133,134],subtsk:15,succe:[111,114],succeed:[53,82,114],succesfulli:67,success:[6,7,8,9,10,15,27,28,30,31,32,33,34,35,37,38,39,40,41,42,43,44,45,48,62,66,69,82,83,84,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],success_count:[6,8],successfulli:[6,8,16,32,34,41,42,114],sudo:140,suffici:135,suffix:[15,114],sum:15,summari:39,supplementari:[52,107,108],suppli:[6,7,8,9,10,16,19,24,32,42,60,82,83,84,101],support:[6,7,8,9,10,11,15,19,21,23,24,28,30,31,33,34,35,39,40,42,44,46,48,49,53,54,55,58,60,62,63,64,66,68,69,70,71,72,79,82,83,84,85,87,93,101,103,109,110,114,115,116,121,127,140],supprt:140,sure:[0,28,46,111,114],surpress:15,surrog:15,surround:[30,41],surveil:15,sv1:134,svc:[15,62,63,64,68],svc_class:[37,38,39],svllab01:36,svplex1:36,sy1:84,sydumax:15,symbol:[28,31,39,43,48,55,66,69],sync:140,syncpoint:15,syntax:[30,53,96,97,98,99,100,104,105,116,119,122,123,125,127,129,132,134,135,137,139],sys1:[30,41,42,66,69],sys20073:39,sys:[24,36,60],sys_lib:[66,69],sys_nam:36,sysabend:[15,63],sysaff:39,sysctlg:47,sysda:39,sysdef:15,sysexec:46,sysidnt:15,sysin:[15,37,39,42],syslib:39,syslin:39,syslmod:39,sysmod1:99,sysmod2:99,sysmod3:99,sysmod:[85,97,98,99],sysnam:41,sysout:[15,37,39,42],sysplex:[15,41,87,90,123],sysplex_nam:[36,90],sysprint:[15,37,39,42],sysr:27,system:[0,1,6,7,8,9,10,11,12,15,16,19,21,24,26,27,28,29,30,31,32,33,34,35,37,38,39,40,42,43,44,46,47,48,49,53,55,60,62,63,64,65,66,68,69,74,75,76,77,78,84,85,87,89,90,91,92,93,94,95,96,97,98,99,101,102,104,105,113,114,116,117,119,120,121,122,123,124,125,126,127,128,129,132,133,134,135,136,137,138,139,141],system_nam:90,system_nicknam:[94,96,97,98,99,100,102],systems_nam:[90,102],systems_nicknam:94,systr:15,sysudump:15,sysut1:[37,39,64],sysut2:[37,39],sysut3:62,sysut4:62,syszd6:36,t043jm:[37,39],t12345:27,t125008:39,tabl:[6,7,8,9,10,15,32,49,53,56,94,102,114],tableonli:15,tag:[31,41,53,71,114,140],tag_ccsid:[41,53],tag_untag:[41,53],tailor:105,take:[4,5,11,12,13,14,15,17,18,23,28,31,34,39,42,53,62,63,64,67,68],taken:[15,19,32,35],takeov:[15,41],takeovr:15,tape2:41,tape_link_uri:140,tar:[27,28,30,31,33,40,41,48,53,104,114],tarfil:28,target1:69,target2:[66,69],target3:69,target4:[66,69],target:[0,3,5,6,7,8,9,10,15,18,22,23,24,26,29,31,36,37,38,39,45,47,48,49,53,60,61,62,63,64,65,66,67,68,69,71,77,78,81,84,87,90,91,92,93,94,95,96,101,102,110,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139,140,141],target_userid:83,targetassign:[6,7,8,9,10],targetdescript:[6,7,8,9,10],task:[0,1,3,4,5,11,12,13,14,15,16,17,18,19,21,26,27,30,31,32,33,34,39,40,46,49,53,54,58,61,63,71,72,74,75,77,78,79,81,82,84,87,89,90,91,92,93,94,95,96,97,98,99,100,101,102,108,110,111,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139,140],taskno:15,tbexit:15,tcb:15,tcp:[6,7,8,9,10,15,37],tcpip:[15,37],tcsactn:15,tcswait:15,tct:15,tctua:15,tctuakei:15,tctualoc:15,td_intrapartit:[3,19],tdintra:15,team:[105,111,114],tell:[24,60],temp_acb_dataset:63,temp_backup:29,temp_volum:29,tempdir:70,templat:[0,3,4,5,11,12,13,14,15,17,18,25,27,30,31,39,46,53,72,77,85,89,94,135,136,137],template_paramet:[31,39,46],templatenam:77,templt:15,tempnam:39,temporari:[0,3,15,19,24,27,28,29,30,31,32,33,34,40,41,42,46,48,49,53,60,140],temporarili:[29,31,32,34,39,46,48,140],tenant:94,tenant_nam:94,tend:111,terabyt:35,term:[105,110],termid:15,termin:[12,15,16,31,39,41,42,63,64,127,140],termuacc:47,ters:[28,48,53],terse_pack:[28,53],test01:[24,60],test1:[24,33,48,60],test2:48,test:[2,28,29,30,31,32,33,34,35,39,40,42,47,48,52,53,56,70,107,137,140],test_config:[24,60],test_create_dataset_arg_expans:[24,60],test_create_dataset_exception_receiving_nam:[24,60],test_create_dataset_missing_all_arg:[24,60],test_create_dataset_missing_second_arg:[24,60],test_create_dataset_various_arg:[24,60],test_data:[24,60],test_dataset_cr:[24,60],test_partit:114,test_zhmc_password_rul:140,test_zhmc_us:140,testcas:[70,114,140],testdata:33,testdb:67,testdsn:[24,60],tester:[11,24,39,60],testgrp1:11,testgrp2:11,testhmc:[114,140],testinventori:140,testnam:[23,24,60],testopt:114,testpgm:31,testprg1:11,testprg2:11,testus:47,testusr:49,testutil:140,testvault:140,text:[6,7,8,9,10,15,16,30,31,39,41,42,43,44,45,53,65,68,83,114,135,140],textual:[21,26],tfs:41,than:[6,8,9,10,15,28,31,33,34,35,38,39,41,47,49,53,63,84,114,123,140],thei:[0,15,23,24,25,27,28,29,31,32,34,41,43,48,53,60,71,81,140],them:[15,20,23,28,31,39,42,44,46,53,64,90,94,105,114,140,141],therefor:[15,20,24,25,27,42,51,60,85,87,106],thi:[0,1,2,4,5,6,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,27,28,29,30,31,32,34,35,36,37,38,39,40,41,42,43,45,46,48,49,50,53,56,58,59,60,62,63,64,65,66,67,68,69,70,71,72,73,74,75,77,78,79,80,83,84,85,87,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,112,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],thin:[24,60],thing:114,third:[82,83,84],those:[0,15,35,48,81,85,97,137,140],though:[31,41,53,118],thousand:15,thread:[127,132],threadsaf:15,three:35,threshold:15,through:[1,11,15,16,21,30,31,32,34,37,38,39,40,46,53,58,62,72,79,84,103,112,114,135],throughout:53,thu:[31,34,39,46,48,56,71,110,140],time:[6,8,9,10,15,16,23,24,28,35,36,37,38,39,42,43,49,53,56,60,66,69,84,93,94,101,102,114,135,140],time_stamp:64,timeout:[6,7,8,9,10,15,16,19,74,77,78,127,132,135],timestamp:[27,30,31,33,40,41,63,64],tinad:35,tip:[22,59],titl:84,tke:121,tls11:15,tls12:15,tls13:15,tmp:[0,28,29,30,31,34,35,40,41,42,46,48,53,66,69,90,91,92,94,96,97,98,99,100,102,111],tmp_hlq:[27,28,29,30,31,32,33,34,40,41,42,48,49,53],tmp_path:53,tmphlq:[27,28,29,30,31,32,33,34,40,41,42,48,49],to_csdgroup:6,to_encod:[33,53],to_expand:[24,60],todai:114,togeth:[15,35,37,39,51,103,106],token:[0,82,83,84,104,123],toler:[131,140],tool:[15,140],toolkit:45,top:[15,25,28,114],top_data_set:15,topic:[0,6,7,8,9,10,41,96,97,98,99,100,105,114],total:[15,39,44,93,94,102,116,132],tower:0,trace:[3,15,19,53],traceback:53,track:[4,5,11,12,13,14,15,17,18,49,53],tracker:114,tradit:[71,105],trail:[29,31,39,44,46,53],tran:[15,65],traniso:15,transact:[3,15,16,19,65],transaction_dump:[3,19],transfer:[31,34,39,45,46,48,50,55,111],transform:25,transid:[6,7,8,9,10],transmit:28,transport:28,trap:15,travers:[34,53],travi:140,trdumax:15,treat:[31,39,42,45,46,66,69],tree:[28,31],trigger:53,trim_block:[31,39,46],trk:[4,5,11,12,13,14,15,17,18,28,29,31,32,42,48,49],troubleshoot:[103,140],trtabsz:15,trtransz:15,trtranti:15,truncat:[31,33,42],trust:[6,7,8,9,10],tsmainlimit:15,tso:[16,21,26,35,46,53],tsocmd_to_issu:[84,101],tst:15,tstre:67,tsu:38,tuesdai:[23,37],tune:15,tupl:121,turn:0,two:[3,5,15,18,20,23,24,28,29,30,35,42,46,60,62,63,66,76,114,121,140],txt:[19,24,28,30,31,40,42,46,48,60,114,140],type:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,20,22,24,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,53,58,60,62,63,64,65,66,67,68,69,70,77,78,82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],type_2_data:65,typeerror:[24,53,60,140],typic:[19,22,24,40,60,87],typrun:[39,53],u0026mbr:39,u00270000:49,u0027:[31,34,37,39,41,49],u0027hello:[37,39],u0027i:41,u0027object:39,u0027sourc:41,u0027un:34,u0027us:34,u0027xref:39,udsa:15,udsasz:15,udx:121,ui66511:85,ui66512:85,ui70435:70,uid:[31,41],unabl:[53,111],unaccept:[120,123,124,127,128,132],unalloc:15,unarch:[26,28,53],unarchiv:[48,53],unassign:132,unauthent:[6,7,8,9,10],unauthor:[42,53,62],unbind:15,uncatalog:[30,31,32,33,34,35,39,40,41,42,53,63],uncatalogu:53,uncatlg:[53,63,64],unchang:[40,41,49,116,119,121,122,125,127,129,132,134,135,137,139],uncommit:15,uncompress:48,uncond:63,uncondition:63,unconfigur:[116,140],unconstrain:15,undefin:31,undeliver:15,under:[0,6,7,8,9,10,15,24,25,28,36,37,53,60,67,93,104],undercov:83,undergo:110,underli:[31,34,39,42,46,48,56],underscor:[70,116,119,122,123,125,127,129,132,134,135,137,139,140],understand:[53,105,108,111,114],understood:41,undo:[11,12,24,60],undocu:53,unew:114,unexpect:[28,31,48,53],unformat:67,unformatted_output:67,unicod:[55,140],unicodedecodeerror:111,unidentifi:53,unifi:[0,51,103,106,140],uniform:66,uniqu:[15,16,30,31,37,38,39,41,42,53,84,94,100,102],unit:[4,5,11,12,13,14,15,17,18,22,28,29,31,32,39,42,43,48,49,59,63,64,104,114,123,127,132,134],unittest:[24,60],unix:[11,15,19,21,28,29,30,31,33,34,39,40,41,42,46,48,53,55,66,69,84,101],unknown:[6,7,8,9,10,43,83,104],unless:[15,28,31,39,42,43,44,46,48,56,62,68,104,123,132,133],unlik:25,unmanag:120,unmount:41,unmount_opt:[41,53],unnecessari:[22,23,42,53,140],unord:42,unpack:[28,48,53],unpin:140,unqualifi:35,unspecifi:[28,31,48],unsuccess:104,unsupport:36,untag:[41,54,71],until:[15,16,42],unusu:140,unvers:114,uownetql:15,upb:42,updat:[1,3,7,11,15,16,19,23,27,30,32,40,41,53,63,64,65,70,74,83,85,89,105,111,114,115,117,119,122,123,125,127,129,132,134,135,137,139,140],update_paramet:10,update_retention_criteria:64,upgrad:[11,12,13,111,140],upload:[114,140],upon:100,upper:[15,23,53],uppercas:[53,96],uppercase_str:23,upstream:114,uri:[74,83,116,119,121,123,125,127,129,132,134,135,137,140],url:[6,7,8,9,10,84,101,104,140],urm:15,urole_list:138,usabl:15,usag:[0,6,7,8,9,10,23,25,53,70,121,127,132,134,140],usage_domain:121,use:[0,1,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,19,20,22,24,27,28,29,31,32,34,39,40,41,42,45,46,48,49,53,60,63,64,67,71,76,83,84,85,89,103,104,105,108,110,111,114,131,140],use_adrdssu:[28,48],use_qualifi:34,use_regex:44,use_templ:[31,39,46],useagelstat:[6,7,8,9,10],usecount:[6,7,8,9,10],used:[0,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,22,23,24,25,26,27,28,29,30,31,32,33,34,35,37,39,40,41,42,43,46,48,49,50,53,55,60,61,62,63,64,66,67,68,69,70,75,76,77,81,82,83,84,85,87,90,91,92,93,94,95,96,97,98,99,100,101,102,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],usefetch:[6,7,8,9,10],useful:[30,40,108],user03:39,user1:135,user:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,23,24,27,28,29,30,31,32,33,34,35,39,40,41,42,46,47,48,49,50,53,60,64,65,68,77,78,82,83,84,85,89,90,91,92,93,94,95,96,97,98,99,100,101,102,104,105,114,115,117,124,128,140,141],user_data_set:19,user_list:136,user_nam:111,user_pattern_nam:135,user_pattern_uri:135,user_rol:[135,137,138],user_role_nam:135,user_to_list:[84,101],userexeckei:[6,7,8,9,10],userid:[15,37,39,96,97,98,99,100,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],userlib:[35,67],usernam:[24,29,32,60,77,78,82,83,84,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],usertr:15,uses:[0,12,13,15,16,24,28,31,34,37,39,46,48,49,50,53,60,90,91,92,94,102,114,131,140],using:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,24,25,26,28,29,30,31,32,34,35,38,39,40,41,42,43,45,46,47,48,49,53,56,60,62,63,72,81,86,87,90,91,92,93,94,95,96,97,98,99,100,102,104,115,116,122,123,125,127,131,137,139,140],usr0010:27,usr:[23,24,46,60,111],usrdelai:15,uss:[11,24,27,28,30,31,33,34,35,39,40,41,42,48,53,55,60,66,69],ussconfig:15,usshom:15,usual:[0,37,41,81],utf:[23,31,39,53,55,111],util:[0,1,12,13,16,20,21,24,30,33,34,37,38,39,40,42,53,56,58,60,62,63,64,67,68,69,70,71,111],uuid:[85,89,96,97,98,99,132,134],v15:71,v2r2:55,v2r3:[24,56,60,70,71,85,87,88],v2r4:[56,70,85],v2r5:85,v2rx:56,v3r8:[24,60],v5r3m0:27,v7k:122,valid:[6,7,8,9,10,15,19,22,23,24,28,29,31,32,34,35,39,41,42,44,46,48,53,60,63,64,68,81,84,85,87,96,114,116,131,132,140],validate_checksum:34,validatedid:83,valu:[3,19,22,23,24,29,53,60,61,70,74,77,78,81,85,90,91,92,93,94,95,96,97,98,99,100,101,102,105,140],value1:[24,60,102],value2:[24,60,102],value3:[24,60],value_specified_in_no_log_paramet:135,valueerror:23,var1:[90,91,93,94,102],var1_valu:[90,93,94],var2:[90,102],var2_valu:90,varaibl:101,vari:[0,27,28,31,32,42,48,49,51,53,55,66,105,106,110],variabl:[0,6,7,8,9,10,19,23,24,27,28,30,31,32,34,36,39,40,42,46,48,53,60,63,71,83,84,104,111,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],variable_end_str:[31,39,46],variable_start_str:[31,39,46],variant:114,variou:[15,63,64,68,85,90,93,94,102,105,112],vars_fil:[77,78,89],vars_prompt:[77,78,82],vault:140,vba:[28,31,32,42,48,63,64],vcat:47,vendor:[84,90],vendor_nam:90,verbos:[31,34,42,43,53,68,105,114],veri:15,verif:[6,7,8,9,10,15,27,30,40,49,140],verifi:[11,12,13,15,17,18,23,34,45,49,83,111,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],verify_offlin:49,verify_volid:49,verify_volume_empti:49,verison:140,versa:114,version:[6,7,8,9,10,15,20,24,28,30,31,33,34,36,39,40,54,55,56,60,64,71,83,84,90,101,109,110,111,113,118,120,124,127,128,132,137],version_ad:140,version_numb:64,vfm:123,vfunction1:139,vhba_cpca_sg_mgmt12:132,via:[6,7,8,9,10,19,79,114,122,135],vice:114,video:108,view:[0,15,24,56,60,63,84,109,137],view_onli:137,vio:42,violat:15,virt:[37,39],virtual:[15,49,112,114,115,122,125,127,132,140],virtual_funct:139,virtual_switch_uri:125,visibl:[31,90,114,141],visit:[0,54,71,108],vlan:[125,127],vlan_typ:140,vm_name:36,vol033:31,vol:[27,39],volid:49,volser:[39,43,49,53],volstat:43,volum:[4,5,11,12,13,14,15,17,18,21,23,26,27,31,32,35,39,42,48,53,63,64,96,97,98,99,115,127,132,140],volupt:140,vsam:[4,11,12,13,14,15,17,19,28,31,32,33,34,35,42,48,49,53,67],vsamcat:15,vsamdset:47,vtam:15,vtoc:[49,53],vtoc_siz:49,vtprefix:15,vuln:140,vulner:140,vvd:49,vvv:[41,105],vvvv:[31,34,105],wai:[0,19,20,31,39,46,53,89,104,140],wait:[15,16,39,41,42,43,53,84,93,94,102,114],wait_time_:[39,43,53],want:[4,5,11,12,13,14,15,17,20,28,30,32,40,53,64,77,78,104,105,111,114],warm:[4,5,11,12,13,14,15,17,18,19],warn:[15,24,37,39,45,53,60,104,105],weakli:84,weather:23,web:[15,45,52,82,83,84,107,112,113,114,135,141],webdelai:15,webspher:[90,92,93,94,95],week:35,weekli:114,weheth:120,weight:[123,127,132],welcom:[15,30],well:[0,15,30,31,39,40,42,46,53,64,65,67,71,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],were:[15,16,19,23,28,37,38,39,41,43,44,53,62,64,68,70,121,123,137,140],what:[15,41,42,49,53,81,84,104,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],wheel:140,when:[2,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,22,23,24,25,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,45,46,48,49,50,53,56,59,60,63,64,66,69,73,75,80,82,83,84,86,87,90,91,92,93,94,95,96,97,98,99,100,101,102,104,105,110,114,119,122,123,125,127,129,131,132,134,135,137,139,140],whenev:[41,114],where:[4,5,11,12,13,14,15,17,18,20,23,24,28,29,31,32,33,34,37,38,39,41,42,44,46,48,53,60,63,64,66,70,75,77,90,91,92,94,96,97,98,99,100,102,105,122,123,125,127,129,132,134,135,137,139,140],whether:[0,4,5,6,7,8,9,10,11,12,13,14,15,17,18,23,30,31,34,39,40,41,42,46,48,53,62,64,83,84,90,101,111,114,120,123,124,127,128,132,133,135,137,140],which:[3,4,5,6,7,8,9,10,11,12,13,14,15,17,18,19,23,24,28,29,30,31,32,33,34,35,39,40,41,42,44,46,48,53,60,62,63,64,65,67,68,69,70,71,74,77,78,82,83,84,85,87,96,97,98,99,101,104,105,110,114,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140],whitespac:70,who:[15,16,27,30,31,33,37,38,40,83,85,90,94],whole:15,whoneedsaccess:83,whose:[15,29,35,44,126,127],why:114,wide:[15,123,127,132,134],wider:103,wih:38,wild:53,wildcard:[6,8,9,10,28,31,35,38,44,53,64],win:140,window:110,winmvs2c:[6,7,8,9,10],with_:30,within:[0,3,15,35,37,38,39,53,55,65,66,68,69,114,116,119,121,122,125,127,129,132,133,134,135,137,139,140],without:[15,19,21,23,24,27,28,30,31,34,37,42,48,53,60,62,63,64,66,68,69,104,105,140],wlm:15,wlmhealth:15,won:0,word:[35,123],work:[3,15,24,31,37,39,40,46,53,60,63,85,104,105,111,114,124,128,140],workaround:53,workflow:[0,79,81,85,87,88,89,103,114,140],workflow_access_typ:[84,101],workflow_account_info:[84,101],workflow_assign_to_own:[84,101],workflow_categori:84,workflow_com:[84,101],workflow_complet:84,workflow_def:[84,101],workflow_delete_completed_job:[84,101],workflow_failed_step:84,workflow_fil:[84,101],workflow_file_system:[84,101],workflow_host:84,workflow_job_stat:[84,101],workflow_kei:84,workflow_nam:[84,101],workflow_notification_url:[84,101],workflow_own:[84,101],workflow_perform_subsequ:[84,101],workflow_resolve_conflict_by_us:[84,101],workflow_resolve_global_conflict_by_us:[84,101],workflow_sample_automation_step:[84,101],workflow_step_nam:[84,101],workflow_var:[84,101],workflow_vars_fil:[84,101],workflow_vendor:84,workflow_wait:84,workload:[15,123],world:[23,30,37,39,123,127,132,134],worri:[24,60],would:[23,24,28,31,34,37,38,42,43,48,53,60,64,70,104,111],wrap:[24,60],wrapper:[24,60],write:[15,31,32,33,41,42,54,64,68,71,96,97,98,99,114],write_onli:42,writeabl:[116,119,122,123,125,127,129,132,134,135,137,139,140],written:[1,5,15,21,31,33,34,41,42,45,48,58,63,64,72,105,112,140],wrkarea:15,wrong:53,wui:15,wwpn:127,www:[6,7,8,9,10,30,96,97,98,99,100],xappc:15,xcf:15,xcfgroup:15,xcmd:15,xdb2:15,xdct:15,xfct:15,xhf:15,xiaopin:9,xjct:15,xlt:15,xmit:[28,48,53],xmit_log_data_set:[28,48],xml:[6,7,8,9,10,84,101],xmltodict:20,xpct:15,xppt:15,xpsb:15,xptkt:15,xre:15,xref:39,xrf:15,xtran:15,xtst:15,xuser:15,xxx:[90,91,92,94,96,97,98,99,100,102,111],xyz:[35,131],yaml:[24,28,31,35,42,48,53,60,74,77,78,105,116,119,122,123,125,127,129,132,134,135,137,139,140],yds7ujxqrd3h8v5wxq9pf1yptztq4jzrozn3xqkf26zicxghc7mdzgycmca:82,year:[35,56],yes:[33,40,77,78,111],yet:[14,42,114,127,140],yield:[16,37,38],yml:[24,60,90,91,92,93,94,95,96,97,98,99,100,102,104,114,140],you:[0,1,2,3,4,5,6,8,9,10,11,12,13,14,15,16,17,18,19,20,22,23,24,26,27,28,30,31,32,33,34,35,39,40,41,42,45,46,48,49,53,55,56,59,60,62,63,64,67,71,73,77,78,80,81,84,85,87,90,91,92,93,94,95,96,97,98,99,100,102,103,104,105,108,110,111,114,115,118],your:[0,6,7,8,9,10,15,16,20,24,30,31,48,49,53,54,60,63,68,71,76,77,78,82,83,84,87,89,101,104,105,108,111,114],your_password:82,your_usernam:82,yqchen:[6,7,8,9,10],yymmdd:15,z114:140,z13:[117,122,124,128],z14:[122,132,133,134,140],z15:[127,140],z16:140,z196:140,z_ansible_collections_sampl:140,z_python_interpret:[24,60],zaa:135,zawar:123,zbc12:140,zec12:140,zero:[9,15,28,31,37,38,39,42,48,53],zeroiz:116,zfs:[32,41],zhmc:[114,127,137,140],zhmc_adapt:[115,117,127,140],zhmc_adapter_list:[115,116,140],zhmc_consol:[115,140],zhmc_cpc:[115,140],zhmc_cpc_list:[115,131],zhmc_crypto_attach:[115,140],zhmc_hba:[115,127],zhmc_inventori:140,zhmc_lpar:[115,140],zhmc_lpar_list:[115,140],zhmc_nic:[115,126,127,140],zhmc_nic_list:[115,140],zhmc_partit:[115,122,125,128,139,140],zhmc_partition_list:[115,127,140],zhmc_password_rul:[115,140],zhmc_password_rule_list:[115,140],zhmc_session:[115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139,140],zhmc_storage_group:[115,127,140],zhmc_storage_group_attach:[115,132,140],zhmc_storage_volum:[115,140],zhmc_test_role_1:137,zhmc_user:[115,140],zhmc_user_list:[115,140],zhmc_user_rol:[115,140],zhmc_user_role_list:[115,140],zhmc_vault:140,zhmc_virtual_funct:[115,127],zhmcclient:[114,116,140,142],zhmcclient_mock:140,ziip:123,zinventori:[24,60],zip:[28,48,53],zmf_authent:[81,83,84,85],zmf_bodi:[90,94],zmf_cpm_create_software_inst:[85,87,89],zmf_cpm_get_software_inst:[85,87,89],zmf_cpm_list_software_templ:[85,87,89],zmf_cpm_manage_software_inst:[85,87,89,90,94],zmf_cpm_provision_software_servic:[85,87,89,93,95],zmf_cpm_remove_software_inst:[85,87,89,90,94],zmf_credenti:[83,84],zmf_crt:[82,83,84,101],zmf_host:[82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102],zmf_kei:[82,83,84,101],zmf_password:[82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102],zmf_port:[82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102],zmf_sca:[81,85,87],zmf_swmgmt_csi_queri:[85,89],zmf_swmgmt_identify_missing_critical_upd:[85,87,89],zmf_swmgmt_identify_missing_fixcat_upd:[85,87,89],zmf_swmgmt_search_software_upd:[85,87,89],zmf_swmgmt_system_uuid:85,zmf_swmgmt_zos_system_uuid:[89,96,97,98,99],zmf_user:[82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102],zmf_workflow:[81,85,87,101],zmf_workflow_complet:[85,87,89],zmf_zmsc_run_management_servic:[85,87,89],zmsc:87,zoa:0,zoau:[16,20,24,27,29,30,31,36,37,38,39,40,41,53,60,62,70,111],zoau_dir:30,zoau_hom:[24,60],zoau_root:[24,60],zoautil:[24,60],zoautil_dir:[24,60],zoautil_pi:[24,60],zone:96,zoneindex:96,zos:[96,97,98,99,100,104,111],zos_apf:[26,53],zos_arch:[26,48,53],zos_backup_restor:[26,49,53],zos_blockinfil:[26,53],zos_copi:[26,28,34,39,46,48,50,53],zos_data_set:[0,26,30,31,34,35,41,42,53],zos_dataset:[24,60],zos_datset:[24,60],zos_encod:[26,53],zos_encode_out:33,zos_fetch:[26,28,31,50,53],zos_find:[26,53],zos_gather_fact:[26,53],zos_job_output:[26,53],zos_job_queri:[0,16,26,53],zos_job_submit:[26,50,53],zos_lineinfil:[26,53],zos_mount:[26,53],zos_mvs_raw:[0,26,53],zos_oper:[16,26,44,53],zos_operator_action_queri:[26,53],zos_p:[26,50,111],zos_raw:42,zos_script:[26,50,53],zos_ssh:111,zos_system_uuid_respons:100,zos_tso_command:[16,26,46,53],zos_unarch:[26,28,50,53],zos_volume_init:[26,53],zosmf:[82,83,84,96,97,98,99,100,101],zosmoninterv:15,zossos24unalloc:15,zossos31unalloc:15,zossos64unalloc:15,zossosnewtcb:15,zpy1:15},titles:["General","z/OS CICS","Contributing","Modules","aux_temp_storage \u2013 Create and remove the CICS auxiliary temporary storage data set","aux_trace \u2013 Allocate auxiliary trace data sets","cmci_action \u2013 Perform actions on CICS and CICSPlex SM resources","cmci_create \u2013 Create CICS and CICSPlex SM definitions","cmci_delete \u2013 Delete CICS and CICSPlex SM resources","cmci_get \u2013 Query CICS and CICSPlex SM resources and definitions","cmci_update \u2013 Update CICS and CICSPlex resources and definitions","csd \u2013 Create, remove, and manage the CICS CSD","global_catalog \u2013 Create, remove, and manage the CICS global catalog","local_catalog \u2013 Create, remove, and manage the CICS local catalog","local_request_queue \u2013 Create and remove the CICS local request queue","region_jcl \u2013 Create CICS startup JCL data set","stop_region \u2013 Stop a CICS region","td_intrapartition \u2013 Create and remove the CICS transient data intrapartition data set","transaction_dump \u2013 Allocate transaction dump data sets","Releases","Requirements of managed nodes","z/OS Core","Contributing","Features","Prerequisites","Filters","Modules","zos_apf \u2013 Add or remove libraries to Authorized Program Facility (APF)","zos_archive \u2013 Archive files and data sets on z/OS.","zos_backup_restore \u2013 Backup and restore data sets and volumes","zos_blockinfile \u2013 Manage block of multi-line textual data on z/OS","zos_copy \u2013 Copy data to z/OS","zos_data_set \u2013 Manage data sets","zos_encode \u2013 Perform encoding operations.","zos_fetch \u2013 Fetch data from z/OS","zos_find \u2013 Find matching data sets","zos_gather_facts \u2013 Gather z/OS system facts.","zos_job_output \u2013 Display job output","zos_job_query \u2013 Query job status","zos_job_submit \u2013 Submit JCL","zos_lineinfile \u2013 Manage textual data on z/OS","zos_mount \u2013 Mount a z/OS file system.","zos_mvs_raw \u2013 Run a z/OS program.","zos_operator \u2013 Execute operator command","zos_operator_action_query \u2013 Display messages requiring action","zos_ping \u2013 Ping z/OS and check dependencies.","zos_script \u2013 Run scripts in z/OS","zos_tso_command \u2013 Execute TSO commands","zos_unarchive \u2013 Unarchive files and data sets in z/OS.","zos_volume_init \u2013 Initialize volumes or minidisks.","Plugins","Contributing","Documentation","Releases","Managed node","Character Sets","Releases and maintenance","Resources","z/OS IMS","Contributing","Prerequisites","Modules","ims_acb_gen \u2013 Generate IMS ACB","ims_catalog_populate \u2013 Add records to the IMS Catalog","ims_catalog_purge \u2013 Purge records from the IMS Catalog","ims_command \u2013 Submit IMS Commands","ims_dbd_gen \u2013 Generate IMS DBD","ims_dbrc \u2013 Submit IMS DBRC Commands","ims_ddl \u2013 Submits Data Definition Language (DDL) SQL statements.","ims_psb_gen \u2013 Generate IMS PSB","Releases","Managed node","IBM Z System Automation","Contributing","Releases","Managed node","Roles","sa_create_dynamic_resource \u2013 Role creates and resumes a dynamic resource","sa_delete_dynamic_resource \u2013 Role deletes a dynamic resource","IBM z/OSMF","Contributing","Modules","zmf_authenticate \u2013 Authenticate with z/OSMF server","zmf_sca \u2013 Automate z/OS security requirements validation and provision","zmf_workflow \u2013 Operate z/OS workflows","Releases","Control node","Managed node","Resources","Roles","zmf_cpm_create_software_instance \u2013 Role creates a z/OS software instance","zmf_cpm_get_software_instance \u2013 Role get specific z/OS software instance","zmf_cpm_list_software_templates \u2013 Role lists all published z/OS software templates","zmf_cpm_manage_software_instance \u2013 Role manages a provisioned z/OS software instance","zmf_cpm_provision_software_service \u2013 Role provisions a z/OS software service","zmf_cpm_remove_software_instance \u2013 Role removes a z/OS software instance","zmf_swmgmt_csi_query \u2013 Query a SMP/E CSI data set","zmf_swmgmt_identify_missing_critical_updates \u2013 Identify Missing Critical Software Updates for a Software Instance","zmf_swmgmt_identify_missing_fixcat_updates \u2013 Identify Missing Fixcat Software Updates for a Software Instance","zmf_swmgmt_search_software_updates \u2013 Search a Software Instance for Software Updates","zmf_swmgmt_zos_system_uuid \u2013 Retrieve the z/OS system UUID","zmf_workflow_complete \u2013 Role completes a z/OS workflow","zmf_zmsc_run_management_service \u2013 Role runs a z/OS management service","Red Hat Ansible Certified Content for IBM Z","Installation","Playbooks","Contributing","Documentation","Helpful Links","Releases","Requirements","Errors and Messages","Z HMC","Resources","Development","Modules","zhmc_adapter \u2013 Update adapters and create Hipersocket adapters","zhmc_adapter_list \u2013 List adapters","zhmc_console \u2013 Get facts about the HMC","zhmc_cpc \u2013 Manage CPCs","zhmc_cpc_list \u2013 List CPCs","zhmc_crypto_attachment \u2013 Attach crypto resources to partitions","zhmc_hba \u2013 Create HBAs in partitions","zhmc_lpar \u2013 Manage LPARs","zhmc_lpar_list \u2013 List LPARs","zhmc_nic \u2013 Create NICs in partitions","zhmc_nic_list \u2013 List NICs","zhmc_partition \u2013 Create partitions","zhmc_partition_list \u2013 List partitions","zhmc_password_rule \u2013 Create HMC password rules","zhmc_password_rule_list \u2013 List Password Rules","zhmc_session \u2013 Manage HMC sessions across tasks","zhmc_storage_group \u2013 Create storage groups","zhmc_storage_group_attachment \u2013 Attach storage groups to partitions","zhmc_storage_volume \u2013 Create storage volumes","zhmc_user \u2013 Create HMC users","zhmc_user_list \u2013 List HMC users","zhmc_user_role \u2013 Create HMC user roles","zhmc_user_role_list \u2013 List HMC user roles","zhmc_virtual_function \u2013 Create virtual functions in partitions","Releases","Managed node","Troubleshooting"],titleterms:{"default":[3,23],"function":[23,24,60,139],"import":23,"new":[0,19,53,74,114],"return":[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,27,28,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,62,63,64,65,66,67,68,69,82,83,84,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],"transient":17,Are:0,IMS:[58,62,63,64,65,66,67,69],Using:3,abl:111,about:118,acb:62,across:131,action:[6,44,50],adapt:[116,117],add:[24,27,60,63],addit:[0,24,60],affect:111,after:0,all:92,alloc:[5,18],also:[12,13,15,28,30,31,34,35,41,42,44,45,46,48,49,101,116,117,126,127,128],ani:[0,111],ansibl:[0,22,59,103,104,111],ansible_librari:[24,60],ansible_zos_modul:[24,60],apf:27,archiv:28,arg_typ:23,argument:[23,24,60],askpass:111,attach:[121,133],authent:[82,111],author:27,autom:[54,72,83,104],aux_temp_storag:4,aux_trac:5,auxiliari:[4,5],avail:[19,53,70,74,85],backup:29,befor:0,behind:0,best:0,beta1:70,beta2:70,beta3:70,beta:[19,70],betterargpars:[22,23],block:30,bugfix:53,build:[104,114],built:23,can:[0,111],catalog:[12,13,63,64],caus:111,certifi:[0,103],chang:53,charact:55,check:[0,45],cic:[0,1,3,4,6,7,8,9,10,11,12,13,14,15,16,17],cicsplex:[6,7,8,9,10],cli:[24,60],cmci:20,cmci_act:6,cmci_creat:7,cmci_delet:8,cmci_get:9,cmci_upd:10,collect:[0,111],command:[43,47,65,67],commun:0,complet:[0,101],concept:105,configur:[0,24,60],content:[0,103],contribut:[0,2,22,51,59,73,80,106],control:[24,60,86,110],copi:31,core:21,cpc:[119,120],creat:[4,7,11,12,13,14,15,17,77,90,116,122,125,127,129,132,134,135,137,139],critic:97,crypto:121,csd:11,csi:96,custom:[0,23],data:[4,5,15,17,18,28,29,30,31,32,34,35,40,48,68,96],dbd:66,dbrc:67,ddl:68,debug:105,defin:[0,23],definit:[7,9,10,68],delet:[8,78],depend:[23,24,45,60,101],deprec:53,detail:[24,60],develop:[0,2,22,24,59,60,114],directori:[24,60],displai:[37,44],document:[0,52,107,114],doe:111,download:0,dump:18,dure:111,dynam:[77,78],encod:33,enterpris:54,environ:[0,114],error:111,exampl:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,23,24,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,60,62,63,64,65,66,67,68,69,77,78,82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],exclus:23,execut:[43,47,111],exist:104,facil:27,fact:[36,118],fail:[0,111],featur:[23,53],fetch:34,file:[0,28,41,48],filter:25,find:[0,35],fix:111,fixcat:98,frequent:0,fresh:104,from:[34,64],galaxi:104,gather:36,gener:[0,62,66,69],get:[91,111,118],global:12,global_catalog:12,group:[3,132,133],guid:53,hat:103,have:[0,111],hba:122,help:108,hipersocket:116,hmc:[112,118,129,131,135,136,137,138],host:111,how:[0,111],hub:104,ibm:[0,54,72,79,103,111],idempot:0,identifi:[97,98],ims_acb_gen:62,ims_catalog_popul:63,ims_catalog_purg:64,ims_command:65,ims_dbd_gen:66,ims_dbrc:67,ims_ddl:68,ims_psb_gen:69,initi:49,instal:[0,24,60,104],instanc:[90,91,93,95,97,98,99],instead:111,intrapartit:17,inventori:105,issu:[0,53],jcl:[15,39],job:[37,38],kei:[24,60],know:0,known:53,languag:68,latest:0,leav:0,librari:27,line:30,link:108,list:[92,117,120,124,126,128,130,136,138],local:[13,14,104],local_catalog:13,local_request_queu:14,login:111,lpar:[123,124],mainten:56,major:53,manag:[11,12,13,20,24,30,32,40,54,60,71,75,87,93,102,110,111,119,123,131,141],match:35,matrix:56,memori:0,messag:[44,111],method:[24,60],minidisk:49,minor:53,miss:[97,98],mock:[24,60],mode:0,modul:[0,3,22,24,26,53,59,60,61,81,111,115],mount:41,much:0,multi:30,mutual:23,need:[0,111],nic:[125,126],node:[20,24,54,60,71,75,86,87,110,141],note:[27,28,30,31,33,34,35,39,40,41,42,45,46,48,62,63,64,65,66,67,68,69,70,74,77,78,84,85,90,91,92,93,94,95,96,97,98,99,100,101,102,132,133,134],object:0,offer:0,open:[0,54],oper:[0,33,43,84],option:23,osmf:[79,82],other:0,output:37,overrid:104,packag:[24,60],paramet:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,46,47,48,49,62,63,64,65,66,67,68,69,77,78,82,83,84,111,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],pars:22,part:0,particular:0,partit:[121,122,125,127,128,133,139],password:[129,130],perform:[6,33],ping:45,playbook:[0,105,111],plugin:50,port:53,practic:0,pre:[104,111],preced:0,prerequisit:[24,60],privat:104,privileg:111,problem:[0,111],program:[27,42],prompt:111,provis:[3,20,83,93,94],psb:69,publish:92,purg:64,pytest:[24,60],python:[0,54,71,111],queri:[9,38,96],queue:14,ram:0,reach:111,record:[63,64],red:103,redhat:0,refer:[3,19,70,85],region:16,region_jcl:15,releas:[0,19,53,56,70,74,85,104,109,114,140],remov:[4,11,12,13,14,17,27,95],repositori:114,request:14,requir:[0,20,23,44,53,83,110,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,132,133,134,135,136,137,138,139],resourc:[6,8,9,10,24,57,60,77,78,88,113,121],restor:29,resum:77,retriev:100,role:[76,77,78,89,90,91,92,93,94,95,101,102,137,138],rule:[0,129,130],run:[0,24,42,46,60,102,105,111],sa_create_dynamic_resourc:77,sa_delete_dynamic_resourc:78,sampl:0,script:46,sdk:54,search:99,secur:83,see:[12,13,15,28,30,31,34,35,41,42,44,45,46,48,49,101,116,117,126,127,128],seek:[0,111],server:[82,104],servic:[94,102],session:131,set:[4,5,15,17,18,28,29,32,35,48,55,96,114],shell:54,should:[0,111],smp:96,softwar:[90,91,92,93,94,95,97,98,99],special:111,specif:[0,91],sql:68,ssh:[24,60,111],start:114,startup:15,statement:68,statu:38,stop:16,stop_region:16,storag:[4,132,133,134],submit:[39,65,67,68],support:[0,56,111],synopsi:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,62,63,64,65,66,67,68,69,77,78,82,83,84,90,91,92,93,94,95,96,97,98,99,100,101,102,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],system:[36,41,72,100,111],target:111,task:[20,131],td_intrapartit:17,templat:92,temporari:4,test:[0,22,24,59,60,111,114],textual:[30,40],them:0,thi:111,tip:[24,60],trace:5,track:0,transact:18,transaction_dump:18,troubleshoot:[111,142],tso:47,type:23,unarch:48,unit:[24,60],unsupport:111,updat:[0,10,97,98,99,116],upgrad:0,usag:[24,60],user:[111,135,136,137,138],using:[0,111],uss:111,util:54,uuid:100,valid:83,valu:[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,27,28,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,62,63,64,65,66,67,68,69,82,83,84,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139],variabl:[90,91,92,93,94,95,96,97,98,99,100,101,102,105],version:[0,19,53,70,74,85,104,114,140],virtual:139,volum:[29,49,134],warn:111,what:[0,19,74,111],when:[0,111],where:0,which:[0,111],why:111,workflow:[84,101],zhmc_adapt:116,zhmc_adapter_list:117,zhmc_consol:118,zhmc_cpc:119,zhmc_cpc_list:120,zhmc_crypto_attach:121,zhmc_hba:122,zhmc_lpar:123,zhmc_lpar_list:124,zhmc_nic:125,zhmc_nic_list:126,zhmc_partit:127,zhmc_partition_list:128,zhmc_password_rul:129,zhmc_password_rule_list:130,zhmc_session:131,zhmc_storage_group:132,zhmc_storage_group_attach:133,zhmc_storage_volum:134,zhmc_user:135,zhmc_user_list:136,zhmc_user_rol:137,zhmc_user_role_list:138,zhmc_virtual_funct:139,zmf_authent:82,zmf_cpm_create_software_inst:90,zmf_cpm_get_software_inst:91,zmf_cpm_list_software_templ:92,zmf_cpm_manage_software_inst:93,zmf_cpm_provision_software_servic:94,zmf_cpm_remove_software_inst:95,zmf_sca:83,zmf_swmgmt_csi_queri:96,zmf_swmgmt_identify_missing_critical_upd:97,zmf_swmgmt_identify_missing_fixcat_upd:98,zmf_swmgmt_search_software_upd:99,zmf_swmgmt_zos_system_uuid:100,zmf_workflow:84,zmf_workflow_complet:101,zmf_zmsc_run_management_servic:102,zoau:[0,71],zos_apf:27,zos_arch:28,zos_backup_restor:29,zos_blockinfil:30,zos_copi:[31,111],zos_data_set:32,zos_encod:33,zos_fetch:[34,111],zos_find:35,zos_gather_fact:36,zos_import_mock:[24,60],zos_job_output:37,zos_job_queri:38,zos_job_submit:39,zos_lineinfil:40,zos_mount:41,zos_mvs_raw:42,zos_oper:43,zos_operator_action_queri:44,zos_p:45,zos_script:46,zos_tso_command:47,zos_unarch:48,zos_volume_init:49}}) \ No newline at end of file