home *** CD-ROM | disk | FTP | other *** search
/ Internet Standards / CD1.mdf / nist / oiw / agreemnt / 19w_9403.txt < prev    next >
Text File  |  1994-05-22  |  12KB  |  925 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.           Working Implementation
  9.           Agreements for Open Systems
  10.           Interconnection Protocols:
  11.           Part 19 - Remote Database Access
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.           Output from the March 1994 OSE Implementors' Workshop (OIW)
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.           SIG Chair:          Peter Eng, IBM Canada
  60.           SIG Editor:    Joel Berson,  Santosh  Hasani,  Digital  Equipment
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.           Corp.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                           ii
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.           Part 19 - Remote Database Access             March 1994 (Working)
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.           Foreword
  159.  
  160.  
  161.  
  162.           This part of  the Working Implementation Agreements  was prepared
  163.           by the Remote  Database Access  Special Interest  Group (RDA SIG)
  164.           of the Open Systems Environment Implementors' Workshop (OIW). See
  165.           Part 1 -  Workshop Policies and Procedures in  the "Draft Working
  166.           Implementation Agreements Document" for the workshop charter.
  167.  
  168.           Text  in  this part  has  been  approved by  the  Plenary of  the
  169.           Workshop. 
  170.  
  171.           Future  changes   and  additions   to  this   version  of   these
  172.           implementation  Agreements will  be  published  as change  pages.
  173.           Deleted and  replaced text  will be shown  as strikeout.  New and
  174.           replacement text will be shown as shaded.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.                                          iii
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.           Part 19 - Remote Database Access             March 1994 (Working)
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                           iv
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.           Part 19 - Remote Database Access             March 1994 (Working)
  273.  
  274.                                   Table of Contents
  275.  
  276.  
  277.           Part 19 - Remote Database Access  . . . . . . . . . . . . . .   1
  278.  
  279.           0   Introduction  . . . . . . . . . . . . . . . . . . . . . .   1
  280.  
  281.           1   Scope . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  282.  
  283.           2   Status  . . . . . . . . . . . . . . . . . . . . . . . . .   1
  284.  
  285.           3   Normative references  . . . . . . . . . . . . . . . . . .   1
  286.  
  287.           4   Definitions and abbreviations . . . . . . . . . . . . . .   1
  288.  
  289.           5   Structure of RDA standards  . . . . . . . . . . . . . . .   1
  290.  
  291.           6   SQL specialization  . . . . . . . . . . . . . . . . . . .   1
  292.               6.1  Service parameter limits/agreements  . . . . . . . .   1
  293.               6.2  Limits for common parameters . . . . . . . . . . . .   1
  294.               6.3  Other limits and agreements  . . . . . . . . . . . .   2
  295.               6.4   Profiles  . . . . . . . . . . . . . . . . . . . . .   2
  296.  
  297.           Annex A (normative)
  298.  
  299.           RDA SIG object identifiers  . . . . . . . . . . . . . . . . .   4
  300.  
  301.           Annex B (normative)
  302.  
  303.           Protocol Implementation Conformance Statement . . . . . . . .   5
  304.  
  305.           Annex C (informative)
  306.  
  307.           SQLSTATE values for RDA errors  . . . . . . . . . . . . . . .   6
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                           v
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.           Part 19 - Remote Database Access             March 1994 (Working)
  339.  
  340.                                     List of Tables
  341.  
  342.           Table 42 - Object Identifiers defined by RDA  . . . . . . . .   4
  343.           Table 43 - SQLSTATE values for RDA errors . . . . . . . . . .   7
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.                                           vi
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.           Part 19 - Remote Database Access
  405.  
  406.  
  407.           0   Introduction
  408.  
  409.           Refer to the Stable Implementation Agreements.
  410.  
  411.  
  412.           1   Scope
  413.  
  414.           Refer to the Stable Implementation Agreements.
  415.  
  416.  
  417.           2   Status
  418.  
  419.           Refer to the Stable Implementation Agreements.
  420.  
  421.  
  422.           3   Normative references
  423.  
  424.           Refer to the Stable Implementation Agreements.
  425.  
  426.  
  427.           4   Definitions and abbreviations
  428.  
  429.           Refer to the Stable Implementation Agreements.
  430.  
  431.  
  432.           5   Structure of RDA standards
  433.  
  434.           Refer to the Stable Implementation Agreements.
  435.  
  436.  
  437.           6   SQL specialization
  438.  
  439.  
  440.           6.1    Service parameter limits/agreements
  441.  
  442.           Refer to the Stable Implementation Agreements.
  443.  
  444.  
  445.  
  446.           6.2    Limits for common parameters
  447.  
  448.           Refer to the Stable Implementation Agreements.
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.                                           1
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.           Part 19 - Remote Database Access             March 1994 (Working)
  471.  
  472.           6.3    Other limits and agreements
  473.  
  474.           Refer to the Stable Implementation Agreements.
  475.  
  476.  
  477.           6.4     Profiles
  478.  
  479.           The  names of RDA profiles are  of the form "ARD-abcd". ("ARD" is
  480.           reserved in ISO/IEC TR 10000-2 for Remote database Access.)
  481.  
  482.           a identifies the RDA specialization:
  483.  
  484.                0 = SQL Specialization
  485.  
  486.           b identifies the capabilities for transaction management:
  487.  
  488.                0 = transactions  accessing data resources through  a single
  489.                remote open system (RDA Basic application-context). The type
  490.                of transaction management provided is one-phase commitment.
  491.  
  492.                1 = transactions spanning more than one open system (the RDA
  493.                TP application-context).  The type of transaction management
  494.                provided is two-phase commitment.
  495.  
  496.           c identifies  the functionality  provided; that  is,  the set  of
  497.           functional  units or other major elements of function    mandated
  498.           by  the  profile.   This  may  differ   among  the  various   RDA
  499.           Specializations. See  below for the           definition of  this
  500.           element for the SQL Specialization.
  501.  
  502.           d identifies the role:
  503.  
  504.                0  = client  role;  that  is, the  ability  to initiate  RDA
  505.                requests.
  506.  
  507.                1  = server  role; that is,  the ability  to respond  to RDA
  508.                requests.
  509.  
  510.                (An implementation  that provides  both  roles must  specify
  511.                both profiles.)
  512.  
  513.           For the  SQL  Specialization, the  following functionalities  are
  514.           defined:
  515.  
  516.           ARD-000d  = Immediate  execution: the  capability to  immediately
  517.           execute SQL  statements. (The significant   function  is the  RDA
  518.           Immediate Execution functional unit.)
  519.  
  520.           ARD-001d =  Stored execution: the  capability to store  and later
  521.           execute  SQL statements. (The  significant   function is  the RDA
  522.  
  523.                                           2
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.           Part 19 - Remote Database Access             March 1994 (Working)
  537.  
  538.           Stored Execution functional unit.)
  539.  
  540.  
  541.  
  542.  
  543.  
  544.           ARD-002d = Status: the capability to perform status operations on
  545.           other dialogues.  (The significant  function   is the  RDA Status
  546.           functional    unit    together     with    support    for     the
  547.           controlServiceDataRequested   parameter   of   the   R-Initialize
  548.           service.)
  549.  
  550.           ARD-003d = Cancel: the capability to perform cancel operations on
  551.           other  dialogues. (The significant   function  is the  RDA Cancel
  552.           functional    unit    together     with    support    for     the
  553.           controlServiceDataRequested   parameter   of   the   R-Initialize
  554.           service.)
  555.  
  556.           Profiles for the RDA TP  application-context will be defined at a
  557.           later time.
  558.  
  559.           Refer to the  Stable Implementation Agreements for  the rules for
  560.           and descriptions of the RDA profiles.
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.                                           3
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.           Part 19 - Remote Database Access             March 1994 (Working)
  603.  
  604.           Annex A (normative)
  605.  
  606.           RDA SIG object identifiers
  607.  
  608.           Refer to the Stable Implementation Agreements.
  609.  
  610.                      Table 42 - Object Identifiers defined by RDA
  611.  
  612.                  Object Identifier           Reference
  613.  
  614.            iso (1) identified-
  615.            organization (3) oiw (14)
  616.            rda-sig (9) testbed (2)
  617.            SQL-environments (1)
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.                                           4
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.           Part 19 - Remote Database Access             March 1994 (Working)
  669.  
  670.           Annex B (normative)
  671.  
  672.           Protocol Implementation Conformance Statement
  673.  
  674.           No text.
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.                                           5
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.           Part 19 - Remote Database Access             March 1994 (Working)
  735.  
  736.           Annex C (informative)
  737.  
  738.           SQLSTATE values for RDA errors
  739.  
  740.           If passed on from the RDA service provider to an SQL Application
  741.           in the RDA Client, errors returned by the SQL Server in RDA Error
  742.           Responses are mapped into SQLSTATE values as specified in Table
  743.           43, SQLSTATE values for RDA errors.
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.                                           6
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.           Part 19 - Remote Database Access             March 1994 (Working)
  801.  
  802.                       Table 43 - SQLSTATE values for RDA errors
  803.  
  804.             SQLSTATE         RDA Service Error Name
  805.               VALUE
  806.            HZ001       accessControlViolation
  807.  
  808.            HZ002       badRepetitionCount
  809.  
  810.            HZ003       commandHandleUnknown
  811.            HZ004       controlAuthenticationFailure
  812.  
  813.            HZ005       controlServicesNotAllowed
  814.  
  815.            HZ006       dataResourceAlreadyOpen
  816.            HZ007       dataResourceHandleNotSpecified
  817.  
  818.            HZ008       dataResourceHandleUnknown
  819.  
  820.            HZ009       dataResourceNameNotSpecified
  821.            HZ010       dataResourceNotAvailable
  822.  
  823.            HZ011       dataResourceUnknown
  824.  
  825.            HZ012       dialogueIDUnknown
  826.            HZ013       duplicateCommandHandle
  827.  
  828.            HZ014       duplicateDataResourceHandle
  829.  
  830.            HZ015       duplicateDialogueID
  831.            HZ016       duplicateOperationID
  832.  
  833.            HZ017       invalidSequence
  834.  
  835.            HZ018       noDataResourceAvailable
  836.  
  837.            HZ019       operationAborted
  838.            HZ020       operationCancelled
  839.  
  840.            HZ021       serviceNotNegotiated
  841.  
  842.            HZ022       transactionRolledBack
  843.            HZ023       userAuthenticationFailure
  844.  
  845.            HZ024       hostIdentifierError
  846.  
  847.            HZ025       invalidSQLConformanceLevel
  848.            HZ026       rDATransactionNotOpen
  849.  
  850.            HZ027       rDATransactionOpen
  851.  
  852.  
  853.                                           7
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.           Part 19 - Remote Database Access             March 1994 (Working)
  867.  
  868.            HZ028       sQLAccessControlViolation
  869.  
  870.            HZ029       sQLDatabaseResourceAlreadyOpen
  871.  
  872.            HZ030       sQLDBLArgumentCountMismatch
  873.            HZ031       sQLDBLArgumentTypeMismatch
  874.  
  875.            HZ032       sQLDBLNoCharSet
  876.  
  877.            HZ033       sQLDBLTransactionStatementNotAllo
  878.                        wed
  879.  
  880.            HZ034       sQLUsageModeViolation
  881.             SQLSTATE        ACSE Service Error Name
  882.               VALUE
  883.  
  884.  
  885.            HZ200       A-AssociateFailurePermanent
  886.  
  887.            HZ201       A-AssociateFailureTransient
  888.            HZ202       A-ReleaseFailure
  889.  
  890.            HZ203       A-AbortFailureServiceUser
  891.  
  892.            HZ204       A-AbortFailureServiceProvider
  893.  
  894.             SQLSTATE         TP Service Error Name
  895.               VALUE
  896.  
  897.            HZ500       BeginDialogueRejectedUser
  898.  
  899.            HZ501       BeginDialogueRejectedProvider
  900.  
  901.            HZ502       UError
  902.            HZ503       UAbortRollbackTrue
  903.  
  904.            HZ504       UAbortRollbackFalse
  905.  
  906.            HZ505       PAbortRollbackTrue
  907.            HZ506       PAbortRollbackFalse
  908.  
  909.            HZ507       HeuristicMix
  910.  
  911.            HZ508       HeuristicHazard
  912.            HZ509       Rollback
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.                                           8
  920.  
  921.  
  922.  
  923.  
  924.  
  925.