Temenos T24 Media Subroutine Guide.doc SUBROUTINE GUIDE Introduction This guide

Temenos T24 Media Subroutine Guide.doc SUBROUTINE GUIDE Introduction This guide contains a list of the subroutines used most frequently by T24 applications and those which are most likely to be of use to developers on client sites. Wherever a subroutine is provided to perform a specified task, the subroutine provided should be used. Temenos reserves the right to modify the following routines as and when required. However, where possible, any such changes and the impact upon the use of the subroutines will be documented. Date Routines CDD Description Calculates the difference, in days, between two supplied dates Arguments (REGION, DATE1, DATE2, DAYS) Incoming REGION Region code DATE1 Start date, YYYYMMDD DATE2 End date, YYYYMMDD DAYS 'W' to indicate working days 'C' to indicate calendar days Returned DAYS The number of days difference, + or - CDT Description Calculates forward or previous date from a start date using the number of days. Arguments (REGION, DATE, DAYS) Incoming REGION Region code DATE Start date, YYYYMMDD DAYS The number of days forward in the format + or -, the number of days, working or calendar eg. +99C, - 6W, +66W+3C Returned DATE The calculated date ETEXT Error message if unsuccessful Page 1 Release T24R05 Temenos T24 Media Subroutine Guide.doc CFQ Description: Calculates the next date from today's date and a frequency code. Arguments: COMI from I COMMON Incoming: COMI YYYYMMDDXXXXX where XXXXX is the frequency code. Returned: COMI YYYYMMDDXXXXX the calculated date and the frequency code. DIETER.DATE Description: This routine converts dates from the format used throughout GLOBUS (YYYMMDD) to the standard UniVerse format (either internal or external. External dates formatted as per UniVerse CONVERSIONs) Arguments: GLOBUS.DATE, jBASE.DATE, CONVERSION Incoming: GLOBUS.DATE Date in Standard T24 Format (yyyymmdd) JBASE.DATE The date in internal jBASE date format, or formatted according to CONVERSION CONVERSION Any valid jBASE Date conversion Note that both DIETER and PRIME DATES cannot be passed. One date is mandatory Returned: GLOBUS.DATE Date in standard T24 format (yyyymmdd) JBASE.DATE The date in internal jBASE date format, or formatted according to CONVERSION JULDATE Description: Convert from Julian to Gregorian date format and visa versa Arguments: GREGORIAN.DATE,JULIAN.DATE Incoming: Page 2 Release T24R05 Temenos T24 Media Subroutine Guide.doc GREGORIAN.DATE Standard T24 Date in the format yyyymmdd JULIAN.DATE Julian Date in the format yyyyjjj One of the above dates must be passed to the subroutine; the other date must be null. Returned: GREGORIAN.DATE Standard T24 Date in the format yyyymmdd if passed as null JULIAN.DATE Julian Date in the format yyyyjjj if passed as null Exchanges Rates CALC.ERATE.LOCAL Description: This routine calculates an exchange rate given a foreign amount and local currency equivalent. Arguments: YLCL.AMT, YFOR.CCY, YFOR.AMT, YEXCH.RATE Incoming: YLCL.AMT Local equivalent amount YFOR.CCY Foreign currency YFOR.AMT Foreign Currency amount Returned: YEXCH.RATE The derived exchange rate CUSTRATE Description: Perform all the tasks involved in foreign exchange of two currencies on a buy/sell basis Arguments: CCY.MARKETS, BUY.CCY,BUY.AMT,SELL.CCY,SELL.AMT, BASE.CCY,TREASURY.RATE,CUST.RATE,CUST.SPRE AD, SPREAD.PCT,LOCAL.CCY.BUY,LOCAL.CCY.SELL, RETURN.CODE Incoming: CCY.MARKETS Is a multi-valued field containing the markets for the buy Page 3 Release T24R05 Temenos T24 Media Subroutine Guide.doc and sell side. This parameter needs be multi-valued only for Multi Market. For all cases where the buy and sell markets are the same, CCY.MARKETS should be a single value only. In case of two markets, the format should be: BUY.CCY.MKT:VM:SELL.CCY.MKT. BUY.CCY and SELL.CCY These are the currencies that will be involved in the transaction BUY.AMT and SELL.AMT These are the amounts that will be involved in the transaction. Only one is passed to the routine. The other is calculated from it and the customer rate BASE.CCY This is the currency in terms of which the RATES will be expressed TREASURY.RATE This is the rate at which the TREASURY will exchange the currencies CUSTOMER.RATE The rate at which the currencies will be exchanged for the customer CUSTOMER.SPREAD The difference between the TREASURY.RATE and the CUSTOMER.RATE SPREAD.PCT The percentage of the default CUSTOMER.SPREAD to be used in calculating the CUSTOMER.RATE Of the above parameters, only CCY.MARKETS, BUY/SELL CCY and one amount are mandatory. The other amount must be blank and only 1 of the CUSTOMER fields may have a value. NOTE: Only one CURRENCY.MARKET is mandatory. Returned: LOCAL BUY/SELL AMTS The local equivalents of the buy and sell amounts involved in this transaction. RETURN.CODE This holds the status of various test performed during the course of the routine. RETURN.CODE is a dynamic array composed of 4 fields, which are as follows: 1) Invalid input parameter - This is a fatal error and the routine will immediately terminate. In such a case, this field is set to one and an explanation of the error returned in ETEXT 2) Negotiable amount exceeded - The field is set to the amount by which the amount entered exceeds the negotiable amount for the relevant currency 3) Fixing date error - This field indicates which of the currencies has a FIXING DATE rate and the current date does not match the date the rate was last fixed. If this field is set then 1 indicates BUY.CCY is in error, 2 that it is the SELL.CCY and 3 that both are in error 4) Suspended market - This indicates that one of the currencies has had quotes suspended whether it be the LOCAL, BUY or SELL CCY. If the LOCAL is suspended, this automatically terminates the routine. For BUY and SELL, the routine is terminated only if the suspension Page 4 Release T24R05 Temenos T24 Media Subroutine Guide.doc indicator is not set to 'BLOCKED'. If the routine is terminated, a relevant message is returned in ETEXT. If the indicator is set, then its value is returned in RETURN.CODE. Note: Suspension of currencies is not currently available. EXCHRATE Description: Performs all the tasks involved in foreign exchange of two currencies Arguments: CCY.MKT,BUY.CCY,BUY.AMT,SELL.CCY, SELL.AMT,BASE.CCY,EXCHANGE.RATE, DIFFERENCE,LCY.AMT,RETURN.CODE Incoming: CCY.MKT The currency market in which the transaction will take place BUY.CCY and SELL.CCY The currencies that will be involved in the transaction BUY.AMT and SELL.AMT The amounts that will be involved in the transaction BASE.CCY The currency in terms of which the EXCHANGE.RATE will be expressed EXCHANGE.RATE The rate of exchange between the two currencies If any of these fields, with exception of BUY/SELL CCY and CCY.MKT are left blank, then they will be filled in by the routine if at all possible Returned: DIFFERENCE The difference between the figures given above and the internally generated BASE.CCY amount LCY.AMT The amount of the transactions in terms of the local currency RETURN.CODE The status of various tests performed during the course of the routine. RETURN.CODE is a dynamic array composed of six fields, which are as follows: - 1) Invalid input parameter - This is a fatal error and the routine will immediately terminate. In such a case, this field is set to 1 and an explanation of the error returned in ETEXT 2) Tolerance error - This is the signed percentage value by which the input rate differs from the calculated rate to 2 decimal places. This is only set if the error is greater than that permitted for the BASE.CCY. 3) Negotiable amount exceeded - The field is set to 1 if the BUY.AMT exceeds the NEGOTIABLE AMOUNT for the BUY.CCY. It is set to 2 if this is true for the SELL.CCY and 3 if true for both currencies Page 5 Release T24R05 Temenos T24 Media Subroutine Guide.doc FCY.CONVERT.CHECK Description: Performs the following functions: Converts a foreign amount to a local amount when a foreign amount is passed but not a local. Converts a local amount to a foreign amount when a local amount is passed but not a foreign. Calculates an exchange rate when both a foreign and local amount is passed. Recalculates foreign and local amounts and returns the difference. Calculates a percentage exchange rate difference when a rate is passed. Arguments: (FAMT, FCY, RATE, RATE.TYPE, LAMT, DIF.AMT, DIF.RATE) Incoming: FAMT Foreign amount FCY Foreign currency code, USD etc RATE Exchange rate RATE.TYPE Middle, buy or sell and the rate number 1, 2 or 3 in the format M1, B2, M3 etc. (default M1) LAMT Local amount Returned: FAMT When calculated LAMT When calculated RATE When calculated DIF.AMT The amount difference when calculated DIF.RATE The percentage rate difference when calculated MIDDLE.RATE.CONV.CHECK Page 6 Release T24R05 Temenos T24 Media Subroutine Guide.doc Description: Performs the following functions: Converts a foreign amount to a local amount when a foreign amount is passed but not a local. Converts a local amount to a foreign amount when a local amount is passed but not a foreign. Calculates an exchange rate when both a foreign and local amount is passed. Recalculates foreign and local amounts and returns the difference. Calculates a percentage exchange rate difference when a rate is passed. Note: The middle rate is used for all calculations unless a rate is explicitly passed. Arguments: (FAMT, FCY, RATE, MARKET, LAMT, DIF.AMT, DIF.RATE) Incoming: FAMT Foreign amount FCY Foreign currency code, USD etc RATE Exchange rate MARKET Currency market (default 1) LAMT Local amount Returned: FAMT When calculated LAMT When uploads/S4/ subroutine-guide.pdf

• Détails
• Publié le Sep 30, 2022
• Catégorie Law / Droit
• Langue French
• Taille du fichier 0.6228MB