Compaq ACMS for OpenVMS
Writing Applications

Appendix B

Appendix B Changing the ACMS Menu Format Using TDMS

     B.1     Modifying the Menu Format Using ACMS

     B.2     Modifying the ACMS Menu Using TDMS Requests

         B.2.1         Getting the ACMS Menu Request and Form

         B.2.2         Modifying the Menu Form Only

         B.2.3         Forms, Records, and Keypad Used by the Menu Request

         B.2.4         Instructions Performed by TDMS When ACMS Calls a Request

         B.2.5         Modifying the Menu Request

         B.2.6         Using the REQUEST Clause

         B.2.7         Changing the MENU_ENTRY_RECORD

         B.2.8         Modifying and Building the ACMS Menu Request Library

     B.3     Disabling the SELECT Command in the ACMS Command Menu

Appendix C

Appendix C Using CDO for Pieces Tracking

     C.1     Overview of Dictionary Object Types

     C.2     Creating Relationships Between Entities

Appendix D

Appendix D Using LSE with ACMS

     D.1     Using LSE with ACMS

     D.2     Creating ACMS Source Files with LSE

         D.2.1         Using Placeholders and Tokens in LSE

         D.2.2         Creating the Final Source File

             D.2.2.1             Syntax Differences

             D.2.2.2             Exiting Editing Mode

     D.3     Compiling Definitions with LSE COMPILE

     D.4     Examining Diagnostic Messages with LSE REVIEW

         D.4.1         Generating the Diagnostics File

         D.4.2         Examining the Diagnostics File with LSE REVIEW

     D.5     Using HELP in LSE

Appendix E

Appendix E Request Interface Kit Components

     E.1     Application Independent Modules

     E.2     RI Sample Application

         E.2.1         RI Sample Application Source Modules

         E.2.2         RI Sample Application Run-Time Files

     E.3     FMS Sample Application

         E.3.1         FMS Sample Application Source Modules

         E.3.2         FMS Sample Application Run-Time Files

Appendix F

Appendix F Modifying the FMS Menu Interface

Appendix G

Appendix G Accessing ACMS Applications from Windows NT Clients

     G.1     Access By NT Clients

     G.2     TP Web Connector Gateway Components

         G.2.1         ADU Extension

         G.2.2         Gateway

     G.3     Running ADU Extension

         G.3.1         Group Task Translation

             G.3.1.1             BUILD GROUP Command

             G.3.1.2             Translation Actions

         G.3.2         Application Group Translation

             G.3.2.1             BUILD APPLICATION Command

             G.3.2.2             Translation Actions

             G.3.2.3             Using Translation Output

         G.3.3         Restrictions

         G.3.4         Converting Records

         G.3.5         Data Type Translation

             G.3.5.1             Integer Support

             G.3.5.2             Floating Point and Complex Support

             G.3.5.3             Decimal Support

             G.3.5.4             Other Support

         G.3.6         Translating Another Record

Appendix H

Appendix H Checklist of References to Platform-Specific Files

     H.1     Task Group Definition

     H.2     ADU BUILD GROUP Command

Appendix I

Appendix I Common Errors

     I.1     ADU

     I.2     Task Debugger

     I.3     Application Startup

     I.4     Task Execution

Index

Index

Examples

1-1 A Sample ADUINI.COM File

1-2 SET VERIFY Display

1-3 REPLACE Command in a Source Definition File

2-1 Definition of ADD_RESERVE_WKSP Fields

2-2 Contents of a Source Definition File

2-3 Complete Definition for the Add Car Reservation Task

2-4 Definition for RENTAL_CLASSES_WKSP

2-5 Complete Definition of the Review Car Rates Task

2-6 Record Description for REVIEW_RESERVATION_WORKSPACE

2-7 Complete Definition of Review Reservation Task

2-8 Definition for RESERVE_WKSP Workspace

2-9 Record Description for RESERVE_SHADOW_WKSP Workspace

2-10 Complete Definition of Review Update Task

3-1 Example of an Escape Unit

4-1 Record Definition for ADD_RESERVE_WKSP

4-2 Task Definition for Add Car Reservation Task

4-3 Definition for the ACMS$SELECTION_STRING Workspace

4-4 Definition for Display Basic Task

4-5 Record Definition for GROUP_WORKSPACE

4-6 Complete Definition for the Get Initial Value Task

4-7 Definition for Labor Reporting Task

4-8 Record Definition for DISPLAY_USER_WKSP

4-9 Definition for Display Basic Task with User Workspace

