Working with Required Responses (WREQ)

Purpose: Use this menu option to respond to Order Management System jobs that require user intervention in order to proceed.

Why would a job require user intervention?

• An error occurred during processing

• The job is used to send transactions to another system and communication failures occur before the transmission completes

Which types of job require user intervention?

• Stored Value Card (activation, balance inquiry and authorization reversal)

• Batch Authorization

• Batch Deposit

Required Response Processing

When a job requires user intervention, Order Management System:

1. Generates a Response Required Email, indicating a job requires user intervention.

2. Creates a record in the Response Required (MSRREQ) table. You can review the records in the Response Required table at the Work with Required Responses Screen.

3. Creates a message in the RESP.log indicating a job requires user intervention.

4. Order Management System waits 60 seconds for a user response.

5. After 60 seconds, Order Management System reviews the Response Required table to determine if a user responded to the response required message.

If a user responds: A user can respond to a job that requires user intervention at the Reply To Message Screen. If a user responds to a response required message, Order Management System:

• uses the response to proceed with the job.

• deletes the record from the Response Required table.

• creates a message in the RESP.log, indicating a user responded to the response required message.

If a user does not respond: If a user does not respond to a response required message, Order Management System looks at the RESPONSE_RETRIES property in Working with Admin Properties (CPRP) to determine the number of times it should look for a response for the job. Order Management System compares the Sent date and time to the Last polled date and time to determine if the number of times has been reached.

If the number of times to look for a user response has not been reached, Order Management System:

• updates the Last polled date and time in the Response Required table with the last polled date and time.

• After every fifth attempt, writes a message to the RESP.log, indicating a user response had not yet been received.

• goes back to sleep for another 60 seconds.

If the number of times to look for a user response has been reached, Order Management System:

• deletes the record in the Response Required table.

• uses a default response in order to proceed with the job. For example:

- the default response for a transmission job in a receive status is R (Resend).

- the default response for a transmission job in a sent status is C (Cancel).

Note:

- For the batch authorization job, the status of each record in the CC Authorization Transaction table remains in its current status so that you can use the Reprocess Authorizations Screen (RPAA) to recover the response.

- For the batch deposit job, the status of each record in the CC Deposit Transaction table remains in its current status so that you can use the Receive option in Processing Auto Deposits (SDEP) to recover the response.

• sends a Response Required Email, indicating the default response was used for the job.

• writes a message to the RESP.log, indicating the default response was used.

If a user deletes the response required message: If a user deletes a response required message at the Work with Required Responses Screen, the system:

• uses a default response in order to proceed with the job. For example:

- the default response for a transmission job in a sent status is C (Cancel).

- the default response for a transmission job in a receive status is R (Resend).

• sends a Response Required Email, indicating the default response was used for the job.

• writes a message to the RESP.log, indicating the default response was used.

Response Required Email

This email is generated when a Order Management System job requires a user response in order to proceed.

The RESPONSE_EMAILS setting in the Notify Properties defines the email address(es) that receive this email.

Order Management System generates an email when:

• A job initially requires user intervention.

• A user does not respond to the response required message and the default response was used.

Sample first email:

From:	cwjava@commercialware.com
To:	Karen Bottger
Subject:	Process Authorizations
Response required for job. Please go to WREQ to view the error and enter a response.

Sample second email:

From:	cwjava@commercialware.com
To:	Karen Bottger
Subject:	Process Authorizations
No response received after 5 attempts, default used.

Contents:

• From: The mail.from setting in the Email Properties file.

• To: The user name for the RESPONSE_EMAILS property in Working with Admin Properties (CPRP).

• Subject: Process, followed by the job name. For example, Process Authorizations.

• Body:

- First email: Response required for job. Please go to WREQ to view the error and enter a response.

- Second email: No response received after 5 attempts, default used.

RESP.log

Order Management System writes messages to the RESP.log file when a job requires user intervention.

Location: /domain/conf/OMSFiles/Logs/RESP/, where domain is the WebLogic domain directory for Order Management System on the application server.

Message	Written When
Deposits - Response required for job. E-Mail sent to:email1@cware.com; email2@cware.com	Order Management System generates a Response Required email, indicating a job requires user intervention. In this example, Deposits is the job name and email@cware.com is the email address to receive the Response Required email.
Deposits - Received R response from BMIRANDA	A user responded to a response required message at the Reply To Message Screen. In this example, Deposits is the job name and BMIRANDA is the user that responded to the job.
Deposits - No response after 5 attempts, will retry	Order Management System reviewed the Response Required table five times to determine if a user responded to the response required message. In this example, Deposits is the job name.
Deposits - No response after 10 attempts, will retry	Order Management System reviewed the Response Required table ten times to determine if a user responded to the response required message. In this example, Deposits is the job name.
Deposits - No response received, default response used	The number of times to look for a response in the Response Required table has been reached without a response from a user. Order Management System uses the default response for the job. In this example, Deposits is the job name.
Deposits - Response Required entry not found, default response used	A user deleted a response required message at the Work with Required Responses Screen. Order Management System uses the default response for the job. In this example, Deposits is the job name.

