72
© Xephon plc 2002 June 2002 189 In this issue MVS KF@=JA 3 JES2 z/OS 1.2 dynamic PROCLIB 5 Java demo files delivered with Java 2 8 A VSAM browse routine – part 2 22 Displaying multi-volume dataset details 37 Maintaining a DASD configuration – revisited 41 Overview of ISPF panel processing commands 57 The fastest way to get SMS DASD space information 72 MVS news

MVS Update - CBT Tape

Embed Size (px)

Citation preview

© Xephon plc 2002

June 2002

189

In this issue

MVS������

3 JES2 z/OS 1.2 dynamic PROCLIB5 Java demo files delivered with Java

28 A VSAM browse routine – part 2

22 Displaying multi-volume datasetdetails

37 Maintaining a DASD configuration– revisited

41 Overview of ISPF panel processingcommands

57 The fastest way to get SMS DASDspace information

72 MVS 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.

2

MVS 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 MVS Update,comprising twelve monthly issues, costs£340.00 in the UK; $505.00 in the USA andCanada; £346.00 in Europe; £352.00 inAustralasia and Japan; and £350.00elsewhere. In all cases the price includespostage. Individual issues, starting with theJanuary 1999 issue, are available separatelyto subscribers for £29.00 ($43.50) eachincluding postage.

MVS Update on-lineCode from MVS Update, and complete issuesin Acrobat PDF format, can be downloadedfrom our Web site at http://www.xephon.com/mvs; you will need to supply a wordfrom the printed issue.

© Xephon plc 2002. 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, EXECs, and other contents of thisjournal before 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.

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

JES2 z/OS 1.2 dynamic PROCLIB

Who has ever been obliged to shut down JES2 in order to add a newPROCLIB dataset?

Starting with z/OS 1.2, you can now dynamically add, remove, ormodify PROCLIBs datasets, making this operation non-disruptive.

Dynamic PROCLIB can override existing PROCxx DDs in the JES2start PROC.

There are two ways to use dynamic PROCLIBs:

1 Using JES2 commands $ADD, $DEL, and $T.

2 Using the PROCLIB init statement in JES2PARM, thus completelyeliminating the static PROCLIBs in JES2 PROC.

SAMPLE JES2 START-UP PROC

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

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

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

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

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

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

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

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

������"���������� �����������

PROC00 concatenation is for START and EXEC PROCs.

The PROC01 is dedicated to TSO logon PROCs as defined inJES2PARM:

��"������#����"�����

EXAMPLE 1: ADDING A PROC

$������"��������������� �����!�"�!��"��

$����%�&���"������������������ ��������!�"�!��"���

If the name in PROCLIB() matches a DDname in the JES2 start PROC,

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

this PROCLIB concatenation will be used instead of the one in the JES2start PROC.

Sysplex note: you need to execute this command on all MAS members.

EXAMPLE 2: DISPLAYING DYNAMIC PROCLIBS

You cannot view PROCLIBs defined in the JES2 start PROC, onlyPROCLIB $ADDed are displayed.

$����"��

$����%�&���"��������

$����%�&���"������������������ ��������!�"�!��"���

EXAMPLE 3: DISPLAY WITH DEBUG KEYWORD

$����"������#�

$����%�&���"��������

$����%�&���"���������#��# ������ �������������

$����%�&������������!�%����'��'�%!()�

$����%�&���������� ��������!�"�!��"���

EXAMPLE 4: MODIFYING AN EXISTING PROCLIB CONCATENATION

This adds a second PROCLIB to an existing concatenation:

$������"��������������� �����!��"��

$����%�&���"��������������������� ��������!��"���

$����"��������������� �����!��"��

$����%�&���"��������

$����%�&���"��������������������� ��������!��"����

$����%�&����������������������������� ��������!��"���

EXAMPLE 5: DELETING A DYNAMICALLY ADDED PROCLIB

You cannot delete PROCLIBs defined in the JES2 start PROC:

$��"���"��������

$����%�&���"��������

$����%�&���"������������������ ��������!�"�!��"����*

$����%�&��"��� ����"����

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

$D PROCLIB,DEBUG can still display some information after theDELETE:

$����%�&���"�����������"�������"���#��# ����

$����%�&��� ����������� �

$����%�&������������!�%����'��'�%!()�

$����%�&���������� ��������!�"�!��"���

Francois Le ManerSystem Engineer (France) © Xephon 2002

Java demo files delivered with Java 2

We have just installed Java 2 Technology Edition on our OS/390machine. We have completed the ‘Apply’ stage for SMP/E and now wewant to check that everything works as expected before running the‘Accept’. The installation guide points us in the direction of IVPs(Installation Verification Programs).

Installation Verification Programs is a super title that, for example withthe CICS installation, promises us some sort of batch or interactiveprogram. There is, however, only one section‚‘Activating IBM DeveloperKit for OS/390, Java 2 Technology Edition’, which contains no prettyscreens, no moving parts, and no dialog. We followed the instructions:

• Use the following shell command:

+,-./0�������12/�3--�4565�������!%�789'$����

which adds the java bin to the PATH description, and for future usewe changed the system path variable as appropriate in /etc/profile.

• After setting the path, enter the following shell command:

4565�*6+/28.9

IBM Developer Kit for OS/390, Java 2 Technology Edition issuccessfully installed if the ‘java’ command returns a summary ofavailable options and the version option returns the current versionof the IBM Developer Kit for OS/390, Java 2 Technology Editioncode.

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

OK it works!

Brilliant, I have had some boring tasks in the past, but this tops them all.By complete coincidence I saw in one of the installation job listings(OAJVI2) the list of expanded (PAX) directories and files, and amongstthe directories was the following:

��!%�:+;.

which on our site is /usr/lpp/java/IBM/J1.3/demo/ and has a whole loadof directories and files packed underneath it – one of which is applets.

Great! Now we can really try the Java. All we need to do is find theappropriate documentation to run these demos.

Why do the folk at IBM make life so difficult sometimes?

Here’s what we did to get the demos up and running.

First, because we naturally expected to access Java via a browser wealtered the PATH, LIBPATH, JAVA_HOME, and CLASSPATH in thehttpd.envars file for our http server to reflect the new address of Java.

Secondly, as we found out on our first attempt to get the demos to run,we needed to have a ‘pass’ rule in the httpd.conf file. Ours was thensimply:

�522����12/�3--�4565�������!%�:+;.�<�����12/�3--�4565�������!%�:+;.�<

And, thirdly, we needed to restart the server.

With our second attempt, and using the URL http://os390r10/usr/lpp/java/IBM/J1.3/demo/applets/Clock/example1 (where OS/390 Release10 is the TCP/IP name of our test OS/390 Version 2 Release 10machine), we were up and running with a Java demo clock. Containedin the directory /usr/lpp/java/IBM/J1.3/demo/applets/ are 21subdirectories of demos with one or more examples (accessed asexample1, example2, etc) per demo directory.

A few words about each.

• Animator – four examples, none of which started under Netscapeor Internet Explorer (ERROR).

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

• ArcTest – one example. You enter the start and end position indegrees and an arc is drawn and filled in if the fill option is used.

• BarChart – simple colourful example of a bar chart. Sadly nomoving parts.

• Blink – this applet had problems starting withjava.lang.NoClassDefFoundError

• CardTest – super demo of various forms (layouts) of click buttons.

• Clock – a simple digital/analog clock.

• DitherTest – I don’t really know what it is, but it enables a superbmixing of the three base colours of blue, red, and green.

• DrawTest – something for the kids amongst us. Six differentcolours and the options of either lines or freehand to play with.

• Fractal – I’m sure it’s a good demo for programming; however, asfractals go it’s somewhat primitive.

• GraphicsTest – demo of five different shapes.

• GraphLayout – four examples of moving graphs. I’m sure the codefor this is pretty interesting and can be used for good and simpleeffects.

• ImageMap – super example of a mapped image. The imagecontains seven different active areas, which trigger nine differentactions, including sound.

• JumpingBox – a simple but effective game. The box movesrandomly in response to the cursor and you have to try to click whenthe cursor is over the box. Also with sound.

• MoleculeViewer – three examples, none of which worked on mybrowsers. Internet Explorer had nothing to say and Netscapementioned something about transferring data from the host, butafter a couple of minutes waiting it still didn’t do anything toimpress the viewer.

• NervousText – a simple moving (text) banner.

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

• SimpleGraph – very simple indeed.

• SortDemo – super graphical demonstration of the sort methods:bubble sort, bi-directional bubble sort, and quicksort. The sort ofthing one would have liked when studying Computing/IT.

• SpreadSheet – a simple spreadsheet.

• SymbolTest – displays unicode character ranges.

• TicTacToe – the simple but ever popular TicTacToe, but withsound.

• WireFrame – four examples, three of which brought ‘Error inmodel: FileFormatException: Token[‚{‚], line 3’ (line 1 underNetscape). The first example brought nothing.

Altogether a good collection of fairly simple examples, which, used asIVPs, make life a little less boring for the installation team. Thecollection also gives the newcomer a good chance to investigate simplecode ( contained in .java files ), to demonstrate techniques, and to avoidconfusion by keeping things simple. It is just a pity that the chaps at IBMdid not document it that well.

Rolf ParkerSystems Programmer (UK) © Xephon 2002

A VSAM browse routine – part 2

This month we conclude the code for a VSAM browse routine that canbe used in place of the standard ISRBRO.

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

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

������������������"�

���������""����#����

��#�����������=���> �������> ��=��� �

����������������=���> �������> ��=��� ���?�=���=�!��

���������� ���@�=��#�����������������"���"������������� ���!=

!������� �

���> �������������> �A�

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

�������������������> �������!B

���������� ���@�= �������� �������B��� ���!���B� #�������� ��!=

!B�������� �

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

�����������B� ������������%��� �������)

������������������"�

�����������������=������=��?�==�! ��#�"

�����������������=����)�=��?�==���=����)�=��?�=���>"� �����>"��=�!B�#C

����������������"

���������� ������=���� ������ ���� ��������� ������=

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

!B�#�"���#��� �������������������������%������ �������������)��

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

! ��#�"��������=���=��?�==���=���=��?�=�=���=���=��?�=� �=���=���=C

����������������?�=���=���=���=��?�=� ���=�!��"��

����������������=���=��?�=�=���=���=��?�=� �=���=���=��?�=���=����C

���������������=���=��?�=� ���=�!�D����

����������#��� �����������������%��� �������)�

���>�������������>��C

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

!�D������#��� �����������������%��� ����)�

���>�������������>��C%

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

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

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

����������#��� ����������

�����������������"�

���������""���DB��������B

���������������%

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

�B�������������

����������������=�������=�������?�=�=���=�������=��?�=�?#=�!��

����������������=�������=��?�==�!�D����

����������������=�������=��?�=�=�! �D��

����������������=�������=��?�=��=�! �D��

����������������=�������=�������?�==�!���B

! �D����� �

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

��������������!��� �

!�D������������=�������=������ ��==�!�����

����������������=�������=��?�=""=�!""

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

���������������%

��������������!���B

!""����� �

���������������%

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

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

�B�������������%

��������������!���B

!�������� �

����������������=�������=� ��=��=�!���B

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

���������������%

�B�������������

��������������!��� �

!���B����� �

�B��������������

!��� ��������������

!�����������������>����������!����

���>��������������>��C�

���>�� ������>������������=�������=

���>�� ������>������������=�������=

����������������=��������=� ��==�!"�%�

���>�� �%����>������������==

��������������!���

!"�%������ �

���>�� �%����>�����������=��������=

!��� ����� �

����������������=������B�=� ��==�!"� �

���>�� � ����>�����������==

��������������!����

!"� ������ �

���>�� � ����>�����������=������B�=

!���������������=�����)�=��?�==�!�"B#��

����������������=�����)�=������� ��=��>� "�">=�!�"B#��

���>�� ������>�����������=�����)�=

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

!�"B#���� �

���>�� ������>�����������==

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

!�������� ���@�=� ��� ���B���E���������!��#���������� �� ��� ��"��=

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

����������#�� �������

������������������"�

���> �������������> �C�

�������������������> ��������!���

���> �������> ������������=����=!=���=

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

!�������� ���@�= �������B���E���������!��#���������� �� ��� ��"��=

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

����������#��"��

������������������"�

�������������������>"���������!���

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

���>��?�����������>��?C�

���>"�������������>"�C�

���>"� �����>"������������=��>� "�">���>��?=

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

!�������� ���@�=�"���"���B���E���������!��#���������� �� ��� ��"��=

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

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

������������������"�

���������""����� �� ����� �

����������#��"��

���>�����������

���>������> �C����������������>��C�

���> �������> ������������=���=!=���> �������> ��=� ���

�����������������=����"��������?�==�!"�

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

���>��"����������������"������

����������������=����"������=��?�==�!� ��"

���������� ��� �=�B��D���#���!������������������� ���=

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

!� ��"�� ��� �=�#��������"����� ���������� !� ���� ������=

���>��"��������

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

!"�������B� ���������"�������>��������������������������������������C

�������������������"�������>��C���������������������������������������C

�������������������"�������>��C���������������������������������������C

�������������������"�������>��C%��������������������������������������C

�������������������"�������>��C �

����������������=����"�������>��C��=��?�=� �=�!� ���

����������������=����"�������>��C��=� ��=� ���=�!�����

!� �����#��� ���������A���>��"����>"� �����>"�A���

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

����������������=����"�������>��C��=� ��=� ���=��� ����� ��!����"�

������������ ��������>������> �C��

���>"� �����>"������?#���<

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

���>"�������������>"�A�

����������#��"��

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

!��������������=����"�������>��C��=��?�=�=�!���

����������������=����"�������>��C��=� ��=���=�!����"�

!������#��� ����������>��"����>"� �����>"���

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

����������������=����"�������>��C��=� ��=���=��� ���� �� ��!����"�

����������#��� ����?#�<�������>"� �����>"�A���

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

����������#��"��

���>"������������>"�A�

���>"� �����>"�A��������=���>"� �����>"�C��=

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

!����"���� �

���>�������������>��C�

����������������=����"�������>��A��=� ��==�!"�

!� ��"��������=���> �������> ��=��� ���?�=�=�!�� �

������������ ��������>������> �C��

����������������A���>��"����>"� �����>"�A��

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

���>"� �����>"������?#���<

!��"�"��� �

���>"�������������>"�A�

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

!�� ����� �

���>�������������>������> �C��

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

! ��"�"���������=���>�� �%����>���=� ��=���>"� �����>"��=�!� ��

���>�� �%����>���������=���>"� �����>"�A%�=

!� ������ �

���>�������������>��C�

!� �"�"������������>���"�����>���! ��"�"

������������ ��������>������> �C��

�����������������>��"����>"� �����>"�A%�

���������������� ���� �� ��!���"�"�������������������������F�� % ��

���>"� �����>"�A����?#���<

!���"�"�� �

���>"�������������>"�A�

���> �������> ����������=����=!=���> �������> ��=��� �

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

�������������������������%��� �������)���(���@���&�������������������%��

������������������ ���������)����(����@����&�������������������%���� ���

�����������������������)����(����@����&���%����%����%����%%���% ���%����

�����������������%)���%(���%@���%&��� ���� ���� ���� %��� ��� ���� )���

����������������� (��� @��� &��������

����������#�� ������

����������#��"��

�����������������������������%��� �������)���(���@���&��������������

�����������������������%���� ���������)����(����@����&������������������

������������������%���� ���������)����(����@����&���%����%����%����%%���

�����������������% ���%����%)���%(���%@���%&��� ���� ���� ���� %��� ���

����������������� ���� )��� (��� @��� &�����

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

����������"������� �������������������������������������������F����%D�

������������������"�

����������������=��� =��?�= #""=�!����������������������������F����%D�

���>"� �����>"�C��������=���>"� �����>"��=

���>"������������>"�A�

����������#��"��

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

����������������=��� =��?�= ��� �=�!������������������������F����%D�

��������������������>"� �����>"��

!��������� ���������������������������������������������������F����%D�

���>"� �����>"�C����?#���<

!��������� ���������������������������������������������������F����%D�

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

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

������������������"�

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

���>"� �����>"������?#���<

���>"�������������>"�A�

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

��������������������������# ��"��D��"�����

������������������"�

���������""�����

���������""���""DB�

����������#��"��

����������#��� ������?#�<�������>"� �����>"���

���>������> ����������������>��C�

����������#��"��

�����������������=������?�==�! � �

����������������=�����%�=��?�==�!� �

���������"����������%�����>"� �����>"��

!� ������ �

�����������������C�

����������������=����"���������=��?�==�!����

����������������=����"���������=��?�=�=�!�� ��

����������������=����"���������=�������?�=A=�! ����"

�����������������=����"�����������?�= =�!����"

����������������=����"���������=�������?�=�=�!�� "�

���������"���������"��������������"���������

��������������!����

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

��������������!����

!����"�������������"������������� �&)�!������

���������"���������"��������������"���������

��������������!����

!�������������������"�������������%�()@�!�#""��

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

! ����"��� �

�""DB��������=����"���������=���(�

�����������������""DB�����%�()@�!�#""��

!��"�"���"���������"������������=����"���������=

��������������!����

!�#""����"���������"������������=����"���������=

��������������!����

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

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

!������������������"��%�!� �

�����������������=�# ��"� ��==�!������

!BD��"����������=�D��"�� ��==�!����

���>"� �����>"������?#���<

!���� ����������=�����?�==�!���� �

�����������������=���� ��==�!���

�����������������=��� ��==�!���

����������������=�����%�=� ��==�!���E

����������#��� �������������������>"� �����>"���

��������������!�����

!���E����#��� ����������������������%��

��������������!�����

!���������#��� ��������������������������>"� �����>"���

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

����������#��� ���������������������������>"� �����>"���

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

!���� ����������=�����%�=��?�==�!����

����������#��� ����������������������%��

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

!���������������=���� ��==�!��

�����������������=����?�==�!� "�

����������#��� �������"�������������������>"� �����>"���

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

!� "�����#��� �������������������>"� �����>"���

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

!����������������=��� ��==�!���

����������������=������=��?�==�!�� ��"�

����������������=������=������ ��=A=�!�� ��"�

��������������!�� ���

!���������������=�����=��?�==���=�������=��?�==�!�� ��"�

����������������=�������=�������?�=A=�!���� ��

�����������������=�������� ��= =�!�� ��"�

����������������=�����=�������?�=A=�!�� ���

�����������������=������ ��= =�!�� ��"�

���������������������������������!�� ���

!�� ��"���#��� �������"��������������������>"� �����>"���

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

!���� ����������=�����=������ ��=A=�!�� ��"�

����������������=�������=���(�����=�����=���(��!�� ��"�

!�� ������#��� ���������������������������>"� �����>"���

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

! � ������������=�D��"���?�==�! D��"�

�����������������=�# ��"� ��==�!����

��������������������>"� �����>"��

����������#��"��

���>"�������������>"�A�

���>"� �����>"�C����?#�<

����������������=�D��"��)�=��?�==�!B�#�"

�����������B� ������D��"�

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

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

!B�#�"����B� �������D��"������D��"������D��"��%���D��"�� ��������������

����������������D��"��������>"� �����>"���

����������������=�D��"����=��?�==�!"���"

����������#��� ����������>��"����>"� �����>"�C���

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

!"���"����#��� ����������>��"����>"� �����>"�C��������>"� �����>"���

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

! D��"����������=�# ��"��?�==�!���� �

���>"� �����>"������?#���<

!# ��������B� ������# ��"

����������#��� ���������A���>��"����>"� �����>"���

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

!���� ����������=���=� ��=� �=�!������

���>"� �����>"������?#���<

����������#��� �������������>"� �����>"���

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

!���� ��������=�D��"��)�=��?�==�!B

�����������B� ������D��"�

��������������!��� ��

!B��������B� �������D��"������D��"������D��"��%���D��"�� ��������������

����������������D��"��������>"� �����>"���

���������������� =�D��"�������!� ���

���>"� �����>"������������A���>��"����>"� �����>"�A��

��������������!�"���?#

!� ����� �

���>������> �C��������������>��

������������ ��������>������> �C��

!��� ����������A���>��"����>"� �����>"�A��

!�"���?#�� �

���> �������> ����������=����=!=���> �������> ��=��� �

�����������������=����� ��==�!���� �

��������������!# �

!��������� ��� �=����� �"������������� ���!��������"��� ��#���=

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

!��������� ��� �=# ��"�B��D���� ��"���D����� ���� ����#�!��� ���=

��������������!BD��"�

!��������� ��� �= �D��"��# ��"���� ���� ������������� ������!=

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

����������������������������������# ��"���D��"��

����������#�� �����

�����������������������������# ��"��D��"�����

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

����������������������������%��� �������)���(���@���&������������������

������������������%���� ���������)����(����@����&�������������������%���

������������������ ���������)����(����@����&���%����%����%����%%���% ���

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

�����������������%����%)���%(���%@���%&��� ���� ���� ���� %��� ��� ����

����������������� )��� (��� @��� &��������

������������������"�

����������#��"��

���> �������> ����������=����=!=���> �������> ��=��� �

�����������������������������%��� �������)���(���@���&��������������

�����������������������%���� ���������)����(����@����&������������������

������������������%���� ���������)����(����@����&���%����%����%����%%���

�����������������% ���%����%)���%(���%@���%&��� ���� ���� ���� %��� ���

����������������� ���� )��� (��� @��� &�����

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

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

�����������"�������>����������> �����>"�����>��

������������ �����>������> ��

���>���������������>��A�

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

���>"�������������>"�A�

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

��������������������������������������# ��"���D��"��

����������#��"��

����������#�� ��������

�����������������������������# ��"��D��"�����

����������#��"��

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

�����������������������������%��� �������)���(���@���&������������������

������������������%���� ���������)����(����@����&�������������������%���

������������������ ���������)����(����@����&���%����%����%����%%���% ���

�����������������%����%)���%(���%@���%&��� ���� ���� ���� %��� ��� ����

����������������� )��� (��� @��� &��������

�����������������������������%��� �������)���(���@���&��������������

�����������������������%���� ���������)����(����@����&������������������

������������������%���� ���������)����(����@����&���%����%����%����%%���

�����������������% ���%����%)���%(���%@���%&��� ���� ���� ���� %��� ���

����������������� ���� )��� (��� @��� &�����

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

�����������"��

������������������"�

���>"� �����>"�C��������=���>"� �����>"��=

���>"�������������>"�A�

����������#��"��

��������������������>"� �����>"�A%�

���>"� �����>"�C����?#���<

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

���> �������> ����������=���=!=���> �������> ��=� ���

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

���������� �"�

������������������"�

����������������=���> �������> ��=�%�����?�=�=�!�""� �

��������������������>"� �����>"�A%�

���>"� �����>"������?#���<

!�""� ��� �

���> �������> ����������=���=!=���> �������> ��=� ���

������������ ��������>������> ��

���>��������������>��A�

���>"�������������>"�A%

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

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

������������������"�

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

���>"� �����>"������?#���<

���>"�������������>"�A�

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

������������ ������������������D����

������������������"�

����������#�� ��������

����������#��"��

����������#��"��

�������������������>���������!���

���>��������������>��C�

���>�� �����>�������������

���>�� �����>�����������=���=

���>�#"�����>�������������

���>�����������D��

!�����"������������>���"����!�� ����

���>�#"�����>���������������>�#"�����>���C���>�#"�����>���

���>�������������>��A�

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

!�� ���������������>�#"�����>�����?� �!������

�������������������>�#"�����>������� �!�������

����������"���������A��D��

��������������!������

!��������������������D��A�

!��������������=�����=��?�=�=���=�����=��?�=��=�!����

����������#��"��

����������������������>"� �����>"��

���������"���������������

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

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

���>"� �����>"���������������>"� �����>"�A���

���>"�������������>"�A�

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

!������������������>"� �����>"�A�������

���> �������> ����������=����=!=���> �������> ��=��� �

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

!�������� ���@�=���"��������B��������!��#���������� �� ��� ��"��=

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

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

������������������"�

���������""���� �������

����������#��"��

���������������� =����"�����?���!"��#�"

� ������������� =����"���

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

!"��#�"��� �

� ������������� =����"������

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

���>�� �����>���������������>�� �����>���C� ��

!����#�"���������=����"����������?�==�� ��� ��� ����! ��#�"

���� ������������"������� ���

�������������!����#"�

! ��#�"�� �

���� ������������"����� ���

!����#"������������� A����� ����>�#"�����>����<���>�#"�����>���� ��C

�����������������! ��#"�

�������������������� ��?���! ��#"�

�������������������>���������!���

���>�������������>�C�

���>� ������>��������������

���>� ������>���������=���>"� �����>"��=

!���� ���� �

� �������������� ��A�

����������������� ��� ����!����#�"

!���������������=���> �������> ��=�%���� ��=�=�!��� �

���> �������> ����������=���=!=���> �������> ��=� ���

��������������!�?#� �

!��� ����������=���> �������> ��=� �����?�=�=�!�� ��

���������"��������>�� �����>�������>"� �����>"�A��

������������������>�� �����>���

��������������!�?#� �

!�� �������������>"� �����>"�A��

!�?#� ���� �

���>"� �����>"������?#���<

���>"�������������>"�A�

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

! ��#"��� ���@�=�������� ���"����!� ���#"���"�������>�#"�����>��C

����������������!=

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

���>�� �����>���������������>�� �����>���A�

��������������!���� ��

! ������� ���= �������������# ��D�����������=

��������������!�������

!�������� ���@�=���� #�������B��������!��#���������� �� ��� ��"��=

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

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

������������������"�

��������������&&&&&

���������""����B���

����������������=���> �������> ��=� �����?�=�=�!�����

���������"��������>�� �����>�������>"� �����>"�A��

������������������>�� �����>���

���>"� �����>"�A�������������>"� �����>"���

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

!�������� �

���>"� �����>"�A������������>"� �����>"��

!�"���������������>�� �����>����"����!�����

�B����������������>�#"�����>���

!"�� ��� �

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

!"�������������B��?����>� ������>�A��C���!�"� �

��������������������?����>�� �����>����!�� ���

�����������������C�

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

!�� ������������=���> �������> ��=� �����?�=�=�!�����

�������������������>"� �����>"���

��������������!� �B

!�"� �����������=���> �������> ��=� �����?�=�=�!����%

�������������������>� ������>�A��C���

��������������!����B

!����%�����������>� ������>�A��C��

!����B��� �

���>�� �����>���������������>�� �����>���A�

���>�������������>�A�

�������������������>�� �����>�����?���!�����

!"����������������?���!� �B

����������������A�

���>� ������>�A��C��������������>� ������>�A��C��

���>� ������>�A��C����������=���>� ������>�A��C��=

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

!����������������>"� �����>"��

!� �B���� �

�B��������������BC���>�#"�����>���

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

!�����������������>��"����!���B���

���>"� �����>"������?#���<

���>"�������������>"�A�

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

���>��������������>��A�

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

�������������������>���"����!���B���

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

!���B����� ���@�= �������������������B����!����� �� �� ��"��!=

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

�����������"������������

������������������"�

�����������"�����>���"����

�����������"������>��������

����������#�� �������"

���>��������> ������������=������=��?�=�����=�

���>���"����> ����������==

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

���������D�� ������������%��� �������)���(���@���&�������������������%��

������������������ ���������)����(����@����&�������������������%���� ���

�����������������������)����(����@����&���%����%����%����%%���% ���%����

�����������������%)���%(���%@���%&��� ���� ���� ���� %��� ��� ���� )���

����������������� (��� @��� &��������

������������������"�

�����������"�����>���"����

�����������"������>��������

�����������"������> ��"�����

����������������=���>���"����> ��=� ��==�!�������

����������������=���=��?�= �=�! ����

����������#��"��

���>���"����> ����������=���>"� �����>"��=

��������������!������

!������������������>��������> ���!���

������������������>���"����> ��

��������������! �

!��� ���������=���=��?�= �=�!�������

! ������ �

���>"� �����>"������?#���<

���>"�������������>"�A�

�������������������> ��"�����> ���!���D��

!��������� �

���> ��"�����> ���������������=���=��?�= �=�

����������������=���=� ��= �=�!���

�������������������>��������> ���!�������

����������#�� �������

����������#��"��

��������������!����

!��������#�� �������

����������#��"��

�����������������������������%��� �������)���(���@���&��������������

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

�����������������������%���� ���������)����(����@����&������������������

������������������%���� ���������)����(����@����&���%����%����%����%%���

�����������������% ���%����%)���%(���%@���%&��� ���� ���� ���� %��� ���

����������������� ���� )��� (��� @��� &�����

!���������� ��������

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

! ������ ���@�=== �==�� ��"���� �����������D�� �������"������#�C

���������������#��=

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

!��������� ���@�=== �==���� �� ��"���D����==��"��������===

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

!���D�� �� ���@�= �D�� �������� ���""D���������==D�� � �===

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

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

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

���������� ���"

������������������"�

�����������"�����>���"����

�����������"������>��������

�����������"������> ��"�����

�������������������>��������> ���!������

���>���"����> ������?#���<

�������������������> ��"�����> ���!� �

!��������� �

���>"� �����>"������?#���<

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

���>"�������������>"�A�

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

PPFGBLC0

�����������"������>��"���������������� �����������"�

�����������"������>����������������������������������# ���

�����������"������>��?������������������"���"� #������� �����

�����������"������>���������������������� ����������"� !��������B

�����������"������>��������������������� ������������ ��"�"� !���B�

�����������"������>���������������������������� �����B�

�����������"������>"��������������������� �������"���"� #�������B

�����������"������> �������������������������� ������B

�����������"������>�� ���������������������"��������B

�����������"������>� ���������������������� #�������B

�����������"������>�#"���������������������� #������#"���"���

�����������"������>���������������������� �����B�� �������������"���"

�����������"�����>� ������������������"���"� #�������B��������

�����������"�����>�� ������������������� ���#�� ���B��

�����������"�����>�� ������������������� ���#�� ���B��

!<���������"�����>���������������������� ���#�� ���B����� ������

!<���������"�����>��%������������������� ���#�� ���B����%�������

!<���������"�����>�� ������������������� ���#�� ���B���� �������

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

�����������"�����>�� �%����������������� ���#�� ���B�%

!<���������"�����>�%�������������������� ���#�� ���B�%��� ������

!<���������"�����>�%%������������������� ���#�� ���B�%��%�������

!<���������"�����>�% ������������������� ���#�� ���B�%�� �������

�����������"�����>�� � ����������������� ���#�� ���B�

!<���������"�����>� �������������������� ���#�� ���B� ��� ������

!<���������"�����>� %������������������� ���#�� ���B� ��%�������

�����������"�����>�� ������������������� ���#�� � �������B

�����������"�����>"� ������������������"���"� #�������B

�����������"�����> �������������������� ���� ����B

�����������"�����>�� ������������������������B������� �������

Pieter WiidSystems EngineerOutSource (South Africa) © Xephon 2002

Displaying multi-volume dataset details

INTRODUCTION

In our data centre we are using many multi-volume datasets because ofsome applications’ huge data needs. So we frequently need to know thedetails of each multi-volume dataset – such as on how many volumesit is allocated, how many extents, and how many tracks/cylinders it useson each volume.

To be able to see all volumes of a multi-volume dataset, normally the I(dataset information) command is issued in the dataset list panel that iscreated by the Dslist utility (ISPF Option 3.4) for non-VSAM datasets.The result panel will display the dataset, allocation volume, and a + signto show that the dataset spans multiple volumes. The dataset allocationattributes are the same for all spanned volumes. If a + sign is displayedthen the Enter key is pressed to display all the spanned volumes. All thevolumes that span a multiple volume dataset that the system will allowto be displayed will be shown. The number of volumes allocated to thisdataset will also be displayed. The same information can also be got byissuing the TSO LISTCAT command. However, when it comes togathering extents distribution throughout all volumes, neither methodcan help us. The only way is to issue the LISTDSI command and

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

interpret its variables within a REXX program.

Allocation details of a VSM multi-volume dataset can be obtained byissuing the TSO LISTCAT command. It gives all the volume names ofthe dataset, space allocation, and extents distribution throughout allvolumes.

To ease the manual procedures explained above, I came up with theREXX LISTMV, which extracts and displays all the details of multi-volume datasets on a dynamically-built panel in the REXX. This way,we can quickly take a look at all details of a multi-volume datasetwithout having to deal with overwhelming LISTCAT output. TheREXX will be in charge of interpreting LISTCAT command output forVSAM datasets and LISTDSI command variables for non-VSAMdatasets.

Displaying all the volume details of a multi-volume dataset on one ormore successive panels can help us draw some important conclusionsas well. For example, we can observe how many extents exist on a singledisk volume and see whether the volume is too fragmented andtherefore needs defragmenting.

HOW TO EXECUTE THE REXX LISTMV

First, the REXX has to be copied to one of your Sysproc or Sysexeclibraries. Although this REXX uses one or more panels, you don’t needto allocate any ISPPLIB libraries since the REXX will allocate atemporary panel library and build the necessary panels inside it. At theend, the REXX will free the panel library.

To execute it for a multi-volume dataset, the desired multi-volumedataset is displayed by using the Dslist utility (ISPF Option 3.4).LISTMV is written on the command line, then the Enter key is pressed.The REXX will use as many panels as necessary to display all the detailsof a multi-volume dataset. Note that each panel can have a maximumof 10 volume details, so details of a multi-volume dataset spanning 59volumes will fit up to 6 panels. On the last panel, we will see the totalspace usage and all extent distributions. As for VSAM datasets, theexact amount of allocated space and used extents will be separatelyshown for each component.

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

There is no problem issuing the LISTMV command for single-volumedatasets or any other type of dataset, such as PDSE datasets that can’tbe multi-volume. In this case, LISTMV will display a panel saying thatit’s not a multi-volume dataset and some characteristics, eg tapedataset, PO dataset, GDG dataset, on this panel.

SAMPLE EXECUTION

Sequential dataset:

������������#"����"#�����������������"�

�505�2+0'���!���!�����!��""��!��� ��

�89G3+�6.31;+�:505�2+0��������:505�2+0!

�.31;+���33.H���#2+:����/8;5/I����+H.9:��� 1;+,0���2+J

�����)��%@������%@��������@�������������������� ���

��������%�������%������������������������������%���

�������� ������� ������������������������������ ��%

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

��������%��������������������������������������%���

�-5H+�1980�����'��������B���.053�+,0+902���'�����@

�-5H+�533.H50+:'�����(@����� 1;!�.K�6.31;+2�'������

�-5H+�12+:�����'�����(����

�80�L�90+/M�0.�+,80!

VSAM (KSDS) dataset:

�������������#"����"#�����������������"�

��505�2+0'���!���!���!��"!����

���1308A6.31;+��:505�2+0��������:505�2+0!

��.31;+���33.H���.;-���/8;5/I����+H.9:���� 1;+,0���2+J

������%������%����������������������������������%���

�������������%����������������������������������%���

������ ��������������������������������������������%

������%������)��� ������������������������������)��

��-5H+�1980������'���B���B��������#��������'��89�0/5HN2�

��.0!+,0+902�����'�������)����.053�533.H����'�����������

� 1;!.K�6.3!�����'�����%������.053�533.H����'����������)

��80�L�90+/M�0.�+,80!

VSAM (ESDS) dataset:

�������������#"����"#�����������������"�

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

��505�2+0'��� ����!�� ��!��#����!����%�!�����!��%@

���1308A6.31;+��:505�2+0��������:505�2+0!

��.31;+���33.H���.;-���/8;5/I����+H.9:���� 1;+,0���2+J

������ ������������������������������%&�������������

������%����%&������������������������%&�������������

������%������&�����������������������%&������������%

