Opsol ZLE Adapter for ATMs, POS Reference Manual Abstract Opsol ZLE Adapter for ATMs, POS is a software subsystem that facilitates the integration of ATM/ POS Host interfaces with the ZLE framework. This manual contains installation instructions and error messages. It is intended for the system administrator/installer. Product Version T0659V01_10AUG2004_ZLEADAP Part Number Published 528947-001 August 2004 ©Opsol Integrators Inc.
Table of Contents Introduction ............................................................................. 3 Installation............................................................................... 4 Installation Requirements .............................................................. 4 Installation Procedures .................................................................. 4 Sample Pathway obey files ............................................................. 7 STRTPATH ........................
Introduction Opsol ZLE Adapter for ATMs, POS devices is a software subsystem that facilitates the integration of ATM/ POS Host interfaces with the ZLE framework. This adapter enables the ATM/POS channels to provide transaction data for the ZLE implementation. In addition, the adapter can be a component of ZLE infrastructure by forwarding the value added offers/recommendations to the devices. The Adapter supports standard ISO 8583 message format.
Installation This section contains step-by-step procedures on how to install Opsol ZLE Adapter for ATMs, POS. Installation Requirements This subsection contains the steps necessary before beginning the Opsol ZLE Adapter for ATMs, POS installation procedure in the next subsection. • Install NonStop TS/MP on the HP NonStop system if it is not already resident. Set the Pathway "MAXLINKMONS" parameters to equal at least the number of CPU’s on the HP NonStop system.
STOPPATH 4. FTP the following files in binary mode to a Guardian location: DIST 5. Edit the STRTPATH and STOPPATH files and specify the appropriate pathmon process name for your environment. 6. Edit the PATHCONF file as follows: Common Parameters: a. Set the Pathway parameters to values appropriate for your environment. Set the Pathway "MAXLINKMONS" parameters to equal at least the number of CPUs on the Hp NonStop system. b.
k. Modify NSIM-DIST-TCP-NAME-1 to specify the name of the TCP/IP Process used for connection. The applications will use the IP address associated with this TCP/IP process and the port specified by NSIM-DIST-LISTEN-PORT param to communicate. l. Modify NSIM-LIC to specify the name of the license file. ZLEADAP Server Parameters: m. Modify ADAP-PCOL to specify the name of the primary EMS collector. n. Modify ADAP-DIST-PROCESS-NAME to specify the name of the DIST process. o.
x. Modify ADAP-IM-SERVERCLASS-NAME to specify the serverclass name of the IM server class. y. Modify ADAP-LIC to specify the License file name. 7. Start the Opsol ZLE Adapter for ATMs, POS pathway environment using the STRTPATH file. Refer to note at the end of this section. Note: See PATHCONF. the sample STRTPATH pathway configuration file At this point, applications can start sending transactions to the Opsol ZLE Adapter for ATMs, POS.
START PATHWAY COLD! OBEY SERVCONF SERVCONF RESET SERVER SET SERVER PROCESSTYPE GUARDIAN SET SERVER AUTORESTART 10 SET SERVER CREATEDELAY 1 MINS SET SERVER DELETEDELAY 10 MINS SET SERVER HIGHPIN ON SET SERVER LINKDEPTH 2 SET SERVER MAXLINKS 5 SET SERVER MAXSERVERS 1 SET SERVER NUMSTATIC 1 SET SERVER PARAM NSIM-PCOL "$zlec" SET SERVER PARAM NSIM-ACOL "$zlec" SET SERVER PARAM NSIM-SERVER-CLASS "ZLEDIST-01" SET SERVER PARAM NSIM-DIST-LISTEN-PORT "8091" SET SERVER PARAM NSIM-MAX-CONNECT-QUEUE "1024" SET SERVER P
SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER SERVER NUMSTATIC 1 CWD /zleadap ENV ADAP-PCOL="$zlec" ENV ADAP-DIST-PROCESS-NAME="$DZLE" ENV ADAP-LOG-NAME="log/adaplog" ENV ADAP-MAX-CONNECT="32" ENV ADAP-ZGATE-PATHMON-NAME="$ZLEPW" ENV ADAP-ZGATE-SERVERCLASS-NAME="GATEWAY-01" ENV ADAP-TRANSACTION-TIMEOUT="30" ENV ADAP-TRA
Messages Opsol ZLE Adapter for ATMs and POS logs messages in two places. EMS logs and log file. • Error opening file . Cause: Filesystem error returned while opening the file. Action: Correct the filesystem error and try again. • Error on Readupdatex. Cause: Filesystem error returned while opening the $Receive. Action: Contact product support. • SETMODE error. Cause: Filesystem error returned while issuing SETMODE. Action: Contact product support. • Error allocating memory.
• Unable to get my process name. Cause: Process name could not be obtained. Action: Contact product support. • Unable to get pathmon name, error . Cause: Pathmon name could not be identified. Action: Contact product support. • Unable to post READX on DIST. No Sockets available. Cause: Initial read on DIST failed. Action: Check if the DIST process is available. • Unable to find the parameter in pathway configuration. Cause: The parameter is not specified correctly.
• Unable to send message to IM, Pathmon err , file err . Cause: Error occurred while sending message to the Interaction Manager. Action: Correct the error conditions and try again. • Unable to parse ISO message. Cause: Unable to parse ISO Message, error . Action: This is an informational message. • Delayed response from Interaction Manager received. Cause: Late IM Response received. Action: This is an informational message. ©Opsol Integrators Inc.