Work with Required Responses Screen

Use this screen to review the jobs that require user intervention in order to proceed.

Note: This screen is not company or user specific; all jobs that require user intervention display on the screen, regardless of the company where the job was submitted or the user that submitted the job.

How to display this screen: Enter WREQ in the Fast path field or select Work with Required Responses from a menu.

Field	Description
Message	Indicates the reason a job requires user intervention. For example, if transmission errors occur for a batch authorization: Error occurred during authorization transmission Alphanumeric, 75 positions; display-only.
Job	The name of the job that requires user intervention. Valid values are: • Stored Value Card • Authorizations • Deposit Display-only.
Sent	The date and time a Response Required Email was sent to the user, indicating a job requires a user response. Alphanumeric, 50 positions (YYYY.MM.DD HH:MM:SS format); display-only.
Last polled	The date and time Order Management System last reviewed the response required message to determine if a response was received from a user. Alphanumeric, 50 positions (YYYY.MM.DD HH:MM:SS format); display-only.

Screen Option	Procedure
Reply to a response required message	Select Change for a response required message to advance to the Reply To Message Screen.
Delete a response required message	Select Delete for a response required message to advance to the Confirm Delete window. At this window, select Delete to delete it. When you delete a response required message, Order Management System: • uses a default response in order to proceed with the job. • sends a Response Required Email, indicating the default response was used for the job. • writes a message to the RESP.log.

Reply To Message Screen

Purpose: Use this screen to reply to a job that requires user intervention.

An error message indicates if a job used the default reply while you were on this screen: Update not accepted - record has been changed by another user since it was displayed.

How to display this screen: Select Change for a job on the Work with Required Responses Screen.

Field	Description
Message text	Indicates the reason a job requires user intervention. For example, if transmission errors occur for a batch authorization: Error occurred during authorization transmission Alphanumeric, 75 positions; display-only.
Enter reply	Enter your response to the job. The Choices field provides a list of valid responses. Alphanumeric, 1 position; required.
Choices	The valid responses you can enter for a job that requires user intervention. Valid values are: • C = Cancel the job. • R = Resubmit the job. Alphanumeric, 1 position; display-only.
Job name	The name of the job that requires user intervention. Valid values are: • Stored Value Card • Authorization • Deposit Alphanumeric, 50 positions; display-only.
Message sent	The date and time a Response Required Email was sent to the user, indicating a job requires user intervention. Alphanumeric, 50 positions (YYYY.MM.DD HH:MM:SS format); display-only.

Required Response Setup

Purpose: In order to respond to Order Management System jobs that require user intervention in order to proceed, you must complete the required setup. Setup includes:

• Notify Properties

• Logging Properties

Notify Properties

In order to respond to Order Management System jobs that may require user intervention to proceed, you must set up the Notify Properties in Working with Admin Properties (CPRP).

Why would a job require user intervention?

• An error occurred during processing

• The job is used to send transactions to another system and communication failures occur before the transmission completes

Which types of jobs require user intervention?

• Stored Value Card (activation, balance inquiry or authorization reversal)

• Authorization (batch only, for all card types)

• Deposit

Property Name	Description
RESPONSE_RETRIES	The number of times Order Management System looks for a response to a job that requires user intervention before using the default response in order to proceed with the job. For example, if this setting is 5, Order Management System will look for a user response five times, waiting 60 seconds between each time.
RESPONSE_EMAILS	The list of email addresses that receive the Response Required email when a job requires user intervention. Each email address entered must be separated by a semi-colon (;). For example: email1@add.com;email2@add.com.

Logging Properties

Order Management System writes messages to the RESP.log file when a job requires user intervention. The Logging Properties in Working with Admin Properties (CPRP) contains settings for the RESP.log.

Property Name	Description
RESP_LOG_LEVEL	The level of logging for the RESP.log. Valid values are: • DEBUG = Generates fine-grained informational events. • INFO = Generates informational messages. • WARN = Generates warning messages. • ERROR = Generates messages that indicate a serious issue. • FATAL = Only generates messages that will cause the application to abort. The delivered logging level is INFO.
RESP_MAXBACKUP_ DAYS	The number of days to store an archived RESP.log before it is deleted. The delivered number of days is 30, indicates the system stores one month of RESP.log files. Order Management System stores one RESP.log per day. Files older than the current day are stored in zip format with the name: RESP.YYYY-MM-DD.log.zip.