�����������@�(�����������������������%&���������%��

��-5H+�1980������'����"�A��������#��������'��89�0/5HN2�

��.0!+,0+902�����'����%�������.053�533.H����'������(�&��

� 1;!.K�6.3!�����'����� ������.053�533.H����'�����������

��80�L�90+/M�0.�+,80!

WHAT’S THE MAXIMUM NUMBER OF VOLUMES FOR STORING AMULTI-VOLUME DATASET?

PDS and PDSE datasets are limited to one volume, and so can’t bemulti-volume datasets. Extended format sequential datasets with multiplestripes are limited to 16 volumes. A dataset on a VIO simulated deviceis limited to 65,535 tracks and is on one volume. A VSAM dataset canhave 255 extents (123 extents per volume) combined over all volumesof a multi-volume VSAM dataset. All other DASD datasets are limitedto 59 volumes. For this reason, the Data Class Volume Count field can’thave a value greater than 59.

Tape datasets are limited to 255 volumes. (This is not the scope of theREXX LISTMV though.) HFS datasets can expand to as many as 255extents of DASD space on multiple volumes (59 volumes maximumwith 123 extents per volume).

HOW ARE MULTI-VOLUME DATASETS ALLOCATED?

ISPF Option 3.2 provides the ability to allocate non-SMS or SMSmultiple volume datasets through the selection field. This field displaysa panel that allows users to enter the number of volumes or the namesof the volumes. For non-SMS datasets, if a number is entered, the nameswill be ignored. The allocation attributes entered on the allocation panelwill span all volumes entered. The value entered in the volume serialfield of the allocation panel will be the value that is placed in the firstvolume field of the multivolume allocation panel.

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

For SMS datasets, the names of volumes don’t make sense since SMSwill choose volumes. On the other hand, the number entered for thenumber of volumes field will override the volume count value definedin the dataset’s data class. For example, if the volume count is 5 in thedata class and we enter 2 in the allocation panel, then just two volumeswill be allocated for the dataset we’ve just defined.

SOME EXAMPLES OF DEFINING MULTI-VOLUME DATA SETS

VSAM multi-volume dataset allocation:

����"#����� ����,���"#���<�<�<�<���"� ����� ��

You can let SMS choose the volumes for SMS-managed datasets bycoding an asterisk (*) for the volser with the VOLUMES parameter. ForSMS-managed and non-SMS-managed datasets, you can specify up to59 volume serial numbers.

Non-VSAM multi-volume dataset allocation:

�""����=,!I=��"��"�@����"B��E����� �D����"������������������

�"� ����������������"������"#�����������������������%������"�%�

If it was an SMS dataset, we wouldn’t need to assign any volsernumbers. In this case, the dataset would be allocated on volumes whichSMS will decide. The following JCL requests that the system assignfive volumes to the dataset:

����� ������������ �� ���� !�������!�� �E�# ��������""������

����������"�%��"����������������"��"���&��"B��E��������������"��

The dataset in the following example will first allocate two volumes,serial numbers PEX101 and PEX102. The VOLUME volume countsubparameter requests four volumes, if required. Thus, if more space isrequired, the system can assign a third and fourth volume:

����� ������������ �� ���� !�������!����# �������""���

����������"�%��"����������������"��"���&��"B��E��������������"���

����"#������� ���������������������

LISTMV SOURCE

�<����<�

�<��+,,�����'�"820;6��������������������������������������������������<�

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

�<��19H08.9�'��82-35I2�;1308A6.31;+�:5052+0�:+05832!������������������<�

�5/2+��/G��8����������<��8�'��5052+0�95;+�����������������������������<�

�05012��2G�=KK=������<��1--/+22����;+225G+2�8221+:�7I�0O+�"820:28!��<�

�8����0/8-��8���P=P���<��+;.6+�7.0O�3+5:89G���3+5:89G�HO5/5H0+/2!�����<�

533�3+5/������������<�3+5/�65/8573+�95;+2�59:�6531+2�K/.;�-..3!����<�

533��.3H90�����������<��89:�6.31;+�H.190�K./�0O+�:5052+0!������������<�

�K��25;����O+9��������<��/.H+2289G�.K������:5052+02!������������������<�

�������533��/.H�25;

�����������32+��������<��/.H+2289G�.K�9.9A�����:5052+02!�����<�

�������533��/.H �25;

P�/++���P�:95;+P�P����<��/++�0O+�0+;-./5/I�-59+3�387/5/I!�������������<�

������<�589������<�

"���'

�<��9808538Q+�65/8573+2!�������������������������<�

�.0���R�.0���R�.0#��R�8G��R�.0�>���R�.0�>���R�2G��PPR�2G��PP

�359N��P�������������������������������������������P

P�2-+,+H��+/52+��N��N���N���N%��N ��N���N)�����/.K83+P

P�2-+,+H��+/52+��N(��N@��N&��N���N���N������/.K83+P

P�2-+,+H��+/52+��N�%�N� �N���N�)�N�(�N�@����/.K83+P

P�2-+,+H��+/52+��N�&�N���N���N���N�%�N� ����/.K83+P

P�2-+,+H��+/52+��N���N�)�N�(�N�@�N�&�N%�����/.K83+P

P�2-+,+H��+/52+��N%��N%��N%%�N% �N%��N%)����/.K83+P

P�2-+,+H��+/52+��N%(�N%@�N%&�N ��N ��N �����/.K83+P

P�2-+,+H��+/52+��N %�N �N ��N )�N (�N @����/.K83+P

P�2-+,+H��+/52+��N &�N���N���N���N�%�N� ����/.K83+P

P�2-+,+H��+/52+��N���N�)�N�(�N�@�N�&�N)�����/.K83+P

P�2-+,+H��+/52+���8�I��.0���.0���.0#��������/.K83+P

���#� ��<��9:A.KA0O+A-/.H+:1/+A"�����<�

�" �'

�25;�������������<��35G�0.�:+0+/;89+�8K�80=2�5������:5052+0�����������<�

�K2��������������<��35G�0.�:+0+/;89+�8K�80=2�5������:5052+0�����������<�

�:2+�������������<��35G�0.�:+0+/;89+�8K�80=2�5������:5052+0�����������<�

�:G��������������<��35G�0.�:+0+/;89+�8K�80=2�5������:5052+0�����������<�

�50��������������<��35G�0.�:+0+/;89+��25;�H.;-.9+90�0I-+��������������<�

90��������������<��35G�0.�:+0+/;89+�8K�5�:505�2+0�82�;1308A6.31;+S���<�

90��������������<��.053�6.31;+�H.190���������������������������������<�

90>�������������<��.053�6.31;+�H.190�K./��505��H.;-.9+90�.K����������<�

90>�������������<��.053�6.31;+�H.190�K./��9:+,�H.;-.9+90�.K����������<�

�8-5>������������<��.053�2-5H+�125G+��K./��505��H.;-.9+90�.K����������<�

�8-5>������������<��.053�2-5H+�125G+��K./��9:+,�H.;-.9+90�.K����������<�

�.0>�33.H�!������<��0+;�K./�533.H=:�2-5H+�.9�+5HO�6.3!.K�5��6�:5052+0�<�

�.0>�33.H�!������<��0+;�K./�533.H=:�2-5H+�.9�+5HO�6.3!.K�5��6�:5052+0�<�

�-5H+>�I-+����=A=R�-5H+>�I-+����=A=

����100/5-�=�5/05-6!=�

P"820H��90/I�P�8P���33P����������������������<��221+�P"820HP�H.;;59:!�<�

����100/5-�=KK=�

�K��9:+,�="#���������T� ����A=��1720/��5/05-6!����(���LM��

������������������������������������O+9��25;��

�K��9:+,��5/05-6!��=��������=��LM����O+9��:G��

�K��9:+,��5/05-6!(�=���=������LM����O+9��K2��

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

�K��9:+,��5/05-6!(�="������=��LM����O+9��:2+��

�.�1�����0.��5/05-6!�

�K��25;����O+9

����.

�������K��9:+,��1720/��5/05-�!1�������=�����TT=��LM����O+9��50����

�������K��9:+,��1720/��5/05-�!1�������=� ����TT=��LM����O+9��50����

����9:

�.32+/��1720/��5/05-6!1��)�)�

41��9:+,��5/05-6!1�=�"���T=�

�K��41�LM�����O+9��90����90��C��

�K��41�LM������.32+/�LM�=TT<=����50�������O+9�90�����90���C��

�K��41�LM������.32+/�LM�=TT<=����50�������O+9�90>����90>��C��

�K��41�LM������.32+/�LM�=TT<=����50�������O+9�90>����90>��C��

�K��9:+,��5/05-6!1�="DA��=��LM����O+9

����.

�����N1��9:+,��5/05-�!1�=���B�TT=�

������8-5����1720/��5/05-�!1�N1C)�������<��,0/5H0�0O+�2-5H+�5;.190!���<�

������8-5����/592350+��8-5�==�=A=�

������K��50����O+9��.

����������������������8-5>�����8-5>��C��8-5

����������������������K��-5H+>�I-+��"��O+9��8-5����8-5U��

����������������������.0>�33.H�!90>�����.0>�33.H�!90>��C��8-5

���������������������9:

������K��50����O+9��.

����������������������8-5>�����8-5>��C��8-5

����������������������.0>�33.H�!90>�����.0>�33.H�!90>��C��8-5

���������������������9:

����9:

�K���9:+,��5/05-�!1�=����A����A=��LM�����O+9

�����������.

�������������-5H+>�I-+�������1720/��5/05-�!1��@�� �

�������������-5H+>�I-+�������/592350+��-5H+>�I-+�==�=A=�

�������������K��-5H+>�I-+����"� �����O+9��-5H+>�I-+��"

�������������K��-5H+>�I-+������B�����O+9��-5H+>�I-+���B

�������������K��50������O+9��-5H+>�I-+�����-5H+>�I-+

�������������K��50������O+9��-5H+>�I-+�����-5H+>�I-+

�����������9:

�K���9:+,��5/05-�!1�=����A���T=��LM�����O+9

���.

����K��50������O+9

��������.

����������-5H+>�/8;�����1720/��5/05-�!1��(��)�

����������-5H+>�/8;�����/592350+��-5H+>�/8;��==�=A=�

��������9:

����K��50������O+9

��������.

����������-5H+>�/8;�����1720/��5/05-�!1��(��)�

����������-5H+>�/8;�����/592350+��-5H+>�/8;��==�=A=�

��������9:

���9:

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

�K���9:+,��5/05-�!1�=����A��T=��LM�����O+9

���.

����K��50������O+9

��������.

����������-5H+>�+H�����1720/��5/05-�!1�� �&�

����������-5H+>�+H�����/592350+��-5H+>�+H��==�=A=�

��������9:

����K��50������O+9

��������.

����������-5H+>�+H�����1720/��5/05-6!1�� �&�

����������-5H+>�+H�����/592350+��-5H+>�+H��==�=A=�

��������9:

���9:

� �

�<��������������B������=�����#"��A�"#�����������S������������������<�

�<��.�:+0+/;89+�8K�:5052+0�82�;1308A6.31;+�.9+��V+�H.13:�HO+HN�0O+����<�

�<��I2/+52.9�6531+�.K�"�������K19H08.9!��K��I2/+52.9�82��&�0O+9�80=:��<�

�<�7+�5�;1308A6.31;+�:5052+0!�����������������������������������������<�

�<��.V+6+/�8K�5�;1308A6.31;+�:2+0��50�0O+�;.;+90��/+28:+2�.9�5�289G3+�<�

�<�6.31;+��0O+9�0O82�K19H08.9�H59=0�K8G1/+�80�.10�59:�5221;+2�0O50����<�

�<�80=2�5�289G3+�6.31;+�:5052+0!��./�0O82�/+52.9��O+/+�V+�05N+�890.���<�

�<�5HH.190�0O+�91;7+/�.K�P�"���TP�20/89G2�89�0O+�"������.10-10!�����<�

�<��K�0O+/+�5/+�50�3+520�0V.�20/89G2�0O+9�0O50�:5052+0�V833�/+G5/:+:��<�

�<�52�5�;1308A6.31;+�:5052+0!�����������������������������������������<�

�<� .0+'��505�H.;-.9+90����9:+,�H.;-.9+90�6.31;+2�5/+�H.190+:���������<�

�<�2+-5/50+3I!��.��89�./:+/�5������:2+0�0.�7+�5�;1308A6.31;+��0.053���<�

�<�6.31;+�H.190�2O.13:�7+�G/+50+/�0O59��!�����������������������������<�

�K��25;����O+9

���.

�����K�90�M���O+9��2G��P�1308A6.31;+��:5052+0P

���������������32+��2G��P�89G3+�6.31;+�:5052+0P

����90���90>�P�P90>�

���9:

�����������32+

���.

�����K��90�M�����:G�����O+9��2G��P�1308A6.31;+��:5052+0P

�������������������������32+��2G��P�89G3+�6.31;+�:5052+0P

���9:

���#� ����<��9:A.KA0O+A-/.H+:1/+A�" ��<�

������'

�2G��P�����:505�2+0!P

�8G��

�.� 1�����0.���<���90>�C90>��U�����7I���

����93���P�59P 1

����K� 1������O+9��3G����R�32+��3G����

����K�90�M�� 1��O+9

������������������.

������������������533��/.H+22>�25;

������������������533��59+3>�25;

������������������9:

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

�9:

���#� ��<��9:A.KA0O+A-/.H+:1/+A�������<�

�����>����'

����100/5-�=�+/952�!=�

P"820H��90/I�P�8P���33.H508.9P

����100/5-�=KK=�

I������<��O82�65/8573+�82�12+:�0.�K89:�0.053�6.31;+�H.190!�<�

�.�H���0.��+/952�!�

�K��9:+,��1720/��+/952�!H�������=�����TT=��LM����O+9��50����

�K��9:+,��1720/��+/952�!H�������=� ����TT=��LM����O+9��50����

�K���9:+,��+/952�!H�=�"���TT=��LM������

������9:+,��+/952�!H�=�"���TTTTTTTT<=�������O+9

�����.

�����I���I�C����������������������������<��9H/+;+90��.31;+>H.190�<�

������.32+/�����1720/��+/952�!H��)�)�

������,0��������1720/��+/952�!H���)�%�

������,0��������/592350+��,0�==�=A=�

�����N�������-5H+>�I-+�P�P�-5H+>�I-+�

������K��50������O+9

������

������.;-.9+90����505

�������.0���8-5>�

�������.0�>�����.0�>��C��,0

�������.-��.32+/��WWP�PWW�.0>�33.H�!IWWP�PWW.;-.9+90WWP

PWW�-5H+>�/8;�WWP

PWW�

�������-5H+>�+H�WWP�PWW�,0

������ �

������K��50������O+9

������

������.;-.9+90����9:+,

�������.0#��8-5>�

�������.0�>�����.0�>��C��,0

������5���IA90>�

�������.-��.32+/��WWP�PWW�.0>�33.H�!5WWP�PWW.;-.9+90WWP

PWW�-5H+>�/8;�WWP

PWW�

�������-5H+>�+H�WWP�PWW�,0

������ �

������.0�����.0�>�P�P�.0�>�

������K�I������O+9��.

��������������������5/2+������.-�N��N��N%�N �N��N)

�������������������P�2-+,+H��-10��N��N��N��N%�N �N��N)���/.K83+P

��������������������9:

������K�I������O+9��.

��������������������5/2+������.-�N(�N@�N&�N���N���N��

�������������������P�2-+,+H��-10��N��N(�N@�N&�N���N���N�����/.K83+P

��������������������9:

������K�I���%��O+9��.

��������������������5/2+������.-�N�%�N� �N���N�)�N�(�N�@

31© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

�������������������P�2-+,+H��-10��N�%�N� �N���N�)�N�(�N�@���/.K83+P

��������������������9:

������K�I��� ��O+9��.

��������������������5/2+������.-�N�&�N���N���N���N�%�N�

�������������������P�2-+,+H��-10��N�&�N���N���N���N�%�N� ���/.K83+P

��������������������9:

������K�I������O+9��.

��������������������5/2+������.-�N���N�)�N�(�N�@�N�&�N%�

�������������������P�2-+,+H��-10��N���N�)�N�(�N�@�N�&�N%����/.K83+P

��������������������9:

������K�I���)��O+9��.

��������������������5/2+������.-�N%��N%��N%%�N% �N%��N%)

�������������������P�2-+,+H��-10��N%��N%��N%%�N% �N%��N%)���/.K83+P

��������������������9:

