You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: _sources/ibm_zos_ims/docs/source/modules/ims_acb_gen.rst.txt
+19-21
Original file line number
Diff line number
Diff line change
@@ -16,8 +16,8 @@ ims_acb_gen -- Generate IMS ACB
16
16
17
17
Synopsis
18
18
--------
19
-
- The ims_acb_gen module generates an IMS application control block (ACB) necessary for an IMS application program to be scheduled and run.
20
-
- The ims_dbd_gen and ims_psb_gen modules can be used to generate the associated IMS database descriptors (DBDs) and program specification block (PSBs) to be used with the ims_acb_gen module.
19
+
- The ims\_acb\_gen module generates an IMS application control block (ACB) necessary for an IMS application program to be scheduled and run.
20
+
- The ims\_dbd\_gen and ims\_psb\_gen modules can be used to generate the associated IMS database descriptors (DBDs) and program specification block (PSBs) to be used with the ims\_acb\_gen module.
21
21
- The DBD and PSB control blocks will be merged and expanded into an IMS internal format called application control blocks (ACBs).
22
22
23
23
@@ -43,17 +43,15 @@ command_input
43
43
compression
44
44
PRECOMP,POSTCOMP, in any combination, cause the required in-place compression.
45
45
46
-
The choices are not mutually exclusive -- PRECOMP or POSTCOMP or PRECOMP,POSTCOMP can be used
The name of the PS**s**. Specifies that blocks are built or deleted for all PSBs that are named on this control statement.
54
+
The name of the PSB(s). Specifies that blocks are built or deleted for all PSBs that are named on this control statement.
57
55
58
56
This field requires "ALL" or a list of psb names to be specified.
59
57
@@ -73,7 +71,7 @@ dbd_name
73
71
acb_lib
74
72
The ACB Maintenance utility maintains the prebuilt blocks (ACB) library (IMS.ACBLIB). The ACB library is a consolidated library of program (PSB) and database (DBD) descriptions.
75
73
76
-
The IMS acb_lib must be used exclusively. The module can only be executed using an ACB library which is not concurrently allocated to an active IMS system.
74
+
The IMS acb\_lib must be used exclusively. The module can only be executed using an ACB library which is not concurrently allocated to an active IMS system.
77
75
78
76
|**required**: True
79
77
|**type**: str
@@ -82,7 +80,7 @@ acb_lib
82
80
psb_lib
83
81
The ACB Maintenance utility receives input from the IMS PSBLIB data set.
84
82
85
-
The ACB Maintenance utility does not change the PS**s** in PSBLIB. If changes are made in PSBs or DBDs that require changes in the associated PSB, make these changes before running the module.
83
+
The ACB Maintenance utility does not change the PSB(s) in PSBLIB. If changes are made in PSBs or DBDs that require changes in the associated PSB, make these changes before running the module.
86
84
87
85
Changes in PSBs might also require modifications to the affected application programs. For example, if a DBD has a segment name changed, all PSBs which are sensitive to that segment must have their SENSEG statements changed.
88
86
@@ -102,11 +100,11 @@ dbd_lib
102
100
103
101
104
102
steplib
105
-
Points to the IMS SDFSRESL data set, which contains the IMS nucleus and required IMS modules. If STEPLIB is unauthorized by having unauthorized libraries that are concatenated to SDFSRESL, you must specify the *reslib* parameter.
103
+
Points to the IMS SDFSRESL data set, which contains the IMS nucleus and required IMS modules. If STEPLIB is unauthorized by having unauthorized libraries that are concatenated to SDFSRESL, you must specify the \ :emphasis:`reslib`\ parameter.
106
104
107
-
The steplib parameter can also be specified in the target inventory's environment_vars.
105
+
The steplib parameter can also be specified in the target inventory's environment\_vars.
108
106
109
-
The steplib input parameter to the module will take precedence over the value specified in the environment_vars.
107
+
The steplib input parameter to the module will take precedence over the value specified in the environment\_vars.
110
108
111
109
|**required**: False
112
110
|**type**: list
@@ -122,11 +120,11 @@ reslib
122
120
123
121
124
122
build_psb
125
-
Specifies whether ims_acb_gen rebuilds all PSBs that reference a changed DBD in the *dbdname* parameter.
123
+
Specifies whether ims\_acb\_gen rebuilds all PSBs that reference a changed DBD in the \ :emphasis:`dbdname`\ parameter.
126
124
127
-
TRUE indicates that ims_acb_gen rebuilds all PSBs that reference the changed DBD on the *dbdname* parameter.
125
+
TRUE indicates that ims\_acb\_gen rebuilds all PSBs that reference the changed DBD on the \ :emphasis:`dbdname`\ parameter.
128
126
129
-
FALSE indicates that ims_acb_gen does not rebuild PSBs that reference the changed DBD if the changed DBD does not change the physical structure of the database.
127
+
FALSE indicates that ims\_acb\_gen does not rebuild PSBs that reference the changed DBD if the changed DBD does not change the physical structure of the database.
130
128
131
129
|**required**: False
132
130
|**type**: bool
@@ -201,15 +199,15 @@ Notes
201
199
-----
202
200
203
201
.. note::
204
-
The *steplib* parameter can also be specified in the target inventory's environment_vars.
202
+
The \ :emphasis:`steplib`\ parameter can also be specified in the target inventory's environment\_vars.
205
203
206
-
The *steplib* input parameter to the module will take precedence over the value specified in the environment_vars.
204
+
The \ :emphasis:`steplib`\ input parameter to the module will take precedence over the value specified in the environment\_vars.
207
205
208
-
If only the *steplib* parameter is specified, then only the *steplib* concatenation will be used to resolve the IMS RESLIB dataset.
206
+
If only the \ :emphasis:`steplib`\ parameter is specified, then only the \ :emphasis:`steplib`\ concatenation will be used to resolve the IMS RESLIB dataset.
209
207
210
-
If both *steplib* and *reslib* are specified, then both parameters will be used by the ACB Maintenenace Utility and *reslib* will be used to resolve the IMS RESLIB dataset.
208
+
If both \ :emphasis:`steplib`\ and \ :emphasis:`reslib`\ are specified, then both parameters will be used by the ACB Maintenenace Utility and \ :emphasis:`reslib`\ will be used to resolve the IMS RESLIB dataset.
211
209
212
-
Specifying only *reslib* without *steplib* is not supported.
210
+
Specifying only \ :emphasis:`reslib`\ without \ :emphasis:`steplib`\ is not supported.
213
211
214
212
The ACB Maintenenace utility SYSUT3/SYSUT4 DD options are not supported by this module.
215
213
@@ -224,7 +222,7 @@ Return Values
224
222
225
223
226
224
msg
227
-
Execution result message from the ims_acb_gen module.
225
+
Execution result message from the ims\_acb\_gen module.
228
226
229
227
|**returned**: always
230
228
|**type**: str
@@ -254,7 +252,7 @@ changed
254
252
debug
255
253
additional messages returned from ZOAU.
256
254
257
-
For more information, refer to the `ZOAU messages documentation <https://www.ibm.com/support/knowledgecenter/en/SSKFYE_1.0.0/bgy.html>`_
255
+
For more information, refer to the \ `ZOAU messages documentation <https://www.ibm.com/support/knowledgecenter/en/SSKFYE_1.0.0/bgy.html>`__\
Copy file name to clipboardexpand all lines: _sources/ibm_zos_ims/docs/source/modules/ims_ddl.rst.txt
+10-10
Original file line number
Diff line number
Diff line change
@@ -66,9 +66,9 @@ proclib
66
66
steplib
67
67
Points to IMS.SDFSRESL, which contains the IMS nucleus and required IMS modules.
68
68
69
-
The steplib parameter can also be specified in the target inventory's environment_vars.
69
+
The steplib parameter can also be specified in the target inventory's environment\_vars.
70
70
71
-
The steplib input parameter to the module will take precedence over the value specified in the environment_vars.
71
+
The steplib input parameter to the module will take precedence over the value specified in the environment\_vars.
72
72
73
73
|**required**: False
74
74
|**type**: list
@@ -133,7 +133,7 @@ Examples
133
133
134
134
135
135
- name: Example of DDL statements are in a dataset
136
-
ims_data_definition:
136
+
ims_ddl:
137
137
online: True
138
138
ims_id: IMS1
139
139
reslib:
@@ -144,7 +144,7 @@ Examples
144
144
- SOME.IMS.PROCLIB
145
145
sql_input: SOME.IMS.SQL
146
146
- name: Example of DDL statements in which VERBOSE and AUTOCOMMIT control options are specified
147
-
ims_data_definition:
147
+
ims_ddl:
148
148
online: True
149
149
ims_id: IMS1
150
150
reslib:
@@ -158,7 +158,7 @@ Examples
158
158
auto_commit: true
159
159
160
160
- name: Example of DDL statements in which SIMULATE control options is specified
161
-
ims_data_definition:
161
+
ims_ddl:
162
162
online: True
163
163
ims_id: IMS1
164
164
reslib:
@@ -171,7 +171,7 @@ Examples
171
171
simulate: true
172
172
173
173
- name: Example of DDL statements in which DYNAMIC_PROGRAMVIEW control option is specified
174
-
ims_data_definition:
174
+
ims_ddl:
175
175
online: True
176
176
ims_id: IMS1
177
177
reslib:
@@ -191,13 +191,13 @@ Notes
191
191
-----
192
192
193
193
.. note::
194
-
The *steplib* parameter can also be specified in the target inventory's environment_vars.
194
+
The \ :emphasis:`steplib`\ parameter can also be specified in the target inventory's environment\_vars.
195
195
196
-
The *steplib* input parameter to the module will take precedence over the value specified in the environment_vars.
196
+
The \ :emphasis:`steplib`\ input parameter to the module will take precedence over the value specified in the environment\_vars.
197
197
198
-
If only the *steplib* parameter is specified, then only the *steplib* concatenation will be used to resolve the IMS RESLIB data set.
198
+
If only the \ :emphasis:`steplib`\ parameter is specified, then only the \ :emphasis:`steplib`\ concatenation will be used to resolve the IMS RESLIB data set.
199
199
200
-
Specifying only *reslib* without *steplib* is not supported.
200
+
Specifying only \ :emphasis:`reslib`\ without \ :emphasis:`steplib`\ is not supported.
201
201
202
202
Currently ddl error messages are returned within the content block of the module response.
Copy file name to clipboardexpand all lines: _sources/ibm_zos_ims/docs/source/release_notes.rst.txt
+53-1
Original file line number
Diff line number
Diff line change
@@ -6,6 +6,56 @@
6
6
Releases
7
7
========
8
8
9
+
10
+
Version 1.3.0
11
+
====================
12
+
13
+
Notes
14
+
-----
15
+
16
+
* Update recommended
17
+
18
+
* type() was replaced by isinstance() in the code for gen utilities since ansible-core 2.16 supports Python 3.12 and that version deprecated type() function.
19
+
* No other changes from version 1.3.0-beta.1 release. Collection promoted to certified content with version 1.3.0.
20
+
21
+
Availability
22
+
------------
23
+
24
+
* `Automation Hub`_
25
+
* `Galaxy`_
26
+
* `GitHub`_
27
+
28
+
29
+
30
+
Known Issues
31
+
------------
32
+
33
+
- ``ims_command`` - STEPLIB is required and needs to be defined as an environment variable.
34
+
- ``ims_command`` - Currently, this module requires to have plex parameter defined.
35
+
36
+
37
+
38
+
Reference
39
+
---------
40
+
41
+
* Supported by IBM z/OS core collection v1.5.0 or later
42
+
* Supported by IBM Z Open Enterprise Python for z/OS 3.9 - 3.12
43
+
* Supported by IBM Z Open Automation Utilities 1.2.2 or later (but prior to 1.3)
44
+
45
+
* ZOAU minimum supported version may vary depending on the z/OS core collection version that is chosen. For details on z/OS core collection requirements, see: https://github.com/ansible-collections/ibm_zos_core/releases
46
+
* Supported by z/OS V2R4 (or later) but prior to version V3R1
* Supported by IBM z/OS core collection v1.5.0 or later
44
94
* Supported by IBM Z Open Enterprise Python for z/OS: 3.9 or later
45
95
* Supported by IBM Z Open Automation Utilities 1.2.2 or later (but prior to 1.3)
46
-
* Supported by z/OS V2R4
96
+
97
+
* ZOAU minimum supported version may vary depending on the z/OS core collection version that is chosen. For details on z/OS core collection requirements, see: https://github.com/ansible-collections/ibm_zos_core/releases
98
+
* Supported by z/OS V2R4 (or later) but prior to version V3R1
<dt>psb_lib</dt><dd><p>The ACB Maintenance utility receives input from the IMS PSBLIB data set.</p>
266
-
<p>The ACB Maintenance utility does not change the PS**s** in PSBLIB. If changes are made in PSBs or DBDs that require changes in the associated PSB, make these changes before running the module.</p>
265
+
<p>The ACB Maintenance utility does not change the PSB(s) in PSBLIB. If changes are made in PSBs or DBDs that require changes in the associated PSB, make these changes before running the module.</p>
267
266
<p>Changes in PSBs might also require modifications to the affected application programs. For example, if a DBD has a segment name changed, all PSBs which are sensitive to that segment must have their SENSEG statements changed.</p>
<h2><aclass="toc-backref" href="#id3">Examples</a><aclass="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
303
303
<divclass="highlight-yaml+jinja notranslate"><divclass="highlight"><pre><span></span><spanclass="p p-Indicator">-</span><spanclass="nt">name</span><spanclass="p">:</span><spanclass="l l-Scalar l-Scalar-Plain">Example of DDL statements are in a dataset</span>
<spanclass="p p-Indicator">-</span><spanclass="nt">name</span><spanclass="p">:</span><spanclass="l l-Scalar l-Scalar-Plain">Example of DDL statements in which VERBOSE and AUTOCOMMIT control options are specified</span>
<spanclass="p p-Indicator">-</span><spanclass="nt">name</span><spanclass="p">:</span><spanclass="l l-Scalar l-Scalar-Plain">Example of DDL statements in which SIMULATE control options is specified</span>
<spanclass="p p-Indicator">-</span><spanclass="nt">name</span><spanclass="p">:</span><spanclass="l l-Scalar l-Scalar-Plain">Example of DDL statements in which DYNAMIC_PROGRAMVIEW control option is specified</span>
0 commit comments