-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1 from UrbanCode/test-ucd
Added z/OS plugins for POC
- Loading branch information
Showing
90 changed files
with
1,385 additions
and
47 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| # Home | ||
|
|
||
| * [z/OS Dataset Writer](zos-dataset-writer) | ||
| * [z/OS External Artifact Repository](zos-external-artifact-download) | ||
| * [z/OS FTP Utility](zos-ftp) | ||
| * [z/OS File Source Config](zos-file-source-config) | ||
| * [z/OS Management Facility](zosmf) | ||
| * [z/OS Multi Generate Artifact Information](zos-multi-generate-artifact-info) | ||
| * [z/OS USS Utility](zos-uss-utility) | ||
| * [z/OS Utility](zos-utility) | ||
| * [z/OS Rexx Executor](zos-rexx) |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| # Downloads | ||
|
|
||
| To download the plug-in, click the following version-specific links. | ||
|
|
||
| - [ucd-plugins-zos-dataset-writer-4.1162523.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-dataset-writer/ucd-plugins-zos-dataset-writer-4.1162523.zip) | ||
| - [ucd-plugins-zos-dataset-writer-4.1138411.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-dataset-writer/ucd-plugins-zos-dataset-writer-4.1138411.zip) | ||
| - [ucd-plugins-zos-dataset-writer-4.1134355.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-dataset-writer/ucd-plugins-zos-dataset-writer-4.1134355.zip) | ||
| - [ucd-plugins-zos-dataset-writer-4.1134053.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-dataset-writer/ucd-plugins-zos-dataset-writer-4.1134053.zip) | ||
| - [ucd-plugins-zos-dataset-writer-3.1133866.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-dataset-writer/ucd-plugins-zos-dataset-writer-3.1133866.zip) | ||
| - [ucd-plugins-zos-dataset-writer-2.1132365.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-dataset-writer/ucd-plugins-zos-dataset-writer-2.1132365.zip) | ||
| - [ucd-plugins-zos-dataset-writer-1.1125890.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zos-dataset-writer/ucd-plugins-zos-dataset-writer-1.1125890.zip) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,48 @@ | ||
| # Overview | ||
|
|
||
| The z/OS Dataset Writer plug-in copies text, dataset, or USS file to a mainframe dataset. | ||
|
|
||
| Apart from copying content to a mainframe dataset, this plug-in provides the following features: | ||
|
|
||
| * Allocates a new output dataset with the required parameter. | ||
| * Deletes the existing output dataset to create a new one with desired parameters. | ||
|
|
||
| ## Compatibility | ||
|
|
||
| The plug-in is compatible with: | ||
|
|
||
| * UrbanCode Deploy version 7.0.0 or later | ||
| * UrbanCode Deploy agents on z/OS | ||
| * IBM z/OS version 2.1 or later | ||
| * IBM Java 8 or 11 | ||
|
|
||
| ## Installation | ||
|
|
||
| No special steps are required for installation. See [Installing plug-ins in UrbanCode products](https://community.ibm.com/community/user/wasdevops/blogs/laurel-dickson-bull1/2022/06/13/install-plugins). | ||
|
|
||
| ## History | ||
|
|
||
| ### Version 4 | ||
|
|
||
| * Enhancement to accept multiple datasets or files as input | ||
| * Minor Improvements | ||
| * Fixed security issue CVE-2021-29425 | ||
| * Fixed Jettison Vulnerability | ||
|
|
||
| ### Version 3 | ||
|
|
||
| !!! Note | ||
| while upgrading plugin from older versions to version 3 | ||
| Sequential output dataset must be enclosed in single quotes for a fully qualified dataset. | ||
| If the single quotation marks are omitted, the user’s dataset prefix from the TSO profile is | ||
| automatically appended to the front of the dataset name. | ||
|
|
||
| * Enhancement to accept source as PDS member or sequential dataset or USS File | ||
|
|
||
| ### Version 2 | ||
|
|
||
| * Fixed issue with GDG version creation | ||
|
|
||
| ### Version 1 | ||
|
|
||
| * Initial release |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,26 @@ | ||
| # Steps | ||
|
|
||
| ## Write to Sequential Dataset | ||
|
|
||
| Use this step to write input text to a sequential dataset. | ||
|
|
||
| !!! Note | ||
| To create a GDG version add (+1) along with GDG base. | ||
| An output property `DatasetName` will contain the actual GDG version dataset name that is created and can be referred in successive steps of the process. | ||
|
|
||
| | Name | Type | Description | Required | | ||
| |--------------------------|-----------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------| | ||
| | Source Type | Enumeration: TEXT / DATASET / FILE / ${p?:dataset.writer.source.type} | Source of data for writing into Output sequential dataset. Select DATASET to write from a PDS member or sequential dataset, FILE to write from a USS file, or TEXT to write text to output sequential dataset. | Yes | | ||
| | Source Value | String | Text or PDS member or Sequential Dataset or USS File to be written into a Sequential dataset. If the single quotation marks are omitted, the user’s data set prefix from the TSO profile is automatically appended to the front of the data set name. Add encoding of USS File after a comma(,). For example – /path/to/file,UTF-8. If no file encoding is specified, file is considered to be in IBM-1047 encoding. Multiple files or datasets can be passed separated by a newline. | Yes | | ||
| | Dataset Name | String | Name of a sequential dataset to write input text. | Yes | | ||
| | Append | Boolean | Select to append input text in the data set. | No | | ||
| | Allocate Data Set | String | Specify `TRUE` to allocate a sequential data set with passed parameters. | No | | ||
| | Delete Existing Data Set | String | Specify `TRUE` to delete the sequential data set if already exist before allocation. | No | | ||
| | Volume Serial | String | Leave blank to use the system default volume. | No | | ||
| | Space Units | Enumeration: TRACKS / CYLINDERS | Specify the dataset space units. For example, Tracks or Cylinders | Yes | | ||
| | Average Record Unit | Enumeration: – – – / K / M / U | Select a unit to use when allocating average record length. The unit **U** specifies single-record units (bytes). **K** specifies thousand-record units (kilobytes). **M** specifies million-record units (megabytes). (- – -) specifies the system default value. | No | | ||
| | Primary Quantity | String | Specify the primary quantity in average record units. | Yes | | ||
| | Secondary Quantity | String | Specify the secondary quantity in average record units. | Yes | | ||
| | Record Format | Enumeration: FB / F / VB / V / FBA / VBA / FBM / FM / VBM / VM | Specify the record format. | Yes | | ||
| | Record Length | String | Specify the record length. | Yes | | ||
| | Block Size | String | Specify the number of bytes of data to place in each block, based on the record length. | Yes | |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,38 @@ | ||
| # Usage | ||
|
|
||
| ## Copy text to a dataset | ||
|
|
||
| Select Source Type as TEXT from the drop-down and a JCL SYSIN content can be passed as text input in Source value. Refer to the below screenshot: | ||
|
|
||
| [](media/picture1.png) | ||
|
|
||
| Third input Dataset Name can either be a Sequential dataset name as below MY.SEQ.DATASET or could be a user-defined property say ```${p:sequential.dataset.name}```. The `sequential.dataset.name` property needs to be defined with a sequential dataset name for writing the input text. | ||
|
|
||
| [](media/zos-dataset-writer-plugin.png) | ||
|
|
||
| Select checkbox **Append** to append input text data after the existing data in a given dataset. By default, **Append** is unchecked and writes the input text newly in a given dataset. | ||
|
|
||
| The **Allocate Data Set** and **Delete Existing Data Set** values are set to `TRUE` by default. As the name suggests, setting input **Allocate Data Set** to `TRUE` will give you an option to decide and set the parameters of a sequential dataset to be created. If **Allocate Data Set** is `FALSE`, the plug-in step assumes that the dataset exists and writes the input text to the dataset. | ||
|
|
||
| Input **Delete Existing Data Set** comes into action only when **Allocate Data Set** is set to `TRUE` and deletes the existing dataset. Set to **Allocate Data Set** to `TRUE` to allocate a new dataset with passed parameters and write the input text to a sequential dataset. | ||
|
|
||
| The remaining inputs in the step are to set parameters like DCB and Space etc., for a sequential dataset and are applicable only if **Allocate Data Set** is `TRUE`. | ||
|
|
||
| ## Copy file data to a dataset | ||
|
|
||
| Select **Source Type** as `FILE` from the drop-down and pass the file path as input in **Source value**. Refer to the below screenshot: | ||
|  | ||
|
|
||
| By default, the plugin assumes the USS file to be in IBM-1047 encoding. However, encoding can be passed along with a file path separated by a comma (,) as shown in the screenshot below | ||
|  | ||
| The plugin step copies the data in the USS file to the Sequential dataset. | ||
|
|
||
| ## Copying PDS member or Sequential dataset data to another dataset | ||
|
|
||
| Select **Source Type** as `DATASET` from the drop-down and pass the PDS member or Sequential dataset name as input in **Source value**. Refer to the below screenshots: | ||
|  | ||
|
|
||
| For Sequential dataset as input | ||
|  | ||
|
|
||
| The plugin step copies the data from a PDS member or input Sequential dataset to the Output Sequential dataset. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| # Downloads | ||
|
|
||
| To download the plug-in, click the following version-specific links. | ||
|
|
||
| - [ucd-ExtArtRepo-10.1162509.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zOS-external-artifact-download/ucd-ExtArtRepo-10.1162509.zip) | ||
| - [ucd-ExtArtRepo-10.1152827.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zOS-external-artifact-download/ucd-ExtArtRepo-10.1152827.zip) | ||
| - [ucd-ExtArtRepo-9.1140093.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zOS-external-artifact-download/ucd-ExtArtRepo-9.1140093.zip) | ||
| - [ExtArtRepo-8.1101664.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zOS-external-artifact-download/ExtArtRepo-8.1101664.zip) | ||
| - [ExtArtRepo-7.1073614.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zOS-external-artifact-download/ExtArtRepo-7.1073614.zip) | ||
| - [ExtArtRepo-7.1064504.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zOS-external-artifact-download/ExtArtRepo-7.1064504.zip) | ||
| - [ExtArtRepo-6.1062664.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zOS-external-artifact-download/ExtArtRepo-6.1062664.zip) | ||
| - [ExtArtRepo-5.1057222.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zOS-external-artifact-download/ExtArtRepo-5.1057222.zip) | ||
| - [ExtArtRepo-4.1052576.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zOS-external-artifact-download/ExtArtRepo-4.1052576.zip) | ||
| - [ExtArtRepo-2.1039791.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zOS-external-artifact-download/ExtArtRepo-2.1039791.zip) | ||
| - [ExtArtRepo-1.1033763.zip](https://raw.githubusercontent.com/UrbanCode/IBM-UCD-PLUGINS/main/files/zOS-external-artifact-download/ExtArtRepo-1.1033763.zip) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,61 @@ | ||
| # Overview | ||
|
|
||
| The External Artifact Repository plug-in automates the downloading of IBM z/OS artifacts from a [Nexus](https://www.sonatype.com/product-nexus-repository) or [JFrog Artifactory](https://jfrog.com/artifactory/) repository. | ||
|
|
||
| ## Step palette | ||
|
|
||
| To access this plug-in in the palette, click **Repositories** > **Artifact** > **zOS ExternalArtifactsDownload**. | ||
|
|
||
| ## Compatibility | ||
|
|
||
| This plug-in requires 7.0.4 or later of UrbanCode Deploy. | ||
|
|
||
| ## Installation | ||
|
|
||
| No special steps are required for installation. See [Installing plug-ins in UrbanCode](https://community.ibm.com/community/user/wasdevops/blogs/laurel-dickson-bull1/2022/06/13/install-plugins "Installing plug-ins in UrbanCode"). | ||
|
|
||
| ## History | ||
|
|
||
| ### Version 10 | ||
|
|
||
| Added support to handle AT_TLS configuration for external repository servers | ||
| Fixed Jettison Vulnerability | ||
|
|
||
| ### Version 9 | ||
|
|
||
| Minor Improvements and upgraded log4j | ||
|
|
||
| ### Version 8 | ||
|
|
||
| Added support to run with insecure connection | ||
|
|
||
| ### Version 7 | ||
|
|
||
| * Added support to run this from non zOS agent | ||
| * Minor improvements for new package format | ||
|
|
||
| ### Version 6 | ||
|
|
||
| Added support to run this from non zOS agent | ||
|
|
||
| ### Version 5 | ||
|
|
||
| Enhancement to extract files for package format v2 | ||
|
|
||
| ### Version 4 | ||
|
|
||
| Implemented the proxy changes for artifactory server | ||
|
|
||
| ### Version 3 | ||
|
|
||
| Implemented the api key changes for artifactory server | ||
|
|
||
| ### Version 2 | ||
|
|
||
| PH20336 – Fixed the default value for extRepoURL and changed the plugin to fail when it is not able to download artifacts | ||
|
|
||
| ### Version 1 | ||
|
|
||
| Initial release. | ||
|
|
||
| Plugin is used to download artifacts from external repository like NEXUS/ARTIFACTORY then we can use Deploy Data Sets step for zOS deployment. |
Oops, something went wrong.