Top Banner
Copyright 2010 IBM Corporation. Page 1 1 Rational Open-Access: RPG Edition ! " # $ % & ( )%* + ,! ! -! ! .! / ! 0 ,-! * 12.. 3 ! 1.1 Open Access handlers ! ( 45 ! + $ + 6 7
26

1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Jun 15, 2018

Download

Documents

doannhu
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 1

1 Rational Open-Access: RPG Edition

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

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

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

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

��������$��������

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

������'� ������ ���

�������(����������� �����������)%*�������

������+�����������

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

,! ����������������������������������� ����������������������� ����������������������������������������������!�

-! ������������ ������������������������ ������ ������ �������������������������������������������!�

.! /��������� ��������� ������������������������������� ������ ����������!�

���� ��������������0���� ������������,�����-!��*� �� ����������12..���������3����������������� ��������������!�

1.1 Open Access handlers

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

������� ����������������������������(����������45����� �� ��������������������� ����������� ��!�

� +���������������������� $����������������� +���� ���������6�������� 7�����

Page 2: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 2

/����������� ��������������������� �������������������������

������� ����������� �������������� �������������!�8����(����#��������������� ����� ������ �������������'�9+/:�����#�����( ���

�� ������ ����������������:/�������#��������� ������ �� �������������0�����;�+9�����!�

1.2 Two ways to approach Open Access �

,!�/����������������������������������� �����������������

�������������(���������� ����������������1-1<���������������������������������� ������������'�9+/:������!��

� /�������������������������� �������������=�:;*���0��������������'�9+/:�������

� /�����������������������������������������������3������������������(�����������������!�

� /��������������������������������� ���������� ��������������(������ ������������������������������� ��������������!�

-!�/���������������������� ������������� �����������������

���������/��������������������������������'� ������ �!�

� /������������������� ���������0��������� ������������ ����������� ������ �!�

� /������������������� �����������������������������������������������������������������������!��8����(����#��������:#�&=��:#�&*+�!�

� /����������������� ����������������������(������������ �� ���0�����;�+9�����!�

� /����������������������� ���������� ������������������������������������������ ��������#����������� ��

�������� ��������������(���!�

� Two ways to approach Open Access��

'����������������������������������������������>������?�����#���

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

Page 3: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 3

'����������������������������������������������������� ����

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

/������������� ����������������� ��������������������� ������������

��� ����������������������������� ���� �������������#������������������������ � 0�������!�

Page 4: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 4

2 RPG coding to use Open Access �

��������������=�:;*���0������#����������������������(������������������������� ��������!�

2.1 HANDLER keyword

/��������������������� ��������������������������� ��������� �� ����������=�:;*���0��������������8������ ��� �����!���������

������������������ ���������������� ���������� ��@;�+9#����:/��#�'�9+/:A����������� ��������������� ��������!�

/���=�:;*���0���������������������������������� ����������������

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

2.1.1 Example: Fmyfile cf e workstn handler('MYLIB/MYSRVPGM(hdlMyfile)') F extdesc('MYFILE') F usropn

/���=�:;*���0���������������������������

,! ������������������������

/������������� ��� �������������������������

o �� ���� ��������������� ���� ��������� ������������������� ���������������� ��������!�/�������������� ��������������5*�$���B�+�4��%@��&�;7��A5����

5+�4��%@��&�;7��A5!�/������������� �������������!��o �� ���� ��������������� ���� ��������� �����������������������!�/�������������� ��������������5*�$���B���%5����

5��%5!�/������������� �������������!��o ���������������� ������� �����!��o ���� ���������������������@C��;;�A��������� ��!��

'������������������������������ ��������������� ��C��;;�#������������������� ��������������������������!�'�������������������

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

Page 5: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 5

-! @������A�������������������������� ��������������������������������������������

/������������� ��� ���������������������������������������������������������������������� �������������������������������!�

8����(����#������ ��������8+�����#����������������������0����

����������������8+�����!��/����������������� ���������������

�������������� ����=�:;*���0���������������!��/����� ����������������������������������� ��#�������������������� ����!�����

�����(����#���������� ������������������� �����>���;�?!��'������������������� �����#����������� ������������������������;�������

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

/������������������������������������������������������������������������������������������������3�����#���������������

���� ������������������������!��7������#������������������������������������������������������������ �����������&�B�����!��

��������(����#������� �����%B*�$� �������� ����������������

����������;�8+����������&�B�8����D���*�+�&��������� ������;�8+!��/��� ��������������������������������� �����

�������E�!�

FmyIfsFile if e disk extdesc('MYLIB/READIFS') F USROPN F handler(readIfs : ifsDs) /copy MYLIB/QRPGLESRC,READIFS D ifsDs ds likeds(readIfs_t) /free ifsDs.path = '/home/mydir/myIfsFile.txt'; open myIfsFile;

2.2 Comparison to RPG SPECIAL files

������� �����������������������������������+��&��*�����!���+��&��*����������������������������������������������������������������������

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

+������������������� ��� ����������� ��������������+��&��*������������

,! ��+��&��*�������������������������������������� �����������3��������@+�DA�����!�������� ��������� ��� ������������������������������ �!�

Page 6: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 6

-! ��+��&��*��������������������� ��������������������������������������� ���������������������!�������� ������������������� �������� ��������������������� �������������������������#�

�� ����������#���������������������������������!�.! ��+��&��*�������������� ������������ � 0������������������������� � 0�����������������������������������<#�,����-#�������1�������+��&��*������� ���������!��������������� ����������+��&��*�����#�

��������������� ��������������,-.,�@���������+��&��*�����A!��������� �������������������������� ������������� � 0��� �������

�������������� �������������������� ���#�������������� � 0������#���������������� ������� ��#���� �����0���������#��������

��������!��F! ��+��&��*�������������� �������� ����������!��������� ������������ ��� ������������������ �����!�

Page 7: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 7

3 Coding the handler �

/����������� ��� �� �������������*����������!���� ��������������������� �������� �����D��������*�����#��*��&������*��&$*!��/������ ������������� ���� ����������@D���*�+�&#�=#�D&$**�+�&A����

D�:��:�&&!�

*� �����D������������ ������������� ��12..���!��/����� ����������� ��� �������������������������� ����������������� �!�

3.1 The record and key data

/������������������������� ����������������������� ���������������

��������#�����������0�������!�/����������� ��� ��������� ��������������������������� �������������:���������� ��������������

���:����4�������� ���������������������������������5,5!��

:����������������������

/�������#������#��������� ������������������������������

���������������������� ������ ���� �����!�/����������������� �����������(�����������������#��������#�����������#��� �����#�

��������������������!�/�������������������������������������� �������G������� ������������������������������������ ��

������C&=��� ����������� ����!�%����������������������H� �&&+�;#� ���7&+�-���������� �������������������&&+�;���������

�����(�����������!��

8����������� �� �����������#����;(#�&=��:#��)8%/#�����

�������������������������������������������������������!�/��������� ����������������������������������������������������

�����������������������0�������#������������ ����������������������#���������#�������������������������������������(� �������

�� ������ �������������������������!��8�������)8%/���������#���������������������� ���������������������������������������

������!�

'�������������������������� �� ���������������� �������������#�����������������������������������������������@�����*��$�����

Page 8: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 8

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

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

�������

,! /����������������������������������� �������������������(������������ �� ����� �����������!������������������� �������

�������������������(������������ �� �����������������������

����������������������� ����������������������!��-! '������������������������������� ������3������� �������������#���������������������������������� ��#�������� � ��������������������������� �� ��#���� � ������������������������

��������������������������������������������� ����������#�������3������������������������������������� ���������� ��

���!��:���( ����������� �������G������������������������������� ����������������!��/������������������������( �����#����

��������������� ��������������������#����������������������H����������������������������������� �����������������������������

��������������� ��������� ������������ �����������0������� �����!��������������������:;���#��������� ��������������

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

;�������� ��������� ������������ �����������0������� �������

/������������ ��������������������������������(� ������������������ ������������������������������ �����!�:��������������������������������������������������!����������������������

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

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

;�������������� �� �����������#����;(#�&=��:�����)8%/#�����

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

�����������:;���#���������������������0���������������������������������������������������������������������������� �� ���

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

8�����0����������������#���������������������0������������������������0��� �����#������������0�������� ����������������������������� �� ���0���!�

Page 9: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 9

4 The parameter passed to the Open-Access handler

/������������������������������������������������������������������

����!�/�������������������������� ���������������������������� ���������

• +������ ������������ ������ �������������� ���������������������������������!�8����(�������

��+������

/��������������� ������������������������������������ ������������������������������������������� �������������������

�������������������!�������������6�������� ������� ���!�

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

������� ����@������������������� �������,<<<�����-<<<A#��������������� ��������������������������������������!�

�� ���:����

8��������������������@���;(#�&=��:A��������(������������ �� ����������������������������� ����������#�����

�� �������������� ������ ��������������������������0�������� ���� �����������������0�����!�

����;���*���

8��������������������@���;(#�&=��:A��������(������������ �� �������#�������������������������� ��������� ������

�������������!� �����/������������� ������������������������������������ ���������!�

����

%���� ���������5,5���������;����������������� �����'��/��

������������ ���������������!������������5<5����� ���������������� ���������� ������������������������!�

������

%���� ���������5,5������&=��:#�+�/**����+�/�/���������������� ������!������������5<5����� ���������������� ��������

���������!�

�3����

%���� ���������5,5������+�/**�������������������� ����������(� ������� ������������ ����������!������������5<5����� ��������������(� ����� ���������������!�

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

Page 10: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 10

%���� ���������5,5������'��/����������������������������

�������������������������!������������5<5����� ���������������������������� ��!�

������� ����

8��������������������@���;(#�&=��:#��)8%/A#������������������������������������������������� ���!�/����

��� �����������������������$�������� ��������������������������4�������� �����!�

• +������ ����������� ������ �������������� �����������������������������������������������������������������������!�8����(�������

����

/�������������� ������� ������������ ��������������

������������������������&:�0������!�

��� ����9���

8�����'�9+/:������ �� �����������#������ �����0���

���������,�-F� ���������I�:9(����� �������� ��������!������������,-,�,-J����� �������������������:/#��**7�#�

�**;':#�&*���#�=�*�����=%��0���#����� �������������������� ���������,,-,�K�,,-J!������������������ ������

������������������������,-LL!�

7��������� ����������������������� ����9����� �������

QrnFunctionKey_None

QrnFunctionKey_01

QrnFunctionKey_24

QrnFunctionKey_PRINT

QrnFunctionKey_ROLLUP

QrnFunctionKey_ROLLDOWN

QrnFunctionKey_CLEAR

QrnFunctionKey_HELP

QrnFunctionKey_HOME

• +������ ������������������������������������������������8����(�������

Page 11: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 11

�� ���*������

8�������(������������ �� �������#���������������������������� ����������������� ��������������������������������� �����!�

�(������8�����

���� ������������������������������������������������������!��������������������� ������ �������)/8�*��0�������

������������!����������)/8�*��0����������������� �����#�����

�� ��������I*�$*��������������������:�%�#�������>���:�%�?��������������������������������������8����

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

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

�(������%�� ���

���� ������������ �������������������������������������������!��������������������� ������ �������)/%$��0�������

������������!���������%$��0����������������� �����#�������

I8��+/!��

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

�����8����

���� ���������������������� �������������������������(������������ �� �������!���

������������������������������� ������������������ ����������#����������� ������������������������� ����������!��8���

�(����#������������������� ��� ����������)/;�+&�0��������� �����������%B8�*�#������������������������������%B8�*�����

%B*�$�/=��8�*�#���������� �����8������ ���������������� ���� �����%B*�$����������/=��8�*�!�

�(��������;�� �� ���

���� �������������������(������������ �� ��!�

0����8����

���� ���������;�+9����������� ������ ��0��������������������������� ������� ���!�

�� 0���

���� ��������������;�+9����������� ��������� �� 0�� ����������������!� �����/����������� �������������������

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

Page 12: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 12

• +������ �������������������������������������������������������!��

���������

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

�����������������#������� ��������������������=�:;*���0������� ��� ������������ ����������� ������ ��

��������������������!�/�������������� ����������������������������������������� ��!�/�������� ��� �����������������

���G�������������������������� ����!�/���������������������������������������������������G��������������������

������������������&�B�������������������������� ��!�

����������

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

��������������������������� ��������������������������������� ������������������:���������#�������������� ��������

�������������������&*+����������!��

4.1 The main structure of the Open-Access parameter

/������� �������������D����� ���E/!�

Subfield Type Set by Used by

structLen UBIN4 RPG Handler

parameterFormat CHAR(8) RPG Handler

userArea Pointer 2 RPG Handler and RPG programmer

stateInfo Pointer 4 Handler Handler

recordLevels 1 Pointer 2 RPG Handler

inputBuffer Pointer 2, 3 Handler RPG

inputNullMap 1 Pointer 2, 3 Handler RPG

outputBuffer Pointer 2 , 3 RPG Handler

outputNullMap 1 Pointer 2, 3 RPG Handler

namesValues 1 Pointer 2 , 3 RPG and Handler RPG and Handler

Key Pointer 2 , 3 RPG Handler

Page 13: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 13

Subfield Type Set by Used by

keyNullMap 1 Pointer 2 , 3 RPG Handler

keyNamesValues 1 Pointer 2 , 3 RPG Handler

Indara Pointer 2 , 3 RPG and Handler RPG and Handler

Prtctl Pointer 2 , 3 RPG and Handler RPG and Handler

openFeedback Pointer 4 Handler RPG

ioFeedback Pointer 4 Handler RPG

deviceFeedback Pointer 4 Handler RPG

externalFile QrnObject_T RPG Handler

externalMember CHAR(10) RPG Handler

compileFile 1 QrnObject_T RPG Handler

recordName 1 CHAR(10) RPG and Handler RPG and Handler

rpgOperation UINT(4) RPG Handler

rpgStatus INT(4) Handler RPG

inputBufferLen UINT(4) RPG Handler

inputNullMapLen 1 UINT(4) RPG Handler

outputBufferLen UINT(4) RPG Handler

outputNullMapLen 1 UINT(4) RPG Handler

keyLen UINT(4) RPG Handler

keyNullMapLen 1 UINT(4) RPG Handler

inputDataLen UINT(4) Handler RPG

openFeedbackLen UINT(4) Handler RPG

ioFeedbackLen UINT(4) Handler RPG

deviceFeedbackLen UINT(4) Handler RPG

numKeys 1 UINT(4) RPG Handler

Rrn UINT(4) RPG and Handler RPG and Handler

formLen UINT(4) RPG Handler

formOfl UINT(4) RPG Handler

functionKey UINT(1) Handler RPG

Page 14: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 14

Subfield Type Set by Used by

externallyDescribed Indicator RPG Handler

keyedFile Indicator RPG Handler

Blocked Indicator RPG Handler

Eof Indicator Handler RPG

Found Indicator Handler RPG

Equal Indicator Handler RPG

printerOverflow Indicator Handler RPG

inputWithLock Indicator RPG Handler

useNamesValues 1 Indicator Handler RPG

4.1.1 Notes on the QrnOpenAccess_T subfields

,! /������ ������������������������������(������������ �� ��������!�-! /���M+��� �M�����M7���� �M� ������������������������������������������������������!�

.! /����������������� �����!��/����������������������������������� ������������#��������������������� ��������������� ����� ������������������!�

F! /����������������� �������������!�

4.1.2 Descriptions of the QrnOpenAccess_T subfields �� 0����

5,5���������������� �� 0��������������������!�5<5����������!�

�����8�����

/����� ��������������������������� ��������������� ���������������������� ��������������(������������ �� �������!�

���� �8��� � 0��

��������������������������������������������������������������������������� ���� ��� ����� � 0����������������5���:8;+!����������������������������������� �������������#��������� ���� ��� �

���� � 0�������������:8;+��������������� �����!�/�������������

�� ������ ������ �8��� � 0*��!�

���� �8��� � 0*����

/��������������������� ���� ��� ����� � 0���������������������

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

Page 15: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 15

�����

+������5,5� ����������������������������� ���������������!�/����������� ���������������5<5����������!�

�3�����

+������5,5� ���������������������(� ����� ������������ ����+�/**���������!�/����������� ���������������5<5����������!�

�(������8�����

/����� ������������������������������������������������������!�

�(������%�� ����

/������ �������������������������������������������!�

�(��������;�� �� ����

5,5�����������������(������������ �� ��������������������!�5<5����������!�

����*����

�������������������!�������������������������������� �� ������:/�������!�

��������

���������������������!�������������������������������� �� ������:/�������!�

�������

+������5,5� ��������������������� �������������� ������������������������@&=��:#�+�/**#�+�/�/A!�/����������� ���������������5<5�

���������!�

��� ����9����

/������ �����0���,�-F�������� �����������������'�9+/:��������������!��������� ���������������������������������,�-F!�

��������

�����������������:;�������������LL����� �������������������'�9+/:�������:/��������������!�:7**��������������������

����������������:;���!�

����$�������

����������������������� ������������������������������� ������������������������ ���!�/������������������� ������$�����*��!��

:7**��������������������������������������������������������������� �����������������������������������!�

Page 16: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 16

����$�����*����

/���������������������� �����!�N���������������� ���������������������#��������������������������������� ���������!�

����;���*����

'�����������������(������������ �� ������������� ��������������������� ������ ����������������#�������� ����������� ������ ��������������������� ������������������������������������������

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

����:���%���

��������������������� ������������������� ������������������������ ���!�/������������������� ������:���%�*��!�:7**��������

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

����:���%�*����

/��������������������������� ������!�N��������������������� ����������������������#��������������������������������� ���������!�

����'���*� 0��

5,5��������������������������������������� 0������� �����������������������������!�5<5����������!�

��8��� � 0��

������������������������������������������������������������������������������ � 0����������������5���:8;+!���������������������

�������������� �������������#������������ � 0������������

�:8;+��������������� �����!�/��������������� ������ ����8��� � 0*��!�

��8��� � 0*����

/������������������������ � 0��������������������� �������������!�

0����

����������������������� ��������������������������0������� ����������������������� ���!�/������������������� ��0��*��!�:7**��������

��������������������������������������������������0��������������������������������!�

0��*����

/�����������������0��� �����!�N�����������0��� ���������������������#��������������������������������� ���������!�

0��:����4�������

Page 17: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 17

����������������D��:����4�����E/����� ����������������������#�

����#����������������� ���� �������������0������� ����!�:7**���������������������������������������������������#�����������

��������������������������0���!�

0��:���%���

��������������������� ��������������0����������������������������

����� ���!�/������������������� ��0��:���%�*��!�:7**����������������������������������������������������������0������

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

0��:���%�*����

/�����������������0�������� ������!�N�����������0�������� ����������������������#��������������������������������� ���������!�

0����8�����

5,5����������������0����������������������!�5<5����������!�

�����4�������

����������������D��:����4�����E/����� ����������������������#�

����#����������������� ���� ��������������� ���!�:7**���������������������������������������������������#��������������������

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

���9�����

/������ ������0����������0���������������������(���������

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

���8��� � 0��

������������������������������������������������������������������������������� � 0����������������5���:8;+!����������������������������������� �������������#������������� � 0������������

�:8;+��������������� �����!�/��������������� ������ �����8��� � 0*��!�

���8��� � 0*����

/������������������������� � 0��������������������� �������������!�

�����$�������

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

������������������ ���!�/������������������� �������$�����*��!�:7**����������������������������������������������������������

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

�����$�����*����

Page 18: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 18

/����������������������� �����!�N����������������� �������������

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

�����:���%���

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

�� ���!�/������������������� �������:���%�*��!�:7**���������������������������������������������������������������� ���������

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

�����:���%�*����

/���������������������������� ������!�N���������������������� ����������������������#��������������������������������� ���������!�

��������8�������

/��������������������� �����

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

+������5,5� ���������������������������������� �����������������������������������������!�/����������� ���������������5<5�

���������!�

�� ����

��������������������� ����������� ��������������:/�������!�:7**�

������������������������:/�������!�

�� ���*�������

����������������D���� ���*�����E/����� ������������������� ����

���������� ������������ ���� ���������������!�:7**�������������������������� �� ��!�

�� ���:�����

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

������������������������!���������#������������������ ���0!��'���������� ���0#�����������������������������������(���������

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

�����������

/������������ �������������� ����������������!�&���������

D���������EI���������������� ���������!�7������#�������������� ����������������������� ���#� ����������������� �����

����������������������� ������������������!�8����(����#�����+�/**������������������D���������E+�/**#�

Page 19: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 19

D���������E�+�/�:E+/��/����

D���������E�+�/�:E�:;!��������������!�

��+�������

/������������������������� �������������6����������� �������������

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

�������������� ����������������������������( ���������� ����������������������� ���!�

�����

��������� ������������������������ ������� ������������������������������������ �����������������0�������������!�

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

�����������

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

���� �*����

/��������������������� �����

���:����4�������

+������5,5� �������������������������������������������������

������������������������������������� ������������������������ �����������0���!�/����������� ���������������5<5����������!�/����

�� ������������������ �� ��������������������:���������!�

����������

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

4.2 The names-values structure listing all the fields

/������� �������������D��:����4�����E/!�

Subfield Type Set by Used by

num UBIN4 RPG Handler

Field QrnNameValue_T array RPG and Handler RPG and Handler

4.2.1 Descriptions of the QrnNamesValues_T subfields

�������

/�����������������������������������

Page 20: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 20

�����

/������ ���������������� �� ��� �����������������!�

4.3 The name-value structure for a single field

/������� �������������D��:���4����E/!�

Subfield Type Set by Used by

externalName CHAR(10) RPG Handler

dataType UINT(1) RPG Handler

numericDefinedLen UINT(1) RPG Handler

decimals UINT(1) RPG Handler

dtzFormat UINT(1) RPG Handler

dtSeparator CHAR(1) RPG Handler

input Indicator RPG Handler

output Indicator RPG Handler

isNullCapable Indicator RPG Handler

hasNullValue Indicator RPG and Handler RPG and Handler

valueLenBytes UINT(4) RPG and Handler RPG and Handler

valueMaxLenBytes UINT(4) RPG Handler

valueCcsid INT(4) RPG Handler

value Pointer 1, 2 RPG Handler

Notes on the QrnNameValue_T subfields

,! /���M+��� �M�����M7���� �M� ������������������������������������������������������!�

-! /����������������� �����!��/����������������������������������� ������������#��������������������� ��������������� ����� ������������������!�

4.3.1 Descriptions of the QrnNameValue_T subfields

Page 21: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 21

����/����

/������������������������!�&���������D��;������EI������������������!�

�� �������

/������ �������� ������� ����������� ����������!�%�������������������� ������������!�

��+���������

/������������������������������������!�%��������������������������������������!�

��68�������

/�������������������#�����#������������������!�%������������������#�����#������������������������!�&���������D��;�68�����EI�

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

�(������:�����

/�����������������������������(������������ �� �������!�

���:���4������

5,5����� ������������������������������������#�5<5����� ����������������������������������������������!�+��� ������������� �������������

������������������0�������������������������!�+��� ��������������������� ������������������������������������������!�%����������

������������:���&�� ������������������5,5!�

������

/����������������� �� ��!�%����������������������)8%/��������!�

��:���&�� ����

5,5���������������������� �� ��!�5<5����������!�

������ ;������*����

/����������������������������� ������!�8������� ��������#�� 0��#�6����#���� �����#�������������������� ������������!�8�����

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

�������

/������������������������������������ �������!�8��������� �������#���������������������������������������� ������C&=���

����������� ����!�8�������#�����#��������������������#���������������������������������������� ������C;�/�� ����������� �����

������������������������ �����������������������!�7�� ����@7&+�-A���������� ����������������&&+�;�������������������������!�/��������

Page 22: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 22

�����������������������������H� �&&+�;!�'�������������������������

����#������������������������������������������������������( ����������� ������ ������� ������ �������%�(*��$����!�

�����& �����

/���&&+�;��������������������������������!������������6�������� �����������������������������H� �&&+�;!�

�����*��$������

���� ������������ ������ ��������������������������� ������������������!�+��� ���������������������������������0��������!�

+��� �������������������������������!������������� ��������������������%�(*��$����!�

�����%�(*��$������

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

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

������������������� �������(�� �����:���������!�

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

���������������+�/**�I+/��/�

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

�������������������� �� $��

���������������+�/**�I�:;�

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

��������������� $��

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

• ���� �������(�� �����3�������������������������������� �������������� ����

• �������������������������������� ������������� ����

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

• %������������� �������������#�����������������������������������>���?��� ���������O,"!�

��������������� $%�

����������������������(�� ��������� ������� ����

!��"�����#������%���������� ����� �����������������������(�� ��������� ���#�����������������������������������>���?��� ���������O,"!�

Page 23: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 23

�����/���������������� ������� ������ ����������������������� �� ���������!�

��������������� $��

���������������������3����0��#������������ ������������� ������

!��"�����#������%������������� �����������������������(���� ���#�������������������������� ������� ��������0��!���������#���������>���?��� ���������O,"!�

������+���D���������E���;�E&7���:/�����������3����0��������������� ������������� �����!�

��������������� $��

���������������+�3������������������������������

!��"�����#������%������������� ������ � 0����#�����������������������������������>���?��� ���������O,"!�

��������������� $���

���������������������3����0����������#������������ ������������� ������

!��"�����#������%������������� ������ � 0������������������ ���#�������������������������� ������� ��������0��!���������#���������>���?�

�� ���������O,"!�

������+���D���������E���;��E&7���:/�����������3����0����������������������� ������������� �����!�

�������������%! � �

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

• �������>0����8���?��� ���������O<"#���������������������������������������������� ������������� ������� ���

• �������>0����8���?��� ���������O,"#���������������������������������������������� ��0���

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

0������������ ��#�����������������������������M�����M��� ���������5,5!����������#���������M�����M��� ���������5<5!�

�����/���������������� ������� ������ ����������������������� �� ���������!�

��������������&'(���

���������������'������������������������������������������ �������

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

• ������������������������������������� ������������� ������� ��������� ����������������� �����������

• �� ��������������������������������#��� ��������������������������� ������� ��������� ����������������� �����������

• +����������������������������� ����������������������������������

Page 24: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 24

• ������������������� ������� ��������� ����������������� �����������

o +�������������� ���� �������� ������� �����������

o +���������� ����������������������D���������E���;&����D���������E&=��:��������������������� ��������������

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

���������������+����������������

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

• +������������ ��������������������� ������������������������� �����������

• +�������>�����?��� ���������>,?��������������� ������ �����

����������������))����������

���������������+���������������

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

• +������������ ��������������������� ������������������3��������������� �����������

• +�������>�����?��� ���������>,?��������������� ������ ����

• +�������>�3���?��� ���������>,?���������� �����������(� ����� �������������� �����������

�������������* )�%+���������

���������������7��� 0��� ����

�������������*�$ �����������

���������������7��������� ��������� �����

!��"�����#������7����������� ��������������� 0��#����������������������������������������������������� 0��!�

�������������,��������������

���������������'������� ����

!��"�����#������8������������������ ������� ���#��������������������������� ��� ����������������������������������� ��3�����D���������E���;&����D���������&=��:���������!�

�������������$�)����

���������������;�������� ���� ������������� ������� ������0���

������+���D���������E;�*�/�E&7���:/�����;���������� ��������� ���������������� ������������� �����!�

�������������'��$�����������

���������������8�� ��������������

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

������������������� �������(�� �� �����������������

Page 25: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 25

�������������$�)����%*��� ���

���������������;���������� ��������� ����

!��"�����#������;���������� ��������� ��������������� 0��#�������������������

���������������������������������� 0��!�

������+���D���������E;�*�/������;���������� ��������� ��������������� ������������� �����!�

��������������� $��%*��� ���

���������������������3����0��#������������� ������������� ������

!��"�����#������%������������� �����������������������(���� ���#�����

��������������������� ������� ��������0�������������������� ��������� ���!���������#���������>���?��� ���������O,"!�

������+���D���������E���;������������3����0�������������� ������������� �����!�

��������������� $���%*��� ���

���������������������3����0����������#������������� ������������� ������

!��"�����#������%������������� ������ � 0������������������ ���#�������������������������� ������� ��������0�������������������� ��������� ���!�

��������#���������>���?��� ���������O,"!�

������+���D���������E���;�������������3����0���������������������� ������������� �����!�

Page 26: 1 Rational Open-Access: RPG Edition - IBM filePage 1 1 Rational Open-Access: RPG Edition ˘ ˇ ˆˆ ˙ ˝ ... 1.1 Open Access handlers ˝ ˝ ! ˝ ˝ ˝ ...

Copyright 2010 IBM Corporation. Page 26

5 Summary

� 7��������� ������� �����(��������������@=�:;*���0������A������� ��������� ����(�@�����������A!�

� /��������������������� ����������������������������� ��� �����������������(��������(�������������������������������������#�

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

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