Chapter 92: Working with WMS MQ Job Control (WMJC)

Purpose: Use the WMS Job Control menu option to work with the ASYNC jobs that process inbound and outbound warehouse management updates for the warehouse management system interface.

Process overview: As the warehouse management system performs inventory updates, MQSeries sends XML messages to CWDirect. For example, when the warehouse management system performs an adjustment to inventory, a message is sent to the GENERIC PIX TRANSACTIONS process. If this process (ASYNC job) is active, it sends the PIX XML message to CWDirect immediately. If the process is not active when the message arrives, the PIX XML message will be created once the process is started. All messages are processed in the sequence in which they arrive at the message queue.

Note: The WMS processes are not restricted by company; when you work with or change a process, it affects all companies.

In this chapter:

• Work with WMS MQ Job Control Screen

• WMS Processes

• Changing the Number of Sessions

• Change MQ Job Control Pop-up Window

• Changing Process Status

• Change Status Pop-up Window

• Work with WMS Queues Screen

• MQSeries Work with Messages Screen (Reviewing Messages)

• Clearing Queues

• Queue Clear Warning Pop-up Window

Work with WMS MQ Job Control Screen

How to display this screen: Enter WMJC in the Fast path field at the top of any menu, or select WMS Job Control from a menu.

WMX0010 DISPLAY Work with WMS MQ Job Control 7/02/01 14:46:52 KAB Co. Type options, press Enter. 2=Change 7=Start 8=End 9=Work with Queues 10=View Local Queue Msgs 11=Change Status 14=Clear Queue Opt Process Status # of Number Sessions Active CONTROLLER ACTIVE 1 1 IMMEDIATE NEEDS EXPORT OUTBOUND ONLY 0 0 INVOICES ACTIVE 1 1 GENERIC INVOICES ACTIVE 1 1 ITEM EXPORT OUTBOUND ONLY 0 0 ITEM NOTES EXPORT OUTBOUND ONLY 0 0 PICK TICKET EXPORT OUTBOUND ONLY 0 0 PIX TRANSACTIONS ACTIVE 1 1 GENERIC PIX TRANSACTIONS ACTIVE 1 1 PURCHASE ORDERS EXPORT OUTBOUND ONLY 0 0 CUSTOMER RETURNS EXPORT OUTBOUND ONLY 0 0 STOP SHIPMENTS OUTBOUND ONLY 0 0 F3=Exit F7=Start All F8=End All F12=Cancel

Field	Description
Process	The job that performs WMS interface updates between CWDirect and the warehouse management system. See WMS Processes for a description of each. Alphanumeric, 20 positions; display-only.
Status	The status of the process. Possible statuses are: • Active • Inactive • Starting • Ending See Changing Process Status. Alphanumeric, 9 positions; display-only.
# of sessions	The number of separate jobs to allocate to processing inventory updates from the warehouse management system. Just as you can set up the billing async job to run multiple instances, you can also set the number of each individual inbound WMS process you would like to run. See Changing the Number of Sessions. Note: You can only define a number of sessions for the CONTROLLER process and inbound WMS processes; INVOICES, GENERIC INVOICES, PIX TRANSACTIONS, and GENERIC PIX TRANSACTIONS. Numeric, 5 positions; display-only.
Number active	The number of sessions currently active. Note: You can only define a number of sessions for inbound WMS processes; INVOICES, GENERIC INVOICES, PIX TRANSACTIONS, and GENERIC PIX TRANSACTIONS. Numeric, 5 positions; display-only.

Note: In order to perform certain options at this screen, such as change the status of a process, you need to have the Security administrator flag at the Create User Screen or Change User screen set to Y.

Screen Option	Procedure
Change the number of sessions for an inbound process	Enter 2 next to an inbound process to advance to the Change MQ Job Control Pop-up Window.
Start a process	Enter 7 next to a process to start it. See Changing Process Status.
End a process	Enter 8 next to a process to end it. See Changing Process Status.
Work with the local input queue and the remote queue, if any, for a process	Enter 9 next to a process to advance to the Work with WMS Queues Screen.
Review messages in the queue for a process	Enter 10 next to a process to advance to the MQSeries Work with Messages Screen (Reviewing Messages).
Change the status of a process	Enter 11 next to a process to advance to the Change Status Pop-up Window.
Clear messages for a process	Enter 14 next to a process to advance to the Queue Clear Warning Pop-up Window.
Start all processes	Press F7 to submit all of the e-commerce processes. See Changing Process Status.
End all processes	Press F8 to end all of the e-commerce processes. See Changing Process Status.

WMS Processes

Purpose: This table describes:

• the WMS processes

• their functions

• the jobs they initiate

• the messages they handle

See the Integration Layer user reference for more information on the translation process the integration layer performs on generic WMS XML messages.

Note: The default input queues (for processing messages from the warehouse management system to CWDirect) and, in certain cases, remote queues and queue managers (to enable sending information from CWDirect to the warehouse management system) vary, depending on the configuration of your warehouse management system. See the appropriate integration manual for more information.

