{"id":25257255,"url":"https://github.com/zowe/explorer-mvs","last_synced_at":"2025-10-27T02:31:47.909Z","repository":{"id":37470245,"uuid":"144592697","full_name":"zowe/explorer-mvs","owner":"zowe","description":null,"archived":false,"fork":false,"pushed_at":"2024-10-29T14:31:29.000Z","size":4011,"stargazers_count":0,"open_issues_count":5,"forks_count":8,"subscribers_count":12,"default_branch":"v2.x/master","last_synced_at":"2024-10-29T17:22:28.173Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":false,"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":"2018-08-13T14:39:59.000Z","updated_at":"2024-09-25T17:13:12.000Z","dependencies_parsed_at":"2024-03-21T13:45:19.230Z","dependency_job_id":"bdbdba19-f492-42e7-bbfc-cb917c64036f","html_url":"https://github.com/zowe/explorer-mvs","commit_stats":null,"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-mvs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-mvs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-mvs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-mvs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zowe","download_url":"https://codeload.github.com/zowe/explorer-mvs/tar.gz/refs/heads/v2.x/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238423897,"owners_count":19469926,"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.869Z","updated_at":"2025-10-27T02:31:42.529Z","avatar_url":"https://github.com/zowe.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# explorer-mvs\n\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=zowe_explorer-mvs\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=zowe_explorer-mvs)\n\nThe issues for the MVS explorer are tracked under the Zowe Zlux repository, https://github.com/zowe/zlux and tagged accordingly with the 'explorer-mvs' label. Open issues tagged with 'explorer-mvs' can be found [here](https://github.com/zowe/zlux/issues?q=is%3Aissue+is%3Aopen+label%3Aexplorer-mvs).\n\n\n# App Development Workflow \n\n### Install Dependencies\n\nAs following modules \n `explorer-ui-server`, `orion-editor-component` and `explorer-fvt-utilities` are published on Zowe Artifactory.\n `.npmrc` file is pre-configured with registry value of `https://zowe.jfrog.io/zowe/api/npm/npm-release`\n```\nnpm install\n```\n\n### Build for Development\n\nModify the host variable in WebContent/js/utilities/urlUtils.js to a host and port that has the Zowe API Gateway and Jobs service.\n\n```\nnpm run dev \n```\n\nThen you can visit http://localhost:8080 to test.\nWhen testing you may see errors with API calls do to CORS (Cross origin resource sharing), to work around this you may disable CORS checking in your browser for local development or setup a proxy.\n\n### Run unit tests\n\n```\nnpm run test\n```\n\n### Run fvt/selenium tests\n\nSee [README](/tests/FVTTests/README.md)\n\n\n### Build for Production\n\n```\nnpm run prod\n```\n\n### Prepare PAX Packaging Workspace\n\n```\n./.pax/prepare-workspace.sh\n```\n\n## Start With explorer-ui-server\n\nAfter preparing PAX workspace, you can serve the explorer UI with explorer-ui-server:\n\n```\nnode .pax/ascii/server/src/index.js --config .pax/ascii/server/configs/config.json\n```\n\n## Run SonarQube Code Analysis\n\nInstall [SonarQube Scanner](https://docs.sonarqube.org/display/SCAN/Analyzing+with+SonarQube+Scanner).\n\nIf you are using Mac, try install with [HomeBrew sonar-scanner formula](https://formulae.brew.sh/formula/sonar-scanner), then update the configuration of SonarQube server at `/usr/local/Cellar/sonar-scanner/\u003cversion\u003e/libexec/conf/sonar-scanner.properties`.\n\nExample scanner configurations:\n\n```\nsonar.host.url=https://jayne.zowe.org:9000\nsonar.login=\u003chash\u003e\n```\n\nThen you can run `sonar-scanner` to start code analysis.\n\nBuild pipeline has embedded the SonarQube code analysis stage.\n\n\n## Build and install as plugin in local zlux development environment\n\nModify `explorer-mvs/Webcontent/index.html`   \nChange relative path for `iframe-adapter.js` \u0026 `logger.js` to absolute path.   \nAppend with your `API Gateway` `Hostname` and `Port`\n\nFor example:\n```\n  \u003cscript type=\"text/javascript\" src=\"https://mymainframe.com:7554/zlux/ui/v1/lib/org.zowe.zlux.logger/0.9.0/logger.js\"\u003e\u003c/script\u003e\n  \u003cscript type=\"text/javascript\" src=\"https://mymainframe.com:7554/zlux/ui/v1/ZLUX/plugins/org.zowe.zlux.bootstrap/web/iframe-adapter.js\"\u003e\u003c/script\u003e\n```\n\nBuild web folder\n```\ncd explorer-mvs\n# root folder\nnpm install\n# This will create web folder\nnpm run build\n```\n\nInstall as ZLUX App/Plugin\n```\n# install in zlux locally\ncd zlux/zlux-app-server/bin\n./install-app.sh \u003cpath-to-explorer-mvs\u003e\n```\n`explorer-mvs` root already have sample `pluginDefinition.json` \u0026 will have `web` folder after `build`.\n\n## Enable Redux logs\nEither use [Redux Dev Tool Browser Extension](https://github.com/reduxjs/redux-devtools) in your browser \nOr enable redux logs by setting `enableReduxLogger` variable `true` in your local storage.\n\n### Add Redux Logger\nWhile explore app is open in browser:\n1. Run this in browser console \n```\nwindow.localStorage.setItem('enableReduxLogger', true);\n```\n\n2. And refresh browser    \nSo as long as this value remains true in browser local storage,       \nyou will see redux logs in console.                  \n\n### Remove Redux Logger          \nWhile explore app is open in browser:      \n1. Run either `window.localStorage.setItem('enableReduxLogger', false)`         \nor `window.localStorage.removeItem('enableReduxLogger')`           \nor clear storage manually in `browser dev tools` under `Application` tab \n\n2. And refresh browser to stop seeing redux console logs. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzowe%2Fexplorer-mvs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzowe%2Fexplorer-mvs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzowe%2Fexplorer-mvs/lists"}