Preface |
Preface
|
Preface
|
Chapter 1 |
1
|
Overview of the ACMS Systems Interface
|
1.1
|
The ACMS Systems Interface
|
1.2
|
Systems Interface Services
|
1.3
|
Agent Programs
|
1.3.1
|
Calling Tasks
|
1.3.2
|
Using Streams
|
1.3.3
|
Using SI Identifiers
|
Chapter 2 |
2
|
Common Features of the Systems Interface
|
2.1
|
Features Common to the SI Services
|
2.1.1
|
Service Call Specification
|
2.1.2
|
Parameter Notation
|
2.1.3
|
Return Status
|
2.1.4
|
Synchronous and Asynchronous Calling Formats
|
2.1.5
|
ACMS$SIGNAL and ACMS$WAIT Support Services
|
2.1.5.1
|
ACMS$SIGNAL
|
2.1.5.2
|
ACMS$WAIT
|
2.1.6
|
Single-Threaded and Multithreaded Agent Programs
|
2.1.7
|
Default Submitter Feature
|
2.1.8
|
Running an Agent Program
|
2.1.8.1
|
Preparing to Use RI or User-Written Agents that Use DECforms in Tasks
|
2.1.8.2
|
Starting an Agent Program
|
2.1.9
|
Debugging an Agent Program with ACMS$CHECK
|
2.2
|
Features Common to Languages that Call the Systems Interface
|
2.2.1
|
BLISS
|
2.2.2
|
C
|
2.2.3
|
FORTRAN
|
2.2.4
|
MACRO
|
2.2.5
|
Pascal
|
2.2.6
|
PL/I
|
2.2.7
|
Other Languages
|
Chapter 3 |
3
|
Agent Programs that Coordinate Distributed Transactions
|
3.1
|
Starting a Distributed Transaction
|
3.2
|
Rolling Back a Distributed Transaction
|
3.3
|
Accessing Remote Data
|
3.4
|
Step Procedure in C that Acts as an Agent Program
|
Chapter 4 |
4
|
Agent Program Initialization and Exchange I/O Services
|
4.1
|
Authorizing an Agent Program in ACMS
|
4.2
|
Signing In a Task Submitter to ACMS
|
4.3
|
Specifying the Type of I/O
|
4.4
|
Terminating Exchange I/O
|
4.5
|
Signing Out a Task Submitter from ACMS
|
4.6
|
ACMS$INIT_EXCHANGE_IO
|
4.7
|
ACMS$SIGN_IN
|
4.8
|
ACMS$SIGN_OUT
|
4.9
|
ACMS$TERM_EXCHANGE_IO
|
Chapter 5 |
5
|
Submitter Services
|
5.1
|
Preparing to Call a Task
|
5.2
|
Calling a Task
|
5.2.1
|
Passing a Transaction ID (TID)
|
5.2.2
|
Supplying Workspaces to a Task
|
5.2.3
|
Supplying the Correct Number of Task Argument Workspaces
|
5.2.4
|
Accessing Task Workspaces
|
5.3
|
Canceling a Task
|
5.4
|
ACMS$CALL
|
5.5
|
ACMS$CANCEL_CALL
|
5.6
|
ACMS$GET_PROCEDURE_INFO
|
5.7
|
ACMS$START_CALL
|
5.8
|
ACMS$WAIT_FOR_CALL_END
|
Chapter 6 |
6
|
Stream Services
|
6.1
|
Overview of Stream Services
|
6.2
|
ACMS$REPLY_TO_STREAM_IO
|
6.3
|
ACMS$WAIT_FOR_STREAM_IO
|
Chapter 7 |
7
|
Sample Agent Programs
|
7.1
|
C Agent Program that Starts a Distributed Transaction
|
7.2
|
FORTRAN General-Purpose Agent Program
|
7.3
|
C Agent Program that Performs Stream I/O or No I/O
|
7.4
|
BLISS Agent Program that Uses Superseded Services
|
7.5
|
Pascal Agent Program that Uses ACMS$WAIT
|
Appendix A |
Appendix A
|
Superseded Services and Parameters
|
A.1
|
ACMS$CLOSE_RR
|
A.2
|
ACMS$CONNECT_STREAM
|
A.3
|
ACMS$CREATE_STREAM
|
A.4
|
ACMS$DELETE_STREAM
|
A.5
|
ACMS$DISCONNECT_STREAM
|
A.6
|
ACMS$OPEN_RR
|
A.7
|
Superseded Parameters of the Task I/O Argument
|
A.7.1
|
Argument List for a Task That Performs Request I/O
|
A.7.2
|
Argument List for a Task That Passes Only Stream I/O
|
A.7.3
|
Argument List with Selection String, Extended Status, and Terminal I/O Defined
|
Index |
Index |
Examples |
3-1 |
A Specialized User-Written Agent |
3-2 |
Task Definition that Calls a Procedure Used as an Agent |
3-3 |
Task Definition that Calls a Procedure to Update Remote Data |
3-4 |
Step Procedure in C that Acts as an Agent Program |
7-1 |
C Agent Program that Starts a Distributed Transaction |
7-2 |
FORTRAN General-Purpose Agent Program |
7-3 |
C Agent Program that Performs Stream I/O or No I/O |
7-4 |
BLISS Agent Program that Uses Superseded Services |
7-5 |
Pascal Agent Program that Uses ACMS$WAIT |
Figures |
1-1 |
Agent Programs Submitting Tasks to ACMS |
1-2 |
Stream Connection |
3-1 |
Using a Step Procedure as an Agent Program |
4-1 |
Signing In a Task Submitter to ACMS |
5-1 |
Calling a Task in ACMS |
5-2 |
Arguments Passed for a Task Using a Full Task Argument List |
5-3 |
Arguments Passed for a Task Doing No I/O |
6-1 |
Using Stream Services to Communicate with ACMS |
A-1 |
Arguments Passed for a Task Doing Request I/O |
A-2 |
Arguments Passed for a Task Doing Stream I/O |
A-3 |
Arguments Passed for a Task Doing Terminal I/O |