������K�I���(��O+9��.

��������������������5/2+������.-�N%(�N%@�N%&�N ��N ��N �

�������������������P�2-+,+H��-10��N%(�N%@�N%&�N ��N ��N ����/.K83+P

��������������������9:

������K�I���@��O+9��.

��������������������5/2+������.-�N %�N �N ��N )�N (�N @

�������������������P�2-+,+H��-10��N %�N �N ��N )�N (�N @���/.K83+P

��������������������9:

������K�I���&��O+9��.

��������������������5/2+������.-�N &�N���N���N���N�%�N�

�������������������P�2-+,+H��-10��N &�N���N���N���N�%�N� ���/.K83+P

��������������������9:

������K�I������O+9��.

��������������������5/2+������.-�N���N�)�N�(�N�@�N�&�N)�

�������������������P�2-+,+H��-10��N���N�)�N�(�N�@�N�&�N)����/.K83+P

��������������������9:

�����9:

� �

P�2-+,+H��-10���.0���.0#��.0���8�I���/.K83+P

���#� ����<��9:A.KA0O+A-/.H+:1/+A�����>�����<�

�� �">����'

�::/+22��2.

�:95;+�=�5/05-6=

�K��3G����O+9�P�33.H��8�P�:95;+P���+12+� +V��+3��2.��.���8/�����-���P��

��������������P�/5HN��+HK;������"/+H3�@���#980��I2:5�P

����������32+�P�33.H��8�P�:95;+P���+12+��O/P

�::/+22��2-+,+H

P";8980��5058:��8:���:95;+�P�:95;+P���9J��,H31�P

P";.-+9��5058:���8:��-08.9�10-10�P

533��10�P�����������������������������������������������������P

533��10�P�>��������������"��D����������������"����#����P

533��10�P�F��������������"�������������������"����#����P

533��10�P�X��������������"����""D���#���������������������P

533��10�P�C��������������"���#�?������������#���"��������P

533��10�P�S��������������"���"#��������������"������������P

533��10�P����������������"�����������"������������P

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

533��10�P�$������#��#���"������ ���������P

533��10�P�Y������#��#���"���� B������������#������������P

533��10�P�Z������#��#���"���"#�������������#������������P

�+3+H0

DO+9��90����������������O+9�533��10�=�����D� �D��(����=

DO+9���90M������I�M�&���O+9�533��10�=�����D� �D��(��@�=

DO+9���90M������I�L�&���O+9�533��10�=�����D� �D��(�=IC��=�=

DO+9��90L���������������O+9�533��10�=�����D� �D��(�=IC��=�=

�9:

533��10�PS������������#"����"#����������������"������P

533��10�PC���������������������������������������������P

533��10�PX�505�2+0'$EP�1720/��359N� �A"+9G0O��8��PCP

533��10�P�P��2G�������������������������P�P��2G�

533��10�PC�.31;+���33.H���.;-���/8;5/I����+H.9:���� 1;+,0���2+JP

�K�IM���O+9�533��10�PYE�����YE�����YE�����YE�������YE�������YE�������XP

1C�

�K�IM���O+9�533��10�PYE�����YE�����YE�����YE�������YE�������YE�������XP

1C�

�K�IM���O+9�533��10�PYE�����YE�����YE�����YE�������YE�������YE�������XP

1C%

�K�IM%��O+9�533��10�PYE�����YE�����YE�����YE�������YE�������YE�������XP

1C

�K�IM ��O+9�533��10�PYE�����YE�����YE�����YE�������YE�������YE�������XP

1C�

�K�IM���O+9�533��10�PYE�����YE�����YE�����YE�������YE�������YE�������XP

1C)

�K�IM)��O+9�533��10�PYE�����YE�����YE�����YE�������YE�������YE�������XP

1C(

�K�IM(��O+9�533��10�PYE�����YE�����YE�����YE�������YE�������YE�������XP

1C@

�K�IM@��O+9�533��10�PYE�����YE�����YE�����YE�������YE�������YE�������XP

1C&

�K�IM&��O+9�533��10�PYE�����YE�����YE�����YE�������YE�������YE�������XP

1C��

533������10�PCP

�K�I�L��&�W��90������O+9

���.

����533��10�PC�-5H+�1980������'ZE������C�������#��������'��89

0/5HN2�P

����533��10�PC�.0!+,0+902�����'ZE������C���.053�533.H����'ZE���������CP

����533��10�PC 1;!.K�6.3!�����'ZE������C���.053�533.H����'ZE���������CP

����533��10�PCP

����533��10�P>�80FL�90+/M>0.�+,80!CP

���9:

���32+�533��10�P>�80FL�90+/M>0.�68+V�0O+�9+,0�-5G+!CP

533��10�P��980������������������������������������������P

533��10�P!E65/2�=��8�����������������������������������CP

�K�IM����O+9�533��10�P���������N��N��N%�N �N��N)�������CP

�K�IM����O+9�533��10�P���������N(�N@�N&�N���N���N������CP

�K�IM����O+9�533��10�P���������N�%�N� �N���N�)�N�(�N�@�CP

33© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

�K�IM�%��O+9�533��10�P���������N�&�N���N���N���N�%�N� �CP

�K�IM� ��O+9�533��10�P���������N���N�)�N�(�N�@�N�&�N%��CP

�K�IM����O+9�533��10�P���������N%��N%��N%%�N% �N%��N%)�CP

�K�IM�)��O+9�533��10�P���������N%(�N%@�N%&�N ��N ��N ��CP

�K�IM�(��O+9�533��10�P���������N %�N �N ��N )�N (�N @�CP

�K�IM�@��O+9�533��10�P���������N &�N���N���N���N�%�N� �CP

�K�IM�&��O+9�533��10�P���������N���N�)�N�(�N�@�N�&�N)��CP

�K�I�L��&�W��90�������O+9�533��10�P�N���.0���.0��90��.0#�=P

�����������������������32+�533��10�P�����������������������=P

533��10�P��/.H�����������������P

533��10�P��9:������������������P

P";;5::��5058:���8:���+;7+/�P�93P�P

P";K/++��5058:���8:�P

P"87:+K��2--387�"87/5/I��:�P�:95;+P�P

P�::-.-P

P�82-35I��59+3�P�93P�P

P�+;-.-P

P"87:+K��2--387P

���#� ��<��9:A.KA0O+A-/.H+:1/+A�� �">����<�

�� ����'

�0/������P�;289K.� ./+H533P��<��9�H52+�5�;8G/50+:�:2+0��:.9=0�/+H533!�<�

,���"820:28��0/��

�K�������� �%���O+9��;2��������������������<��K��;2���0O+9� .A�������<�

�����������������32+��;2��������������������<��K��;2���0O+9�����:2+0!�<�

�2G�����I2:2./G�P�:505�2+0!P

�K���:2+����[���K2����[���:G�����O+9��8G��

�K��:G�����O+9��.R�2G��P�����:505�2+0!PR90��R�9:

�K��:2+����O+9�����2G��P�����:505�2+0!P

�K��K2�����O+9�����2G��P�����:505�2+0!P

�K�������� �������O+9��.R�K��:G����O+9

���������������������������2G��P#9H5053.G1+:�:505�2+0PR�8G��R�9:

�K�������� ����@��O+9��.R�2G��P�5-+�:5052+0����P���R�8G��R90��R�9:

�K�������� ����&��O+9��.R�2G��P�8G/50+:�:5052+0P���R�8G��R�9:

�<��59+3�O59:389G!��0�;.20����-59+32�H59�7+�510.;508H533I�71830�59:���<�

�<�0O+9�:82-35I+:!���5HO�-59+3�H59�O56+�.93I����6.31;+�:+05832�59:����<�

�<�;5,8;1;�91;7+/�.K�6.31;+2�0O50�H59�7+�12+:�0.�20./+�5�;1308A6.31;+�<�

�<�:505�2+0�82��&!��./�0O82�/+52.9����-59+32�V833�7+�+9.1GO!����������<�

�.� 1�����0.���<��90U�����7I���

�������93���P�59P 1

�������<��3G�65/8573+�82�12+:�0.�H/+50+�0O+�0+;-./5/I��59+3����<�

�������<�387/5/I�.93I�.9H+!��K��3G���0O+9�80=33�7+�H/+50+:�59:�<�

�������<�533.H50+:!��K��3G���0O+9�80=33�7+�.93I�533.H50+:!�����<�

�������K� 1������O+9��3G����R�32+��3G����

�������K�90�M�� 1��O+9

��������������������.

���������������������533��/.H+22> .9�25;

���������������������533��59+3> 625;

��������������������9:

�9:

���#� ��<��9:A.KA0O+A-/.H+:1/+A�� �����<�

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

�����> ����'

�K��;2������O+9�18������������������<�"820H�.10-10�K./����A;595G+:����<�

������������32+�18���(��������������<�:5052+0�:8KK+/2�K/.;�.10-10�����<�

������������������������������������<�K./�9.9A����;595G+:�:5052+02!���<�

I������<��O82�65/8573+�82�12+:�0.�K89:�0.053�6.31;+�H.190!������������<�

�.�1��� 1C18�0.��5/05-6!�������<��.A�����<�

�.32+/��1720/��5/05-6!1��)�)�

41��9:+,��5/05-6!1�=�"���T=�

�K��41�LM������.32+/�LM�=TT<=���O+9

�.����������������������������<��.A�����<�

���K��8GLM���O+9�I����

�������������32+�I���I�C�����������<��9H/+;+90��.31;+>H.190���<�

���0/�������P�.31;+�P�.32+/P�P

��,������"820:28��0/��

��N�������I219802��<��-5H+�19802'��"� ��������B���"B�<�

���K��:2+����O+9��I212+:����I212+:-5G+2WWP-!P

���.-��.32+/WWP�PWW����""WWP�PWW���#���WWP�PWW����������WWP�PWW�

��������� ��WWP�PWW������� ��

���K�I������O+9��.

������������������5/2+������.-�N��N��N%�N �N��N)

������������������K��8GLM���O+9��.

�����������������������������K��:G����O+9�N��P ��P

�����������������������������.0��P ��PR�.0#�P ��PR�.0��P ��PRN��P ��P

�����������������������������9:

��������������������32+��.

��������������������������.0�����.0��C�N�R�.0#����.0#�C�N%R�.0���.0�CN)

�������������������������P�2-+,+H��-10��N��N��N��N%�N �N��N)���/.K83+P

�������������������������9:

�����������������9:

���K�I������O+9��.R�5/2+������.-�N(��N@��N&��N���N���N��

��������������������.0�����.0��C�N@R�.0#����.0#�C�N&R�.0���.0�CN��

�������������������P�2-+,+H��-10��N(�N@�N&�N���N���N�����/.K83+PR�9:

���K�I���%��O+9��.R�5/2+������.-�N�%�N� �N���N�)�N�(�N�@

��������������������.0�����.0��C�N� R�.0#����.0#�C�N��R�.0���.0�CN�@

�������������������P�2-+,+H��-10��N�%�N� �N���N�)�N�(�N�@���/.K83+PR�9:

���K�I��� ��O+9��.R�5/2+������.-�N�&�N���N���N���N�%�N�

��������������������.0�����.0��C�N��R�.0#����.0#�C�N��R�.0���.0�CN�

�������������������P�2-+,+H��-10��N�&�N���N���N���N�%�N� ���/.K83+PR�9:

���K�I������O+9��.R�5/2+������.-�N���N�)�N�(�N�@�N�&�N%�

��������������������.0�����.0��C�N�)R�.0#����.0#�C�N�(R�.0���.0�CN%�

�������������������P�2-+,+H��-10��N���N�)�N�(�N�@�N�&�N%����/.K83+PR�9:

���K�I���)��O+9��.R�5/2+������.-�N%��N%��N%%�N% �N%��N%)

��������������������.0�����.0��C�N%�R�.0#����.0#�C�N%%R�.0���.0�CN%)

�������������������P�2-+,+H��-10��N%��N%��N%%�N% �N%��N%)���/.K83+PR�9:

���K�I���(��O+9��.R�5/2+������.-�N%(�N%@�N%&�N ��N ��N �

��������������������.0�����.0��C�N%@R�.0#����.0#�C�N%&R�.0���.0�CN �

�������������������P�2-+,+H��-10��N%(�N%@�N%&�N ��N ��N ����/.K83+PR�9:

���K�I���@��O+9��.R�5/2+������.-�N %�N �N ��N )�N (�N @

��������������������.0�����.0��C�N R�.0#����.0#�C�N �R�.0���.0�CN @

�������������������P�2-+,+H��-10��N %�N �N ��N )�N (�N @���/.K83+PR�9:

35© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

���K�I���&��O+9��.R�5/2+������.-�N &�N���N���N���N�%�N�

��������������������.0�����.0��C�N��R�.0#����.0#�C�N��R�.0���.0�CN�

�������������������P�2-+,+H��-10��N &�N���N���N���N�%�N� ���/.K83+PR�9:

���K�I�������O+9��.R�5/2+������.-�N���N�)�N�(�N�@�N�&�N)�

��������������������.0�����.0��C�N�)R�.0#����.0#�C�N�(R�.0���.0�CN)�

�������������������P�2-+,+H��-10��N���N�)�N�(�N�@�N�&�N)����/.K83+PR�9:

�9:��<��9:��.A�����<�

�9:���<��9:��.A�����<�

P�2-+,+H��-10���.0���.0#��.0���8�I���/.K83+P

���#� ����<��9:A.KA0O+A-/.H+:1/+A�����> �����<�

�� �"> ����'

�::/+22��2.

�:95;+�=�5/05-6=

�K��3G����O+9�P�33.H��8�P�:95;+P���+12+� +V��+3��2.��.���8/�����-���P��

��������������P�/5HN��+HK;������"/+H3�@���#980��I2:5�P

����������32+�P�33.H��8�P�:95;+P���+12+��O/P

�::/+22��2-+,+H

P";8980��5058:��8:���:95;+�P�:95;+P���9J��,H31�P

P";.-+9��5058:���8:��-08.9�10-10�P

533��10�P�����������������������������������������������������P

533��10�P�>��������������"��D����������������"����#����P

533��10�P�F��������������"�������������������"����#����P

533��10�P�X��������������"����""D���#���������������������P

533��10�P�C��������������"���#�?������������#���"��������P

533��10�P�S��������������"���"#��������������"������������P

533��10�P����������������"�����������"������������P

533��10�P�$������#��#���"������ ���������P

533��10�P�Y������#��#���"���� B������������#������������P

533��10�P�Z������#��#���"���"#�������������#������������P

�+3+H0

DO+9��90����������������O+9�533��10�=�����D� �D��(����=

DO+9���90M������I�M�&���O+9�533��10�=�����D� �D��(��@�=

DO+9���90M������I�L�&���O+9�533��10�=�����D� �D��(�=IC��=�=

DO+9��90L���������������O+9�533��10�=�����D� �D��(�=IC��=�=

�9:

533��10�PS������������#"����"#����������������"������P

533��10�PC���������������������������������������������P

533��10�PX�505�2+0'$EP�1720/��359N� �A"+9G0O��8��PCP

533��10�P�P��2G�������������������������P�P��2G�

�K�I�LM����O+9

������533��10�PC�.31;+���33.H���#2+:����/8;5/I����+H.9:��� 1;+,0

�2+JP

�������32+�533��10�PCP

�K�IM���O+9�533��10�PYE�����YE�����YE������YE�������YE�������YE������XP

1C�

�K�IM���O+9�533��10�PYE�����YE�����YE������YE�������YE�������YE������XP

1C�

�K�IM���O+9�533��10�PYE�����YE�����YE������YE�������YE�������YE������XP

1C%

�K�IM%��O+9�533��10�PYE�����YE�����YE������YE�������YE�������YE������XP

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

1C

�K�IM ��O+9�533��10�PYE�����YE�����YE������YE�������YE�������YE������XP

1C�

�K�IM���O+9�533��10�PYE�����YE�����YE������YE�������YE�������YE������XP

1C)

�K�IM)��O+9�533��10�PYE�����YE�����YE������YE�������YE�������YE������XP

1C(

�K�IM(��O+9�533��10�PYE�����YE�����YE������YE�������YE�������YE������XP

1C@

�K�IM@��O+9�533��10�PYE�����YE�����YE������YE�������YE�������YE������XP

1C&

�K�IM&��O+9�533��10�PYE�����YE�����YE������YE�������YE�������YE������XP

1C��

533��10�PCP

�K�I�L��&�W��90������O+9

���.

����533��10�PC�-5H+�1980�����'�ZE�������C��.053�+,0+902���'ZE����CP

����533��10�PC�-5H+�533.H50+:'�ZE�������C� 1;!�.K�6.31;+2�'ZE����CP

����533��10�PC�-5H+�12+:�����'�ZE�������C������������������������CP

����533��10�PCP

����533��10�P>�80FL�90+/M>0.�+,80!CP

���9:

���32+�533��10�P>�80FL�90+/M>0.�68+V�0O+�9+,0�-5G+!CP

533��10�P��980������������������������������������������P

533��10�P!E65/2�=��8�����������������������������������CP

�K�IM����O+9�533��10�P���������N��N��N%�N �N��N)�������CP

�K�IM����O+9�533��10�P���������N(�N@�N&�N���N���N������CP

�K�IM����O+9�533��10�P���������N�%�N� �N���N�)�N�(�N�@�CP

�K�IM�%��O+9�533��10�P���������N�&�N���N���N���N�%�N� �CP

�K�IM� ��O+9�533��10�P���������N���N�)�N�(�N�@�N�&�N%��CP

�K�IM����O+9�533��10�P���������N%��N%��N%%�N% �N%��N%)�CP

�K�IM�)��O+9�533��10�P���������N%(�N%@�N%&�N ��N ��N ��CP

�K�IM�(��O+9�533��10�P���������N %�N �N ��N )�N (�N @�CP

�K�IM�@��O+9�533��10�P���������N &�N���N���N���N�%�N� �CP

�K�IM�&��O+9�533��10�P���������N���N�)�N�(�N�@�N�&�N)��CP

�K�I�L��&�W��90�������O+9�533��10�P�N���.0���.0��90��.0#�=P

�����������������������32+�533��10�P�����������������������=P

533��10�P��/.H�����������������P

533��10�P��9:������������������P

P";;5::��5058:���8:���+;7+/�P�93P�P

P";K/++��5058:���8:�P

P"87:+K��2--387�"87/5/I��:�P�:95;+P�P

P�::-.-P

P�82-35I��59+3�P�93P�P

P�+;-.-P

P"87:+K��2--387P

���#� ��<��9:A.KA0O+A-/.H+:1/+A�� �"> �����<�

�#�'

�5/2+��/G��/;�����<��/;�'��+H./:�0.�7+�V/800+9�<�

37© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

P";-10��5058:���8:���.:+��965/���5053.H��/;���5053+9�@��P

���#� ��<��9:A.KA0O+A-/.H+:1/+A�#�����<�

Atalay GulSystems ProgrammerEDS Barcelona (Spain) © Xephon 2002

Maintaining a DASD configuration – revisited

In the article entitled Maintaining a DASD configuration, in MVSUpdate, Issue 187, April 2002, I unfortunately neglected to include theactual bit of REXX that generates the back-ups. It’s called GENBKUPS.

GENBKUPS

�<��������������������������������������������������������������<�

�<���� �B#��'�/+50+��133��5HN�������75HNA1-2�2180+2��1289G�0O+�<�

�<���������������B��;+;7+/�52�2.1/H+!��������������������������<�

�<������������32.�H/+50+2�0O+�=�������=�2050+;+902�K./�+5HO�����<�

�<�����������.K�0O+�75HNA1-�2180+2�89�=�?����)!����!����=��89�<�

�<�����������0O+�25;+�;+;7+/�95;+�52�82�12+:�K./�0O+�75HNA1-2���<�

�<������������8+��B���,��VO+/+�=,=�82�0O+�2180+�21KK8,�!�������<�

�<����������� .0+�0O50�=�B���F=�82�5�2-+H853�2180+�VO8HO�V833��<�

�<�����������7+�G+9+/50+:�H.9058989G�59I�:82N2�VO8HO�O56+�5�=S=�<�

�<�����������89�=����B�=!��O82�8;-38+2�0O50�0O+�:82N�O52�7++9��<�

�<�����������89808538Q+:��710�0O50�9.��B���A�2180+�O52�I+0�����<�

�<�����������7++9�5228G9+:�0.�80!�������������������������������<�

�<��������������������������������������������������������������<�

�<������������K�0O+�=G+9>4.72=�65/8573+�82�2+0�0.�=�=�0O+9�0O+��<�

�<�����������5H0153�75HNA1-��"�V833�7+�H/+50+:��533.V89G�5�4.7�<�

�<�����������2HO+:13+/�0.�217;80�0O+�75HNA1-2��8920+5:�.K�0O+���<�

�<�����������-+/50./2�685�-59+32!� .0+�0O50�0O82�K19H08.9�82���<�

�<�����������.93I�6538:�VO+9�5�-5/;�.K�=�=�82�-522+:��8;-3I89G��<�

�<�����������V+�5/+�/19989G�89�750HO��52�0O+�-/.H+22�82�J180+���<�

�<�����������23.V!����������������������������������������������<�

�<��������������������������������������������������������������<�

�<��/5H+�8/�<�

�5/2+�#--+/��/G�-5/;�!

�<��O+2+�5/+�6538:�95;+2�VO8HO�;5I�7+�12+:�K./�75HNA1-�2180+2!��<�

7N1-2���P�������������������B�"��� ����?�������#���D�����E������P

7N1-2���7N1-2P�%� ���)�(�@�&�FP

G+9>4.72���P P�������������������<��.��.9=0�G+9+/50+�5H0153�4.72��<�

+90/8+2���D./:2�7N1-2����������������<� 1;7+/�.K�+90/8+2�0.�8980��<�

75:.9+2���P P������������������������<� .�:.:GI�.9+2�K.19:��I+0���<�

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

:K����P��������� �������@!����!!�B���P

:K����P��"�������������� ������P

H.:+����

�K�-5/;���P�P��O+9��.

���5I�PMMM��05/089G��5HN1-��180+�������52+�59:��133-5HN��"��+9+/508.9'P

���5I�PMMM������������������������������������������������������������P

�9:

�32+��.

���5I�PMMM��05/089G��5HN1-��180+�59:������52+��+9+/508.9'P

���5I�PMMM����������������������������������������������P

�9:

�.�5�����0.�+90/8+2

��21KK,���D./:�7N1-2�5���������������<��+0�+5HO�21KK8,������������<�

���90+/-/+0�P���P21KK,P!����==P������<��9808538Q+�533�0573+2!!!���<�

���90+/-/+0�P���P21KK,P�B�����P������<�!!!0.053�:82N2�K./�2180+���<�

�9:

�<��+5:�0O+�P�?����)!����! ��"�����B��P�;+;7+/��59:�������<�

�<�H/+50+�0O+�/+3+6590�:505�89�P�?����)!����!��B#��P!��������<�

�::/+22�P��P

P�""����� �#������=�?����)!����! ��"�����B��=�����P

P�����<����B��� �#����0+;�89-0!��� ��P

P��������� �#��P

�<��+5:�89�0O+�:505�K/.;�P����B�P�59:�2-380�.10�890.�/+3+6590���<�

�<�75HNA1-�2180+�20+;�65/8573+2��K./;50�82�P���,!P��VO+/+�=,=�82�<�

�<�0O+�2180+�95;+�K/.;�0O+�0573+�57.6+�!!!�����������������������<�

�.�5�����0.�89-0!�

���5/2+�#--+/��5/�89-0!5�5::/�6.38:�0I-+�2180+�H.;�/+H20/�!

���K�2180+���P �P��O+9�������<� .�75HNA1-2�8K�9.0�/+J18/+:��������<�

�����0+/50+

���K�5::/���P<P��O+9�����������<��G9./+�H.;;+902�H5/:2��������������<�

�����0+/50+

���K�5::/���P����P��O+9��������<��G9./+�O+5:+/2���������������������<�

�����0+/50+

��21KK,����8GO0�2180+���

���K�21KK,���PSP��O+9��.

����21KK,���PFP

����75:.9+2���P�P

���9:

���90+/-/+0�P���P21KK,P�B�������P21KK,P�B��C��P

��:+60���P,,,,P

���K�0I-+���P&%P��O+9�:+60���P%%&�P

���K�0I-+���P@�P��O+9�:+60���P%%@�P

���K�0I-+���P@�P��O+9�:+60���P%%@�P

���K�0I-+���P@�P��O+9�:+60���P%%@�P

���90+/-/+0�P�"P21KK,P!���P21KK,P�B����6.38:�5::/�:+60�H.;P

��:+KG:G���:K�\\21KK,P!P6.38:\\:K�

���90+/-/+0�P���P21KK,P!���P21KK,P�B����:+KG:GP

�9:

�<��K�59I�+90/8+2�O56+�7++9�H/+50+:�K./�5�75HNA1-�2180+�0O+9�V/80+��<�

�<�0O+;�0.�0O+�/+3+6590�;+;7+/!!!�����������������������������������<�

39© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

�.�5�����0.�+90/8+2

��21KK,���D./:�7N1-2�5���������������<��+0�+5HO�21KK8,������������<�

���90+/-/+0�P7NH0������P21KK,P�B�P���<��+0�H.190�K./�0O82�21KK8,��<�

���K�7NH0�M�)���O+9������������������<�6+/�)��89�2180+�82�9.�G..:<�

