Show TOC

Function documentationQueue Write Locate this document in the navigation structure

 

You use this action to send text-based messages to an existing queue on a Java Message Service (JMS) server.

Features

The properties in the Link Editor for this action are listed in the following table:

Name

Property

Data Type

Access

Use

Connection Alias

ConnPropAlias

String

In and out

Identifies the JMS Connection alias that you want to use. This property is not mandatory. You can either choose to use an alias or enter the connection details for the action manually. If you choose to use an alias, then the following fields are filled automatically during the runtime with the data from the alias.

  • URL:

  • JNDI Context Provider:

  • JNDI Factory Context:

Else, you have to enter the data for the above mentioned fields. You can manage the JMS Connection aliases through System Connection Editor.

Queue Credential Alias

QueueCredentialAlias

String

In and out

Specifies the alias to the identity used to create a JMS queue connection. For more information on credential aliases, see Credential Editor.

Queue Name

QueueName

String

In and out

The name of the JMS queue to which the message is written

URL

JndiUrl

String

In and out

Specifies the URL for the JNDI service provider. For more information on the URL connection to SAP NetWeaver JNDI, see Creating an Initial Context in the SAP NetWeaver Composition Environment Library. The connection must be through ICM and/or Message Server. For complete list of ports used by SAP NetWeaver, use AS Java Ports.

JNDI Credential Alias

JndiCredentialAlias

Integer

In and out

Alias for the user name and password used to create JNDI context. For more information on credential aliases, see Credential Editor.

JNDI Factory Context

JndiFactoryContext

String

In and out

Specifies the factory class name used to create connections with a point to point JMS provider. To send messages to SAP NetWeaver JMS provider use jmsfactory/default/QueueConnectionFactory. To see the JMS available connection factories in SAP NetWeaver do the following:

  1. Open SAP NetWeaver Administrator

  2. Choose   Configuration Management   Infrastructure   JMS Server Configuration.  

  3. Enter JMS Connection Factory as a Type filter in the filters row .

  4. Choose Enter.

JNDI Context Provider

JndiContextProvider

String

In and out

Identifies the initial context factory to use. The value of the property must be the fully qualified name of the factory class that will create an initial context. You have to use com.sap.engine.services.jndi.InitialContextFactoryImpl as initial context factory class name to get connected. For more information, see SAP NetWeaver JNDI Registry Service in the SAP NetWeaver Composition Environment Library.

Message Expiration

MessageExpiration

Integer

In and out

Specifies the message lifetime in milliseconds. The message is destroyed after the specified expiration time. The message never expires when the value is set to 0.

Message

Message

String

In and out

Specifies the message body.

Delivery Mode

DeliveryMode

Integer

In and out

Specifies one of the following modes:

  • Persistent (Value=1)

    Message is saved to the database until the send attempt is successful. This ensures that the message is not lost in case of JMS provider failure.

  • Non-Persistent (Value=2)

    Message is not saved to the database. The system retries to send the message, unless the server crashes.

By default, the delivery mode is always Non-Persistent.

Priority

Priority

Integer

In and out

The priority of the message in the queue

Specifies the priority of the message in the queue. The priority levels range from 0 (low) to 9 (highest). The default priority level is 4.

Success

Success

Boolean

Out

Indicates the status of the action. If the action fails, then the errors are displayed in the server trace log.