4-10 Moving Data to a Workspace Field

5-1 Task ENTER_ORDER

5-2 Task PROCESS_ORDER_LINE

5-3 Procedure WRITE_ORDER_LINE (in BASIC)

5-4 Updating User and Group Workspaces

5-5 Passing User Workspaces to Menu Tasks

5-6 Passing Data to a Called Task

5-7 Returning Your Own Exit and Cancel Status Values

5-8 MAIN_MENU Task

6-1 Audit Message for Starting a Detached Task

6-2 Audit Message for Exceeding the Retry Limit

6-3 ACMS/SHOW TASK Message for Detached Tasks

6-4 ACMS/SHOW APPLICATION/DETACHED_TASKS Message

6-5 Audit Messages for a Detached Task Canceled by a System Operator

6-6 Audit Message for a Task Failure that Is Not Retried

6-7 Broadcast Message for a Detached Task that Exceeded the Retry Limit

7-1 Distributed Transaction on a Nested Block Step

7-2 Multiple Database Updates in a Distributed Transaction

7-3 Calling a Task to Participate in a Distributed Transaction

7-4 Complete Definition of the VR_COMPLETE_CHECKOUT_TASK

7-5 VR_FAST_CHECKIN_TASK with Nonparticipating Processing Steps

8-1 RAISE EXCEPTION Clause in a Processing Step

8-2 Performing Exception Handling in a Task

8-3 Recovering from a DECforms Time-Out Exception

8-4 Recovering from an Exception Raised in a Called Task

8-5 Recovering from a Transaction Exception

8-6 Canceling a Task without Calling Server Cancel Procedures

9-1 Sample QTI Audit Entry

9-2 A Task That Dequeues from an Error Queue

9-3 A Dequeue Procedure

9-4 An Enqueue Procedure

9-5 C Agent that Starts a Distributed Transaction

9-6 VR_FAST_CHECKIN_TASK Definition

9-7 Enqueuing Routine

9-8 VR_COMP_FAST_CHKIN_TASK Definition

10-1 Definition of VR_READ_SERVER

10-2 Definition of Department Task Group

11-1 Personnel Application Definition

11-2 Application Definition Using TASK DEFAULTS

11-3 Application Definition Using Multiple TASK DEFAULTS

11-4 Application Using TASK ATTRIBUTES and TASK DEFAULTS

11-5 Enabling and Disabling Tasks in the Application Definition

11-6 Using TRANSACTION TIMEOUT in the Application Definition

11-7 Application Definition Using Server Defaults

11-8 Application Using Multiple Server Defaults Clauses

12-1 Menu Definition for the Personnel Menu

12-2 Example of a Menu with a Remote Task

13-1 A Task Group Definition

14-1 Simple Inquiry Task

14-2 Task Group Definition

14-3 FORTRAN User Request Procedure

14-4 TDMS Request

14-5 FORTRAN Initialization Procedure

14-6 Example of Audit Trail Error Messages

14-7 FORTRAN Cancel Procedure

14-8 REQPROCS.OPT Options File on VAX

14-9 REQPROCS.OPT Options File on Alpha

14-10 Linking Shareable Images and Using an Options File

14-11 FMS Initialization Procedure

14-12 FMS Menu Procedure

14-13 Example Application Definition

A-1 Definition for ACMS Menu Header

A-2 Definition for Menu Entries Record

A-3 Definition for Menu Control

A-4 Definition for Menu Selection Record

A-5 Control Text Response Found Record

A-6 Panel Definition

A-7 Default Panel Field Definition

A-8 Command Panel Field Definition

A-9 Record Group SELECT_LINE_GROUP

A-10 SELECTION_STRING Record Groups

A-11 SELECTION_STRING Panel Definitions

A-12 ENTRIES Record Group

A-13 ENTRIES Record in Default Panel Definition

A-14 Menu Definition Specifying Entries per Screen

A-15 Command Line Recall Buffer Definitions

A-16 Definition of Default Screen Layout

A-17 Menu Definition Using CONTROL TEXT

B-1 MENU_REQUEST Definition

B-2 Definition for ACMS Menu Header Record

B-3 Definition for Menu Entry Record

B-4 Definition for Menu Control

B-5 Definition for Menu Selection Record

B-6 Customized Menu Request

B-7 Menu Definition Using REQUEST Clause

B-8 Record Definition for MENU_ENTRY_RECORD with 12 Entries

B-9 MENU_LIBR Request Library Definition

