T24 Frequently Used Core Routines.doc

S no

Core routine

Description

1

APP.STATIC.TEXT

2 3

AWD B.UPDATE.BATCH

4 5

BATCH.BUILD.LIST BD.CALC.DAYS

6 7

CACHE.READ CALC.ERATE.LOCAL

8

CALCULATE.CHARGE

9

CALENDAR.DAY

Returns array of application messages from the static text translation file. The messages are defined by the application and their translations (entered by the user) are read in at run time. Checks whether the given date is working day or not Adds a batch job to an existing batch process. Enables application programs to initiate ad-hoc jobs in the overnight run. Selects the IDs and builds the joblist for processing Calculation routine for interest accrual taking into account the AIBD. Read Parameter files This routine calculates an exchange rate given a foreign amount and local currency equivalent. Calculates charges, commission and tax amounts and returns enough information to raise the accounting entries. Calculates forward or previous date from a start date using the frequency Call Java program Calculates the difference, in days, between two supplied dates Calculates forward or previous date from a start date using the number of days. Calculates the next date from today's date and a frequency code. This routine will take a given category and sector and ensure that there is a match on the appropriate account class. This routine is used to check if a program is compiled or not. This is program will work in UV/jBASE. Program restores the common variables from a named common area that was saved earlier by COMMON.SAVE. This will return a populated CUSTOMER.POSITION record for a given account number and company. This subroutine will return any customers that are related. Perform all the tasks involved in foreign exchange of two currencies on a buy/sell basis

10 11

CALLJ CDD

12

CDT

13

CFQ

14

CHECK.ACCOUNT.CLASS

15

CHECK.ROUTINE.EXIST

16

COMMON.RESTORE

17

CUS.AC.EXTRACT

18

CUSTOMER.RELATIONS

19

CUSTRATE

20 21 22

DAS DBR DIETER.DATE

23 24

DISPLAY.MESSAGE DUP

Returns a field from a record for 'checkfile' processing. 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) Routine to display a status message for the user. Checks for duplicate occurrences of values in multi and sub-valued fields at cross-validation.

25

E.GET.LOCAL.AMT

Enquiry Subroutine to calculate the local currency equivalent using MIDDLE.RATE.CONV.CHECK Subroutine to return a calculated statement entry narrative for enquiry purposes. The narrative is calculated according the definitions in TRANSACTION, STMT.NARR.FORMAT and STMT.NARR.PARAM Application interface routine to the accounting system. Invokes the routines to validate & post entries, determines the suspense categories for value dated transactions (value dated accounting) and maintains currency positions. When Pricipal amount outstanding on the contract, ccy, rate and other details are passed as incoming parameters, this routine will return caculated repayment amount. When Pricipal amount outstanding on the contract, ccy, rate and other details are passed as incoming parameters, this routine will return Number of payments due. Calculate the yield to maturity or internal rate of return for a series of cash-flows This routine will clear each partfile is the file is distributed else a normal clear will be performed. Program to convert a currency amount to another currency amount This routine will determine the date a payment should be valued.Based on the day convention and the business centres,the value date for the schedules are determined. This routine formats rate values depending upon the system settings. If extended precision is on, the maximum no. of decimals allowed is 9 else it is 6. Total no of digits allowed for a rate value is 11. This routine will return an interest amount based on a given base amount at a specified rate. It will also return the rounded amount if the currency code is passed.

26

E.GET.STMT.NARRATIVE

27

EB.ACCOUNTING

28

EB.CALC.REPAYMENT

29

EB.CALC.TERM

30

EB.CALC.YTM.IRR

31

EB.CLEAR.FILE

32

EB.CURR.CONV

33

EB.DETERMINE.PAYMENT.DATE

34

EB.FORMAT.RATE

35

EB.INTEREST.CALC

36

EB.LOCREF.SETUP

37

EB.READ.HISTORY.REC

38 39

EB.READLIST EB.ROUND.AMOUNT

Routine to return a list of keys from a select statement. Formats amount according to currency definition, by: using, by default, two decimal places, OR, - using the defined number of decimal places for the currency, OR, - using the lowest unit of currency (e.g. 10, 0.05 etc.) AND -rounding according to the lowest unit

40

ERR

Displays error message on the same line as the input field or on line 22 if running under a multi-line version. Can be used only within the confines of a template program.

