Updated: 11 December 1998

OpenVMS Programming Interfaces: Calling a System Routine

Contents

Preface
Preface	Preface
Chapter 1
1	Call Format to OpenVMS Routines
1.1	Overview
1.2	Format Heading
1.2.1	Procedure Call Format
1.2.2	JSB Call Format (VAX only)
1.3	Returns Heading
1.3.1	Condition Values Returned in a Register
1.3.2	Other Returned Values
1.3.3	Condition Values Signaled
1.4	Arguments Heading
1.4.1	OpenVMS Usage Entry
1.4.2	Type Entry
1.4.3	Access Entry
1.4.4	Mechanism Entry
1.4.5	Explanatory Text
1.5	Condition Values Returned Heading
1.5.1	Condition Values Returned
1.5.2	Condition Values Returned in an I/O Status Block
1.5.3	Condition Values Returned in a Mailbox
1.5.4	Condition Values Signaled
Chapter 2
2	Basic Calling Standard Conventions
2.1	Hardware Registers
2.1.1	Register Usage for OpenVMS VAX
2.1.2	Register Usage for OpenVMS Alpha
2.1.2.1	Integer Registers
2.1.2.2	Floating-Point Registers
2.2	Stack Usage for Procedures
2.2.1	Stack Procedure Usage for VAX
2.2.1.1	Calling Sequence
2.2.1.2	Call Frames on Return
2.2.2	Stack Procedure Usage for Alpha
2.2.2.1	Fixed-Size Stack Frame
2.2.2.2	Variable-Size Stack Frame
2.3	Procedure Representation
2.4	Argument List
2.5	Argument Passing Mechanisms
2.5.1	Passing Arguments by Value
2.5.2	Passing Arguments by Reference
2.5.3	Passing Arguments by Descriptor
2.6	Passing Scalars as Arguments
2.7	Passing Arrays as Arguments
2.8	Passing Strings as Arguments
2.9	Combinations of Descriptor Class and Data Type
2.10	Return of the Function Value
2.11	Return of the Condition Value
Chapter 3
3	Calling Run-Time Library Routines
3.1	Overview
3.2	Call Instructions
3.2.1	Facility Prefix and Routine Name
3.2.2	The RTL Call Entry
3.2.2.1	JSB Call Entries (VAX Only)
3.2.3	Returns from an RTL Routine
3.2.3.1	Facility Return Status and Condition Value Symbols
3.3	Calling a Library Procedure in VAX MACRO (VAX Only)
3.3.1	VAX MACRO Calling Sequence
3.3.2	VAX MACRO CALLS Instruction Example
3.3.3	VAX MACRO CALLG Instruction Example
3.3.4	VAX MACRO JSB Entry Points
3.3.5	Return Status
3.3.6	Function Return Values in VAX MACRO
3.4	Calling a Library Routine in BLISS
3.4.1	BLISS Calling Sequence
3.4.2	Accessing a Return Status in BLISS
3.4.3	Calling JSB Entry Points from BLISS
Chapter 4
4	Calling System Services
4.1	Overview
4.2	Preserving System Integrity
4.2.1	User Privileges
4.2.2	Resource Quotas
4.2.3	Access Modes
4.3	System Service Call Entry
4.4	System Service Completion
4.4.1	Asynchronous and Synchronous System Services
4.4.2	System Service Resource Wait Mode
4.4.3	Condition Values Returned from System Services
4.4.4	Testing the Condition Value
4.4.5	Special Condition Values Using Symbolic Codes
4.4.6	Testing the Return Condition Value for Assembly Languages
4.4.7	System Messages Generated by Condition Values
4.5	Program Examples with System Service Calls
Chapter 5
5	STARLET Structures and Definitions for C Programmers
5.1	SYS$STARLET_C.TLB Equivalency to STARLETSD.TLB
5.2	NEW STARLET Definitions for C
Appendix A
Appendix A	Generic Macros for Calling System Services
A.1	Using Macros to Construct Argument Lists
A.1.1	Specifying Arguments with the $name_S Macro and the $name Macro
A.1.2	Conventions for Specifying Arguments to System Services
A.1.3	Defining Symbolic Names for Argument List Offsets: $name and $nameDEF
A.2	Using Macros to Call System Services
A.2.1	The $name_S Macro
A.2.1.1	Example of $name_S Macro Call
A.2.2	The $name_G Macro
A.2.3	The $name Macro
A.2.4	Example of $name and $name_G Macro Calls

Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal

5843PRO_CONTENTS.HTML