cics nov title2 - cbt tape · attention needs to be paid to ensure that maxopentcbs is not set to...

48
© Xephon plc 2001 November 2001 192 3 CICS hot-pooling for Java applications – hints and tips 8 CICS load module information 11 Displaying Temporary Storage queues 25 Support for the COBOL SORT verb in CICS 46 December 1999 – November 2001 index 48 CICS news

Upload: duongliem

Post on 10-Aug-2018

215 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

© Xephon plc 2001

November 2001

192

3 CICS hot-pooling for Javaapplications – hints and tips

8 CICS load module information11 Displaying Temporary Storage

queues25 Support for the COBOL SORT

verb in CICS46 December 1999 – November 2001

index48 CICS news

Current Support
Xephon magazine issues are now supported at www.cbttape.org. Please go to www.cbttape.org if you have any support questions.
Page 2: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

2

CICS UpdatePublished byXephon27-35 London RoadNewburyBerkshire RG14 1JLEnglandTelephone: 01635 38342From USA: 01144 1635 38342E-mail: [email protected]

North American officeXephonPO Box 350100Westminster, CO 80035-0100USATelephone: 303 410 9344

Subscriptions and back-issuesA year’s subscription to CICS Update,comprising twelve monthly issues, costs£175.00 in the UK; $270.00 in the USA andCanada; £181.00 in Europe; £187.00 inAustralasia and Japan; and £185.50elsewhere. In all cases the price includespostage. Individual issues, starting with theDecember 1998 issue, are availableseparately to subscribers for £16.00 ($24.00)each including postage.

CICS Update on-lineCode from CICS Update, and completeissues in Acrobat PDF format, can bedownloaded from our Web site at http://www.xephon.com/cics; you will need tosupply a word from the printed issue.

© Xephon plc 2001. All rights reserved. None of the text in this publication may be reproduced,stored in a retrieval system, or transmitted in any form or by any means, without the priorpermission of the copyright owner. Subscribers are free to copy any code reproduced in thispublication for use in their own installations, but may not sell such code or incorporate it in anycommercial product. No part of this publication may be used for any form of advertising, salespromotion, or publicity without the written permission of the publisher. Copying permits areavailable from Xephon in the form of pressure-sensitive labels, for application to individualcopies. A pack of 240 labels costs $36 (£24), giving a cost per copy of 15 cents (10 pence).To order, contact Xephon at any of the addresses above.

Printed in England.

EditorTrevor Eddolls

DisclaimerReaders are cautioned that, although theinformation in this journal is presented in goodfaith, neither Xephon nor the organizations orindividuals that supplied information in thisjournal give any warranty or make anyrepresentations as to the accuracy of thematerial it contains. Neither Xephon nor thecontributing organizations or individualsaccept any liability of any kind howsoeverarising out of the use of such material.Readers should satisfy themselves as to thecorrectness and relevance to theircircumstances of all advice, information,code, JCL, and other contents of this journalbefore making any use of it.

ContributionsWhen Xephon is given copyright, articlespublished in CICS Update are paid for at therate of £170 ($260) per 1000 words and £100($160) per 100 lines of code for the first 200lines of original material. The remaining codeis paid for at the rate of £50 ($80) per 100lines. In addition, there is a flat fee of £30($50) per article. To find out more aboutcontributing an article, without anyobligation, please download a copy of ourNotes for Contributors from www.xephon.com/nfc.

Page 3: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

3© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

CICS hot-pooling for Java applications – hintsand tips

INTRODUCTION

CICS Transaction Server for OS/390 Release 1.3 (CICS TS 1.3)provides major performance improvements for Java applicationprograms compiled using the Enterprise Toolkit for OS/390 Compilerand Binder (also known as the High Performance Java compiler orHPJ) via a technique known as ‘hot-pooling’. Support for hot-pooling within CICS TS 1.3 was shipped and enabled via PTFUQ44003.

This article provides guidance on various aspects of hot-poolingutilization.

STACK AND HEAP STORAGE CONSIDERATIONS

For non hot-pooled Java programs, the -lerunopts option on the HPJcommand (used to compile and bind the program) can specify valuessuch as the Language Environment (LE) stack size. For hot-pooledprograms, CICS provides User Replaceable Module (URM)DFHAPH8O, where values such as stack and heap are specified.DFHAPH8O has default initial settings of 128KB for stack storageand 4MB for heap storage.

Since garbage collection is disabled for hot-pooled programs, heapstorage usage will grow with each reuse of an LE enclave until CICSdetermines that the enclave should be terminated and a new onecreated. This process is handled automatically, and is one of thefactors that determines the lifetime of a hot-pooled enclave environmentwithin CICS. You should therefore review the heap storage requirementfor your Java programs (see below). 4MB of heap storage may beinsufficient for your object requirements, and you will therefore needto increase the heap value specified within DFHAPH8O to provide alarger object storage capacity for the hot-pooled programs.

Page 4: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

4 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

DFHAPH8O is an optional URM. If it is not available for use, CICSprovides default settings for the lerunopt parameters used for the hot-pooled enclaves. These defaults are hard-coded within CICS itself. Itshould be noted that CICS TS 1.3 PTF UQ46069 has modified thehard-coded default value for stack storage from 4KB to 128KB. Thismakes the hard-coded default stack size the same as that given as theexample stack size specification within DFHAPH8O. A 4KB stacksize can lead to GETMAINs for additional stack storage by LE whena hot-pooled program is being executed, if this initial stack amountis insufficient for the program’s needs. Such additional GETMAINsrepresent an increase in CPU utilization. For this reason, you shouldensure PTF UQ46069 is applied to avoid additional GETMAIN calls/CPU overhead, if DFHAPH8O is not being used.

LE OPTIONS AND STORAGE REPORTING

You can obtain reports on LE options and storage usage for hot-pooled Java programs by respectively specifying RPTO(ON) andRPTS(ON) within DFHAPH8O. Note that the supplied version ofDFHAPH8O has these settings commented-out within the source.This means that use of the default DFHAPH8O will not generateoption and storage reports. If you wish to produce such reports whilstsetting up and testing programs in a hot-pooled environment,uncomment the two lines in the DFHAPH8O source code.

Specifying RPTO(ON) and RPTS(ON) results in additionalprocessing overhead, since the report information is written totransient data queue CESE by LE when the reports are generated ateach enclave termination. Requesting both options can result inapproximately 200 writes to the CESE queue when one pair of reportsis generated.

The supplied definition for CESE is as an extrapartition transient dataqueue that relates to destination CEEMSG.

DETERMINING HEAP STORAGE USAGE

To determine the heap usage for an enclave, one approach is to set theinitial heap size in DFHAPH8O to a small value (eg 4KB). Set

Page 5: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

5© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

RPTS(ON) as well, by uncommenting it within DFHAPH8O. Thefirst run of a hot-pooled program will use more than this amount ofheap, and so force an enclave termination. Analysis of the reportgenerated from RPTS(ON) shows how much heap storage wasactually required by this run of the program. Some example figuresare given below:

�������������

� �������������������������������������������������

������������������������������ ������������� !��!"

The storage report shows that in this example 3,174,072 bytes wererequired for the test run. The amount includes both the initial set-upof the function references for the DLLs used by the program, alongwith the object storage used by the execution of the program itself.Now set the initial heap size to its intended value (eg 10MB). Re-runthe program until another report is generated (as the result of asubsequent enclave termination after a number of reuses of theenvironment). This time, the example report is as follows:

�������������

� ����������������������������������������� ��#$!��

������������������������������ ����������� �$ �#�#

In this example, it had been observed from analysis of the CICS tracethat 57 runs of the hot-pooled program managed to use the enclavebefore it was terminated. So, 10514808-3174072 = 7340736 byteswere used by the last 56 runs, therefore each run used 131KB of heapstorage on average for (for example) object storage.

DSA LIMITS AND MAXOPENTCBS VALUES

A CICS task running a hot-pooled Java program uses an LE enclaveand an H8 Open TCB, managed by the Open Transaction Environment(OTE). Once a task has linked to a hot-pooled program, it maintainsuse of this TCB/enclave until the end of task. Each hot-pooled enclavewithin CICS is associated with a particular H8 TCB. The maximumthroughput of hot-pooled transactions in a CICS region can therefore

Page 6: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

6 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

be determined by dividing the number of available H8 TCBs by theaverage transaction response time. The number of concurrent H8TCBs that may coexist within a single CICS region depends on theavailable storage for that system. The main restriction for this isbelow-the-line (< 16MB) storage, from both the CICS DSAs and theCICS Private Area storage within the address space.

Using the default LE options as provided within URM DFHAPH8O,an H8 TCB and its associated LE enclave require 6KB of below-the-line CICS Private Area storage and 20KB of below-the-line CICSDSA storage. This storage is in addition to any existing storagerequirements that the CICS system may have.

The CICS-supplied statistics transaction STAT can be used whencalculating current storage availability in both the CICS DSA andCICS Private Area storage. The following example was taken fromsuch a STAT transaction for a CICS system that was to be used as ahot-pooled application-owning region:

