Settings to Configure the Sterling Connect:Enterprise UNIX Server Extract Service

Edit online

To configure the Sterling Connect:Enterprise® UNIX Server Extract service, you must specify field settings in Application and in the Graphical Process Modeler.

Application Configuration

The following table describes the fields used to configure the Sterling Connect:Enterprise UNIX Server Extract service:

Note: The field names in parentheses represent the corresponding field names in the GPM. This information is provided for your reference.

Field	Description
Name	Unique and meaningful name for the service configuration. Required.
Description	Meaningful description for the service configuration, for reference purposes. Required.
Select a Group	Group of services or adapters of the same type that can act as peers. A Service Group name is used in BPML in place of the Service Configuration name. Service Groups show up in the GPM as if they were Service Configurations. Select a Service Group to associate with this adapter. Valid values are: None – You do not want to include this configuration in a group at this time (default) Create New Group – You can enter a name for a new group in this field, which is then created along with this configuration. Select Group – If you have already created one or more groups for this service type, they are displayed in the list. Select a group from the list. For more information about service groups see Managing Services and Adapters.
CEU Server Adapter Instance Name (CEUServerAdapterInstanceName)	The instance of the Sterling Connect:Enterprise UNIX Server Adapter that the Extract service should use. The preconfigured service uses the preconfigured adapter named CEU Server Adapter BP.
Document Storage (DatabaseOrFileSystem)	Defines how the document will be stored in the system. Required. Valid values are: System Default Database File System Choose file system when handling very large batches.

GPM Configuration

The following table describes the fields used to configure the Sterling Connect:Enterprise UNIX Server Extract service in the GPM:

Field	Description
Config	Name of the service configuration. Required.
CEUBatchNumber	Numeric identifier for a batch within Sterling Connect:Enterprise for UNIX
CEUBatchDateTime	Combined with CEUBatchNumber, this provides unique access to a batch. That is, these two parameters identify what batch is to be extracted.
CEUServerAdapterInstanceName	Normally, this is already defined.
DatabaseOrFileSystem	Normally, this is already defined.

The required parameters CEUBatchNumber and CEUBatchDateTime can be obtained using XPath expressions when the business process is initiated by an auto connect. The following are examples of such XPath expressions:

<assign to="CEUBatchNumber" from="ACD_INFO/Batches/Batch[number(//loop_counter/text())]
/CEUBatchNumber/text()"></assign>

<assign to="CEUBatchDateTime" from="ACD_INFO/Batches/Batch[number(//loop_counter/text())]
/CEUBatchDateTime/text()"></assign>

Output from Business Process to Service

The following table describes the output from the business process to the Sterling Connect:Enterprise UNIX Server Extract service (Message To Service):

Parameter	Description
CEUBatchNumber	Numeric identifier for a batch within Sterling Connect:Enterprise for UNIX
CEUBatchDateTime	Combined with CEUBatchNumber provides unique access to a batch

Output from Service to Business Process

The following table describes the information that is placed in process data by the Sterling Connect:Enterprise UNIX Server Extract service (Message From Service):

Parameter	Description
PrimaryDocument	Batch payload
CEUBatchNumber	Echoes the batch number provided to this service as input.
CEUBatchDateTime	Echoes the batch date and time provided to this service as input.
CEUBatchSize	Size of the message in bytes.
CEUBatchId	Identifier (name) of the batch in Sterling Connect:Enterprise for UNIX.
CEUMailboxId	The Sterling Connect:Enterprise for UNIX Mailbox ID from which the batch was extracted.
CEUSessionId	Sterling Connect:Enterprise for UNIX session that the extract activity is associated with.
CEUProcessFlagStatus	Depicts the flag settings for the batch before the extract occurred. Comma delimited characters. For more information, see your Sterling Connect:Enterprise for UNIX documentation.