Skip to content

Commit

Permalink
Deployed c9dee88 with MkDocs version: 1.6.1
Browse files Browse the repository at this point in the history
  • Loading branch information
Unknown committed Jan 28, 2025
1 parent 8140479 commit bd7e83a
Show file tree
Hide file tree
Showing 6 changed files with 20 additions and 173 deletions.
13 changes: 0 additions & 13 deletions downloads/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -404,19 +404,6 @@

<h1 id="downloads">Downloads</h1>
<hr />
<ul>
<li><a href="https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1168947.zip">ucd-plugins-zos-rexx-2.1168947.zip</a></li>
<li><a href="https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1168604.zip">ucd-plugins-zos-rexx-2.1168604.zip</a></li>
<li><a href="https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1164401.zip">ucd-plugins-zos-rexx-2.1164401.zip</a></li>
<li><a href="https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1164307.zip">ucd-plugins-zos-rexx-2.1164307.zip</a></li>
<li><a href="https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1161998.zip">ucd-plugins-zos-rexx-2.1161998.zip</a></li>
<li><a href="https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1161121.zip">ucd-plugins-zos-rexx-2.1161121.zip</a></li>
<li><a href="https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1161042.zip">ucd-plugins-zos-rexx-2.1161042.zip</a></li>
<li><a href="https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1159387.zip">ucd-plugins-zos-rexx-2.1159387.zip</a></li>
<li><a href="https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1158244.zip">ucd-plugins-zos-rexx-2.1158244.zip</a></li>
<li><a href="https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-2.1154680.zip">ucd-plugins-zos-rexx-2.1154680.zip</a></li>
<li><a href="https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-rexx/ucd-plugins-zos-rexx-1.1152822.zip">ucd-plugins-zos-rexx-1.1152822.zip</a></li>
</ul>



Expand Down
38 changes: 6 additions & 32 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -385,18 +385,9 @@
<ul class="md-nav__list">

<li class="md-nav__item">
<a href="#version-2" class="md-nav__link">
<a href="#version-01" class="md-nav__link">
<span class="md-ellipsis">
Version 2
</span>
</a>

</li>

<li class="md-nav__item">
<a href="#version-1" class="md-nav__link">
<span class="md-ellipsis">
Version 1
Version 0.1
</span>
</a>

Expand Down Expand Up @@ -492,40 +483,23 @@

<h1 id="overview">Overview</h1>
<hr />
<p>The zOS Rexx Executor can run REXX statements provided in a dataset or in the plugin step.</p>
<p>Apart from executing a REXX program, this plug-in provides ability to create output properties.</p>
<p>The Terraform Plugin can be used to create AWS cloud infrastructures like EC2 instances.</p>
<h2 id="compatibility">Compatibility</h2>
<p>The plug-in is compatible with:</p>
<ul>
<li>UrbanCode Deploy version 7.0.0 or later</li>
<li>UrbanCode Deploy agents on z/OS</li>
<li>IBM z/OS version 2.1 or later</li>
<li>IBM Java 8 or 11</li>
</ul>
<h2 id="available-steps">Available Steps</h2>
<ul>
<li>Execute a REXX program</li>
<li>Run Terraform Command (AWS).</li>
</ul>
<h2 id="installation">Installation</h2>
<p>No special steps are required for installation. See <a href="https://community.ibm.com/community/user/wasdevops/blogs/laurel-dickson-bull1/2022/06/13/install-plugins">Installing plug-ins in UrbanCode products</a>.</p>
<h2 id="history">History</h2>
<h3 id="version-2">Version 2</h3>
<ul>
<li>Added new checkbox input to show debug logs in case of any unknown failure.</li>
<li>Output will now show the elapsed time of the REXX program</li>
<li>New output property RexxReturnCode will store the return code of the REXX program</li>
<li>Fixes output buffer issue when output has too much data</li>
<li>Arguments can now be as big as 248 characters</li>
<li>Fixed issue with work directory during two or more parallel step execution</li>
<li>Minor improvements in temporary directory creation</li>
<li>Fixed handling of CLIST error message response from ISPF Gateway</li>
<li>Changes to run process in Legacy ISPF Gateway</li>
<li>Improvements in ISPF gateway error handling</li>
<li>Fixed PH62152 - RcException while allocating temporary datasets</li>
</ul>
<h3 id="version-1">Version 1</h3>
<h3 id="version-01">Version 0.1</h3>
<ul>
<li>Initial release</li>
<li>Initial release of the new Tearraform Plugin</li>
</ul>