This routine will return the local reference data of a specified application. This subroutine will read a record from a specified HISTORY file Initially this will be used in EOD.CONSOL.UPDATE, but can be used elsewhere.

41

EXCEPTION.LOG

42

EXCHRATE

43 44

F.DELETE F.LIVE.WRITE

45 46 47 48 49

F.MATREAD F.MATREADU F.MATWRITE F.READ F.READ.HISTORY

50 51 52 53

F.READU F.READV F.WRITE FATAL.ERROR

54

FCY.CONVERT.CHECK

55

FIELD.NUMBERS.TO.NAMES

56

FIND.CCY.MKT

Log all EOD errors so they can be reported at then end of the EOD processing. 1) 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. 2) 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 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 return in RETURN.CODE. Note: Suspension is not currently available as an option in CURRENCY. 3) Tolerance exceeded - If the DIFFERENCE in terms of the local currency is greater than the maximum conv.tolerance for the company, then this is set to 'N' indicating the rate is out of bounds. If it is set to 'O' then the rate needs an override and if set to 'Y' then rate is okay. Deletes a record from a file writes the current details in the record to history and updates with new details to the record with the audit fields Read a dimensioned array from a file Read a dimensioned array record from a file with a lock Writes a dimensioned array (record) to a file Read a record from a file This subroutine will read a record from a specified HISTORY file Read a record with a lock Read a field on a record from a file Writes a record to a file Application fatal abort: displays an error message, exits from 'EX' and updates the PROTOCOL file. Should be called for all 'fatal' errors in both on-line mode and batch. Performs the following functions: a) Converts a foreign amount to a local amount when a foreign amount is passed but not a local. B) Converts a local amount to a foreign amount when a local amount is passed but not a foreign. C)Calculates an exchange rate when both a foreign and local amount is passed. d) Recalculates foreign and local amounts and returns the difference. e) Calculates a percentage exchange rate difference when a rate is passed. Converts fields numbers (as defined in the standard selection record) to field names Program to find currency market

57

FT.NULLS.CHK

This routine will check for a particular field, if the field has been expanded with extra multi- or sub-values, and if there are any null values.

58

GET.ACCOUNT.COMPANY

59 60

GET.COMPANY GET.LOC.REF

61

GET.NARRATIVE

This routine gives the correct lead company mnemonic for doing the OPF on the account file. This routine is used in places where the job runs in master company and the account records of the other book and other company have the limit that exist in the Master company attached to them. get the Lead company and its mnemonic details when application name, local field name is passed, this routine will return the local field position by refering to standard selection table Subroutine to return calculated statement narrative using TRANSACTION, STMT.NARR.PARAM and STMT.NARR.FORMAT applications.

62

GET.NEXT.ID

63

GET.SETTLEMENT.DEFAULTS

64

GET.STANDARD.SELECTION.DETS

65 66 67

GIT IDESC INP

68 69

JOURNAL.UPDATE JULDATE

70 71

LCK LIMIT.CHECK

72

LIMIT.CURR.CONV

73

LIMIT.GET.PRODUCT

when application informations are passed in common variables,this routine will return the new @ID. This routine is used to get the default account and settlement details for a particular customer and application. Defaults may be obtained from Portfolio (SEC.ACC.MASTER), AGENCY, CUSTOMER.CCY.ACCT or NOSTRO.ACCOUNT files. The routine reads the STANDARD.SELECTION record and merges the SYS and USR fields together. The routine contains a dimensioned cache of Standard Selection records T.SS.REC and dynamic list of Standard Selection ids T.SS.IDS. Subroutine to return the value of an I-descriptor. Routine to prompt for input and validate. Determine if we're running GUI and invoke the correct routine. Convert from Julian to Gregorian date format and visa versa Displays record locked message This subroutine is used by applications both online and end of day to verify and update the limits system. The application is required to supply the correct values from the transaction in order to give the correct update to the system. Program to convert a currency amount to another currency, assuming that the call parameters have previously been validated. The currency from is assumed to be the base currency. Xrate is calculated as to.rate/from.rate by this program. This routine will cater for conversion to a currency not defined in the current company. This subroutine is used by applications to validate and default the Limit Reference used in a given transaction. It is called as part of the cross-validation processing.

