{"id":25257233,"url":"https://github.com/zowe/launcher","last_synced_at":"2026-01-08T00:12:08.954Z","repository":{"id":37469339,"uuid":"300586575","full_name":"zowe/launcher","owner":"zowe","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-25T07:35:26.000Z","size":976,"stargazers_count":0,"open_issues_count":30,"forks_count":4,"subscribers_count":16,"default_branch":"v3.x/staging","last_synced_at":"2025-06-25T08:37:20.684Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zowe.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-10-02T10:59:26.000Z","updated_at":"2025-05-08T15:09:51.000Z","dependencies_parsed_at":"2023-10-16T18:29:23.898Z","dependency_job_id":"0b557bcd-1fd4-41f6-9544-6ec88cf27f5a","html_url":"https://github.com/zowe/launcher","commit_stats":null,"previous_names":[],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/zowe/launcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Flauncher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Flauncher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Flauncher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Flauncher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zowe","download_url":"https://codeload.github.com/zowe/launcher/tar.gz/refs/heads/v3.x/staging","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Flauncher/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267103980,"owners_count":24036574,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-26T02:00:08.937Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-12T06:38:17.153Z","updated_at":"2026-01-08T00:12:08.949Z","avatar_url":"https://github.com/zowe.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"This program and the accompanying materials are\nmade available under the terms of the Eclipse Public License v2.0 which accompanies\nthis distribution, and is available at https://www.eclipse.org/legal/epl-v20.html\n\nSPDX-License-Identifier: EPL-2.0\n\nCopyright Contributors to the Zowe Project.\n\n\u003ch1 align=\"center\"\u003eZowe Launcher\u003c/h1\u003e\n\nThe Zowe launcher is a part of the Zowe server architecture that was added as an optional program for HA/FT usage in v1.\nIn v2, the Zowe launcher became the sole way to start the Zowe servers.\nThe launcher's purpose is to start, restart, and stop each Zowe server component which has a `start` command,\nand in doing so it watches over such components for health (restarting them if they crash) and log management.\n\n## Current features\n* Stopping Zowe using the conventional `P` operator command\n* Ability to handle `MODIFY` commands\n* Stopping and starting specific Zowe components without restarting the entire Zowe\n\n## Future features\n* Issuing WTOs indicating the start and termination of specific components (this should simplify the integration with z/OS automation)\n* Passing `MODIFY` commands to Zowe components\n* Clean termination of the components in case if the launcher gets cancelled\n\n## Building\n\nThe Zowe launcher is build with a version defined in [manifest.yaml](./manifest.yaml). This version is used in `ZWEL0021I` message.\n\n```shell\ncd zowe-launcher/build\n./build.sh\n```\n\nFor development purposes, it is possible to specify custom defined version, which must be compound from three numeric values and dots: for example `1.2.3`. Invalid version will be used as `0.0.0`.\n```shell\ncd zowe-launcher/build\nexport LAUNCHER_VERSION=1.2.3 \u0026\u0026 ./build.sh\n```\n\nThe launcher binary will be saved into the `bin` directory.\n\n## Testing\n\nSee [details](./test/README.md) in `test` directory.\n\n## Prerequisites\n\n* Zowe 2.4.0\n\n## Deployment\n\n* Find the JCL used to start your Zowe instance (ZWESLSTC)\n* Stop that Zowe instance\n* Find the dataset used by that STC\n* Copy the binary from the bin directory into that dataset with whatever name you want\n* If necessary, update the PGM name to match the name of the resulting copy you just did\n* Restart that Zowe instance\n\n## Operating the launcher\n\n* To start the launcher use the `S` operator command:\n```\nS ZWESLSTC\n```\n* To stop use the `P` operator command:\n```\nP ZWESLSTC\n```\n* To stop a specific component use the following `MODIFY` command:\n```\nF ZWESLSTC,APPL=STOP(component_name)\n```\n* To start a specific component use the following `MODIFY` command:\n```\nF ZWESLSTC,APPL=START(component_name)\n```\n* To list the components use the following `MODIFY` command:\n```\nF ZWESLSTC,APPL=DISP\n```\n\n## Community\n\nThis part of Zowe is currently developed by the zOS squad, which you can find on Slack at [#zowe-zos-interface](https://openmainframeproject.slack.com/archives/C034VLT3W2G).\n\n## Architecture\n\nThe launcher is a z/OS program which utilizes [configmgr](https://github.com/zowe/zowe-common-c/blob/v3.x/staging/c/configmgr.c) to read the Zowe config in order to determine which components to start, and then prepares Zowe to run, starts the components, and manages their unix processes.\n\nIt's behavior is summarized in this flow chart diagram.\n\n![Launcher flow chart](./Launcher.svg)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzowe%2Flauncher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzowe%2Flauncher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzowe%2Flauncher/lists"}