Oracle Application Server InterConnect Adapter for SMTP Installation and User's Guide -- Index

adapter.ini file

agent_delete_file_cache_at_startup parameter, 2-13

agent_dvm_table_caching parameter, 2-13

agent_log_level parameter, 2-11

agent_lookup_table_caching parameter, 2-13

agent_max_ao_cache_size parameter, 2-13

agent_max_co_cache_size parameter, 2-14

agent_max_dvm_table_cache_size parameter, 2-14

agent_max_lookup_table_cache_size parameter, 2-14

agent_max_message_metadata_cache_size parameter, 2-14

agent_max_queue_size parameter, 2-14

agent_message_selector parameter, 2-11

agent_metadata_caching parameter, 2-13

agent_persistence_cleanup_interval parameter, 2-14

agent_persistence_queue_size parameter, 2-14

agent_persistence_retry_interval parameter, 2-14

agent_pipeline_to_hub, adapter.ini file

agent_pipeline_from_hub, 2-14

agent_reply_message_selector parameter, 2-12

agent_reply_subscriber_name parameter, 2-12

agent_subscriber_name parameter, 2-11

agent_throughput_measurement_enabled parameter, 2-12

agent_tracking_enabled parameter, 2-12

agent_use_custom_hub_dtd parameter, 2-12

application parameter, 2-11

bridge_class parameter, 2-19

cannot be changed, 4-3

configuring D3L, 3-2

configuring XML, 3-2

corba_port_number, adapter.ini file

encoding, 2-16

definition, 2-9

directory path location, 2-5

encrypted_smtp.receiver.password parameter, 2-20

instance_number parameter, 2-11

nls_country parameter definition, 2-17

nls_date_format parameter definition, 2-17

nls_language parameter definition, 2-17

ota.d3ls parameter, 2-19

ota.receive.endpoint parameter, 2-19

ota.send.endpoint parameter, 2-19, 3-4

ota.type parameter, 2-19

partition parameter, 2-11

sample file, A-2

service_class parameter, 2-15

service_classpath parameter, 2-15

service_max_heap_size parameter, 2-15

service_max_java_stack_size parameter, 2-15

service_max_native_stack_size parameter, 2-15

service_min_heap_size parameter, 2-15

service_num_vm_args parameter, 2-15

service_path parameter, 2-15

service_vm_argnumber parameter, 2-16

smtp.receiver.exception_folder parameter, 2-20

smtp.receiver.max_msgs_retrieved parameter, 2-20

smtp.receiver.password parameter, 2-20

smtp.receiver.polling_interval parameter, 2-20

smtp.receiver.protocol parameter, 2-20

smtp.sender.character_set parameter, 2-19

smtp.sender.content_type parameter, 2-19

smtp.sender.smtp_host parameter, 2-19

adapter.ini parameters, 2-10

agent

configuration parameters, 2-11

agent_delete_file_cache_at_startup parameter

definition, 2-13

agent_dvm_table_caching parameter

definition, 2-13

agent_log_level parameter

definition, 2-11

agent_lookup_table_caching parameter

definition, 2-13

agent_max_ao_cache_size parameter

definition, 2-13

agent_max_co_cache_size parameter

definition, 2-14

agent_max_dvm_table_cache_size parameter

definition, 2-14

agent_max_lookup_table_cache_size parameter

definition, 2-14

agent_max_message_metadata_cache_size parameter

definition, 2-14

agent_max_queue_size parameter

definition, 2-14

agent_message_selector parameter

definition, 2-11

agent_metadata_caching parameter

definition, 2-13

agent_persistence_cleanup_interval parameter

definition, 2-14

agent_persistence_queue_size parameter

definition, 2-14

agent_persistence_retry_interval parameter

definition, 2-14

agent_reply_message_selector parameter

definition, 2-12

agent_reply_subscriber_name parameter

definition, 2-12

agent_subscriber_name parameter

definition, 2-11

agent_throughput_measurement_enabled parameter

definition, 2-12

agent_tracking_enabled parameter

definition, 2-12

agent_use_custom_hub_dtd parameter

definition, 2-12

application parameter

definition, 2-11

application view, 3-3

bridge

configuration parameters, 2-19

