Skip to content

Conversation

@Martin-Zeithaml
Copy link
Collaborator

@Martin-Zeithaml Martin-Zeithaml commented Jul 10, 2025

Migrate to JCL is adding a lot of changes, which are not documented or an update is missing.

List the file(s) included in this PR:
docs/user-guide/zwe-init-subcommand-overview.md
docs/user-guide/initialize-zos-system.md

After creating the PR, follow the instructions in the comments.

@Martin-Zeithaml Martin-Zeithaml added area: zwe Related to the zwe management tool release: V3 Zowe V3 content review: doc Needs review by Doc Squad member labels Jul 10, 2025
@github-actions
Copy link

github-actions bot commented Jul 10, 2025

😺 Thank you for creating this PR! To publish your content to Zowe Docs, follow these required steps.

  • Add the label review: doc.
  • Identify your content topic with a label. (Examples: area: apiml, area: cli, area: install and config, etc.)
  • Specify the major Zowe release(s) for your content. (Examples: release: V1, release: V2, release: V3)
    • If adding content that needs to be removed from V3 documentation, add the V3 N/A tag.
  • Select the master branch if your PR updates content that is on the live site. Select docs-staging if your PR updates content for a future release.
  • Notify the Doc Squad about this PR. If you don't know whom should review your content, message the #zowe-doc Slack channel. If you know which Doc Squad writer should approve your content, add that person as a reviewer.

Need help? Contact the Doc Squad in the #zowe-doc Slack channel.

@github-actions
Copy link

github-actions bot commented Jul 10, 2025

@github-actions github-actions bot temporarily deployed to pull request July 10, 2025 09:51 Inactive
@Martin-Zeithaml Martin-Zeithaml marked this pull request as draft July 10, 2025 10:55
Signed-off-by: Martin Zeithaml <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request July 10, 2025 12:18 Inactive
@Martin-Zeithaml Martin-Zeithaml changed the title server-datasets.md: missing MVS members Migrate to JCL: update Jul 10, 2025
Signed-off-by: Martin Zeithaml <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request July 10, 2025 13:58 Inactive
@github-actions github-actions bot temporarily deployed to pull request July 11, 2025 09:07 Inactive
Signed-off-by: Martin Zeithaml <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request August 6, 2025 11:53 Inactive
Signed-off-by: Martin Zeithaml <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request August 6, 2025 12:08 Inactive
@github-actions github-actions bot temporarily deployed to pull request August 6, 2025 12:35 Inactive
Signed-off-by: Martin Zeithaml <[email protected]>
Signed-off-by: Martin Zeithaml <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request August 6, 2025 12:54 Inactive
Signed-off-by: Martin Zeithaml <[email protected]>
Signed-off-by: Martin Zeithaml <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request August 6, 2025 15:00 Inactive
@github-actions github-actions bot temporarily deployed to pull request August 28, 2025 20:59 Inactive
Signed-off-by: MarkAckert <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request August 29, 2025 13:48 Inactive
Signed-off-by: MarkAckert <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request August 29, 2025 16:16 Inactive
@github-actions github-actions bot temporarily deployed to pull request August 29, 2025 17:17 Inactive
@MarkAckert MarkAckert changed the base branch from master to docs-staging August 29, 2025 17:32
@github-actions github-actions bot temporarily deployed to pull request August 29, 2025 17:45 Inactive

This takes the configuration values present in your `zowe.yaml` file, uses them to populate JCL templates in `SZWESAMP`, and creates a `JCLLIB` dataset with the final generated JCL. The `JCLLIB` will be created using the value of `zowe.setup.dataset.jcllib`.

For example, `zwe init generate` with the below zowe.yaml creates the dataset `MY.DS.PREFIX.JCLLIB`. If this dataset already exists, you must add `--allow-overwrite` to the `init generate` command.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If this dataset already exists, you must add --allow-overwrite to the init generate command.

Nope, this dataset is always deleted and created by ZWEGEN00.

Signed-off-by: Martin Zeithaml <[email protected]>
|Certificates Option 3|Zowe creates a keyring and populates the keyring by importing PKCS12 content from a dataset that you specify.|RACF: [ZWEIKRR3](https://github.com/zowe/zowe-install-packaging/tree/feature/v3/jcl/files/SZWESAMP/ZWEIKRR3)<br /><br />TSS: [ZWEIKRT3](https://github.com/zowe/zowe-install-packaging/tree/feature/v3/jcl/files/SZWESAMP/ZWEIKRT3)<br /><br />ACF2: [ZWEIKRA3](https://github.com/zowe/zowe-install-packaging/tree/feature/v3/jcl/files/SZWESAMP/ZWEIKRA3)|
|STC|**Purpose**:<br /> ZWESLSTC is the job for running Zowe's webservers. ZWESISTC runs the APF authorized cross-memory server. The ZWESASTC job is started by ZWESISTC on an as-needed basis.<br /><br />**Action**:<br /> Copy the members ZWESLSTC, ZWESISTC, and ZWESASTC into your desired PROCLIB. If the job names are customized, modify the job name YAML values in `zowe.setup.security.stcs`|[ZWEISTC](https://github.com/zowe/zowe-install-packaging/tree/feature/v3/jcl/files/SZWESAMP/ZWEISTC)|
|(Optional) VSAM for Caching Service (NYI)|**Purpose:**<br /> To use VSAM as your storage method for the Caching Service. Note that Infinispan is the recommended storage method. For more information, see [Using VSAM as a storage solution through the Caching service](../extend/extend-apiml/api-mediation-vsam.md).<br /><br />**Action:**<br /> Create a RLM or NONRLM dataset for the Caching service, and set the name as the value for `components.caching-service.storage.vsam.name`|[ZWECSVSM](https://github.com/zowe/zowe-install-packaging/tree/feature/v3/jcl/files/SZWESAMP/ZWECSVSM)|
|Installation|**Purpose:**<br /> Create datasets for Zowe's PARMLIB content and non-ZFS extension content for a given Zowe Instance<br /><br />**Action:**<br />1. Allocate the PDSE FB80 dataset with at least 15 tracks named from Zowe parameter `zowe.setup.dataset.parmlib`<br />2. Allocate the PDSE FB80 dataset with at least 30 tracks named from Zowe parameter `zowe.setup.dataset.authPluginLib`<br />3. Copy the ZWESIP00 member from `zowe.setup.dataset.prefix`.SZWESAMP into `zowe.setup.dataset.parmlib`|[ZWEIMVS](https://github.com/zowe/zowe-install-packaging/tree/v3.x/master/files/SZWESAMP/ZWEIMVS)|
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This was fixed here
There were some additional changes.

@github-actions github-actions bot temporarily deployed to pull request September 2, 2025 15:04 Inactive
Signed-off-by: MarkAckert <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request September 3, 2025 16:19 Inactive
@github-actions github-actions bot temporarily deployed to pull request September 3, 2025 17:47 Inactive
@github-actions github-actions bot temporarily deployed to pull request September 3, 2025 20:53 Inactive
MarkAckert and others added 4 commits September 4, 2025 14:40
Signed-off-by: Martin Zeithaml <[email protected]>
Signed-off-by: Martin Zeithaml <[email protected]>
@github-actions github-actions bot temporarily deployed to pull request September 10, 2025 13:44 Inactive
@Martin-Zeithaml Martin-Zeithaml marked this pull request as ready for review September 30, 2025 08:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: zwe Related to the zwe management tool release: V3 Zowe V3 content review: doc Needs review by Doc Squad member

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants