HP OpenVMS Utility Routines Manual

Chapter 14
14	Lightweight Directory Access Protocol (LDAP) Routines
14.1	Introduction
14.1.1	Overview of the LDAP Model
14.1.2	Overview of LDAP API Use
14.1.3	LDAP API Use on OpenVMS Systems
14.1.4	64-bit Addressing Support
14.1.4.1	Background
14.1.4.2	Implementation
14.1.4.2.1	Library Symbol Names
14.1.4.2.2	LDAP Data Structures
14.1.4.3	Mixing Pointer Sizes
14.1.5	Multithreading Support
14.2	Common Data Structures and Memory Handling
14.3	LDAP Error Codes
14.4	Initializing an LDAP Session
14.5	LDAP Session Handle Options
14.6	Working with Controls
14.7	Authenticating to the Directory
14.8	Closing the Session
14.9	Searching
14.9.1	Reading and Listing the Children of an Entry
14.10	Comparing a Value Against an Entry
14.11	Modifying an Entry
14.12	Modifying the Name of an Entry
14.13	Adding an Entry
14.14	Deleting an Entry
14.15	Extended Operations
14.16	Abandoning an Operation
14.17	Obtaining Results and Looking Inside LDAP Messages
14.18	Handling Errors and Parsing Results
14.18.1	Stepping Through a List of Results
14.19	Parsing Search Results
14.19.1	Stepping Through a List of Entries
14.19.2	Stepping Through the Attributes of an Entry
14.19.3	Retrieving the Values of an Attribute
14.19.4	Retrieving the Name of an Entry
14.19.5	Retrieving Controls from an Entry
14.19.6	Parsing References
14.20	Encoded ASN.1 Value Manipulation
14.20.1	Encoding
14.20.1.1	Encoding Example
14.20.2	Decoding
14.20.2.1	Decoding Example
14.21	Using LDAP with HP SSL for OpenVMS
14.21.1	HP SSL Certificate Options
14.21.2	Obtaining a Key Pair
14.22	Sample LDAP API Code
Chapter 15
15	LOGINOUT (LGI) Routines
15.1	Introduction to LOGINOUT
15.1.1	The LOGINOUT Process
15.1.2	Using LOGINOUT with External Authentication
15.1.3	The LOGINOUT Data Flow
15.2	LOGINOUT Callouts
15.2.1	LOGINOUT Callout Routines
15.2.2	LOGINOUT Callback Routines
15.3	Using Callout Routines
15.3.1	Calling Environment
15.3.2	Callout Organization
15.3.3	Activating the Callout Routines
15.3.4	Callout Interface
15.3.5	Sample Program
15.4	LOGINOUT Callout Routines
Command 136	LGI$ICR_AUTHENTICATE
Command 137	LGI$ICR_CHKRESTRICT
Command 138	LGI$ICR_DECWINIT
Command 139	LGI$ICR_FINISH
Command 140	LGI$ICR_IACT_START
Command 141	LGI$ICR_IDENTIFY
Command 142	LGI$ICR_INIT
Command 143	LGI$ICR_JOBSTEP
Command 144	LGI$ICR_LOGOUT
15.5	LOGINOUT Callback Routines
Command 145	LGI$ICB_ACCTEXPIRED
Command 146	LGI$ICB_AUTOLOGIN
Command 147	LGI$ICB_CHECK_PASS
Command 148	LGI$ICB_DISUSER
Command 149	LGI$ICB_GET_INPUT
Command 150	LGI$ICB_GET_SYSPWD
Command 151	LGI$ICB_MODALHOURS
Command 152	LGI$ICB_PASSWORD
Command 153	LGI$ICB_PWDEXPIRED
Command 154	LGI$ICB_USERPARSE
Command 155	LGI$ICB_USERPROMPT
Command 156	LGI$ICB_VALIDATE
Chapter 16
16	Mail Utility (MAIL) Routines
16.1	Messages
16.2	Folders
16.3	Mail Files
16.4	User Profile Database
16.5	Mail Utility Processing Contexts
16.5.1	Callable Mail Utility Routines
16.5.2	Single and Multiple Threads
16.6	Programming Considerations
16.6.1	Condition Handling
16.6.2	Item Lists and Item Descriptors
16.6.2.1	Structure of an Item Descriptor
16.6.2.2	Null Item Lists
16.6.2.3	Declaring Item Lists and Item Descriptors
16.6.2.4	Terminating an Item List
16.6.3	Action Routines
16.7	Managing Mail Files
16.7.1	Opening and Closing Mail Files
16.7.1.1	Using the Default Specification for Mail Files
16.7.1.2	Specifying an Alternate Mail File Specification
16.7.2	Displaying Folder Names
16.7.3	Purging Mail Files Using the Wastebasket Folder
16.7.3.1	Reclaiming Disk Space
16.7.3.2	Compressing Mail Files
16.8	Message Context
16.8.1	Selecting Messages
16.8.2	Reading and Printing Messages
16.8.3	Modifying Messages
16.8.4	Copying and Moving Messages
16.8.4.1	Creating Folders
16.8.4.2	Deleting Folders
16.8.4.3	Creating Mail Files
16.8.5	Deleting Messages
16.9	Send Context
16.9.1	Sending New Messages
16.9.1.1	Creating a Message
16.9.1.1.1	Constructing the Message Header
16.9.1.1.2	Constructing the Body of the Message
16.9.1.2	Creating an Address List
16.9.2	Sending Existing Messages
16.9.3	Send Action Routines
16.9.3.1	Success Action Routines
16.9.3.2	Error Handling Routines
16.9.3.3	Aborting a Send Operation
16.10	User Profile Context
16.10.1	User Profile Entries
16.10.1.1	Adding Entries to the User Profile Database
16.10.1.2	Modifying or Deleting User Profile Entries
16.11	Input Item Codes
16.12	Output Item Codes
16.13	Using the MAIL Routines: Examples
16.14	MAIL Routines
Command 157	MAIL$MAILFILE_BEGIN
Command 158	MAIL$MAILFILE_CLOSE
Command 159	MAIL$MAILFILE_COMPRESS
Command 160	MAIL$MAILFILE_END
Command 161	MAIL$MAILFILE_INFO_FILE
Command 162	MAIL$MAILFILE_MODIFY
Command 163	MAIL$MAILFILE_OPEN
Command 164	MAIL$MAILFILE_PURGE_WASTE
Command 165	MAIL$MESSAGE_BEGIN
Command 166	MAIL$MESSAGE_COPY
Command 167	MAIL$MESSAGE_DELETE
Command 168	MAIL$MESSAGE_END
Command 169	MAIL$MESSAGE_GET
Command 170	MAIL$MESSAGE_INFO
Command 171	MAIL$MESSAGE_MODIFY
Command 172	MAIL$MESSAGE_SELECT
Command 173	MAIL$SEND_ABORT
Command 174	MAIL$SEND_ADD_ADDRESS
Command 175	MAIL$SEND_ADD_ATTRIBUTE
Command 176	MAIL$SEND_ADD_BODYPART
Command 177	MAIL$SEND_BEGIN
Command 178	MAIL$SEND_END
Command 179	MAIL$SEND_MESSAGE
Command 180	MAIL$USER_BEGIN
Command 181	MAIL$USER_DELETE_INFO
Command 182	MAIL$USER_END
Command 183	MAIL$USER_GET_INFO
Command 184	MAIL$USER_SET_INFO