%���� ��&'��()�******��+ ��,������-.�&'�(�/� �����'���

%���� ��&'��0���*******�$+ ��,

�%���� ��&'��()���1��%���� ��&'��0�����2��&'���3���-���

�+ ��,�1�$+ ��,�2���#,

Not all the available storage should be used when calculating howmany H8 TCBs could exist in a CICS system. To provide sufficientrelief from unexpectedly high demands on storage, a DSA buffer ofapproximately 500KB is recommended to be left. Therefore, assumingthat 400KB of CICS DSA may be used by hot-pooled transactions, theexample shows that (400K / 20K), or 20 H8 TCBs, could coexist withthis CICS region’s available DSA.

In the same example, using STAT to return CICS Private Area storageusage shows:

��3������������������3���-���-���4� �/5****�� +���,

1,990KB would support the 120KB requirement for 20 H8 TCBs.Again, it is recommended that a 500KB buffer of free CICS Private

Page 7: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

7© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

Area storage be left when determining Private Area availability forhot-pooling use.

OTE system tuning parameter MAXOPENTCBS limits the totalnumber of concurrent Open TCBs that may exist in a given CICSTS 1.3 system. Assuming JVMs are not being used (ie no J8 TCBsexist), MAXOPENTCBS therefore reflects the total number of H8TCBs that can coexist within a single CICS region. Therefore,attention needs to be paid to ensure that MAXOPENTCBS is not setto too high a value, and that the optimum balance between CICS DSAand Private Area storage needs to be found.

Note that you should use statistics taken at times of peak systemactivity when making this determination, since you need to know thepeak storage requirements for the current system set-up, whendetermining what additional storage availability may be exploited byhot-pooling transactions. Note also that other subsystems (eg DB2)will utilize CICS Private Area storage too.

The CICS Performance Guide gives further detailed information onJava hot-pooling, and on storage tuning within a CICS system ingeneral.

SUMMARY

The DSA limit should be adjusted to its optimum value, and thenMAXOPENTCBS be set to the lesser of (DSA available - 500KB)/20KB or (Private Area available - 500KB)/6KB. If this calculationyields too low a number of H8 TCBs to satisfy transaction throughputrequirements, one possibility is to spread the applications acrossmultiple CICS Java Application Owning Regions (JORs).

Readers wishing to discuss the material in this article further arewelcome to contact me via e-mail, at [email protected].

Andy WrightCICS Change TeamIBM (UK) © IBM 2001

Page 8: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

8 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

CICS load module information

Ken Rogers, one of our CICS Update readers, e-mailed the followingquery:

I am trying to remember the CICS transaction utility that will tell me:

1 What CICS load libraries a given CICS load module is locatedin.

2 Which one is currently being executed.

3 What the concatenation of load libraries is for a given CICSregion.

I think the easiest way to answer this question is to lead you througha set of CICS CPSM screen shots. CPSM (CICSPlex System Manager)supplies data from all attached CICS address spaces running in a TSOaddress space on the same plex as the set of CICS address spaces.

So to specifically answer Ken’s question above, go into a TSOsession, fire up the CSPM TSO End User Interface, and issue thePROGRAM command, which, after Enter is pressed, will provide thescreen shown below:

� "60("77 �� ��$$�"$�88888��9:;</���;9�&�'�(�=�88888888888881

�%;//�9&��222>�����������������������������������������'%<;((�222>���?�

�%0<<�@�9�222>� ���������(��@�9�222>

�>@ �2�<;?<�/222222222�6�(A2222�6�(A2222 "60("77 22 ��$��$�22%�'/22222!�

�%/&�������)��%�%'�� �-����0������%���� ��������)���'�������%�&:���%��.

�8�9�)�88��'.���)8�'�����8�%�� �8�0��88�(� �����1�'�������;��� �<�B���

��=0�C;/&��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C;'���=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C;',��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C;''��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C�?���=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C�?,��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C�?'��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C�����=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C��,��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C��'��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C�6���=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C�6,��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C�6'��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

Page 9: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

9© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

��=0�C�/���=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C�/,��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C�/'��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C�'���=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

��=0�C�',��=%@D%?:��9�5(�&��7�������7��''�/5(�<��<�C����9;%�&:�9;�<�E0

If we wanted information on program EYUTVOMD, tab down thedisplay till the cursor is under its name and hit Enter. The followingdetail screen results:

"60("77 �� ��$��$��88888��9:;</���;9�&�'�(�=�88888888888881

%;//�9&��222>�������������������������������������������'%<;((�222>���?�

%0<<�@�9�222>� ���������(��@�9�222>

F@ �2�<;?<�/22�<;?<�/&2�6�(A222�6�(A222 "60("77 22 ��$��$�222%�'/222222

����%�%'�'.���)***�����=%@D%?:�%����0���% �*���������� 7

�����G��,�.******�%�%'�A�%,�=�����0���% �**����������

�����G���� �'��*�����:0((����0���� �� �3�*����������

����/�������� �*�������������9�4��.�% �**�����������7

����'������'�����*������<�C����<�)�3���% �**�����������7

����(��H'C��'���**������9;�(���:����% �****�����������

����%���� ��(�***��������<&'��<�(�9�)-��***�����������#

���������'�����***������9;�;(&�<�)����9�)�**

����:�����)�****�77�77�77*7 �<�)����'.��*

�����3��:�����)��77�77�77*7 �%��.�<�B�����9;�<�E0�<�&

����%� ���� .***���E0�'�<�9��<� �)�******����9;9(��!7

����6C/�&�-��*****�����9;&�50?

����6C/����I��***����&:�6C/�<

The answer to question 2 lies in the RPL number – 8 in this case. Tabdown to this field and hit Enter. The following screen results,detailing the RPL concatenation; so 8 maps to BLDBSF.PLUXA.SEYULOAD – so answering question 3:

� "60("77 �� ��$��$7�88888��9:;</���;9�&�'�(�=�88888888888881

�%;//�9&��222>������������������������������������������'%<;((�222>���?�

�%0<<�@�9�222>� ���������(��@�9�222>

��@ �2<�((�'�&222222�6�(A2222�6�(A2222 "60("77 22 ��$��$7222%�'/222222"7

��<�(�%�%'�����&������

��9�)�'.���)8�9�)�888888888888888888

����7��=%@D%?:�%�'/&�C*�6;�9';*(;�&

���� ��=%@D%?:�%�'/&�C*��'�*(;�&

����"��=%@D%?:�%�'/&�C*5':*(;�&

�������=%@D%?:�%�'/&�C*&0//=*(;�&

�������=%@D%?:�0�(*�6;�9';*(;�&

����$��=%@D%?:�%�'/&�C*��5(��"7*(;�&

�������=%@D%?:��05�(0*%�'/*(;�&

����!��=%@D%?:��05�(0*%�'/*��5(�'

����#��=%@D%?:�5(&5':*�(0A�*'�=0(;�&

�������=%@D%?:���*�&(��!7*;'��7" 7*'%��%�%'

Page 10: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

10 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

��� 7��=%@D%?:���*�&(��!7*;'��7" 7*'%��<09

��� ��=%@D%?:���*�(�*C"�7*�(�5�'�

��� "��=%@D%?:���*�(�*C"�7*�(�(�9,

��� ���=%@D%?:���*�(�*C"�7*'�5/5�'�

��� ���=%@D%?:�5(&5':*�(0A�*'&:�(;�&

��� $��=%@D%?:�5(&5':*�(0A�*'&:�(;�&

��� ���=%@D%?:�5(&5':*�(0A�*'&:�(;�&

��� !��=%@D%?:�5(&5':*�(0A�*'&:��0��

To find which libraries a given program is located in, you could usethe above list of libraries and search them via the library list utilityunder TSO (via cut and paste into a split screen). An alternativeprogramming solution could use the EXEC CICSPlex SM applicationProgramming Interface – see CICS Update, Utilizing the power of theCICSPlex SM Web User Interface, Issue 191, October 2001.

Andy KrasunIBM (UK) © IBM 2001

Contributing to CICS Update

If you have ever experienced any difficulties with CICS, ormade an interesting discovery, you could receive a cashpayment, a free subscription to any of our Updates, or a creditagainst any of Xephon’s wide range of products and services,simply by telling us all about it.

If you’re interested in writing an article, but not sure what on,then visit the CICS Update Web site, http://www.xephon.com/cics, and follow the link to Opportunities for CICSspecialists. Here you’ll find a list of topics that readers haveasked us for more articles about.

Articles can be e-mailed to Trevor Eddolls at [email protected]. A copy of our Notes for Contributors is availablefrom www.xephon.com/nfc.

Page 11: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

11© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

Displaying Temporary Storage queues

CICS provides CEBR as the standard transaction for the visualizationof temporary storage queues. However, you must know beforehandthe name of the queue you want to browse. If you are not sure whatqueue you are looking for, then it can be difficult to find what youwant, specially if the number of queues in the system is large.

To solve this problem, I created a program that shows all the TSqueues in a CICS region, along with each one’s characteristics, as youcan see below. To browse a queue, just put the cursor in the respectiveline and press Enter. The queue browsing is limited to the first 78characters of each line, but that should be sufficient in most cases. Ifyou need more complete browsing, then call CEBR for that queue.When you are in the visualization screen, you can jump directly to aspecific line item by placing the desired item number in the Item Nrfield that appears on top of it.

This application consists of a program (TSVIEW) and two BMSmaps – one to show the queue names (TSVIEW1) and the other todisplay them (TSVIEW2). You can assign TSVIEW any transactionyou want, because the program always returns to whatever transactionit was called by.

An example of the queue list screen is shown below:

� J111111111111111111111111111111111111111111111111111111111111111111111111J

�K������������������������������������������������������������������������K

�K����E�������������)����(���������� ����/�G����/ ��������������%�%'!#��K

� K111111111111111111111111111111111111111111111111111111111111111111111111K

�K������(�$������7777"����0A����7777 "#���77�����77�����������������������K

�K����5�(�$$7����777""����0A����777�$$7���7 "#���77�����������������������K

�K����5�' 7����77$7 ����0A����777$������77�����77�����������������������K

�K����5�' ����77�""����0A����77 � "#���7 "#���77�����������������������K

�K����5�' $����7777�����0A����77$� "#���77�����77�����������������������K

�K����5�' �����777 "����0A����777$$"#���7 "#���77�����������������������K

�K����5�' !����7$"�"����0A����77"� "#���7 "#���77�����������������������K

�K����5�' #����7777�����0A����77777"#���77�����77�����������������������K

�K����5�' �����77�7"����0A����77$7 "#���7 "#���77�����������������������K

�K����5�' "7����77$������0A����777�7�����77�����77�����������������������K

�K����5�' " ����77"7"����0A����77$$ "#���77�����77�����������������������K

�K����5�' ""����7 "7 ����0A����77"�7�����77�����77�����������������������K

�K����5�' "�����7777�����0A����7777������77�����77�����������������������K

Page 12: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

12 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

�K����5�' �77����777#!����0A����7777������77�����77�����������������������K

�K����%:< 777����77�$�����0A����777�#!����77�����77�����������������������K

�K����%:< 77 ����777������0A����777�7�����77�����77�����������������������K

�K����%:< 77�����7777!����0A����7777������77�����77�����������������������K

�K����%:< 77����777 ����0A����77777�!���77�����77���������:!����3�������K

�K����%:< 7 ����777!�����0A����777� �����77�����77���������:#�9�G��������K

�K���5/DD�777����77��!���/��9���777�� "���7 "#���7 "#�������:���G��������K

� K111111111111111111111111111111111111111111111111111111111111111111111111K

�K������������������ �I�� ���I���B������ ���������9��<���������.������K

�K������������������������������������������������������������������������K

� J111111111111111111111111111111111111111111111111111111111111111111111111J

TSVIEW SOURCE CODE

��������&�9��:�%���;9�&�C�'�;9*

��������<;?<�/1�&*��'C��@*

������L222222222222222222222222222222222222222222222222222222222222222L

��������9C�<;9/�9��&�C�'�;9*

�������&����&�C�'�;9*

�������@;<,�9?1'�;<�?��'�%��;9*

�������!!��(�A;������������������%�A�����C�(0��'��%�*

�������!!��A���������������������%�������%;/��C�(0��7*

�������!!��=���������������������%�������%;/��C�(0��7*

�������!!��D���������������������%�������%;/��C�(0��!#*

�������!!��D ��������������������%�������%;/��C�(0��!#*

�������!!��E�(�/�����������������%�������%;/��C�(0�� 77*

�������!!��%0<�;'����������������%�'��"��C�(0��J7*

�������!!��%;//�<��(�������������%�������%;/��C�(0����77*

�������!!��'%<��9 1(�9�'���������%�������%;/��C�(0��"7*

�������!!��'%<��9"1(�9�'���������%�������%;/��C�(0��"7*

�����������%;�=�&:���&*

�������7 ��@;<,1:��(&'*

�����������7"����A�*

��������������7����:�((�<������������%�A���*

��������������7�����A�190/���/'������%���$�*

��������������7����:�((�<������������%�A���*

��������������7�����A�1(;%���;9������%�A���*

��������������7����:�((�<������������%�A���*

��������������7�����A�1:(�9?���������%���!�*

��������������7����:�((�<������������%�A���*

��������������7�����A�1/�A(����������%�����*

��������������7����:�((�<������������%�A���*

��������������7�����A�1/�9(����������%�����*

��������������7����:�((�<������������%�A�!�*

�����������7"����'1:��(&'*

��������������7�����'1E0�0�����������%�A�#�*

��������������7�����'190/���/'�������%�'������%;/�*

��������������7�����'1:(�9?����������%�'��#���%;/�*

Page 13: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

13© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

��������������7�����'1(;%���;9�������%�'��#���%;/�*

��������������7�����'1/�A���/(�9�����%�'������%;/�*

��������������7�����'1/�9���/(�9�����%�'������%;/�*

��������������7����:�((�<������������%�A�$��*

�����������7"���@1<�'����������������%�'��#���%;/�*

�����������7"���@1<�'�"��������������%�'��#���%;/�*

�����������7"���@190/�<�%#�����������%���#�*

�����������7"���:�((�<�<�&�:�9�'�@190/�<�%#*

��������������7����:�((�<������������%�A*

��������������7����@190/�<�%!��������%���!�*

�����������7"���:�((�<�<�&�:�9�'�@190/�<�%#*

��������������7����:�((�<������������%�A���*

��������������7����@190/�<�%$��������%���$�*

�����������7"���:�((�<�<�&�:�9�'�@190/�<�%#*

��������������7����:�((�<������������%�A���*

��������������7����@190/�<�%���������%�����*

�������7 ��%;//�<��*

�����������7"���'�(:(�?��������������%��*

�����������7"���9�A�1E0�0������������%�A�#�*

�����������7"���E0�0�1&�'�(�=��������%�A�#�*

�����������7"���E19<�%A��������������%�A�$�*

�����������7"���E19<�%��<�&�:�9�'�E19<�%A���%���$�*

�����������7"���E0�0�19<�%'����������%�'�����%;/�*

�����������7"���E0�0�1���/�����������%�'�����%;/�*

�����������7"���E0�0�1�A�<�����������%�'�����%;/�*

�����������7"���E��������������������%�'�����%;/�*

�����������7"���E0�0�1:�((�<���������%�A�#77�*

�����������7"���E0�0�1��5(��<�&�:�9�'�E0�0�1:�((�<

�������������������������������������%�A�#��;%%0<'� 77*

�����������7"����'C��@ �*

��������������7����:�((�<������������%�A� "�*

��������������7����'�'�&(������������%�'�����%;/�*

��������������7����'�'�&�������������%�A*

��������������7����'�'�&�������������%�A�#�*

��������������7����'%<��9 1(�9���;%%0<'�"7*

�����������������7���%/&(������������%�'�����%;/�*

�����������������7���%/&�������������%�A*

�����������������7���%/&�������������%�A���*

�����������������7���E0�(������������%�'�����%;/�*

�����������������7���E0��������������%�A*

�����������������7���E0��������������%�A�#�*

�����������������7����A�(������������%�'�����%;/�*

�����������������7����A��������������%�A*

�����������������7����A��������������%�A����*

�����������7"����'C��@ ;�<�&�:�9�'��'C��@ ����%�A� ����*

�����������7"����'C��@"�*

��������������7����:�((�<���%�A� "�*

Page 14: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

14 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

��������������7����E9�/�"(�����������%�'�����%;/�*

��������������7����E9�/�"������������%�A*

��������������7����E9�/�"������������%�A�#�*

��������������7����'���/"(�����������%�'�����%;/�*

��������������7����'���/"������������%�A*

��������������7����'���/"������������%���$�*

��������������7����'%<��9"1(�9���;%%0<'�"7*

�����������������7���E(�9�(����������%�'�����%;/�*

�����������������7���E(�9������������%�A*

�����������������7���E(�9������������%�A�!#�*

�����������7"����'C��@";�<�&�:�9�'��'C��@"����%�A� �$ �*

�����������7"���:�((�<���������������%�A�$77�*

������L

�������(�9,�?��'�%��;9*

������L222222222222222222222222222222222222222222222222222222222222222L

�������7 ��&:�%;//�<��*

�����������7"��:�((�<�������������%�A��777�*

������L222222222222222222222222222222222222222222222222222222222222222L

��������<;%�&0<��&�C�'�;9*

������L222222222222222222222222222222222222222222222222222222222222222L

������L

�����������/;C��(;@1C�(0�'��;�@;<,1:��(&'�%;//�<��*

������L

�������:�<'�1��/�1;9(=*

������L2222222222222222L

������������:���5%�(�9�2�7

���������������A�%�%�%'��''�?9����(�&��'�'�&��

���������������9&1�A�%

��������������/;C�� ��;�E�

��������������/;C��'��%�'��;�E0�0�1:�((�<

����������������<:;</�9�A�1��?�

����������������<:;</�?��1:�<'�1:;<@�<&

����������������<:;</�'�9&1/��

��������������/;C�� ��;�'�(:(�?

��������������?;��;�<��0<91�<�9'�&

������������9&1�:*

������L

�������;���<1��/�'*

������L22222222222L

�����������/;C��&:�%;//�<����;�%;//�<��

������������:�'�(:(�?�2�

����������������<:;</�<�%��C�1/��

���������������:���5��&�2�&:��9��<

�������������������<:;</�%��%,1%;//�9&

���������������9&1�:

���������������:���5��&�2�&:��:!�;<���5��&�2�&:��: �

������������������:�E��>�

��������������������'05�<�%�� �:<;/�E�

������������������9&1�:

�����������������/;C��E0�0�1��5(��E����;�9�A�1E0�0�

Page 15: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

15© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

�������������������<:;</�9�A�1��?�

���������������9&1�:

���������������:���5��&�2�&:��:#�;<���5��&�2�&:��:"7

������������������:�E��F�E�(�/��

���������������������&&� ��;�E�

������������������9&1�:

�����������������/;C��E0�0�1��5(��E����;�9�A�1E0�0�

�������������������<:;</�9�A�1��?�

�������������������<:;</�?��1:�<'�1:;<@�<&

���������������9&1�:

����������������<:;</�'�9&1/��

��������������?;��;�<��0<91�<�9'�&

������������9&1�:*

������������:�'�(:(�?�2�"

����������������<:;</�<�%��C�1/��"

���������������:���5��&�2�&:��:!�;<���5��&�2�&:��: �

�������������������<:;</��<�C1��?�"

���������������('�

�������������������<:;</�9�A�1��?�"

���������������9&1�:

����������������<:;</�'�9&1/��"

��������������?;��;�<��0<91�<�9'�&

������������9&1�:*

������L

������L222222222222222222222222222222222222222222222222222222222222222L

������L����'�-���� ��

������L222222222222222222222222222222222222222222222222222222222222222L

������L

�������9�A�1��?� *

������L2222222222L

�������������<:;</�%(��91'%<��9 �C�<=�9?�A�:<;/� �5=�

�������������������09��(�A�>�'%<��9 1(�9�'

������������A�%�%�%'��9E0�<���'E0�0��'��<�

������������9&1�A�%

�����������/;C��7��;�A

�������������<:;</�(;�&1'%<��9 ���<0�(;�&1'%<��9 1�A��

�������������������09��(�A�>�'%<��9 1(�9�'*

������L

�������(;�&1'%<��9 *

������L222222222222L

������������A�%�%�%'��9E0�<���'E0�0��������'1E0�0��

�����������������������������90/���/'������'190/���/'�

�����������������������������:(�9?���������'1:(�9?���

�����������������������������(;%���;9������'1(;%���;9�

�����������������������������/�A���/(�9����'1/�A���/(�9�

�����������������������������/�9���/(�9����'1/�9���/(�9�

�����������������������������<�'����������@1<�'��

�����������������������������<�'�"��������@1<�'�"�

�����������������������������9�A�

Page 16: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

16 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

������������9&1�A�%

������������:�@1<�'�"�>�7

��������������/;C��" ��;�A

��������������?;��;�(;�&1'%<��9 1�A��

������������9&1�:*

������������:��'1E0�0��F�9�A�1E0�0�

��������������?;��;�(;�&1'%<��9 1�A��

������������9&1�:*

������������&&� ��;�A

������������:�A�>�'%<��9 1(�9�'

��������������?;��;�(;�&1'%<��9 1�A��

������������9&1�:*

������������:��'1(;%���;9�2�&:�C�(0��/��9�

��������������/;C��M/��9M���;���A�1(;%���;9

������������9&1�:*

������������:��'1(;%���;9�2�&:�C�(0���0A�(��<=�

��������������/;C��M�0A�M���;���A�1(;%���;9

������������9&1�:

�����������/;C����'190/���/'�����;��@190/�<�%#

�����������/;C���@190/�<�%$������;���A�190/���/'

�����������/;C����'1:(�9?��������;��@190/�<�%#

�����������/;C���@190/�<�%!������;���A�1:(�9?��

�����������/;C����'1/�A���/(�9���;��@190/�<�%#

�����������/;C���@190/�<�%�������;���A�1/�A(

�����������/;C����'1/�9���/(�9���;��@190/�<�%#

�����������/;C���@190/�<�%�������;���A�1/�9(

�����������/;C����A��������������;���A���A�

�����������/;C����'1E0�0���������;��E0���A�*

������L

�������(;�&1'%<��9 1�A��*

������L22222222222222222L

������������A��*

������L

�������%(��91'%<��9 *

������L2222222222222L

�����������/;C��'��%�'��;��A���A���A��E0���A��%/&��A�*

������L

�������?��1:�<'�1:;<@�<&*

������L22222222222222222L

������������A�%�%�%'��9E0�<���'E0�0����'1E0�0��

������������9&1�A�%

������������:�E��F�E�(�/��

���������������&&� ��;�E�

������������9&1�:

�����������/;C���'1E0�0���;�E0�0�1��5(��E��

�����������'05�<�%�� �:<;/�E�*

������L

�������%��%,1%;//�9&*

������L2222222222222L

�����������%;/�0���%0<�;'�2���5%�;'9�H�#7�1� *

Page 17: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

17© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

������������:�%0<�;'�?<����<�7��9&

��������������%0<�;'�9;��?<����<�'%<��9 1(�9�'

��������������/;C��E0���%0<�;'���;�E0�0�1&�'�(�=�E9�/�"�

��������������/;C��MLM��;�%/&��%0<�;'�

��������������/;C���A���%0<�;'����$���;�E19<�%A

��������������/;C��E19<�%���;�E0�0�19<�%'

��������������/;C��"��;�'�(:(�?

��������������/;C�� ��;�E0�0�1���/

��������������/;C��7��;�E0�0�1�A�<�

����������������<:;</�9�A�1��?�"

����������������<:;</�'�9&1/��"

��������������?;��;�<��0<91�<�9'�&

������������9&1�:*

������L

�������9�A�1��?�"*

������L2222222222L

������������:�'���/"(�>�7��9&�'���/"��90/�<�%

���������������:�'���/"��>�7��9&�'���/"��F�E0�0�19<�%'

�����������������/;C��'���/"���;�E0�0�1���/

���������������9&1�:

���������������:�'���/"��>�E0�0�19<�%'

�����������������'05�<�%�� ��:<;/�E0�0�19<�%'�?�C�9?�E0�0�1���/

���������������9&1�:

���������������:�'���/"��F�

�����������������/;C�� ��;�E0�0�1���/

���������������9&1�:

������������9&1�:

������������:�E0�0�1���/�(�''�

��������������/;C�� ��;�E0�0�1���/

������������9&1�:

������������A�%�%�%'��?9;<��%;9&���;9�(�9?�<<

������������9&1�A�%

�������������<:;</�%(��91'%<��9"�C�<=�9?�=�:<;/� �5=�

����������������09��(�=�>�'%<��9"1(�9�'

�������������<:;</�(;�&1'%<��9"���<0�(;�&1'%<��9"1�A��

����������������C�<=�9?�=�:<;/� �5=� �09��(�=�>�'%<��9"1(�9�'

������������:�E0�0�1���/�>�E0�0�19<�%'

��������������/;C��'���/"���;�E0�0�1���/

��������������/;C��"7��;�E0�0�1�A�<�

������������9&1�:*

������L

��������<�C1��?�"*

������L2222222222L

�����������'05�<�%���7�:<;/�E0�0�1���/

������������&&�E0�0�1�A�<���;�E0�0�1���/

�����������/;C��7��;�E0�0�1�A�<�

������������:�E0�0�1���/�(�''�

��������������/;C�� ��;�E0�0�1���/

������������9&1�:

������������A�%�%�%'��?9;<��%;9&���;9�(�9?�<<

Page 18: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

18 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

������������9&1�A�%

�������������<:;</�%(��91'%<��9"�C�<=�9?�=�:<;/� �5=�

����������������09��(�=�>�'%<��9"1(�9�'

�������������<:;</�(;�&1'%<��9"���<0�(;�&1'%<��9"1�A��

����������������C�<=�9?�=�:<;/� �5=� �09��(�=�>�'%<��9"1(�9�'*

������L

�������(;�&1'%<��9"*

������L222222222222L

������������:�E0�0�1���/�>�E0�0�19<�%'

��������������?;��;�(;�&1'%<��9"1�A��

������������9&1�:

������������:�=�2�

��������������/;C��E0�0�1���/��;�'���/"�

������������9&1�:

�����������/;C��D��;�D

������������A�%�%�%'�<��&E��'�E0�0���E0�0�1&�'�(�=�

���������������������������������/���E0�0�1���/�

�������������������������������9�;���E(�9���=��

������������������������������(�9?���D �

������������9&1�A�%

������������&&� ��;�E0�0�1���/*

������L

�������(;�&1'%<��9"1�A��*

������L22222222222222222L

������������A��*

������L

�������%(��91'%<��9"*

������L2222222222222L

�����������/;C��'��%�'��;�E(�9���=�*

������L

�������<�%��C�1/�� *

������L222222222222L

������������A�%�%�%'�<�%��C��/���M�'C��@ M�

������������9&1�A�%*

������������:���5��&�2�&:��:��;<���5��&�2�&:��: $

��������������?;��;��A��1�<;?<�/

������������9&1�:*

������L

�������'�9&1/�� *

������L222222222L

������������A�%�%�%'�'�9&�/���M�'C��@ M���<�'�

������������9&1�A�%*

������L

�������<�%��C�1/��"*

������L222222222222L

������������A�%�%�%'�<�%��C��/���M�'C��@"M�

������������9&1�A�%*

������������:���5��&�2�&:��:��;<���5��&�2�&:��: $

��������������/;C�� ��;�'�(:(�?

����������������<:;</�'�9&1/��

Page 19: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

19© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

��������������?;��;�<��0<91�<�9'�&

������������9&1�:*

������L

�������'�9&1/��"*

������L222222222L

������������A�%�%�%'�'�9&�/���M�'C��@"M���<�'�

������������9&1�A�%*

������L

�������<��0<91�<�9'�&*

������L22222222222222L

������������A�%�%�%'�<��0<9��<�9'�&�����5�<9�&�

����������������������������%;//�<����%;//�<���

����������������������������(�9?������%;//�<��(�

������������9&1�A�%*

������L

��������A��1�<;?<�/*

������L222222222222L

������������A�%�%�%'�'�9&�:<;/�(�A;��(�9?��� ���<�'�

������������9&1�A�%

������������A�%�%�%'�<��0<9

������������9&1�A�%*

�����������?;5�%,*

TSVIEW1 SOURCE CODE

/��'�����&:�/'&��=��2N'='��</+/;&�2�9;0�+%�<(2�:<��,5�+����������������L

���������������(�9?2%;5;(+��;��:A2=�'+�A����2/��;9(=

L

�'C��@ ��&:�/&��'�D�2�"�+#7�

L

���������&:�/&:��;'2�7 +7��+(�9?��2��+���<52��',��+�<;��+��������������L

���������������%;(;<2�0<E0;�'�+����������������������������������������L

����������������9����(2ME�������������)����(���������� ����/�G����/ M

'�'�&����&:�/&:��;'2�7 +�#�+(�9?��27#+���<52��<;�+:'���+���������������L

���������������%;(;<2&�:�0(�

L

���������&:�/&:��;'2�7"+7 �+(�9?��2!�+���<52��',��+�<;��+��������������L

���������������%;(;<2<�&+����������������������������������������������L

����������������9����(2M88888888888888888888888L

���������������88888888888888M

L

%/&7 ����&:�/&:��;'2�7�+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0�7 ����&:�/&:��;'2�7�+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A�7 ����&:�/&:��;'2�7�+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/&7"����&:�/&:��;'2�7�+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

Page 20: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

20 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

���������������%;(;<2<�&

E0�7"����&:�/&:��;'2�7�+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A�7"����&:�/&:��;'2�7�+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/&7�����&:�/&:��;'2�7$+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0�7�����&:�/&:��;'2�7$+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A�7�����&:�/&:��;'2�7$+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/&7�����&:�/&:��;'2�7�+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0�7�����&:�/&:��;'2�7�+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A�7�����&:�/&:��;'2�7�+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/&7$����&:�/&:��;'2�7!+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0�7$����&:�/&:��;'2�7!+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A�7$����&:�/&:��;'2�7!+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/&7�����&:�/&:��;'2�7#+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0�7�����&:�/&:��;'2�7#+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A�7�����&:�/&:��;'2�7#+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/&7!����&:�/&:��;'2�7�+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0�7!����&:�/&:��;'2�7�+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A�7!����&:�/&:��;'2�7�+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/&7#����&:�/&:��;'2� 7+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0�7#����&:�/&:��;'2� 7+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A�7#����&:�/&:��;'2� 7+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/&7�����&:�/&:��;'2� +7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

Page 21: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

21© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

E0�7�����&:�/&:��;'2� +7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A�7�����&:�/&:��;'2� + ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/& 7����&:�/&:��;'2� "+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0� 7����&:�/&:��;'2� "+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A� 7����&:�/&:��;'2� "+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/& ����&:�/&:��;'2� �+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0� ����&:�/&:��;'2� �+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A� ����&:�/&:��;'2� �+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/& "����&:�/&:��;'2� �+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0� "����&:�/&:��;'2� �+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A� "����&:�/&:��;'2� �+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/& �����&:�/&:��;'2� $+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0� �����&:�/&:��;'2� $+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A� �����&:�/&:��;'2� $+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/& �����&:�/&:��;'2� �+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0� �����&:�/&:��;'2� �+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A� �����&:�/&:��;'2� �+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/& $����&:�/&:��;'2� !+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0� $����&:�/&:��;'2� !+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A� $����&:�/&:��;'2� !+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

���������&:�/&:��;'2� !+� �+(�9?��27 +���<52��',��+�<;��

L

%/& �����&:�/&:��;'2� #+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

Page 22: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

22 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

E0� �����&:�/&:��;'2� #+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A� �����&:�/&:��;'2� #+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/& !����&:�/&:��;'2� �+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0� !����&:�/&:��;'2� �+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A� !����&:�/&:��;'2� �+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

L

%/& #����&:�/&:��;'2�"7+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0� #����&:�/&:��;'2�"7+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A� #����&:�/&:��;'2�"7+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

���������&:�/&:��;'2�"7+���+(�9?��2 �+���<52��',��+�<;��+��������������L

���������������%;(;<29�0�<�(+������������������������������������������L

����������������9����(2M�:!����3�����M

L

%/& �����&:�/&:��;'2�" +7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0� �����&:�/&:��;'2�" +7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A� �����&:�/&:��;'2�" + ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

���������&:�/&:��;'2�" +���+(�9?��2 �+���<52��',��+�<;��+��������������L

���������������%;(;<29�0�<�(+������������������������������������������L

����������������9����(2M�:#�9�G������M

L

%/&"7����&:�/&:��;'2�""+7 �+(�9?��27�+���<52�09�<;�+:'���+�������������L

���������������%;(;<2<�&

E0�"7����&:�/&:��;'2�""+7$�+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2=�((;@

�A�"7����&:�/&:��;'2�""+ ��+(�9?��2��+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2�0<E0;�'�

���������&:�/&:��;'2�""+���+(�9?��27#+���<52��',��+�<;��+��������������L

���������������%;(;<29�0�<�(+������������������������������������������L

����������������9����(2M�:���G�M

L

���������&:�/&:��;'2�"�+7 �+(�9?��2!$+���<52��',��+�<;��+��������������L

���������������%;(;<2<�&+����������������������������������������������L

����������������9����(2M888888888888888888188888L

���������������88888888888888M

���������&:�/&:��;'2�"�+7#�+(�9?��2��+���<52��',��+�<;��+��������������L

���������������%;(;<29�0�<�(+������������������������������������������L

����������������9����(2M��������������� �I�� ���I���B������ ��������L

����������������9��<���������.��M

Page 23: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

23© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

L

���������&:�/'&��=��2:�9�(

����������9&

TSVIEW2 SOURCE CODE

/��'�����&:�/'&��=��2N'='��</+/;&�2�9;0�+%�<(2�:<��,5�+����������������L

���������������(�9?2%;5;(+��;��:A2=�'+�A����2/��;9(=

L

�'C��@"��&:�/&��'�D�2�"�+#7�

L

���������&:�/&:��;'2�7 +7!�+(�9?��27�+���<52��',��+�<;��+��������������L

���������������%;(;<2�0<E0;�'�+����������������������������������������L

����������������9����(2ME�����M

E9�/�"���&:�/&:��;'2�7 + ��+(�9?��27#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<29�0�<�(

���������&:�/&:��;'2�7 +�7�+(�9?��2 "+���<52��',��+�<;��+��������������L

���������������%;(;<2=�((;@+�������������������������������������������L

����������������9����(2M���)�9�)-���M

'���/"���&:�/&:��;'2�7 +���+(�9?��27$+���<52�09�<;�+90/+�%�+�����������L

���������������%;(;<29�0�<�(

���������&:�/&:��;'2�7 +���+(�9?��27

L

���������&:�/&:��;'2�7"+7 �+(�9?��2!�+���<52��',��+�<;��+��������������L

���������������%;(;<2<�&+����������������������������������������������L

����������������9����(2M88888888888888888888888L

���������������88888888888888M

L

E(�97 ���&:�/&:��;'2�7�+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�97"���&:�/&:��;'2�7�+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�97����&:�/&:��;'2�7$+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�97����&:�/&:��;'2�7�+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�97$���&:�/&:��;'2�7!+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�97����&:�/&:��;'2�7#+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�97!���&:�/&:��;'2�7�+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�97#���&:�/&:��;'2� 7+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�97����&:�/&:��;'2� +7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�9 7���&:�/&:��;'2� "+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�9 ���&:�/&:��;'2� �+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

Page 24: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

24 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

���������������%;(;<2&�:�0(�

E(�9 "���&:�/&:��;'2� �+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�9 ����&:�/&:��;'2� $+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�9 ����&:�/&:��;'2� �+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�9 $���&:�/&:��;'2� !+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�9 ����&:�/&:��;'2� #+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�9 !���&:�/&:��;'2� �+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�9 #���&:�/&:��;'2�"7+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�9 ����&:�/&:��;'2�" +7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

E(�9"7���&:�/&:��;'2�""+7 �+(�9?��2!#+���<52��',��+�<;�+:'���+���������L

���������������%;(;<2&�:�0(�

L

���������&:�/&:��;'2�"�+7 �+(�9?��2!$+���<52��',��+�<;��+��������������L

���������������%;(;<2<�&+����������������������������������������������L

����������������9����(2M88888888888888888888888L

���������������88888888888888M

L

���������&:�/&:��;'2�"�+ #�+(�9?��2��+���<52��',��+�<;��+��������������L

���������������%;(;<2=�((;@+�������������������������������������������L

����������������9����(2M�:�H $�<���� ������:#H"7�9�G�������:!H �����3M

L

���������&:�/'&��=��2:�9�(

����������9&

Systems Programmer (Portugal) © Xephon 2001

Circle CICS TS 1.3 control blocks wall chart

Circle, famous for its control blocks wall chart, has justcompleted the CICS TS 1.3 version. This is the mostcomprehensive yet, covering all the new Web and Socketsblocks and their connectivity, plus much more. To see athumb-nail of the chart, go to www.circle-group.com Toorder your copy please contact: USA: [email protected]: (973) 890-9331; rest of the world: [email protected] Tel: +44 (0)1273 721123.

Page 25: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

25© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

Support for the COBOL SORT verb in CICS

This article describes the process which resulted in the creation of aCICS-compatible SORT routine, callable from general purposeCOBOL programs via the SORT verb.

BACKGROUND

Some time ago I wrote a program that lists the terminals acquired bya CICS region, including information about running (or next)transaction code, user-id, and user names. The program returned theinformation in the order returned by CICS from the INQUIRETERMINAL NEXT commands.

It became obvious that the program could be more useful, especiallyfor fairly large sets of data (up to several hundred or more terminals),if the data could be sorted into other sequences, such as user name,terminal-id, network-id, or user-id.

I investigated alternatives to determine what was the easiest way tosort small amounts of data in CICS, and found from the COBOLmanuals that the SORT verb is supported under CICS when usingCOBOL for OS/390 and VM.

Having found this, and knowing that I really didn’t want to build a sortprogram from scratch, I proceeded to write the COBOL code toimplement an in-store sort using input and output procedures, asrequired for use within CICS.

The first test failed dismally, which is when I discovered that COBOLdoesn’t actually implement a sort. It just builds an interface to theDFSORT (or compatible) module ‘SORT’. My program received anabend because the SORT program could not be loaded.

I took a typically male approach at this point, trying to fix the problemwithout reading the manuals (a bad mistake). I ended up adding thesystem library containing DFSORT to my DFHRPL concatenation,and then to STEPLIB as well. At first look, this approach seemed towork. The abend went away, the data came back to the program

Page 26: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

26 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

sorted, and I had the output I wanted. I was a bit concerned though thatthere was a long delay whenever I called the sort. Further investigationfound even more problems. During the several seconds which even asmall sort (<10 records) was taking, all work within the CICS regionwas suspended. It was clear that I had a problem.

Finally doing what I should have earlier and returning to the manuals,I found that DFSORT does not have a CICS-compatible routine, andI was doing an MVS sort in my CICS region, hogging the QR TCBfor the life of the sort. This was when I discovered that IBM does notprovide a CICS-compatible sort module.

I found that third parties do have sorts for CICS available (I believethat CA-CICSort and possibly Syncsort provide a routine) but my sitewas not a user, and I could not justify the expense.

I was left with two alternatives. I could implement a callable sort, andthrow out the COBOL SORT verb, or I could implement a DFSORTand CICS-compatible sort routine myself.

I suspect that the former option would have been more sensible.

I built the sort routine.

DESIGN

Once I had decided to write the SORT module, I needed to find outwhat its interface should look like so that I could interface successfullywith COBOL. My first attempt at this failed dismally. I asked IBM toprovide the details I would need, pointing out to them that as theirCOBOL manual said that it was compatible with CICS, but theydidn’t provide a routine, they should at least give me enoughinformation so that I could write the routine. After a wait of someweeks, I received a note from the change team saying that theinformation was proprietary and was not released to customers.

Back to the manuals again, after realizing that the DFSORT manualsdocument how to write the E15 and E35 exits routines so thatDFSORT can call them. This gave me what I needed. All I needed todo was build a program that would correctly interface with routines

Page 27: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

27© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

built to the E15 and E35 specifications in the manual.

After several test routines, which I used to determine which interface(24 or 31-bit) COBOL was using, and exactly how the sort parametertext was formatted, I got down to writing the interface code. I endedup with a program that could be called by COBOL, would call the E15exit to obtain all the records, and would then call the E35 exit to returnthe records back to the program. Now I just had to solve my originalproblem – how was I going to sort the data?

SORT ALGORITHM

Realizing that sorting algorithms are well documented, I went to myuniversity texts, and found samples of various sorts. I looked atimplementing a shell sort and a heap sort, for which I had Pascal codeavailable, but then realized that someone else may already haveanswered my need. I didn’t find anything on the CBT tape, but I didfind a CICS sort routine in the November 1990 edition of CICSUpdate, Issue 60. That program implemented a tag-key quick sort,which suited my purposes, so I downloaded the source and adaptedit for my program.

The original TSQ sort program on which the sort component here isbased was credited to Safran Menachem, Systems Programmer,Mivtachim Computers (Israel), © Xephon 1990. It is downloadablefrom Xephon’s Web site at www.xephon.com/cics.

The routine has not been changed in any significant way except to addEXEC CICS SUSPEND calls after every hundred or so iterations.This is to ensure that a call to sort does not monopolize the QR TCB,or become vulnerable to an AICA abend.

Debug output is written to a TD queue. The name of the queue is codedin the program (at my site we have a standard debugging destinationcalled NBUG).

USAGE

This routine is designed to be invoked from a COBOL program using

Page 28: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

28 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

the SORT verb, and the example below shows that usage. It shouldwork correctly when called by any program meeting its interfacerequirements for invocation and E15/E35 exits. It is, however, verysensitive to the format of the parameter text and cannot handle freeformat input.

The following extract from a COBOL program shows how the sortcan be invoked:

OO

�9�0�1;0��0��'�%��;9*

:�(�1%;9�<;(*

L�1111111111111111111111111111111111111111L

'�(�%��'&� 1';<�1��</�9�(1:�(�

�''�?9��;�';<�:�(�*

&����&�C�'�;9*

L�1111111111111111111111111111111111111111L

:�(��'�%��;9*

L�1111111111111111111111111111111111111111L

'&�'&� 1';<�1��</�9�(1:�(�*

� �'&� 1';<�1��</�9�(1<�%;<&*

�$�'&� 1(;9?1,�=*

��'&� 1'�;<�1,�=*

$�'&� 1'�;<�1,�=1����%���#�*

��'&� 1,�=1:�((�<���%�A�"�"�*

�$�'&� 1&���1�<��*

��'&� 1&���15=�����%�A

;%%0<'� ��;�����

&���9&�9?�;9�<�%(�9*

OO

�<;%�&0<��&�C�'�;9*

OO

%;/�0���';<�1:�(�1'�D��2�90/<�%'

�9&1%;/�0��

%;/�0���';<�1%;<�1'�D��2

��';<�1:�(�1'�D��L�<�%(�9�

�9&1%;/�0��

OO

';<��'&� 1';<�1��</�9�(1:�(�

;9�&�'%�9&�9?�,�=�'&� 1(;9?1,�=

�9�0���<;%�&0<���'�A 1';<�1�9�0�

;0��0���<;%�&0<���'�= 1';<�1;0��0�

*

OO

A 1';<�1�9�0�*

L�11111111111111111111111111111111111111111

/;C��90/<�%'��;���?�(�/��

��<:;</�A 1<�(��'�1<�%;<&

Page 29: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

29© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

C�<=�9?�90/<�%'�:<;/� �5=�

09��(�90/<�%'�>���?�(�/��

*

L

A 1<�(��'�1<�%;<&*

L�11111111111111111111111111111111111111111

/;C��90/<�%'��;�'&� 1'�;<�1,�=1�

<�(��'��'&� 1';<�1��</�9�(1<�%;<&

*

L

A1';<�1�A��*

L�1111111111111111111111111111111111111111111111

�A��

*

= 1';<�1;0��0�*

L�1111111111111111111111111111111111111111111111

��<:;</�= 1<��0<91<�%;<&

09��(�9;1/;<�1��</�9�('

L�?;��;�=1';<�1�A��

*

L

= 1<��0<91<�%;<&*

L�1111111111111111111111111111111111111111111111

<��0<9�'&� 1';<�1��</�9�(1:�(�

����9&

'���9;1/;<�1��</�9�('��;��<0�

�9&1<��0<9

*

L

=1';<�1�A��*

L�11111111111111111111111111111111111111111111111

�A��

*P

PERFORMANCE

Once I had completed and proved the routine, I wrote a test programso that I could analyse the performance of the sort. The following tableshows approximate CPU times for a range of sorts. As with all CPUtime statements, the numbers have to be taken with a pinch of salt, butthe relationship between the tests should hold true, no matter whatsort of CPU you are running on.

Figure 1 shows total transaction times for a test transaction with testsof small (260 byte) and large (10,000 byte) records. Figures wereproduced for a range of sort file sizes, from 5 records to 5000 records.

Page 30: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

30 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

Because of performance evaluation during this testing, the routinewill not sort sets of more than 5000 records. Sorts of large amountsof data (greater than the size of ECDSA) can make CICS go SOS, andso were eliminated from the test.

DOCUMENTATION REFERENCE

In writing this routine, I referred to the IBM COBOL manuals and theDFSORT programming guide:

• COBOL for OS/390 and VM, Language Reference, SC26-9046-03

• COBOL for OS/390 and VM, Programming Guide, SC26-9049-04

#Records Key length Record length Initial order CPU time (milliseconds)5 8 260 In order 6.55 8 260 Reversed 4.650 8 260 In order 1950 8 260 Reversed 20500 8 260 In order 180

500 8 260 Reversed 1795000 8 260 In order 2,6005000 8 260 Reversed 2,7005 250 260 In order 4.75 250 260 Reversed 4.7

50 250 260 In order 1950 250 260 Reversed 20500 250 260 In order 184500 250 260 Reversed 1855000 250 260 In order 3,600

5000 250 260 Reversed 3,4005 8 10000 In order 4.85 8 10000 Reversed 4.950 8 10000 In order 2250 8 10000 Reversed 22

500 8 10000 In order 209500 8 10000 Reversed 2115 250 10000 In order 4.85 250 10000 Reversed 5.150 250 10000 In order 23

50 250 10000 Reversed 23500 250 10000 In order 213500 250 10000 Reversed 214

Figure 1: Transaction times

Page 31: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

31© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

• DFSORT, Application Programming Guide, SC33-4035-17.

SOFTWARE PREREQUISITES

The program has been tested with COBOL for OS/390 and VM V1.2and V2.1. It runs with CICS V4.1. I have no reason to expect problemswith any version of CICS/TS, although it has not been tested therebecause my company has not yet implemented it. Software was:

• COBOL for MVS and VM

• Language Environment

• CICS V4.1 or higher.

Restrictions:

• Maximum key length = 250 bytes

• Maximum record length = 32000 bytes

• Key type = character (only)

• Maximum number of keys = 1

• Duplicate result order = undefined

• Sufficient storage for all keys to be stored in main memory(approximately 1.2MB at the extreme limit).

POSSIBLE ENHANCEMENTS

The program could be enhanced to remove many of its restrictions.The parser of the sort parameters is extremely primitive, and isoptimized to the parameter text produced by COBOL with a veryrestricted subset of available options. A more flexible parser, togetherwith the ability to implement the options, would make the routinemore generally useful.

Many COBOL SORT verb options are not supported. These includemultiple keys, the Duplicates In Order phrase, data types for thekeys except for characters and others. These features could be addedto the program, but would require a rewrite of the sort algorithm. It

Page 32: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

32 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

probably needs to have a generalized comparison routine, rather thanthe distributed comparisons used at various points in the currentimplementation. An enhanced parser is also needed, so that the moreextensive parameter text required to control these options can beinterpreted.

The following features would provide useful additions to the tool:

• Implementation of several sort algorithms.

• Selection of an appropriate sort algorithm based on the input dataset size.

• Selectable alternative collating sequences.

PROBLEMS

The data to be sorted is stored in a temporary storage queue. Asimplemented here, a MAIN TS queue is used. This can cause aproblem, because the NOSUSPEND option is implemented only forauxiliary TS calls. If the data overflows the available ECDSA, then anSOS will occur in ECDSA, and the region will hang. The call couldbe changed to remove the MAIN option. This will require an increasedTS dataset size, and increase the elapsed time for many sorts. It will,however, mean that the sort cannot send the region SOS, so it shouldprobably be implemented without the MAIN option.

The original implementation of this program (inherited from the basesort function design) was targeted at an application that could runonly against a terminal. The temporary storage queue used to save thedata while the sort was in progress was named using the EIBTRMIDto provide ‘uniqueness’. A subsequent implementation of the routineran in a program that was initiated by an MQSeries message. Thisprogram ran without a primary facility. On several occasions, databelonging to two separate transactions was intermingled by sortsoperating concurrently.

This has been resolved by changing the temporary storage queuename so that EIBTASKN is used in the name instead of EIBTRMID.As an additional precaution, an enqueue is performed against thequeue name before entering the sort. If the enqueue fails, a failurereturn code is passed back to the application.

Page 33: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

33© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

SORT ASSEMBLER

L��';<��1�����������)�)���)� �����';<��I� ��

L���������4���� ��� �� �.� ����%�%'*���������� ��

L������������-��������3����%;5;(�';<�������)� �*�����';<�

L��������������)� ��)����� I��)��������������� �����)� ���

L��������� �����%;5;(�I���/C'�)� ���+������� �������I�';<�

L���������� ����%�%'*

L

L���������:��������)���)� ����

L�����������' ����Q�.

L�������������� � ��� ��&��� � �

L�����������:G���� ��3���-����� ����������

L������������ $��G��I��������� ���

L�������������$��G��I���������������

L������������ �������������

L�����������9�)-����I��������� ��%������������)�����

L�����������'����������B������ ��I����������B����

L�����������E�Q'���

L�����������,�.��� ����-��4�� � �� ��"$�

L�����������<����������������"����-.���

L

L���������'�� ����������I�������� �������������

L������������ ����I��)�� ������������I�����%�%'�������� �

L������������ ���)������4��Q�I�����%�%'�������� �

L�����������(��������������*��������� ���)������� �)-����I

L��������������������� �������������������$���*

L�����������/� .��������� B���*��������� ��4�����4�.������

L���������������� ����B�Q�����';<���������-���

L������������������A���� �0������������I��)� ����

L����������������M��%�%'����������.�������)M

L�����������/�������Q�.�

L

L�������������������)������������';<��%;9�<;(�'����/�9�'+�� �

L����������G����������-�� ������I�I��)����4������������

L���������-.�%;5;(�*

L

L�������������I��)����G��������

L���������M�';<��:��(&'2���� +���#+%�+���M

L���������M�<�%;<&��=��2:+(�9?��2������!++��M

L���������M�;���;9�/��9'�D�2���� ��$+:�('D2���������M

L��������������������I���IG����� ����������

L��������������������������

L���������M�';<��:��(&'2���� +���#+%�+���M

L���������M�<�%;<&��=��2C+(�9?��2�����!�+++����! +��M

L���������M�;���;9�/��9'�D�2���� ��$+:�('D2���������M

L��������������������I���3���-����� ����������

L

L�������������� �.�I�����.�����%�+���� � �����&��� � �

L���������,�.������ �� �-��� .4����� �������������*

Page 34: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

34 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

L���������,�.������ �J�Q�.��� ����)����-��F�) ��������� ���

L���������/�G)�)�Q�.��� ������"$��-.���

L

L��������������������������I������������� ����������)� ����

L���������3��.���)�3�+�� ��� �������4���I����I��)��

L��������� ���*��������-�� ��������4���%;5;(�I���/C'+�� �

L���������(��I���/C'�C *#*�%�� ����������������� ����������)� �

L���������I��)���-��4�� �%;5;(����(��3���� ��4��� ���-���� ����*

L�����������4����4����)���3�)� �������������4�����-�����-���

L�����������)�������-���������+�4�����������������4���-�� Q

L��������������-��4�� �3��-�+�� ��4���3���-����������I����)�*

L����������������������������4������� ���3�������Q�������

L����������3���-��� �����(�9?�����-���� +�� ��4���3���-��

L����������� ���� �)���3�����*

L

L���������:�����������-���� �� �)� ���4�����-������������

L�������������������������)��� �)�-������ �����I��

L������������+�� �����)���)� ���II��� ��������������)�*

L���������%���� ��.+�E�Q'����������*������ ��3���4�����-�

L���������'����'���+�����'���+����� �)� �'���+�<��G'���+���

L����������3� �5�--��'����I���3��.��)���������������F �1"��*

L

L�������������� ��3���)����� ��.���+�I����� ���- ��.���

L�����������Q�����)��������4�����-�����I��+����4�����)������

L��������� ���� �� ��Q�.������+�������������B�� �������-�

L������������ � ��� �� ��Q�.+�� ������ � ��� �� �����

L�����������-����.�Q�.*

L

���������&:�<�?'���������������������5�������������B�����

LLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLL

';<���</�&'�%������������������������'�����G�� ��������)��������

'�%'�����&'�����������������������������������I�%� �����'����)� ������

'�� $����&'�����������������������������������I�� $��G�

'���$����&'�����������������������������������I���$��G�

'�0��%���&'�����������������������������������I�0�����G��%� ��� �

'��(�'E��&'�����������������������������������I��(�'�E���� �������-��

'��'�����&'�����������������������������������I��'����������� ���

'�� #����&'�����������������������������������I�� #��G�

'��������&'�����������������������������������I������G�

'�%�((�&�&'������%(�������������������1�������������� �I��

'��9&����&'������%(������������������� �����)����� �����

L

';<�%9�(�&'�%������������������������'����%� �����'����)� ������

'%(�9����&'��������������������������(� �����I�� ����������)� ������

'%�<�����&'�������%������������������'������I�'����� ����������)� ��

L

&:���'�?�&'�%������������������������&. �)�������������

���������&:���'�?

<��%;&���&'������:�������������������������)������ ����

�<;%<�� �&'������������������������������������������ ��I������-���� �

Page 35: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

35© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

�<;%<��"�&'������������������������������������������ ��I������-���� �

�<;%<����&'������������������������������������������ ��I������-���� �

��</(�'��&'�����������������������������������I��G�� ������������)����

L

��<'&����&'�������:������������������������� I��)��� �I����4�

,�=(�9���&'��������������������������(� �����I����������Q�.

/�A,�=����E0�����"$������������������/�G)�)������I�Q�.��������

,�=;::'��&'��������������������������(���� � ���������I������Q�.

%9�(?;;&�&'������%�������������������%� �����'����) ����������������.

';<�,@���&'������%�������������������';<��,�.4������ �����;Q

<�%;<&,@�&'������%�������������������<�%;<&�,�.4������ �����;Q

;���;9,@�&'������%�������������������;���;9�,�.4������ �����;Q

';<�&�<��&'������%�������������������@��������� ��������������H&�

<�%:/����&'������%�������������������:G������C���-��R

,�=(�9�"�&'��������������������������(� �����I����������Q�.

(<�%(����&'��������������������������(� �����I��������)�G)�)�

/�9<�%(��&'��������������������������(� �����I��������) )�)�

E<�%(�9��&'��������������������������(� �����I�������I��)��'�B����

E%;09����&'��������������������������9�)-����I���)�� �';<��B����

/�A'�D����E0������"!�����������������/�G)�)������I��������������

/��9'�D��&'������:�������������������<��))� ���������I�)� �����

/�A<�%'���E0�����$�������������������/�G)�)�������� �������*

��5��<���&'�����������������������������������I��������-��

'�%,��<��&'����������������������������������4��Q����Q

'�%,(�9��&'������:�������������������(� �����I�4��Q����Q

';<�E9/��&'�������%(#����������������9�)���I�';<���'E

';<�E'<��&'������%(������������������%� ��� ��2�95'�

';<�E�',�&'�������(������������������:����4�4�����5��',9

:�(�'�D��&'��������������������������9�)-����I�������� �I����������

��<'(�9���E0�����L1��<'&�������������(� �����I������������ I��)���

L

%0<C�(0��&'������%("$����������������%���� ��C������I�Q�.� �����

��/������&'������%("$"���������������@��Q������I����4��

<�?������&'���������������������������� �����������������I�������

(�:������&'���������������������������� ���������I�������I�������

��&(�:���&'����������������������������)�������I�����I���� ���

L

���������&'�������&������������������'������ )� ��I���%C5

@;<,��%,�&'�������(#�����������������@��Q�I����I������1>- �� 3

L

� $��</��&'�������:������������������� $��G�����)����

� $9�@���&'�����������������������������������I� �4������

� $0��%��&'�����������������������������������I�������G����������� ��

L

��$��</��&'�������:��������������������$��G�����)����

��$9�@���&'�����������������������������������I� �4������

��$;0����&'�����������������������������������I������� �����-�II��

��$0��%��&'�����������������������������������I�������G����������� ��

L

���������&:����9&

Page 36: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

36 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

L

';<�������/;&���

';<������</;&���9=

';<������&:����9��%;&�<�?2�"+ �+��������������������������������������A

���������������&���<�?2� ��+�������������������������������������������A

�����������������5<�?2���

L

';<��9����E0�����L

���������'�������< +��</(�'����������'�3�����)������� ���

L������������������������������������?���������5��������

����������A�%�%�%'��&&<�''���5�&:���5<�

���������'�������&:���5<+&:���5�

���������(�������<�+#����������������'���-�������� �����I������� �

L��������'<������<�+<����������������%�������4��Q��������

���������'�������<�+<��%;&�����������'�����I���������� ������������

���������/C%�����';<�E'<�+2%M95'�M���'�������� ��� ��-�

���������/C%�����';<�E�',+��5��',9���'�������3���-���-�

L�������������������������������������9E������'�E� �)�*�����4��

L������������������������������������� ���������������Q�� ��

L�����������������������������������������3��.���������+�� ������

L���������������������������������������� ��������-.�� �� �G�����

L�������������������������������������'���� ������������*

����������A�%�%�%'��9E�������������������������������������������������A

���������������<�';0<%��';<�E9/����������������������������������������A

���������������(�9?���2�M#M��������������������������������������������A

���������������9;'0'��9&�����������������������������������������������A

���������������9;��9&(�

���������%(%�����5<�'�+&:�<�'��9;</�(��@��������9E������I��R

���������59����<��0<9����������������9�***�'�����*�������� ��������

L������������������������������������������.�-�� �������*

L

L�������������������������������������9E�4�������+�������I����*

';<�/��9��E0�����L

���������5�(�����< �+C�(�&�����������C��������������������)��������

L

���������5�(�����< �+��<'%9�(������������������� ����������)� ��

L

���������5�(�����< �+?��'�?�����������B������������I�����������

L

���������5�(�����< �+?��<�%'���������?��������������I��)������ $��G�

L

���������5�(�����< �+&;';<�����������&������������I������������� ����

L

���������5�(�����< �+�0�<�%'���������?3����������������������$��G�

L

���������5�(�����< �+<�('�?����������<���������������I��)���������

L

���������'<������< �+< ��������������D���

���������'�������< �+<��%;&����������D����<��%;&��� ���������.����)*

L

Page 37: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

37© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

<��0<9����E0�����L

L������������������������������������&����������B������S���� �����

����������A�%�%�%'�&�(���E��'������������������������������������������A

���������������E0�0��';<�E9/�������������������������������������������A

���������������9;��9&(�

L������������������������������������&�����������9E�����������Q��

L�������������������������������������������� *

����������A�%�%�%'�&�E�������������������������������������������������A

���������������<�';0<%��';<�E9/����������������������������������������A

���������������(�9?���2�M#M��������������������������������������������A

���������������9;��9&(�

���������(�������< $+<��%;&����������?�������� �������������-�Q

���������(�������< �+��+< �����������?������3������3������

���������'�������< $+ ��+< ����������'������������ ����

L

���������5��������A������������������?3������ ������� ���������

L

L

L������������������������������������'05<;0��9�'�:;((;@*

L

LLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLL

C�(�&�����E0���L

L������������������������������������C��������������������)��������

L������������������������������������)������4����4��� �����4��*

L

���������'�����< �+�<;%<�� ����������'�3��������-���� ������� ��������

L��������L�����L

C�(�������E0���L���������������������%��Q����)������� ���

���������(�����<$+��</(�'��������������������������������)����

���������0'�9?�';<���</+<$�����������/����������������)�����

���������(�<���<$+<$������������������ .����)�����������R

���������59D���C�(� �����������������=��+�� � �����Q�

���������(�����<�+#������������������?� ������3�����#

���������'�����<�+<��%;&����������������������� ���<��%;&�

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��950?����������������������������������������������A

���������������:<;/�'<��<<���������������������������������������������A

���������������(�9?���2�("�(M'<��<<������������������������������������A

���������������9;��9&(�

L

���������5�����<��0<9����������������?3�����))������.*

L��������L�����L

C�(� �����E0���L���������������������%��Q�� ����������)� ���� ���

L

L��������A�%�%�%'�@<���E��&�������������������������������������������A

L�������������E0�0��950?����������������������������������������������A

L�������������:<;/�'�%'�����������������������������������������������A

L�������������(�9?����������������������������������������������������A

L�������������9;��9&(�

L

Page 38: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

38 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

���������(�����<�+'�%'���������������?���%� ����������)� ������

���������0'�9?�';<�%9�(+<������������/������������� ����������)� ��

���������(�<���<�+<������������������� .�'����%� ����������������R

���������59D���C�(�"�����������������=��+�� � �����Q�

���������(�����<�+#������������������?� ������3�����#

���������'�����<�+<��%;&����������������������� ���<��%;&�

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��950?����������������������������������������������A

���������������:<;/�'<��<<� �������������������������������������������A

���������������(�9?���2�("�(M'<��<<� ����������������������������������A

���������������9;��9&(�

L

���������5�����<��0<9����������������?3�����))������.*

L

C�(�"�����E0���L���������������������%��Q�� $��G���������

L

L

L��������A�%�%�%'�@<���E��&�������������������������������������������A

L�������������E0�0��950?����������������������������������������������A

L�������������:<;/�';<�%9�(�������������������������������������������A

L�������������(�9?���'%(�9��������������������������������������������A

L�������������9;��9&(�

L

L

���������(�����< +'�� $��������������?���� $��G���������

���������%�����< +2:M1 M������������������ ���I�����-�� �������

���������5�����C�(�"$����������������=��+�-�����������.�1������

���������(�<���< +< ��������������������������R

���������59D���C�(������������������������������3���+����� � ��

C�(�"$����E0���L

���������(�����<�+#������������������?� ������3�����#

���������'�����<�+<��%;&����������������������� ���<��%;&�

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��950?����������������������������������������������A

���������������:<;/�'<��<<�"�������������������������������������������A

���������������(�9?���2�("�(M'<��<<�"����������������������������������A

���������������9;��9&(�

L

���������5�����<��0<9����������������?3�����))������.*

L

C�(�������E0���L���������������������%��Q���$��G���������

���������(�����< +'���$��������������?�����$��G���������

���������%�����< +2:M1 M������������������ ���I�����-�� �������

���������5�����C�(��"����������������=��+�-�����������.�1������

���������(�<���< +< ��������������������������R

���������59D���C�(��$���������������������������3���+����� � ��

C�(��"����E0���L

���������(�����<�+#������������������?� ������3�����#

���������'�����<�+<��%;&����������������������� ���<��%;&�

����������A�%�%�%'�@<���E��&�������������������������������������������A

Page 39: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

39© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

���������������E0�0��950?����������������������������������������������A

���������������:<;/�'<��<<���������������������������������������������A

���������������(�9?���2�("�(M'<��<<������������������������������������A

���������������9;��9&(�

L

���������5�����<��0<9����������������?3�����))������.*

L

C�(��$����E0���L���������������������%��Q�0�����G����������%� ��� �

���������'<����< +< �����������������9������ ���

���������'�����< +� $0��%������������'�3����I�����0��%�3����

���������(�����< +'�0��%�������������?���0�����G���������%� ��� �

���������%�����< +2:M1 M������������������ ���I�����-�� �������

���������5�����C�($������������������=��+����������������)����

���������'�����< +� $0��%������������'�3���������0��%�3����

L

C�(�������E0���L���������������������%��Q��(�'�E���� ��������-��

���������(�����< +'��(�'E������������?����(�'�E���-����������

���������%�����< +2:M1 M������������������ ���I�����-�� �������

���������5�����C�($������������������=��+����������������)����

���������(�<���< +< ��������������������������R

���������5D����C�(��$����������������9����-��+����� � ��

���������(�����<�+#������������������?� ������3�����#

���������'�����<�+<��%;&����������������������� ���<��%;&�

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��950?����������������������������������������������A

���������������:<;/�'<��<<���������������������������������������������A

���������������(�9?���2�("�(M'<��<<������������������������������������A

���������������9;��9&(�

L

���������5�����<��0<9����������������?3�����))������.*

L

C�(��$����E0���L���������������������%��Q��'�������� ���������

���������(�����< +'��'���������������?����'�����������

���������%�����< +2:M1 M������������������ ���I�����-�� �������

���������5�����C�($������������������=��+����������������)����

L

C�(�$�����E0���L���������������������%��Q�� #��G���������

���������(�����< +'�� #��������������?���� #��G���������

���������%�����< +2:M1 M������������������ ���I�����-�� �������

���������5�����C�($������������������=��+����������������)����

���������(�<���< +< ��������������������������R

���������5D����C�(�������������������9���G�+����� � ��

���������(�����<�+#������������������?� ������3�����#

���������'�����<�+<��%;&����������������������� ���<��%;&�

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��950?����������������������������������������������A

���������������:<;/�'<��<<�$�������������������������������������������A

���������������(�9?���2�("�(M'<��<<�$����������������������������������A

���������������9;��9&(�

L

Page 40: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

40 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

���������5�����<��0<9����������������?3�����))������.*

L

C�(�������E0���L���������������������%��Q������G���������

���������(�����< +'������������������?��������G���������

���������%�����< +2:M1 M������������������ ���I�����-�� �������

���������5�����C�($������������������=��+����������������)����

���������(�<���< +< ��������������������������R

���������5D����C�(�!�����������������9���G�+����� � ��

���������(�����<�+#������������������?� ������3�����#

���������'�����<�+<��%;&����������������������� ���<��%;&�

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��950?����������������������������������������������A

���������������:<;/�'<��<<���������������������������������������������A

���������������(�9?���2�("�(M'<��<<������������������������������������A

���������������9;��9&(�

L

���������5�����<��0<9����������������?3�����))������.*

L

C�(�!�����E0���L���������������������%��Q�%�((1�&�I���

���������%(%���'�%�((�&+2:M1 M�������?���%�((�&�3����

���������5�����C�($������������������=��+����������������)����

L

C�(�#�����E0���L���������������������%��Q�������� �� �����

���������%(%���'��9&+2:M1 M�������������� �� ������2�GM::::::::MR

���������5�����C�($������������������=��+����� � ����

���������(�����<�+#������������������?� ������3�����#

���������'�����<�+<��%;&����������������������� ���<��%;&�

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��950?����������������������������������������������A

���������������:<;/�'<��<<�!�������������������������������������������A

���������������(�9?���2�("�(M'<��<<�!����������������������������������A

���������������9;��9&(�

L

���������5�����<��0<9����������������?3�����))������.*

L

C�($������E0���L���������������������C������ ����� �+������

���������(�����< �+�<;%<�� ����������<������������ ��������

���������5<����< ��������������������<���� ���������

LLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLL

L������������������������������������%��Q������4��� �� ������ �����

L������������������������������������������ ����������)� ��*�'�����

L������������������������������������� �����3���-������������4����

L������������������������������������4����4����������*

L

��<'%9�(��E0���L�������������������������������'����� ����������)� ��

���������'�����< �+�<;%<�� ����������'�3��������-���� ������� ��������

L��������L�����L

L������������������������������������@������������������ ����

��<'������E0���L

L������������������������������������'�������3��.�� ��-�I����4�������

Page 41: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

41© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

���������(�����<�+'%�<����������������� ������������I�'����� ����

���������(�����<!+'%(�9��������������<������� ���� ���.����G�) ��

���������/C����%9�(?;;&+%M=M����������G�����3��.�� ��4���-��;,

���������/C����';<�,@+%M9M�����������';<��,�.4�������������=�2������

���������/C����<�%;<&,@+%M9M���������<�%;<&�,�.4�����������=�2������

���������/C����;���;9,@+%M9M���������;���;9�,�.4�����������=�2������

���������5�(���< �+��<'��������������'Q���3����G���������

L

��<' �����E0���L���������������������'������I�Q�.4������

���������%(%���2%M';<��M+��<������������';<��Q�.4�������

���������59������<'"�����������������9�+�����3����*�@��� M�����

���������5�(���< �+��<'!�������������=��+�����������������-I����

L

��<' ����E0���L

���������%(%���2%M�<�%;<&�M+"#�<��������<�%;<&�Q�.4���������

���������59������<'"�����������������9�+�����3����*�@��� M�����

���������5�(���< �+��<'#�������������=��+�����������������-I����

L

��<' "����E0���L

���������%(%���2%M�;���;9�M+� �<���������;���;9�Q�.4���������

���������59������<'������������������9�+� ������ ������

���������5�(���< �+��<'��������������=��+�����������������-I����

L

L���������@�������� ��4������������+� �4���Q���4���4� �*

��<'"�����E0���L

���������%(����';<�,@+%M=M�����������'����Q�.4�������������;QR

���������59������<'������������������9�+� �����-���� �����

���������%(����<�%;<&,@+%M=M���������<�����Q�.4�������������;QR

���������59������<'������������������9�+� �����-���� �����

���������%(����;���;9,@+%M=M���������;���;9�Q�.4�������������;QR

���������59������<'������������������9�+� �����-���� �����

���������5�������<'$������������������3��.�� ��)����-.�;Q

L

��<'������E0���L

���������/C����%9�(?;;&+%M9M���������� ����������-��)�4��������)� ��

L������������������������������������@������G +���)���*�

���������/C%���'<��<< #J"����+��5�<9�&��<�������� ����

���������/C%���'<��<< #J� ���+��5��',9��<��������) ��

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��%'/�����������������������������������������������A

���������������:<;/�'<��<< #�������������������������������������������A

���������������(�9?���2�("�(M'<��<< #����������������������������������A

���������������9;��9&(�

L������������������������������������@����������)������

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��%'/�����������������������������������������������A

���������������:<;/�'<��<<�#�������������������������������������������A

���������������(�9?���2�("�(M'<��<<�#����������������������������������A

���������������9;��9&(�

L������������������������������������@���������� ����������)� ��

Page 42: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

42 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��950?����������������������������������������������A

���������������:<;/�';<�%9�(�������������������������������������������A

���������������(�9?���'%(�9��������������������������������������������A

���������������9;��9&(�

L

L��������A�%�%�%'��5�9&�����������������������������������������������A

L��������������5%;&��M';<�M�������������������������������������������A

L�������������9;��9&(�

L

���������5�����<��0<9����������������?3�����))������.*

L

��<'$�����E0���L

���������(�����< �+�<;%<�� ����������<������������ ��������

���������5<����< ��������������������<���� ���������

L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L

��<'������E0���L���������������������'Q���3���-�� Q�+�-������������ �

���������'�����< �+�<;%<��"����������'�3��������-���� ������� ��������

L��������L�����L

��<'� ����E0���L���������������������'Q���3���-�� Q�+�-������������ �

���������%(������<��+%M�M���������������������R

���������59������<'�"����������������9�+�����G�

���������(�����<�+ �<����������������� ��)� ���� ���

���������5%����<!+��<'� �������������&���)� ���� ��� ��-�� ��-�Q

L

��<'�"����E0���L

���������(�����< �+�<;%<��"����������<������������ �������

���������5<����< ��������������������?��-�Q*

L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L

��<'!�����E0���L��������������������������������';<��Q�.4�������� �

���������'�����< �+�<;%<�������������'�3��������-���� ������� ��������

���������%(%���2%M:��(&'2�M+$�<���������:��(&'�Q�.4��������

���������59������<'!#����������������9��1� ��� ����������������

L

��<'! ����E0���L��������������������������������:��(&'�����

L����������������������������������������)������������� ���� �M+M

�����������%,��@;<,��%,+ ���+<���������Q���������� �I���

���������%C5���<�+@;<,��%,�����������9�4� �- ��.

���������5%�<��<�+�������������������&���)� �����I��)��II���

���������'�����<�+,�=;::'������������'�3������Q�.��II����3����

L

���������%(���� !�<��+%M+M�����������%�))�� �G�R

���������59������<'!#����������������?3����+�� M���������*

L

�����������%,��@;<,��%,+ #��+<���������Q�����Q�.��� ����I���

���������%C5���<�+@;<,��%,�����������9�4� �- ��.

���������'�����<�+,�=(�9�������������'�3������Q�.��� ����3����

���������%�����<�+2�("�/�A,�=��������,�.��� ����;QR

���������59������<'! $���������������=��+�� � ��������

Page 43: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

43© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

L������������������������������������5���Q�.��� ����1�������

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��950?����������������������������������������������A

���������������:<;/�'<��<< ��������������������������������������������A

���������������(�9?���2�("�(M'<��<< �����������������������������������A

���������������9;��9&(�

L

���������5�����<��0<9����������������?3�����))������.*

L

��<'! $���E0���L

���������%(����""�<��+%M+M�����������%�))�� �G�R

���������59������<'!#����������������?3����+�� M���������*

L

���������%(%���2%M%�M+"��<�������������������������)����� R

���������59������<'!#����������������9�+����4��� M������*

L

���������%(����"$�<��+%M+M�����������%�))����� R

���������59������<'!#����������������?3����+�� M���������*

L

���������%(����"��<��+%M�M�������������� � ������R

���������59������<'!"����������������9��1��������� � �R

���������5�������<'!�����������������=��+������3���

L

��<'!"����E0���L

���������%(����"��<��+%M&M�����������&��� � ������R

���������59������<'!#����������������9��1������+�����3����

���������5�������<'!�����������������=��+������3����� ���Q��I��4���

L

��<'!�����E0���L

���������/C%���';<�&�<+"��<����������'�3����������������

���������%(����"!�<��+%M�M�����������:����4���-.��R

���������59������<'!#����������������9�+����4��� M������4����

���������/C����';<�,@+%M=M����������������������';<�������)� ��;,*

L

��<'!#����E0���L

���������'<����<!+<!�����������������'����������� �����������

L��������L�����L

��<'!�����E0���L

���������(�����< �+�<;%<�������������<������������ �������

���������5<����< ��������������������?��-�Q*

L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L

��<'#�����E0���L����������������������������<�%;<&�Q�.4���

���������'�����< �+�<;%<�������������'�3��������-���� ������� ��������

���������/C����<�%:/+%M�M������������%�����<�%:/

���������'<����<#+<#

���������'�����<#+(<�%(��������������%�����(<�%(

L

��<'# ����E0���L���������������������(������������<�%;<&�Q�.4����

���������%(%���2%M�=��2M+���<��������������=���Q�.4���R

���������59������<'##����������������9��1��3����

Page 44: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

44 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

L

��<'#"����E0���L���������������������������������=�������

L��������L�����L

���������%(����� �<��+%M:M�����������������=��2:R

���������5�������<'#�����������������=��+����4�������4����*

���������%(����� �<��+%MCM�����������������=��2CR

���������59������<'##����������������9�+����4��� M�������4����*

��<'#�����E0���L

���������/C%���<�%:/+� �<������������'�3�������������.��

���������%(�����"�<��+%M+M����������������I����4���-.��))�

���������59������<'##����������������9�+����4��)����-���� �

L

���������%(%���2%M(�9?��2�M+���<����������(�9?���Q�.4���

���������59������<'##����������������9��1� ��� ����������������

L

��<'#�����E0���L��������������������������������(�9?��2������

L��������L�����L

�����������%,��@;<,��%,+$ ��+<���������Q������� ����3����

���������%C5���<�+@;<,��%,�����������/�Q����- ��.

���������'�����<�+(<�%(��������������'�3�������/�G���������� ���

���������'�����<�+/�9<�%(������������'�3�����������-����) �����

���������%(����<�%:/+%M:M������������:G���I��)��R

���������5�������<'#�$���������������=��+� ��)���������

L

L������������������������������������C���-���I��)��+�������-�) ���

�����������%,��@;<,��%,+����+<���������Q������� ����3����

���������%C5���<�+@;<,��%,�����������/�Q����- ��.

���������'�����<�+/�9<�%(������������'�3�������/ ���������� ���

���������(�����<�+#�+<���������������� ��)� ���3�������) ������ ���

L

��<'#�$���E0���L

���������(�����< �+,�=(�9������������?���Q�.��� ���

���������������< �+,�=;::'�����������������������

���������%<����<�+< �����������������,�.� ���������R

���������59(�����<'#$����������������=��+����� � ��

L

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��950?����������������������������������������������A

���������������:<;/�'<��<< �������������������������������������������A

���������������(�9?���2�("�(M'<��<< ����������������������������������A

���������������9;��9&(�

L

���������5�����<��0<9����������������?3�����))������.*

L

��<'#$����E0���L���������������������%��Q��������� ����3*�)�G

���������%�����<�+2�("�/�A'�D�������������F2�)�GR

���������59������<'#��

L��������L�����L

����������A�%�%�%'�@<���E��&�������������������������������������������A

���������������E0�0��950?����������������������������������������������A

Page 45: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

45© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

���������������:<;/�'<��<< "�������������������������������������������A

���������������(�9?���2�("�(M'<��<< "����������������������������������A

���������������9;��9&(�

L

���������5�����<��0<9����������������?3�����))������.*

L

��<'#�����E0���L���������������������,����� ���Q �

���������%(%���2%M+�M+$#�<����������������I����4���-.�M+�MR

���������59������<'##����������������9�+����4��� M���� �����

���������5�������<'#������������������3��.�� ������ �

L

��<'##����E0���L

���������'<����<!+<!�����������������'����������� �����������

L��������L�����L

L

��<'#�����E0���L

���������%(����<�%:/+%M�M������������<�%:/������R

���������5�������<'#�$���������������9�+���� �������1��� M����������

���������%(%���(<�%(+2�M�M�����������(<�%(����R

���������5�������<'#�$���������������9�+���� �������1��� M����������

���������/C����<�%;<&,@+%M=M����������3��.�� ��;Q*�:������������)�

L

��<'#�$���E0���L

���������(�����< �+�<;%<�������������<������������ �������

���������5<����< ��������������������?��-�Q*

L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L

��<'������E0���L����������������������������;���;9�Q�.4���

���������'�����< �+�<;%<�������������'�3��������-���� ������� ��������

���������'<����<#+<#

���������'�����<#+:�(�'�D������������%�����:����������� �

���������'�����<#+/��9'�D������������%�����:����������� �

L

��<'� ����E0���L���������������������(������������;���;9�Q�.4����

���������%(%���2%M�/��9'�D�2M+�#�<��������/��9'�D�R

���������59������<'�#����������������=���1���������

L

��<'�"����E0���L��������������������������������/��9'�D������

L��������L�����L

�����������%,��@;<,��%,+!#�#+<���������Q��� ���4��Q�I���

���������%C5���<�+@;<,��%,�����������%� 3���������- ��.

���������'�����<�+/��9'�D������������'�3������)� ���������

���������%(����#��<��+%M+M����������������I����4���-.��))�

���������59������<'�#����������������9�+����4��)����-���� �

Editor’s note: this article will be concluded in the next issue.

Neil CaseySenior Systems Programmer (CICS and MQSeries)National Australia Bank (Australia) © National Australia Bank 2001

Page 46: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

46 © 2001. Xephon UK telephone 01635 33848, fax 01635 38345. USA telephone (303) 410 9344, fax (303) 438 0290.

December 1999 – November 2001 index

Items below are references to articles that have appeared in CICS Update since Issue 169,December 1999. References show the issue number followed by the page number(s). Back-issues of CICS Update are available back to issue 169 (December 1999). See page 2 for details.

Alter 177.32-47, 178.5-23AOR 174.14-20, 178.23-32Application development 172.3-10Auto-install 177.3-9Batch 172.11-19BMS 187.46-51, 188.18-55CEDA 190.11-12CEDF 172.3CETR 174.3-14CICS TS 1.3 188.3-4, 192.25CICSplex SM API 170.30-47,

171.26-37Cloning 170.12-25Cold start 169.16-20, .3-6,

182.11-16, 184.10-11COPY 181.28-31CPSM 192.8-10CREATE command 173.3-10CSD 169.3-16, 170.26-30,

172.29-47, 173.11-13, 173.29-47,174.30-47, 175.32-47, 176.9-25,182.35-47, 183.3-6, 183.19-38,

184.36-47, 185.12-32,187.6-40, 190.3-10

CVDA 185.3-11DB2 182.35-47DB2ENTRY 191.28-47Define statements 175.15-31Display 184.5-10Doctemplates 173.14-29,

174.21-29, 175.14Documenting programs 188.9-17Dynamic Transaction Routing 176.26-38E-business 181.32-47EJB 191.3-7Enclaves 178.3-4Faxing 189.25-35FOR 174.14-20, 178.23-32

Forward recovery 181.14-28GLUE 182.28-35Hot-pooling (HPJ) 181.3-13, 192.3-7Integrated Translator 189.3-7ISC 182.17-28Java 170.3-11, 181.3-13, 192.3-7LE/370 187.40-45Libraries 190.16-24Log manager 171.13-25Log stream 180.6-9Maps 185.32-47Messages 186.9-22Monitoring 171.37-47,

172.19-28, 182.17-28, 183.6-18,190.12-16, 190.24-47, 191.22-28

MQSeries 153.15-28, 154.10-21MRO 182.17-28National language 169.37-47NEWCOPY 169.21-36,

173.14-29, 174.21-29, 175.14Null-use resources 174.30-47, 175.32-47PL/I 189.3-7, 189.7-24PL/I transactions 187.3-6Printer assignment 183.39-47, 184.11-36RDO 169.3-16, 170.26-30RDO definition 188.5-9Rununits 178.3-4Shared TS queues 175.3-14SIT parameter 184.3-5SMP/E zones 171.3-12SMTP 176.39-47, 177.9-16Sort 169.37-47SORT 192.26-45Started regions 176.3-9Storage management 178.3-4Storage use 186.23-32Stress 182.3-11System logger 190.24-47

Page 47: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

47© 2001. Reproduction prohibited. Please inform Xephon of any infringement.

Task activity 182.3-11TCP/IP 177.17-31,

179.34-47, 180.9-37Temporary storage 179.3-5,

191.8-11, 192.11-24Temporary storage queues 186.3-9Terminals 186.33-47Testing 189.7-24The Monitor 178.33-47, 179.17-34TRACE TABLE 174.3-14

Transaction Server 1.3 170.3-11Tuning 174.14-20, 191.28-47VSAM 175.15-31, 181.14-28VSE 181.32-47Web 180.38-45Web documents 189.36-51Web interface 185.11-12Web User Interface (WUI) 191.12-21WML 179.6-16

Need help with a CICS problem orproject?

Maybe we can help:

• If it’s on a topic of interest to other subscribers, we’llcommission an article on the subject, which we’llpublish in CICS Update, and which we’ll pay for –it won’t cost you anything.

• If it’s a more specialized, or more complex, problem,you can advertise your requirements (including one-off projects, freelance contracts, permanent jobs,etc) to the thousands of CICS professionals who visitCICS Update’s home page every week. This serviceis also free of charge.

Visit the CICS Update Web site, http://www.xephon.com/cics, and follow the link to Opportunities for CICSspecialists.

Page 48: CICS Nov title2 - CBT Tape · attention needs to be paid to ensure that MAXOPENTCBS is not set to too high a value, and that the optimum balance between CICS DSA

CICS news

Micro Focus International has announcedenhancements to Component Generator thatenable users to access CICS data andbusiness processes across the latest platformtechnology. These updates include supportfor WAP and J2ME protocols for wirelessdevices and support for mapping mainframedata to XML Document Type Definitions(DTDs).

Component Generator enables ITorganizations to capture complete CICSbusiness processes and produce componentsin the form of JavaBeans, EJBs, COM, andXML.

Component Generator generates the entirecomponent, middleware, and back-endsource code needed to access CICSapplications. The company claims that nohand coding or changes to legacy systems arerequired.

There’s now wireless connectivity to CICSapplications and business workflows throughWAP- and J2ME-enabled devices, includingPalm, PocketPC, and mobile phones.

For further information contact:Merant, Abbey View, Everard Close, StAlbans, Herts, AL1 2PS, UK.Tel: 01727 812812.URL: http://www.microfocus.com.

* * *

IBM has announced the second release ofz/OS, with enhancements in IP networking,Internet and intranet security, and distributedprint management for the Web.

A new function in the InfoPrint Serverfeature is designed to make it easy toincorporate legacy transaction programs intoa printing infrastructure and to get output tothe people who need it.

Infoprint Server converts SCS data and 3270output from CICS, IMS, and other VTAMapplication programs directly to any PCLprinter in the network. A new functionenables transmission of output as e-mail.

For further information contact your localIBM representative.URL: http://www.ibm.com/servers/eserver/zseries.

* * *

Xephon is holding a one-day conferenceentitled CICS Update 2001 at the RadissonSAS Portman hotel, London, on 11December 2001.

For further details about CICS Update 2001,or information about Xephon’s completerange of seminars and conferences, call01635 33823 or browse www.xephon.com/events.

� xephon