Process	Function	Submitted Job(s)	Messages
Controller	Controls the outbound processes and directs each outbound process to the appropriate queue, in consecutive order. If the XML Begin Message Indicator (H49) system control value contains a code, this job also creates a begin WMS XML message for each WMS XML message. If the XML End Message Indicator (H50) system control value contains a code, this job also creates an end WMS XML message for each WMS XML message.	CONTROLLER (program name PKC0235)	N/A
Immediate Needs Export	CWDirect sends immediate backorder notices to the warehouse management system when you process immediate needs using the Sending Immediate Backorder Fulfillment Notices to a Warehouse Management System (MIND) menu option.	N/A	To PkMS: PkMS Immediate Needs XML Message (ImmediateNeeds_1_0) To another WMS: Generic WMS Immediate Needs XML Message (CWImmediateNeeds)
Invoices	PkMS sends shipment confirmations and warehouse backorder notices to CWDirect.	SHPCNFPKMS (program name PKX0185)	PkMS Batch Invoice XML Message (Invoice_1_0)
Generic Invoices	The warehouse management system sends shipment confirmations and warehouse backorder notices to CWDirect.	SHPCNF_GEN (program name PKX0187)	Generic WMS Invoice XML Message (CWInvoices)
Item Export	CWDirect sends item/SKU information to the warehouse management system when you create, change, or delete an item/SKU.	N/A	To PkMS: PkMS Item XML Message (ItemMaster_1_0) To another WMS: Generic WMS Item XML Message (CWItem)
Item Notes Export	CWDirect sends item/SKU information to the warehouse management system when you create or change item or SKU product comments or customer service comments.	N/A	Generic WMS Item Notes XML Message (CWItemNotes)
Pick Ticket Export	CWDirect sends pick ticket messages to the warehouse management system when you generate a pick slip.	N/A	To PkMS: PkMS Pick XML Message (Pickticket_1_0) To another WMS: Generic WMS Pick XML Message (CWPickTicket)
PIX Transactions	PkMS sends inventory transactions to CWDirect.	PIX_PKMS (program name PKX0181)	PkMS PIX XML Message (PIX_1_0)
Generic PIX Transactions	The warehouse management system sends inventory transactions to CWDirect.	PIX_GEN (program name PKX0183)	Generic WMS PIX XML Message (CWPIX)
Purchase Orders Export	CWDirect sends purchase order messages to the warehouse management system when you create or maintain a purchase order.	N/A	To PkMS: PkMS PO XML Message (InboundASN_1_0) To another WMS: Generic WMS PO XML Message (CWPurchaseOrder)
Customer Returns Export	CWDirect sends customer returns messages to the warehouse management system when you perform a return or exchange.	N/A	To PkMS: PkMS Customer Return XML Message (CaseBridge_1_0) To another WMS: Generic WMS Customer Return XML Message (CWCustomerReturn)
Stop Shipments	CWDirect sends stop pick slip shipment requests to the warehouse management system when you process a stop shipment using the Sending Stop Shipment Requests to a Warehouse Management System (MRSS) menu option.	N/A	To PkMS: PkMS Stop Shipment Request XML Message (Pickticket_1_0) To another WMS: Generic WMS Stop Shipment Request XML Message (CWStopShipment)
Vendor Export	CWDirect sends vendor messages to the warehouse management system when you create, change, or delete a vendor.	N/A	To PkMS: PkMS Vendor XML Message (VendorMaster_1_0, VendorContact_1_0) To another WMS: Generic WMS Vendor XML Message (CWVendor)
Vendor Contacts Export	CWDirect sends vendor contact messages to the warehouse management system when you create, change, or delete a vendor contact.	N/A	Generic WMS Vendor Contacts XML Message (CWVendorContacts)
Vendor Notes Export	CWDirect sends vendor notes messages to the warehouse management system when you create or maintain a vendor note.	N/A	Generic WMS Vendor Notes XML Message (CWVendorNotes)

Changing the Number of Sessions

Purpose: Use this pop-up window to change the number of sessions, or queues, available to an inbound WMS process. You might increase the number of sessions to improve response time. You can also review the program name and job name defined for the WMS process.

Outbound WMS processes: You cannot display this window for the WMS outbound processes.

• IMMEDIATE NEEDS EXPORT

• ITEM EXPORT

• ITEM NOTES EXPORT

• PICK TICKET EXPORT

• PURCHASE ORDERS EXPORT

• CUSTOMER RETURNS EXPORT

• STOP SHIPMENTS

• VENDOR EXPORT

• VENDOR CONTACTS EXPORT

• VENDOR NOTES EXPORT

Change MQ Job Control Pop-up Window

How to display this screen: Enter 2 next to a process at the Work with WMS MQ Job Control Screen. .

Change MQ Job Control # of Sessions . . 1 Program Name . . PKX0185 Job Name . . . . SHPCNFPKMS F12=Cancel

