|
1 | 1 | # Code4z |
2 | 2 |
|
3 | | -Mainframe starter pack for Developers working with z/OS applications. |
| 3 | +Code4z is an all-in-one mainframe extension package for developers working with z/OS applications, suitable for all levels of mainframe experience, even beginners. |
4 | 4 |
|
5 | | -Powered by open source projects Zowe and Che4z, Code4z offers mainframe application Developers a modern, familiar and seamless experience. |
| 5 | +Mainframe application developers can use the Code4z package for a modern, familiar, and seamless experience, which helps to overcome some developers' reservations or concerns about the traditional mainframe user experience. |
6 | 6 |
|
7 | | -> How can we improve Code4z? Let us know on the [Git Repository](https://github.com/BroadcomMFD/code4z/issues) |
| 7 | +Developers can now find the code they need to work on in Explorer for Endevor and Zowe Explorer, edit code assisted by COBOL or HLASM Language Support, and test the resulting code with the Debugger, all in one Mainframe development package. |
8 | 8 |
|
9 | | -## What’s New |
10 | | - |
11 | | -* [HLASM Language Support](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.hlasm-language-support) and [Debugger for Mainframe](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.debugger-for-mainframe) are now a part of the Code4z package |
12 | | -## Features |
13 | | - |
14 | | -* Access z/OS Datasets |
15 | | -* Access z/OS Unix file system |
16 | | -* Submit JCL |
17 | | -* View and download job output |
18 | | -* Issue TSO commands |
19 | | -* Retrieve, browse and search CA Endevor® elements |
20 | | -* Edit COBOL and HLASM code with Syntax highlighting, real time syntax validation, content assist and other advanced features |
21 | | -* Trace HLASM macros |
22 | | -* Debug COBOL code for applications running in a CICS region |
23 | | -* Edit JCL with basic syntax highlighting |
24 | | -* Optionally, pair and use with Zowe CLI |
25 | | - |
26 | | -Many of these extensions, and other mainframe-oriented innovations, are also available as part of Eclipse Che subproject [Che4z](https://www.eclipse.org/che/docs/che-7/eclipse-che4z/). |
27 | | -<br /><br /> |
28 | 9 | <p align="center"> |
29 | 10 | <img src="https://raw.githubusercontent.com/BroadcomMFD/code4z/1.1.0/extensions.png" alt="Code4z Extensions"/> |
30 | 11 | </p> |
31 | 12 |
|
32 | | -## Extensions Included |
| 13 | +Powered by open source projects [Zowe](https://www.zowe.org/) and [Che](https://www.eclipse.org/che/). Many of these extensions, and other mainframe-oriented innovations, are also available as part of open source [Eclipse Che4z subproject](https://github.com/eclipse/che-che4z). |
33 | 14 |
|
34 | | -* [Zowe Explorer](https://marketplace.visualstudio.com/items?itemName=Zowe.vscode-extension-for-zowe) - VS Code extension, powered by Zowe CLI, that streamlines interaction with mainframe data sets, USS files, and jobs |
35 | | -* [COBOL Language Support](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.cobol-language-support) - COBOL Language Support standardizes the communication between language tooling and your code editor using the Language Server Protocol (LSP) |
36 | | -* [HLASM Language Support](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.hlasm-language-support) - Code completion, highlighting, browsing and validation for High Level Assembler |
37 | | -* [Explorer for Endevor](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.explorer-for-endevor) - Explorer for Endevor gives you the ability to Browse and Retrieve CA Endevor® SCM elements using a user-friendly, intuitive interface |
38 | | -* [Debugger for Mainframe](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.debugger-for-mainframe) - Debugger for Mainframe provides the debugging interface to CA InterTest™. This extension provides a modern debug experience for COBOL applications running in a CICS region |
39 | | -* [COBOL](https://marketplace.visualstudio.com/items?itemName=bitlang.cobol) - Syntax highlighting for COBOL, JCL, PL/I and MF directive files |
40 | 15 |
|
| 16 | +## What’s New |
| 17 | + |
| 18 | +* 2019-12-16 - [HLASM Language Support](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.hlasm-language-support) and [Debugger for Mainframe](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.debugger-for-mainframe) are now a part of the Code4z package. |
41 | 19 |
|
42 | 20 | ## Prerequisites |
43 | 21 |
|
44 | | -* Java installed on your PC |
45 | | -* For information about the prerequisites of individual extensions, refer to the links in the section above. |
| 22 | +* Java installed on your machine. |
| 23 | +* Individual extension prerequisites are detailed in the sections below. |
46 | 24 |
|
47 | | -## Sample Workflows |
| 25 | +## [COBOL Language Support](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.cobol-language-support) |
| 26 | + |
| 27 | +[](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.cobol-language-support) |
| 28 | +[](https://github.com/eclipse/che-che4z-lsp-for-cobol/issues) |
| 29 | +[](https://join.slack.com/t/che4z/shared_invite/enQtNzk0MzA4NDMzOTIwLWIzMjEwMjJlOGMxNmMyNzQ1NWZlMzkxNmQ3M2VkYWNjMmE0MGQ0MjIyZmY3MTdhZThkZDg3NGNhY2FmZTEwNzQ) |
| 30 | + |
| 31 | +COBOL Language Support provides autocomplete, highlighting and diagnostic features for COBOL code and copybooks. |
| 32 | + |
| 33 | +The Code4z package includes a bitlang [COBOL extension](https://marketplace.visualstudio.com/items?itemName=bitlang.cobol) which provides an enhanced experience while working with COBOL Language Support and enables syntax coloring. |
| 34 | + |
| 35 | +> How can we improve COBOL Language Support? [Let us know on our Git repository](https://github.com/eclipse/che-che4z-lsp-for-cobol/issues) |
| 36 | +
|
| 37 | +### Features |
| 38 | +* Edit COBOL code with syntax highlighting, real time syntax validation, content assist and other advanced features. |
| 39 | + |
| 40 | +### Blogs |
| 41 | +* [Beginner’s Guide: COBOL Made Easy](https://medium.com/modern-mainframe/beginners-guide-cobol-made-easy-introduction-ecf2f611ac76) |
| 42 | + |
| 43 | +## [HLASM Language Support](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.hlasm-language-support) |
| 44 | + |
| 45 | +[](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.hlasm-language-support) |
| 46 | +[](https://github.com/eclipse/che-che4z-lsp-for-hlasm/issues) |
| 47 | +[](https://join.slack.com/t/che4z/shared_invite/enQtNzk0MzA4NDMzOTIwLWIzMjEwMjJlOGMxNmMyNzQ1NWZlMzkxNmQ3M2VkYWNjMmE0MGQ0MjIyZmY3MTdhZThkZDg3NGNhY2FmZTEwNzQ) |
| 48 | + |
| 49 | +Code completion, highlighting, browsing and validation for High Level Assembler language. |
| 50 | + |
| 51 | +> How can we improve HLASM Language Support? [Let us know on our Git repository](https://github.com/eclipse/che-che4z-lsp-for-hlasm/issues) |
| 52 | +
|
| 53 | +### Features |
| 54 | +* Edit HLASM code with syntax highlighting, real time syntax validation, content assist and other advanced features. |
| 55 | +* Trace HLASM macros. |
48 | 56 |
|
49 | | -### COBOL Language Support and CA Endevor Git Bridge |
50 | | -* Use VS Code’s built-in git interface to git clone source code from CA Endevor using Endevor’s Git Bridge |
51 | | -* Edit COBOL code using the COBOL Language Support, taking advantage of all the coding assistance provided by the extension |
52 | | -* Use VS Code’s built-in git interface to push, pull and merge changes |
| 57 | +## [Zowe Explorer](https://marketplace.visualstudio.com/items?itemName=Zowe.vscode-extension-for-zowe) |
53 | 58 |
|
54 | | -### Zowe Explorer and Developer Testing |
| 59 | +[](https://marketplace.visualstudio.com/items?itemName=Zowe.vscode-extension-for-zowe) |
| 60 | +[](https://github.com/zowe/vscode-extension-for-zowe/issues) |
| 61 | +[](https://openmainframeproject.slack.com/) |
55 | 62 |
|
56 | | -* Unit test code changes by submitting batch jobs. Access JCL in datasets using Zowe Explorer and submit them to the target z/OS system. View the results on the VS Code editor allowing quick and easy batch based unit testing of their code changes. |
| 63 | +Zowe Explorer is a VS Code extension powered by Zowe CLI that streamlines interaction with mainframe data sets, USS files, and jobs. |
57 | 64 |
|
58 | | -### COBOL Language Support and Explorer for Endevor |
| 65 | +> How can we improve Zowe Explorer? [Let us know on our Git repository](https://github.com/zowe/vscode-extension-for-zowe/issues) |
59 | 66 |
|
60 | | -* View code elements in the entire map of Endevor using the Explorer for Endevor Extension. Editing is not allowed, but the COBOL Language Support will provide syntax highlighting for COBOL elements. |
61 | | -* Download code elements, including their dependencies, using the Explorer for Endevor extension and add it to the git project if code modifications are needed. |
| 67 | +### Features |
| 68 | +* Access z/OS Datasets and z/OS Unix file systems and submit JCLs. |
| 69 | +* View and download job output. |
| 70 | +* Issue TSO commands. |
| 71 | + |
| 72 | +### Blogs |
| 73 | +* [Beginner’s Guide: How to access mainframe via Zowe in 10 easy steps](https://marketplace.visualstudio.com/items?itemName=Zowe.vscode-extension-for-zowe) |
| 74 | +* [Zowe blog](https://marketplace.visualstudio.com/items?itemName=Zowe.vscode-extension-for-zowe) |
| 75 | + |
| 76 | +## [Explorer for Endevor](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.explorer-for-endevor) |
| 77 | +[](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.explorer-for-endevor) |
| 78 | +[](https://github.com/eclipse/che-che4z-explorer-for-endevor/issues) |
| 79 | +[](https://join.slack.com/t/che4z/shared_invite/enQtNzk0MzA4NDMzOTIwLWIzMjEwMjJlOGMxNmMyNzQ1NWZlMzkxNmQ3M2VkYWNjMmE0MGQ0MjIyZmY3MTdhZThkZDg3NGNhY2FmZTEwNzQ) |
| 80 | + |
| 81 | +Explorer for Endevor gives you the ability to Browse and Retrieve [CA Endevor® SCM](https://www.broadcom.com/products/mainframe/devops-app-development/app/endevor-software-change-manager) elements using a user-friendly, intuitive interface. |
| 82 | + |
| 83 | +This extension offers best developer experience in synergy with [Bridge for Git](https://youtu.be/sjnZuQpUVM4), a solution which enables you to concurrently work in Git and mainframe. |
| 84 | + |
| 85 | +> How can we improve Explorer for Endevor? [Let us know on our Git repository](https://github.com/eclipse/che-che4z-explorer-for-endevor/issues) |
| 86 | +
|
| 87 | +### Features |
| 88 | +* Retrieve, browse and search CA Endevor® elements. |
| 89 | + |
| 90 | +## [Debugger for Mainframe](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.debugger-for-mainframe) |
| 91 | +[](https://marketplace.visualstudio.com/items?itemName=broadcomMFD.debugger-for-mainframe) |
| 92 | +[](https://github.com/BroadcomMFD/debugger-for-mainframe/issues) |
| 93 | +[](https://join.slack.com/t/che4z/shared_invite/enQtNzk0MzA4NDMzOTIwLWIzMjEwMjJlOGMxNmMyNzQ1NWZlMzkxNmQ3M2VkYWNjMmE0MGQ0MjIyZmY3MTdhZThkZDg3NGNhY2FmZTEwNzQ) |
| 94 | + |
| 95 | +Debugger for Mainframe provides the debugging interface to [CA InterTest™ for CICS](https://www.broadcom.com/products/mainframe/devops-app-development/testing-quality/intertest-cics). This extension provides a modern debug experience for COBOL applications running in a CICS region. |
| 96 | + |
| 97 | +> How can we improve Debugger for Mainframe? [Let us know on our Git repository](https://github.com/BroadcomMFD/debugger-for-mainframe/issues) |
| 98 | +
|
| 99 | +### Features |
| 100 | + |
| 101 | +* Debug COBOL code for applications running in a CICS region. |
| 102 | + |
| 103 | +## Sample Workflows |
| 104 | + |
| 105 | +### COBOL Language Support using CA Endevor Bridge for Git and Explorer for Endevor |
| 106 | +* Use VS Code’s built-in Git interface to clone source code from CA Endevor using Endevor’s Bridge for Git. |
| 107 | +* Edit COBOL code using COBOL Language Support, taking advantage of all the coding assistance provided by the extension. |
| 108 | +* Use VS Code’s built-in Git interface to push, pull and merge changes. |
| 109 | +* Search and browse additional code elements in the entire map of Endevor using the Explorer for Endevor extension. The COBOL Language Support extension provides syntax awareness for COBOL elements. |
| 110 | +* Download code elements, including their dependencies, into the current workspace using the Explorer for Endevor extension, and synchronize them with the Git project if code modifications are needed. |
62 | 111 |
|
63 | 112 | ### Debugger for Mainframe |
64 | 113 |
|
65 | 114 | * Provide InterTest server location, CICS region, credentials and program/transaction name (either by file or input form). |
66 | | -* Obtain the listing and define breakpoints. |
67 | | -* Start a debug session after triggering the CICS transaction. |
68 | | -* Display variable values and change variable values |
69 | | -* Stop at designated breakpoints, continue from designated breakpoint and step through the listing. |
70 | | -* Close debug session. |
| 115 | +* Obtain the listing and set breakpoints. |
| 116 | +* Trigger the CICS transaction and start a debug session. |
| 117 | +* Display and change variable values. |
| 118 | +* Stop at designated breakpoints, continue from a designated breakpoint and step through the listing. |
| 119 | +* Close the debug session. |
| 120 | + |
| 121 | +### Zowe Explorer and Zowe CLI |
| 122 | + |
| 123 | +* Access mainframe files and execute jobs, either from an interactive graphical interface or in the terminal with CLI. Whether you want to view a PDS, allocate a dataset, change a JCL, submit a mainframe compile, or download and upload files, both interfaces provide these capabilities. |
0 commit comments