Technical Standard Structured Transaction Definition Language (STDL) NICAL H S C T A E N T D A R D [This page intentionally left blank] X/Open CAE Specification Structured Transaction Definition Language (STDL) X/Open Company Ltd. August 1996, X/Open Company Limited All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior permission of the copyright owners. X/Open CAE Specification Structured Transaction Definition Language (STDL) ISBN: 1-85912-176-4 X/Open Document Number: C611 Published by X/Open Company Ltd., U.K. Any comments relating to the material contained in this document may be submitted to: The Open Group Apex Plaza Forbury Road Reading Berkshire, RG1 1AX United Kingdom or by Electronic Mail to: [email protected] ii X/Open CAE Specification (1996) Contents Part 1 STDL Specification ........................................................................... 1 Chapter 1 Introduction to STDL .......................................................................... 3 1.1 The STDL Language................................................................................... 3 1.1.1 Major Features .......................................................................................... 3 1.1.2 Resource Manager Access...................................................................... 4 1.2 The STDL Model ......................................................................................... 5 1.2.1 Mapping STDL to Different Client/Server Models.......................... 5 1.2.2 Mapping STDL to the X/Open DTP Model....................................... 8 1.2.3 Mapping STDL to Existing TP Monitors ............................................ 9 1.3 Client Programs........................................................................................... 10 1.4 Application Flow and Transaction Control........................................... 11 1.4.1 Transactions .............................................................................................. 11 1.4.2 Task Call..................................................................................................... 11 1.4.3 Submit Task............................................................................................... 12 1.4.4 Transactional Task Call........................................................................... 13 1.4.5 Non-transactional Task Call .................................................................. 13 1.4.6 Transactional Submit Task..................................................................... 14 1.4.7 Concurrent Execution ............................................................................. 15 1.4.8 Text Messages........................................................................................... 16 1.4.9 Exception Handling................................................................................. 16 1.5 Database and File Access .......................................................................... 18 1.6 Accessing a Display.................................................................................... 19 1.6.1 Non-transactional Presentation Procedures ...................................... 19 1.6.2 Transactional Presentation Procedures ............................................... 20 1.7 Communications......................................................................................... 21 1.8 STDL Language Components .................................................................. 22 1.8.1 STDL Source Files.................................................................................... 22 1.8.2 Execution Environment.......................................................................... 26 1.8.3 The STDL Specification .......................................................................... 26 Chapter 2 Introduction to Part 1 ........................................................................... 27 2.1 Scope.............................................................................................................. 27 2.2 Organisation of Part 1 ................................................................................ 28 2.3 Syntax Notation .......................................................................................... 29 2.4 Conventions................................................................................................. 30 2.4.1 Definitions ................................................................................................. 31 2.5 Conformance ............................................................................................... 32 2.5.1 Categories.................................................................................................. 34 2.5.2 Levels.......................................................................................................... 35 Structured Transaction Definition Language (STDL) iii Contents Chapter 3 Concepts ...................................................................................................... 37 3.1 Transaction................................................................................................... 37 3.1.1 Transactional and Durable Resources ................................................. 37 3.1.2 Isolation Level .......................................................................................... 38 3.2 TP System Model ........................................................................................ 40 3.2.1 Task............................................................................................................. 41 3.2.2 Task Group................................................................................................ 42 3.2.3 Processing Procedure.............................................................................. 43 3.2.4 Processing Group..................................................................................... 43 3.2.5 Display....................................................................................................... 44 3.2.6 Presentation Procedure........................................................................... 45 3.2.7 Presentation Group ................................................................................. 45 3.3 Task Invocation ........................................................................................... 47 3.3.1 Task Call..................................................................................................... 47 3.3.2 Task Submit............................................................................................... 50 3.3.2.1 Actions on the Submitter TP System ................................................ 52 3.3.2.2 Actions on the Client TP System ....................................................... 53 3.3.3 Dialogues................................................................................................... 54 3.4 Security ......................................................................................................... 56 3.4.1 Principal..................................................................................................... 56 3.4.2 User Authentication ................................................................................ 57 3.4.3 Remote Authentication........................................................................... 57 3.4.4 Authorization ........................................................................................... 58 3.5 Environment ................................................................................................ 59 3.5.1 Translation Environment ....................................................................... 59 3.5.2 Execution Environment.......................................................................... 59 3.5.3 Environmental Information................................................................... 59 3.6 Record Queuing .......................................................................................... 60 3.6.1 Ordering..................................................................................................... 60 3.6.2 Records and Positions............................................................................. 60 3.6.3 Context....................................................................................................... 60 3.6.4 Queue Operations.................................................................................... 61 3.6.4.1 EnqueueOperation............................................................................... 61 3.6.4.2 Dequeue Operation .............................................................................. 61 3.6.4.3 Read Queue Operation ........................................................................ 61 3.7 Exceptions .................................................................................................... 62 3.7.1 Types of Exceptions................................................................................. 62 3.7.2 Exception Classes, Sources, Codes and Level ................................... 62 3.7.3 How Exceptions Are Generated........................................................... 64 3.7.4 Exception Handlers................................................................................. 64 3.7.5 TP System Actions when an Exception is Generated .....................