Sun ONE logo     Previous      Contents      Index      Next     

Sun logo
IS B2B: ECXpert 3.6.3 Support for AS2 Messaging 

Appendix A  
ECXpert’s Configuration File (ecx.ini)

AS2 processing uses configuration information from the ECXpert configuration file, ecx.ini. The ECXpert installer prompts for all required information and automatically configures the parameters within the file. However, some AS2 usage profiles require that the user modify ecx.ini as a post-installation task. These are:

The AS2 sections in ecx.ini are located under the following labels:

Label

Description

http-as2

Contains Server Settings information common to AS2 send and receive Communications Agents.

commhttp-as2-send

Contains information specific to the outbound AS2 Communications Agent

commhttp-as2-receive

Contains information specific to the inbound AS2 Communications Agent

This appendix provides a description of each field in the AS2 sections.

http-as2 Fields

Table A-1 lists the fields in the AS2 Server Settings http-as2 section of the ecx.ini file. Many of these AS2 Server Settings fields are filled in by the ECXpert installer, which prompts you to enter AS2 settings for the HTTP/AS2 Listener server you create prior to installing ECXpert.

The Server Settings fields are common to both AS2 send and receive Communications Agents. Mandatory fields are identified with italics.

Table A-1  Field descriptions for the AS2 Server Settings http-as2 section of ecx.ini 

Field

Description

registry_port

The port under which the RMI registry will run. This value is automatically set by the installer. It can be changed if the port is already bound to another process or if you want to select a different port.

submit_sender

Hard-codes the sender name for submissions to ECXpert. Use this to submit all AS2 documents as the same user. If no value is specified, the AS2 Server determines the sending member's name based on its AS2 party ID and submits the document using that value.

submit_receiver

Hard-codes the receiver name for sending from ECXpert. Use this to send all AS2 documents to the same user. If no value is specified, the AS2 Server determines the receiving member's name based on its AS2 party ID and sends the document using that value.

submit_password

Password used for submission. If not specified, the sending member must be a trusted member in ECXpert, because no password will be passed in the submission. If you specify a password, it must be encrypted using the bdgsetpasswd utility.

submit_file_type

File type used for submission. If not specified, the MIME sub-type specified in the Content-Type header of the AS2 message is used. If the sub-type is EDI-X12, EDIFACT, or EDI-Consent, the value is trimmed to 'EDI'. Examples are: Content-Type Submission File Type application/XML XML application/EDI-X12 EDI application/EDIFACT EDI application/idox-x8-41 idox-x8-41

http_proxy_host

The hostname of the proxy server (if used).

http_proxy_port

The port of the proxy server (if used).

log_level

The level of granularity used for log file entries. Possible values include: SEVERE, WARNING, INFO, FINE, FINER, FINEST.

keystore_file

If the system is using any level of message security (encryption, digital signature) and/or SSL, the administrator must specify a keystore file. The file path must point to an existing Java keystore.

keystore_pass

The password used to access the keystore. Must be encrypted using the bdgsetpasswd utility.

root_dir

The AS2 root directory.

asynch_url

A local URL used as a return address when requesting asynchronous MDNs.

jdbc_uri

The JDBC hostname/port/SID used by the JDBC driver.

ssl_host_verify

Set to true if the server name of an SSL host should be checked against the credentials presented in its certificate. False is the default.

custom_mdn_path

The path to a user-defined message for AS2 MDNs. When present, the value for this field should point to a file containing text that is used in the second part of an MDN multipart message (for example, The user section). If a path is not supplied, or if it is unresolvable or unreadable, the following default MDN text will be used: AS2 Message Disposition Notification

AS2 Send and Receive Fields

Table A-2 lists the fields in the AS2 Send and Receive Communications Agent sections of the ecx.ini file. You should not have to edit any of the fields listed in this section of the ecx.ini file, but it is possible that you might want to edit the following debugging fields for AS2 Send and Receive Agents.

Table A-2  Debugging for AS2 Send and Receive Communications Agents 

Field

Description

debug_flag

Turn on low level tracing information?

Restrictions—valid values:

-yes
-no

Default: no

redirect_stdout
redirect_stderr

Restrictions—valid values:

-yes
-no

Default: yes

if set to yes, the output directed to stdout and stderr is redirected to the files specified in stdout_path and stderr_path parameters.

stdout_path

Fully specified path for log file to receive standard output from low level trace.

Send: $ECXPERT_INSTALL_DIR/NS-apps/
ECXpert/data/log/ECXpert.log.
commhttp-as2-send.dat

Send: $ECXPERT_INSTALL_DIR/NS-apps/
ECXpert/data/log/ECXpert.log.
commhttp-as2-send.dat

stderr_path

Fully specified path for log file to receive standard output from low level trace.

Receive: $ECXPERT_INSTALL_DIR/NS-apps/
ECXpert/data/log/ECXpert.log.
commhttp-as2-send.dat

Receive: $ECXPERT_INSTALL_DIR/NS-apps/
ECXpert/data/log/ECXpert.log.
commhttp-as2-receive.dat

log_flag

Should entry appear in the logging API?

Restrictions—valid values:

-yes
-no

Default: yes

log_prefix

File prefix used for name generation.

Default: ECXpert.log.admin.dat

log_dir

Full path to directory for log files.

Default: $ECXPERT_INSTALL_DIR/NS-apps/
ECXpert/data/log



Previous      Contents      Index      Next     


Copyright 2004 Sun Microsystems, Inc. All rights reserved.