This blog's entries will be related to the Language Environment for z/VSE. The intention is to share news, hints & tips, technical documents or articles and provide assistance with any Language Environment related topic that might be of interest. The postings on this site are my own and don't necessarily represent IBM's positions, strategies or opinions.
Possibly little known changes have been made to the LE/PLI run-time since the LE z/VSE 1.4.6 (z/VSE 4.2) release. There are two major changes that are PL/I specific. The first, available with LE z/VSE 1.4.6 (with the PTF for APAR PM02293 installed), is a significant reduction in the PL/I "FETCH" limitations that have been imposed on PL/1 VSE users ever since LE/VSE 1.1.0. The only limitations now associated with "FETCH"ing a PL/I fetchable routine from another PL/I program are : Only external procedures can be... [More]
With this blog I would like to provide information and assistance with Language Environment on the z/VSE mainframe operating system. That is news, hints & tips, use of utilities and any LE z/VSE topic, question or issue you are interested in. My hope is that you will find this blog and the related entries a valuable resource.
For this entry I thought I would discuss the use of the vast array of language environment callable services within LE-enabled HLASM routines. Even though the manuals often only show examples of how to use these callable services with COBOL, C, or PL/1 - so long as the linkage and parameter configurations are honoured - these callable services can also be used by LE-enabled assembler routines. Just as required with use of a callable service by a High Level Language (HLL) program, an LE-enabled assembler routine can setup the... [More]
Today I thought I would make a entry on the LE z/VSE Attention Routine commands that have been available since z/VSE 4.2. How they can be used to help with tuning, "test and try" experiments and application monitoring. So long as the attention routine initialisation job has been run at IPL (and not removed/disabled) you can make quick changes to LE z/VSE run-time options "on-the-fly". Then, when you've finished, simply re-instate your system default optons. All without the need to submit or tailor any JCL. Just as there... [More]
With z/VSE 5.1 is a new release of the CEETRACE application development diagnosis tool. The new version documentation can be downloaded for free and the tool activated on any z/VSE 5.1 system from this link. http://www-03.ibm.com/systems/z/os/zvse/downloads/tools.html#ceetrace CEETRACE is designed to complement the already available LE z/VSE dump information to aid in application problem analysis by providing an execution statement history prior to any subsequent application failure similar to the previously available READY TRACE facility... [More]
After the earlier topic on obtaining a z/VSE system dump from an LE application failure, its worth discussing the same functionality, but in a more CICS specific direction. It is possible to use the CICS/TS dump CEMT commands to get CICS to produce a system dump for specific CICS and LE z/VSE abend codes. There are times when these are useful and can be a good tool for analysing a failure. But with the more technically difficult LE abends that may occur they can be taken by CICS too late and be missing vital information that is needed for a... [More]
With there being a number of new features introduced with CEETRACE and some possibly new uses for CEETRACE utilities I thought it would be a good idea to put some of these ideas into a document that can be publicly viewed on-line for reference and to demonstrate some of the capabilities now available. The first item is a document that can be treated as a summary and "hands-on" assistance for anyone either thinking about activating CEETRACE or as a enhancement feature list for those already utilising the tool. Next... [More]
Users of CEETRACE V1.2.0 (z/VSE 5.1) can now download and install the latest Fixpack B from the z/VSE website. ftp://public.dhe.ibm.com/eserver/zseries/zos/vse/download/CEETRACE_Update-V120b.zip The updates included are : ● Console message CELT022W incorrectly issued for a COBOL/VSE "main" statically calling a COBOL/VSE subroutine and subsequently a DOS/VS COBOL subroutine. If an application failure occurs subsquent to this in the COBOL/VSE "main" the program execution history trace report is... [More]
July 8, 2014 1:32 AM With z/VSE 5.2 is a new modification level, LE z/VSE V1 R4.9, which is included as part of the VSE "Central Functions" component. Available in this new modification level are a set of functional enhancements and improvements. This modification update is further complemented by CEETRACE (“optional extra”) specific enhancements. 1. Run-Unit Work Area (RUWA) Trace Control for CICS LE-Enabled Programs. A new transaction is supplied with LE z/VSE 1.4.9 (called “CRUT”) which can be used to... [More]
Users of CEETRACE V1.1.2 (z/VSE 4.3) should ensure they install the PTF for APAR PM79074 to enable the Fixpack B updates. These updates include : 1. env_validation option not producing a statement execution history report indicating the statement that was detected as causing the validation requested to fail. 2. CEETRACE will now issue a new error-level console message (CELT060E) whenever the specified environment validation testing level fails. This change will allow much easier diagnosis of storage corruptions such as Heap storage overlays... [More]
Just a quick post to note that fix-pack V1.2.0a for the LE z/VSE CEETRACE feature is now available. Summary of the updates included in the fix-pack: HEAP storage corruption/checking improvements. See section "CEETRACE Environment Validation Processing Notes" in the Installation and Users Guide for more information. Addition of message CELT060E. See the Installation and Users Guide for more information. The CEETRACE statement execution history report title has been updated to included in the CEETRACE fixpack level information. Console... [More]
After receiving a few questions related to the usefulness of the LE formatted dumps (CEE5DMP) for PL/I VSE/ESA programs I thought it would be a good subject for a blog entry. Over the years I have had a number of PL/I for VSE/ESA users comment on the lack of a formatted variable and contents section in a CEE5DMP dump produced in response to an application failure. This is in contrast to COBOL/VSE and C/VSE programs that will include a formatted variable and contents dump in any CEE5DMP dump produced when the application has been compiled with... [More]
Language Environment for z/VSE - Pieces of News, Tips and Enhancements Register for this live virtual class where you will be presented with an overview of the latest Language Environment for z/VSE features and enhancements. There will also be presentations on execution environment independant execution routines using a COBOL/VSE routine as an example. Details on what is a 4083 abend and a simple example of how to use the available information provided in the LE z/VSE formatted dump to identify the cause of the abend. Then there will be some... [More]
Welcome to the first LE z/VSE blog entry for 2014! I hope that everyone had a great break over the Xmas and New Year period. In this entry I would like to discuss performance of COBOL/VSE applications that are executed within a created re-usable run-time environment. This might be done by your own applications team or perhaps a vendor product you have installed utilises this LE z/VSE functionality to perform some or even the majority of their processing. For any relevant application that uses re-usable COBOL environments,... [More]
I thought I would discuss with my first June entry the possibly little known yet very useful CICS configuration option - RUWAPOOL - and how this can improve CICS storage usage with LE z/VSE applications. This configuration parameter instructs CICS to pre-allocate storage for LE z/VSE CICS applications from a CICS managed storage pool - RUWA. This is the "Run-Unit Work Area". When ever a CICS transaction is executed that requires LE z/VSE run-time support CICS will provide to LE z/VSE two Rununit work area storage addresses. One... [More]