Expand Down
2 changes: 1 addition & 1 deletion search/search_index.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Overview","text":"<p>The zOS Rexx Executor can run REXX statements provided in a dataset or in the plugin step.</p> <p>Apart from executing a REXX program, this plug-in provides ability to create output properties.</p>"},{"location":"#compatibility","title":"Compatibility","text":"<p>The plug-in is compatible with:</p> <ul> <li>UrbanCode Deploy version 7.0.0 or later</li> <li>UrbanCode Deploy agents on z/OS</li> <li>IBM z/OS version 2.1 or later</li> <li>IBM Java 8 or 11</li> </ul>"},{"location":"#available-steps","title":"Available Steps","text":"<ul> <li>Execute a REXX program</li> </ul>"},{"location":"#installation","title":"Installation","text":"<p>No special steps are required for installation. See Installing plug-ins in UrbanCode products.</p>"},{"location":"#history","title":"History","text":""},{"location":"#version-2","title":"Version 2","text":"<ul> <li>Added new checkbox input to show debug logs in case of any unknown failure.</li> <li>Output will now show the elapsed time of the REXX program</li> <li>New output property RexxReturnCode will store the return code of the REXX program</li> <li>Fixes output buffer issue when output has too much data</li> <li>Arguments can now be as big as 248 characters</li> <li>Fixed issue with work directory during two or more parallel step execution</li> <li>Minor improvements in temporary directory creation</li> <li>Fixed handling of CLIST error message response from ISPF Gateway</li> <li>Changes to run process in Legacy ISPF Gateway</li> <li>Improvements in ISPF gateway error handling</li> <li>Fixed PH62152 - RcException while allocating temporary datasets</li> </ul>"},{"location":"#version-1","title":"Version 1","text":"<ul> <li>Initial release</li> </ul>"},{"location":"downloads/","title":"Downloads","text":"<ul> <li>ucd-plugins-zos-rexx-2.1168947.zip</li> <li>ucd-plugins-zos-rexx-2.1168604.zip</li> <li>ucd-plugins-zos-rexx-2.1164401.zip</li> <li>ucd-plugins-zos-rexx-2.1164307.zip</li> <li>ucd-plugins-zos-rexx-2.1161998.zip</li> <li>ucd-plugins-zos-rexx-2.1161121.zip</li> <li>ucd-plugins-zos-rexx-2.1161042.zip</li> <li>ucd-plugins-zos-rexx-2.1159387.zip</li> <li>ucd-plugins-zos-rexx-2.1158244.zip</li> <li>ucd-plugins-zos-rexx-2.1154680.zip</li> <li>ucd-plugins-zos-rexx-1.1152822.zip</li> </ul>"},{"location":"steps/","title":"Steps","text":""},{"location":"steps/#process-steps-in-the-zos-rexx-executor-plug-in","title":"Process steps in the z/OS Rexx Executor plug-in","text":""},{"location":"steps/#execute-a-rexx-program","title":"Execute a REXX program","text":"<p>Use this step to execute rexx program</p> Name Type Description Required Source Type Enumeration: INLINE / DATASET Source of REXX program Yes Source Value String Text or PDS member or Sequential Dataset that has REXX program. If the single quotation marks are omitted, the user's data set prefix from the TSO profile is prefixed to the front of the data set name. Yes Arguments String Specify the arguments(without quotes) to the REXX program No SYSPROC Datasets String Specify fully qualified SYSPROC datasets that the INPUT REXX program may use No"},{"location":"usage/","title":"Usage","text":"<p>The z/OS Rexx Executor plug-in will execute statements provided in a dataset or inline in the plugin step.</p> <p>Select Source type as DATASET from the drop-down and enter the dataset in the Source Value. Fully qualified dataset needs to be enclosed in single quotes. When the quotes are omitted then, the TSO prefix of the id running the plugin step is prefixed to the Source Dataset.</p> <p>(or)</p> <p>Select Source type as INLINE from the drop-down and then in the Source Value enter REXX statements beginning with a /* REXX */ statement.</p> <p>Arguments can be passed to the REXX program with/without quotes. However, if there are more than one argument then arguments must be separated by a space.</p> <p>The SYSPROC field allows user to pass datasets containing REXX programs that will be used by the REXX program run by the plugin step. Multiple SYSPROC datasets can be passed by separating datasets by a comma(,).</p>"},{"location":"usage/#setting-output-property","title":"Setting output property","text":"<p>This plugin allows user to set output properties from the REXX program and later to be used in successive steps of a process. A user REXX program can simply invoke a call to SETPROP with two arguments.</p> <p>The first argument is output property name and the second argument is the property value.</p> <p>CALL SETPROP propertyName propertyValue</p> <p>For example, below REXX snippet will set an output property currentDate with value of date variable</p> <pre><code>/* REXX */\ndate = DATE('S') /* Returns date in YYYYMMDD format E.g., 20120327 */\nCALL SETPROP \"currentDate\" date\n</code></pre>"},{"location":"usage/#setting-multi-line-output-property","title":"Setting multi-line output property","text":"<p>To set a multi-line output property, the lines of the property value must be separated by a delimiter returned by inbuilt program GETDLMTR </p> <pre><code>/* REXX */\ndelimiter = GETDLMTR() /* Return delimiter to separate lines */\nlines = \"This is first line\" || delimiter || \"This is second line\" \nCALL SETPROP \"outputLines\" lines\n</code></pre> <p>Will set property outputLines to below value</p> <pre><code>This is first line\nThis is second line\n</code></pre>"},{"location":"usage/#referring-properties-from-successive-steps","title":"Referring properties from successive steps","text":"<p>If the rexx step name is Run-Rexx-Program and output property name is currentDate then the output properties can be referred by the successive steps as below</p> <p>${p:Run-Rexx-Program/currentDate}</p> <p>Note</p> <p>From plugin version 2, an output property RexxReturnCode will store the return/exit code from REXX program.</p>"}]}
{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Overview","text":"<p>The Terraform Plugin can be used to create AWS cloud infrastructures like EC2 instances.</p>"},{"location":"#compatibility","title":"Compatibility","text":"<p>The plug-in is compatible with:</p> <ul> <li>UrbanCode Deploy version 7.0.0 or later</li> <li>IBM Java 8 or 11</li> </ul>"},{"location":"#available-steps","title":"Available Steps","text":"<ul> <li>Run Terraform Command (AWS).</li> </ul>"},{"location":"#installation","title":"Installation","text":"<p>No special steps are required for installation. See Installing plug-ins in UrbanCode products.</p>"},{"location":"#history","title":"History","text":""},{"location":"#version-01","title":"Version 0.1","text":"<ul> <li>Initial release of the new Tearraform Plugin</li> </ul>"},{"location":"downloads/","title":"Downloads","text":""},{"location":"steps/","title":"Steps","text":""},{"location":"steps/#process-steps-in-the-terraform-iaac-plug-in","title":"Process steps in the Terraform-IAAC plug-in","text":""},{"location":"steps/#run-terraform-command-aws","title":"Run Terraform Command (AWS)","text":"<p>Use this step to execute rexx program</p> Name Type Description Required Terraform File Path String Full path of the .tf file that contains all configurations needed for a resource creation for any cloud service provider. Yes Source Value String Full path of the terraform installation. Ex: /usr/local/bin/. Yes AWS Role String AWS Role to assume No"},{"location":"usage/","title":"Usage","text":""}]}
Binary file modified sitemap.xml.gz
Binary file not shown.
32 changes: 13 additions & 19 deletions steps/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -390,19 +390,19 @@
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>

<li class="md-nav__item">
<a href="#process-steps-in-the-zos-rexx-executor-plug-in" class="md-nav__link">
<a href="#process-steps-in-the-terraform-iaac-plug-in" class="md-nav__link">
<span class="md-ellipsis">
Process steps in the z/OS Rexx Executor plug-in
Process steps in the Terraform-IAAC plug-in
</span>
</a>

<nav class="md-nav" aria-label="Process steps in the z/OS Rexx Executor plug-in">
<nav class="md-nav" aria-label="Process steps in the Terraform-IAAC plug-in">
<ul class="md-nav__list">

<li class="md-nav__item">
<a href="#execute-a-rexx-program" class="md-nav__link">
<a href="#run-terraform-command-aws" class="md-nav__link">
<span class="md-ellipsis">
Execute a REXX program
Run Terraform Command (AWS)
</span>
</a>

Expand Down Expand Up @@ -458,8 +458,8 @@

<h1 id="steps">Steps</h1>
<hr />
<h2 id="process-steps-in-the-zos-rexx-executor-plug-in">Process steps in the z/OS Rexx Executor plug-in</h2>
<h3 id="execute-a-rexx-program">Execute a REXX program</h3>
<h2 id="process-steps-in-the-terraform-iaac-plug-in">Process steps in the Terraform-IAAC plug-in</h2>
<h3 id="run-terraform-command-aws">Run Terraform Command (AWS)</h3>
<p>Use this step to execute rexx program</p>
<table>
<thead>
Expand All @@ -472,27 +472,21 @@ <h3 id="execute-a-rexx-program">Execute a REXX program</h3>
</thead>
<tbody>
<tr>
<td>Source Type</td>
<td>Enumeration: INLINE / DATASET</td>
<td>Source of REXX program</td>
<td>Terraform File Path</td>
<td>String</td>
<td>Full path of the .tf file that contains all configurations needed for a resource creation for any cloud service provider.</td>
<td>Yes</td>
</tr>
<tr>
<td>Source Value</td>
<td>String</td>
<td>Text or PDS member or Sequential Dataset that has REXX program. If the single quotation marks are omitted, the user's data set prefix from the TSO profile is prefixed to the front of the data set name.</td>
<td>Full path of the terraform installation. Ex: /usr/local/bin/.</td>
<td>Yes</td>
</tr>
<tr>
<td>Arguments</td>
<td>String</td>
<td>Specify the arguments(without quotes) to the REXX program</td>
<td>No</td>
</tr>
<tr>
<td>SYSPROC Datasets</td>
<td>AWS Role</td>
<td>String</td>
<td>Specify fully qualified SYSPROC datasets that the INPUT REXX program may use</td>
<td>AWS Role to assume</td>
<td>No</td>
</tr>
</tbody>
Expand Down
108 changes: 0 additions & 108 deletions usage/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -371,17 +371,6 @@



<label class="md-nav__link md-nav__link--active" for="__toc">


<span class="md-ellipsis">
Usage
</span>


<span class="md-nav__icon md-icon"></span>
</label>

<a href="./" class="md-nav__link md-nav__link--active">


Expand All @@ -392,52 +381,6 @@

</a>



<nav class="md-nav md-nav--secondary" aria-label="Table of contents">






<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>

<li class="md-nav__item">
<a href="#setting-output-property" class="md-nav__link">
<span class="md-ellipsis">
Setting output property
</span>
</a>

</li>

<li class="md-nav__item">
<a href="#setting-multi-line-output-property" class="md-nav__link">
<span class="md-ellipsis">
Setting multi-line output property
</span>
</a>

</li>

<li class="md-nav__item">
<a href="#referring-properties-from-successive-steps" class="md-nav__link">
<span class="md-ellipsis">
Referring properties from successive steps
</span>
</a>

</li>

</ul>

</nav>

</li>


Expand All @@ -459,57 +402,6 @@

<h1 id="usage">Usage</h1>
<hr />
<p>The z/OS Rexx Executor plug-in will execute statements provided in a dataset or inline in the plugin step.</p>
<p>Select <strong>Source type</strong> as <strong>DATASET</strong> from the drop-down and
enter the dataset in the <strong>Source Value</strong>.
Fully qualified dataset needs to be enclosed in single quotes.
When the quotes are omitted then, the TSO prefix of the id running the
plugin step is prefixed to the Source Dataset.</p>
<p>(or)</p>
<p>Select <strong>Source type</strong> as <strong>INLINE</strong> from the drop-down and
then in the <strong>Source Value</strong> enter REXX statements beginning with a <strong>/* REXX */</strong> statement.</p>
<p>Arguments can be passed to the REXX program with/without quotes.
However, if there are more than one argument then arguments must be separated by a space.</p>
<p>The <strong>SYSPROC</strong> field allows user to pass datasets containing REXX programs
that will be used by the REXX program run by the plugin step.
Multiple <strong>SYSPROC</strong> datasets can be passed by separating datasets by a comma(,).</p>
<h3 id="setting-output-property">Setting output property</h3>
<p>This plugin allows user to set output properties from the REXX program and
later to be used in successive steps of a process.
A user REXX program can simply invoke a call to <strong>SETPROP</strong> with two arguments.</p>
<p>The first argument is output property name and
the second argument is the property value.</p>
<blockquote>
<p>CALL SETPROP propertyName propertyValue</p>
</blockquote>
<p>For example, below REXX snippet will set an output property <strong>currentDate</strong> with value of <strong>date</strong> variable</p>
<hr />
<pre><code>/* REXX */
date = DATE('S') /* Returns date in YYYYMMDD format E.g., 20120327 */
CALL SETPROP "currentDate" date
</code></pre>
<h3 id="setting-multi-line-output-property">Setting multi-line output property</h3>
<p>To set a multi-line output property, the lines of the property value must be separated
by a delimiter returned by inbuilt program <strong>GETDLMTR</strong> </p>
<hr />
<pre><code>/* REXX */
delimiter = GETDLMTR() /* Return delimiter to separate lines */
lines = "This is first line" || delimiter || "This is second line"
CALL SETPROP "outputLines" lines
</code></pre>
<p>Will set property <strong>outputLines</strong> to below value</p>
<hr />
<pre><code>This is first line
This is second line
</code></pre>
<h3 id="referring-properties-from-successive-steps">Referring properties from successive steps</h3>
<p>If the rexx step name is <strong>Run-Rexx-Program</strong> and output property name is <strong>currentDate</strong>
then the output properties can be referred by the successive steps as below</p>
<blockquote>
<p>${p:Run-Rexx-Program/currentDate}</p>
</blockquote>
<p><strong>Note</strong></p>
<p>From plugin version 2, an output property <strong>RexxReturnCode</strong> will store the return/exit code from REXX program.</p>



Expand Down

0 comments on commit bd7e83a

Please sign in to comment.