����533��>�� �

���90+/-/+0�P���P21KK,P!�������P21KK,P�B�P

���K�7NH0�LM����O+9��.���������������<��K�59I�/+H./:2�K./�21KK8,'�<�

����2180+���P�B���P21KK,

����H.;90���PP

�����K�-5/;���P�P��O+9

������H.;90���P��#""��B��"�P

�����5I�"+K0�PMMM��+9+/5089G�P2180+P��6.31;+2���P7NH0� ��WWH.;90

����P�""����P2180+P�����=�?����)!����!��B#���P2180+P�=�����P

����P�""����PG:G:KP�����=�?����)!����!�����P2180+P�=�����P

����20+;8:���P�"P21KK,P!P

����P�����<����BD�P2180+�P���0+;�P20+;8:P��� ��P

����20+;8:���P���P21KK,P!P

����P�����<����BD�PG:G:K�P���0+;�P20+;8:P��� ��P

����P��������P2180+P�P

����P��������PG:G:KP�P

�����K�-5/;���P�P��O+9���������������<�93I�89�750HO��59:!!!������<�

�����K�G+9>4.72���P�P����������������<�.93I�8K�K35G�2+0�����������<�

�����O+9��.

������,���#������P91332!P����P ��P�����<��1--/+22�9+,0�;2G��<�

������P��"����=�?����)!����!�#""��B!�B���P21KK,P=P

������,���#������P��P�

������P�""����B�"�����=�?����)!����!�#""��B!�B���P21KK,P=�

���������"B��E��)�)������������# �����������"��������������������

��������"��"�@������� %�� �D����"�P

������P��������B�"�P

�������.�99�����0.�7NH0��������������<�/+50+��"�K./�+5HO�6.31;+�<�

��������20+;8:���P�"P21KK,P!P99

���������90+/-/+0�P�5/2+�#--+/��5/�P20+;8:P�:826.3�:825:/�:82:+6�!P

��������7N479;���P]��P21KK,P�P�8GO0�P�P99������<�+G�]������X��<�

��������2180+���P�B���P21KK,

��������12/8:���P�#����P

��������P�""��������"������=�?����)!����!�#""��B!�B���P21KK,P=�

�������������P

����������������P������P

��������P��� "����B�(�P������������<�XXX� ���0O82�2N+3+0.9�82��<�

�������������������������������������<�XXX�2O5/+:�V80O�0O+��������<�

�������������������������������������<�XXX�752+:�75HNA1-2�2I20+;!�<�

���������K�/H�LM����O+9

�����������5I�PMM��//./�89H31:89G�2N+3+0.9����B�(�!!!P

��������P��"��� ����P:826.3P�P

����������������P��P

��������P������������"��P

�������9:���������������������������������������<��.�99�����0.!!!�<�

�����9:�����������������������������������������<��K�G+9>4.72�����<�

���9:�������������������������������������������<��K�7NH0�LM��!!!�<�

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

�9:���������������������������������������������<��.�5�����0.!!!��<�

�<���3820�.K��""�.K�0O+�75HNA1-2�82�V/800+9�0.�;+;7+/�=���B��=!���<�

�<��9�0O82�3820�V+�892+/0�0O+�2180+�95;+�59:�0O+�:+H8;53�6531+�.K���<�

�<�0O+�O+,�5::/+22��0O82�533.V2�12�0.�+5283I�2./0�890.�O+,�./:+/�!��<�

�<��O82�3820�82�5�H.;-3+0+�3820�.K��""�6.31;+2�0O50�5/+�2+90�0.�����<�

�<��B#�������8//+2-+H086+�.K�VO+0O+/�0O+I�5/+�5H01533I�/+20./+:�./��<�

�<�9.0��0O.2+�V80O�59�=�=�89�0O+��B#�������35G�K8+3:�5/+�9.0�9./;A��<�

�<�533I�/+20./+:�!��O+�P���"����P��,+H�V833�350+/�7+�12+:�0.�H/+50+�<�

�<�5�382089G�.K�:82N2�/+J18/+:��7I�����2I20+;��VO8HO�+,H31:+2�0O.2+�<�

�<�9.0�9./;533I�/+20./+:���59:�5�3820�.K��""�:82N2�0O50�V+�2+9:�����<�

�<�75HN1-2�K./!��O+2+�38202�5/+�+A;583+:�0.��B#������2.�0O50�0O+I���<�

�<�H59�H/+50+�0O+�9+H+225/I�-/.K83+2�K./�0+202�59:�532.�O56+�5�K133�<�

�<�3820�89�H52+�V+�9++:�0.�896.N+�/+H.6+/I!�������������������������<�

�.�5�����0.�+90/8+2

��21KK,���D./:�7N1-2�5���������������<��+0�+5HO�21KK8,������������<�

���90+/-/+0�P,,������P21KK,P�B�P�����<��+0�H.190�K./�0O82�21KK8,��<�

���90+/-/+0�P���P21KK,P!�������P21KK,P�B�P

���K�,,�LM����O+9��.�V�����0.�,,�����<��K�59I�/+H./:2�K./�21KK8,'�<�

�����90+/-/+0�P��������"P21KK,P!PV

����2180+���P�B���P21KK,

�����5/2+��5/�0+;-�6.3�O+,5::/�:+60�H.;K35G�!

�����K�H.;K35G�LM�P P��O+9��.

������2./0K3:����8GO0�=��=����O+,5::/��)�

������?1+1+�P�P6.3P�PO+,5::/P�P:+60P�P2180+P�PH.;K35GP�������P2./0K3:

�����9:

���9:

�9:

91;���?1+1+:��

P�""�������B������=�?����)!����!��B#������B���=�����P

P�����P91;P����BD����B����� ��P

P�����������B��P

�K�75:.9+2���P�P��O+9��.

���5I�PCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCP

���5I�PCC��96538:�75HN1-�2180+�2��K.19:�A�-3+52+�/+2.36+�59:�/+/19�CCP

���5I�PCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCP

��H.:+���@

�9:

�,80�H.:+�

�>�� �'

�5I�P�P

�5I�PMMMMMMMMMMMMMMMMMMMMMMMMMMMMMLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLP

�5I�PMMM�������6+/�)��75HNA1-2�K.19:�89�2180+��B���P21KK,P�LLLP

�5I�PMMM����������5HNA1-�2180+�H/+508.9�0+/;8950+:!!!��������LLLP

�5I�PMMMMMMMMMMMMMMMMMMMMMMMMMMMMMLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLP

�5I�P�P

�,80��)

Grant CarsonSystems Programmer (UK) © Xephon 2002

41© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

Overview of ISPF panel processing commands

During the evolution of ISPF Dialog Manager, many useful featureshave been added, in particular in the area of panel processing. Myexperience has shown that many of these features are either unknownor not fully appreciated. The purpose of this article is to provide anoverview of some of the most useful of these features as they affect panelprocessing. The correct operation of some features depends on othersettings being made. This article discusses such dependencies.

In its most simple form, a panel displays information, allows informationto be input, and can perform simple formal validations on the entereddata – for example, is a dataset name formally correct (not longer than44 characters, the parts of a dataset name are not longer than eightcharacters, alphanumeric with a leading alphabetic character, andseparated with a period)?

Originally, any more intensive processing had to be performed in theinvoking procedure (REXX or CLIST) or program. Features added toDialog Manager now provide more flexibility regarding how externalprocedures can be activated. Some facilities allow procedures to beinvoked in parallel with the display and return control to the paneldisplay. Such facilities can be used, for example, to verify the physicalpresence of a dataset, and, if it is not present, allow the panel to displayan error message immediately.

This article describes the various means of invoking procedures(commands) from a panel. It also provides an example that uses all thesefacilities.

The methods of invoking a procedure from a panel are:

• Set a command variable

• Invoke a panel exit

• Action bar

• Command invoked by a PF key.

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

SET A COMMAND VARIABLE

If the displayed panel explicitly sets a command variable (normallyZCMD, or the field name specified in the CMD option of the )BODYheader), the procedure or program that displayed the panel can executethe command at the end of the display.

For example:

����������

���������������P����"����� �"�� �P

�����������QH;:�LM�==���� �� ��������QH;:

This method has always been available.

INVOKE A PANEL EXIT

A panel exit can invoke either a program or a REXX EXEC. Althougha panel exit cannot itself invoke any ISPF services, it can use operatingsystem services, TSO services, etc. A panel exit also has the restrictionthat, although it can be passed and return ISPF variables, it cannot altertheir length. This means that any variables passed to a panel exit mustbe passed with their maximum possible length, ie padded wherenecessary. A panel exit returns immediately after the point of execution.

For example, a panel exit could be passed two variables – a dataset nameand a status field. The status field could be set to an appropriate codeif the dataset does not exist.

Since the availability of panel exits, it has always been possible toinvoke a program, either by name (PGM keyword) or by its address(LOAD keyword). The ability to invoke a REXX EXEC has onlyrecently become available, although I published a program in MVSUpdate in January 1993 that could be used to invoke a REXX EXEC.

For example:

�������=������������������������=��<�H3+5/�%��7I0+2�<�

�� ���������"� ���������������������

��������� ��=�=�

���"����������

��!��������������

������

In this case, two variables (FILENAME,MSG) are passed to the REXX

43© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

EXEC XPXCMD2. Because a panel exit cannot alter the length ofpassed variables, MSG must be initialized to the maximum possiblelength. The called REXX EXEC receives a single parameter thatcontains the address and length of the passed variables.

IBM supplies the ISPREXPX function that a panel exit can use to setlocal REXX variables (‘I’-option) or ISPF variables (‘T’); the REXXSTORAGE instruction can also be used to access and return the passedISPF variables.

For example:

�<������-59+3�+,80�<�

�""����������=�=���<�2+0�3.H53������65/8573+2�<�

�<�65/95;+2!�'���"� ����<�

�<�65/3+92!�'�3+9G0O�.K���"� ����<�

�<�65/95;+2!�'�����<�

�<�65/3+92!�'�3+9G0O�.K�����<�

0,0�������� �K83+95;+�

���0,0�LM�=B=�

����� �;2G���"����0,0�65/3+92!����<�2+0�;+225G+�0+,0�<�

�""����������=�=���<�2+0������65/8573+2�<�

Although the diagram shows a panel exit being invoked from the)PROC section, panel exits can also be invoked from the )INIT and)REINIT sections.

ACTION BAR

When an action bar is opened, it lists the associated actions. Theassociated action for a selected action bar entry can specify either theinvocation of a command or the setting of a variable. To illustrate thetechniques involved, the example uses both types of action. When acommand is invoked, the associated Command Table entry specifiesthe processing to be performed. If a CMD (command) is assigned, theassociated command will run in a separate window. After beingprocessed, the command returns to the start of the )PROC section. If noCommand Table entry exists, ZCMD will be set to the specifiedcommand; this command is then processed as described in the firstmethod.

For example:

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

���������83+�

��������= +V=�

������ ��# ���������������"� ����

��������=3:=�

���� ��

�!E���������

�������=�=

�����

����������?���

�����������=;+;95;+���������K83+95;+�=

The )ABC section specifies the action bar entry (here File). Thesubsequent PDC entries specify the pull-down choices, here New andOld. The ACTION entry for New specifies the command to be executedwhen it is selected. The )ABCPROC section specifies the processing tobe performed when the variable associated with the pull-down (PDC)is set to 2, ie Old selected.

COMMAND INVOKED BY A PF KEY

The effect of a command invoked by a PF key does not actually differfrom a command explicitly set in the command variable; the differencelies in how the command is set. ISPF, or more correctly PDF, uses PFkeys as shortcuts for frequently-used functions, eg PF1 = Help, PF3 =End. An application can define its own application-specific functionkeys (key-list table) by including a table with the name applKEYS,where appl is the name of the application specified by the NEWAPPLparameter when the application is started. The function key tablespecifies the command associated with the function key, for exampleKEY4DEF = PROMPT assigns the PROMPT command to the PF4 key.The application command table applCMDS specifies the functionassociated with the command, for example ZCTVERB=PROMPT,ZCTACT=PASSTHRU means that the PROMPT command is assignedunchanged to the command field.