74

LOAD.COMPANY

75

LOCAL.PRINT

76

MIDDLE.RATE.CONV.CHECK

77 78

MSK OFS.CALL.BULK.MANAGER

79

OFS.POST.MESSAGE

80

OPF

81 82

OVE PRINTER.CLOSE

83

PRINTER.OFF

84

PRINTER.ON

85

PRO

86

PRODUCE.DEAL.SLIP

87 88

PST REBUILD.SCREEN

89

REFRESH.FIELD

90

REM

Builds and loads a company profile into I COMMON. This routine must be called for a change of company. Subroutine to print data to the local printer. Using a dumb terminal this is output via the slave printer port. When using GUI this is sent to the GUI Client which in turn prints it on the comx/lptx port. Performs the following functions: A) Converts a foreign amount to a local amount when a foreign amount is passed but not a local. B) Converts a local amount to a foreign amount when a local amount is passed but not a foreign. C) Calculates an exchange rate when both a foreign and local amount is passed. d)Recalculates foreign and local amounts and returns the difference. e) Calculates a percentage exchange rate difference when a rate is passed. f)Note: The middle rate is used for all calculations unless a rate is explicitly passed. Masks input to a specified format Routine to call OFS.BULK.MANAGER from an application used for performing OFS transactions within transaction boundary File open routine. Handles company modification of file name hence, it must be called for all file opens. Prompts for an override and validates Y/N input. Spools report as directed by the report control system. This subroutine must be used in place of the Data/Basic PRINTER CLOSE statement. Redirects output from the print unit to the screen. This routine must be used instead of the Data/Basic PRINTER OFF statement. Sets up the printer environment for the report and directs output to the print unit. This routine must be used instead of the Data/Basic PRINTER ON statement. Outputs a message to the protocol file for audit or exception purposes. Routine to format & print a deal slip based on the DEAL.SLIP.FORMAT parameters. The DEAL.SLIP argument can be a dynamic array of deal slip id's to be MERGED prior to output. Ie you could define a header format and then merge in the actual deal slip data. For output if the terminal supports a local printer then this is used otherwise it gets sent via report control. Opens/closes printer for output and defines headers Invokes MATRIX.ALTER to reset screen pointers for automatically expanded multi-values. This routine takes the field number, multi value and sub value specified in REFRESH.FIELD.NO and forces the redisplay of the field, and the enrichment. Displays a message on line 23 and prompts to continue.

91

RG.GET.LAST.MATCH

92

RG.GET.LOCAL.TEXT

93

SC.FORMAT.CCY.AMT

94

SPOOL.REPORT

95

STORE.END.ERROR

96

STORE.OVERRIDE

97

TRANSACTION.ABORT

98

TXT

99 100

TXTINP VALIDATE.SIGN.ON

101

WORKING.DAY

102 103

OFS.BUILD.RECORD

S.UPDATE.AUDIT.FIELDS 104

EB.HIST.REC.WRITE 105

106

EB.SET.NEXT.TASK OCOMO

Routine to return the last id from a list of ids which match the first few characters passed in argument FIRST.PART.ID. Repgen subroutine will get the description from REMARK field of a LOCAL.TABLE record. PGM.FILE entry to be used in REPGEN is RG.LOCAL.TABLE.TEXT. This subroutine will receive two parameters and returns the amount to the calling program formated to the correct number of decimal places including trailling zeros. Spools a report, which has not been created, by the report control system. This is only intended for use with COMO files. This routine must be used instead of executing a spool command. Routine to store error messages by field, to be displayed at the end of validation processing. Prompts for an override and stores the message in the main file record if the user replies 'Y'. Subroutine to cancel the current transaction and clear deferred write caches and releases locks. Translates dynamic messages. The message can contain a variable portion e.g. RATE 99.9999 EXCEEDS TOLERANCE BY 10%. Prompt user and accept user input Routine to validate sign on name & password. Handles all sms checks,protocol logging, expiration of passwords etc. finds out whether the start date and the end date are non-working dates.

Build OFS string Appends/updates the audit fields. Common variable "V" should be assigned with the last field number writes the current details in the record to history and updates with new details to the record with the audit fields Facilitates the automatic execution of a mainline process (subroutine or command) at the completion of another process Used for updating the comments in COMO record