Field	Description
# of sessions	The number of separate jobs to allocate to processing inventory updates from the warehouse management system. Just as you can set up the billing async job to run multiple instances, you can also set the number of each individual WMS process you would like to run. Numeric, 5 positions; optional.
Program name	The program name defined for the WMS process. CONTROLLER = PKC0235 INVOICES = PKX0185 GENERIC INVOICES = PKX0187 PIX TRANSACTIONS = PKX0181 GENERIC PIX TRANSACTIONS = PKX0183 Alphanumeric, 10 positions; optional.
Job name	The job name defined for the WMS inbound process. CONTROLLER = CONTROLLER INVOICES = SHPCNFPKMS GENERIC INVOICES = SHPCNF_GEN PIX TRANSACTIONS = PIX_PKMS GENERIC PIX TRANSACTIONS = PIX_GEN Alphanumeric, 10 positions; optional.

Changing Process Status

Overview: You can start or stop the WMS inbound processes individually or as a group from the Work with WMS Job Control screen:

• Press F7 to start all processes

• Press F8 to end all processes

• Enter 7 next to a process to start it

• Enter 8 next to a process to end it

When you start one or more processes, their status changes from Inactive to Starting to Active. When you end one or more processes, their status changes from Active to Ending to Inactive.

Normally, you would leave the WMS processes running except to perform backup, system maintenance, and so on.

Note: You can start and end the CONTROLLER job; however, you cannot start or end each individual WMS outbound process.

Change Status Pop-up Window

Change status: You can also change the status of a process if it does not start or stop normally in a reasonable amount of time. Enter 11 next to a process to display the Change Status pop-up window:

Change MQ Job Status Inactive . . . Active . . . . F12=Cancel

At this window, enter 1 next to the desired status, Inactive or Active.

Note: You cannot change the status of the WMS outbound processes using these options. The WMS outbound processes remain Inactive except when messages are actively passed to the warehouse management system.

Work with WMS Queues Screen

Purpose: Use this screen to review or change the MQSeries message queue(s) to use for one of the WMS processes.

Each process has at least one queue so that it can send to the warehouse management system or receive messages from the warehouse management system.

How to display this screen: Enter 9 next to a process at the Work with WMS MQ Job Control Screen.

WMX0012 CHANGE Work with WMS Queues 7/02/01 15:20:00 KAB Co. Enter queue definitions for IMMEDIATE NEEDS EXPORT Local Queue: Local Queue not required Input Queue . . . . . . Response Queue: Remote Queue Mgr . . . CWIAS400 Remote Queue . . . . . PKMS.IMMEDNEED.OUT.BASE.50.QA F3=Exit F12=Cancel

Field	Description
Local queue/input	The MQSeries message queue, on the AS/400, from which this process receives messages originating from the warehouse management system. Enter the name of the correct queue to change it. Alphanumeric, 48 positions; required.
Response queue/remote queue manager	The definition of the machine where the remote queue is located. Enter the name of the correct queue manager to change it. Alphanumeric, 48 positions; required.
Response queue/remote queue	The MQSeries message queue to which response messages should be sent from CWDirect to the warehouse management system. The queue you specify here must match the name of the queue on the NT machine or other remote server. Enter the name of the correct queue to change it. Alphanumeric, 48 positions; required.

Screen Option	Procedure
Change a message queue	Enter the name of the queue to change it.

MQSeries Work with Messages Screen (Reviewing Messages)

Purpose: Use this screen to review the messages in the queue for a particular WMS process.

How to display this screen: Enter 10 next to a process at the Work with WMS MQ Job Control Screen.

MQSeries Work with Messages Queue Manager Name . . : CWIAS400 Queue name . . . . . . . PKMS.IMMEDNEED.OUT.BASE.50.QA Type options, press Enter. 5=Display Description 8=Display Data Opt Date Time Type UserId Format Size 20010702 16532113 DATAGRAM CMCNICHOLA MQSTR 1024+ 20010702 16532141 DATAGRAM CMCNICHOLA MQSTR 1024+ 20010702 16532166 DATAGRAM CMCNICHOLA MQSTR 1024+ 20010702 16532187 DATAGRAM CMCNICHOLA MQSTR 1024+ 20010702 16532234 DATAGRAM CMCNICHOLA MQSTR 1024+ 20010702 16532260 DATAGRAM CMCNICHOLA MQSTR 1024+ 20010702 16532279 DATAGRAM CMCNICHOLA MQSTR 1024+ 20010702 16532304 DATAGRAM CMCNICHOLA MQSTR 1024+ More... Command ===> F3=Exit F4=Prompt F5=Refresh F9=Retrieve F12=Cancel F16=Repeat position to F17=Position to F21=Print

Contact your MICROS representative for more information.

Clearing Queues

Purpose: From the Work with WMS MQ Job Control Screen you can clear the messages from the queue for a particular WMS process if it becomes necessary for any reason by entering 14 next to the process. The system displays the Queue Clear Warning pop-up window.

Queue Clear Warning Pop-up Window

Queue Clear Warning Queue is about to be cleared. Press F9 to clear the queue, or F12 to return and not clear the queue. F9=Accept Clear Request F12=Cancel

To clear: Press F9 to clear the message queue.