The command name variable with the associated command in theapplication command table is passed to the )PROC section.

Note: to illustrate the widest range of possibilities, the example specifiesPASSTHRU as an action associated with the PROMPT command.Obviously another possibility would be to directly specifyZCTACT=SELECT PCMD(...) as ZCTACT for ZCTVERB=PROMPT,

45© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

even though this is not identical because PCMD in this case executesin a separate function pool.

Figure 1 shows the invocation of commands. The Figure illustrates theinteraction of panel entries with the command table and the keylisttable.

����������������������������;:�573+

����������������������������H;:

���� ��# �H;:��!!!��������E������H;:��������������������+,+H

����������������������������E������"������+,+H����������H08.9;:

�����

��H;:���+,+H�!!!�

����������������������������B+I3820�573+

��������E�����������������-/.;-0

����M>E����������� ��������B�� ���������

����������������������������;:�573+

�����������������������������-/.;-0

����������������������������E�����������

����������������������������E�����������#

���

������E�����������

������E�����=H;:�!!!�=

��������

����������������������������+,+H

��� �������!!!�������+,+H����59+3�,80

������QH;:���=H;:�!!!�=

�����

��QH;:���=:�!!!�=

Figure 1: Panel entries, command table, and the keylist table

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

EXAMPLE

The following example is a simple implementation of an end user-oriented application for editing a dataset (EUEDIT); it has been chosento illustrate the methods described above.

EUEDIT allows the editing of a member of a partitioned dataset. Toisolate the user from needing to know how to allocate a dataset, theallocate function is included in the application. Similarly, to reduce thelearning curve, the handling is similar to a typical PC application’s: thepop-up panel associated with the NEW action allocates a new dataset,the pop-up panel associated with the OPEN action allows the selectionof an existing member. The member field on the panel can either be usedto enter a new member name or as a prompt field when the PF4 key ispressed with the cursor positioned on the member input field.

To reduce the size of the application, the standard IBM panel(ISRUAASE) is used to specify the dataset details (block size, recordlength, space, etc). A true end-user-oriented editor would provide apanel more appropriate for an end user, and so reduce the errorpossibilities. However, even with the standard panel, the applicationhas full control over the input (because this does not directly concernthe topics discussed in this article, the example does not place anyrestrictions on the input).

The standard editor is invoked once the dataset and member name havebeen entered or selected.

ADEMO (INITIAL PROCEDURE)

�<������A������<�

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

P��"������������� �D���"�����P

ADEMO invokes the ADEMO1 command with DEMO as theapplication identifier; the ADEMO procedure is needed only to set theapplication identifier. This application identifier is used to access theassociated command table (DEMOCMDS).

ADEMO1 (PROCESSING PROCEDURE)

�<������A�������<�

�<��/.H+2289G�-/.H+:1/+��<�

47© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

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

����������P����"����� �"������ �P�������M������ �"����

�����57H;:�LM�==���� �QH;:���57H;:

�����QH;:�LM�==���� �� ��������QH;:

���<�HO+HN�K./�H.;-3+0+9+22�<�

������K83+95;+�LM�==�����;+;95;+�LM�==����� ��

����:29��������K83+95;+P�P;+;95;+P�P���

����P�������������P:29P�P

��� �

� �

ADEMO1 performs the actual processing. The panel (DEMOPAN) isdisplayed until the END key is pressed (pressing the END key sets theRC to 8). The panel processing could set either of the two commandvariables – ABCMD is the command variable set in the action barprocessing, ZCMD is the command variable set when the command isentered directly (or as command assigned to a PF key). The associatedcommand will be executed (with the REXX INTERPRET) if either ofthese command variables has been set.

The standard ISPF editor (EDIT) is called when the dataset name(FILENAME) and member name (MENNAME) have both beenspecified.

DEMOPAN (DISPLAY PANEL)

��� �"�B��"��������"�������

�<������

����������#"��U^>�

S���������

F���������

U���������"�

L���������

Z���������

Y������ �������� �

���������83+�� �����

��������= +V!!!��=��� �����

������ ��# ���������������"� ����

��������=������=��� �����

���� ��

�!E���������

�������=�=

�����

����������?���

�����������=;+;95;+���������K83+95;+�=

���������+3-��� �����

����������

���������9:+,�

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

���� ��

�!E���������

��������� ���������E���

S�A���:80��/.90+9:��A�

�F��83+�F��+3-

UTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTA

L.;;59:����M>E������������������������������������������������^

L

L�83+ 5;+�!�!�Y��"� �����������������������������������������^

L�+;7+/�!�!�!�Y��� ����^C

L

Z���L�+3-�Z��%L�9:�Z�� L�/.;-0�Z����L�H08.92

�� ��

�E�����==������<�H3+5/�H.;;59:�<�

��������==�����<�H3+5/�H.;;59:�<�

��������==�����<�H3+5/����H.;;59:�<�

��������==������<�H3+5/�2O./0�;+225G+�<�

���������=��������=

�� ���������"� �����������������������

���� ��

�E�����==������<�H3+5/�H.;;59:�<�

��������<�

���

����!�������� ��

������

�<�K./;533I�6538:50+�LK83+95;+M�<�

�������"� ���� ���� ����

����!���� ��==������

��#�����"� ���������"�

�����E�����������

���#��"����!#���

���ED� ��"������ ���#��"�

����������������������� ����=�+3+H0��+;7+/� 5;+=

�������������������������������%�

���E�����=�#��"��������P�#��"�P����"� ����=

����#���ED� ��"�

������

���������� ��==�

������

�<�6538:50+�0O+�+,820+9H+�.K�0O+�K83+�<�

�������=������������������������=��<�H3+5/�%��7I0+2�<�

�� ���������"� ���������������������

��������� ��=�=�

���"����������

��!��������������

49© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

������

�<�K./;533I�6538:50+�;+;7+/�95;+�<�

�������� ���� ������<�6+/8KI�VO+0O+/�L;+;95;+M�82�6538:� ����<�

�������� �����?�==���<�HO+HN�VO+0O+/�L;+;95;+M�2-+H8K8+:�<�

���"������=�90+/�./�-/.;-0�K./�;+;7+/�95;+=

��!��������������

�� �

DEMOPAN, the display panel, has the following form when it isdisplayed:

CAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAC

\AAAAAAAAAAAAAAAAAAAAAAAA��:80��/.90+9:�AAAAAAAAAAAAAAAAAAAAAAAAAA\

\����83+����+3-���������������������������������������������������\

\�AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA�\

\�.;;59:����M����������������������������������������������������\

\�����������������������������������������������������������������\

\��83+ 5;+�!�!����������������������������������������������������\

\��+;7+/�!�!�!�����������C����������������������������������������\

\�����������������������������������������������������������������\

\������+3-����%��9:���� ��/.;-0��������H08.92���������������������\

CAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAC

The File pull-down menu has the following form when it is displayed:

CAAAAAAAAC

\ +V!!!��\

\<-+9!!!\

CAAAAAAAAC

An * is prefixed to Open when the associated dataset does not have anymembers; the XPXCMD1 panel exit sets the TEXT2 variableappropriately. Although the Help action bar has two entries, to avoidovercomplicating the example, it serves only as a placeholder here.

Depending on the entry selected in the File pull-down menu, either theXACMD command is invoked directly (for New) or the ABCMDvariable is set to invoke the XBCMD (for Old) procedure at the end ofthe panel display.

The XACMD command specified in the command table (‘SELECTCMD(ACMD &ZPARM)’) specifies that the ACMD procedure isinvoked. ACMD allocates the specified dataset.

The DEMOCMDS command table assigns the following commandswith the specified action:

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

E��������=�����=

E������=�������#=

E��������=����=

E������=��"�����������E�����=

The MEMBER input field in the panel is a prompt field. TheDEMOKEYS keylist table assigns the following commands for theDISPLAY keylist name. The KEYLIST parameter in the )PANELheader, KEYLIST(DISPLAY,DEMO), specifies the DISPLAY entry inthe DEMO keylist, namely DEMOKEYS:

��������"�

��%���� �

�� ��������

���_������ �

�33�.0O+/���AN+I2�5/+�:82573+:��2+0�0.� ��!

XBCMD (LIST LIBRARY AND SELECT MEMBER)

�<������A������<�

�<��52N'�"820�387/5/I�59:�2+3+H0�;+;7+/�<�

����������38795;+

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

P"�� ����������:8:����������P38795;+P�P

�����LM������ ��

������P-+9�+//./'�P38795;+

�������==

� �

P"��� ��������P:8:P����� �� �#��P

P������������������)�P��<����'�2+3+H0�;+;7+/�<�

P"��������������P:8:P����� �����"������� �����P

��������

����� �;+;7+/���Q3;+;7+/

���"����

����;+;7+/���==

����P������������������(�P��<����'�9.�;+;7+/�2+3+H0+:�<�

��� �

P"�"����������P:8:P�P

���#� �;+;7+/

The XBCMD procedure is invoked when File/Old is selected. Theprocedure uses the LMMDISP service to display the list of members inthe associated library. The ‘S’ command can be used to select a member,the name of which is returned as a procedure result.

51© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

PCMD (PROMPT FOR MEMBER)

�<������A�����<�

�<��52N'��/.;-0�K./�;+;7+/�<�

����������K3:95;+�38795;+

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

�<�0+20�VO+0O+/�+;-0I�387/5/I�<�

/H���"�������38795;+�P�������P�

�����M�@���� ��

������P-+9�+//./'�P38795;+

�������==

� �

���2I2;+;7+/2�������� ��

������P�;-0I�387/5/IP

��;+;7+/���==

����D��"��;+;7+/���==

��������P�90+/�9+V�;+;7+/�95;+P

�����#""�;+;7+/

����;+;7+/���"����;+;7+/�@�

��� �

�����#� �;+;7+/

� �

�<�.0O+/V82+�2+3+H0�+,82089G�;+;7+/�<�

P������������������)�P��<����'�2+3+H0�;+;7+/�<�

P"�� ����������:8:����������P38795;+P�P

P"��� ��������P:8:P����� �� �#��P

P�����P

P"��������������P:8:P����� �����"������� �����P

������������� �;+;7+/���Q3;+;7+/���"��������;+;7+/���==����P������

�����������@�P��<����'�9.�;+;7+/�2+3+H0+:�<�

��� �

P�����PP"�"����������P:8:P�P

���#� �;+;7+/

The PCMD procedure is invoked as a result of pressing the PF4 keywhen the cursor is positioned on the MEMBER field. The user isrequested to enter a member name if the associated library does notcontain any members, otherwise the list of members in the associatedlibrary is displayed for selection. The procedure returns the membername (either new or selected) as a result.

The TRANS() function executed in the panel processing section whenthe ZCMD variable contains PROMPT (namely the PF4 key has beenpressed) performs two tasks:

1 Tests whether CURFLD (ie the current cursor location) isMEMNAME. The message XXMSG003 will be set if this is notthe case, ie the cursor is not placed at a prompt field.

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

2 Assigns the text ‘Select Member Name’ as a window title for theassociated display.

XPXCMD1 (PANEL EXIT TO TEST WHETHER FILE HAS ANYMEMBERS)

�<������A��������-59+3�+,80��<���<��52N'��+20�VO+0O+/�K83+�O52�59I

;+;7+/2�<�

����������-5/;�""����������=�=���<�2+0�3.H53������65/8573+2�<�

�<�65/95;+2!�'���"� ����<�

�<�65/95;+2!�'�������<�

0+,0����"����=<-+9!!!=�65/3+92!��

0,0�������� �K83+95;+�

���0,0���=B=���� ��

���""�"�������K83+95;+�=�������=

�����2I2:2./G�������2I2;+;7+/2�LM������ �

����0+,0����"����=-+9!!!=�65/3+92!����<�2+0�;+225G+�0+,0�<�

� �

�""����������=�=���<�2+0������65/8573+2�<�

XPXCMD2 PANEL EXIT TO TEST FOR THE EXISTENCE OF THESPECIFIED FILENAME)

�<������A��������-59+3�+,80��<�

�<��52N'��+20�+,820+9H+�.K�K83+95;+�<�

����������-5/;

�""����������=�=���<�2+0�3.H53������65/8573+2�<�

�<�65/95;+2!�'���"� ����<�

�<�65/95;+2!�'�����<�

0,0�������� �K83+95;+�

���0,0�LM�=B=�

����� �;2G���"����0,0�65/3+92!����<�2+0�;+225G+�0+,0�<�

�""����������=�=���<�2+0������65/8573+2�<�

ACMD (ALLOCATE DATASET)

�<������A�����<�

�<��52N'��33.H50+�:5052+0��28;-38K8+:��<�

����:292

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

��������

��P����"����� �"����#�����P

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

����/+HK;���==

������D��"��Q53/K�LM�==

����������������Q53/K�0+;-���Q53/K

������/+HK;���/+HK;�0+;-

53© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

����� �

�������Q532-5H���=��B�=���� �Q532-5H���=���B�=

�������Q532-5H���=�"�=���� �Q532-5H���=�"� ����=

����533.H20/����

����P�""��������� �P:292P�������PQ53�+,P�P�Q532-5H�

����P�"B��E��PQ5373NP��"��"�PQ533/+HP�������P/+HK;P�P�

����P �D���#�P

�������Q53:8/�LM������ �533.H20/���533.H20/�P����PQ53:8/P�P

���������������533.H20/

��������P�""��'P/H

���������������� �"����

��� �

���"���"����

� �

DEMOCMDS (COMMAND TABLE)

�<������A��������<�

82-0573���=:+;.!0387=

����P��� ���7+89G�5::+:P

�����������P�""���������"�����P������"P��������#�P

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

P��������������� �����E������E���# �E����E���������"��P

�����M� ���� ��

������P�������H599.0�7+�H/+50+:P

������

� �

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

E�������==

E��������=�����=

E���# ����

E������=�������#=

P������������P

�����������

E��������=����=

E���# ����

E������=��"�����������E�����=

P������������P

�����������

P�������������P

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

P��"���������P

�����M� ���� ��

������P�������+//./P��

������

� �

������"����

The example assumes that the DEMOCMDS command table is stored

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

as DEMOCMDS, a member in the user’s DEMO.TLIB library. Thislibrary must be contained in the ISPTLIB concatenation at runtime.

DEMOKEYS (KEYLIST TABLE)

�<������A����B����<�

82-0573���=:+;.!0387=

����PB����7+89G�5::+:P

�����������P�""���������"�����P82-0573P��������#�P

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

P�����������B����B����B��"��� ��P�

�P� �����B�������B���"���B�������P�

�P�������B�������B���"���B�������P�

�P�������B��%����B��%"���B��%����P�

�P�������B�� ����B�� "���B�� ����P�

�P�������B�������B���"���B�������P�

�P�������B��)����B��)"���B��)����P�

�P�������B��(����B��("���B��(����P�

�P�������B��@����B��@"���B��@����P�

�P�������B��&����B��&"���B��&����P�

�P�������B��������B����"���B��������P�

�P�������B��������B����"���B��������P�

�P�������B��������B����"���B���������P�

�P����"��P

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

B��"��� �������"��

B�����������"�

B���"�������"�

B������������

B��������� �

B���"����� �

B���������

B��%������� �

B��%"������ �

B��%������

B�� �����������

B�� "����������

B�� ���������

B��������� �

B���"����� �

B���������

B��)������ �

B��)"����� �

B��)������

