4. ofs responses

Open -inancial er(ice

TEMENO E#%"T*ON ENT&E Warning: This document, is protected by copyright law and international treaties. No part of this document may be reproduced or transmitted in any form or by any means, electronic or m echanical, for any purpose, without the express written permission of TEMENO !E"#$%"&TE& " %nauthori'ed reproduction reproduction or distribution of this presentation or any portion of it, may result in se(ere ci(il and criminal penalties, and will be prosecuted to the maximum extent possible under applicable law.) *nformation in this document is sub+ect to change without notice

Ob+ecti(es

 "t the end of this session you should be able to



#escribe the response to O- Tra Transaction nsaction / En0uiry re0uests

Transaction Transacti on &esponse 1 ample



3ou can see a 4familiar56 O- response message below

39087//1,CUSTOMER=100724:1:1,CATEGORY=1001:1:1,ACCOUNT.TITLE.1=AAA SHIPPING COMPANY OF PANAMA:1:1,SHORT.TITLE=AAA SHIPPING COMPANY OF PANAMA:1:1,POSITION.TYPE=TR:1:1,CURRENCY=US:1:1,CURRENCY.MAR!ET=1: 1:1,ACCOUNT.OFFICER=27:1:1,CONITION.GROUP=2:1:1,PASS"OO!=NO:1:1,OP EN.CATEGORY=1001:1:1,CHARGE.CCY=US:1:1,CHARGE.M!T=1:1:1,INTEREST.C CY=US:1:1,INTEREST.M!T=1:1:1,ALT.ACCT.TYPE=LEGACY:1:1,ALLO#.NETTIN G=NO:1:1,SINGLE.LIMIT=Y:1:1,RECOR.STATUS=INAU:1:1,CURR.NO=1:1:1,IN PUTTER=2$OFSUSER1$$$OFS$TEST."ATCH:1:1,ATE.TIME=0811012041:1:1,CO. COE=G"0010001:1:1,EPT.COE=1:1:1

O- Message yntax 8 Transaction &esponse -ormat

Transaction ID

 /

Message ID

 /

Success / Fail Indicator 

,

Returned Message Data

39087//1,CUSTOMER=100724:1:1,CATEGORY=1001:1:1,ACCOUNT.TITLE.1=AAA 39087// 39087//1,CUSTOMER=100724:1:1,CATEGORY=1001:1:1,ACCOUNT.TITLE.1=AAA //1,CUSTOMER=100724:1:1,CATEGORY=1001:1:1,ACCOUNT.TITLE.1=AAA 1,CUSTOMER=100724:1:1,CATEGORY=1001:1:1,ACCOUNT.TITLE.1=AAA SHIPPING COMPANY OF PANAMA:1:1,SHORT.TITLE=AAA SHIPPING COMPANY OF PANAMA:1:1,POSITION.TYPE=TR:1:1,CURRENCY=US:1:1,CURRENCY.MAR!ET=1: 1:1,ACCOUNT.OFFICER=27:1:1,CONITION.GROUP=2:1:1,PASS"OO!=NO:1:1,OP EN.CATEGORY=1001:1:1,CHARGE.CCY=US:1:1,CHARGE.M!T=1:1:1,INTEREST.C CY=US:1:1,INTEREST.M!T=1:1:1,ALT.ACCT.TYPE=LEGACY:1:1,ALLO#.NETTIN G=NO:1:1,SINGLE.LIMIT=Y:1:1,RECOR.STATUS=INAU:1:1,CURR.NO=1:1:1,IN PUTTER=2$OFSUSER1$$$OFS$TEST."ATCH:1:1,ATE.TIME=0811012041:1:1,CO. COE=G"0010001:1:1,EPT.COE=1:1:1 COE=G"0010001:1:1,EPT.COE=1:1:1%

Transaction response 4continued 6

Transaction ID



Message ID

 /

Success / Fail Indicator 

,

Returned Message Data

T&"N"T*ON *# 



 /

The transaction *# contains either the (alue supplied for the transaction in the re0uest or the (alue that is automatically generated by the TEMENO T7 application 4when no (alue is supplied in the re0uest6.

ME";E *# 

The Message *# contains the (alue of Message *# if supplied in the re0uest.

Transaction response 4continued 6

Transaction ID



 /

Message ID

 /

Success / Failure Indicator 

,

Returned Message Data

%E = -"*> *N#*"TO& 

*ndicates the status of the transaction re0uest processed. O- returns one of the following (alues: ?

uccessful transaction.

 1?

Errors encountered during processing.

 1

O(erride condition 4s6 encountered during processing.

 12

T7 ser(er is offline

Transaction response 4continued 6

Transaction Transaction ID



 /

Message ID

 /

Success / Failure Indicator 

,

Returned Message Data

&ET%&NE# ME";E #"T"  " successfully processed message will contain all the fields populated in the transaction. -ield and (alue pairs are separated by commas.



The format is the same as that of the re0uest message data.



 !owe(er for a unsuccessful transaction, the returned message data has a slightly different format.



Transaction response 8 &eturned Message #ata

Field Name

=

Field content

:

Multi value number 

:

Sub value number 



-ield Name 8The field name is as in the T"N#"&#.E>ET*ON record of the application.



Multi (alue number 8the multi (alue field number is returned.



ub (alue number 8the sub (alue field number is returned.



-ield content 8 the contents of the field

Transaction response 8 example ?

FUNS.TRANSFER,,SRI&ATS.1/1234'(7,,TRANSACTION.TYPE:=AC,E"IT.ACCT.NO:=4(11(,E" IT.CURRENCY:=EUR,E"IT.AMOUNT:=2000,CREIT.CURRENCY:=EUR,CREIT.ACCT.NO=19(23

FT030((001000001/TCS030((00001/1,TRANSACTION.TYPE=AC:1:1,E"IT.ACCT.NO=4(11(:1:1 ,CURRENCY.M!T.R=1:1:1,E"IT.CURRENCY=EUR:1:1,E"IT.AMOUNT=2000.00:1:1,E"IT.&AL UE.ATE=20030307:1:1,CREIT.ACCT.NO=19(23:1:1,CURRENCY.M!T.CR=1:1:1,CREIT.CURRE NCY=EUR:1:1,CREIT.&ALUE.ATE=20030307:1:1,PROCESSING.ATE=20030307:1:1,CHARGE.C OM.ISPLAY=NO:1:1,COMMISSION.COE=E"IT PLUS CHARGES:1:1,CHARGE.COE=E"IT PLUS CHARGES:1:1,PROFIT.CENTRE.CUST=100('7:1:1,RETURN.TO.EPT=NO:1:1,FE.FUNS=NO:1:1 ,POSITION.TYPE=TR:1:1,AMOUNT.E"ITE=EUR2000.00:1:1,AMOUNT.CREITE=EUR2000.00:1 :1,CREIT.COMP.COE=US0010001:1:1,E"IT.COMP.COE=US0010001:1:1,LOC.AMT.E"ITE= 1940.81:1:1,LOC.AMT.CREITE=1940.81:1:1,CUST.GROUP.LE&EL=99:1:1,E"IT.CUSTOMER= 100('7:1:1,CREIT.CUSTOMER=104':1:1,R.A&ICE.RE).Y.N=Y:1:1,CR.A&ICE.RE).Y.N= Y:1:1,CHARGE.CUSTOMER=104':1:1,TOT.REC.COMM=0:1:1,TOT.REC.COMM.LCL=0:1:1,TOT.RE C.CHG=0:1:1,TOT.REC.CHG.LCL=0:1:1,RATE.FI*ING=NO:1:1,TOT.REC.CHG.CRCCY=0:1:1,TOT .SN.CHG.CRCCY=0:1:1,STMT.NOS=&AL:1:1,O&ERRIE=E*REMFORM/FT+'01 FROM 100('7 NOT RECEI&E:1:1,RECORD.STATUS=INAU:1:1,CURR.NO=1:1:1,INPUTTER=32$SRI&ATS$$$OFS$TCS: 1:1,ATE.TIME=0412200('3:1:1,CO.COE=US0010001:1:1,EPT.COE=1:1:1

Transaction response 8 example 

FUNS.TRANSFER,/A,SRI&ATSAN.1/1234'(7,FT030((001000002

FT030((001000002/TCS030((0000(/1,TRANSACTION.TYPE:1:1=AC,E"IT.ACCT.NO:1:1=19(23 ,CURRENCY.M!T.R:1:1=1,E"IT.CURRENCY:1:1=EUR,E"IT.AMOUNT:1:1=2000.00,E"IT.&AL UE.ATE:1:1=20030307,CREIT.ACCT.NO:1:1=4(11(,CURRENCY.M!T.CR:1:1=1,CREIT.CURRE NCY:1:1=EUR,CREIT.&ALUE.ATE:1:1=20030307,PROCESSING.ATE:1:1=20030307,COMMISSI ON.COE:1:1=E"IT PLUS CHARGES,CHARGE.COE:1:1=E"IT PLUS CHARGES,PROFIT.CENTRE.CUST:1:1=104',RETURN.TO.EPT:1:1=NO,FE.FUNS:1:1=NO,POSIT ION.TYPE:1:1=TR,AMOUNT.E"ITE:1:1=EUR2000.00,AMOUNT.CREITE:1:1=EUR2000.00,EL I&ERY.OUTREF:1:1=200412210003'4229300900.1.1 E"IT A&ICE,ELI&ERY.OUTREF:2:1=200412210003'4229301910.2.1 CREIT A&ICE,CREIT.COMP.COE:1:1=US0010001,E"IT.COMP.COE:1:1=US0010001,LOC.AMT.E"I TE:1:1=1940.81,LOC.AMT.CREITE:1:1=1940.81,CUST.GROUP.LE&EL:1:1=99,E"IT.CUSTO MER:1:1=104',CREIT.CUSTOMER:1:1=100('7,R.A&ICE.RE).Y.N:1:1=Y,CR.A&ICE.RE). Y.N:1:1=Y,CHARGE.CUSTOMER:1:1=100('7,TOT.REC.COMM:1:1=0,TOT.REC.COMM.LCL:1:1=0, TOT.REC.CHG:1:1=0,TOT.REC.CHG.LCL:1:1=0,RATE.FI*ING:1:1=NO,TOT.REC.CHG.CRCCY:1:1 =0,TOT.SN.CHG.CRCCY:1:1=0,AUTH.ATE:1:1=20030307,STMT.NOS:1:1=13'0'0003'42291.0 0,STMT.NOS:2:1=12,O&ERRIE:1:1=E*REMFORM/FT+'01 FROM 104' NOT RECEI&E,CURR.NO:1:1=1,INPUTTER:1:1=32$SRI&ATS$$$OFS$TCS,ATE.TIME:1:1=041221114 4,AUTHORISER:1:1=3'$SRI&ATSAN$OFS$TCS,CO.COE:1:1=US0010001,EPT.COE:1:1=1

Transaction response 8 example 2

FUNS.TRANSFER,/R/&ALIATE,SRI&ATSAN.1/1234'(7,FT030((001000002

FT030((001000002/TCS030((00008/1,TRANSACTION.TYPE:1:1=AC,E"IT.ACCT.NO:1:1=19(23 ,CURRENCY.M!T.R:1:1=1,E"IT.CURRENCY:1:1=EUR,E"IT.AMOUNT:1:1=2000.00,E"IT.&AL UE.ATE:1:1=20030307,CREIT.ACCT.NO:1:1=4(11(,CURRENCY.M!T.CR:1:1=1,CREIT.CURRE NCY:1:1=EUR,CREIT.&ALUE.ATE:1:1=20030307,PROCESSING.ATE:1:1=20030307,COMMISSI ON.COE:1:1=E"IT PLUS CHARGES,CHARGE.COE:1:1=E"IT PLUS CHARGES,PROFIT.CENTRE.CUST:1:1=104',RETURN.TO.EPT:1:1=NO,FE.FUNS:1:1=NO,POSIT ION.TYPE:1:1=TR,AMOUNT.E"ITE:1:1=EUR2000.00,AMOUNT.CREITE:1:1=EUR2000.00,EL I&ERY.OUTREF:1:1=200412210003'4229300900.1.1 E"IT A&ICE,ELI&ERY.OUTREF:2:1=200412210003'4229301910.2.1 CREIT A&ICE,CREIT.COMP.COE:1:1=US0010001,E"IT.COMP.COE:1:1=US0010001,LOC.AMT.E"I TE:1:1=1940.81,LOC.AMT.CREITE:1:1=1940.81,CUST.GROUP.LE&EL:1:1=99,E"IT.CUSTO MER:1:1=104',CREIT.CUSTOMER:1:1=100('7,R.A&ICE.RE).Y.N:1:1=Y,CR.A&ICE.RE). Y.N:1:1=Y,CHARGE.CUSTOMER:1:1=100('7,TOT.REC.COMM:1:1=0,TOT.REC.COMM.LCL:1:1=0, TOT.REC.CHG:1:1=0,TOT.REC.CHG.LCL:1:1=0,RATE.FI*ING:1:1=NO,TOT.REC.CHG.CRCCY:1:1 =0,TOT.SN.CHG.CRCCY:1:1=0,AUTH.ATE:1:1=20030307,STMT.NOS:1:1=&AL,O&ERRIE:1:1= E*REMFORM/FT+'01 FROM 104' NOT RECEI&E,RECORD.STATUS:1:1=RNAU,CURR.NO:1:1=1,INPUTTER:1:1=32$SRI&ATS$$$OFS$TCS, ATE.TIME:1:1=0412211144,AUTHORISER:1:1=3'$SRI&ATSAN$OFS$TCS,CO.COE:1:1=US00100 01,EPT.COE:1:1=1

Transaction &esponse syntax 8 for incorrect data

Field Name



:

Multi value number 

:

Sub value number 

=

Error message

Error Message 8 When a attempt to store data in a field has failed, the error message is returned in place of field content

Transaction &esponse 8 for incorrect data portion FUNS.TRANSFER,/I/&ALIATE,INPUTT/123123,, TRANSACTION.TYPE=AC,E"IT.ACCT.NO=10103, E"IT.CURRENCY=AU,E"IT.AMOUNT=300,CREIT.ACCT.NO=10138,C REIT.CURRENCY=CHF



ample message contains debit currency which is NOT the currency of the account

FT080091P41//1/NO,DEBIT.CURRENCY:1:1=DEBIT ACCT CCY NOT EQ DEBIT CCY



Error message returned in place of #ebit urrency (alue

Transaction &esponse syntax 8 for incorrect messages

Error Message





The response format is different if an error occurs in the operation, option , user information or record id portion of the re0uest.  "n error message alone is returned

Transaction &esponse 8 for incorrect operation FUNS.TRANFER,/I/&ALIATE,INPUTT/123123,, TRANSACTION.TYPE=AC,E"IT.ACCT.NO=10103, E"IT.CURRENCY=CHF,E"IT.AMOUNT=300,CREIT.ACCT.NO=10138,C REIT.CURRENCY=CHF



ample message contains a mis1spelt -%N#.T&"N-E&

APPLICATION MISSING



Error message returned

Transaction &esponse 8 for incorrect option FUNS.TRANSFER,/I/PROCES,INPUTT/123123,, TRANSACTION.TYPE=AC,E"IT.ACCT.NO=10103, E"IT.CURRENCY=CHF,E"IT.AMOUNT=300,CREIT.ACCT.NO=10138,C REIT.CURRENCY=CHF



ample message contains a mis1spelt B&OE

IN&ALI &ALIATE/PROCESS/"UIL SUPPLIE



Error message returned

Transaction &esponse 8 for incorrect user information FUNS.TRANSFER,/I/PROCESS,INPUTT/12313,, TRANSACTION.TYPE=AC,E"IT.ACCT.NO=10103, E"IT.CURRENCY=CHF,E"IT.AMOUNT=300,CREIT.ACCT.NO=10138,C REIT.CURRENCY=CHF



ample message contains a wrong password

SECURITY &IOLATION



Error message returned

EN$%*&3 &EBONE

En0uiry &esponse 1 ample

EN)UIRY.SELECT,,INPUTT/123123,CURRENCYLIST

,-I::-I/NUM.CCY::C/NO.OF.ECIMALS::N O 56/)UOTATION.COE::)5 C;/AYS.ELI&ERY::6 >784> >2 > > > >1 > > 3.(72'0> > 3.(7300> > 3.(7200> >04 EC 07 10:22>,>AU> > 3(> >2 > >0 > >1 > > 0.9'000> > 0.94000> > 0.9(000> >04 APR 08 17:4'>,>CA> >124> >2 > > > >1 > > 1.2012'> > 1.201'0> > 1.20100> >04 EC 07 10:2'>,>CHF> >7'(> >2 > > > >1 > > 1.18(00> > 1.19(00> > 1.17(00> >04 EC 07 10:2'>

En0uiry and output

,-I::-I/NUM.CCY::C/NO.OF.ECIMALS::N O 56/QUOTATION.CODE::Quotation Co!/ AYS.ELI&ERY::6 >784> >2 > > > >1 > > 3.(72'0> > 3.(7300> > 3.(7200> >04 EC 07 10:22>,>AU> > 3(> >2 > >0 > >1 > > 0.9'000> > 0.94000> > 0.9(000> >04 APR 08 17:4'>,>CA> >124> >2 > > > >1 > > 1.2012'> > 1.201'0> > 1.20100> >04 EC 07 10:2'>,>CHF> >7'(> >2 > > > >1 > > 1.18(00> > 1.19(00> > 1.17(00> >04 EC 07 10:2'>

O- En0uiry &esponse 1 yntax

Header a!tion details

,

olumn Details

,

Returned Data

En0uiry &esponse syntax8 !eader aption part

Header a!tion Identi"ier 

=

Header Te#t

 /

,

!eader 1 ample

EN)UIRY.SELECT,,INPUTT/123123,CUSTOMER.POSITION, CUSTOMER.NO:E)=10028'

"EADER=#ID/"EADER=$ DIS%.CUST/"EADER=$ CUSTO&ER/"EADER=$ ACCT.O$$ICER' MOULE::M;6/T*N.REF::T55.R/ ISPLAY.NARRATI&E::?65 N55AC> >143(2> >MICROSOFT> >US> > 2,780,234,'(2.14 > >> >> > B >,>10028'> >MICROSOFT >,>> > >,>> >> >ACCRUE INTEREST ((7,((7.(9

>

When are headers shown5



!eaders are shown when an en0uiry field contains data meant to be displayed as a header 



Why5 -ixed column position

En0uiry &esponse syntax 1 olumn details olumn Identi"ier 

:

olumn Format T$!e

:

olumn %abel

/

,

'#ID::#ID/NU&.CCY::C()/NO.O$.DECI&A*S::No O+ D!(i,a-/QUOTATION.CODE::Quotation Co!/DAYS.DE*IERY::D!-i!) Da)/&ID.REA*.RATE::&i R!a- Dat!/BUY RATE::Bu) Rat!/SE**::S!-- Rat!/DATE.TI&E::Dat!,>AE> >784> >2 > > > >1 > > 3.(72'0> > 3.(7300> > 3.(7200> >04 EC 07 10:22>,>AU> > 3(> >2 > >0 > >1 > > 0.9'000> > 0.94000> > 0.9(000> >04 APR 08 17:4'>,>CA> >124> >2 > > > >1 > > 1.2012'> > 1.201'0> > 1.20100> >04 EC 07 10:2'>,>CHF> >7'(> >2 > > > >1 > > 1.18(00> > 1.19(00> > 1.17(00> >04 EC 07 10:2'>

En0uiry &esponse syntax 1 &eturned data olumn &alue n

Tab

,

HEAER=-I/HEAER=F ISP.CUST/HEAER=F CUSTOMER/HEAER=F ACCT.OFFICER, MOULE::M;6/T*N.REF::T55.R/ ISPLAY.NARRATI&E::?65 N55 >> >> > B >,>10028'> >MICROSOFT >,>> > >,>> >> >ACCRUE INTEREST ((7,((7.(9

>

Worshop 7.?



Modify the %&&EN31>*T en0uiry to include a header that will display todayFs date . Test if the header appears in the en0uiry response.

$ui'

?.

Which one these (alues in the success = fail indicator show that an o(erride condition was encountered.

a. b. c. d.

.

? 1? 1 12

What error message would this O- re0uest throw out5 -T,="=G">*#"TE,*NB%TT=?2?2,-TDADDCHC2?N

a. E%&*T3 G*O>"T*ON b. -T NOT ">>OWE# c. G">*#"TE OBT*ON NOT ">>OWE# -O& I"F -%NT*ON d.  "JJ&EG*"T*ON NOT ">>OWE#

$ui'

2.

When does an en0uiry response begin with a comma5

a.  "lways b. Ne(er  c. When there are no headers d. When there is no data returned by the en0uiry

7.

*n an en0uiry response each record 4line of information6is separated from another by

a.  " space b.  " tab c.  " comma d.  " field marer