Monorepo for all CICS related APIs and Apps built by Zowe Clients
Home Page: https://www.zowe.org/
License: Eclipse Public License 2.0
Discuss with CICS COBOL developers and other users which resources may be most beneficial for their use case in addition to the current 'Programs', 'Local Transactions' and 'Local Files' and implement them.
The content you are editing has changed. Please copy your edits and refresh the page.
Create profile https://github.com/zowe/vscode-extension-for-cics#create-profile states ...The connection must point to a CICS region's CICS Management Client Interface (CMCI) TCP/IP host name and port number. The region can be a WUI server in a CICSPlex, or else a stand-alone Single Management Application Programming (SMSS) region. Would be helpful to make the CICS z/OS pre-reqs more visible (feedback from CICS BP conference).
I want to make use of the @zowe/cics API in a new plug-in, I'm struggling to do so as the CicsSession class isn't part of the exported API. CicsSession is what's used to create the session object that is then referenced in the API functions, without it the API isn't very accessible.
I have been able to copy the logic from CicsSession.createBasicCicsSession() into my own code, it just seems an odd requirement to have to do that. Perhaps the logic for creating the session instance could be moved into a utility class that is part of the API? That would make it consistent with the equivalent code in the zosmf API.
On a related note, there may be a bug in CicsSession.createBasicCicsSession(); I found the following line of code:
password: profile.pass,
only worked in my copy of the code when I changed it to:
password: profile.password,
I imagine this is related to issue zowe/zowe-cli-cics-plugin#13.
Note: this issue is not directly linked to the development of the CICS extension
Allow users to define and install their CICS TCPIPService
helpful info
https://www.ibm.com/support/knowledgecenter/SSGMCP_5.5.0/reference/cpsm-restables/TCPDEFtab.html
Low Priority: The majority of GIFs in the README.md file are outdated in terms of the icons that are used for resources. Update them with newer screen recordings.
If we have the following 4 programs loaded:
and we click on "View 4 more..." to obtain 8 program resources in total now:
If a disable command is applied on one of the subsequently loaded programs, the state of the program resource goes back to showing 4 rather than keeping 8 resources in the viewing stage and the user would have to click "View 4 more..." to see the disabled program.
When a CICS profile is created for a CICSPlex region, the --cicsPlex value is set to the plex name and the --regionName set to one of the plex's regions, allowing a query like
zowe cics getResource CICSProgram --cicsPlex PLEX1 --regionName REGION1 to show all programs in REGION1 in the plex. The REST API constructed is a get request CICSSystemManagement/CICSProgram/PLEX1/REGION1.
Customers with plexes group regions together in system groups, using the table CICSSystemGroup. This can be used as the last segment of the URL, so if there is a system group AORS or FORS or ALLGRP (the name is up to the user to define), then a valid query is CICSSystemManagement/CICSProgram/PLEX1/AORS where the system group can be used in place of the regionName. In the CMCI documentation this is known as scope, that can be either a region or a system group.
Doing some tests it's possible to specify a system group in the --regionName attribute.
This issue is to change the imperative documentation so that the description for --regionName lets users know that it can be a region or a system group.
If SMSS system is in use, there is an unneeded tree with the Region Applid.
If the system is an SMSS system, append the region applid to the profile node label and show programs, transactions and localfiles directly underneath.
The Zowe Explorer for IBM CICS extension should support other plugins to access useful properties of CICS resources and extend its capabilities.
It should provide an API for other VS Code extension to contribute such implementations.
Allow the user to view DB2 transactions and filter / show attributes and purge
When a CICS profile is created you need to specify a --region-name (if it's an SMSS managed region) and also a --cicsPlex if it's part of a plex
These can be queried, which means that it's possible to just connect to host:port and then return the scope/region for SMSS and also the CICSPlexnames if the plex isn't specified.
Allow an SMSS connection to not have to specify the --region-name
Allow a CICS Plex connection likewise to have the plex name as optional. Also add the ability to get the plexes, e.g. zowe cics get CICSPlexes
Also, when you are connected to plex there is no reason to set a --region-name scope as you can retrieve all of the regions for a plex.
zowe cics get resource CICSCICSplexList
This should work, however it fails because it insists that a regionname is added which is actually invalid
Use error message structure provided through the ZE APIs for CICS extension error message.
Snippet from FTP extension which uses the desired structure:
ZoweVsCodeExtension.showVsCodeMessage(
"Zowe Explorer was modified for FTP support.",
MessageSeverityEnum.INFO,
ZoweLogger
);
The CICS extension does not create a CICS view on a Windows machine. Investigate why this is happening and which operating systems/platforms are affected.
The graphic
is using an old CICS logo.
We have been told there is a newer graphic, so this issue is to track getting the newer graphic and creating a new overlay with the Zowe icon and updating the one used in the marketplace branding
Currently, when right-clicking 'Show Attributes' on a Region, the data is retrieved from a CICS 'Regions' table if the region is not part of a CICS Plex, whereas regions in a plex hit the 'Managed Regions' table.
Users may want to see attributes from the 'Regions' table e.g. Max tasks as well as attributes from 'Managed Region' table.
Idea 1
Idea 2
** Problem **
A User was trying to connect and had their password wrong, but didn't get any visual feedback so it was revoked after a few attempts and they needed to get it reset
** Solution **
Show the 401 error message (which the rNext Zowe Explorer has) but also deal with 401 specially to let the user know it's because authentication failed with bad credentials.
It could be good also to have an "Open Profile" button against the error message to allow the user to quickly open their profile and remedy the password.
With TSO login it's possible to distinguish between bad user ID and bad password, however for the 401 response from CICS it may not be possible to separate the two conditions, so the error message should mention Invalid credentials (wrong userID or password)
Currently the tree shows ManagedRegion. MAXTASK is an attribute on the CICS region table however.
Possible Design
Have "Show Managed Attributes" and also "Show Region Attributes" to allow opening of the attributes page for each of the base tables.
Hi, I'm the lead developer of CICS Explorer at IBM, and I wanted to test the water to see if you would welcome contributions to expand the API covered by the CIC CLI plugin.
We use a lot of code generation technology in CICS Explorer to generate a Java model of CPSM's API. The code generator operates on a meta-model of CPSM's API, something like, but definitely not, an OpenAPI spec, I guess. I've toyed around with adapting this code generator in the past to generate TypeScript. I was taking a look at your CLI plugin, and I figured it'd probably be possible to generate support for more resource types and more actions. I guess this could potentially be all resource types and actions, though some will be more complicated than others!
Let me know if you're interested. This definitely doesn't constitute a promise, but we could at least do a little investigation and see how feasible it would be. Thanks!
With the addition of more resources, users should be able to choose which resources they see in their CICS view via Settings (UI).
Proposed UI: Users open Settings (UI) and then can select/unselect checkboxes to choose which resources to display. They should be able to then apply these changes by refreshing the window.
Changes required:
Allow users to define and install their CICS PIPELINEs
helpful info
https://www.ibm.com/support/knowledgecenter/SSGMCP_5.5.0/reference/cpsm-restables/PIPEDEFtab.html
add CICSDb2Transaction in the src/api/constants/CicsCmci.constants.ts
Currently there are settings that use the name to try and build up an exclusion NOT list of resources so that when a customer opens their programs/local files/transactions they don't see the DFH*, CE*, ... ones and only see the ones that represent that application resources in the region.
Rather than using name, it may be better to use DEFINESOURCE. If by default we exclude SYSTEM and DFH* that looks as though it is more effective that using name.
We should allow a user to extend the list to include vendor DEFINESOURCE values as well.
We could model the UI based on how VS Code allows users to add filters to restrict the files they see, where values are entered and combined together, rather than have a raw CRITERIA value (which makes it more error prone as a mistake in the field value would cause a bad request to be made)
A tree node should not need to be selected for a command palette action to work. If no node is selected, prompt the user to select a profile, then allow them to choose the type and then the name of the resource to perform the command on.
e.g. After a command is chosen from command palette:
For developers who use the DISPLAY statement for debugging programs, this ends up being written to the CEEMSG JES file for the CICS job.
The request is to provide a point and shoot solution to go from a CICS region to open the CEEMSG file.
Issues to solve:
ruc.dk
Users want to do a NewCopy on definitions in a CSD and then install them into the regions managed by the CSD
Proposed Idea
Show CSDs beneath a connection. In a plex connect to every region's LOCALFILE table to work out its CSD VSAM file name and from this have a map of which CSD a region is using.
From this show the CSDs, and allow the definitions to be shown. ? How do we know which region to connect through ?
For install can we allow a single definition to be installed across all of the regions that the CSD manages ?
Allow users to define and install their CICS PIPELINEs
helpful info
https://www.ibm.com/support/knowledgecenter/SSGMCP_5.5.0/reference/cpsm-restables/WEBSVDEFtab.html
Investigate having favorites for CICS resources similar to the way Zowe Explorer does Data Sets/USS/JES where grouped resources across connections can be retrieved and actioned on
Applying a resource filter, then applying a region filter clears the original resource filter.
Possible fix: Store the resource filter on the plex so that when a region filter is applied, the resource filter can be reapplied on the filtered regions.
Visual enhancement - Consider updating the current folder icons in the CICS view to have a funnel icon next to them after a filter is applied, the same as how Zowe Explorer does it.
Have set up the CICS plugin in VScode, defined connection to a CICS WUI server, but it is not able to connect, I get an icon like red "no entry" sign
I can connect to the CICS WUI all ok from CICS SM Explorer in zOS Explorer on the same PC, so I know I have the correct settings to use to connect
Target CICS is V6.1 on zOS 2.5
VSCode is latest download as I set this up all new in last few days
Not using SSL/TLS to connect
No msgs in CICS or zOS syslog
Any advice on how to find out why cannot connect from VSCode ?
Allow users to have interaction model through web to be able to develop CICS applications.
If two systems are expanded and a command that updates the resource label, e.g. new copy, is fired on a resource that's shared between both systems, only the currently selected resource label updates. The user will need to collapse and re-expand the parent node of the element in the other system to view the change.
The updating of both profile resources should be done automatically.
Provide a way to run a CICS transaction, perhaps using a modify command on a CICS region ?
Currently the cics zowe cli only support defining the program and transaction, however, it would be helpful to provide the support of managing the other cics resources like file, library etc.
This would be helpful while using the cics zowe cli during the DevOps.
Individual resources (Program, File, Transaction) have particular icons used in the tree
It'd be good to use these icons in the attributes editor so they appear at the top of the editor and also are visible in the list of open editors when a user does a Ctrl+P
Documentation says:
--region-name | --rn (string)
The CICS region name from which to get the resources
However, the --region-name is actually a CICSPlex scope when using a CICSPlex. This is actually a good thing but should be documented to allow for newcopy across a CICSPlex.
I have installed the extension, I have my profile for CICS created and it doesn't show up and it give me this error when I try to add.
Error running command cics-extension-for-zowe.addSession: command 'cics-extension-for-zowe.addSession' not found. This is likely caused by the extension that contributes cics-extension-for-zowe.addSession.
Create a new Zowe CLI command to define a CICS BUNDLE resource (zowe cics define bundle).
The CICS bundle deployment API works really well with gradle to easily develop and deploy Java applications to CICS, however it requires the bundle definition to exist already. In sandbox environments it would be really useful to have a straightforward way to create the bundle instead of using resource builder and DFHCSDUP, or the other more traditional alternatives, and the zowe CLI would be a great option.
Like Zowe Explorer and the FTP extension 🙂 Some advantages of webpack are that it makes the VSIX install and launch faster.
Show Library resources in CICS view
We want to use LIBRARY resources in test environments to activate on-demand versions of programs in development:
the CICS test environment works with loadlibs declared in DFHRPL (they could also be declared by LIBRARY resources)
the CICS test environment is permanent and shared by all project teams
each member of a project team compiles (User Build) in a loadlib which is dedicated to the project, (the Db2 objects are common, and the Db2 PLAN contains all the packages, those of the programs in DFHRPL and those of the programs in loadlibs managed in LIBRARY, by playing on the VERSION parameter of Db2 precompilation)
to perform a test, the project team activates its LIBRARY, its programs therefore become active (with a PHASE IN)
at the end of the test, the project team deactivates its LIBRARY, it is the programs in DFHRPL which become active again (with a PHASE IN)
This is a solution that we are currently implementing as part of the switch to CI/CD mode on the mainframe.
This addresses the need to test User Builds triggered from a feature or hotfix branch in a Git workflow (Gitflow).This allows us to save on the number of CICS test environments, while waiting for a solution to virtualize these environments, (probably Wazi Sandbox).
So we need a way to easily ENAble and DISable a LIBRARY resource, or query the status of a LIBRARY resource.
We also need to list the programs contained in a LIBRARY resource (which can consist of several loadlibs) to trigger the PHASE INs.
The declaration of the LIBRARY resource is made in an automated project initialization process, and its deletion is subordinated to the end of life action of the project.
We would like Zowe CLI CICS support the LIBRARY resource :
We use LIBRARY to dynamically install new programs without altering loadlib defined by DFHRPL.
LIBRARY is defined for Application-Version, created at start of project, temporary enabled for a test, then disabled et end of the test, deleted at end of project.
Note: no alter group ?
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
Django
The Web framework for perfectionists with deadlines.
Laravel
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft
Open source projects and samples from Microsoft.
Google
Google ❤️ Open Source for everyone.
Alibaba
Alibaba Open Source for everyone
D3
Data-Driven Documents codes.
Tencent
China tencent open source team.