B��(������ �

B��("����� �

B��(������

B��@������ �

B��@"����� �

B��@������

55© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

B��&������ �

B��&"����� �

B��&������

B������������� �

B����"�������� �

B�������������

B���������� �

B����"����� �

B����������

B���������� �

B����"����� �

B����������

P���������B���P

�����������

B��"��� �������

B�����������"�

B���"�������"�

B���������

B��%������� �

B��%"������ �

B��%������

B�� ������ �

B�� "����� �

B�� ������

B���������� �

B����"����� �

B����������

P���������B���P

�����������

P����������B���P

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

P��"������B���P

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

This keylist defines two entries – DISPLAY and DATA (although theDATA is not used in this example). The example assumes that thekeylist is stored as DEMOKEYS, a member in the user’s DEMO.TLIBlibrary. This library must be contained in the ISPTLIB concatenation.

XXMSG00 (MESSAGE MEMBER)

�������%�= .0�5�-/.;-0�K8+3:=�!�"�������

=�O+�H1/2./�O52�7++9�-35H+:�.9�5�K8+3:�0O50�:.+2�9.0�-/.68:+�-/.;-0

H5-578380I=

���������=�����=�!�"���� �!D� �D� ����

=�"���=

�������)�=��"���������=�!�"�������

=� ����P�P�����"���������=

�������(�= ����������"����=�!�"�������

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

=������� ����������"��������������������=

�������@�= ����������"����=�!�"�������

==

APPENDIX

Rather than using the ISPREXPX() function, the standard REXXSTORAGE() function can be used to access and set the passed ISPFvariables. The example makes it clear that this is more involved.

XPXCMD2A

XPXCMD2A is an alternative version of XPXCMD2 using theSTORAGE instruction to access and set the passed ISPF variables.

�<������A���������-59+3�+,80��<�

�<��52N'��+20�+,820+9H+�.K�K83+95;+�<�

�<��HH+22�-522+:������65/8573+2�1289G�0O+��������K19H08.9�<�

�<�69!�'���"� ����<�

�<�69!�'������2+0�8K�+//./��<�

����������-5/;��<�L-5/;M�H.905892�0O+�5::/+22�.K�0O+�-5/5;+0+/�3820�<�

-,����������-5/;�%����<�L-,M���-5/5;+0+/�3820�<�

�<��+0�L96M���91;7+/�.K�65/8573+2�<�

-����21720/�-,��(� �

96����������������-��� ��

�<��,0/5H0�89:868:153�65/8573+�:505�3+9G0O2�<�

-(���21720/�-,���� �

635�������������-(��96< ���<�65/8573+�3+9G0O�5//5I�<�

635������635�

63!���`=

��8�������96

��,����#�����635�8<@A(�@�

��63!8�������,�

� �

�<��HH1;1350+�0.053�3+9G0O�<�

0.063����

��8�������96

��0.063���0.063�C�63!8

� �

�<��+0�5::/+22�59:�6531+�.K�65/8573+2�<�

-@���21720/�-,��&� �

65������-@���<�65/8573+�5::/+22�<�

665����������65�0.063���<�65/8573+�6531+�5//5I�<�

65!���`=

66!���`=

4����

��8�������96

��65!8���65

57© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

��66!8����#�����665�4�63!8���<�+,0/5H0�89:868:153�6531+2�<�

��4���4�C�63!8

��,�������65�

��,���,�C�63!8

��65�������,�

� �

�<��+0�LK83+95;+M�<�

K83+95;+���66!�

0,0�������� �K83+95;+�

���0,0�LM�`B=���� ��

��;2G���"����0,0�63!����<�2+0�;+225G+�0+,0�<�

���""��������65!��63!��0,0

� �

Systems Programmer(Germany) © Xephon 2002

The fastest way to get SMS DASD spaceinformation

INTRODUCTION

As installations get bigger, it’s essential to use DFSMS as an indispensableand handy storage management tool. DFSMS does its job very well, andtools like ISMF can supply all the necessary information in a quick andversatile way. But, unfortunately, they do not always cover every need– for example the console operator might need to know how the poolsare or something similar, and sometimes it’s necessary to monitor theavailable space throughout the day, or perhaps we need to have reportsabout the occupation of our disks.

For these cases, solutions like DCOLLECT, ISMF/BATCH, or directlyusing LISTVTOC are usually applied, but they are inefficient when wehave a large number of disks at an installation. They’re tedious to usebecause we have to add steps that will analyse the information or, on theother hand, we can’t run them online because of system restrictions.

After testing some alternative methods I have reached the conclusionthat the fastest, cleanest, and smartest way to get results is by usingDFSMS directly.

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

User SSI DFSMS

Figure 1: DFSMS request using SSI

We can accomplish the DFSMS request as shown in Figure 1.

It’s necessary to create two control blocks, SSOB and SSSA, as well asto GETMAIN a buffer area to get the requested information. We willobtain the subsystem identification block (SSIB) related to DFSMSfrom the JES2 control blocks. As you can see in Figure 2, we haveestablished the environment and, with the required control blockscreated and available, the request is made calling the IEFSSREQmacro.

The subfunction codes that we are interested in are:

• SSSA1SGV – return volume record definitions from a given SG.

• SSSA1VSG – return an SG from a given volser.

• SSSA1VOL – return a volume record definition from a given

THE SMS SUBSYSTEM INTERFACE

The DFSMS tool works on an MVS system through the little-knownand worse-documented Subsystem Interface. Every operation relatedto files in an SMS environment goes through an internal call to theSubsystem Interface, from the simple creation of a small file to theactivation of a new configuration.

Between the multiple calls available in the system, there are fivefunctions that will serve our needs pretty well. With them we will be ableto obtain the necessary information about volumes or storage groups.

59© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

volser.

• SSSA1AVL – return all volume record definitions in the currentconfiguration.

• SSSA1SGL – return all storage group definitions in the currentconfiguration.

In any case, DFSMS provides a structure in the buffer area, for therequested information, which can be mapped to the IGDSGD andIGDVLD macros. This information is retained in main memory throughDFSMS, making the access to any VTOC unnecessary – so that’s thetrick of this quick method.

QUERYSMS REXX FUNCTION

R1

Buffer Area

Length

.....SSID

.....Function Dep Area

.....

SSOB

SSSA

Length

.....SubFunction code

.....Buffer Area

.....

SSIB

SMS SSIB

.....

‘1’ SSOBPRT

Figure 2: Request procedure

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

I decided to write a function in REXX, as opposed to a program, to makebetter use of the precious information that the interface can give us.

I’ve always been an ASM 370/390 lover, but I think that you should onlywrite your program in Assembler language if you can’t solve theproblem more easily with a high-level language.

In every situation, I write the main function in ASM code and one ormore REXX routines that use it, so I can play with every possible wayof making the critical code shorter.

The QUERYSMS function accepts two values – kind of call (SGV/VSG/VOL/AVL/SGL), and one name (where required).

The reply is put back to the stack where, once formatted, it can be usedfor virtually any need. In the example REXX program, two routines areincluded to format both registers: VLD (Volume Definition Record)and SGD (Storage Group Definition).

DFSMS can return enough information about volumes and SGs(capacity, free space, status), so we can use a large range of utilities toproduce reports with virtually any information.

However, the program nucleus is self-sufficient from the REXXenvironment, as it can be converted to a batch program or TSOcommand with very little effort.

BUILDING AND INSTALLING

Before we proceed to the compilation, the internal parameter of theprogram MAXVOLS (line 2) must be adjusted, indicating the maximumnumber of SMS volumes that the installation owns. This is a critical andimportant adjustment, so, if we don’t define a buffer with enough spaceavailable, we will not be able to use this function to list all the volumes(AVL). It must be greater than the real number of volumes, because theSMS uses approximately 2K for every volser.

The QUERYSMS module doesn’t require any special compilationparameter, except for the concatenation of the SYS1.MODGEN macroslibrary in the assemble step.

Once constructed, it must reside in any standard ‘system search order’

61© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

load library, LINKLST, STEPLIB, or ISPLLIB.

AN EXAMPLE

The VIEWSGS REXX program is a good example of the use of theQUERYSMS function. The program calls the function to get a full listof all storage groups in the active configuration (Parm SGL), then callsthe Format_SGD routine (which set ups the REXX variables with theSG settings), and then we keep in one table those that we need in orderto list all the volumes for each of them (Parm SGV). Now, we call theFormat_VLD routine to get the free space and capacity on everyvolume. They build up in counters and finish displaying the whole SG.

At a typical medium-size installation with approximately a thousanddisks, the whole process takes less than a second.

Output example:

��0./5G+��/.1-� 5;+������.31;+2��5-5H80I�������/++��U#2+:

AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA

���"����������������������������� ��)�������%(@)�� ��((����������!!!!!!!!!!!

���������������������������% _����& �� _������ ��&��@)�(@������������������!!!

"����������������������������_������� �_�����%��% ��%)� ���������!!!!!!!!!!!!!

����������������������������%�����)���@������%_�)@��) ��&��������������!!!!!!!

������������������������������������� _��������)�_��@&�(%�������������������!!

��#������������������������������� ��)������%%)@(���@�&������!!!!!!!!!!!!!!!!

QUERYSMS

?#����������"��=������# �� �A�?#�������=

�����"��������������<���������������"#����� ������������<�

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

<���������������#"�� ������?#����������������������������������������<

<������������������������ �������������# �� ���?#�����������D����<

<��������������#��������"����������������������������������������<

<��������������# �� ������������������������������������������������<

<����������������5/G����=���=�A�/+01/9�5�3820�.K�6.31;+2�522.H850+:���<

<�������������������������������0O+�20./5G+�G/.1-�5/G�����������������<

<�����������������������=���=�A�/+01/9�0O+�20./5G+�G/.1-�522.H850+:���<

<�������������������������������0O+�6.31;+�5/G������������������������<

<�����������������������=�"=�A�/+01/9�5/G����6.31;+�:+K89808.9�������<

<�����������������������=��"=�A�/+01/9�0O+�3820�.K�533�6.31;+2��������<

<�����������������������=��"=�A�/+01/9�0O+�3820�.K�20./5G+�G/.1-2�����<

<��������������������� ���� ��������������������������������������<

<���������������������� �� �� ������� ����� �� �� �!������������<

<�������������������#������B��� E�����"����������� ��"���� �"B����<

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

<�������������� ������ �����?#�������� "��� ������ ����������������<

<�������������� �#����������� ����������� ��"B��������������������<

<���������������������������� ����������������"���������������������<

<������������������A� ���"�������������� ���������� ����������������<

<�������������#��#���������� ���������B�����������������������������<

<�������������������������#� ���������������������������������������<

<������������������A������������������� ���������� �����������������<

<�������������#��#�������������������������������������������������<

<�������������������������#� �������)�������������������������������<

<������������������ �"������� ���������������������������������������<

<���������������� ��"��"B��������#���������!��������������������<

<����������������������������������������������!�����������������<

<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

?#����������

?#������������%�

?#������������� �

�����������������������������������������������������?#����

<��������� �

����������������� ������<������������������������#�

���������"�������������������������������������

���������#�� ��?#������������������������������������������

���������"����������������������������������� ��"B����!

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

��������������� ��#�"��"�����"���"D�����D�B�����

���������"�����������%����������������������#����������

���������"�������%��������������������� �D����������D�B�����

������������������� ���%��������������������"����������

�����������������%�@������������������������ �D���������

���������#�� ���������%�������������������������CD�B������

���������#�� ��� ��"B����������������������� ���"B�����

���������#�� �����"�����������������������������"����������

���������#�� �����"�"B��&���������������������"�"B�����

���������#�� ��������"�>� �����@��������������������"������

���������"������&����"���"�������������#�������#"�����"�"B

���������"������&����&���������������������������

���������"������@����"��������������������������

<������ �������������

��������������������������������������"���������

���������������������"%�=�=����������"���������

���������"��������������"�>������� �>����������������������

���������"���������������������������������

������������������� B����������������� ������AM�����

���������"��������������"�>������� �>"� ��������"� ���������

�������������������=%=����������������"� ������%�S

���������� �������� B����������������� �AM������ �B

��������������������������������������"� �"� A�

����������������������������������������#������

���������"������@�������"�> ������������� ���� �������

���������"��������������"�>������� �>���������������

���������"�����������������������������������

63© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

�����������������B��������������������� �������AM��B��

���������"��������������"�>������� �>"� ��������"� ���������

�������������������=%�=���������������"� ����L��%��S

������������������� B����������������� �AM������ �B

�����������������������"��������������������"� ���

��������������������������������������"� �"� A�

����������������������������������������#������

��B�����?#���<

��������������������=�=����������������"�������

���������"����������=�"=��������������������=�"=�S

�����������������B��������������������������B�������

���������"����������=��"=��������������������=��"=�S

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

���������"����������=���=��������������������=���=�S

�����������������B�����������������������������

��������������������=�=������������������������

���������"����������=���=��������������������=���=�S

�����������������B�����������������������������

���������"����������=��"=��������������������=��"=�S

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

������������������� B������������������������ ����"��

��B����"����������"%�=�=�����������������������S

������������������� B��������������������������� �B

������������������ ���������������������������B�AM������

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

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

<����

��� ����������� ��#�"��DB��"�"�� ��������D�B�����

������������������D�B�"���������������������#������������

�����������"����� ��""������������������������� ������

�����������"����� ���������������������D���������

���������"��������D�B�"��������������������#������������

���������������� ��#�"��DB��"��������������������D�B�����

�������������������B

<�����

������������������D�B���������������� ���������"������

����������������������)��D�B�C�������������� ����

���������"�����������������������������"����������

�����������"����� �D���������������������������

���������"����������)���������������������#� �����)

���������������$���

�����������������D�B����������������� ���������"��������

����������������������)��D�B�C�������������� ����

���������"�����������������������������"����������

�����������"����� �D���������������������������

���������"����������)���������������������#� �����)

���������������$���

���� B��"������������������������������������������

�����������"����� �D���������������������������

���������"����������)���������������������)

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

���������������$���

����B������������"�"B>�������=�=������#� �=��#�=

���������"��������������������������������#� �"� ���

���������������������"�"B>��"� �������������

����������"�������������������������������#� �����

$��������"����������%���������������������������D�B�����

���������"�������%� ��%��������������������"����������

���������������� ��#�"��"������������������������D�B�����

���������"������������������������������������#� ���

������������#� ��� ����������������������#� ����""��

<��""���

�""������?#���<

����������������� ���""�����������������������#� ��������!

<� ���#�����

��������������D�B����D�B����������"�������

���������"��������D�B����������������"����������!

���������#�� �������������������������������

���������������������=���=��������������� !

�����������������"� ���"��������E�������"� ���

������������������# ���"������������# �� ������������������

���������"����������������������������AM���

���������"��������������A�����������AM��������# ���� ����"�

���������"���������������A�����������AM�������"������

������������������������������A������������AM���������

�������������������=@�������=�������������"��������

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

<� ���#������

��������������D�B�����D�B�����������"��������

���������"������%�D�B�����������������"�����������!

����������������%����� ����������������# �� ����� �� ��������� ���

���������#�� �����������%��������������������

����������������������=����=���������������� !

���������"������������" C�����" C%�����"� ���

����������������������"�

������������������������"����������������� � #����

�������������������� ���"���������������#� �����������������������

���������������������"������ �#���������""��� ���#����E��

$��������?#���<

���������"����������=��"=��������������������=��"=�S

���������� ����$���������������������� ������ ���

�������������������������������"����������#� �����"�������""��"#���

���������������$&

$�������"����������=�"=��������������������=�"=�S

���������� ����$���������������������� ������ ���

������������������������������"����������#� ����"#��

������������������� �"���"��)���������"� �������"���

������������������� ���)�������C�����������"���

���������������$&

$�������"����������=���=��������������������=���=�S

���������� ����$%��������������������� ������ ���

65© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

������������������������������������������#� ���"����"�������������

������������������� �"������"���������"� ������������� ���

������������������� ���%��������C���������������

���������������$&

$%������"����������=���=��������������������=���=�S

���������� ����$ ��������������������� ������ ���

������������������������������������������#� ���������������"#��

������������������� �"���"��)���������"� �������"���

������������������� ���)�������C�����������"���

���������������$&

$ �������?#���<��������������������������������=��"=

�������������������������������"����������#� ����"���

���������������$&

$&�������?#���<

������������������� ����=�=���������� ����?#���

�������������������"� ���" �DB��"�����"� ������D�B�����

���������"��������D�B�"��������������������"��D�B�����

���������������������������������������������"��D�B�����

<��""����

���������"���������������������������������������������

����������������?�����������������������""����

���������"�����������������������������������

���������� E���������������������������a���AM�������������#� ���

���������"�������������� ��������������"������������ ���

���������"�����������������������������������

���������� E���������������������������a���AM�������������#� ���

������������������%�������������������� ���������

��""����"������� ���""����������������������#� ����!

����������������� ������������������������#� ����""��

<���������A���������#� ���� ������

����������?#���<

����������������� ���������������������������""��=�����!����!

<����������""���?#�#�

���������"��������� ��"B>�������������������������� �"��#�� ������

���������"������(������BA���������������������B��#�� �����!

�������������������>��B� �������������������� �����

��������������>��B�# ��"@=?#�#�=��������?#�#���# ��

���������"��������>��B�# ��������������������

������������������>��B����C������������������������

���������"��������>��B���������������������������������

������������������>��B����C �����������������������

���������"��������>��B"� �����������������������"� ���

������������������>��B����C@����������������������%

���������"��������>��B��������������������������

������������������>��B����C�����������������������

���������"��������>��B� �������������������� ��"B����

������������������>��B����C�)����������������������

���������"��������>��B������������������������������

�������������������=@�������=����������������"��������

������������������>��B����C�����������������������)

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

<�D����������

���������"��������D�B�"�������������������D�B����

���������#�� ���"������������������������������"�����

���������"������%��"�� ����������������������"�# �

���������"������ ��"��"� ������������������"� ��������������

���������������� �>��B"� ������������������"� ������������B

���������"���������"������������������������������ ���

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

�����������������>��B���������������������������������

���������"���������������������������������� ��"B

���������"����������(���������������������������B�� ������ �

���������"��������>��B�����������������"�����������

�����������"����� ����������������������""������B

������������������� ��������������������B����� ����� ���

���������������%� ����������������������������# ��"�# �����

���������"������� ��������������������������""������#� ����

����������������� ������������������������#� ����""��

<�D������A�D�������������

D���������?#���<

����������������� ��D������

<����������""������

���������"��������� ��"B>�������������������������� �"��#�� ������

���������"������(�������A���������������������B��#�� �����!

�������������������>��B� �������������������� �����

��������������>��B�# ��"@=D�������=�����D���������# ��

���������"��������>��B�# ��������������������

������������������>��B����C������������������������

���������"��������>��B���������������������������������

������������������>��B����C �����������������������

���������"��������>��B"� �����������������������"� ���

������������������>��B����C@����������������������%

���������"��������>��B� �������������������� ��"B����

������������������>��B����C�����������������������

���������"��������>��B������������������������������

�������������������=@�������=����������������"��������

������������������>��B����C�)����������������������

<�D�������������

���������"������%����������������������"�����������

���������������������������������������"������

��"� ������������=����=����%�������������"� ��"� ���

���������"��������������������������������E���S

����������E�����D���������������������������AM�� �

���������"������%����%���������������������������������

����������������%�>��B�������������������������������

������������������>��B"� ������������������"� ���������

���������"���������������������������������� ��"B

���������"����������(������������������������������ ������ �

���������"��������>��B�����������������"�����������

�����������"����� ����������������������""�������

����������������%��������������������������"� ��"� ���

67© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

��������������� ��"� ����������������������� ����"� �

�D�������"������� ��D�������������������������#� ����

����������������� ������������������������#� ����""��

<����������

���������������"���)��=#25G+'�?#�������0I-+�95;+�=

���������������"���%��=�DO+/+�0I-+��=

���������������"��(%��=������A�/+01/9�5�3820�.K�6.31;+2�522.H850+:�V8�

���������������0O�0O+�20./5G+�G/.1-�==95;+===

���������������"��))��=������A�/+01/9�0O+�20./5G+�G/.1-�522.H850+:�V8�

���������������0O�0O+�6.31;+�==95;+===

