Information technology — Programming languages, their environments and system software interfaces — Guidelines for the preparation of language-independent service specifications (LISS)

ISO/IEC TR 14369:2018 provides guidelines to those concerned with developing specifications of information technology services and their interfaces intended for use by clients of the services, in particular by external applications that do not necessarily all share the environment and assumptions of one particular programming language. The guidelines do not directly or fully cover all aspects of service or interface specifications, but they do cover those aspects required to achieve language independence, i.e. required to make a specification neutral with respect to the language environment from which the service is invoked. The guidelines are primarily concerned with the interface between the service and the external applications making use of the service, including the special case where the service itself is already specified in a language-dependent way but needs to be invoked from environments of other languages. Language bindings, already addressed by ISO/IEC TR 10182, are dealt with by providing advice on how to use the two documents together. ISO/IEC TR 14369:2018 provides technical guidelines, rather than organizational or administrative guidelines for the management of the development process, though in some cases the technical guidelines can have organizational or administrative implications.

Technologies de l'information — Langages de programmation, leurs environnements et interfaces du logiciel d'exploitation — Lignes directrices pour l'élaboration de spécifications de service indépendantes du langage (LISS)

General Information

Status
Published
Publication Date
29-Jan-2018
Current Stage
6060 - International Standard published
Start Date
30-Jan-2018
Due Date
07-Jul-2018
Completion Date
07-Jul-2018
Ref Project

Relations

Technical report
ISO/IEC TR 14369:2018 - Information technology -- Programming languages, their environments and system software interfaces -- Guidelines for the preparation of language-independent service specifications (LISS)
English language
64 pages
sale 15% off
Preview
sale 15% off
Preview

Standards Content (Sample)


TECHNICAL ISO/IEC TR
REPORT 14369
Second edition
2018-01
Information technology —
Programming languages, their
environments and system software
interfaces — Guidelines for the
preparation of language-independent
service specifications (LISS)
Technologies de l'information — Langages de programmation,
leurs environnements et interfaces du logiciel d'exploitation —
Lignes directrices pour l'élaboration de spécifications de service
indépendantes du langage (LISS)
Reference number
©
ISO/IEC 2018
© ISO/IEC 2018
All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may
be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting
on the internet or an intranet, without prior written permission. Permission can be requested from either ISO at the address
below or ISO’s member body in the country of the requester.
ISO copyright office
CP 401 • Ch. de Blandonnet 8
CH-1214 Vernier, Geneva, Switzerland
Tel. +41 22 749 01 11
Fax +41 22 749 09 47
copyright@iso.org
www.iso.org
Published in Switzerland
ii © ISO/IEC 2018 – All rights reserved

Contents Page
Foreword .vii
Introduction .viii
1 Scope . 1
2 Normative references . 1
3 Terms and definitions . 1
4 Abbreviated terms . 4
5 Overview . 4
5.1 Services, interfaces, service providers and service users . 4
5.2 Information technology services . 4
5.3 Services and language independence . 5
5.4 Language-independent specifications . 6
5.5 Problems of language dependence and inbuilt assumptions . 7
5.5.1 General. 7
5.5.2 Representational assumptions . 7
5.5.3 Implementation assumptions. 7
6 Guidelines on strategy . 8
6.1 General . 8
6.2 General guidelines. 8
6.2.1 Guideline: Dependence of the interface on the service . 8
6.2.2 Guideline: What to do when there are interoperability, concurrency, or
time constraint issues. 8
6.2.3 Guideline: Use of marshalling/unmarshalling . 8
6.2.4 Guideline: Recruiting expertise from a variety of backgrounds . 9
6.3 What to do if starting from scratch. 9
6.3.1 General. 9
6.3.2 Guideline: Avoidance of implementation assumptions . 9
6.3.3 Specifying the service in language-independent form . 9
6.3.4 Specifying the interface to the service in language-independent form .10
6.4 What to do if starting from an existing language-dependent specification .10
6.4.1 General.10
6.4.2 General guidelines .10
6.4.3 Converting an existing language-dependent specification of the service
into language-independent form .12
6.4.4 Converting an existing implicit interface into an explicit language-
independent interface .13
6.4.5 Specifying a language-independent interface to a service whose
specification is language-dependent .14
7 Guidelines on document organization.15
7.1 General .15
7.2 Guideline: The general framework .15
7.2.1 General.15
7.2.2 Checklist of parts for inclusion .15
7.3 Guideline: Production and publication .16
7.4 Guideline: Document organization when starting from a language-specific specification 16
8 Guidelines on terminology .17
8.1 General .17
8.2 Guideline: The need for rigour .17
8.3 Guideline: The need for consistency .17
8.4 Guideline: Use of undefined terms .17
8.5 Guideline: Use of ISO 2382 .17
8.6 Guideline: Use of definition by reference .18
© ISO/IEC 2018 – All rights reserved iii

8.7 Guideline: Terminology used in bindings .18
9 Guidelines on use of formal specification languages .18
9.1 Guideline: Use of a formal specification language .18
9.2 Checklist of formal specification languages .18
9.2.1 General.18
9.2.2 Estelle .18
9.2.3 Lotos .19
9.2.4 VDM-SL .19
9.2.5 Z .19
9.2.6 Extended BNF .20
9.3 Guideline: Using formal specifications from the outset .20
9.4 Guideline: Use of operational semantics .20
10 Guidelines on interoperability.21
10.1 General .21
10.1.1 Interoperability with what? .21
10.1.2 The nature of the interoperation .22
10.1.3 How interoperation is invoked .22
10.2 Guidelines on interoperability with other instantiations of the same service .22
10.2.1 Guideline: Identifying features affecting interoperability .22
10.2.2 Guideline: Precise definition and rigorous conformity requirements .22
10.2.3 Guideline: Importance of exchange values .23
10.3 Guidelines on interoperability with other services .23
10.3.1 General.23
10.3.2 Guideline: Interoperability with other services being defined at the same time .23
10.3.3 Guideline: Interoperability with a pre-defined service .23
11 Guidelines on concurrency issues .24
11.1 General .24
11.2 Guidelines on concurrency within the service specification .24
11.2.1 Guideline: Avoidance of unnecessary concurrency requirements .24
11.3 Guidelines on concurrency of interaction with service users .24
11.3.1 General.
...

Questions, Comments and Discussion

Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.