CONTENTS Title Page Copyright Page Information Map Information Table Preface Technical Changes and New Features 1 Application Definition Utility Commands 1.1 Explanations of Reference Page Terminology 1.2 Command Summary 1.3 Common ADU Command Qualifiers 1.4 @ (At sign) Command (ADU>) 1.5 ATTACH (ADU>) 1.6 BUILD (ADU>) 1.7 CONVERT (ADU>) 1.8 COPY (ADU>) 1.9 CREATE (ADU>) 1.10 DELETE (ADU>) 1.11 DUMP (ADU>) 1.12 EDIT (ADU>) 1.13 EXIT Command (ADU>) 1.14 HELP (ADU>) 1.15 LIST (ADU>) 1.16 MODIFY (ADU>) 1.17 REPLACE (ADU>) 1.18 SAVE (ADU>) 1.19 SET DEFAULT (ADU>) 1.20 SET LOG (ADU>) 1.21 SET VERIFY (ADU>) 1.22 SHOW DEFAULT (ADU) 1.23 SHOW LOG (ADU>) 1.24 SHOW VERSION (ADU>) 1.25 SPAWN (ADU>) 2 %INCLUDE 2.1 %INCLUDE 3 Task Definition Clauses 3.1 Multiple-Step Task Definitions 3.2 Nested Blocks 3.3 Block Step Phrases 3.4 Block Conditional Clauses 3.5 Exchange Step Clauses 3.6 Processing Step Phrases and Clauses 3.7 Step Labels 3.8 Action Clauses 3.9 Exception Handler Action Clauses 3.10 Boolean Expressions 3.10.1 Relational Expressions 3.10.2 Types of Boolean Expressions 3.10.3 Relational Operators 3.10.4 Boolean Operators and Associativity 3.10.5 Precedence 3.10.6 Parentheses 3.10.7 Comparisons 3.11 I/O Restrictions for Distributed Processing 3.12 BLOCK Clause (Block) 3.13 CALL Clause (Processing) 3.14 CALL TASK Clause (Processing) 3.15 CANCEL ACTION Phrase (Block) 3.16 CANCEL TASK Clause (Action) 3.17 CANCELABLE Clause (Task) 3.18 COMMIT TRANSACTION Clause (Action) 3.19 CONTROL FIELD Clause (Block, Exchange, Processing, Action) 3.20 DATATRIEVE COMMAND Clause (Processing) 3.21 DCL COMMAND Clause (Processing) 3.22 DEFAULT FORM Clause (Task) 3.23 DEFAULT REQUEST LIBRARY Clause (Task) 3.24 DEFAULT SERVER Clause (Task) 3.25 DELAY Clause (Task) 3.26 EXCEPTION HANDLER Clause (BLOCK, EXCHANGE, PROCESSING) 3.27 EXCHANGE Clause (Block) 3.28 EXIT BLOCK Clause (Action) 3.29 EXIT TASK Clause (Action) 3.30 FORM I/O Phrase (Block) 3.31 GET ERROR MESSAGE Clause (Action) 3.32 GLOBAL Clause (Task) 3.33 GOTO STEP Clause (Action) 3.34 IF THEN ELSE Clause (Block, Exchange, Processing, Action) 3.35 IMAGE Clause (Processing) 3.36 LOCAL Clause (Task) 3.37 MOVE Clause (Action) 3.38 NO EXCHANGE Clause (Exchange) 3.39 NO PROCESSING Clause (Processing) 3.40 NO SERVER CONTEXT ACTION Clause (Action) 3.41 NO TERMINAL I/O Phrase (Block, Processing) 3.42 NONPARTICIPATING SERVER Phrase (Processing) 3.43 PROCESSING Clause (Task) 3.44 RAISE EXCEPTION Clause (Action) 3.45 READ Clause (Exchange) 3.46 RECEIVE Clause (Exchange) 3.47 RELEASE SERVER CONTEXT Clause (Action) 3.48 REPEAT STEP Clause (Action) 3.49 REQUEST Clause (Exchange) 3.50 REQUEST I/O Phrase (Block, Processing) 3.51 RETAIN SERVER CONTEXT Clause (Action) 3.52 ROLLBACK TRANSACTION Clause (Action) 3.53 SELECT FIRST Clause (Block, Exchange, Processing, Action) 3.54 SEND Clause (Exchange) 3.55 SERVER CONTEXT Phrase (Block) 3.56 STREAM I/O Phrase (Block) 3.57 TASK ARGUMENTS Phrase (Task) 3.58 TERMINAL I/O Phrase (Processing) 3.59 TRANSACTION Phrase (Block, Processing) 3.60 TRANSCEIVE Clause (Exchange) 3.61 USE WORKSPACE Clause (Task) 3.62 WAIT Clause (Task) 3.63 WHILE DO Clause (Block, Exchange, Processing) 3.64 WORKSPACES Clause (Task) 3.65 WRITE Clause (Exchange) 4 Task Group Definition Clauses 4.1 Task Group Clauses 4.2 Processing Subclauses 4.3 Server Subclauses 4.4 ALWAYS EXECUTE TERMINATION PROCEDURE Subclause (Server) 4.5 CALL Subclause (Processing) 4.6 CANCEL PROCEDURE Subclause (Server) 4.7 DATATRIEVE COMMAND Subclause (Processing) 4.8 DCL COMMAND Subclause (Processing) 4.9 DCL PROCESS Subclause (Server) 4.10 DEFAULT OBJECT FILE Subclause (Server) 4.11 DEFAULT TASK GROUP FILE Clause (Task Group) 4.12 DYNAMIC USERNAME Subclause (Server) 4.13 FIXED USERNAME Subclause (Server) 4.14 FORMS Clause (Task Group) 4.15 IMAGE Subclause (Processing) 4.16 INITIALIZATION PROCEDURE Subclause (Server) 4.17 MESSAGE FILES Clause (Task Group) 4.18 PROCEDURE SERVER IMAGE Subclause (Server) 4.19 PROCEDURES Subclause (Server) 4.20 REQUEST LIBRARIES Clause (Task Group) 4.21 REUSABLE Subclause (Server) 4.22 RUNDOWN ON CANCEL Subclause (Server) 4.23 SERVERS Clause (Task Group) 4.24 TASKS Clause (Task Group) 4.25 TERMINATION PROCEDURE Subclause (Server) 4.26 USERNAME Subclause (Server) 4.27 WORKSPACES Clause (Task Group) 5 Application Definition Clauses 5.1 Application Definition Clauses 5.2 Server Subclauses 5.3 Task Subclauses 5.4 ACCESS Subclause (Task) 5.5 APPLICATION DEFAULT DIRECTORY Clause (Application) 5.6 APPLICATION LOGICALS Clause (Application) 5.7 APPLICATION NAME TABLES Clause (Application) 5.8 APPLICATION USERNAME Clause (Application) 5.9 AUDIT Clause (Application, Server, Task) 5.10 CANCELABLE Subclause (Task) 5.11 CREATION DELAY Subclause (Server) 5.12 CREATION INTERVAL Subclause (Server) 5.13 DEFAULT APPLICATION FILE Clause (Application) 5.14 DEFAULT DIRECTORY Subclause (Server) 5.15 DELAY Subclause (Task) 5.16 DELETION DELAY Subclause (Server) 5.17 DELETION INTERVAL Subclause (Server) 5.18 DISABLE Subclause (Task) 5.19 DYNAMIC USERNAME Subclause (Server) 5.20 ENABLE Subclause (Task) 5.21 FIXED USERNAME Subclause (Server) 5.22 GLOBAL Subclause (Task) 5.23 LOCAL Subclause (Task) 5.24 LOGICALS Subclause (Server) 5.25 MAXIMUM SERVER PROCESSES Clause (Application, Server) 5.26 MAXIMUM TASK INSTANCES Clause (Application) 5.27 MINIMUM SERVER PROCESSES Subclause (Server) 5.28 NAME TABLES Subclause (Server) 5.29 PROTECTED WORKSPACES Subclause (Server) 5.30 SERVER ATTRIBUTES Clause (Application) 5.31 SERVER DEFAULTS Clause (Application) 5.32 SERVER MONITORING INTERVAL Clause (Application) 5.33 SERVER PROCESS DUMP Subclause (Server) 5.34 TASK ATTRIBUTES Clause (Application) 5.35 TASK DEFAULTS Clause (Application) 5.36 TASK GROUPS Clause (Application) 5.37 TRANSACTION TIMEOUT Subclause (Task) 5.38 USERNAME Subclause (Server) 5.39 WAIT Subclause (Task) 6 Menu Definition Clauses 6.1 Application Specifications 6.2 Writing Menu Definitions for Distributed Applications 6.3 CONTROL TEXT Clause (Menu) 6.4 DEFAULT APPLICATION Clause (Menu) 6.5 DEFAULT MENU FILE Clause (Menu) 6.6 DELAY Subclause (Optional ENTRIES) 6.7 ENTRIES Clause (Menu) 6.8 HEADER Clause (Menu) 6.9 MENU Subclause (Required ENTRIES) 6.10 REQUEST Clause (Menu) 6.11 TASK Subclause (Required ENTRIES) 6.12 TEXT Subclause (Optional ENTRIES) 6.13 WAIT Subclause (Optional ENTRIES) 7 Declining Task Definition Clauses 7.1 COMMIT Clause (Action) 7.2 CONTINUE ON BAD STATUS Phrase (Processing) 7.3 DBMS RECOVERY Phrase (Block, Processing) 7.4 GOTO TASK Clause (Action) 7.5 NO RECOVERY UNIT ACTION Clause (Action) 7.6 RDB RECOVERY Phrase (Block, Processing) 7.7 REPEAT TASK Clause (Action) 7.8 RETAIN RECOVERY UNIT Clause (Action) 7.9 RMS RECOVERY Phrase (Block, Processing) 7.10 ROLLBACK Clause (Action) 7.11 SQL RECOVERY Phrase (Block, Processing) A ADU Error Messages B Summary of ACMS System Workspaces B.1 ACMS$PROCESSING_STATUS System Workspace B.2 ACMS$SELECTION_STRING System Workspace B.3 ACMS$TASK_INFORMATION System Workspace EXAMPLES 3-1 Simple Task Definition (Single-Step) 3-2 More Complex Task Definition (Multiple-Step) 3-3 Task Definition with Nested Blocks 4-1 Simple Task Group Definition 4-2 Simple Task Group Definition for Multiple-Step Tasks 4-3 More Complex Task Group Definition 5-1 Application Definition 5-2 Example of SERVER ATTRIBUTES and SERVER DEFAULTS Clauses 5-3 Example of TASK ATTRIBUTES and TASK DEFAULTS Clauses 5-4 Application Definition Using Multiple TASK DEFAULTS 6-1 Sample Menu Definition 6-2 Example of a Menu with a Remote Task FIGURES 3-1 Task Syntax 3-2 Block Step Structure 3-3 Nested Block Arrangement 3-4 Structure of Block Step Syntax 3-5 Block Step Phrases Syntax 3-6 Block Conditional Clauses Syntax 3-7 Block Conditional Clauses with a Nested Block 3-8 Exchange Step Clause Syntax 3-9 Processing Step Syntax 3-10 Action Syntax 3-11 GOTO STEP Clauses in a Nested Blocks Structure 4-1 Task Group Syntax 4-2 Processing Subclauses Syntax 4-3 Server Subclauses Syntax 5-1 Application Definition Syntax 5-2 SERVER ATTRIBUTES Clause Syntax 5-3 SERVER DEFAULTS Clause Syntax 5-4 TASK ATTRIBUTES Clause Syntax 5-5 TASK DEFAULTS Clause Syntax 6-1 Menu Definition Syntax TABLES 1-1 Summary of ADU Commands 3-1 Task Clauses 3-2 Block Step Phrases 3-3 Block Conditional Clauses 3-4 Exchange Step Clauses 3-5 Processing Step Phrases 3-6 Processing Step Clauses 3-7 Action Clauses 3-8 Relational Operators 3-9 Boolean Precedence 3-10 I/O Attributes for Distributed Processing 3-11 Clauses Compatible with the CONTROL FIELD Clause 3-12 Action Clauses Compatible with the CONTROL FIELD Clause 3-13 Clauses Compatible with the IF THEN ELSE Clause 3-14 Action Clauses Compatible with the IF THEN ELSE Clause 3-15 Clauses Compatible with the SELECT FIRST Clause 3-16 Action Clauses Compatible with the SELECT FIRST Clause 3-17 Default Server Context Actions 3-18 Default Server Context Actions (Distributed Transactions) 3-19 Default Transaction Actions 3-20 Clauses Compatible with the WHILE DO Clause 4-1 Task Group Clauses 4-2 Processing Subclauses 4-3 Server Subclauses 4-4 Server Process Rundown Actions 5-1 Application Definition Clauses 5-2 Server Subclauses 5-3 Task Subclauses 6-1 Menu Definition Clauses 7-1 Default Recovery Actions 7-2 Default Recovery Actions 7-3 Default Recovery Actions 7-4 Default Recovery Actions B-1 Fields in ACMS$PROCESSING_STATUS B-2 Fields in ACMS$SELECTION_STRING B-3 Fields in ACMS$TASK_INFORMATION