���������������"��%&��=���"�A�/+01/9�==95;+==�6.31;+�:+K89808.9=

���������������"��%@��=����"�A�/+01/9�0O+�3820�.K�533�6.31;+2=

���������������"�� ���=����"�A�/+01/9�0O+�3820�.K�20./5G+�G/.1-2=

���������������"����

���������������"��%&��=�172I20+;��90+/K5H+��//./������=

���������������= ����������� �=

���������������"��%%��=�� .0+'��++�����!��"�����������=

���������������"�����

���������������"��� ��=�����//./���� ���=

���������������= ����������� �=

���������������"��%���=�� .0+'��++�����!���� ���������=

���������������"�����

���������"���

�������������������������������������������D�B�����

����������������@�������������������������������

����������������������������������������#�� �����#�

��""�����������������������������������#�� �����#�

�D��������������������������������������#�� �����#�

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

>��B�# �������"@�����������������������B�#

>��B�������������������������������������B���

>��B"� ����������������������������������B"�

>��B������������������������������������B�

>��B� �����������������������������������B� �

>��B������������������������������������B��

>��B�����������)�����������������������������������

D�B�����������������������������������D�B� �������"

���������������"%���������������������������

���������������"%���������������������������

�����"����������������������������������������"� ���

�������������������������������������������������#�

��������������������������������������AM������

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

D�B�����������"�������E�������������D�B� �����

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

D�B������������"�����" C�����" C%�����D�B� ������

�"�"� ����?#����"�� �A�"���C�"�� ��A�"����������"��"��"� ���

DB��"�����?#����"���A�"�C��"�"� <�����"��

D�B�"����������

"���������?#���<A����

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

<�#��������

�#�����������

������������� ������������������������������� �!��"B

���������������"�������������������������������"

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

���������������"�������������������������������"��"B

���������������������������������������������#�� ��

������������#������"������������������#������� �

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

�������������������������������������������A����

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

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

�������������"������������������������������"#������� ��� ������ �

����������������������������������������������������#������ ��� ����

���������� ����?#������

VIEWSGS

�<AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA�+,,AA<�

�<����D���'��8+V��-5H+�56583573+�89�533��0./5G+��/.1-2����������������<�

8K�J1+/I2;2�P��"P��0O+9�:.

�����>.190���J1+1+:��

���:.�8���0.���>.190

������-5/2+�-133�2G:

������H533��./;50>����2G:

��������> 5;+!8������>�G:K95;+

��������>�+2H!8������>�G:K:+2H

��������>�I-+!8������>�G:K0I-+

������+9:

���25I�3+K0�P�0./5G+��/.1-� 5;+P����/8GO0�P�.31;+2P����WW�

�������/8GO0�P5-5H80IP����/8GO0�P�/++P����/8GO0�PU#2+:P�(�

���25I�H.-8+2�PAP�(&�

���:.�8���0.���>.190

������8K���>�I-+!8�����0O+9�:.

���������6.32����R�0H����R�0K����

���������8K�J1+/I2;2�P���P���> 5;+!8��0O+9�:.

������������6.32���J1+1+:��

������������:.�4���0.�6.32

���������������-5/2+�-133�63:

���������������H533��./;50>�3:�63:

���������������0H���0H�C��"�>�3:90H-I

���������������0K���0K�C��"�>�3:9K/++

���������������+9:

������������+9:

���������/0���K./;50���0HA0K��0H�<������

���������25I�"+K0���> 5;+!8����/8GO0�6.32����/8GO0�0H����/8GO0�0K����WW�

�������������/8GO0�K./;50���0HA0K��0H�<��������(�P�PH.-8+2�P�P�/0�WW�

�������������H.-8+2�P!P���A/0�

���������+9:

������+9:

69© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

���+9:

+,80

�<��./;50��"#������������ ��� ������������������������������������<�

�./;50>�"�'

-5/2+�5/G������"�>�3:623+9������������<��.32+/�3+9G0O���)�������������<�

����������%����"�>�3:62+/�������������<��.32+/������������������������<�

����������&����"�>�+2+/6+:%�����������<��+2+/6+:����������������������<�

����������%%���"�>�3::12+/������������<�12+/8:�.K�3520�1-:50+/��������<�

���������� ����"�>�3:::50+������������<�:50+�.K�3520�1-:50+�����������<�

���������������"�>�3:0/N2Q������������<��.31;+����0/5HN�H5-5H80I������<�

�����������%���"�>�+2+/6+: �����������<��+2+/6+:����������������������<�

�����������(���"�>�3::08;+������������<��8;+�.K�3520�1-:50+�����������<�

����������)����"�>�3:2G3��������������<�"+9G0O�.K�20./G/-�95;+��������<�

����������)(���"�>�3:2G9��������������<� 5;+�.K�20./G/-���������������<�

����������&(���"�>�3:92050������������<�3:�205012�7I�2I20+;����������<�

������������%��"�>�3:91H75������������<�5::/+22�.K�1H7�8K�N9.V9�������<�

������������(��"�>�3:90H-I������������<�0.053�H5-5H80I�89�;+G57I0+2���<�

���������������"�>�3:9K/++������������<�5;.190�K/++�89�;+G57I0+2������<�

���������������"�>�3:93+,0������������<�35/G+20�K/++�+,0+90�89�;7!����<�

������������&��"�>�3:K35G2������������<��35G2��2++�7+3.V��������������<�

�����������%���"�>�+2+/6+:������������<��+2+/6+:����������������������<�

�����������%���"�>�3:9�H90������������<��.31;+�3+6+3��+2+0�.190������<�

�����������%%��"�>�3:9228�������������<��+2+/6+:�K./�2172I20+;�12+����<�

�����������%(��"�>�3:2G20�������������<�20./G/-�205012�.9�0O82�2I0+;��<�

�����������%@��"�>�+2+/6+:������������<��+2+/6+:����������������������<�

����������� ���"�>�3:93+63������������<�#-:50+�3+6+3�K./�6.31;+�������<�

����������� ���"�>�3:H2;22������������<�3:�3.H508.9�.K�H.9K8/;+:�2050<�

������������%��"�>�3:2I2.K������������<�KK2+0�.K�2I20+;�:505���������<�

������������(��"�>�3:2I239������������<�"+9G0O�.K�2I20+;�:505���������<�

�����������)���"�>�+2+/6+:)�����������<��+2+/6+:����������������������<�

�����������((��"�>�820����������������<��820+;2������0573+2�����������<�

�"�>�3:623+9���H�:��"�>�3:623+9�

�"�>�3:0/N2Q���H�:��"�>�3:0/N2Q�

�"�>�3:2G3���H�:��"�>�3:2G3�

�"�>�3:2G9���21720/��"�>�3:2G9����"�>�3:2G3�

�"�>�3:90H-I���H�:��"�>�3:90H-I�

�"�>�3:9K/++���H�:��"�>�3:9K/++�

�"�>�3:93+,0���H�:��"�>�3:93+,0�

��������������������������������������<��.3�82�89�H.96+/28.9���������<�

�"�>�3G>.96���78059:��"�>�3:K35G2�,=@�=����,=@�=

�"�>�3:9�H90���H�:��"�>�3:9�H90�

�"�>�3:93+63���H�:��"�>�3:93+63�

�"�>�;2�050!���PP����������������������<������05012�<�

���������������������������������������<���A� .�205012�G86+9�<�

���������������������������������������<���A��9573+:�<�

���������������������������������������<���A�?18+2H+��33�<�

���������������������������������������<�%�A�?18+2H+� +V�<�

���������������������������������������<� �A��82573+:��33�<�

���������������������������������������<���A��82573+:� +V�<�

�"�>�62�050!���PP����������������������<������05012�<�

���������������������������������������<���A�9389+�<�

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

���������������������������������������<���A�KK389+�<�

���������������������������������������<�%�A��+9:89G�.KK389+�<�

���������������������������������������<� �A��.,+:�<�

���������������������������������������<���A� .0��+5:I�<�

�"�>�;2�050!���PP���������������������<�.9K8/;+:������05012�<�

���������������������������������������<��5;+�52��;2�050�<�

:.�63:>4�����0.�@��<��5,�2I20+;2���)�<�

����"�>�;2�050!63:>4���H�:�21720/��"�>�820�������63:>4A��<@�C�����

����"�>�62�050!63:>4���H�:�21720/��"�>�820�������63:>4A��<@�C�����

����"�>�;2�050!63:>4���H�:�21720/��"�>�820�������63:>4A��<@�C%����

���+9:

/+01/9

�<��./;50����������#������������ ��� ����������������������������<�

�./;50>���'

-5/2+�5/G��������>�G:9;3+9������������<��+2+/6+:��V.13:�7+�95;+�3+9���<�

����������%������>�G:K95;+������������<��0./5G+��/.1-� 5;+������������<�

����������%%�����>�G:K12+/������������<�#������.K�3520�1-:50+/��������<�

���������� ������>�G:K:50+������������<��50+�3520�1-:50+:�������������<�

�����������������>�+2+/6+:������������<��+2+/6+:����������������������<�

�����������(�����>�G:K08;+������������<��8;+�3520�1-:50+:�������������<�

����������)������>�G:K:+2H������������<��+2H/8-08.9�.K��0./5G+��/.1-��<�

�����������@�����>�G:K35G2������������<��35G2�59:�/+2+/6+:��2++�7+3.V�<�

�����������@)����>�G:K0I-+������������<��0./5G+��/.1-��I-+��++�7+3.V��<�

�����������@(����>�+2+/6+:������������<��+2+/6+:����������������������<�

�����������@&����>�G:K6;5,������������<���������505�2+0�28Q+���������<�

�����������&%����>�G:K6190������������<����1980�0I-+�����������������<�

�����������&(����>�G:KO0O/������������<��8GO�0O/+2O.3:�����&&�U������<�

�����������&@����>�G:K30O/������������<�".V�0O/+2O.3:�����&&�U�������<�

�����������&&����>�G::;-H3������������<��1;-�3522+2�K./�510.:1;-�����<�

�����������%&����>�G:K-/20������������<�3:�3.H508.9'�-/.H+22./�205012<�

����������� (����>�G:572I2������������<��10.�75HN1-�2I20+;������������<�

�����������������>�G:5:2I2������������<��10.�:1;-�2I20+;��������������<�

�����������)%����>�G:5;2I2������������<��10.�;8G/50+�2I20+;�����������<�

�����������(�����>�+2+/6+:������������<��+2+/6+:����������������������<�

�����������(%����>�G:228��������������<��+2+/6+:�K./�2172I20+;�12+����<�

�����������((����>�G:228��������������<��+2+/6+:�K./�2172I20+;�12+����<�

�����������@�����>�G:H9K/;������������<�3:�3.H508.9'�H.9K8/;+:�205012<�

�����������@&����>�G:G7N1K������������<��15/590++:�75HN1-�K/+J��������<�

�����������&%����>�G:073G/������������<�����573+��-5H+���������������<�

����������%������>�G:.5;K3������������<����K35G2��2++�7+3.V����������<�

����������%������>�+2+/6+:%�����������<��+2+/6+:����������������������<�

����������%�%����>�G:HI320������������<����IH3+��05/0�08;+��O/2�����<�

����������%� ����>�G:HI3+:������������<����IH3+��9:�08;+��O/2�������<�

����������%������>�G:6.3K0������������<��.31;+��133��O/+2O.3:�780�����<�

����������%�(����>�G::/620������������<��/86+��05/0��O/+2O.3:�780�����<�

����������%�&����>�G:.3872������������<�"87/5/8+2�.-08H53�05-+��������<�

�����������)�����>�G:2I2.K������������<�KK2+0�0.�2I20+;�:505���������<�

�����������)&����>�G:2I239������������<�3+9G0O�.K�2I20+;�:505���������<�

�����������(%����>�G:.2I29������������<����2I20+;�95;+��������������<�

�����������@�����>�+2+/6+: �����������<��+2+/6+:����������������������<�

�����������&%����>�G:2I2:0������������<��I20+;�/+350+:�:505�����������<�

71© 2002. Reproduction prohibited. Please inform Xephon of any infringement.

���>�G:9;3+9���H�:����>�G:9;3+9�

���>�G:K0I-+���H�:����>�G:K0I-+���<��0./5G+��/.1-�0I-+�<�

����������������������������������<���A��..3�<�

����������������������������������<���A����<�

����������������������������������<���A��1;;I�<�

����������������������������������<�%�A�74+H0�<�

����������������������������������<� �A�74+H0��5HN1-�<�

����������������������������������<���A��5-+�<�

��������������������������������������<�����510.�75HN1-���������� ���<�

���>�3G>�G:K571-���78059:����>�G:K35G2�,=@�=����,=@�=

��������������������������������������<��10.�;8G/508.9����������� ���<�

���>�3G>�G:K5;8G���78059:����>�G:K35G2�,= �=����,= �=

��������������������������������������<��10.�:1;-��������������� ����<�

���>�3G>�G:K5:;-���78059:����>�G:K35G2�,=��=����,=��=

��������������������������������������<��O/+2O.3:2�2-+H8K8+:������� ��<�

���>�3G>�G:K0O/2���78059:����>�G:K35G2�,=��=����,=��=

��������������������������������������<��15/590++:�75HN1-�K/+J������� <�

���>�3G>�G:KG7N1���78059:����>�G:K35G2�,=�@=����,=�@=

��������������������������������������<��15/590++:�75HN1-�K/+J��� "��<�

���>�3G>�G:G79.3���78059:����>�G:K35G2�,=� =����,=� =

��������������������������������������<��90��8G�����+2���� .����������<�

���>�3G>�G:K8;8G���78059:����>�G:K35G2�,=��=����,=��=

��������������������������������������<��/8;�2-5H+�������+2���� .�����<�

���>�3G>�G:K-2;����78059:����>�G:K35G2�,=��=����,=��=

��������������������������������������<����IH3+�205/0�+9:�G86+9�����<�

���>�3G>�G:KHI2����78059:����>�G:.5;K3�,=@�=����,=@�=

��������������������������������������<��.31;+��133��O/+2O.3:�780�����<�

���>�3G>�G:K63K0���78059:����>�G:.5;K3�,= �=����,= �=

��������������������������������������<��/86+��05/0��O/+2O.3:�780�����<�

���>�3G>�G:K:/20���78059:����>�G:.5;K3�,=��=����,=��=

��������������������������������������<��.3�K133�V/80+�+/�G86+9�������<�

���>�3G>�G:6KK+/���78059:����>�G:.5;K3�,=��=����,=��=

��������������������������������������<��.3�K133�D/80+�+//./�780������<�

���>�3G>�G:6K+//���78059:����>�G:.5;K3�,=�@=����,=�@=

���>�;2�050!���PP����������������������<������05012�<�

���������������������������������������<���A� .�205012�G86+9�<�

���������������������������������������<���A��9573+:�<�

���������������������������������������<���A�?18+2H+��33�<�

���������������������������������������<�%�A�?18+2H+� +V�<�

���������������������������������������<� �A��82573+:��33�<�

���������������������������������������<���A��82573+:� +V�<�

���>�;2�050!���PP���������������������<�.9K8/;+:������05012�<�

���������������������������������������<��5;+�52��;22050�<�

:.�4�����0.�@��<��5,�2I20+;2���)�<�

������>�;2�050!4���H�:�21720/����>�820�������4A��<@�C�����

������>�;2�050!4���H�:�21720/����>�820�������4A��<@�C�����

���+9:

/+01/9

Salvador CarrascoComputer Room Coordinator (Spain) © Xephon 2002

MVS news

Serena has announced enhancements to itsStarTool Family Product Suite.

The company has released Version 7.3 ofSerena StarTool FDM (its file and datamanager), and Version 3.1 of SerenaStarTool APM (its application performancemanager), which are compatible with themost recent versions of z/OS, furtherextending the company’s support for IBM’slatest architecture.

Later this year, Serena will release the nextversion of Serena StarTool ATD, itsapplication test debugger. It has alreadyshipped StarTool DA 5.2 and SerenaStarTool IOO 3.1.

For further information contact:Serena Software, 2755 Campus Drive, 3rdFloor, San Mateo, Ca 94403, USA.Tel: (650) 522 6600.URL: http://www.serena.com/product/index.html.

* * *

Mainstar has announced release 6.101A of itsCatalog RecoveryPlus, with enhancementsthat promise improved functionality in anumber of core areas.

New Extract file functionality has been addedto the EXPLORE command, theDIAGNOSE BCS-VVDS command nolonger requires a journal data set, and theDIAG B-V reports have been improved.

There’s a new keyword REMOVE forALTER BCS BACK-POINTERS, forremoving unused BCS back-pointers withinVVCR/VVCN. A new keyword VVCR forZAP PRINT command will initiate a print ofVVCR, VVCN, and VVCM records.

A ZAP PATCH command enhancement nowallows users to change a primary key value ina BCS and there’s added ISPF support forBACKUP DSN, RECOVER DSN, andEXPLORE. The RECOVER DSN commandnow allows changes to the values for spaceallocation, free space, and CI size during therecovery.

Also new is BACKUP and RECOVERcommand support for compressed data setsand an Installation Verification Process(IVP) is supplied with the product. TheInstallation & Maintenance Guide showshow to use it for verification of new releases.Meanwhile, a new ISPF panel CatalogSearch is for searching for specific cataloginformation and there’s improvedRECOVER BCS command reporting, nowdisplaying totals by record type.

For further information contact:Mainstar Software, PO Box 4132, Bellevue,WA 98009-4132, USA.Tel: (425) 455 3589.URL: http://www.mainstar.com.

* * *

IBM has announced its Migration Utility forz/OS and OS/390, allowing sites to createstandard COBOL reports using ComputerAssociates’ Easytrieve Plus languagewithout Easytrieve Plus installed, and whichruns in place of the Easytrieve run-timeinterpreter.

The applications can then be modified,maintained, and enhanced via standardCOBOL programming.

For further information contact your localIBM representative.URL: http://www.ibm.com/software/ad/migration.

� xephon