{"id":25257251,"url":"https://github.com/zowe/zss","last_synced_at":"2026-01-08T00:12:34.794Z","repository":{"id":37851153,"uuid":"166097436","full_name":"zowe/zss","owner":"zowe","description":"Zowe System Services Server for enabling low-level microservices ","archived":false,"fork":false,"pushed_at":"2025-02-04T17:13:15.000Z","size":94188,"stargazers_count":14,"open_issues_count":66,"forks_count":45,"subscribers_count":12,"default_branch":"v3.x/staging","last_synced_at":"2025-02-04T18:25:03.910Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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":"CONTRIBUTING.md","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}},"created_at":"2019-01-16T19:24:57.000Z","updated_at":"2025-01-28T16:19:25.000Z","dependencies_parsed_at":"2023-10-26T12:25:40.172Z","dependency_job_id":"8a74a020-48a9-41b1-a44c-7bf20755ddd4","html_url":"https://github.com/zowe/zss","commit_stats":null,"previous_names":[],"tags_count":93,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fzss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fzss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fzss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fzss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zowe","download_url":"https://codeload.github.com/zowe/zss/tar.gz/refs/heads/v3.x/staging","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238423759,"owners_count":19469894,"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","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:27.379Z","updated_at":"2026-01-08T00:12:34.752Z","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# ZSS - Zowe System Services Server for enabling low-level microservices for z/OS\n\n## (Quick start) How to build ZSS and the cross-memory server\n\n```\ngit clone git@github.com:zowe/zss.git\ncd zss\ngit submodule update --init\n./build/build.sh\n``` \n\nNote: zssServer will be placed in the `bin` directory, the cross-memory server's load module will be placed \nin the `user-id.DEV.LOADLIB` dataset.\n\n## (Quick run) How to start ZSS\n\nZowe core schemas are needed to run, so the quickest way to get them as a developer is to clone the repo they come from.\n\n```\ngit clone git@github.com:zowe/zowe-install-packaging.git\n```\nThen, tell ZSS where to find the schemas and the configs and then start it up, like so:\n```\ncd /path/to/zss/bin\nexport ZWES_COMPONENT_HOME=/path/to/zss\nexport ZWE_zowe_runtimeDirectory=/path/to/zowe-install-packaging\nZWE_CLI_PARAMETER_CONFIG=\"FILE(/my/zowe.yaml)\" ./zssServer.sh\n```\n\nNote: ZSS defaults are in [defaults.yaml](https://github.com/zowe/zss/blob/v3.x/staging/defaults.yaml) so you only need to provide customizations in your own zowe.yaml.\n\n## How to submit a pull request\n\nThe [zowe-common-c](https://github.com/zowe/zowe-common-c) library is a dependency of ZSS.\nIf a ZSS pull request implies some changes of `zowe-common-c`, the changes should be merged\nfirst, and the reference to the correspondent `zowe-common-c` commit should be included.  \n\nFor example:\n\n```\ncd deps/zowe-common-c\ngit checkout \u003cZOWE_COMMON_C_GIT_REFERENCE\u003e\ncd ../..\ngit add deps/zowe-common-c/\n```  \n\n## Troubleshooting\n\nWhen using ZSS as the agent to host files and folders, for example: for the Zowe Editor Desktop app by the App server, may lead to '401 Impersonator Error'\nFix: Make sure the program-controlled bit is set for your ZSS binary `extattr +p zssServer`\n\nZSS in V3 takes advantage of V3 by using schemas and the Zowe configuration YAML. If you're running `zssServer` accidentally, instead of `zssServer.sh` or your `zssServer.sh` is out of date, you may see an error on start like `ZSS 2.x requires schemas and config`\n\nWhen starting ZSS, you may encounter a schema validation issue i.e. `Configuration has validity exceptions: Schema at '' invalid [...]`. \nFix: To read these errors, consult: https://docs.zowe.org/stable/user-guide/configmgr-using/#validation-error-reporting\nNote: ZSS has a default schema in `$ZWES_COMPONENT_HOME/schemas` and default configuration YAML in `$ZWES_COMPONENT_HOME/defaults.yaml`\n\n## Mock server\n\nIf you don't have access to z/OS, or want to help expand the Mock server, find it at: https://github.com/zowe/zss/tree/v3.x/staging/mock\n\nThis 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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzowe%2Fzss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzowe%2Fzss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzowe%2Fzss/lists"}