detecting messages, 3-3

bridge_class parameter

cannot be changed, 4-3

definition, 2-19

common view, 3-3, 3-5

configuration

executable files, 2-8

postinstallation, 2-6

SMTP adapter, 2-8, 2-19

configuration files

adapter.ini, 2-9

ErrorCodes.ini, 2-9

SMTP adapter, 2-9

configuration parameters

agent, 2-11

bridge, 2-19

D3L. See data definition description language (D3L)

data definition description language (D3L)

customizing the payload datatype after installation, 2-6

file contents, 3-2

importing in iStudio, 3-2

sending messages using D3L as the payload datatype, 3-6

setting the ota.d3ls parameter, 2-19

setting the ota.type parameter, 2-6, 2-19

used by bridge, 3-5

used by bridge to parse formats, 3-3

design time concepts

SMTP adapter, 3-2

directories

logs, 2-9

persistence, 2-9

directory path

of SMTP adapter, 2-5

document type definition (DTD)

features, 3-2

importing in iStudio, 3-2

DTD. See document type definition (DTD)

encrypt tool

location of, 4-3

encrypt.bat tool

location of, 4-3

encrypted_smtp.receiver.password parameter

definition, 2-20

encryption

of the SMTP adapter password parameter, 2-20, 4-3

endpoints

associating with a subscribing event in iStudio, 3-4

do not use personal e-mail accounts for receiving endpoints, 2-5

sending and receiving endpoints restricted to SMTP endpoints, 1-5

error messages

ignoring, 2-8

in ErrorCodes.ini file, 2-9

SMTP adapter error codes, 3-16

SMTP adapter startup problems, 4-2

ErrorCodes.ini file

definition, 2-9

executable files

ignoreerrors, 2-8

ignoreerrors.bat, 2-8

start, 2-8

start.bat, 2-8

stop, 2-8

stop.bat, 2-8

ignoreerrors file

definition, 2-8

ignoreerrors.bat file

definition, 2-8

IMAP server

integration with SMTP adapter, 1-2

not supported with SSL, 1-5

receiving messages, 3-3

supported versions, 1-5

initialization parameters

agent_delete_file_cache_at_startup, 2-13

agent_dvm_table_caching, 2-13

agent_log_level, 2-11

agent_lookup_table_caching, 2-13

agent_max_ao_cache_size, 2-13

agent_max_co_cache_size, 2-14

agent_max_dvm_table_cache_size, 2-14

agent_max_lookup_table_cache_size, 2-14

agent_max_message_metadata_cache_size, 2-14

agent_max_queue_size, 2-14

agent_message_selector, 2-11

agent_metadata_caching, 2-13

agent_persistence_cleanup_interval, 2-14

agent_persistence_queue_size, 2-14

agent_persistence_retry_interval, 2-14

agent_reply_message_selector, 2-12

agent_reply_subscriber_name, 2-12

agent_subscriber_name, 2-11

agent_throughput_measurement_enabled, 2-12

agent_tracking_enabled, 2-12

agent_use_custom_hub_dtd, 2-12

application, 2-11

bridge_class, 2-19

cannot be changed, 4-3

encrypted_smtp.receiver.password, 2-20

in adapter.ini file, 2-9

instance_number, 2-11

making the password parameter secure, 4-3

ota.d3ls, 2-19

ota.receive.endpoint, 2-19

ota.send.endpoint, 2-19, 3-4

ota.type, 2-19

partition, 2-11

service_class, 2-15

service_classpath, 2-15

service_max_heap_size, 2-15

service_max_java_stack_size, 2-15

service_max_native_stack_size, 2-15

service_min_heap_size, 2-15

service_num_vm_args, 2-15

service_path, 2-15

service_vm_argnumber, 2-16

smtp.receiver.exception_folder, 2-20

smtp.receiver.max_msgs_retrieved, 2-20

smtp.receiver.password, 2-20

smtp.receiver.polling_interval, 2-20

smtp.receiver.protocol, 2-20

smtp.sender.character_set, 2-19

smtp.sender.content_type, 2-19

smtp.sender.smtp_host, 2-19

installation

changing or correcting settings after installation, 4-3

do not use personal e-mail accounts for receiving endpoints, 2-5

