Debian Codegraph @

texmf-dist/source/latex/iso10303/stepe.dtx

raw
1 % \iffalse meta-comment
2 %
3 % stepe.dtx
4 %
5 % This work has been partially funded by the US government
6 % and is not subject to copyright.
7 %
8 % This program is provided under the terms of the
9 % LaTeX Project Public License distributed from CTAN
10 % archives in directory macros/latex/base/lppl.txt.
11 %
12 % Author: Peter Wilson (CUA and NIST)
13 % now at: [email protected]
14 %
15 % \fi
16 % \CheckSum{1959}
17 %
18 % \changes{v11}{1997/09/30}{Output character table to packages files only}
19 % \changes{v1.3}{1999/02/15}{Character table not output at all}
20 % \changes{v1.4}{2000/01/12}{Updated for edition 2 documents and tex4ht}
21 % \changes{v1.4}{2000/01/12}{Added labels to many clause headers}
22 % \changes{v1.5}{2001/07/16}{Many changes to match SD N200}
23 % \changes{v1.5}{2001/01/10}{Many changes to match SD N1217}
24 %
25 % \def\fileversion{v1.5}
26 % ^^A \def\filedate{2001/07/16}
27 % \def\filedate{2002/01/10}
28 % \title{\LaTeX{} Package Files for ISO 10303: \\ Source code\thanks{This
29 % file has version number \fileversion, last revised
30 % \filedate.}}
31 %
32 % \author{%
33 % Peter Wilson\\
34 % Catholic University of America \\
35 % Now at \texttt{[email protected]}
36 % }
37 % \date{\filedate}
38 % \maketitle
39 % \tableofcontents
40 %
41 % \StopEventually{}
42 %
43 % \section{Introduction}
44 %
45 % This document provides the commented source for the \LaTeX{}
46 % package files designed for the typesetting of documents according
47 % to the rules for ISO international standards, and specifically
48 % for ISO~10303 {\em Product data representation and exchange} commonly
49 % referred to as `STEP' (STandard for the Exchange of Product model data).
50 % A separate document provides the user manual~\cite{PRW96k}.
51 % This manual is typeset according to the conventions of the \LaTeX{}
52 % {\sc docstrip} utility which enables the automatic extraction of
53 % the \LaTeX{} package files~\cite{GOOSSENS94}.
54 %
55 %
56 % ISO (the International Organization for Standardisation)
57 % specify their document layout requirements in ISO Directives~\cite{ISOD397}.
58 % Unfortunately these Directives do not
59 % completely define the document layout, leaving several
60 % aspects open to interpretation by the document editor
61 % and re-interpretation by the ISO editorial board.
62 % In the case of STEP an additional set of informal
63 % `Supplementary Directives' have been established by the ISO TC184/SC4
64 % Editing Committe~\cite{SD537}. The packages defined herein provide
65 % extensions to the general package files~\cite{PRW96i,PRW96j} and meet
66 % the requirements of both of these Directives.
67 % Elsewhere there is a set of package files for the general typesetting
68 % of ISO documents~\cite{PRW96i,PRW96j}.
69 %
70 % Some of the STEP standard documents have been published by ISO from camera ready
71 % copy derived from electronic sources (this also means that ISO
72 % has not objected to the typographical conventions supported
73 % by these packages). Within ISO there are proposals
74 % to maintain and publish directly from SGML tagged electronic sources.
75 % The packages have been designed to simplify the conversion from
76 % \LaTeX\ to SGML tagging. Thus, there are more document structural
77 % elements defined than is usual with \LaTeX.
78 %
79 % As already noted, the macros described later are based on the STEP
80 % Supplementary Directives. If in the future the Directives are modified or
81 % extended, then it may be necessary to modify or extend the macros.
82 % Essentially, this manual is provided as a service for maintainers
83 % of the \LaTeX{} packages. It is assumed that any package maintainer
84 % is \LaTeX{} literate and accustomed to supporting a \LaTeX{}
85 % system~\cite{GOOSSENS94}.
86 %
87 %
88 % \section{A driver for this document}
89 %
90 % The next bit of code contains the documentation driver file for
91 % \LaTeX{}, i.e., the file that will produce the documentation you are
92 % currently reading. It will be extracted from this file by the
93 % {\sc docstrip} program.
94 %
95 % \begin{macrocode}
96 %<*driver>
97 \documentclass{ltxdoc}
98 % \end{macrocode}
99 %
100 % We want an index, using linenumbers, but not update information.
101 % \begin{macrocode}
102 \EnableCrossrefs
103 \CodelineIndex
104 %%% \RecordChanges
105 % \end{macrocode}
106 % We use so many \file{docstrip} modules that we set the
107 % \texttt{StandardModuleDepth} counter to 1.
108 % \begin{macrocode}
109 \setcounter{StandardModuleDepth}{1}
110 % \end{macrocode}
111 % Define some commonly used abbreviations
112 % \begin{macrocode}
113 \newcommand*{\Lopt}[1]{\textsf {#1}}
114 \newcommand*{\file}[1]{\texttt {#1}}
115 \newcommand*{\Lcount}[1]{\textsl {\small#1}}
116 \newcommand*{\pstyle}[1]{\textsl {#1}}
117 % \end{macrocode}
118 % We also want the full details printed.
119 % \begin{macrocode}
120 \begin{document}
121 \DocInput{stepe.dtx}
122 \PrintIndex
123 %%% \PrintChanges
124 \end{document}
125 %</driver>
126 % \end{macrocode}
127 %
128 % \section{Identification}
129 %
130 % These packages can only be used with \LaTeX 2e.
131 % \changes{v1.5}{2001/07/16}{Added am (Application Module) option and package}
132 % \begin{macrocode}
133 %<*step|ir|ap|ats|aic|am>
134 % \end{macrocode}
135 %
136 % Announce the Package name and its version:
137 % \begin{macrocode}
138 %<*step>
139 \ProvidesPackage{stepv13}[2002/01/10 v1.3.2 STEP general package]
140 %</step>
141 %<*ir>
142 \ProvidesPackage{irv12}[2002/01/10 v1.2.2 STEP IR package]
143 %</ir>
144 %<*ap>
145 \ProvidesPackage{apv12}[2002/01/10 v1.2.2 STEP AP package]
146 %</ap>
147 %<*ats>
148 \ProvidesPackage{atsv11}[2002/01/10 v1.1.2 STEP ATS package]
149 %</ats>
150 %<*aic>
151 \ProvidesPackage{aicv1}[2002/01/10 v1.0.2 STEP AIC package]
152 %</aic>
153 %<*am>
154 \ProvidesPackage{amv1}[2002/01/10 v1.0 STEP AM package]
155 %</am>
156 %</step|ir|ap|ats|aic|am>
157 % \end{macrocode}
158 %
159 %
160 % The \file{step} package is the main documentation style for
161 % STEP. Some of the other packages require this to be loaded.
162 % \begin{macrocode}
163 %<*ir|ap|ats|aic|am>
164 \RequirePackage{stepv13}[2002/01/10]
165
166 %</ir|ap|ats|aic|am>
167 % \end{macrocode}
168 %
169 % \section{Initial Code}
170 %
171 % In this part we define a few commands that are used later on.
172 %
173 % \begin{macro}{\stepemptystring}
174 % This is an alias for the |\isoemptystring| command (for
175 % the purposes of upwards compatibility).
176 % We use it in testing for an empty parameter.
177 % \begin{macrocode}
178 %<step> \let\stepemptystring\isoemptystring
179 % \end{macrocode}
180 % \end{macro}
181 %
182 % \section{The STEP package}
183 %
184 % This section defines the facilities available in the STEP package.
185 % \begin{macrocode}
186 %<*step>
187 % \end{macrocode}
188 %
189 % \subsection{Preamble commands}
190 %
191 % The commands defined in this section should, if required,
192 % be placed in the document preamble.
193 %
194 % \begin{macro}{\partno}
195 % \begin{macro}{\thespartno}
196 % |\partno{|\meta{part number}|}| specifies the part number
197 % for ISO 10303. Internally, it is referred to by |\thespartno|.
198 % \begin{macrocode}
199 \gdef\thespartno{}
200 \newcommand{\partno}[1]{\gdef\thespartno{#1}}
201 % \end{macrocode}
202 % \end{macro}
203 % \end{macro}
204 %
205 % \begin{macro}{\series}
206 % \begin{macro}{\theseries}
207 % \begin{macro}{\Theseries}
208 % |\series{|\meta{series name}|}| specifies the particular
209 % series name for this Part of ISO 10303. Internally, it is
210 % referred to by |\theseries|.
211 % \changes{v11}{1997/09/30}{Added series commands}
212 % \changes{v1.5}{2001/07/16}{Changed \cs{thes@ries} to \cs{theseries}}
213 % \changes{v1.5}{2001/07/16}{Added \cs{Theseries}}
214 % \begin{macrocode}
215 \gdef\theseries{}
216 \gdef\Theseries{}
217 \newcommand{\series}[1]{\gdef\Theseries{#1}
218 \gdef\theseries{\MakeLowercase{#1}}}
219 % \end{macrocode}
220 % \end{macro}
221 % \end{macro}
222 % \end{macro}
223 %
224 % \begin{macro}{\doctitle}
225 % \begin{macro}{\thed@ctitle}
226 % \begin{macro}{\st@pn@me}
227 % |\doctitle{|\meta{informal title}|}| specifies the informal
228 % title of the document to be placed on the cover sheet.
229 % Internally, it is referred to by |\thed@ctitle|.
230 % \changes{v11}{1997/09/30}{Changed definition of the doctitle command}
231 % \begin{macrocode}
232 \gdef\thed@ctitle{}
233 \newcommand{\doctitle}[1]{\gdef\thed@ctitle{#1}}
234 \newcommand{\st@pn@me}{Product data representation and exchange}
235 % \end{macrocode}
236 % \end{macro}
237 % \end{macro}
238 % \end{macro}
239 %
240 % \begin{macro}{\ballotcycle}
241 % \begin{macro}{b@cyc}
242 % |\ballotcycle{|\meta{ballot cycle number}|}| specifies the
243 % ballot cycle number for the document (i.e, 0, 1, 2, \ldots).
244 % The command sets the \Lcount{b@cyc} counter appropriately.
245 % \changes{v11}{1997/09/30}{Added ballotcycle command and counter}
246 % \begin{macrocode}
247 \newcounter{b@cyc}
248 \newcommand{\ballotcycle}[1]{\setcounter{b@cyc}{#1}}
249 % \end{macrocode}
250 % \end{macro}
251 % \end{macro}
252 %
253 % \begin{macro}{\ifanir}
254 % TRUE if the document is an IR (generic or application).
255 % \changes{v1.5}{2001/07/16}{Added \cs{ifanir}}
256 % \begin{macrocode}
257 \newif\ifanir
258 \anirfalse
259
260 % \end{macrocode}
261 % \end{macro}
262 %
263 % \begin{macro}{\ifhaspatents}
264 % TRUE if the document has identified patents.
265 % \changes{v1.5}{2001/08/29}{Added \cs{ifhaspatents}}
266 % \begin{macrocode}
267 \newif\ifhaspatents
268 \haspatentsfalse
269
270 % \end{macrocode}
271 % \end{macro}
272 %
273 % \begin{macro}{\ifmapspec}
274 % Set up for use Mapping specification (TRUE) or table (FALSE) in an AP.
275 % Initialise to FALSE (i.e., requires no change to an existing AP).
276 % \changes{v1.5}{2001/07/16}{Added \cs{ifmapspec}}
277 % \changes{v1.5}{2002/01/23}{Moved \cs{ifmapspec} from AP to STEP}
278 % \begin{macrocode}
279 \newif\ifmapspec
280 \mapspecfalse
281 % \end{macrocode}
282 % \end{macro}
283 %
284 % \subsection{Indexing style commands}
285 %
286 % We make sure that the index style commands are appropriate.
287 %
288 % \begin{macro}{\indexfill}
289 % \begin{macro}{\sindexfill}
290 % \begin{macro}{\ssindexfill}
291 % Dotted lines between an index entry and the page number.
292 % \begin{macrocode}
293 \renewcommand{\indexfill}{\dotfill}
294 \renewcommand{\sindexfill}{\dotfill}
295 \renewcommand{\ssindexfill}{\dotfill}
296 % \end{macrocode}
297 % \end{macro}
298 % \end{macro}
299 % \end{macro}
300 %
301 % \begin{macro}{\alphaindexspace}
302 % \begin{macro}{\otherindexspace}
303 % No extra vertical spacing between blocks of index entries,
304 % \begin{macrocode}
305 \renewcommand{\alphaindexspace}[1]{}
306 \renewcommand{\otherindexspace}[1]{}
307 % \end{macrocode}
308 % \end{macro}
309 % \end{macro}
310 %
311 % \begin{macro}{\indexsee}
312 % \begin{macro}{\indexseealso}
313 % Formatting of {\em see} and {\em see also}.
314 % \begin{macrocode}
315 \renewcommand{\indexsee}[1]{\par \hspace*{2em} {\em see} #1}
316 \renewcommand{\indexseealso}[1]{\par \hspace*{2em} {\em see also} #1}
317
318 % \end{macrocode}
319 % \end{macro}
320 % \end{macro}
321 %
322 % \begin{macro}{\ix}
323 % Both print and index a word or phrase.
324 % \begin{macrocode}
325 \newcommand{\ix}[1]{#1\index{#1}}
326
327 % \end{macrocode}
328 % \end{macro}
329 %
330 % \subsection{Miscellaneous commands}
331 %
332 % \subsubsection{Font changes}
333 %
334 % \begin{macro}{\B}
335 % \begin{macro}{\E}
336 % \begin{macro}{\BG}
337 % |\B{|\meta{text}|}| prints \meta{text} in bold while |\E{|\meta{text}|}|
338 % prints it {\em emphasized}. |\BG{|\meta{mathsymbol}|}| prints
339 % \meta{mathsymbol} in bold.
340 % \begin{macrocode}
341 \newcommand{\B}[1]{{\bf #1}}
342 \newcommand{\E}[1]{{\em #1}}
343 \newcommand{\BG}[1]{{\mbox{\boldmath $#1$}}}
344
345 % \end{macrocode}
346 % \end{macro}
347 % \end{macro}
348 % \end{macro}
349 %
350 % \subsubsection{Logos}
351 %
352 % \begin{macro}{\Express}
353 % \begin{macro}{\ExpressG}
354 % \begin{macro}{\ExpressI}
355 % \begin{macro}{\ExpressX}
356 % The commands print the logos for the {\small\sc EXPRESS} family
357 % of information modeling languages. (Note: In Part 11 the macros
358 % were specified as |{{\small\sl EX\-PRESS}}|, etc. but the STEP
359 % Editing Committee ignored the wishes of the authors of EXPRESS
360 % leading to the definitions below.)
361 % \begin{macrocode}
362 \newcommand{\Express}{{\sc EX\-PRESS}}
363 \newcommand{\ExpressG}{{\sc EX\-PRESS-G}}
364 \newcommand{\ExpressI}{{\sc EX\-PRESS-I}}
365 \newcommand{\ExpressX}{{\sc EX\-PRESS-X}}
366
367 % \end{macrocode}
368 % \end{macro}
369 % \end{macro}
370 % \end{macro}
371 % \end{macro}
372 %
373 % \subsubsection{EXPRESS code symbols}
374 %
375 % \begin{macro}{\nexp}
376 % Highlight an EXPRESS-defined name.
377 % \begin{macrocode}
378 \newcommand{\nexp}[1]{\textbf{#1}}
379 % \end{macrocode}
380 % \end{macro}
381 %
382 % \begin{macro}{\HASH}
383 % \begin{macro}{\LT}
384 % \begin{macro}{\LE}
385 % \begin{macro}{\NE}
386 % \begin{macro}{\INE}
387 % \begin{macro}{\GE}
388 % \begin{macro}{\GT}
389 % Various symbols used within EXPRESS.
390 % \begin{macrocode}
391 \newcommand{\HASH}{\texttt{\small \#}}
392 \newcommand{\LT}{\texttt{\small <}}
393 \newcommand{\LE}{\texttt{\small <=}}
394 \newcommand{\NE}{\texttt{\small <>}}
395 \newcommand{\INE}{\texttt{\small :<>:}}
396 \newcommand{\GE}{\texttt{\small >=}}
397 \newcommand{\GT}{\texttt{\small >}}
398 % \end{macrocode}
399 % \end{macro}
400 % \end{macro}
401 % \end{macro}
402 % \end{macro}
403 % \end{macro}
404 % \end{macro}
405 % \end{macro}
406 % \begin{macro}{\CAT}
407 % \begin{macro}{\HAT}
408 % \begin{macro}{\QUES}
409 % \begin{macro}{\BS}
410 % \begin{macro}{\IEQ}
411 % \begin{macro}{\INEQ}
412 % More EXPRESS symbols.
413 % \begin{macrocode}
414 \newcommand{\CAT}{\texttt{\small ||}}
415 \newcommand{\HAT}{\texttt{\small ^}}
416 \newcommand{\QUES}{\texttt{\small ?}}
417 \newcommand{\BS}{\texttt{\small \\}}
418 \newcommand{\IEQ}{\texttt{\small :=:}}
419 \newcommand{\INEQ}{\texttt{\small :<>:}}
420
421 % \end{macrocode}
422 % \end{macro}
423 % \end{macro}
424 % \end{macro}
425 % \end{macro}
426 % \end{macro}
427 % \end{macro}
428 %
429 % \begin{macro}{\xword}
430 % SD N200 says that EXPRESS reserved words in the text should
431 % be written in smallcaps. Use as |\xword{|\meta{word}|}|, where
432 % \meta{word} is an EXPRESS (-I, -X) word in any case.
433 % \changes{v1.5}{2001/07/16}{Added EXPRESS keywords}
434 % \begin{macrocode}
435 \newcommand{\xword}[1]{\textsc{\lowercase{#1}}}
436
437 % \end{macrocode}
438 % \end{macro}
439 %
440 %
441 %
442 % \subsubsection{marginal notes}
443 %
444 % \begin{macro}{\mnote}
445 % Put a note into the document margin. This is only operative when
446 % the \Lopt{draft} option is in effect.
447 %
448 % \begin{macrocode}
449 \newcommand{\mnote}[1]{\ifdr@ftd@c
450 \marginpar{\raggedright\tiny #1}
451 \fi}
452
453 % \end{macrocode}
454 % \end{macro}
455 %
456 % \subsection{EXPRESS code documentation}
457 %
458 % The commands and environments in this section are for documenting
459 % EXPRESS code.
460 %
461 % \subsubsection{environments}
462 %
463 % \begin{environment}{specific@tion}
464 % An environment to tag the body of a specification.
465 % \begin{macrocode}
466 \newenvironment{specific@tion}[1]{}{}
467 % \end{macrocode}
468 % \end{environment}
469 %
470 % \begin{environment}{espec}
471 % \begin{environment}{fspec}
472 % \begin{environment}{rspec}
473 % \begin{environment}{sspec}
474 % \begin{environment}{tspec}
475 % Environments for tagging the bodies of entity, function, rule, schema and
476 % type specifications.
477 % \begin{macrocode}
478 \newenvironment{espec}[1]{}{}
479 \newenvironment{fspec}[1]{}{}
480 \newenvironment{rspec}[1]{}{}
481 \newenvironment{sspec}[1]{}{}
482 \newenvironment{tspec}[1]{}{}
483 % \end{macrocode}
484 % \end{environment}
485 % \end{environment}
486 % \end{environment}
487 % \end{environment}
488 % \end{environment}
489 %
490 % \begin{environment}{dtext}
491 % An environment to tag descriptive text.
492 % \begin{macrocode}
493 \newenvironment{dtext}{}{}
494
495 % \end{macrocode}
496 % \end{environment}
497 %
498 % \begin{macro}{\pbre@k}
499 % \begin{macro}{\nopbre@k}
500 % Internal commands to encourage page breaking before a list heading
501 % and discourage after the heading.
502 % \begin{macrocode}
503 \newcommand{\pbre@k}{\pagebreak[2]}
504 \newcommand{\nopbre@k}{\nopagebreak}
505
506 % \end{macrocode}
507 % \end{macro}
508 % \end{macro}
509 %
510 % \begin{macro}{\ehe@d}
511 % \begin{macro}{\ehe@dmark}
512 % An internal command for (underlined) headings. |\ehe@dmark| is required
513 % otherwise the title is printed twice!
514 % \begin{macrocode}
515 \newcommand{\ehe@d}{\@startsection{ehe@d}{20}
516 {\z@}% % indent
517 {-\baselineskip}% % beforeskip
518 {0.5\baselineskip}% % afterskip
519 {}}% % normal body text style for heading
520 \newcounter{ehe@d}
521 \newcommand{\ehe@dmark}[1]{}
522
523 % \end{macrocode}
524 % \end{macro}
525 % \end{macro}
526 %
527 % \begin{environment}{ecode}
528 % Environment for writing EXPRESS code.
529 % \begin{macrocode}
530 \newenvironment{ecode}{%
531 \ehe@d*{{\underline{\protect\Express{} specification}}:}
532 \begin{Efont}}%
533 {\end{Efont}}
534
535 % \end{macrocode}
536 % \end{environment}
537 %
538 % \begin{environment}{eicode}
539 % Environment for writing EXPRESS-I code.
540 % \begin{macrocode}
541 \newenvironment{eicode}{%
542 \ehe@d*{{\underline{\protect\ExpressI{} specification}}:}
543 \begin{Efont}}%
544 {\end{Efont}}
545
546 % \end{macrocode}
547 % \end{environment}
548 %
549 % \begin{environment}{excode}
550 % Environment for writing EXPRESS-X code.
551 % \begin{macrocode}
552 \newenvironment{excode}{%
553 \ehe@d*{{\underline{\protect\ExpressX{} specification}}:}
554 \begin{Efont}}%
555 {\end{Efont}}
556
557 % \end{macrocode}
558 % \end{environment}
559 %
560 % \begin{environment}{expdesc}
561 % A non-indented description environment.
562 % \begin{macro}{\expdesclabel}
563 % The label for the description list. Note that it includes a colon.
564 % \begin{macrocode}
565 \newcommand{\expdesclabel}[1]{{\bf #1:}}
566 % \end{macrocode}
567 % \end{macro}
568 %
569 % \begin{macrocode}
570 \newenvironment{expdesc}{\list{}%
571 {\setlength{\leftmargin}{\z@} \setlength{\labelsep}{0.5em}
572 \setlength{\itemindent}{\labelsep} \setlength{\labelwidth}{\z@}
573 \setlength{\itemsep}{\z@ \@plus 0.2ex \@minus 0.1ex}
574 \setlength{\parsep}{0.5\baselineskip}
575 \let\makelabel\expdesclabel}}%
576 {\endlist}
577
578 % \end{macrocode}
579 % \end{environment}
580 %
581 % \begin{environment}{attrlist}
582 % Listing of attribute descriptions.
583 % \begin{macrocode}
584 \newenvironment{attrlist}{%
585 \ehe@d*{{\underline{Attribute definitions}}:}
586 \begin{expdesc}}%
587 {\end{expdesc}}
588
589 % \end{macrocode}
590 % \end{environment}
591 %
592 % \begin{environment}{fproplist}
593 % Listing of formal propositions.
594 % \begin{macrocode}
595 \newenvironment{fproplist}{%
596 \ehe@d*{{\underline{Formal propositions}}:}
597 \begin{expdesc}}%
598 {\end{expdesc}}
599
600 % \end{macrocode}
601 % \end{environment}
602 %
603 % \begin{environment}{iproplist}
604 % Listing of informal propositions.
605 % \begin{macrocode}
606 \newenvironment{iproplist}{%
607 \ehe@d*{{\underline{Informal propositions}}:}
608 \begin{expdesc}}%
609 {\end{expdesc}}
610
611 % \end{macrocode}
612 % \end{environment}
613 %
614 % \begin{environment}{enumlist}
615 % Listing of enumerated items.
616 % \begin{macrocode}
617 \newenvironment{enumlist}{%
618 \ehe@d*{{\underline{Enumerated item definitions}}:}
619 \begin{expdesc}}%
620 {\end{expdesc}}
621
622 % \end{macrocode}
623 % \end{environment}
624 %
625 % \begin{environment}{arglist}
626 % Listing of argument definitions.
627 % \begin{macrocode}
628 \newenvironment{arglist}{%
629 \ehe@d*{{\underline{Argument definitions}}:}
630 \begin{expdesc}}%
631 {\end{expdesc}}
632
633 % \end{macrocode}
634 % \end{environment}
635 %
636 % \subsubsection{Indexing}
637 %
638 % \begin{macro}{\ixent}
639 % \begin{macro}{\ixenum}
640 % \begin{macro}{\ixfun}
641 % \begin{macro}{\ixproc}
642 % \begin{macro}{\ixrule}
643 % \begin{macro}{\ixsc}
644 % \begin{macro}{\ixschema}
645 % \begin{macro}{\ixselect}
646 % \begin{macro}{\ixtype}
647 % Macros for indexing EXPRESS definitions.
648 % \changes{v1.5}{2001/07/16}{Added EXPRESS indexing macros}
649 % \begin{macrocode}
650 \newcommand{\ixent}[1]{\index{#1 (entity)}}
651 \newcommand{\ixenum}[1]{\index{#1 (enumeration)}}
652 \newcommand{\ixfun}[1]{\index{#1 (function)}}
653 \newcommand{\ixproc}[1]{\index{#1 (procedure)}}
654 \newcommand{\ixrule}[1]{\index{#1 (rule)}}
655 \newcommand{\ixsc}[1]{\index{#1 (subtype\_constraint)}}
656 \newcommand{\ixschema}[1]{\index{#1 (schema)}}
657 \newcommand{\ixselect}[1]{\index{#1 (select)}}
658 \newcommand{\ixtype}[1]{\index{#1 (type)}}
659
660 % \end{macrocode}
661 % \end{macro}
662 % \end{macro}
663 % \end{macro}
664 % \end{macro}
665 % \end{macro}
666 % \end{macro}
667 % \end{macro}
668 % \end{macro}
669 % \end{macro}
670 %
671 % \subsection{STEP part title}
672 %
673 % \begin{macro}{\stepparttitle}
674 % A special title command for STEP parts. \\
675 % |\stepparttitle{|\meta{Part title}|}| \\
676 % It is implemented in the same manner as the general ISO |\title|
677 % command but using specific title wording.
678 % \changes{v1.5}{2001/07/16}{Added \cs{par} to \cs{stepparttitle}}
679 % \changes{v1.5}{2001/07/16}{Changed to \cs{cleardoublepage} in \cs{stepparttitle}}
680 % \begin{macrocode}
681 \gdef\thestepparttitle{}
682 \newcommand{\scivm@in}{Industrial automation systems and integration ---\newline}
683 \newcommand{\stepc@mp}{Product data representation and exchange ---\newline}
684 \newcommand{\thisp@rtno}[1]{Part #1 :\newline}
685 \newcommand{\sptitle}[1]{#1\par}
686 \newcommand{\stepparttitle}[1]{%
687 \cleardoublepage\pagenumbering{arabic}
688 %%% \setcounter{section}{0}
689 \setcounter{clause}{0}
690 \ifotherdoc \else
691 \protect\thispagestyle{isotitlehead}
692 \fi
693 \gdef\thestepparttitle{{\Tfont\bf \scivm@in \stepc@mp
694 \thisp@rtno{\thespartno} \sptitle{#1}}}
695 \if@twocolumn
696 \twocolumn[\vspace*{2\baselineskip}\vbox to 35mm{\thestepparttitle}]
697 \else
698 \vspace*{2\baselineskip}\vbox to 35mm{\thestepparttitle}
699 \fi}
700
701 % \end{macrocode}
702 % \end{macro}
703 %
704 % \subsection{Headings and boilerplate}
705 %
706 % There are certain elements within a standard that are predetermined.
707 %
708 % \subsubsection{Foreword elements}
709 %
710 % \begin{macro}{\Foreword}
711 % This command introduces the Foreword for ISO~10303.
712 %
713 % \changes{v1}{1995/05/31}{Deleted `contributions from Foreword.}
714 % \changes{v1}{1995/05/31}{SC4 has changed its name to Industrial Data.}
715 % \changes{v1.5}{2001/07/16}{Changed \cs{Foreword} to get new boilerplate}
716 % \changes{v1.5}{2001/08/29}{Changed \cs{Foreword} to accomodate yet another ISO change of mind}
717 % \changes{v1.5}{2002/01/10}{Changed \cs{Foreword} to accomodate yet another ISO change of mind}
718 %
719 % \begin{macrocode}
720 \newcommand{\Foreword}{%
721 \begin{foreword}
722 %%% \input{isofwdbp}
723 \fwdbp
724
725 \ifhaspatents\else\fwdnopatents\fi
726
727 \iftechspec
728 ISO/TS~10303--\thespartno\
729 \else
730 \ifpaspec
731 ISO/PAS~10303--\thespartno\
732 \else
733 ISO~10303--\thespartno\
734 \fi
735 \fi
736 was prepared by Technical Committee
737 ISO/TC~184, \textit{Industrial automation systems and integration},
738 Subcommittee SC4, \textit{Industrial data}.
739 }
740 % \end{macrocode}
741 % \end{macro}
742 %
743 % \begin{macro}{\endForeword}
744 % The command for ending the STEP Foreword. Use as: \\
745 % |\endForeword{|\meta{normannexes}|}{|\meta{infannexes}|}|
746 % \changes{v1.5}{2001/07/16}{Changed \cs{endForeword} for new boilerplate}
747 % \begin{macrocode}
748 \gdef\endForeword#1#2{%
749 \par
750 A complete list of parts of ISO~10303 is available from the Internet:\\
751 \centerline{\isourl{http://www.nist.gov/sc4/editing/step/titles/}}
752 \par
753
754 % Don't talk about annexes if relevent argument is empty.
755 \if\stepemptystring{#1} \else%
756 #1 a normative part of this part of ISO~10303. \fi%
757 %% an integral part of this part of ISO~10303. \fi%
758 \if\stepemptystring{#2} \else%
759 #2 for information only. \fi
760 \end{foreword}
761 }
762
763 % \end{macrocode}
764 % \end{macro}
765 %
766 % \begin{macro}{\steptrid}
767 % Boilerplate for the foreword describing the creators of a TR.
768 % \begin{macrocode}
769 \newcommand{\steptrid}{%
770
771 ISO/TR~10303--\thespartno, which is a Technical Report of type 2,
772 was prepared by Technical Committee
773 ISO/TC~184, \textit{Industrial automation systems and integration,}
774 Subcommittee SC4, \textit{Industrial data.}
775
776 }
777
778 % \end{macrocode}
779 % \end{macro}
780 %
781 % \begin{macro}{\fwdshortlist}
782 % \changes{v1.4}{2000/01/12}{Added \cs{fwdshortlist} command}
783 % These commands typeset the list of STEP parts and the list of STEP
784 % documentation divisions, respectively.
785 % \changes{v1.5}{2001/07/16}{Deleted \cs{fwdpartslist}, \cs{fwddivslist}
786 % and their associated files}
787 % \begin{macrocode}
788 \newcommand{\fwdshortlist}{\input{stppdlst}}
789
790 % \end{macrocode}
791 % \end{macro}
792 %
793 %
794 % The following is the contents of the file \file{stppdlst.tex}. The wording
795 % is based on the SD edition 2.
796 % \changes{v1.4}{2000/01/12}{Added stppdlst.tex file}
797 % \changes{v1.5}{2001/07/16}{Changed the stppdlst.tex file}
798 % \begin{macrocode}
799 %</step>
800 %<*fwd4>
801 \ProvidesFile{stppdlst.tex}[2001/07/16 STEP parts and divisions URL]
802 \typeout{stppdlst.tex [2001/07/16 STEP parts and divisions URL]}
803
804 This International Standard is organized as a series of parts,
805 each published separately. The structure of this International
806 Standard is described in ISO~10303--1.
807
808 Each part of this International Standard is a member of one
809 of the following series:
810 description methods,
811 implementation methods,
812 conformance testing methodology and framework,
813 integrated generic resources,
814 integrated application resources,
815 application protocols,
816 abstract test suites,
817 application interpreted constructs,
818 and
819 application modules.
820 This part is a member of the \theseries{} series.
821 \ifanir The integrated generic resources and the integrated application
822 resources specify a single conceptual product data model.
823 \fi
824
825
826 %</fwd4>
827 %<*step>
828 % \end{macrocode}
829 %
830 % \subsubsection{The introduction}
831 %
832 % \begin{environment}{Introduction}
833 % Starts a new `introduction' clause, together with initial STEP boilerplate.
834 % \changes{v1}{1995/05/31}{Added AICs to introduction text.}
835 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfs1.tex}
836 % \changes{v1.5}{2001/07/16}{Deleted the argument to the Introduction environment}
837 % \begin{macrocode}
838 \newenvironment{Introduction}{%
839 \clearpage
840 \begin{introduction}
841 \input{bpfs1}
842
843 }%
844 {\end{introduction}}
845
846 % \end{macrocode}
847 % \end{environment}
848 %
849 % Here is the text maintained in file \file{bpfs1.tex}.
850 % \changes{v1.5}{2001/07/16}{Changed contents of bpfs1.tex file}
851 % \begin{macrocode}
852 %</step>
853 %<*bpfs1>
854 \ProvidesFile{bpfs1.tex}[2001/07/16 STEP Intro boilerplate]
855 \typeout{bpfs1.tex [2001/07/16 STEP Intro boilerplate]}
856
857 ISO 10303 is an International Standard for the computer-interpretable
858 representation of product information and for the exchange of product data.
859 The objective is to
860 provide a neutral mechanism capable of describing products
861 throughout their life cycle.
862 This mechanism is suitable
863 not only for neutral file exchange, but also as a basis for
864 implementing and sharing product databases, and as a basis for archiving.
865
866 %</bpfs1>
867 %<*step>
868 % \end{macrocode}
869 %
870 %
871 % \begin{environment}{majorsublist}
872 % This environment provides boilerplate text and an itemized listing
873 % for major subdivisions of the standard.
874 % \begin{macrocode}
875 \newenvironment{majorsublist}{%
876 \majorsubname
877 \begin{itemize}}{\end{itemize}}
878
879 % \end{macrocode}
880 % \end{environment}
881 %
882 % \begin{macro}{\majorsubname}
883 % Boilerplate for introduction to major subdivision listing.
884 % \changes{v1.5}{2002/01/22}{Changed boilerplate in \cs{majorsubname}}
885 % \begin{macrocode}
886 \newcommand{\majorsubname}{%
887 Major subdivisions of this part of ISO~10303 are:}
888
889 % \end{macrocode}
890 % \end{macro}
891 %
892 % \changes{v1.5}{2001/07/16}{Deleted \cs{introend} and file endint.tex}
893 %
894 % \subsubsection{Miscellaneous headings}
895 %
896 % Here we define the commands to produce `standard' clause headings,
897 % and in some cases the introductory boilerplate.
898 % Some of these are general in nature while others are specific
899 % to IR parts.
900 %
901 % \begin{macro}{\partidefhead}
902 % Starts a `Terms defind in ISO 10303-1' subclause
903 % \begin{macrocode}
904 \newcommand{\partidefhead}{\sclause{Terms defined in ISO~10303-1}}
905 % \end{macrocode}
906 % \end{macro}
907 %
908 % \begin{macro}{\refdefhead}
909 % Starts a `Terms defined in ' subclause
910 % \begin{macrocode}
911 \newcommand{\refdefhead}[1]{\sclause{Terms defined in #1}}
912 % \end{macrocode}
913 % \end{macro}
914 %
915 % \begin{macro}{\otherdefhead}
916 % Starts a `Other definitions' subclause
917 % \begin{macrocode}
918 \newcommand{\otherdefhead}{\sclause{Other terms and definitions}}
919 % \end{macrocode}
920 % \end{macro}
921 %
922 % \begin{macro}{\schemahead}
923 % \begin{macro}{\schemaintro}
924 % Identification of a clause describing an EXPRESS schema,
925 % and the introductory boilerplate.
926 % \changes{v1.5}{2001/07/16}{Changed \cs{irschemaintro} to \cs{schemaintro}}
927 % \begin{macrocode}
928 \let\schemahead=\clause
929 \newcommand{\schemaintro}[1]{%
930 The following \Express{} declaration begins the \nexp{#1}
931 and identifies the necessary external references.\par}
932
933 % \end{macrocode}
934 % \end{macro}
935 % \end{macro}
936 %
937 % \begin{macro}{\introsubhead}
938 % Starts an `Introduction' subclause.
939 % \begin{macrocode}
940 \newcommand{\introsubhead}{\sclause{\introductionname}}
941 % \end{macrocode}
942 % \end{macro}
943 %
944 % \begin{macro}{\fcandasubhead}
945 % Starts a `Fundamental concepts and assumptions' subclause.
946 % \begin{macrocode}
947 \newcommand{\fcandasubhead}{\sclause{\fcandaname}}
948 % \end{macrocode}
949 % \end{macro}
950 %
951 % \begin{macro}{\singletypehead}
952 % \begin{macro}{\typehead}
953 % Starts a `type definition' or `type definitions' subclause.
954 % \begin{macrocode}
955 \newcommand{\singletypehead}[2]{\sclause{#1 type definition: #2}}
956 \newcommand{\typehead}[1]{\sclause{#1 type definitions}}
957 % \end{macrocode}
958 % \end{macro}
959 % \end{macro}
960 %
961 % \begin{macro}{\atypehead}
962 % Starts a `type definition' subsubclause.
963 % \begin{macrocode}
964 \newcommand{\atypehead}[1]{\ssclause{#1}}
965 % \end{macrocode}
966 % \end{macro}
967 %
968 % \begin{macro}{\singleentityhead}
969 % \begin{macro}{\entityhead}
970 % Starts an `entity definition' subclause or
971 % an `entity definitions' subclause. Use the latter as: \\
972 % |\entityhead{|\meta{schema}|}{|\meta{group}|}| where \meta{schema}
973 % is the name of the schema and \meta{group} is a possibly blank
974 % grouping identifier.
975 % \begin{macrocode}
976 \newcommand{\singleentityhead}[2]{\sclause{#1 entity definition: #2}}
977 \newcommand{\entityhead}[2]{%
978 \if\stepemptystring{#2}
979 \sclause{#1 entity definitions}
980 \else
981 \sclause{#1 entity definitions: #2}
982 \fi
983 }
984 % \end{macrocode}
985 % \end{macro}
986 % \end{macro}
987 %
988 % \begin{macro}{\anentityhead}
989 % Starts an `entity definition' subsubclause.
990 % \begin{macrocode}
991 \newcommand{\anentityhead}[1]{\ssclause{#1}}
992 % \end{macrocode}
993 % \end{macro}
994 %
995 % \begin{macro}{\singlerulehead}
996 % \begin{macro}{\rulehead}
997 % Starts a `rule definition' or `rule definitions' subclause.
998 % \begin{macrocode}
999 \newcommand{\singlerulehead}[2]{\sclause{#1 rule definition: #2}}
1000 \newcommand{\rulehead}[1]{\sclause{#1 rule definitions}}
1001 % \end{macrocode}
1002 % \end{macro}
1003 % \end{macro}
1004 %
1005 % \begin{macro}{\arulehead}
1006 % Starts a `rule definition' subsubclause.
1007 % \begin{macrocode}
1008 \newcommand{\arulehead}[1]{\ssclause{#1}}
1009 % \end{macrocode}
1010 % \end{macro}
1011 %
1012 % \begin{macro}{\singlefunctionhead}
1013 % \begin{macro}{\functionhead}
1014 % Starts a `function definition' or a `function definitions' subclause.
1015 % \begin{macrocode}
1016 \newcommand{\singlefunctionhead}[2]{\sclause{#1 function definition: #2}}
1017 \newcommand{\functionhead}[1]{\sclause{#1 function definitions}}
1018 % \end{macrocode}
1019 % \end{macro}
1020 % \end{macro}
1021 %
1022 % \begin{macro}{\afunctionhead}
1023 % Starts a `function definition' subsubclause.
1024 % \begin{macrocode}
1025 \newcommand{\afunctionhead}[1]{\ssclause{#1}}
1026 % \end{macrocode}
1027 % \end{macro}
1028 %
1029 % \begin{macro}{\shortnamehead}
1030 % Starts a `Short names of entities' normative annex
1031 % \begin{macrocode}
1032 \newcommand{\shortnamehead}{\normannex{Short names of entities}\label{;ssne}}
1033 % \end{macrocode}
1034 % \end{macro}
1035 %
1036 % \begin{macro}{\objreghead}
1037 % Starts a `Information object registration' normative annex.
1038 % \begin{macrocode}
1039 \newcommand{\objreghead}{\normannex{Information object registration}\label{;sior}}
1040 % \end{macrocode}
1041 % \end{macro}
1042 %
1043 % \begin{macro}{\docidhead}
1044 % Starts a `Document identification' subclause.
1045 % \begin{macrocode}
1046 \newcommand{\docidhead}{\sclause{Document identification}}
1047 % \end{macrocode}
1048 % \end{macro}
1049 %
1050 % \begin{macro}{\schemidhead}
1051 % Starts a `Schema identification' subclause
1052 % \begin{macrocode}
1053 \newcommand{\schemaidhead}{\sclause{Schema identification}}
1054 % \end{macrocode}
1055 % \end{macro}
1056 %
1057 % \begin{macro}{\aschemidhead}
1058 % Starts a `Schema identification' subsubclause
1059 % \begin{macrocode}
1060 \newcommand{\aschemaidhead}[1]{\ssclause{#1 identification}}
1061 % \end{macrocode}
1062 % \end{macro}
1063 %
1064 % \begin{macro}{\expresshead}
1065 % Starts an `EXPRESS listing' informative annex
1066 % \begin{macrocode}
1067 \newcommand{\expresshead}{\infannex{EXPRESS listing}}
1068 % \end{macrocode}
1069 % \end{macro}
1070 %
1071 % \begin{macro}{\listingshead}
1072 % Starts a `Computer interpretable listings' informative annex.
1073 % \changes{v1.4}{2000/01/12}{Added \cs{listingshead}}
1074 % \begin{macrocode}
1075 \newcommand{\listingshead}{\infannex{Computer interpretable listings}\lable{;scil}}
1076 % \end{macrocode}
1077 % \end{macro}
1078 %
1079 % \begin{macro}{\expressghead}
1080 % Starts a `EXPRESS-G diagrams' informative annex
1081 % \begin{macrocode}
1082 \newcommand{\expressghead}{\infannex{EXPRESS-G diagrams}\label{;seg}}
1083 % \end{macrocode}
1084 % \end{macro}
1085 %
1086 % \begin{macro}{\picshead}
1087 % Starts a `Protocol Implementation Conformance Statement (PICS) proforma'
1088 % normative annex
1089 % \begin{macrocode}
1090 \newcommand{\picshead}{\normannex{Protocol Implementation
1091 Conformance Statement (PICS) proforma}\label{;spics}}
1092 % \end{macrocode}
1093 % \end{macro}
1094 %
1095 % \begin{macro}{\techdischead}
1096 % Starts a `Technical discussions' informative annex.
1097 % \begin{macrocode}
1098 \newcommand{\techdischead}{\infannex{Technical discussions}\label{;std}}
1099 % \end{macrocode}
1100 % \end{macro}
1101 %
1102 % \changes{v1.5}{2001/07/16}{Deleted \cs{modelscopehead}}
1103 %
1104 % \begin{macro}{\exampleshead}
1105 % Starts an `Examples' informative annex
1106 % \changes{v1.5}{2001/07/16}{Added \cs{exampleshead}}
1107 % \begin{macrocode}
1108 \newcommand{\exampleshead}{\infannex{Examples}\label{;sex}}
1109
1110 % \end{macrocode}
1111 % \end{macro}
1112 %
1113 % \subsubsection{Miscellaneous boilerplate}
1114 %
1115 % \begin{macro}{\expressgdef}
1116 % Where EXPRESS-G is defined.
1117 % \changes{v1.5}{2001/07/16}{Added \cs{expressgdef}}
1118 % \begin{macrocode}
1119 \newcommand{\expressgdef}{\ExpressG{} is defined in annex~D of ISO 10303-11}
1120
1121 % \end{macrocode}
1122 % \end{macro}
1123 %
1124 % \begin{macro}{\maptableorspec}
1125 % Depending on |\ifmapspec|, prints either `table' or `specification'.
1126 % \changes{v1.5}{2002/01/23}{Added \cs{maptableorspec}}
1127 % \begin{macrocode}
1128 \DeclareRobustCommand{\maptableorspec}{%
1129 \ifmapspec specification\else table\fi}
1130
1131 % \end{macrocode}
1132 % \end{macro}
1133 %
1134 % \begin{macro}{\shortnames}
1135 % Boilerplate for Short Name annex.
1136 % \changes{v1.4}{2000/01/12}{Added \cs{shortnames}}
1137 % \begin{macrocode}
1138 \newcommand{\shortnames}{\input{bpfir1}}
1139 % \end{macrocode}
1140 %
1141 % Here is the text of file \file{bpfir1.tex}.
1142 % \begin{macrocode}
1143 %</step>
1144 %<*bpfir1>
1145 \ProvidesFile{bpfir1.tex}[1997/09/30 short names annex boilerplate]
1146 \typeout{bpfir1.tex [1997/09/30 short names annex boilerplate]}
1147
1148 Table A.1 provides the short names of entities specified in this
1149 part of ISO~10303. Requirements on the use of short names are
1150 found in the implementation methods included in ISO~10303.
1151
1152 %</bpfir1>
1153 %<*step>
1154 % \end{macrocode}
1155 % \end{macro}
1156 %
1157 %
1158 % \begin{macro}{\docreg}
1159 % Boilerplate for document registration annex. Use as: \\
1160 % |\docreg{|\meta{version no}|}|
1161 % \changes{v1}{1995/05/31}{Changed ISO 8824 to ISO/IEC 8824.}
1162 % \begin{macrocode}
1163 \newcommand{\docreg}[1]{%
1164 To provide for unambiguous identification of an information
1165 object in an open system, the object identifier
1166 \begin{center}
1167 \{~iso standard 10303 part(\thespartno) version(#1)~\}
1168 \end{center}
1169 is assigned to this part of ISO~10303. The meaning of this value is defined
1170 in ISO/IEC~8824-1, and is described in ISO~10303-1.
1171 }
1172
1173 % \end{macrocode}
1174 % \end{macro}
1175 %
1176 % \begin{macro}{\schemareg}
1177 % Boilerplate for EXPRESS schema registration. Use as: \\
1178 % |\schemareg{|\meta{version no}|}{|
1179 % \meta{underscored schema}|}{|\meta{schema no}|}{|
1180 % \meta{hyphenated schema}|}{|\meta{schema-name no}|}{|
1181 % \meta{clause/annex no}|}|
1182 % \changes{v1}{1995/05/31}{Changed ISO 8824 to ISO/IEC 8824.}
1183 % \changes{v1.5}{2001/07/16}{Changed definition of \cs{schemareg}}
1184 % \begin{macrocode}
1185 \newcommand{\schemareg}[6]{%
1186 To provide for unambiguous identification of the schema-name % #2
1187 in an open information system, the object identifier
1188 \begin{center}
1189 \{~iso standard 10303 part(\thespartno) version(#1) schema(#3) #4(#5)~\}
1190 \end{center}
1191 is assigned to the \nexp{#2} schema (see #6). The meaning of this
1192 value is defined in ISO/IEC~8824-1, and is described in ISO~10303-1.
1193 }
1194
1195 % \end{macrocode}
1196 % \end{macro}
1197 %
1198 % \changes{v1.5}{2001/07/16}{Deleted \cs{apschemareg}}
1199 %
1200 % \begin{macro}{\expurls}
1201 % The command |\expurls{|\meta{short}|}{|\meta{express}|}| prints
1202 % the boilerplate for an annex of short names and EXPRESS schemas,
1203 % where \meta{short} is the URL of the short names and \meta{express}
1204 % is the URL of the EXPRESS code.
1205 % \changes{v1.4}{2000/01/12}{New \cs{expurls} command}
1206 % \begin{macrocode}
1207 \newcommand{\expurls}[2]{\input{bpfir2}
1208 Short names: \isourl{#1} \\
1209 \Express: \isourl{#2}
1210 \input{bpfir3}}
1211
1212 % \end{macrocode}
1213 % \end{macro}
1214 %
1215 % Here is the text of file \file{bpfir2.tex}
1216 % \changes{v1.3}{1999/02/15}{Changed contents of file bpfir2.tex}
1217 % \changes{v1.5}{2002/01/22}{Changed contents of file bpfir2.tex}
1218 % \begin{macrocode}
1219 %</step>
1220 %<*bpfir2>
1221 \ProvidesFile{bpfir2.tex}[2002/01/22 IR short names and EXPRESS annex initial boilerplate]
1222 \typeout{bpfir2.tex [2002/01/22 IR short names and EXPRESS annex initial boilerplate]}
1223
1224 This annex references a listing of the \Express{} entity data type
1225 names and corresponding short names as specified in this part of ISO~10303.
1226 It also references a listing of each \Express{} schema specified in
1227 this part of ISO~10303, without comments or other explanatory text. These
1228 listings are available in computer-interpretable form
1229 and can be found at the following URLs:
1230
1231 %</bpfir2>
1232 %
1233 % Here is the text of \file{bpfir3.tex}.
1234 % \changes{v1.3}{1999/02/15}{Added file bpfir3.tex}
1235 %<*bpfir3>
1236 \ProvidesFile{bpfir3.tex}[1999/02/15 IR short names and EXPRESS annex ending boilerplate]
1237 \typeout{bpfir3.tex [1999/02/15 IR short names and EXPRESS annex ending boilerplate]}
1238
1239 If there is difficulty accessing these sites contact ISO Central
1240 Secretariat or contact the ISO TC~184/SC4 Secretariat directly at:
1241 \url{[email protected]}.
1242
1243 \begin{anote}The information provided in computer-interpretable form at
1244 the above URLs is informative. The information that is contained
1245 in the body of this part of ISO~10303 is normative.
1246 \end{anote}
1247
1248 %</bpfir3>
1249 %<*step>
1250 % \end{macrocode}
1251 %
1252 % \subsection{Common references}
1253 %
1254 % Many of the STEP parts use the same `standard' references.
1255 % \begin{macro}{\nrefasni}
1256 % \begin{macro}{\nrefparti}
1257 % \begin{macro}{\nrefpartxi}
1258 % \begin{macro}{\nrefpartxii}
1259 % \begin{macro}{\nrefpartxxi}
1260 % \begin{macro}{\nrefpartxxii}
1261 % \begin{macro}{\nrefpartxxxi}
1262 % \begin{macro}{\nrefpartxxxii}
1263 % \begin{macro}{\nrefpartxli}
1264 % \begin{macro}{\nrefpartxlii}
1265 % \begin{macro}{\nrefpartxliii}
1266 % These macros specify some standard normative references.
1267 % \changes{v11}{1997/09/30}{Added extra STEP part normative refs (12, 22, 31, 32)}
1268 % \changes{v1.5}{2002/01/10}{Changed ASN reference}
1269 % \begin{macrocode}
1270 \newcommand{\nrefasni}{\isref{ISO/IEC 8824-1:1998}{%
1271 Information technology ---
1272 Abstract Syntax Notation One (ASN.1):
1273 Specification of basic notation.}}
1274 \newcommand{\nrefparti}{\isref{ISO 10303-1:1994}{%
1275 Industrial automation systems and integration ---
1276 Product data representation and exchange ---
1277 Part 1: Overview and fundamental principles.}}
1278 \newcommand{\nrefpartxi}{\isref{ISO 10303-11:1994}{%
1279 Industrial automation systems and integration ---
1280 Product data representation and exchange ---
1281 Part 11: Description methods:
1282 The EXPRESS language reference manual.}}
1283 \newcommand{\nrefpartxii}{\isref{ISO/TR 10303-12:1997}{%
1284 Industrial automation systems and integration ---
1285 Product data representation and exchange ---
1286 Part 12: Description method:
1287 The EXPRESS-I language reference manual.}}
1288 \newcommand{\nrefpartxxi}{\isref{ISO 10303-21:1994}{%
1289 Industrial automation systems and integration ---
1290 Product data representation and exchange ---
1291 Part 21: Implementation methods:
1292 Clear text encoding of the exchange structure.}}
1293 \newcommand{\nrefpartxxii}{\disref{ISO 10303-22:---}{%
1294 Industrial automation systems and integration ---
1295 Product data representation and exchange ---
1296 Part 22: Implementation method:
1297 Standard data access interface specification.}}
1298 \newcommand{\nrefpartxxxi}{\isref{ISO 10303-31:1994}{%
1299 Industrial automation systems and integration ---
1300 Product data representation and exchange ---
1301 Part 31: Conformance testing methodology and framework:
1302 General concepts.}}
1303 \newcommand{\nrefpartxxxii}{\disref{ISO 10303-32:---}{%
1304 Industrial automation systems and integration ---
1305 Product data representation and exchange ---
1306 Part 32: Conformance testing methodology and framework:
1307 Requirements on testing laboratories and clients.}}
1308 \newcommand{\nrefpartxli}{\isref{ISO 10303-41:1994}{%
1309 Industrial automation systems and integration ---
1310 Product data representation and exchange ---
1311 Part 41: Integrated generic resources:
1312 Fundamentals of product description and support.}}
1313 \newcommand{\nrefpartxlia}{\isref{ISO 10303-41:2001}{%
1314 Industrial automation systems and integration ---
1315 Product data representation and exchange ---
1316 Part 41: Integrated generic resources:
1317 Fundamentals of product description and support.}}
1318 \newcommand{\nrefpartxlii}{\isref{ISO 10303-42:1994}{%
1319 Industrial automation systems and integration ---
1320 Product data representation and exchange ---
1321 Part 42: Integrated generic resources:
1322 Geometric and topological representation.}}
1323 \newcommand{\nrefpartxliia}{\isref{ISO 10303-42:2001}{%
1324 Industrial automation systems and integration ---
1325 Product data representation and exchange ---
1326 Part 42: Integrated generic resources:
1327 Geometric and topological representation.}}
1328 \newcommand{\nrefpartxliii}{\isref{ISO 10303-43:1994}{%
1329 Industrial automation systems and integration ---
1330 Product data representation and exchange ---
1331 Part 43: Integrated generic resources:
1332 Representation structures.}}
1333 \newcommand{\nrefpartxliiia}{\isref{ISO 10303-43:2001}{%
1334 Industrial automation systems and integration ---
1335 Product data representation and exchange ---
1336 Part 43: Integrated generic resources:
1337 Representation structures.}}
1338
1339 % \end{macrocode}
1340 % \end{macro}
1341 % \end{macro}
1342 % \end{macro}
1343 % \end{macro}
1344 % \end{macro}
1345 % \end{macro}
1346 % \end{macro}
1347 % \end{macro}
1348 % \end{macro}
1349 % \end{macro}
1350 % \end{macro}
1351 %
1352 % \begin{macro}{\bibidefo}
1353 % \begin{macro}{\brefidfo}
1354 % \begin{macro}{\bibidefix}
1355 % \begin{macro}{\bibieeeidefix}
1356 % \begin{macro}{\brefidefix}
1357 % These macros specify some bibliographic references and the associated
1358 % commands to cite them in the text.
1359 % \changes{v1.5}{2001/07/16}{Added \cs{bibieeeidefo}}
1360 % \begin{macrocode}
1361 \newcommand{\bibidefo}{\reference{}{%
1362 IDEF0 (ICAM Definition Language 0),}{%
1363 Federal Information Processing Standards Publication 183,
1364 Integration Definition for Information Modeling (IDEF0),
1365 FIPS PUB 183, National Institute for Standards and
1366 Technology, December 1993.}\label{bibidefo}}
1367 \newcommand{\brefidefo}{\bref{bibidefo}}
1368 \newcommand{\bibidefix}{\reference{}{%
1369 IDEF1X (ICAM Definition Language 1 Extended),}{%
1370 Federal Information Processing Standards Publication 184,
1371 Integration Definition for Information Modeling (IDEF1X),
1372 FIPS PUB 184, National Institute for Standards and
1373 Technology, December 1993.}\label{bibidefix}}
1374 \newcommand{\bibieeeidefix}{\reference{IEEE Std 1320.2--1998,}{%
1375 Standard for Conceptual Modeling Language ---
1376 Syntax and Semantics for IDEF1X.}{}\label{bibidefix}}
1377 \newcommand{\brefidefix}{\bref{bibidefix}}
1378
1379 % \end{macrocode}
1380 % \end{macro}
1381 % \end{macro}
1382 % \end{macro}
1383 % \end{macro}
1384 % \end{macro}
1385 %
1386 %
1387 % \subsection{Cover sheet}
1388 %
1389 % STEP documents require a cover sheet for tracking purposes.
1390 %
1391 % First we set up some internal commands depending on the
1392 % type of ISO document being produced. The information is
1393 % typically taken from the options used in the ISO class.
1394 %
1395 % \begin{macro}{\thest@tus}
1396 % |\thest@tus| holds the ISO suffix indicating the type of
1397 % ISO document.
1398 % \changes{v11}{1997/09/30}{Added thest@tus command}
1399 % \changes{v1.5}{2001/07/16}{Added extra status elements}
1400 % \begin{macrocode}
1401 \gdef\thest@tus{}
1402 \ifisstandard
1403 \gdef\thest@tus{}
1404 \fi
1405 \iffdisstandard
1406 \gdef\thest@tus{/FDIS}
1407 \fi
1408 \ifdisstandard
1409 \gdef\thest@tus{/DIS}
1410 \fi
1411 \ifcdstandard
1412 \gdef\thest@tus{/CD}
1413 \fi
1414 \ifwdstandard
1415 \gdef\thest@tus{/WD}
1416 \fi
1417 \iftechrep
1418 \gdef\thest@tus{/TR}
1419 \fi
1420 \iftechspec
1421 \gdef\thest@tus{/TS}
1422 \fi
1423 \ifpaspec
1424 \gdef\thest@tus{/PAS}
1425 \fi
1426 \ifotherdoc
1427 \gdef\thest@tus{}
1428 \fi
1429
1430 % \end{macrocode}
1431 % \end{macro}
1432 %
1433 % The cover sheet is typeset by clever use of the |picture| environment.
1434 % First define some commands that place text at particular places in
1435 % a picture.
1436 % \changes{v1.4}{2000/01/12}{Complete rewrite of STEPcover and internals}
1437 % \changes{v1.4}{2000/01/12}{Deleted all unused STEPcover code}
1438 %
1439 % \begin{macro}{\@wg}
1440 % \begin{macro}{\wg}
1441 % The Working Group number. Use as |\wg{WG the_number}|.
1442 % \changes{v11}{1997/09/30}{Changed position of WG from (44.5,235)}
1443 % \begin{macrocode}
1444 \newcommand{\@wg}{}
1445 \newcommand{\wg}[1]{\def\@wg{\put(47,235){\Large\textbf{#1}}}}
1446 % \end{macrocode}
1447 % \end{macro}
1448 % \end{macro}
1449 %
1450 % \begin{macro}{\@docnumber}
1451 % \begin{macro}{\docnumber}
1452 % Document number. Use as |\docnumber{1234}|.
1453 % \changes{v11}{1997/09/30}{Changed position of docnumber from (77,235)}
1454 % \begin{macrocode}
1455 \newcommand{\@docnumber}{}
1456 \newcommand{\docnumber}[1]{\def\@docnumber{\put(72,235){\Large\textbf{#1}}}}
1457 % \end{macrocode}
1458 % \end{macro}
1459 % \end{macro}
1460 %
1461 % \begin{macro}{\@docdate}
1462 % \begin{macro}{\docdate}
1463 % Document date. Use as |\docdate{yyyy/mm/dd}|.
1464 % \changes{v11}{1997/09/30}{Docdate position changed from (12.5,222.5)}
1465 % \begin{macrocode}
1466 \newcommand{\@docdate}{}
1467 \newcommand{\docdate}[1]{\def\@docdate{\put(148,235){#1}}}
1468 % \end{macrocode}
1469 % \end{macro}
1470 % \end{macro}
1471 %
1472 % \begin{macro}{\@oldwg}
1473 % \begin{macro}{\oldwg}
1474 % Developers of the immediately prior version of the document.
1475 % \changes{v11}{1997/09/30}{oldwg position changed from (110,222.5)}
1476 % \begin{macrocode}
1477 \newcommand{\@oldwg}{}
1478 \newcommand{\oldwg}[1]{\def\@oldwg{\put(58,227){\textbf{#1}}}}
1479 % \end{macrocode}
1480 % \end{macro}
1481 % \end{macro}
1482 %
1483 % \begin{macro}{\@olddocnumber}
1484 % \begin{macro}{\olddocnumber}
1485 % The number of the immediately prior version of the document.
1486 % \changes{v11}{1997/09/30}{olddocnumber position changed from (130,222.5)}
1487 % \changes{v11}{1997/09/30}{oldprojnumber no longer required}
1488 % \begin{macrocode}
1489 \newcommand{\@olddocnumber}{}
1490 \newcommand{\olddocnumber}[1]{\def\@olddocnumber{\put(78,227){\textbf{#1}}}}
1491 % \end{macrocode}
1492 % \end{macro}
1493 % \end{macro}
1494 %
1495 % \begin{macro}{\@abstract}
1496 % \begin{macro}{\abstract}
1497 % Document abstract. Use as |\abstract{|\meta{text}|}|.
1498 % \changes{v11}{1997/09/30}{Command abstract modified}
1499 % \begin{macrocode}
1500 \newcommand{\@abstract}{}
1501 \newcommand{\abstract}[1]{%
1502 \def\@abstract{\put(2,110){\parbox[t]{161mm}{#1}}}}
1503 %%% \def\@abstract{\put(2,120){\parbox[t]{161mm}{#1}}}}
1504 % \end{macrocode}
1505 % \end{macro}
1506 % \end{macro}
1507 %
1508 % \begin{macro}{\@keywords}
1509 % \begin{macro}{\keywords}
1510 % Document keywords. Use as |\keywords{|\meta{text}|}|.
1511 % \changes{v11}{1997/09/30}{Command keywords modified}
1512 % \begin{macrocode}
1513 \newcommand{\@keywords}{}
1514 %%% \newcommand{\keywords}[1]{\def\@keywords{\put(35,77){#1}}}
1515 \newcommand{\keywords}[1]{\def\@keywords{\put(35,87){#1}}}
1516 % \end{macrocode}
1517 % \end{macro}
1518 % \end{macro}
1519 %
1520 % \begin{macro}{\@comread}
1521 % \begin{macro}{\comread}
1522 % Document comments to the reader. Use as |\comread{|\meta{text}|}|.
1523 % \changes{v11}{1997/09/30}{Command comread modified}
1524 % \begin{macrocode}
1525 \newcommand{\@comread}{}
1526 \newcommand{\comread}[1]{%
1527 %%% \def\@comread{\put(2,65){\parbox[t]{161mm}{#1}}}}
1528 \def\@comread{\put(2,75){\parbox[t]{161mm}{#1}}}}
1529
1530 % \end{macrocode}
1531 % \end{macro}
1532 % \end{macro}
1533 %
1534 % \begin{macro}{\@owner}
1535 % \begin{macro}{\owner}
1536 % \begin{macro}{\@address}
1537 % \begin{macro}{\address}
1538 % \begin{macro}{\@telephone}
1539 % \begin{macro}{\telephone}
1540 % \begin{macro}{\@fax}
1541 % \begin{macro}{\fax}
1542 % \begin{macro}{\@email}
1543 % \begin{macro}{\email}
1544 % Contact information for the document's project leader. Each of
1545 % these commands takes a single text argument
1546 % (e.g., |\address{|\meta{text}|}|).
1547 %
1548 % \changes{v11}{1997/09/30}{Change position of owner from (32.5,77.5)}
1549 % \changes{v11}{1997/09/30}{Change position of address from (48,75)}
1550 % \changes{v11}{1997/09/30}{Change position of telephone from (35,47.5)}
1551 % \changes{v11}{1997/09/30}{Added command fax}
1552 % \changes{v11}{1997/09/30}{Change position of email from (17.5,42.5)}
1553 % \changes{v1.5}{2001/07/16}{Change position of Email and Fax}
1554 % \begin{macrocode}
1555 \newcommand{\@owner}{}
1556 \newcommand{\owner}[1]{\def\@owner{\put(35,45){#1}}}
1557 \newcommand{\@address}{}
1558 \newcommand{\address}[1]{\def\@address{\put(22,40){\parbox[t]{59mm}{#1}}}}
1559 \newcommand{\@telephone}{}
1560 \newcommand{\telephone}[1]{\def\@telephone{\put(25,11){#1}}}
1561 \newcommand{\@fax}{}
1562 %%%\newcommand{\fax}[1]{\def\@fax{\put(30,6){#1}}}
1563 \newcommand{\fax}[1]{\def\@fax{\put(25,6){#1}}}
1564 \newcommand{\@email}{}
1565 %%%\newcommand{\email}[1]{\def\@email{\put(35,1){#1}}}
1566 \newcommand{\email}[1]{\def\@email{\put(22,1){#1}}}
1567
1568 % \end{macrocode}
1569 % \end{macro}
1570 % \end{macro}
1571 % \end{macro}
1572 % \end{macro}
1573 % \end{macro}
1574 % \end{macro}
1575 % \end{macro}
1576 % \end{macro}
1577 % \end{macro}
1578 % \end{macro}
1579 %
1580 % \begin{macro}{\@altowner}
1581 % \begin{macro}{\altowner}
1582 % \begin{macro}{\@altaddress}
1583 % \begin{macro}{\altaddress}
1584 % \begin{macro}{\@alttelephone}
1585 % \begin{macro}{\alttelephone}
1586 % \begin{macro}{\@altfax}
1587 % \begin{macro}{\altfax}
1588 % \begin{macro}{\@altemail}
1589 % \begin{macro}{\altemail}
1590 % Contact information for the document's editor.
1591 % \changes{v11}{1997/09/30}{Change position of altowner from (105,77.5)}
1592 % \changes{v11}{1997/09/30}{Change position of altaddress from (128.5,75)}
1593 % \changes{v11}{1997/09/30}{Change position of alttelephone from (117.5,47.5)}
1594 % \changes{v11}{1997/09/30}{Added command altfax}
1595 % \changes{v11}{1997/09/30}{Change position of altemail from (100,42.5)}
1596 % \changes{v1.5}{2001/07/16}{Changed position of altEmail and altFax}
1597 % \begin{macrocode}
1598 \newcommand{\@altowner}{}
1599 \newcommand{\altowner}[1]{\def\@altowner{\put(117.5,45){#1}}}
1600 \newcommand{\@altaddress}{}
1601 \newcommand{\altaddress}[1]{\def\@altaddress{\put(104.5,40){\parbox[t]{59mm}{#1}}}}
1602 \newcommand{\@alttelephone}{}
1603 \newcommand{\alttelephone}[1]{\def\@alttelephone{\put(107.5,11){#1}}}
1604 \newcommand{\@altfax}{}
1605 %%%\newcommand{\altfax}[1]{\def\@altfax{\put(112.5,6){#1}}}
1606 \newcommand{\altfax}[1]{\def\@altfax{\put(107.5,6){#1}}}
1607 \newcommand{\@altemail}{}
1608 %%%\newcommand{\altemail}[1]{\def\@altemail{\put(117.5,1){#1}}}
1609 \newcommand{\altemail}[1]{\def\@altemail{\put(104.5,1){#1}}}
1610
1611 % \end{macrocode}
1612 % \end{macro}
1613 % \end{macro}
1614 % \end{macro}
1615 % \end{macro}
1616 % \end{macro}
1617 % \end{macro}
1618 % \end{macro}
1619 % \end{macro}
1620 % \end{macro}
1621 % \end{macro}
1622 %
1623 % \begin{macro}{\STEPcover}
1624 % The cover sheet is implemented by clever use of the |picture| environment
1625 % and by using a multitude of internal commands.
1626 %
1627 % Use as |\STEPcover{|\meta{commands}|}|.
1628 % \changes{v11}{1997/09/30}{Complete rewrite of STEPcover and its internals}
1629 % \changes{v1.5}{2001/07/16}{Revision 8 of \cs{STEPcover} layout}
1630 % \changes{v1.5}{2001/07/16}{Added copyright page to \cs{STEPcover}}
1631 % \begin{macrocode}
1632 \newcommand{\STEPcover}[1]{%
1633 % \end{macrocode}
1634 % Make sure that the internal commands are picked up.
1635 % \begin{macrocode}
1636 #1
1637 % \end{macrocode}
1638 % and call the routine to draw the picture.
1639 % \begin{macrocode}
1640 \drawcoversheet
1641 % \end{macrocode}
1642 % Put a copyright notice at the bottom of the next page.
1643 % \begin{macrocode}
1644 \clearpage
1645 \thispagestyle{startpage}
1646 \mbox{}
1647 \ifc@pyright\@copyrighttext\fi
1648 \newpage
1649 }
1650
1651 % \end{macrocode}
1652 % \end{macro}
1653 %
1654 % \begin{macro}{\drawcoversheet}
1655 % This draws the STEP cover sheet.
1656 % \changes{v1.4}{2000/01/12}{Added \cs{drawcoversheet} command}
1657 % \begin{macrocode}
1658 \newcommand{\drawcoversheet}{%
1659 % \end{macrocode}
1660 %
1661 % Make sure we have an empty page style.
1662 % \begin{macrocode}
1663 \protect\thispagestyle{nohead}
1664 % \end{macrocode}
1665 % Start the picture. The actual size of the picture is (165,240)
1666 % but need to fool \LaTeX{} into thinking it is smaller so it
1667 % fits onto a page without complaints. The origin also needs
1668 % adjustment to centre it in a reasonable fashion.
1669 % \changes{v11}{1997/09/30}{Complete change of the picture layout}
1670 % \begin{macrocode}
1671 \setlength{\unitlength}{1mm}
1672 \begin{picture}(165,200)(0,40) %% actual size is (165,240)
1673 \thicklines
1674 % \end{macrocode}
1675 %
1676 %%%%% Revision notice for the cover sheet layout.
1677 % \begin{macrocode}
1678 \put(165,-1){\makebox(0,0)[tr]{\tiny revision 8, 1/02 (PRW)}}
1679 % \end{macrocode}
1680 %
1681 %%%%% Project leader information. (Box at y=0, height 50)
1682 % \begin{macrocode}
1683 \put(0,0){\framebox(82.5,50){}}
1684 \put(2,1){\bf E-mail:}
1685 \put(2,6){\bf Facsimile:}
1686 \put(2,11){\bf Telephone:}
1687 \put(2,40){\bf Address:}
1688 \put(2,45){\bf Project Leader:}
1689 % \end{macrocode}
1690 %
1691 %%%%%%% Document editor information.
1692 % \begin{macrocode}
1693 \put(82.5,0){\framebox(82.5,50){}}
1694 \put(84.5,1){\bf E-mail:}
1695 \put(84.5,6){\bf Facsimile:}
1696 \put(84.5,11){\bf Telephone:}
1697 \put(84.5,40){\bf Address:}
1698 \put(84.5,45){\bf Project Editor:}
1699 % \end{macrocode}
1700 %
1701 %%%%%%% Comments to reader box. (Box at y=50, height 35, total height 85)
1702 % \begin{macrocode}
1703 %%% \put(0,50){\framebox(165,25){}}
1704 %%% \put(2,70){\large\bf COMMENTS TO READER:}
1705 \put(0,50){\framebox(165,35){}}
1706 \put(2,80){\large\bf COMMENTS TO READER:}
1707 % \end{macrocode}
1708 %
1709 %%%%%% Draw abstract and keyword headings. (Box at y=85, height 35, total 120)
1710 % \begin{macrocode}
1711 \put(0,85){\framebox(165,35){}}
1712 \put(2,87){\large\bf KEYWORDS:}
1713 \put(2,115){\large\bf ABSTRACT:}
1714 %%\put(0,85){\framebox(165,45){}}
1715 %%\put(2,87){\large\bf KEYWORDS:}
1716 %%\put(2,125){\large\bf ABSTRACT:}
1717 % \end{macrocode}
1718 %
1719 %%%%% Do the copyright element. (Box at y=120, height 80, total 200)
1720 % \begin{macrocode}
1721 \put(0,120){\framebox(165,80)[t]{
1722 %%%\put(0,130){\framebox(165,70)[t]{
1723 \ifc@pyrightopt
1724 \begin{minipage}{161mm}
1725 \ifisstandard
1726 \input{bpfs2} %% unknown at present
1727 \fi
1728 \iffdisstandard
1729 \input{bpfs2}
1730 \fi
1731 \ifdisstandard
1732 \input{bpfs2}
1733 \fi
1734 \ifcdstandard
1735 \input{bpfs3}
1736 \fi
1737 \ifwdstandard
1738 \input{bpfs3}
1739 \fi
1740 \iftechrep
1741 \input{bpfs3} %% unknown at present
1742 \fi
1743 \end{minipage}
1744 \else
1745 %%% \put(2,195){{\large\bf COPYRIGHT NOTICE:}}
1746 {\vspace*{\baselineskip}
1747 \textbf{\large\space COPYRIGHT NOTICE}\hfill\vspace*{\fill}}
1748 \fi}}
1749
1750 % \end{macrocode}
1751 %
1752 %%%%% Draw the STEP title. (y=215 and 210)
1753 % \begin{macrocode}
1754 \put(0,215){%
1755 \ifnum\value{b@cyc} < 2
1756 {\bf ISO\thest@tus\ 10303-\thespartno}
1757 \else
1758 {\bf ISO\thest@tus\ 10303-\thespartno.\theb@cyc}
1759 \fi}
1760 \put(0,210){\begin{minipage}[t]{165mm}
1761 {\bf \st@pn@me: \Theseries: \thed@ctitle}
1762 \end{minipage}}
1763 % \end{macrocode}
1764 %
1765 %%%%% Identify the slots for the superseded document information.
1766 % \begin{macrocode}
1767 \put(0,227){\bf Supersedes ISO TC 184/SC4/} % (y=227)
1768 \put(67,226){\line(1,0){5}}
1769 \put(73,227){\bf N}
1770 \put(78,226){\line(1,0){8}}
1771 % \end{macrocode}
1772 %
1773 %
1774 %%%%% Draw the heading block
1775 % \begin{macrocode}
1776 \put(0,235){\Large\bf ISO TC 184/SC4/} % (y=235)
1777 \put(58,234){\line(1,0){7}}
1778 \put(67,235){\Large\bf N}
1779 \put(72,234){\line(1,0){11}}
1780 % \end{macrocode}
1781 % Identify the date slot.
1782 % \begin{macrocode}
1783 \put(135,235){\bf Date:}
1784 % \end{macrocode}
1785 %
1786 % Finish off the picture. Note that this is where all the specific
1787 % drawing commands are called.
1788 % \begin{macrocode}
1789 \@wg \@docnumber \@docdate \@oldwg \@olddocnumber
1790 \@abstract \@keywords \@comread
1791 \@owner \@address \@telephone \@fax \@email
1792 \@altowner \@altaddress \@alttelephone \@altfax \@altemail
1793 \end{picture}
1794 \setlength{\unitlength}{1pt}
1795 % \end{macrocode}
1796 % Force printing of cover sheet, and remove the STEPcover internal
1797 % commands as they are no longer needed.
1798 % \begin{macrocode}
1799 \clearpage
1800 \undef@covercmds
1801 % \end{macrocode}
1802 % At last, this is the end of the definition of the |\drawcoversheet| command.
1803 % \begin{macrocode}
1804 }
1805
1806 % \end{macrocode}
1807 % \end{macro}
1808 %
1809 % \begin{macro}{\undef@covercmds}
1810 % Make the |\STEPcover| internal commands undefined to make space for
1811 % later macros, if necessary.
1812 % \changes{v1.4}{2000/01/12}{Added \cs{undef@covercmds} command}
1813 % \begin{macrocode}
1814 \newcommand{\undef@covercmds}{%
1815 \let\@wg\relax \let\wg\relax
1816 \let\@docnumber\relax \let\docnumber\relax
1817 \let\@docdate\relax \let\docdate\relax
1818 \let\@oldwg\relax \let\oldwg\relax
1819 \let\@olddocnumber\relax \let\olddocnumber\relax
1820 \let\@abstract\relax \let\abstract\relax
1821 \let\@keywords\relax \let\keywords\relax
1822 \let\@comread\relax \let\comread\relax
1823 \let\@owner\relax \let\owner\relax
1824 \let\@address\relax \let\address\relax
1825 \let\@telephone\relax \let\telephone\relax
1826 \let\@fax\relax \let\fax\relax
1827 \let\@email\relax \let\email\relax
1828 \let\@altowner\relax \let\altowner\relax
1829 \let\@altaddress\relax \let\altaddress\relax
1830 \let\@alttelephone\relax \let\alttelephone\relax
1831 \let\@altfax\relax \let\altfax\relax
1832 \let\@altemail\relax \let\altemail\relax
1833 }
1834
1835 % \end{macrocode}
1836 % \end{macro}
1837 %
1838 %
1839 % Here is the text of the file \file{bpfs2.tex}.
1840 % \changes{v1.3}{1999/02/15}{Changed: Prosecutors may be violated. to: Violators may be prosecuted}
1841 % \changes{v1.5}{2001/07/16}{Deleted files bpfs3, bpfs4 and bpfsX.tex}
1842 % \changes{v1.5}{2002/01/10}{Changed file bpfs2.tex}
1843 % \begin{macrocode}
1844 %</step>
1845 %<*bpfs2>
1846 \ProvidesFile{bpfs2.tex}[2002/01/10 STEP cover DIS+ copyright boilerplate]
1847 \typeout{bpfs2.tex [2002/01/10 STEP cover DIS+ copyright boilerplate]}
1848
1849 \vspace*{\baselineskip}
1850 \textbf{\large COPYRIGHT NOTICE}
1851
1852 \begin{small}
1853 This ISO document is
1854 \iffdisstandard
1855 a Final Draft
1856 \else
1857 \ifdisstandard
1858 a Draft
1859 \else
1860 an
1861 \fi
1862 \fi
1863 International
1864 Standard and is copyright protected by ISO. Except
1865 as permitted under the applicable laws of the user's
1866 country, neither this ISO draft nor any extract from
1867 it may be reproduced, stored in a retrieval system or
1868 transmitted in any form or by any means, electronic,
1869 photocopying, recording, or otherwise, without prior
1870 written permission being secured.
1871
1872 Requests for permission to reproduce should be addressed
1873 to ISO at the address below or ISO's member body in the
1874 country of the requester:
1875 \begin{center}
1876 ISO copyright office \\
1877 Case postale 56. CH-1211 Geneva 20 \\
1878 Tel. +41 22 749 01 11 \\
1879 Fax +41 22 734 01 79 \\
1880 E-mail \texttt{[email protected]}
1881 \end{center}
1882 Reproduction for sales purposes for any of the above-mentioned
1883 documents may be subject to royalty payments or a licensing
1884 agreement.
1885
1886 Violators may be prosecuted.
1887
1888 \end{small}
1889
1890 %</bpfs2>
1891 %<*step>
1892 % \end{macrocode}
1893 %
1894 % \changes{v1.5}{2002/01/10}{Added file bpfs3.tex}
1895 % \begin{macrocode}
1896 %</step>
1897 %<*bpfs3>
1898 \ProvidesFile{bpfs3.tex}[2002/01/10 STEP cover WD/CD copyright boilerplate]
1899 \typeout{bpfs3.tex [2002/01/10 STEP cover WD/CD copyright boilerplate]}
1900
1901 \vspace*{\baselineskip}
1902 \textbf{\large COPYRIGHT NOTICE}
1903
1904 \begin{small}
1905 This ISO document is a working draft or Committee Draft
1906 and is copyright protected by ISO.
1907 While the reproduction of working drafts or Committee Drafts
1908 in any form for use by Participants in the ISO standards
1909 development process is permitted without prior permission
1910 from ISO, neither this document nor any extract from
1911 it may be reproduced, stored or
1912 transmitted in any form for any other purpose without prior
1913 written permission from ISO.
1914
1915 Requests for permission to reproduce this document for the
1916 purposes of selling it should be addressed as shown below
1917 (via the ISO TC 184/SC4 Secretariat's member body)
1918 or to ISO's member body in the
1919 country of the requester:
1920 \begin{center}
1921 Copyright Manager \\
1922 ANSI \\
1923 11 West 42nd Street \\
1924 New York, New York 10036 \\
1925 USA \\
1926 phone: +1--212--642--4900 \\
1927 fax: +1--212--398--0023
1928 \end{center}
1929 Reproduction for sales purposes may be subject to royalty payments
1930 or a licensing agreement.
1931
1932 Violators may be prosecuted.
1933
1934 \end{small}
1935
1936 %</bpfs3>
1937 %<*step>
1938 % \end{macrocode}
1939 %
1940 % \begin{macro}{\draftctr}
1941 % Some boilerplate for `Comments to Reader'.
1942 % \begin{macrocode}
1943 \newcommand{\draftctr}{Recipients of this draft are invited to submit,
1944 with their comments, notification of any relevant patent rights of
1945 which they are aware and to provide supporting documentation. }
1946
1947 % \end{macrocode}
1948 % \end{macro}
1949 %
1950 %
1951 % The end of this package.
1952 % \begin{macrocode}
1953 %</step>
1954 % \end{macrocode}
1955 %
1956 % \section{The Integrated Resources package}
1957 %
1958 % This section defines the content of the package designed for use
1959 % in documenting STEP Integrated Resources.
1960 % \begin{macrocode}
1961 %<*ir>
1962 % \end{macrocode}
1963 %
1964 % \begin{macro}{\anirtrue}
1965 % We are meant to be processing an IR.
1966 % \begin{macrocode}
1967 \anirtrue
1968
1969 % \end{macrocode}
1970 % \end{macro}
1971 %
1972 % \subsection{Boilerplate}
1973 %
1974 % This section defines the commands used to print boilerplate text.
1975 %
1976 %
1977 %
1978 % \begin{macro}{\irexpressg}
1979 % Boilerplate for IR EXPRESS-G annex. Use as: \\
1980 % |\irexpressg|
1981 % \changes{v1.4}{2000/01/12}{Modified \cs{irexpressg}}
1982 % \changes{v1.5}{2001/07/16}{Deleted argument from \cs{irexpressg}}
1983 % \begin{macrocode}
1984 \newcommand{\irexpressg}{%
1985 The diagrams in this annex correspond to the \Express{} schemas
1986 specified in this part of ISO~10303. The
1987 diagrams use the \ExpressG{} graphical notation for the
1988 \Express{} language. \expressgdef.
1989 }
1990
1991 % \end{macrocode}
1992 % \end{macro}
1993 %
1994 %
1995 % The end of this package.
1996 % \begin{macrocode}
1997 %</ir>
1998 % \end{macrocode}
1999 %
2000 %
2001 % \section{The Application Protocol package}
2002 %
2003 % This section defines the content of the package designed for use
2004 % in documenting STEP Application Protocols.
2005 % \begin{macrocode}
2006 %<*ap>
2007 % \end{macrocode}
2008 %
2009 % \begin{macro}{\anirfalse}
2010 % If we are processing an AP then we are not processing an IR.
2011 % \begin{macrocode}
2012 \anirfalse
2013 % \end{macrocode}
2014 % \end{macro}
2015 %
2016 % In general, the ToC should contain subclauses.
2017 % \begin{macrocode}
2018 \settocdepth{sclause}
2019
2020 % \end{macrocode}
2021 %
2022 % \subsection{Preamble commands}
2023 %
2024 %
2025 %
2026 % These commands, if used, should be placed in the document preamble.
2027 %
2028 % \begin{macro}{\aptitle}
2029 % \begin{macro}{\theap}
2030 % |\aptitle{|\meta{title of AP}|}| --- the AP title to be used in
2031 % running text.
2032 % \begin{macrocode}
2033 \gdef\theap{}
2034 \newcommand{\aptitle}[1]{\gdef\theap{#1}}
2035 % \end{macrocode}
2036 % \end{macro}
2037 % \end{macro}
2038 %
2039 % \begin{macro}{\ifaicinap}
2040 % Set up for use of AIC's in the AP. Initialize to no AIC used.
2041 % \begin{macrocode}
2042 \newif\ifaicinap
2043 \aicinapfalse
2044 % \end{macrocode}
2045 % \end{macro}
2046 %
2047 %
2048 % \begin{macro}{\ifmaptemplate}
2049 % Set up for use Mapping Template (TRUE).
2050 % Initialise to FALSE (i.e., requires no change to an existing AP).
2051 % \changes{v1.5}{2001/07/16}{Added \cs{ifmaptemplate}}
2052 % \begin{macrocode}
2053 \newif\ifmaptemplate
2054 \maptemplatefalse
2055 % \end{macrocode}
2056 % \end{macro}
2057 %
2058 % \begin{macro}{\ifidefix}
2059 % Set up for using IDEF1X as the ARM graphical form (TRUE).
2060 % \changes{v1.5}{2001/07/16}{Added \cs{ifidefix}}
2061 % \begin{macrocode}
2062 \newif\ifidefix
2063 \idefixfalse
2064
2065 % \end{macrocode}
2066 % \end{macro}
2067 %
2068 % \subsection{Heading commands}
2069 %
2070 % The commands in this section provide for the `standard' clause
2071 % headings in an AP.
2072 %
2073 % \begin{macro}{\inforeqhead}
2074 % Starts a `Information requirements' clause. N200 says that subsubclauses
2075 % of this should be in the ToC.
2076 % \changes{v1.5}{2001/07/16}{Added \cs{settocdepth} to \cs{inforeqhead}}
2077 % \begin{macrocode}
2078 \newcommand{\inforeqhead}{%
2079 \settocdepth{ssclause}
2080 \clause{Information requirements}\label{;sireq}}
2081 % \end{macrocode}
2082 % \end{macro}
2083 %
2084 % \begin{macro}{\uofhead}
2085 % Starts a `Units of functionality' subclause
2086 % \begin{macrocode}
2087 \newcommand{\uofhead}{%
2088 \sclause{Units of functionality}\label{;suof}}
2089 % \end{macrocode}
2090 % \end{macro}
2091 %
2092 % \begin{macro}{\auofhead}
2093 % Starts a subsubclause for a UoF
2094 % \begin{macrocode}
2095 \newcommand{\auofhead}[1]{\ssclause{#1}}
2096 % \end{macrocode}
2097 % \end{macro}
2098 %
2099 % \begin{macro}{\applobjhead}
2100 % Starts a `Application objects' subclause. N200 says this should
2101 % revert to ToC subclause listing.
2102 % \changes{v1.5}{2001/07/16}{Added \cs{settocdepth} to \cs{applobjhead}}
2103 % \begin{macrocode}
2104 \newcommand{\applobjhead}{%
2105 \settocdepth{sclause}
2106 \sclause{Application objects}\label{;sao}}
2107 % \end{macrocode}
2108 % \end{macro}
2109 %
2110 % \begin{macro}{\applasserthead}
2111 % Starts a `Application assertions' subclause
2112 % \begin{macrocode}
2113 \newcommand{\applasserthead}{%
2114 \sclause{Application assertions}\label{;saa}}
2115 % \end{macrocode}
2116 % \end{macro}
2117 %
2118 % \begin{macro}{\aimhead}
2119 % Starts a `Application interpreted model' clause
2120 % \begin{macrocode}
2121 \newcommand{\aimhead}{%
2122 \clause{Application interpreted model}\label{;saim}}
2123 % \end{macrocode}
2124 % \end{macro}
2125 %
2126 % \begin{macro}{\mappinghead}
2127 % Starts a `Mapping table' or `Mapping specification' subclause
2128 % \changes{v1.5}{2001/07/16}{Changed \cs{maptablehead} to \cs{mappinghead}}
2129 % \begin{macrocode}
2130 \newcommand{\mappinghead}{%
2131 \sclause{Mapping \maptableorspec}\label{;smap}}
2132 % \end{macrocode}
2133 % \end{macro}
2134 %
2135 % \begin{macro}{\templateshead}
2136 % Starts a `Mapping templates' subsubclause.
2137 % \changes{v1.5}{2001/07/16}{Added \cs{templateshead}}
2138 % \begin{macrocode}
2139 \newcommand{\templateshead}{%
2140 \ssclause{Mapping templates}\label{;stemps}}
2141 % \end{macrocode}
2142 % \end{macro}
2143 %
2144 % \begin{macro}{\mapuofhead}
2145 % Starts a UoF mapping subsubclause.
2146 % \changes{v1.5}{2001/07/16}{Added \cs{mapuofhead}}
2147 % \begin{macrocode}
2148 \newcommand{\mapuofhead}[1]{\ssclause{#1}}
2149 % \end{macrocode}
2150 % \end{macro}
2151 %
2152 % \begin{macro}{\mapobjecthead}
2153 % Starts an application object mapping subsubsubclause.
2154 % \changes{v1.5}{2001/07/16}{Added \cs{mapobjecthead}}
2155 % \begin{macrocode}
2156 \newcommand{\mapobjecthead}[1]{\sssclause{#1}}
2157 % \end{macrocode}
2158 % \end{macro}
2159 %
2160 % \begin{macro}{\mapattribhead}
2161 % Starts an application object attribute mapping subsubsubsubclause.
2162 % \changes{v1.5}{2001/07/16}{Added \cs{mapattribhead}}
2163 % \begin{macrocode}
2164 \newcommand{\mapattribhead}[1]{\ssssclause{#1}}
2165 % \end{macrocode}
2166 % \end{macro}
2167 %
2168 % \begin{macro}{\aimshortexphead}
2169 % Starts a `AIM EXPRESS short listing' subclause
2170 % \begin{macrocode}
2171 \newcommand{\aimshortexphead}{%
2172 \sclause{AIM EXPRESS short listing}\label{;saesl}}
2173 % \end{macrocode}
2174 % \end{macro}
2175 %
2176 % \begin{macro}{\confreqhead}
2177 % Starts a `Conformance requirements' clause
2178 % \begin{macrocode}
2179 \newcommand{\confreqhead}{%
2180 \clause{Conformance requirements}\label{;scr}}
2181 % \end{macrocode}
2182 % \end{macro}
2183 %
2184 % \begin{macro}{\aimlongexphead}
2185 % Starts a `AIM EXPRESS expanded listing' normative annex
2186 % \begin{macrocode}
2187 \newcommand{\aimlongexphead}{%
2188 \normannex{AIM EXPRESS expanded listing}\label{;saeel}}
2189 % \end{macrocode}
2190 % \end{macro}
2191 %
2192 % \begin{macro}{\aimshortnameshead}
2193 % Starts a `AIM short names' normative annex
2194 % \begin{macrocode}
2195 \newcommand{\aimshortnameshead}{%
2196 \normannex{AIM short names}\label{;sasn}}
2197 % \end{macrocode}
2198 % \end{macro}
2199 %
2200 % \begin{macro}{\impreqhead}
2201 % Starts a `Implementation method specific requirements' normative annex
2202 % \begin{macrocode}
2203 \newcommand{\impreqhead}{%
2204 \normannex{Implementation method specific requirements}\label{;simreq}}
2205 % \end{macrocode}
2206 % \end{macro}
2207 %
2208 % \begin{macro}{\aamhead}
2209 % Starts a `Application activity model' informative annex
2210 % \begin{macrocode}
2211 \newcommand{\aamhead}{%
2212 \infannex{Application activity model}\label{;saam}}
2213 % \end{macrocode}
2214 % \end{macro}
2215 %
2216 % \begin{macro}{\aamdefhead}
2217 % Starts a `Application activity model definitions and abbreviations'
2218 % subclause. N200 says this should not be in the ToC.
2219 % \changes{v1.5}{2001/07/16}{Removed \cs{aamdefhead} from the ToC}
2220 % \begin{macrocode}
2221 \newcommand{\aamdefhead}{%
2222 \settocdepth{clause}
2223 \sclause{Application activity model definitions and abbreviations}}
2224 % \end{macrocode}
2225 % \end{macro}
2226 %
2227 % \begin{macro}{\aamfighead}
2228 % Starts a `Application activity model diagrams' subclause
2229 % N200 says this should not be in the ToC.
2230 % \changes{v1.5}{2001/07/16}{Removed \cs{aamfighead} from the ToC}
2231 % \begin{macrocode}
2232 \newcommand{\aamfighead}{%
2233 \settocdepth{clause}
2234 \sclause{Application activity model diagrams}}
2235 % \end{macrocode}
2236 % \end{macro}
2237 %
2238 % \begin{macro}{\armhead}
2239 % Starts a `Application reference model' informative annex
2240 % \changes{v1.5}{2001/07/16}{added \cs{settocdepth} to \cs{armhead}}
2241 % \begin{macrocode}
2242 \newcommand{\armhead}{%
2243 \settocdepth{sclause}
2244 \infannex{Application reference model}\label{;sarm}}
2245 % \end{macrocode}
2246 % \end{macro}
2247 %
2248 % \begin{macro}{\aimexpressghead}
2249 % Starts a `AIM EXPRESS-G' informative annex
2250 % \begin{macrocode}
2251 \newcommand{\aimexpressghead}{%
2252 \infannex{AIM EXPRESS-G}\label{;saeg}}
2253 % \end{macrocode}
2254 % \end{macro}
2255 %
2256 % \begin{macro}{\aimexpresshead}
2257 % Starts a `AIM EXPRESS listing' informative annex
2258 % \begin{macrocode}
2259 \newcommand{\aimexpresshead}{%
2260 \infannex{AIM EXPRESS listing}}
2261 % \end{macrocode}
2262 % \end{macro}
2263 %
2264 % \begin{macro}{\apusagehead}
2265 % Starts a `Application protocol usage guide' informative annex
2266 % \begin{macrocode}
2267 \newcommand{\apusagehead}{%
2268 \infannex{Application protocol usage guide}\label{;sapug}}
2269
2270 % \end{macrocode}
2271 % \end{macro}
2272 %
2273 % \subsubsection{Template headings}
2274 %
2275 % \begin{macro}{\signature}
2276 % The `mapping signature' heading.
2277 % \begin{macrocode}
2278 \newcommand{\signature}{\ehe@d*{\underline{Mapping signature}:}}
2279 % \end{macrocode}
2280 % \end{macro}
2281 %
2282 % \begin{macro}{\parameters}
2283 % The `parameter definitions' heading.
2284 % \begin{macrocode}
2285 \newcommand{\parameters}{\ehe@d*{\underline{Parameter definitions}:}}
2286 % \end{macrocode}
2287 % \end{macro}
2288 %
2289 % \begin{macro}{\body}
2290 % The `template body' heading.
2291 % \begin{macrocode}
2292 \newcommand{\body}{\ehe@d*{\underline{Template body}:}}
2293
2294 % \end{macrocode}
2295 % \end{macro}
2296 %
2297 %
2298 %
2299 % \subsection{Boilerplate printing}
2300 %
2301 % \begin{macro}{\apextraintro}
2302 % Print boilerplate for end of AP introduction clause.
2303 % \changes{v1.5}{2001/07/16}{Changed \cs{apintroend} to \cs{apextraintro}}
2304 % \begin{macrocode}
2305 \newcommand{\apextraintro}{\input{apendint}}
2306 % \end{macrocode}
2307 %
2308 % Here is the text of \file{apendint.tex}.
2309 % \begin{macrocode}
2310 %</ap>
2311 %<*apf1>
2312 \ProvidesFile{apendint.tex}[1996/05/31 AP end intro boilerplate]
2313 \typeout{apendint.tex [1996/05/31 AP end intro boilerplate]}
2314
2315 Application protocols provide the basis for developing
2316 implementations of ISO~10303 and abstract test suites for
2317 the conformance testing of AP implementations.
2318
2319 Clause~\ref{;i1} defines the scope of the application protocol
2320 and summarizes the functionality and data covered by the AP.
2321 Clause~\ref{;i3} lists the words defined in this part of ISO~10303 and
2322 gives pointers to words defined elsewhere.
2323 An application activity model that is the basis for the definition
2324 of the scope is provided in \aref{;saam}. The information requirements
2325 of the application are specified in \cref{;sireq} using terminology
2326 appropriate to the application. A graphical representation of the
2327 information requirements, referred to as the application reference
2328 model, is given in \aref{;sarm}.
2329
2330 Resource constructs are interpreted to meet the information
2331 requirements. This interpretation produces the application
2332 interpreted model (AIM). This interpretation, given in~\ref{;smap}, shows
2333 the correspondence between the information requirements and the
2334 AIM. The short listing of the AIM specifies the interface to the
2335 integrated resources and is given in~\ref{;saesl}. Note that the definitions
2336 and \Express{} provided in the integrated resources for constructs
2337 used in the AIM may include select list items and subtypes which are
2338 not imported into the AIM. The expanded listing given in \aref{;saeel}
2339 contains the complete \Express{} for the AIM without annotation. A
2340 graphical representation of the AIM is given in \aref{;saeg}. Additional
2341 requirements for specific implementation methods are given in
2342 \aref{;simreq}.
2343
2344 %</apf1>
2345 %<*ap>
2346 % \end{macrocode}
2347 % \end{macro}
2348 %
2349 % \begin{macro}{\apscope}
2350 % Print boilerplate for start of AP scope clause. \\
2351 % |\apscope{|\meta{application purpose and context}|}|
2352 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap1.tex}
2353 % \begin{macrocode}
2354 \newcommand{\apscope}[1]{%
2355 This part of ISO 10303 specifies the use of the integrated
2356 resources necessary for the scope and information requirements
2357 for #1
2358
2359 \input{bpfap1}
2360
2361 }
2362 % \end{macrocode}
2363 %
2364 % Here is the text for file \file{bpfap1.tex}
2365 % \changes{v1.5}{2001/07/16}{Minor word change in file bpfap1.tex}
2366 % \begin{macrocode}
2367 %</ap>
2368 %<*bpfap1>
2369 \ProvidesFile{bpfap1.tex}[2001/07/16 AP start scope clause boilerplate]
2370 \typeout{bpfap1.tex [2001/07/16 AP start scope clause boilerplate]}
2371
2372 \begin{anote}The application activity model in \aref{;saam} provides a
2373 graphical representation of the processes and
2374 information flows that are the basis for the definition
2375 of the scope of this part of ISO~10303.\end{anote}
2376
2377 %</bpfap1>
2378 %<*ap>
2379 % \end{macrocode}
2380 % \end{macro}
2381 %
2382 % \begin{macro}{\apinforeq}
2383 % Print boilerplate for start of AP clause on
2384 % information requirements. \\
2385 % |\apinforeq{|\meta{AP purpose}|}|
2386 % \changes{v1}{1995/05/31}{Added AIC phrase (twice).}
2387 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap2.tex}
2388 % \begin{macrocode}
2389 \newcommand{\apinforeq}[1]{%
2390 This clause specifies the information required for #1
2391
2392 \input{bpfap2}
2393
2394 }
2395 % \end{macrocode}
2396 %
2397 % Here is the text for file \file{bpfap2.tex}.
2398 % \changes{v1.5}{2001/07/16}{Changed text of file bpfap2.tex}
2399 % \begin{macrocode}
2400 %</ap>
2401 %<*bpfap2>
2402 \ProvidesFile{bpfap2.tex}[2001/07/16 AP info boilerplate]
2403 \typeout{bpfap2.tex [2001/07/16 AP info boilerplate]}
2404
2405 The information requirements are specified as a set of
2406 units of functionality, application objects, and
2407 application assertions. These assertions pertain to
2408 individual application objects and to relationships
2409 between application objects. The information requirements
2410 are defined using the terminology of the subject area of
2411 this application protocol.
2412
2413 \begin{note}A graphical representation of the information
2414 requirements is given in \aref{;sarm}.\end{note}
2415 \begin{note}The information requirements correspond to those of
2416 the activities identified as being within the scope of this
2417 application protocol in \aref{;saam}.\end{note}
2418 \begin{note}The mapping \maptableorspec{}
2419 specified in~\ref{;smap} shows how the
2420 integrated resources
2421 \ifaicinap and application interpreted constructs \fi
2422 are used to meet the information requirements of this
2423 application protocol. \end{note}
2424
2425 %</bpfap2>
2426 %<*ap>
2427 % \end{macrocode}
2428 % \end{macro}
2429 %
2430 % \begin{environment}{apuof}
2431 % Print boilerplate for UoF. \\
2432 % |\begin{apuof}|\meta{UoF list}|\end{apuof}| where \meta{UoF list} is a
2433 % list of UoF names in |\item| format.
2434 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap3.tex}
2435 %
2436 % \begin{macrocode}
2437 \newenvironment{apuof}{%
2438 This subclause specifies the units of functionality for the
2439 \theap\space application protocol. This part of ISO~10303
2440 specifies the following units of functionality:
2441 \begin{itemize}}{%
2442 \end{itemize}
2443
2444 \input{bpfap3}
2445
2446 }
2447 % \end{macrocode}
2448 %
2449 % Here is the text for file \file{bpfap3.tex}.
2450 % \begin{macrocode}
2451 %</ap>
2452 %<*bpfap3>
2453 \ProvidesFile{bpfap3.tex}[1997/09/30 AP uof boilerplate]
2454 \typeout{bpfap3.tex [1997/09/30 AP uof boilerplate]}
2455
2456 The units of functionality and a description of the functions
2457 that each UoF supports are given below. The application objects
2458 included in the UoFs are defined in~\ref{;sao}.
2459
2460 %</bpfap3>
2461 %<*ap>
2462 % \end{macrocode}
2463 % \end{environment}
2464 %
2465 % \begin{macro}{\apapplobj}
2466 % Print boilerplate for Application objects.
2467 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap4.tex}
2468 %
2469 % \begin{macrocode}
2470 \newcommand{\apapplobj}{\input{bpfap4}}
2471 % \end{macrocode}
2472 %
2473 % Here is the text for file \file{bpfap4.tex}
2474 % \begin{macrocode}
2475 %</ap>
2476 %<*bpfap4>
2477 \ProvidesFile{bpfap4.tex}[1997/09/30 AP application objects boilerplate]
2478 \typeout{bpfap4.tex [1997/09/30 AP application objects boilerplate]}
2479
2480 This subclause specifies the application objects for
2481 the \theap\space application protocol. Each application
2482 object is an atomic element that embodies a unique
2483 application concept and contains attributes specifying
2484 the data elements of the object. The application objects
2485 and their definitions are given below.
2486
2487 %</bpfap4>
2488 %<*ap>
2489 % \end{macrocode}
2490 % \end{macro}
2491 %
2492 % \begin{macro}{\apassert}
2493 % Print boilerplate for AP application assertions subclause.
2494 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap5.tex}
2495 %
2496 % \begin{macrocode}
2497 \newcommand{\apassert}{\input{bpfap5}}
2498 % \end{macrocode}
2499 %
2500 % Here is the text for file \file{bpfap5.tex}
2501 % \begin{macrocode}
2502 %</ap>
2503 %<*bpfap5>
2504 \ProvidesFile{bpfap5.tex}[1997/09/30 AP application assertions boilerplate]
2505 \typeout{bpfap5.tex [1997/09/30 AP application assertions boilerplate]}
2506
2507 This subclause specifies the application assertions for the
2508 \theap\space application protocol. Application assertions
2509 specify the relationships between application objects,
2510 the cardinality of the relationships, and the rules required
2511 for the integrity and validity of the application objects and
2512 UoFs. The application assertions and their definitions are
2513 given below.
2514
2515 %</bpfap5>
2516 %<*ap>
2517 % \end{macrocode}
2518 % \end{macro}
2519 %
2520 % \begin{macro}{\apmapping}
2521 % Print boilerplate for start of AP mapping table subclause.
2522 %
2523 % \changes{v1}{1995/05/31}{Major rewrite of mapping table boilerplate.}
2524 % \changes{v1}{1995/05/31}{Ignore parameters in mapping table boilerplate.}
2525 % \changes{v1.5}{2001/07/16}{Changed \cs{apmappingtable} to \cs{apmapping}}
2526 % \begin{macrocode}
2527 \newcommand{\apmapping}{%
2528 \ifmapspec \input{apmpspec} \else \input{apmptbl} \fi}
2529 % \end{macrocode}
2530 %
2531 % Here is the contents of the \file{apmptbl.tex} file.
2532 % \changes{v1.5}{2002/01/22}{Added item to apmptbl.tex file}
2533 % \begin{macrocode}
2534 %</ap> AP: boilerplate;
2535 %<*apmptbl>
2536 \ProvidesFile{apmptbl.tex}[2002/01/22 AP mapping table boilerplate]
2537 \typeout{apmptbl.tex [2002/01/22 STEP AP mapping table boilerplate]}
2538
2539 This clause contains the mapping table that shows how each
2540 UoF and application object of this part of ISO~10303
2541 (see \cref{;sireq}) maps to one or more AIM constructs
2542 (see \aref{;saeel}).
2543 The mapping table is organized in five columns.
2544
2545
2546 Column 1) Application element: Name of an application
2547 element as it appears in the application object definition
2548 in~\ref{;sao}. Application object names are written in uppercase.
2549 Attribute names and assertions are listed after the application
2550 object to which they belong and are written in lower case.
2551
2552 Column 2) AIM element: Name of an AIM element as it
2553 appears in the AIM (see \aref{;saeel}), the term ``IDENTICAL MAPPING'',
2554 or the term ``PATH''. AIM entities are written in lower case.
2555 Attribute names of AIM entities are referred to as
2556 $<$entity name$>$.$<$attribute name$>$. The mapping of an
2557 application element may result in several related AIM
2558 elements. Each of these AIM elements requires a line of its
2559 own in the table. The term ``IDENTICAL MAPPING'' indicates
2560 that both application objects of an application assertion
2561 map to the same AIM element. The term ``PATH'' indicates
2562 that the application assertion maps to the entire reference
2563 path.
2564
2565 Column 3) Source: For those AIM elements that are
2566 interpreted from the integrated resources or the application
2567 interpreted constructs, this is the
2568 number of the corresponding part of ISO~10303. For those
2569 AIM elements that are created for the purpose of this part
2570 of ISO~10303, this is the number of this part.
2571 Entities or types that are defined within the integrated
2572 resources have an AIC as the source reference if the use
2573 of the entity or type for the mapping is within the scope
2574 of the AIC.
2575
2576 Column 4) Rules: One or more numbers may be given that
2577 refer to rules that apply to the current AIM element or
2578 reference path. For rules that are derived from
2579 relationships between application objects, the same rule
2580 is referred to by the mapping entries of all the involved AIM
2581 elements. The expanded names of the rules are listed after
2582 the table.
2583
2584 Column 5) Reference path: To describe fully the mapping
2585 of an application object, it may be necessary to specify a
2586 reference path through several related AIM elements. The
2587 reference path column documents the role of an AIM element
2588 relative to the AIM element in the row succeeding it.
2589 Two or more such related AIM elements define the
2590 interpretation of the integrated resources that satisfies
2591 the requirement specified by the application object.
2592 For each AIM element that has been created for use within this
2593 part of ISO~10303, a reference path up to its supertype from
2594 an integrated resource is specified.
2595
2596
2597 For the expression of reference paths the following notational
2598 conventions apply:
2599 \begin{enumerate}
2600 \item \verb|[]| : enclosed section constrains multiple AIM elements
2601 or sections of the
2602 reference path are required to satisfy an information
2603 requirement;
2604 \item \verb|()| : enclosed section constrains multiple AIM elements
2605 or sections of the
2606 reference path are identified as alternatives within the
2607 mapping to satisfy an information requirement;
2608 \item \verb|{}| : enclosed section constrains the reference path
2609 to satisfy an information requirement;
2610 \item \verb|<>| : enclosed section constrains at one or more
2611 required reference path;
2612 \item \verb+||+ : enclosed section constrains the supertype entity;
2613 \item \verb|->| : attribute references the entity or select type
2614 given in the following row;
2615 \item \verb|<-| : entity or select type is referenced by the
2616 attribute in the following row;
2617 \item \verb|[i]| : attribute is an aggregation of which a
2618 single member is given in the following row;
2619 \item \verb|[n]| : attribute is an aggregation of which
2620 member \verb|n| is given in the following row;
2621 \item \verb|=>| : entity is a supertype of the entity given in the
2622 following row;
2623 \item \verb|<=| : entity is a subtype of the entity given in
2624 the following row;
2625 \item \verb|=| : the string, select, or enumeration type is
2626 constrained to a choice or value;
2627 \item \verb|\| : the reference path expression continues on
2628 the next line;
2629 \item \verb|*| : used in conjunction with braces to indicate that any
2630 number of relationship entity data types may be assembled in a
2631 relationship tree structure.
2632 \end{enumerate}
2633
2634 %</apmptbl>
2635 %<*ap>
2636 % \end{macrocode}
2637 % \end{macro}
2638 %
2639 % \begin{macro}{\apmappingspec}
2640 % Print boilerplate for start of AP mapping specification subclause.
2641 % \changes{v1.5}{2001/07/16}{Added \cs{apmappingspec}}
2642 % \begin{macrocode}
2643 \newcommand{\apmappingspec}{\input{apmpspec}}
2644 % \end{macrocode}
2645 %
2646 % Here is the contents of the \file{apmpspec.tex} file.
2647 % \changes{v1.5}{2001/07/16}{Added apmpspec.tex file}
2648 % \begin{macrocode}
2649 %</ap>
2650 %<*apmpspec>
2651 \ProvidesFile{apmpspec.tex}[2001/07/16 AP mapping spec boilerplate]
2652 \typeout{apmpspec.tex [2001/07/16 STEP AP mapping spec boilerplate]}
2653
2654 This clause contains the mapping specification that shows how each
2655 UoF and application object of this part of ISO~10303
2656 (see \cref{;sireq}) maps to one or more AIM constructs
2657 (see \aref{;saeel}).
2658 Each mapping specifies up to five elements.
2659
2660 \begin{description}
2661 \item[Application element] The mapping for each application element
2662 is specified in a seperate subclause below.
2663 Application object names are given in title case.
2664 Attribute names and assertions are listed after the application
2665 object to which they belong and are given in lower case.
2666
2667 \item[AIM element] The name of one or more AIM entity data types
2668 (see \aref{;saeel}), the term ``IDENTICAL MAPPING'',
2669 or the term ``PATH''.
2670 AIM entity data type names are given in lower case.
2671 Attributes of AIM entity data types are referred to as
2672 $<$entity name$>$.$<$attribute name$>$.
2673 The mapping of an application element may involve more than
2674 one AIM element.
2675 Each of these AIM elements is presented on a seperate line
2676 in the mapping specification.
2677 The term ``IDENTICAL MAPPING'' indicates that both application
2678 objects involved in an application assertion map to the same
2679 instance of an AIM entity data type.
2680 The term ``PATH'' indicates that the application assertion maps
2681 to a collection of related AIM entity instances specified
2682 by the entire reference path.
2683
2684 \item[Source] For those AIM elements that are
2685 interpreted from any common resource, this is the ISO standard
2686 number and part number in which the resource is defined.
2687 For those AIM elements that are created for the purpose of this part
2688 of ISO~10303, this is ``ISO~10303--'' followed by the number of
2689 this part.
2690
2691 \item[Rules] One or more global rules may be specified that
2692 apply to the population of the AIM entity data types specified
2693 as the AIM element or in the reference path.
2694 For rules that are derived from
2695 relationships between application objects, the same rule
2696 is referred to by the mapping entries of all the involved AIM
2697 elements.
2698 A reference to a global rule may be accompanied by a reference to
2699 the subclause in which the rule is defined.
2700
2701 \item[Reference path] To describe fully the mapping
2702 of an application object, it may be necessary to specify a
2703 reference path involving several related AIM elements.
2704 Each line in the reference path documents the role of an AIM
2705 element relative to the AIM element in the line following it.
2706 Two or more such related AIM elements define the
2707 interpretation of the integrated resources that satisfies
2708 the requirement specified by the application object.
2709 For each AIM element that has been created for use within this
2710 part of ISO~10303, a reference path to its supertype from
2711 an integrated resource is specified.
2712 For the expression of reference paths and the relationships
2713 between AIM elements the following notational conventions apply:
2714 \begin{itemize}
2715 \item[\texttt{[]}] enclosed section constrains multiple AIM elements
2716 or sections of the
2717 reference path are required to satisfy an information
2718 requirement;
2719 \item[\texttt{()}] enclosed section constrains multiple AIM elements
2720 or sections of the
2721 reference path are identified as alternatives within the
2722 mapping to satisfy an information requirement;
2723 \item[\texttt{\{\}}] enclosed section constrains the reference path
2724 to satisfy an information requirement;
2725 \item[\texttt{<>}] enclosed section constrains at one or more
2726 required reference path;
2727 \item[\texttt{||}] enclosed section constrains the supertype entity;
2728 \item[\texttt{->}] attribute references the entity or select type
2729 given in the following row;
2730 \item[\texttt{<-}] entity or select type is referenced by the
2731 attribute in the following row;
2732 \item[\texttt{[i]}] attribute is an aggregation of which a
2733 single member is given in the following row;
2734 \item[\texttt{[n]}] attribute is an aggregation of which
2735 member \texttt{n} is given in the following row;
2736 \item[\texttt{=>}] entity is a supertype of the entity given in the
2737 following row;
2738 \item[\texttt{<=}] entity is a subtype of the entity given in
2739 the following row;
2740 \item[\texttt{=}] the string, select, or enumeration type is
2741 constrained to a choice or value;
2742 \item[\texttt{\textbackslash}] the reference path expression continues on
2743 the next line;
2744 \item[\texttt{*}] used in conjunction with braces to indicate that
2745 any number of relationship entity data types may be assembled
2746 in a relationship tree structure;
2747 \ifmaptemplate
2748 \item[\texttt{//}] enclosed section is an application of one of the
2749 mapping templates defined in \ref{;stemps} below;
2750 \fi
2751 \item[\texttt{--}] the text following is a comment
2752 (normally a clause reference).
2753 \end{itemize}
2754
2755 \end{description}
2756
2757 %</apmpspec>
2758 %<*ap>
2759 % \end{macrocode}
2760 % \end{macro}
2761 %
2762 % \begin{macro}{\apmaptemplate}
2763 % Print boilerplate for start of AP mapping template subsubclause.
2764 % \changes{v1.5}{2001/07/16}{Added \cs{apmaptemplate}}
2765 % \begin{macrocode}
2766 \newcommand{\apmaptemplate}{\input{apmptempl}}
2767 % \end{macrocode}
2768 %
2769 % Here is the contents of the \file{apmptempl.tex} file.
2770 % \changes{v1.5}{2001/07/16}{Added apmptempl.tex file}
2771 % \begin{macrocode}
2772 %</ap>
2773 %<*apmptempl>
2774 \ProvidesFile{apmptempl.tex}[2001/07/16 AP mapping template boilerplate]
2775 \typeout{apmptempl.tex [2001/07/16 STEP AP mapping template boilerplate]}
2776
2777 This mapping specification includes mapping templates.
2778 A mapping template is a reusable portion of a reference path that defines
2779 a commonly used part of the structure of the application interpreted model.
2780 A mapping template is similar to a programming language macro.
2781 The mapping templates used in this part of ISO~10303 are defined in this
2782 subclause. Each mapping template definition has three components as follows:
2783 \begin{itemize}
2784 \item the template signature that specifies the name of the template
2785 and may also specify the names and the order of the formal parameters
2786 of the template;
2787
2788 \item descriptions of the formal parameters of the template, if any;
2789
2790 \item the template body that defines the reusable portion of a reference
2791 path and may indicate, through the use of the formal parameter
2792 names included in the template signature, the points at which
2793 the value parameters are supplied in each template application.
2794 \end{itemize}
2795
2796 Each mapping template is used at least once in the reference paths
2797 specified in~\ref{;uof1} to~\ref{;uoflast}.
2798 Each such template application is a reference to the template definition,
2799 based on the pattern established by the template signature, and supplies
2800 the value parameters that are to be substitued for the formal parameters
2801 specified in the template definition. The full reference path can be derived
2802 by replacing any formal parameters in the template body by the value
2803 parameters specified in the template application and then substituting
2804 the completed template body for the template application.
2805
2806 %%\begin{anexample}
2807 %%The following is an example of a template application that invokes and
2808 %%supplies parameters for the GROUPS mapping template.
2809 %%
2810 %%/GROUPS(shape\_aspect, 'boundary index 1')/
2811 %%
2812 %%\end{anexample}
2813
2814 The non-blank characters following the first `/' define the name of
2815 the mapping template. The name of the mapping template is given in
2816 upper case. The name of the template is followed by a list of parameter
2817 values, seperated by commas, enclosed in parentheses. Parameter values
2818 are given in lower case except in the case that the value parameter
2819 is a string literal that includes upper case characters.
2820
2821 The following notational conventions apply to the definitions and
2822 applications of templates:
2823
2824 \begin{itemize}
2825
2826 \item[\texttt{/}] marks the beginning and end of a template signature or a
2827 template application;
2828 \item[\texttt{\&}] prefixes the name of a formal parameter within the definition
2829 of a template body;
2830 \item[\texttt{()}] enclose the formal parameters in a template signature or the
2831 value parameters in a template application;
2832 \item[\texttt{,}] separates formal parameters in a template signature or
2833 value parameters in a template application;
2834 \item[\texttt{' '}] denotes a string literal that is used as a value parameter
2835 in a template application.
2836
2837 \end{itemize}
2838
2839 Value parameters that are not enclosed by quotes are \Express{} data type
2840 identifiers.
2841
2842 This part of ISO~10303 uses the templates that are specified in the
2843 following subclauses.
2844
2845 %</apmptempl>
2846 %<*ap>
2847 % \end{macrocode}
2848 % \end{macro}
2849 %
2850 % \begin{macro}{\sstemplates}
2851 % A macro for the boilerplate text for SUBTYPE and SUPERTYPE templates.
2852 % \changes{v1.5}{2001/07/16}{Added \cs{sstemplates} and boilerplate}
2853 % \begin{macrocode}
2854 \newcommand{\sstemplates}{\input{apsstempl}}
2855 % \end{macrocode}
2856 % \end{macro}
2857 %
2858 % Here is the text for the file \file{apsstempl.tex}.
2859 % \begin{macrocode}
2860 %</ap>
2861 %<*apsstempl>
2862 \ProvidesFile{apsstempl.tex}[2001/07/16 AP SUP/SUB templates boilerplate]
2863 \typeout{apsstempl.tex [2001/07/16 AP SUP/SUB templates boilerplate]}
2864
2865 \sssclause{SUBTYPE}
2866
2867 The SUBTYPE mapping template specifies a reference to the mapping of
2868 a subtype of the current application object. Several such references may
2869 be included for one supertype application object.
2870
2871 \begin{anote} This template definition only consists of a template signature,
2872 there is no matching template body. The template is included to ease the
2873 automatic processing of the mapping specification.
2874 \end{anote}
2875
2876 \signature
2877
2878 /SUBTYPE(application\_object)/
2879
2880 \parameters
2881
2882 application\_object: the application object that is a subtype of the current
2883 supertype application object and that has the entire
2884 or a part of the mapping specification of this
2885 supertype.
2886
2887
2888 \sssclause{SUPERTYPE}
2889
2890 The SUPERTYPE mapping template specifies a reference to the mapping of
2891 a supertype of the current application object. Several such references may
2892 be included for the subtype application object.
2893
2894 \begin{anote} This template only consists of a signature,
2895 there is no matching body. The template is included to ease the
2896 automatic processing of the mapping specification.
2897 \end{anote}
2898
2899 \signature
2900
2901 /SUPERTYPE(application\_object)/
2902
2903 \parameters
2904
2905 application\_object: the application object that is a supertype of the current
2906 subtype application object and that has the entire
2907 or a part of the mapping specification of this
2908 subtype.
2909
2910 %</apsstempl>
2911 %<*ap>
2912 % \end{macrocode}
2913 %
2914 %
2915 % \begin{macro}{\apshortexpress}
2916 % Print boilerplate for AP AIM EXPRESS short listing.
2917 % \changes{v1}{1995/05/31}{Changed the conditionals.}
2918 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap6.tex}
2919 %
2920 % \begin{macrocode}
2921 \newcommand{\apshortexpress}{\input{bpfap6}}
2922 % \end{macrocode}
2923 %
2924 % Here is the text of file \file{bpfap6.tex}
2925 % \changes{v1.5}{2001/07/16}{Minor changes to file bpfap6.tex}
2926 % \changes{v1.5}{2002/01/22}{Minor changes to file bpfap6.tex}
2927 % \begin{macrocode}
2928 %</ap>
2929 %<*bpfap6>
2930 \ProvidesFile{bpfap6.tex}[2002/01/22 AP AIM EXPRESS short listing boilerplate]
2931 \typeout{bpfap6.tex [2002/01/22 AP AIM EXPRESS short listing boilerplate]}
2932
2933 This clause specifies the \Express{} schema that uses
2934 elements from the integrated resources
2935 \ifaicinap and the AICs \fi
2936 and contains the types, entity specializations, rules,
2937 and functions that are specific to this part of ISO~10303.
2938 This clause also specifies modifications to the text
2939 for constructs that are imported from the
2940 integrated
2941 \ifaicinap resources and the AICs. \else resources. \fi
2942 The definitions and
2943 \Express{} provided in the integrated resources for constructs
2944 used in the AIM may include select list items and subtypes
2945 that are not imported into the AIM. Requirements stated
2946 in the integrated resources that refer to select list items and
2947 subtypes apply exclusively to those items that are imported
2948 into the AIM.
2949
2950 %</bpfap6>
2951 %<*ap>
2952 % \end{macrocode}
2953 % \end{macro}
2954 %
2955 % \begin{macro}{\apconformance}
2956 % Print boilerplate for AP conformance. \\
2957 % |\apconformance{|\meta{implentation methods}|}|
2958 % \changes{v1}{1995/05/31}{Interchanged annexes C and D.}
2959 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap7.tex}
2960 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap8.tex}
2961 % \begin{macrocode}
2962 \newcommand{\apconformance}[1]{%
2963
2964 \input{bpfap7}
2965
2966 An implementation shall support at least one of the following
2967 implementation methods: #1.
2968
2969 \input{bpfap8}
2970
2971 }
2972 % \end{macrocode}
2973 %
2974 % Here is the text of file \file{bpfap7.tex}
2975 % \begin{macrocode}
2976 %</ap>
2977 %<*bpfap7>
2978 \ProvidesFile{bpfap7.tex}[1997/09/30 AP conformance boilerplate (1)]
2979 \typeout{bpfap7.tex [1997/09/30 AP conformance boilerplate (1)]}
2980
2981 Conformance to this part of ISO 10303 includes satisfying
2982 the requirements stated in this part, the requirements of
2983 the implementation method(s) supported, and the relevant
2984 requirements of the normative references.
2985
2986 %</bpfap7>
2987 %<*ap>
2988 % \end{macrocode}
2989 %
2990 % Here is the text of file \file{bpfap8.tex}
2991 % \begin{macrocode}
2992 %</ap>
2993 %<*bpfap8>
2994 \ProvidesFile{bpfap8.tex}[1997/09/30 AP conformance boilerplate (2)]
2995 \typeout{bpfap8.tex [1997/09/30 AP conformance boilerplate (2)]}
2996
2997 Requirements with respect to implementation methods-specific
2998 requirements are specified in \aref{;simreq}.
2999
3000 The Protocol Information Conformance Statement (PICS)
3001 proforma lists the options or the combination of options
3002 that may be included in the implementation. The PICS
3003 proforma is provided in \aref{;spics}.
3004
3005 %</bpfap8>
3006 %<*ap>
3007 % \end{macrocode}
3008 % \end{macro}
3009 %
3010 % \begin{environment}{apconformclasses}
3011 % Print boilerplate for AP conformance classes. \\
3012 % |\begin{apconformclasses}|\meta{class list}|\end{apconformclasses}|
3013 % where \meta{class list}
3014 % is a list of conformance classes in |\item| format.
3015 %
3016 % \begin{macrocode}
3017 \newenvironment{apconformclasses}{%
3018 This part of ISO~10303 provides for a number of options that
3019 may be supported by an implementation. These options have been
3020 grouped into the following conformance classes:
3021 \begin{itemize}}{%
3022 \end{itemize}
3023 Support for a particular conformance class requires support of
3024 all the options specified in this class.
3025
3026 }
3027 % \end{macrocode}
3028 % \end{environment}
3029 %
3030 % \begin{macro}{\apshortnames}
3031 % Print boilerplate for AP short names.
3032 %
3033 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap9.tex}
3034 % \begin{macrocode}
3035 \newcommand{\apshortnames}{\input{bpfap9}}
3036 % \end{macrocode}
3037 %
3038 % Here is the text of file \file{bpfap9.tex}
3039 % \begin{macrocode}
3040 %</ap>
3041 %<*bpfap9>
3042 \ProvidesFile{bpfap9.tex}[1997/09/30 AP short names boilerplate]
3043 \typeout{bpfap9.tex [1997/09/30 AP short boilerplate]}
3044
3045 Table B.1 provides the short names of entities specified
3046 in the AIM of this part of ISO~10303. Requirements on the
3047 use of the short names are found in the implementation methods
3048 included in ISO~10303.
3049
3050 %</bpfap9>
3051 %<*ap>
3052 % \end{macrocode}
3053 % \end{macro}
3054 %
3055 % \begin{macro}{\picsannex}
3056 % Print boilerplate for PICS annex.
3057 %
3058 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap10.tex}
3059 % \begin{macrocode}
3060 \newcommand{\picsannex}{\input{bpfap10}}
3061 % \end{macrocode}
3062 %
3063 % Here is the text of file \file{bpfap10.tex}
3064 % \begin{macrocode}
3065 %</ap>
3066 %<*bpfap10>
3067 \ProvidesFile{bpfap10.tex}[1997/09/30 AP PICS annex boilerplate]
3068 \typeout{bpfap10.tex [1997/09/30 AP PICS annex boilerplate]}
3069
3070 This clause lists the optional elements of this part
3071 of ISO~10303. An implementation may choose to support
3072 any combination of these optional elements. However,
3073 certain combinations of options are likely to be
3074 implemented together. These combinations are called
3075 conformance classes and are described in the subclauses
3076 of this annex.
3077
3078 This annex is in the form of a questionnaire. This
3079 questionnaire is intended to be filled out by the
3080 implementor and may be used in preparation for conformance
3081 testing by a testing laboratory. The completed PICS proforma
3082 is referred to as a PICS.
3083
3084 %</bpfap10>
3085 %<*ap>
3086 % \end{macrocode}
3087 % \end{macro}
3088 %
3089 % \begin{macro}{\aamfigrs}
3090 % \begin{macro}{\aamfigrange}
3091 % The command |\aamfigrange{|\meta{figure range}|}| stores the
3092 % figure range for the AAM activity model diagrams. Use as:
3093 % \begin{verbatim}
3094 % \aamfigrange{figure F.1 through F.n}
3095 % \end{verbatim}
3096 % where \verb|F.n| is the last of \verb|n| figures.
3097 %
3098 % Internally, the value of |\aamfigrange| is kept in |\aamfigrs|
3099 % which is given an initial value just in case the user forgets
3100 % to call |\aamfigrange|. The value of |\aamfigrs| is used in later
3101 % boilerplate.
3102 %
3103 % \changes{v11}{1997/09/30}{Added aamfigrange and aamfigrs}
3104 % \begin{macrocode}
3105 \gdef\aamfigrs{figure F.1}
3106 \newcommand{\aamfigrange}[1]{\gdef\aamfigrs{#1}}
3107 % \end{macrocode}
3108 % \end{macro}
3109 % \end{macro}
3110 %
3111 % \begin{macro}{\apaamintro}
3112 % Print boilerplate for AAM annnex intro.
3113 %
3114 % \changes{v11}{1997/09/30}{Modify the apaamintro to input file bpfap11.tex}
3115 % \begin{macrocode}
3116 \newcommand{\apaamintro}{\input{bpfap11}}
3117 % \end{macrocode}
3118 %
3119 % Here is the contents of \file{bpfap11.tex}. Note the use of
3120 % the |\aamfigrs| command.
3121 %
3122 % \changes{v1.5}{2001/07/16}{Minor change to file bpfap11.tex}
3123 % \begin{macrocode}
3124 %</ap>
3125 %<*bpfap11>
3126 \ProvidesFile{bpfap11.tex}[2001/07/16 AP AAM annex intro boilerplate]
3127 \typeout{bpfap11.tex [2001/07/16 AP AAM annex intro boilerplate}
3128
3129 The application activity model (AAM) is provided as an aid
3130 in understanding the scope and information requirements
3131 defined in this application protocol. The model is presented
3132 as a set of figures that contain the activity
3133 diagrams and a set of definitions of the activities
3134 and their data.
3135 %%%%%% The application activity model is given in \aamfigrs.
3136 Activities and data flows that are out of scope are marked with
3137 an asterisk.
3138
3139 %</bpfap11>
3140 %<*ap>
3141 % \end{macrocode}
3142 % \end{macro}
3143 %
3144 %
3145 % \begin{macro}{\apaamdefs}
3146 % Print boilerplate for AAM definitions.
3147 %
3148 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap12.tex}
3149 % \begin{macrocode}
3150 \newcommand{\apaamdefs}{\input{bpfap12}}
3151 % \end{macrocode}
3152 %
3153 % Here is the text of file \file{bpfap12.tex}
3154 % \begin{macrocode}
3155 %</ap>
3156 %<*bpfap12>
3157 \ProvidesFile{bpfap12.tex}[1997/09/30 AP AAM definitions boilerplate]
3158 \typeout{bpfap12.tex [1997/09/30 AP AAM definitions boilerplate]}
3159
3160 The following terms are used in the application
3161 activity model. Terms marked with an asterisk are outside
3162 the scope of this application protocol.
3163
3164 The definitions given in this annex do not supersede
3165 the definitions given in the main body of the text.
3166
3167 %</bpfap12>
3168 %<*ap>
3169 % \end{macrocode}
3170 % \end{macro}
3171 %
3172 % \begin{macro}{\aamfigures}
3173 % Print boilerplate for AAM figures.
3174 % |\aamfigures|
3175 %
3176 % \changes{v11}{1997/09/30}{Modified aamfigures command to input file bpfap15.tex}
3177 % \begin{macrocode}
3178 \newcommand{\aamfigures}{\input{bpfap15}}
3179 % \end{macrocode}
3180 %
3181 % Here is the contents of \file{bpfap15.tex}.
3182 %
3183 % \changes{v1.5}{2001/07/16}{Minor change to file bpfap15.tex}
3184 % \begin{macrocode}
3185 %</ap>
3186 %<*bpfap15>
3187 \ProvidesFile{bpfap15.tex}[2001/07/16 AP AAM annex figures subclause boilerplate]
3188 \typeout{bpfap15.tex [2001/07/16 AP AAM annex figures subclause boilerplate]}
3189
3190 The application activity model diagrams are given in \aamfigrs. The
3191 graphical form of the application activity model is
3192 presented in the IDEF0 activity modelling format \brefidefo.
3193 Activities and data flows that are out of scope are
3194 marked with asterisks.
3195
3196 %</bpfap15>
3197 %<*ap>
3198 % \end{macrocode}
3199 % \end{macro}
3200 %
3201 % \begin{macro}{\armintro}
3202 % Print boilerplate for ARM introduction.
3203 % \changes{v1.5}{2001/07/16}{Replaced \cs{armfigures} by \cs{armintro}}
3204 % \begin{macrocode}
3205 \newcommand{\armintro}{%
3206 This annex provides the application reference model for this part of ISO
3207 10303. The application reference model is a graphical
3208 representation of the structure and constraints of the application objects
3209 specified in \cref{;sireq}. The graphical form of the application reference
3210 model is presented in \ifidefix IDEF1X. \else \ExpressG. \fi
3211 The application reference model is
3212 independent from any implementation method.
3213 \ifidefix The diagrams use the IDEF1X graphical notation~\brefidefix.
3214 \else \expressgdef. \fi
3215
3216 }
3217 % \end{macrocode}
3218 % \end{macro}
3219 %
3220 % \begin{macro}{\aimexpressg}
3221 % Print boilerplate for AIM EXPRESS-G.
3222 % \changes{v1.5}{2001/07/16}{Changed \cs{aimexpressg}}
3223 % \begin{macrocode}
3224 \newcommand{\aimexpressg}{%
3225 The diagrams in this annex correspond to the AIM \Express{} expanded
3226 listing given in \aref{;saeel}.
3227 The diagrams use the \ExpressG{} graphical notation for the
3228 \Express{} language. \expressgdef.
3229
3230 }
3231 % \end{macrocode}
3232 % \end{macro}
3233 %
3234 % \changes{v1.5}{2001/07/16}{Deleted \cs{aimexplisting} command}
3235 %
3236 % \begin{macro}{\apexpurls}
3237 % The command |\apexpurls{|\meta{short}|}{|\meta{express}|}| prints
3238 % the boilerplate for an AP annex of short names and EXPRESS schemas,
3239 % where \meta{short} is the URL of the short names and \meta{express}
3240 % is the URL of the EXPRESS code.
3241 % \changes{v1.3}{1999/02/15}{New \cs{apexpurls} command}
3242 % \changes{v1.5}{2001/07/16}{Changed \cs{apexpurls} command}
3243 % \begin{macrocode}
3244 \newcommand{\apexpurls}[2]{\input{bpfap13}
3245
3246 \begin{itemize}
3247 \item Short names: \isourl{#1}
3248 \item \Express: \isourl{#2}
3249 \end{itemize}
3250
3251 \input{bpfap16}}
3252 % \end{macrocode}
3253 % \end{macro}
3254 %
3255 % Here is the text of file \file{bpfap13.tex}
3256 % \changes{v1.3}{1999/02/15}{Changed contents of file bpfap13.tex}
3257 % \changes{v1.5}{2001/07/16}{Changed contents of file bpfap13.tex}
3258 % \begin{macrocode}
3259 %</ap>
3260 %<*bpfap13>
3261 \ProvidesFile{bpfap13.tex}[2001/07/16 AP short names/EXPRESS listing boilerplate (1)]
3262 \typeout{bpfap13.tex [2001/07/16 AP ahort names/EXPRESS listing boilerplate (1)]}
3263
3264 This annex provides a listing of the complete \Express{} schema
3265 specified in \aref{;saeel} of this part of ISO~10303 without comments
3266 or explanatory text. It also provides a listing of the \Express{} entity
3267 names and corresponding short names as specified in \aref{;sasn}
3268 of this part of ISO~10303. The content of this annex is available
3269 in computer-interpretable form and can be found at the following URLs:
3270
3271 %</bpfap13>
3272 %
3273 % Here is the text of \file{bpfap16.tex}.
3274 % \changes{v1.3}{1999/02/15}{Added file bpfap16.tex}
3275 %<*bpfap16>
3276 \ProvidesFile{bpfap16.tex}[1999/02/15 AP short names and EXPRESS annex ending boilerplate]
3277 \typeout{bpfap16.tex [1997/09/30 AP short names and EXPRESS annex ending boilerplate]}
3278
3279 If there is difficulty accessing these sites contact ISO Central Secretariat or
3280 contact the ISO TC~184/SC4 Secretariat directly at: \url{[email protected]}.
3281
3282 \begin{anote}The information provided in computer-interpretable form at the above
3283 URLs is informative. The information that is contained in the body of this
3284 part of ISO~10303 is normative.
3285 \end{anote}
3286
3287 %</bpfap16>
3288 %<*ap>
3289 % \end{macrocode}
3290 %
3291 % \begin{macro}{\aimlongexp}
3292 % Print boilerplate for AIM EXPRESS expanded listing.
3293 %
3294 % \changes{v1}{1997/09/30}{Put boilerplate into file bpfap14.tex}
3295 % \begin{macrocode}
3296 \newcommand{\aimlongexp}{\input{bpfap14}}
3297 % \end{macrocode}
3298 %
3299 % Here is the text of file \file{bpfap14.tex}
3300 % \begin{macrocode}
3301 %</ap>
3302 %<*bpfap14>
3303 \ProvidesFile{bpfap14.tex}[1997/09/30 AP AIM EXPRESS expanded listing boilerplate]
3304 \typeout{bpfap14.tex [1997/09/30 AP AIM EXPRESS expanded listing boilerplate]}
3305
3306 The following \Express{} is the expanded form of the short
3307 form schema given in~\ref{;saesl}. In the event of any discrepancy
3308 between the short form and this expanded listing, the expanded
3309 listing shall be used.
3310
3311 %</bpfap14>
3312 %<*ap>
3313 % \end{macrocode}
3314 % \end{macro}
3315 %
3316 % \begin{macro}{\apimpreq}
3317 % Print boilerplate for AP requirements on exchange structure.\\
3318 % |\apimpreq{|\meta{schema name}|}|.
3319 %
3320 % \begin{macrocode}
3321 \newcommand{\apimpreq}[1]{%
3322 The implementation method defines what types of exchange
3323 behaviour are required with respect to this part of ISO~10303.
3324 Conformance to this part of ISO~10303 shall be realized in an
3325 exchange structure. The file format shall be encoded according
3326 to the syntax and \Express{} language mapping defined in
3327 ISO~10303-21 and in the AIM defined in \aref{;saeel} of this part
3328 of ISO~10303. The header of the exchange structure shall identify
3329 use of this part of ISO~10303 by the schema name `#1'.
3330
3331 }
3332 % \end{macrocode}
3333 % \end{macro}
3334 %
3335 % The end of this package.
3336 % \begin{macrocode}
3337 %</ap>
3338 % \end{macrocode}
3339 %
3340 % \section{The Application Interpreted Construct package}
3341 %
3342 % This section defines the contents of the package designed for
3343 % use in documenting STEP AICs.
3344 % \begin{macrocode}
3345 %<*aic>
3346 % \end{macrocode}
3347 %
3348 % If we are in an AIC we are not in an IR.
3349 % \begin{macrocode}
3350
3351 \anirfalse
3352
3353 % \end{macrocode}
3354 %
3355 %
3356 % \subsection{Heading commands}
3357 %
3358 % The commands in this section provide for the specified clause
3359 % headings in an AIC.
3360 %
3361 % \begin{macro}{\aicshortexphead}
3362 % Starts an `EXPRESS short listing' clause
3363 % \begin{macrocode}
3364 \newcommand{\aicshortexphead}{\clause{EXPRESS short listing}\label{;sesl}}
3365 % \end{macrocode}
3366 % \end{macro}
3367 %
3368 % \changes{v1.5}{2001/07/16}{Deleted \cs{aicshortnameshead}}
3369 % \changes{v1.5}{2001/07/16}{Deleted \cs{aicexpressghead}}
3370 %
3371 %
3372 %
3373 % \subsection{Boilerplate commands}
3374 %
3375 % \begin{macro}{\aicextraintro}
3376 % Print boilerplate for an extra AIC paragraph in the Introduction.
3377 %
3378 % \begin{macrocode}
3379 \newcommand{\aicextraintro}{%
3380 This part of ISO~10303 is a member of the application
3381 interpreted construct series.
3382 An application interpreted construct (AIC) provides a
3383 logical grouping of interpreted constructs that supports
3384 a specific functionality for the usage of product data across
3385 multiple application contexts. An interpreted construct is a
3386 common interpretation of the integrated resources that
3387 supports shared information requirements among application
3388 protocols.
3389 }
3390 % \end{macrocode}
3391 % \end{macro}
3392 %
3393 % \begin{macro}{\aicdef}
3394 % Boilerplate for the definition of `AIC'. Only to be used within
3395 % the |definitions| environment.
3396 % \changes{v1.5}{2001/07/16}{Changed wording in \cs{aicdef}}
3397 % \begin{macrocode}
3398 \newcommand{\aicdef}{%
3399 \definition{application interpreted construct (AIC)}%
3400 {a logical grouping of interpreted constructs
3401 that supports a specific function for
3402 the usage of product data across multiple
3403 application contexts.}
3404 }
3405 % \end{macrocode}
3406 % \end{macro}
3407 %
3408 %
3409 % \begin{macro}{\aicshortexpintro}
3410 % This environemt provides the boilerplate for the introduction
3411 % to the AIC EXPRESS short listing.
3412 %
3413 % \changes{v11}{1997/09/30}{Changed \cs{aicshortexpintro} boilerplate}
3414 % \changes{v1.5}{2001/07/16}{Changed \cs{aicshortexpintro} boilerplate}
3415 % \begin{macrocode}
3416 \newcommand{\aicshortexpintro}{%
3417 This clause specifies the \Express{} schema that uses
3418 elements from the integrated resources and contains the
3419 types, entity data types specializations, and functions that are
3420 specific to this part of ISO~10303.
3421 \begin{anote}There may be subtypes and items of select lists that
3422 appear in the integrated resources that are not
3423 imported into the AIC. Constructs are eliminated
3424 from the subtype tree or select list through the
3425 use of the implicit interface rules of ISO 10303-11.
3426 References to eliminated constructs are outside the
3427 scope of the AIC. In some cases, all items of the select
3428 list are eliminated. Because AICs are intended to be
3429 implemented in the context of an application protocol,
3430 the items of the select list will be defined by the
3431 scope of the application protocol.
3432 \end{anote} % end note
3433 }
3434 % \end{macrocode}
3435 % \end{macro}
3436 %
3437 % \changes{v1.5}{2001/07/16}{Deleted \cs{aicshortnames}}
3438 %
3439 %
3440 % \begin{macro}{\aicexpressg}
3441 % Print boilerplate for AIC EXPRESS-G. \\
3442 % \changes{v1.4}{2000/01/12}{Changed text of \cs{aicexpressg}}
3443 % \changes{v1.5}{2001/07/16}{Deleted parameter of \cs{aicexpressg}}
3444 % \begin{macrocode}
3445 \newcommand{\aicexpressg}{%
3446 The diagrams in this annex are generated from the short
3447 listing given in \cref{;sesl} and correspond to the \Express{} schemas
3448 specified in this part of ISO 10303.
3449 The diagrams use the \ExpressG{} graphical notation for the
3450 \Express{} language. \expressgdef. \par
3451 }
3452 % \end{macrocode}
3453 % \end{macro}
3454 %
3455 %
3456 %
3457 %
3458 % The end of this package.
3459 % \begin{macrocode}
3460 %</aic>
3461 % \end{macrocode}
3462 %
3463 %
3464 % \section{The Abstract Test Suite package}
3465 %
3466 % This section defines the contents of the package designed for
3467 % use in documenting STEP ATSs. The relevent text has been taken from
3468 % \cite{SC4N536}.
3469 %
3470 % \begin{macrocode}
3471 %<*ats>
3472 % \end{macrocode}
3473 %
3474 % If we are in an ATS then we are not in an IR.
3475 % \begin{macrocode}
3476
3477 \anirfalse
3478
3479 % \end{macrocode}
3480 %
3481 % \subsection{Preamble commands}
3482 %
3483 % These commands must be put in the document preamble.
3484 % \begin{macro}{\theAPpartno}
3485 % \begin{macro}{\APnumber}
3486 % \begin{macro}{\theAPtitle}
3487 % \begin{macro}{\APtitle}
3488 % |\APnumber{|\meta{part number of AP}|}| --- the part number (e.g. 203)
3489 % of the AP of this ATS. Internally it is referred to as |\theAPpartno|.
3490 % \begin{macrocode}
3491 \gdef\theAPpartno{}
3492 \newcommand{\APnumber}[1]{\gdef\theAPpartno{#1}}
3493 \gdef\theAPtitle{}
3494 \newcommand{\APtitle}[1]{\gdef\theAPtitle{#1}}
3495
3496 % \end{macrocode}
3497 % \end{macro}
3498 % \end{macro}
3499 % \end{macro}
3500 % \end{macro}
3501 %
3502 %
3503 % \subsection{Keyword commands}
3504 %
3505 % The commands defined in this section implement the keywords specified
3506 % for an ATS document.
3507 %
3508 % \begin{macro}{\atssummary}
3509 % \begin{macro}{\atscovered}
3510 % \begin{macro}{\atsinput}
3511 % \begin{macro}{\atsconstraints}
3512 % \begin{macro}{\atsverdict}
3513 % \begin{macro}{\atsexecution}
3514 % \begin{macro}{\atsextra}
3515 % These commands produce a set of underlined phrases.
3516 % \changes{v11}{1997/09/30}{New ATS keyword commands (7)}
3517 % \begin{macrocode}
3518 \newcommand{\atssummary}{\underline{\texttt{Test case summary:}}}
3519 \newcommand{\atscovered}{\underline{\texttt{Test purposes covered:}}}
3520 \newcommand{\atsinput}{\underline{\texttt{Input specification:}}}
3521 \newcommand{\atsconstraints}{\underline{\texttt{Constraints on values:}}}
3522 \newcommand{\atsverdict}{\underline{\texttt{Verdict criteria:}}}
3523 \newcommand{\atsexecution}{\underline{\texttt{Execution sequence:}}}
3524 \newcommand{\atsextra}{\underline{\texttt{Extra details:}}}
3525
3526 % \end{macrocode}
3527 % \end{macro}
3528 % \end{macro}
3529 % \end{macro}
3530 % \end{macro}
3531 % \end{macro}
3532 % \end{macro}
3533 % \end{macro}
3534 %
3535 % \subsection{Heading commands}
3536 %
3537 % The commands in this section provide for the specified clause
3538 % headings in an ATS.
3539 % \changes{v1.5}{2001/07/16}{Deleted the AIC ...name macros for headings}
3540 %
3541 % \begin{macro}{\purposesname}
3542 % Command to start a `Test purposes' clause.
3543 % \begin{macrocode}
3544 \newcommand{\purposeshead}{\clause{Test purposes}}
3545 % \end{macrocode}
3546 % \end{macro}
3547 %
3548 % \begin{macro}{\domainpurposehead}
3549 % Command to start a `Domain test purposes' clause.
3550 % \begin{macrocode}
3551 \newcommand{\domainpurposehead}{\sclause{Domain test purposes}}
3552 % \end{macrocode}
3553 % \end{macro}
3554 %
3555 % \begin{macro}{\aepurposehead}
3556 % Command to start a `Application element test purposes' clause.
3557 % \changes{v11}{1997/09/30}{Changed text of aepurposename command}
3558 % \begin{macrocode}
3559 \newcommand{\aepurposehead}{\sclause{Application element test purposes}}
3560 % \end{macrocode}
3561 % \end{macro}
3562 %
3563 % \begin{macro}{\apobjhead}
3564 % Command to start an application object clause.
3565 % Use as |\apobjhead{|\meta{Application object n}|}|.
3566 % \begin{macrocode}
3567 \newcommand{\apobjhead}[1]{\ssclause{#1}}
3568 % \end{macrocode}
3569 % \end{macro}
3570 %
3571 % \begin{macro}{\apasserthead}
3572 % Command to start an `Application assertions' clause.
3573 % \begin{macrocode}
3574 \newcommand{\apasserthead}{\ssclause{Application assertions}}
3575 % \end{macrocode}
3576 % \end{macro}
3577 %
3578 % \begin{macro}{\aimpurposehead}
3579 % Command to start a `AIM test purposes' clause.
3580 % \begin{macrocode}
3581 \newcommand{\aimpurposehead}{\sclause{AIM test purposes}}
3582 % \end{macrocode}
3583 % \end{macro}
3584 %
3585 % \begin{macro}{\aimenthead}
3586 % Command to start an AIM entity clause. Use as
3587 % |\aimenthead{|\meta{aim entity n}|}|.
3588 % \changes{v11}{1997/09/30}{Added aimenthead command}
3589 % \begin{macrocode}
3590 \newcommand{\aimenthead}[1]{\ssclause{#1}}
3591 % \end{macrocode}
3592 % \end{macro}
3593 %
3594 % \begin{macro}{\extrefpurposehead}
3595 % Command to start a `External reference test purposes' clause.
3596 % \begin{macrocode}
3597 \newcommand{\extrefpurposehead}{\sclause{External reference test purposes}}
3598 % \end{macrocode}
3599 % \end{macro}
3600 %
3601 % \begin{macro}{\implementpurposehead}
3602 % Command to start a `Implementation method test purposes' clause.
3603 % \begin{macrocode}
3604 \newcommand{\implementpurposehead}{\sclause{Implementation method test purposes}}
3605 % \end{macrocode}
3606 % \end{macro}
3607 %
3608 % \begin{macro}{\otherpurposehead}
3609 % Command to start an `Other test purposes' clause.
3610 % \changes{v11}{1997/09/30}{New otherpurposename and otherpurpose head commands}
3611 % \changes{v11}{1997/09/30}{Deleted rulepurposehead and rulepurpose commands}
3612 % \begin{macrocode}
3613 \newcommand{\otherpurposehead}{\sclause{Other test purposes}}
3614 % \end{macrocode}
3615 % \end{macro}
3616 %
3617 %
3618 % \begin{macro}{\gtpvchead}
3619 % Command to start a `General test purposes and verdict criteria' clause.
3620 % \begin{macrocode}
3621 \newcommand{\gtpvchead}{\clause{General test purposes and verdict criteria}}
3622 % \end{macrocode}
3623 % \end{macro}
3624 %
3625 % \begin{macro}{\generalpurposehead}
3626 % Commands to start a `General test purposes' clause.
3627 % \begin{macrocode}
3628 \newcommand{\generalpurposehead}{\sclause{General test purposes}}
3629 % \end{macrocode}
3630 % \end{macro}
3631 %
3632 % \begin{macro}{\gvcatchead}
3633 % Commands to start a `General verdict criteria for all test cases' clause.
3634 % \begin{macrocode}
3635 \newcommand{\gvcatchead}{\sclause{General verdict criteria for all abstract test cases}}
3636 % \end{macrocode}
3637 % \end{macro}
3638 %
3639 % \begin{macro}{\gvcprehead}
3640 % Commands to start a `General verdict criteria for preprocessor
3641 % abstract test cases' clause.
3642 % \changes{v11}{1997/09/30}{Changed gvcprepname and gvcprephead to gvcprename and gvcprehead}
3643 % \begin{macrocode}
3644 \newcommand{\gvcprehead}{\sclause{General verdict criteria for preprocessor
3645 abstract test cases}}
3646 % \end{macrocode}
3647 % \end{macro}
3648 %
3649 % \begin{macro}{\gvcposthead}
3650 % Commands to start a `General verdict criteria for postprocessor
3651 % abstract test cases' clause.
3652 % \begin{macrocode}
3653 \newcommand{\gvcposthead}{\sclause{General verdict criteria for postprocessor
3654 abstract test cases}}
3655 % \end{macrocode}
3656 % \end{macro}
3657 %
3658 % \begin{macro}{\atchead}
3659 % Commands to start a `Abstract test cases' clause.
3660 % \begin{macrocode}
3661 \newcommand{\atchead}{\clause{Abstract test cases}}
3662 % \end{macrocode}
3663 % \end{macro}
3664 %
3665 % \begin{macro}{\atctitlehead}
3666 % Command |\atctitlehead{|\meta{title}|}| to start a particular test
3667 % case clause.
3668 % \changes{v11}{1997/09/30}{New atctitlehead command}
3669 % \begin{macrocode}
3670 \newcommand{\atctitlehead}[1]{\sclause{#1}}
3671 % \end{macrocode}
3672 % \end{macro}
3673 %
3674 % \begin{macro}{\prehead}
3675 % Commands to start a `Preprocessor' clause.
3676 % \changes{v11}{1997/09/30}{New prehead and prepname commands}
3677 % \begin{macrocode}
3678 \newcommand{\prehead}{\ssclause{Preprocessor}}
3679 % \end{macrocode}
3680 % \end{macro}
3681 %
3682 % \begin{macro}{\posthead}
3683 % Command |\posthead{|\meta{title}|}| to start a `Postprocessor' clause.
3684 % \changes{v11}{1997/09/30}{New posthead command}
3685 % \changes{v1.5}{2001/07/16}{Changed \cs{posthead}}
3686 % \begin{macrocode}
3687 \newcommand{\posthead}[1]{\ssclause{Postprocessor}}
3688 % \end{macrocode}
3689 % \end{macro}
3690 %
3691 % \begin{macro}{\confclassannexhead}
3692 % Commands to start a `Conformance classes' annex.
3693 % \begin{macrocode}
3694 \newcommand{\confclassannexhead}{\normannex{Conformance classes}}
3695 % \end{macrocode}
3696 % \end{macro}
3697 %
3698 % \begin{macro}{\confclasshead}
3699 % Commands to start a `Conformance class N' clause. Us as
3700 % |\confclasshead{|\meta{number}|}|.
3701 % \begin{macrocode}
3702 \newcommand{\confclasshead}[1]{\sclause{Conformance class #1}}
3703 % \end{macrocode}
3704 % \end{macro}
3705 %
3706 % \begin{macro}{\postipfilehead}
3707 % Command to start a `Postprocessor input specification file names'
3708 % annex.
3709 % \changes{v11}{1997/09/30}{New postipfilename and postipfilehead commands}
3710 % \begin{macrocode}
3711 \newcommand{\postipfilehead}{\normannex{Postprocessor input specification file names}}
3712 % \end{macrocode}
3713 % \end{macro}
3714 %
3715 % \changes{v11}{1997/09/30}{New excludepurposename and excludepurposehead commands}
3716 % \changes{v1.5}{2001/07/16}{Deleted \cs{excludepurposehead}}
3717 %
3718 % \begin{macro}{\atsusagehead}
3719 % Command to start an `ATS Usage scenarios' annex.
3720 % \changes{v1.5}{2001/07/16}{Added \cs{atsusagehead}}
3721 % \begin{macrocode}
3722 \newcommand{\atsusagehead}{\infannex{Usage scenarios}}
3723 % \end{macrocode}
3724 % \end{macro}
3725 %
3726 %
3727 %
3728 %
3729 %
3730 % \subsection{Boilerplate printing}
3731 %
3732 % \begin{macro}{\atsintroendbp}
3733 % Print boilerplate for the end of ATS introduction clause.
3734 % \begin{macrocode}
3735 \newcommand{\atsintroendbp}{%
3736 \input{bpfats1}
3737 }
3738 % \end{macrocode}
3739 % \end{macro}
3740 % Here is the text of \file{bpfats1.tex}.
3741 % \changes{v11}{1997/09/30}{Changed boilerplate in atsendint.tex and renamed it bpfats1.tex}
3742 % \changes{v1.5}{2001/07/16}{Changed boilerplate in file bpfats1.tex}
3743 % \begin{macrocode}
3744 %</ats>
3745 %<*bpfats1>
3746 \ProvidesFile{bpfats1.tex}[2001/07/16 ATS end intro boilerplate]
3747 \typeout{bpfats1.tex [2001/07/16 ATS end intro boilerplate]}
3748
3749 The purpose of an abstract test suite is to provide a basis for
3750 evaluating whether a particular implementation of an application
3751 protocol actually conforms to the requirements of that application
3752 protocol. A standard abstract test suite helps ensure that
3753 evaluations of conformance are conducted in a consistent manner
3754 by different test laboratories.
3755
3756 This part of ISO~10303 specifies the abstract test suite for
3757 ISO 10303-\theAPpartno, application protocol \theAPtitle.
3758 The abstract test cases presented here are the basis for
3759 conformance testing of implentations of ISO 10303-\theAPpartno.
3760
3761 This abstract test suite is made up of two major parts:
3762 \begin{itemize}
3763 \item the test purposes, the specific items to be covered by
3764 conformance testing;
3765 \item the set of abstract test cases that meet those test purposes.
3766 \end{itemize}
3767
3768 The test purposes are statements of the application protocol
3769 requirements that are to be addressed by the abstract test cases.
3770 Test purposes are derived primarily from the application protocol's
3771 information requirements and AIM,
3772 as well as from other sources such as standards
3773 referenced by the application protocol and other requirements
3774 stated in the application protocol conformance requirements clause.
3775
3776 The abstract test cases address the test purpose by:
3777 \begin{itemize}
3778 \item specifying the requirements for input data to be used when
3779 testing an implementation of the application protocol;
3780 \item specifying the verdict criteria to be used when evaluating
3781 whether the implementation successfully converted the input
3782 data to a different form.
3783 \end{itemize}
3784
3785 The abstract test cases set the requirements for the
3786 executable test cases that are required to actually conduct
3787 a conformance test. Executable test cases contain the scripts,
3788 detailed values, and other explicit information required to
3789 conduct a conformance test on a specific implementation of
3790 the application protocol.
3791
3792 At the time of publication of this document, conformance
3793 testing requirements had been established for implementations
3794 of application protocols in combination with ISO 10303-21 and
3795 ISO 10303-22. This part of ISO 10303 only specifies
3796 test purposes and abstract test cases for a subset of such
3797 implementations.
3798
3799 For ISO 10303-21, two kinds of implementations, preprocessors and
3800 postprocessors, must be tested. Both of these are addressed in this
3801 abstract test suite.
3802
3803 For ISO 10303-22, a class of applications will possess the capability
3804 to upload and download AP-compliant SDAI-models or schema instances
3805 to and from applications that implement the SDAI. By providing test case
3806 data that correspond with SDAI-models, this abstract test suite addresses
3807 such applications in a single-schema scenario.
3808
3809 %</bpfats1>
3810 %<*ats>
3811 % \end{macrocode}
3812 %
3813 % \begin{macro}{\atsscopebp}
3814 % The boilerplate for the ATS scope clause.
3815 % \changes{v11}{1997/09/30}{New bpfats2.tex boilerplate file}
3816 % \begin{macrocode}
3817 \newcommand{\atsscopebp}{%
3818 \input{bpfats2}
3819 }
3820 % \end{macrocode}
3821 %
3822 % Here is the text of \file{bpfats2.tex}.
3823 % \begin{macrocode}
3824 %</ats>
3825 %<*bpfats2>
3826 \ProvidesFile{bpfats2.tex}[1997/09/30 ATS scope boilerplate]
3827 \typeout{bpfats2.tex [1997/09/30 ATS scope boilerplate]}
3828
3829 This part of ISO 10303 specifies the abstract test suite to be
3830 used in the conformance testing of implementations of
3831 ISO 10303-\theAPpartno.
3832 The following are within the scope of this part of ISO 10303:
3833 \begin{itemize}
3834 \item the specification of the test purposes associated with
3835 ISO 10303-\theAPpartno;
3836 \item the verdict criteria to be applied during conformance
3837 testing of an implementation of ISO 10303-\theAPpartno\
3838 using ISO 10303-21 or ISO 10303-22;
3839 \begin{anote}
3840 The verdict criteria are used to ascertain whether a test purpose
3841 has been satisfactorily met by an implementation under test (IUT)
3842 within the context of a given test case.
3843 \end{anote}
3844 \item the abstract test cases to be used as the basis for the
3845 executable test cases for conformance testing.
3846 \end{itemize}
3847
3848 The following are outside the scope of this part of ISO 10303:
3849 \begin{itemize}
3850 \item the creation of executable test cases;
3851 \item test specifications for tests other than conformance testing
3852 such as interoperability or acceptance testing;
3853 \item other implementation methods.
3854 \end{itemize}
3855
3856 %</bpfats2>
3857 %<*ats>
3858 % \end{macrocode}
3859 % \end{macro}
3860 %
3861 % \begin{macro}{\atspurposebp}
3862 % The boilerplate for the introduction to the Test purposes clause.
3863 % \changes{v11}{1997/09/30}{Changed atspurposebp boilerplate and arguments}
3864 % \changes{v1.5}{2001/07/16}{Changed \cs{atspurposebp} text}
3865 % \changes{v1.5}{2001/07/16}{Deleted parameters of \cs{atspurposebp}}
3866 % \begin{macrocode}
3867 \newcommand{\atspurposebp}{%
3868
3869 This clause specifies the test purposes for this part of ISO 10303.
3870 Clauses 4.1 and 4.2 are describe the source and meaning of test
3871 purposes that are derived from the information
3872 requirements defined in ISO 10303-\theAPpartno, clause 4, and the
3873 AIM \Express{} schema defined in ISO 10303-\theAPpartno, annex A.
3874 These test purposes are not repeated in this part of ISO~10303.
3875 However, through reference in a test case each specific element
3876 from the application elements of the AIM implicitly requires
3877 that the identified element, as specified in the test purpose statement,
3878 will be correctly instantiated by the implementation under test. \par
3879 }
3880
3881 % \end{macrocode}
3882 % \end{macro}
3883 %
3884 % \begin{macro}{\aetpbp}
3885 % Prints the boilerplate for the introduction to the Application
3886 % element test purposes clause.
3887 % \changes{v11}{1997/09/30}{Changes to text in file atsprpbp.tex and renamed it bpfats3.tex}
3888 % \changes{v1.5}{2001/07/16}{Changed text in file bpfats3.tex}
3889 % \begin{macrocode}
3890 \newcommand{\aetpbp}{%
3891 \input{bpfats3}
3892 }
3893 % \end{macrocode}
3894 % \end{macro}
3895 %
3896 % And here is the text of file \file{bpfats3.tex}.
3897 % \changes{v1.5}{2002/01/23}{Changed contents of file bpfats3.tex}
3898 % \begin{macrocode}
3899 %</ats>
3900 %<*bpfats3>
3901 \ProvidesFile{bpfats3.tex}[2002/01/23 ATS AE test purpose intro boilerplate]
3902 \typeout{bpfats3.tex [2002/01/23 ATS AE test purpose intro boilerplate]}
3903
3904 Application element (AE) test purposes are implicitly derived
3905 from the AP information requirements and are not explicitly documented
3906 here. AE test purposes apply to the input specifications of both
3907 preprocessr and postprocessor test cases. AE test purposes are implicitly
3908 derived from the AP information requirements as follows:
3909 \begin{itemize}
3910 \item Application objects (see ISO 10303-\theAPpartno, 4.2):
3911 a test purpose derived from an application object is a simple
3912 statement of the object's name;
3913
3914 \item Application object attributes (see ISO 10303-\theAPpartno, 4.2):
3915 test purposes derived from application object attributes are
3916 statements of the application object name with a specific attribute name;
3917
3918 \item Application assertions (see ISO 10303-\theAPpartno, 4.3):
3919 test purposes derived from application assertions are
3920 statements describing the relationships between two application objects.
3921 Application assertion test purposes address the directions of
3922 relationships as well as the number (cardinality) of relationships.
3923
3924 \end{itemize}
3925
3926
3927 They shall be interpreted as given in the
3928 following statement:
3929 %\begin{quotation}
3930 the IUT shall preserve the semantic associated with the unique
3931 application element from which the test purpose was implicitly derived.
3932 %\end{quotation}
3933 This implies that the semantics of the application element are
3934 preserved by the IUT between the input and output of a test,
3935 according to the reference path specified by the mapping
3936 \maptableorspec{}
3937 defined in ISO 10303-\theAPpartno, 5.1.
3938 \par
3939
3940
3941 %</bpfats3>
3942 %<*ats>
3943 % \end{macrocode}
3944 %
3945 % \begin{macro}{\aimtpbp}
3946 % A command to print the introductory boilerplate for an
3947 % AIM test purpose clause.
3948 % \changes{v11}{1997/09/30}{New aimtpbp command and file bpfats4.tex}
3949 % \begin{macrocode}
3950 \newcommand{\aimtpbp}{%
3951 \input{bpfats4}
3952 }
3953 % \end{macrocode}
3954 % \end{macro}
3955 %
3956 % And here is the text of file \file{bpfats4.tex}.
3957 % \changes{v1.5}{2001/07/16}{Changed text of file bpfats4.tex}
3958 % \changes{v1.5}{2002/01/23}{Changed text of file bpfats4.tex}
3959 % \begin{macrocode}
3960 %</ats>
3961 %<*bpfats4>
3962 \ProvidesFile{bpfats4.tex}[2002/01/23 ATS AIM test purpose intro boilerplate]
3963 \typeout{bpfats4.tex [2002/01/23 ATS AIM test purpose intro boilerplate]}
3964
3965 Test purposes are implicitly derived from the AP AIM \Express,
3966 and are not explicitly documented here. AIM test purposes are implicitly
3967 derived from the expanded \Express{} listing contained in
3968 annex~A of ISO 10303-\theAPpartno{} as follows:
3969 \begin{itemize}
3970 \item AIM entity data types: a test purpose derived from an AIM
3971 entity data type is a simple statement of the entity data type name;
3972
3973 \item AIM entity attributes: a test purpose derived from an AIM
3974 entity attribute is a statement of the AIM entity data type with
3975 a given attribute.
3976 \end{itemize}
3977
3978 Aim test purposes shall be interpreted as given in the
3979 following statement:
3980 %\begin{quotation}
3981 the postprocessor shall accept the input in accordance with the
3982 AIM \Express{} structure corresponding to this test purpose.
3983 %\end{quotation}
3984 This implies that the semantics of the application element
3985 represented by the AIM element are preserved by the IUT between
3986 the input and output of a test according to the reference path
3987 specified in the mapping
3988 \maptableorspec{}
3989 of the AP. This also implies
3990 no violations of any constraints (local rules or global
3991 rules) that apply to the AIM element. AIM test purposes apply
3992 to the input specifications of postprocessor test cases only.
3993 \par
3994
3995 %</bpfats4>
3996 %<*ats>
3997 % \end{macrocode}
3998 %
3999 % \begin{macro}{\atsimtpbp}
4000 % |\atsimptpbp| --- the boilerplate for the introduction to the
4001 % Implementation method test purposes clause.
4002 % \changes{v1.5}{2001/07/16}{Added \cs{atsimtpbp}}
4003 % \begin{macrocode}
4004 \newcommand{\atsimtpbp}{\input{bpfats14}}
4005
4006 % \end{macrocode}
4007 % \end{macro}
4008 %
4009 % And here is the text of file \file{bpfats14.tex}.
4010 % \changes{v1.5}{2001/07/16}{Added file bpfats14.tex}
4011 % \begin{macrocode}
4012 %</ats>
4013 %<*bpfats14>
4014 \ProvidesFile{bpfats14.tex}[2001/07/16 ATS implementation method test purpose intro boilerplate]
4015 \typeout{bpfats14.tex [2001/07/16 ATS implementation method test purpose intro boilerplate]}
4016
4017 The following test purpose is derived from requirements in
4018 ISO 10303-21 and applies to preprocessors only.
4019
4020 other1 The IUT correctly encodes the AIM schema name in the exchange
4021 structure.
4022
4023 The following test purposes are derived from requirements in
4024 ISO 10303-21 and apply to postprocessors only.
4025
4026 other2 The IUT interprets the ISO 10303-21 header section
4027 present in the exchange structure.
4028
4029 other3 The IUT interprets the ISO 10303-21 SCOPE and EXPORT constructs
4030 present in the exchange structure.
4031
4032 other4 The IUT interprets the ISO 10303-21 user-defined entity constructs
4033 present in the exchange structure.
4034
4035 other5 The IUT interprets various representations of numbers
4036 present in the exchange structure
4037 in accordance with ISO 10303-21.
4038
4039 other6 The IUT interprets various sequences of symbols
4040 present in the exchange structure
4041 in accordance with ISO 10303-21.
4042
4043 \par
4044
4045 %</bpfats14>
4046 %<*ats>
4047 % \end{macrocode}
4048 %
4049 % \begin{macro}{\atsgtpvcbp}
4050 % |\atsgtpvc| --- the boilerplate for the introduction to the
4051 % General test purposes and verdict criteria clause.
4052 % \changes{v11}{1997/09/30}{Put atsgtvcbp text into file bpfats5.tex}
4053 % \begin{macrocode}
4054 \newcommand{\atsgtpvcbp}{%
4055 \input{bpfats5}
4056 }
4057 % \end{macrocode}
4058 % \end{macro}
4059 %
4060 % Here is the text of file \file{bpfats5.tex}.
4061 % \begin{macrocode}
4062 %</ats>
4063 %<*bpfats5>
4064 \ProvidesFile{bpfats5.tex}[1997/09/30 ATS general verdict boilerplate]
4065 \typeout{bpfats5.tex [1997/09/30 ATS general verdict boilerplate]}
4066
4067 General test purposes are statements of requirements that apply
4068 to all abstract test cases, all preprocessor abstract test cases,
4069 or all postprocessor abstract test cases. General verdict criteria
4070 are the means for evaluating whether the general test purposes are
4071 met. General verdict criteria shall be evaluated as a part of every
4072 executable test case to which they apply. Each general verdict criterion
4073 includes a reference to its associated test purpose.
4074
4075 %</bpfats5>
4076 %<*ats>
4077 % \end{macrocode}
4078 %
4079 % \begin{macro}{\gtpbp}
4080 % Command to print the boilerplate introduction to General test
4081 % purposes clause.
4082 % \changes{v11}{1997/09/30}{New gtpbp command and file bpfats6.tex}
4083 % \begin{macrocode}
4084 \newcommand{\gtpbp}{%
4085 \input{bpfats6} }
4086 % \end{macrocode}
4087 % \end{macro}
4088 %
4089 % And here is the text of file \file{bpfats6.tex}
4090 % \changes{v1.5}{2001/07/16}{Changed text in file bpfats6.tex}
4091 % \begin{macrocode}
4092 %</ats>
4093 %<*bpfats6>
4094 \ProvidesFile{bpfats6.tex}[2001/07/16 ATS general test purpose boilerplate]
4095 \typeout{bpfats6.tex [2001/07/16 ATS general test purpose boilerplate]}
4096
4097 The following are the general test purposes for this part of
4098 ISO 10303:
4099
4100 g1 The output of an IUT shall preserve all the semantics defined by
4101 the input model according to the reference paths specified in the
4102 mapping \maptableorspec{} defined in clause~5 of ISO 10303-\theAPpartno.
4103
4104 g2 The output of a preprocessor shall conform to the implementation
4105 method to which the IUT claims conformance.
4106
4107 g3 The instances in the output of a preprocessor shall be encoded
4108 according to the mapping \maptableorspec{} and the AIM \Express{} long form
4109 defined in 5.1 and annex~A of ISO 10303-\theAPpartno.
4110
4111 g4 A postprocessor shall accept input data which is encoded according
4112 to the implementation method to which the IUT claims conformance.
4113
4114 g5 A postprocessor shall accept input data structured
4115 according to the mapping \maptableorspec{}
4116 and the AIM \Express{} long form
4117 defined in 5.1 and annex~A of ISO 10303-\theAPpartno.
4118
4119 \par
4120
4121 %</bpfats6>
4122 %<*ats>
4123 % \end{macrocode}
4124 %
4125 % \begin{macro}{\gvatcbp}
4126 % Command to print the boilerplate introduction to
4127 % {\em General verdict criteria} clause.
4128 % \changes{v11}{1997/09/30}{New bpfats7.tex file for gvatcbp command}
4129 % \begin{macrocode}
4130 \newcommand{\gvatcbp}{%
4131 \input{bpfats7} }
4132 % \end{macrocode}
4133 % \end{macro}
4134 %
4135 % And here is the text of file \file{bpfats7.tex}
4136 % \changes{v1.5}{2001/07/16}{Changed text in file bpfats7.tex}
4137 % \begin{macrocode}
4138 %</ats>
4139 %<*bpfats7>
4140 \ProvidesFile{bpfats7.tex}[2001/07/16 ATS general verdict criteria boilerplate]
4141 \typeout{bpfats7.tex [2001/07/16 ATS general verdict criteria boilerplate]}
4142
4143 The following verdict criteria apply to all abstract test cases
4144 contained in this part of ISO 10303:
4145
4146 gvc1 The semantics of the input model are preserved in the output of
4147 the IUT according to the reference paths specified in the mapping
4148 \maptableorspec{} defined in ISO 10303-\theAPpartno, clause 5 (g1).
4149
4150 \par
4151
4152 %</bpfats7>
4153 %<*ats>
4154 % \end{macrocode}
4155 %
4156 % \begin{macro}{\gvcprebp}
4157 % Command to print the boilerplate introduction to
4158 % {\em General verdict criteria for preprocessor } clause.
4159 % \changes{v11}{1997/09/30}{Replaced gvcpepbp command by gvcprebp}
4160 % \changes{v11}{1997/09/30}{New gvcprebp command and bpfats8.tex file}
4161 % \begin{macrocode}
4162 \newcommand{\gvcprebp}{%
4163 \input{bpfats8} }
4164 % \end{macrocode}
4165 % \end{macro}
4166 %
4167 % And here is the text of file \file{bpfats8.tex}
4168 % \changes{v1.5}{2001/07/16}{Changed text in file bpfats8.tex}
4169 % \begin{macrocode}
4170 %</ats>
4171 %<*bpfats8>
4172 \ProvidesFile{bpfats8.tex}[2001/07/16 ATS general verdict pre boilerplate]
4173 \typeout{bpfats8.tex [2001/07/16 ATS general verdict pre boilerplate]}
4174
4175 The following verdict criteria apply to all preprocessor
4176 abstract test cases contained in this part of ISO 10303:
4177
4178 gvc2 The output of a preprocessor conforms
4179 to the implementation method to which the IUT claims conformance (g2).
4180
4181 gvc3 The instances in the output of a preprocessor are encoded according
4182 to the AIM \Express{} long form and mapping \maptableorspec{}
4183 defined in ISO 10303-\theAPpartno, annex A and 5.1 (g3).
4184 \par
4185
4186 %</bpfats8>
4187 %<*ats>
4188 % \end{macrocode}
4189 %
4190 % \begin{macro}{\gvcpostbp}
4191 % Command to print the boilerplate introduction to
4192 % {\em General verdict criteria for postprocessor } clause.
4193 % \changes{v11}{1997/09/30}{New bpfats9.tex file for gvcpostbp command}
4194 % \begin{macrocode}
4195 \newcommand{\gvcpostbp}{%
4196 \input{bpfats9} }
4197 % \end{macrocode}
4198 % \end{macro}
4199 %
4200 % And here is the text of file \file{bpfats9.tex}
4201 % \changes{v1.5}{2001/07/16}{Changed text in file bpfats9.tex}
4202 % \begin{macrocode}
4203 %</ats>
4204 %<*bpfats9>
4205 \ProvidesFile{bpfats9.tex}[2001/07/16 ATS general verdict post boilerplate]
4206 \typeout{bpfats9.tex [2001/07/16 ATS general verdict post boilerplate]}
4207
4208 The following verdict criteria apply to all postprocessor
4209 abstract test cases contained in this part of ISO 10303:
4210
4211 gvc4 The postprocessor accepts input data which is encoded according
4212 to the implementation method to which the IUT claims conformance (g4).
4213
4214 gvc5 The postprocessor accepts input data which is structured according
4215 to the AIM \Express{} long form and mapping \maptableorspec{}
4216 defined in ISO 10303-\theAPpartno, annex A and 5.1 (g5).
4217 \par
4218
4219
4220 %</bpfats9>
4221 %<*ats>
4222 % \end{macrocode}
4223 %
4224 % \begin{macro}{\atcbp}
4225 % \begin{macro}{\atcbpii}
4226 % Commands to print boilerplate for {\em Abstract test cases} clause.
4227 % |\atcbp| prints the first paragraph.
4228 % \changes{v11}{1997/09/30}{New boilerplate for atcbp command}
4229 % \changes{v11}{1997/09/30}{New atcbpii command and file bpfats10.tex}
4230 % \changes{v1.5}{2001/07/16}{Changed text in \cs{atcbp}}
4231 % \begin{macrocode}
4232 \newcommand{\atcbp}{%
4233 This clause specifies the abstract test cases for this part of
4234 ISO 10303. Each abstract test case addresses one or more test purposes
4235 explicitly or implicitly specified in clause~4.
4236 \par
4237 }
4238
4239 % \end{macrocode}
4240 %
4241 % |\atcbpii| is for printing the major portion
4242 % of the boilerplate (paragraphs 3 onwards).
4243 % \changes{v1.5}{2001/07/16}{Deleted parameter of \cs{atcbpii}}
4244 % \changes{v1.5}{2001/07/16}{Changed body of \cs{atcbpii}}
4245 % \begin{macrocode}
4246 \newcommand{\atcbpii}{%
4247 \input{bpfats10}
4248 }
4249 % \end{macrocode}
4250 % \end{macro}
4251 % \end{macro}
4252 %
4253 % And here is the text of files \file{bpfats10.tex} and
4254 % \file{bpfats11.tex}.
4255 % \changes{v1.5}{2001/07/16}{Changed text in file bpfats10.tex}
4256 % \changes{v1.5}{2001/07/16}{Deleted file bpfats11.tex}
4257 % \begin{macrocode}
4258 %</ats>
4259 %<*bpfats10>
4260 \ProvidesFile{bpfats10.tex}[2001/07/16 ATS ats clause boilerplate]
4261 \typeout{bpfats10.tex [2001/07/16 ATS ats clause boilerplate]}
4262
4263 Each abstract test case has a subclause for the preprocessor
4264 test information and a subclause for each postprocessor
4265 input specification and related test information.
4266 The preprocessor and postprocessor input specifications
4267 are mirror images of each other: they represent the same
4268 semantic information. The preprocessor input model is presented
4269 in the form of a table with five columns:
4270 \begin{itemize}
4271 \item The Id column contains an identifier for the application object
4272 instantiated in a particular row. The identifier may be
4273 referenced as the value of an application assertion.
4274 The identifier is the lowest-level subclause number from
4275 ISO 10303-\theAPpartno, 4.2 where the application
4276 element that appears in that row of the table is specified.
4277
4278 \item The V column specifies whether or not the element in that
4279 row of the table is assigned a verdict in this test case.
4280 A blank indicates that it is not assigned a verdict in this test case.
4281 A `*' indicates that it is assigned a verdict
4282 using a derived verdict criteria. The derived verdict criteria
4283 determine whether the semantics associated with the application
4284 element are preserved in the output of the IUT according to
4285 the reference paths specified in the mapping table defined
4286 in ISO 10303-\theAPpartno, 5.1. A number in the V column references
4287 a specific verdict criterion defined in the verdict criteria
4288 section that follows the preprocessor input specification table.
4289
4290 \item The Application Elements column identifies the particular
4291 application element instance that is being
4292 defined by the table. For assertions the role is specified
4293 in parenthesis.
4294
4295 \item The Value column specifies a specific value for the application
4296 element. For application objects and attributes the value column
4297 defines the semantic value for that element's instance in the
4298 input model. A `\#$<$number$>$' in the column is a reference
4299 to an entity instance name in the postprocessor input specification
4300 where the corresponding value is specified. For assertions, this
4301 column holds a link to the related application object.
4302 A `$<$not\_present$>$' indicates that the
4303 application element is not present in the
4304 input model.
4305
4306 \item The Req column specifies whether the value in the Value column
4307 is mandatory (M), suggested (S) or constrained (C$<$n$>$), where `n'
4308 is an integer referencing a note that follows the table.
4309 A suggested value may be changed by the test realizer.
4310 A mandatory value may not be changed due to rules in \Express,
4311 rules in the mapping \maptableorspec, or the requirements of the test
4312 purpose being assigned a verdict. Each constrained value references
4313 a note labelled C$<$number$>$ at the end of the preprocessor
4314 input model table and may be modified according to specific
4315 constraints specified in it.
4316 \end{itemize}
4317
4318 The postprocessor input specifications are defined using
4319 ISO 10303-\theAPpartno. The values in the postprocessor specifications
4320 are suggested unless declared mandatory or constrained by the
4321 preprocessor input table.
4322
4323 The abstract test case specifies all the verdict criteria that are
4324 used to assign a verdict during testing. Special verdict criteria for
4325 preprocessor and postprocessor testing are defined explicitly in each
4326 abstract test case subclause. The relevant derived verdict criteria
4327 for preprocessor and postprocessor testing are identified in the V
4328 column of the preprocessor input table.
4329
4330 %</bpfats10>
4331 %<*ats>
4332 % \end{macrocode}
4333 %
4334 % \begin{macro}{\atcpretpc}
4335 % |\atcpretpc| prints the boilerplate for the Preprocessor Test Purposes
4336 % Covered subclause.
4337 % \changes{v1.5}{2001/07/16}{Added \cs{atcpretpc}}
4338 % \begin{macrocode}
4339 \newcommand{\atcpretpc}{%
4340 \input{bpfats11}
4341 }
4342
4343 % \end{macrocode}
4344 % \end{macro}
4345 %
4346 % Here is the text of \file{bpfats11.tex}.
4347 % \changes{v1.5}{2001/07/16}{Added file bpfats11.tex}
4348 % \begin{macrocode}
4349 %</ats>
4350 %<*bpfats11>
4351 \ProvidesFile{bpfats11.tex}[2001/07/16 ATS preprocessor purposes covered boilerplate]
4352 \typeout{bpfats11.tex [2001/07/16 ATS preprocessor purposes covered boilerplate]}
4353
4354 In the preprocessor input specification table of this test case, the
4355 numbers in the Id column (ignoring the part beyond the decimal point, if any)
4356 whose rows are not empty in the V column identify the application objects
4357 that are covered by this test case. These Id numbers refer directly to
4358 the subclause numbers within ISO 10303-\theAPpartno, 4.2, where the
4359 application object is defined.
4360 \par
4361
4362 %</bpfats11>
4363 %<*ats>
4364 % \end{macrocode}
4365 %
4366 % \begin{macro}{\atcposttpc}
4367 % |\atcposttpc| prints boilerplate for the Postprocessor Test Purposes
4368 % Covered subclause.
4369 % \changes{v1.5}{2001/07/16}{Added \cs{atcposttpc}}
4370 % \begin{macrocode}
4371 \newcommand{\atcposttpc}{%
4372 \input{bpfats12}
4373 }
4374
4375 % \end{macrocode}
4376 % \end{macro}
4377 %
4378 % Here is the text of \file{bpfats12.tex}.
4379 % \changes{v1.5}{2001/07/16}{Added file bpfats12.tex}
4380 % \begin{macrocode}
4381 %</ats>
4382 %<*bpfats12>
4383 \ProvidesFile{bpfats12.tex}[2001/07/16 ATS postprocessor purposes covered boilerplate]
4384 \typeout{bpfats12.tex [2001/07/16 ATS postprocessor purposes covered boilerplate]}
4385
4386 In the postprocessor input specification table of this test case, the
4387 numbers in the Id column (ignoring the part beyond the decimal point, if any)
4388 whose rows are not empty in the V column identify the application objects
4389 that are covered by this test case. These Id numbers refer directly to
4390 the subclause numbers within ISO 10303-\theAPpartno, 4.2, where the
4391 application object is defined.
4392 \par
4393
4394 %</bpfats12>
4395 %<*ats>
4396 % \end{macrocode}
4397 %
4398 %
4399 %
4400 % \begin{macro}{\confclassbp}
4401 % \begin{macro}{\atsnoclassesbp}
4402 % |\confclassbp{|\meta{number}|}| prints the boilerplate for the
4403 % start of a {\em Conformance class} clause.
4404 %
4405 % |\atsnoclassesbp| --- the boilerplate for the Confomance class
4406 % annex when the AP has no conformance classes.
4407 % \begin{macrocode}
4408 \newcommand{\confclassbp}[1]{%
4409
4410 To conform to conformance class #1 of ISO 10303-\theAPpartno,
4411 an implementation shall pass executable versions of the following
4412 abstract test cases: }
4413 \newcommand{\atsnoclassesbp}{%
4414 Conformance to ISO 10303-\theAPpartno\ is defined only in terms
4415 of the entire AP. Therefore, conformance requires that an
4416 implementation pass executable versions of all abstract
4417 test cases in clause 6. }
4418 % \end{macrocode}
4419 % \end{macro}
4420 % \end{macro}
4421 %
4422 % \begin{macro}{\pisfbp}
4423 % Prints the boilerplate for the start of a {\em Postprocessor input
4424 % specification file names} annex.
4425 % \changes{v11}{1997/09/30}{New pisfbp command}
4426 % \changes{v1.5}{2001/07/16}{Major changes to \cs{pisfb}, and added three parameters}
4427 % \begin{macrocode}
4428 \newcommand{\pisfbp}[3]{\par
4429 This annex references a listing of the postprocessor input
4430 specifications for this part of ISO~10303 without comments or other
4431 explanatory text. These specifications are documented using
4432 ISO 10303-#1. These specifications are available in
4433 computer-interpretable form and can be found at the following URL:
4434 \begin{center}
4435 \isourl{#2}
4436 \end{center}
4437
4438 If there is difficulty accessing this site contact the ISO Central
4439 Secretariat or contact the ISO TC184/SC4 Secretariat directly at:
4440 \url{[email protected]}.
4441
4442 The postprocessor input specifications for each test case is supplied
4443 electronically via the Internet. Table~#3 lists
4444 the file name of the postprocessor input specification that is
4445 associated with the postprocessor subclause(s) of a test case.
4446 \par
4447 %%% \input{bpfats13}
4448 }
4449
4450 % \end{macrocode}
4451 % \end{macro}
4452 %
4453 % Here is the text of \file{bpfats13.tex}.
4454 % \changes{v1.5}{2001/07/16}{Added file bpfats13.tex}
4455 % \begin{macrocode}
4456 %</ats>
4457 %<*bpfats13>
4458 \ProvidesFile{bpfats13.tex}[2001/07/16 ATS postprocessor annex (B) boilerplate]
4459 \typeout{bpfats13.tex [2001/07/16 ATS postprocessor annex (B) boilerplate]}
4460
4461 This annex references a listing of the postprocessor input
4462 specifications for this part of ISO~10303 without comments or other
4463 explanatory text. These specifications are documented using
4464 ISO 10303-\atstempa. These specifications are available in
4465 computer-interpretable form and can be found at the following URL:
4466 \begin{center}
4467 \isourl{\atstempb}
4468 \end{center}
4469
4470 If there is difficulty accessing this site contact the ISO Central
4471 Secretariat or contact the ISO TC184/SC4 Secretariat directly at:
4472 \url{[email protected]}.
4473
4474 The postprocessor input specifications for each test case is supplied
4475 electronically via the Internet. Table~\atstempc{} lists
4476 the file name of the postprocessor input specification that is
4477 associated with the postprocessor subclause(s) of a test case.
4478
4479
4480 %</bpfats13>
4481 %<*ats>
4482 % \end{macrocode}
4483 %
4484 %
4485 % The end of this package.
4486 % \begin{macrocode}
4487 %</ats>
4488 % \end{macrocode}
4489 %
4490 % \bibliographystyle{alpha}
4491 %
4492 % \begin{thebibliography}{GMS94}
4493 %
4494 % \bibitem[GMS94]{GOOSSENS94}
4495 % Michel Goossens, Frank Mittelbach, and Alexander Samarin.
4496 % \newblock {\em The LaTeX Companion}.
4497 % \newblock Addison-Wesley Publishing Company, 1994.
4498 %
4499 % \bibitem[ISO97]{ISOD397}
4500 % {\em {ISO/IEC Directives Part 3 --- Drafting and presentation of International
4501 % Standards}}, third edition, 1997.
4502 %
4503 % \bibitem[Sec97a]{SC4N536}
4504 % SC4 Secretariat.
4505 % \newblock {\em {Guidelines for the development of abstract test suites}}.
4506 % \newblock ISO TC184/SC4/WG6 Document N536, March 1997.
4507 % \newblock (Available from NIST, Gaithersburg, MD 20899.).
4508 %
4509 % \bibitem[Sec97b]{SD537}
4510 % SC4 Secretariat.
4511 % \newblock {\em {Supplementary directives for the drafting and presentation of
4512 % ISO 10303}}.
4513 % \newblock ISO TC184/SC4 Document N537, March 1997.
4514 % \newblock (Available from NIST, Gaithersburg, MD 20899.).
4515 %
4516 % \bibitem[Wil96a]{PRW96j}
4517 % Peter~R. Wilson.
4518 % \newblock {\em {LaTeX files for Typesetting ISO Standards: Source code}}.
4519 % \newblock NIST Report NISTIR, June 1996.
4520 %
4521 % \bibitem[Wil96b]{PRW96i}
4522 % Peter~R. Wilson.
4523 % \newblock {\em {LaTeX for standards: The LaTeX package files user manual}}.
4524 % \newblock NIST Report NISTIR, June 1996.
4525 %
4526 % \bibitem[Wil96c]{PRW96k}
4527 % Peter~R. Wilson.
4528 % \newblock {\em {LaTeX package files for ISO 10303: User manual}}.
4529 % \newblock NIST Report NISTIR, June 1996.
4530 %
4531 % \end{thebibliography}
4532 %
4533 %
4534 %
4535 % \Finale
4536 \endinput
4537 %
4538 %% \CharacterTable
4539 %% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
4540 %% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
4541 %% Digits \0\1\2\3\4\5\6\7\8\9
4542 %% Exclamation \! Double quote \" Hash (number) \#
4543 %% Dollar \$ Percent \% Ampersand \&
4544 %% Acute accent \' Left paren \( Right paren \)
4545 %% Asterisk \* Plus \+ Comma \,
4546 %% Minus \- Point \. Solidus \/
4547 %% Colon \: Semicolon \; Less than \<
4548 %% Equals \= Greater than \> Question mark \?
4549 %% Commercial at \@ Left bracket \[ Backslash \\
4550 %% Right bracket \] Circumflex \^ Underscore \_
4551 %% Grave accent \` Left brace \{ Vertical bar \|
4552 %% Right brace \} Tilde \~}
4553 %
4554