1. Messaging Queue Adapter Configuration Guide for WebSphere MQ on UNIX Systems
  2. Configuring the JD Edwards EnterpriseOne Server Components

Configuring the JD Edwards EnterpriseOne Server Components

Perform the following tasks to set up your JD Edwards EnterpriseOne server so that EnterpriseOne can receive an inbound message from another system or application and respond by placing an outbound message in the outbound queue. If your JD Edwards EnterpriseOne server is an IBM pSeries machine or an HP-UX machine, use the appropriate setup task to set up your machine then proceed to the task titled To create and start the IBM WebSphere MQ Queue Manager. If you have other UNIX platforms, go directly to the task titled To create and start the IBM WebSphere MQ Queue Manager.

  • Prepare for IBM WebSphere MQ version 6.0 or version 7.0.

  • Set up your pSeries machine.

  • Set up your HP machine.

  • Create and start IBM WebSphere MQ queue manager.

  • Create MQ local queues.

  • Create a MQ remote queue.

  • Create a MQ local sender channel.

  • Create a MQ local receiver channel.

  • End the IBM WebSphere MQ queue manager.

Caution: The names of queues and channels in IBM WebSphere MQ are case-sensitive. Be sure to use capital letters as specified in this document. You can specify any name for a queue or channel. However, it is important that the queue names you create exactly match the queue names you specify in the jde.ini file on the JD Edwards EnterpriseOne server.

To setup an IBM AIX (pSeries) machine for WebSphere MQ 6 or MQ 7

Note: Perform this setup task only if your JD Edwards EnterpriseOne server is an IBM AIX (pSeries) machine when using WebSphere MQ 6 or MQ 7. These steps are not required with WebSphere MQ 8.

To properly perform this task, you must be logged on with root authority.

  1. Edit the /etc/services file and add this line:

    ibm-mqseries 1414/tcp # WebSphere MQ channel listener

  2. Edit the /etc/inetd.conf file and add this line:

    ibm-mqseries stream tcp nowait mqm /usr/mqm/bin/amqcrsta amqcrsta -m JDE_QMGR

  3. After you have made the file edits, you must either refresh the inetd process or kill the process and restart it. Do one of these:

    • To refresh the inetd process, enter this command:

      refresh -s inetd

    • To kill the inetd process, you must first locate it using this command:

      ps -ef | grep inetd

      After you have located the inetd process, you can kill it using this command:

      kill -1 inetd <process_ID>

      where <process_ID> is the ID you determined using the grep command.

  4. Edit the .profile files for each user that will connect to the WebSphere MQ instance (may include jde900, mqm, and/or root) to add this export line:

    MQSERVER=SYSTEM.DEF.SVRCONN/TCP/<hostname>

  5. Log out these users from step 4, and log them back in to execute the .profile to set MQSERVER.

To setup your HP machine

Note: Perform this setup task only if your JD Edwards EnterpriseOne server is an HP machine.

To properly perform this task, you must be logged on as the UNIX user who starts JD Edwards EnterpriseOne services (for example, jde910).

  1. Edit the .profile file to add the following export line:

    export MQS_NO_SYNC_SIGNAL_HANDLING=

  2. Log out and back in to execute the .profile to set MQS_NO_SYNC_SIGNAL_HANDLING.

To create and start WebSphere MQ Queue Manager

  1. On your JD Edwards EnterpriseOne server, open a shell.

  2. To create the queue manager, execute this command:

    crtmqm -q JDE_QMGR

    This establishes a JDE queue manager as the default queue manager.

  3. To start the queue manager, execute this command:

    strmqm JDE_QMGR

To create MQ local queues

You must create these local queues:

  • INBOUND.Q

  • SUCCESS.Q

  • ERROR.Q

  • DEFRES.Q

  • OUTBOUND.Q.XMIT

  1. Access the shell you used to start the queue manager.

  2. To start the MQSC facility, enter this command:

    runmqsc JDE_QMGR

  3. To create the local queues, run these IBM WebSphere MQ commands:

    Define QLOCAL(INBOUND.Q) DEFPSIST(YES)

    DESCR('Queue for messages into EnterpriseOne')

    Define QLOCAL(SUCCESS.Q) DEFPSIST(YES)

    DESCR('Queue for successful messages in EnterpriseOne')

    Define QLOCAL(ERROR.Q) DEFPSIST(YES)

    DESCR('Queue for error messages in EnterpriseOne')

    Define QLOCAL(DEFRES.Q) DEFPSIST(YES)

    DESCR('Queue for responses if not in message in EnterpriseOne')

    Define QLOCAL(OUTBOUND.Q.XMIT) DEFPSIST(YES)

    USAGE(XMITQ) DESCR('Transmit queue to NC system')

To create the MQ remote queue

In the same shell you used in the previous task, enter this command to create a single MQ remote queue:

Define QREMOTE(OUTBOUND.Q) DEFPSIST(YES)

XMITQ(OUTBOUND.Q.XMIT) RNAME(ECE_IN2MQI)

RQMNAME(ECE_MQI_QMGR) DESCR('EnterpriseOne outbound queue to NC system')

Note: ECE_IN2MQI is the third-party remote queue name and ECE_MQI_QMGR is the third-party queue manager name.

To create a MQ local sender channel

In the same shell you used in the previous task, enter this command to create a MQ local sender channel:

Define CHANNEL(OW2MQI_CHL) CHLTYPE(SDR) TRPTYPE(TCP)

CONNAME(Net Comm Server Name) XMITQ(OUTBOUND.Q.XMIT)

DISCINT(0) DESCR('Sender channel to NC system')

To create a MQ local receiver channel

In the same shell you used in the previous task, enter the following command to create a MQ local receiver channel:

Define CHANNEL('MQI2OW_CHL') CHLTYPE(RCVR) TRPTYPE(TCP) DESCR('Receiver channel from third-party application or system')

To end the IBM WebSphere MQ command mode

When you are finished creating the queues and channels, from the same shell you used in the previous tasks, enter this command:

END

This exits the runmqsc program.