hardware requirements, 1-4

JRE requirements, 1-5

of multiple SMTP adapters on a single computer, 4-3

operating system requirements, 1-4

preinstallation tasks, 2-2

SMTP adapter, 2-3

software requirements, 1-4

instance_number parameter

definition, 2-11

iStudio

associating endpoints with subscribing events, 3-4

associating metadata, 3-4

importing D3L, 3-2

importing XML, 3-2

JavaMail API

using, 3-6

log files

oailog.txt, 2-9

of successfully started SMTP adapter, 3-14

viewing SMTP adapter startup problems, 4-2

logs directory

definition, 2-9

messages

example of extracting message from SMTP adapter, 3-7

example of sending message to SMTP adapter, 3-6

ignoring error messages, 2-8

logging SMTP adapter activity, 2-9

multiple endpoint support for outgoing messages, 1-5

persisting, 2-9

receiving from a single endpoint, 3-3

sending to multiple endpoints, 3-4

single endpoint support for incoming messages, 1-5

SMTP adapter error messages, 3-16

metadata

associating in iStudio, 3-4

metadata parameter

ota.endpoint, 3-4

native view, 3-5

oailog.txt file

logging information, 2-9

verifying SMTP adapter startup, 4-2

OracleAS InterConnect

integration with SMTP adapter, 1-2

ota.d3ls parameter

customizing after installation, 2-6

definition, 2-19

ota.endpoint metadata parameter, 3-4

ota.receive.endpoint parameter

definition, 2-19

ota.send.endpoint parameter

definition, 2-19, 3-4

ota.type parameter

customizing after installation, 2-6

definition, 2-19

partition parameter

definition, 2-11

password

encryption, 2-20, 4-3

payload datatype

customizing after installation, 2-6

sending messages, 3-6

persistence directory

definition, 2-9

POP3

not supported, 1-5

postinstallation

configuration, 2-6

customizing receiving endpoints behavior, 2-7

customizing sending endpoints behavior, 2-7

customizing the payload datatype, 2-6

RAC-specific Hub.ini parameters, 2-10

RAC-specific hub.ini parameters, 2-10

ReceiverCustomizer Interface, 3-8

receiving endpoints

do not use personal e-mail accounts, 2-5

requirements

hardware, 1-4

JRE, 1-5

operating system, 1-4

software, 1-4

runtime concepts

SMTP adapter, 3-3

Secure Socket Layer (SSL)

not supported with IMAP server, 1-5

security

making the adapter.ini password parameter secure, 4-3

service_class parameter

definition, 2-15

service_classpath parameter

definition, 2-15

service_max_heap_size parameter

definition, 2-15

service_max_java_stack_size parameter

definition, 2-15

service_max_native_stack_size parameter

definition, 2-15

service_min_heap_size parameter

definition, 2-15

service_num_vm_args parameter

definition, 2-15

service_path parameter

definition, 2-15

service_vm_argnumber parameter

definition, 2-16

SMTP adapter

adapter.ini file, 2-9

agent subcomponent, 3-5

bridge subcomponent, 3-5

configuration, 2-8

configuration files, 2-9

configuration parameters, 2-19

customizing, 3-7

design time concepts, 3-2

directory path location, 2-5

error messages, 3-16

executable files, 2-8

extracting messages, 3-7

hardware requirements, 1-4

installation tasks, 2-3

installing multiple versions on the same computer, 4-3

integration with IMAP server, 1-2

integration with OracleAS InterConnect, 1-2

integration with SMTP server, 1-2

JRE requirements, 1-5

limitations, 1-5

log of successfully started adapter, 3-14

logging information, 2-9

message persistence, 2-9

operating system requirements, 1-4

overview, 1-2

preinstallation tasks, 2-2

receiving messages, 3-3

runtime concepts, 3-3

sample adapter.ini file, A-2

sending messages, 3-4, 3-6

software requirements, 1-4

starting, 2-8, 3-14

startup errors, 4-2

startup verification, 4-2

stopping, 2-8, 3-15

troubleshooting, 4-2

XML payload, 3-2

SMTP server

integration with SMTP adapter, 1-2

receiving messages, 3-4

smtp.receiver.exception_folder parameter