D-1 LSEDIT.COM File

Appendix B
Appendix B	Changing the ACMS Menu Format Using TDMS
B.1	Modifying the Menu Format Using ACMS
B.2	Modifying the ACMS Menu Using TDMS Requests
B.2.1	Getting the ACMS Menu Request and Form
B.2.2	Modifying the Menu Form Only
B.2.3	Forms, Records, and Keypad Used by the Menu Request
B.2.4	Instructions Performed by TDMS When ACMS Calls a Request
B.2.5	Modifying the Menu Request
B.2.6	Using the REQUEST Clause
B.2.7	Changing the MENU_ENTRY_RECORD
B.2.8	Modifying and Building the ACMS Menu Request Library
B.3	Disabling the SELECT Command in the ACMS Command Menu
Appendix C
Appendix C	Using CDO for Pieces Tracking
C.1	Overview of Dictionary Object Types
C.2	Creating Relationships Between Entities
Appendix D
Appendix D	Using LSE with ACMS
D.1	Using LSE with ACMS
D.2	Creating ACMS Source Files with LSE
D.2.1	Using Placeholders and Tokens in LSE
D.2.2	Creating the Final Source File
D.2.2.1	Syntax Differences
D.2.2.2	Exiting Editing Mode
D.3	Compiling Definitions with LSE COMPILE
D.4	Examining Diagnostic Messages with LSE REVIEW
D.4.1	Generating the Diagnostics File
D.4.2	Examining the Diagnostics File with LSE REVIEW
D.5	Using HELP in LSE
Appendix E
Appendix E	Request Interface Kit Components
E.1	Application Independent Modules
E.2	RI Sample Application
E.2.1	RI Sample Application Source Modules
E.2.2	RI Sample Application Run-Time Files
E.3	FMS Sample Application
E.3.1	FMS Sample Application Source Modules
E.3.2	FMS Sample Application Run-Time Files
Appendix F
Appendix F	Modifying the FMS Menu Interface
Appendix G
Appendix G	Accessing ACMS Applications from Windows NT Clients
G.1	Access By NT Clients
G.2	TP Web Connector Gateway Components
G.2.1	ADU Extension
G.2.2	Gateway
G.3	Running ADU Extension
G.3.1	Group Task Translation
G.3.1.1	BUILD GROUP Command
G.3.1.2	Translation Actions
G.3.2	Application Group Translation
G.3.2.1	BUILD APPLICATION Command
G.3.2.2	Translation Actions
G.3.2.3	Using Translation Output
G.3.3	Restrictions
G.3.4	Converting Records
G.3.5	Data Type Translation
G.3.5.1	Integer Support
G.3.5.2	Floating Point and Complex Support
G.3.5.3	Decimal Support
G.3.5.4	Other Support
G.3.6	Translating Another Record
Appendix H
Appendix H	Checklist of References to Platform-Specific Files
H.1	Task Group Definition
H.2	ADU BUILD GROUP Command
Appendix I
Appendix I	Common Errors
I.1	ADU
I.2	Task Debugger
I.3	Application Startup
I.4	Task Execution
Index
Index
Examples
1-1	A Sample ADUINI.COM File
1-2	SET VERIFY Display
1-3	REPLACE Command in a Source Definition File
2-1	Definition of ADD_RESERVE_WKSP Fields
2-2	Contents of a Source Definition File
2-3	Complete Definition for the Add Car Reservation Task
2-4	Definition for RENTAL_CLASSES_WKSP
2-5	Complete Definition of the Review Car Rates Task
2-6	Record Description for REVIEW_RESERVATION_WORKSPACE
2-7	Complete Definition of Review Reservation Task
2-8	Definition for RESERVE_WKSP Workspace
2-9	Record Description for RESERVE_SHADOW_WKSP Workspace
2-10	Complete Definition of Review Update Task
3-1	Example of an Escape Unit
4-1	Record Definition for ADD_RESERVE_WKSP
4-2	Task Definition for Add Car Reservation Task
4-3	Definition for the ACMS$SELECTION_STRING Workspace
4-4	Definition for Display Basic Task
4-5	Record Definition for GROUP_WORKSPACE
4-6	Complete Definition for the Get Initial Value Task
4-7	Definition for Labor Reporting Task
4-8	Record Definition for DISPLAY_USER_WKSP
4-9	Definition for Display Basic Task with User Workspace
4-10	Moving Data to a Workspace Field
5-1	Task ENTER_ORDER
5-2	Task PROCESS_ORDER_LINE
5-3	Procedure WRITE_ORDER_LINE (in BASIC)
5-4	Updating User and Group Workspaces
5-5	Passing User Workspaces to Menu Tasks
5-6	Passing Data to a Called Task
5-7	Returning Your Own Exit and Cancel Status Values
5-8	MAIN_MENU Task
6-1	Audit Message for Starting a Detached Task
6-2	Audit Message for Exceeding the Retry Limit
6-3	ACMS/SHOW TASK Message for Detached Tasks
6-4	ACMS/SHOW APPLICATION/DETACHED_TASKS Message
6-5	Audit Messages for a Detached Task Canceled by a System Operator
6-6	Audit Message for a Task Failure that Is Not Retried
6-7	Broadcast Message for a Detached Task that Exceeded the Retry Limit
7-1	Distributed Transaction on a Nested Block Step
7-2	Multiple Database Updates in a Distributed Transaction
7-3	Calling a Task to Participate in a Distributed Transaction
7-4	Complete Definition of the VR_COMPLETE_CHECKOUT_TASK
7-5	VR_FAST_CHECKIN_TASK with Nonparticipating Processing Steps
8-1	RAISE EXCEPTION Clause in a Processing Step
8-2	Performing Exception Handling in a Task
8-3	Recovering from a DECforms Time-Out Exception
8-4	Recovering from an Exception Raised in a Called Task
8-5	Recovering from a Transaction Exception
8-6	Canceling a Task without Calling Server Cancel Procedures
9-1	Sample QTI Audit Entry
9-2	A Task That Dequeues from an Error Queue
9-3	A Dequeue Procedure
9-4	An Enqueue Procedure
9-5	C Agent that Starts a Distributed Transaction
9-6	VR_FAST_CHECKIN_TASK Definition
9-7	Enqueuing Routine
9-8	VR_COMP_FAST_CHKIN_TASK Definition
10-1	Definition of VR_READ_SERVER
10-2	Definition of Department Task Group
11-1	Personnel Application Definition
11-2	Application Definition Using TASK DEFAULTS
11-3	Application Definition Using Multiple TASK DEFAULTS
11-4	Application Using TASK ATTRIBUTES and TASK DEFAULTS
11-5	Enabling and Disabling Tasks in the Application Definition
11-6	Using TRANSACTION TIMEOUT in the Application Definition
11-7	Application Definition Using Server Defaults
11-8	Application Using Multiple Server Defaults Clauses
12-1	Menu Definition for the Personnel Menu
12-2	Example of a Menu with a Remote Task
13-1	A Task Group Definition
14-1	Simple Inquiry Task
14-2	Task Group Definition
14-3	FORTRAN User Request Procedure
14-4	TDMS Request
14-5	FORTRAN Initialization Procedure
14-6	Example of Audit Trail Error Messages
14-7	FORTRAN Cancel Procedure
14-8	REQPROCS.OPT Options File on VAX
14-9	REQPROCS.OPT Options File on Alpha
14-10	Linking Shareable Images and Using an Options File
14-11	FMS Initialization Procedure
14-12	FMS Menu Procedure
14-13	Example Application Definition
A-1	Definition for ACMS Menu Header
A-2	Definition for Menu Entries Record
A-3	Definition for Menu Control
A-4	Definition for Menu Selection Record
A-5	Control Text Response Found Record
A-6	Panel Definition
A-7	Default Panel Field Definition
A-8	Command Panel Field Definition
A-9	Record Group SELECT_LINE_GROUP
A-10	SELECTION_STRING Record Groups
A-11	SELECTION_STRING Panel Definitions
A-12	ENTRIES Record Group
A-13	ENTRIES Record in Default Panel Definition
A-14	Menu Definition Specifying Entries per Screen
A-15	Command Line Recall Buffer Definitions
A-16	Definition of Default Screen Layout
A-17	Menu Definition Using CONTROL TEXT
B-1	MENU_REQUEST Definition
B-2	Definition for ACMS Menu Header Record
B-3	Definition for Menu Entry Record
B-4	Definition for Menu Control
B-5	Definition for Menu Selection Record
B-6	Customized Menu Request
B-7	Menu Definition Using REQUEST Clause
B-8	Record Definition for MENU_ENTRY_RECORD with 12 Entries
B-9	MENU_LIBR Request Library Definition
D-1	LSEDIT.COM File

Contents

Index

Compaq ACMS for OpenVMSWriting Applications

Compaq ACMS for OpenVMS
Writing Applications