IN2 ROUTINES

Application Overview

This section describes the standard 'IN2' sections and their use of other 'T' table parameters.
Field N refers to the field in the dynamic array stored in the T () parameter.

Setting up the System

Alphanumeric

IN2A

Allows alpha-numeric input. Only the following characters will be accepted:

'A...Z', 'a...z', '0...9', space or '!"#$%&'()*+,-./[\]:;<=>?@^'

IN2AA

Allows the same characters as IN2A but the first character of the input string must be 'A...Z' or
'a...z'.

IN2AAA

Allows input strings containing 'A...Z' or 'a...z' only.

IN2S

Allows input of SWIFT characters. Only the following characters will be accepted:
'A...Z', '0...9', space or '()' +, -, '.
This character is not allowed to be first '-’

IN2SS

Allows the same character, as IN2S, but the first character of the input string must be 'A...Z'.

IN2SSS

Allows input strings containing 'A...Z' only.

Amounts

IN2 (no suffix)

This routine handles one of three types of editing:

• Simple numeric input

• Input within a specified range
 • Input matching a value in a specified table

Figure 1 - IN2 Routine Table

IN2AMT

This routine accepts input of an amount and can edit the input to have the number of decimal
places defined for a specified currency. The currency can be defined directly in the 'T' table
element or implicitly by reference to the value in another field, multi-value or sub-value in
R.NEW. The reference to another field can be dynamically linked with the respective multi-
value and/or sub-value of an association of multi-values and/or sub-values.

Input can be abbreviated by using 'T' and 'M' to express thousands and millions. Such input will
be expanded to the normal figure representation. The field will be redisplayed using a mask
inserting commas (or periods) at each thousand. Field 2 of the 'T' table element defines the
editing:

Figure 2 - IN2AMT Routine Table

IN2CCYDEC

This routine will accept a currency and an amount. The amount may have any number of
decimals up to the number defined in field 2,2 of the T table. The currency must exist as a valid
currency on the CURRENCY table.

Input can be abbreviated using 'H', 'T', 'M' and 'B' to express Hundreds, Thousands, Millions and
Billions. Such input will be expanded to normal figure representation. If the number of decimal
places is less than that of the currency then COM1 will be formatted to the number of decimal
places for that currency.

The field will be redisplayed with a space after the currency code and the numbers with commas
after each thousand.
 Figure 3 - IN2CCYDEC Routine Table

IN2DEC

This routine will accept an amount figure with a maximum and minimum number of decimal
places defined in the 'T' table. Input may be abbreviated using 'H', 'T', 'M' and 'B' to express
Hundreds, Thousands, Millions or Billions. Such input will be expanded to normal figure
representation.

The field will be redisplayed using a mask inserting commas at each thousand.

Figure 4 - IN2DEC Routine Table

Dates

IN2D

Will accept input in any of several valid date formats. The date input will be expanded to the full
date YYYYMMDD and displayed as DD MMM YYYY. Dates with two figure years will be
assumed to be from 1950 to 2049 inclusive unless field 2 of the 'T' table element is set to '1000'
when the date will be treated as prior to 1950.

Input must be in the format DD{MM{YY{YY{}}} or MM{DD{YY{YY}}} depending on the

date format set for the user, or may be in the internal eight numeric format of YYYYMMDD.

If the month or year is not supplied, they will be defaulted to those of the current bank date. The
month may be input as the 3-character abbreviation defined for the language of the user.

All dates will be converted to an internal format of YYYYMMDD (which is returned in

COMI).
IN2.ACCD

This routine will edit input, which is a combination of account number and date. See IN2ACC
and IN2D.

IN2.CCYD

This routine will edit input, which is a combination of currency and date. See IN2CCY and
IN2D.

IN2.D

This routine will edit input, which is a combination of numeric characters and date. See
IN2ACC and IN2.

IN2.YM

This routine is similar to IN2.D except that the date is in YYYYMM format. See IN2ACC and
IN2YM.

IN2FQU

This routine will accept a frequency consisting of a start date and a period code. The date may
be any valid date as for IN2D. If no date is entered, advancing the current bank date to the next
period date will generate a date.

The frequency code may be one of the following:

Figure 5 - IN2FQU Frequency Codes

IN2YM

This routine handles date in the same way as IN2D except that days are not allowed. The input is
converted into YYYYMM internal format.

Tables
Account Numbers

IN2ACC

Input must be a valid account number, i.e. as defined by the account mask and check-digit
defined on the COMPANY record. Input of an account mnemonic will also be accepted and
converted to the account number.

IN2ALL

This routine will accept input of all types of account numbers. It combines the functions of
IN2ACC, IN2INT and IN2ANT.

IN2ANT

Input of an account number as for IN2ACC or of an internal account number will be accepted.

IN2INT

The input must be a valid internal account number (6-12 alphanumeric characters).

Currency

IN2CCY

The input must be a valid ISO currency code. A numeric currency code will also be accepted
and will be converted to the ISO code.

Charges, Commissions and Tax

IN2CHG

Validates charge, commission or tax code. In order to obtain the relevant enrichment, this routine
should be called from within CHECK.FIELD. The enrichment is returned in COMI.ENRI.

Field 2 of the 'T' table defines which of the tables to validate against:

Figure 6 - IN2CHG Routine Table

These three values may be used in any combination separated by value marks, e.g. if one wishes
to validate against the CHARGE and TAX tables only then field 2 of the 'T' table would be
'CHG':VM:'TAX'.
Company

IN2COM

Input must be in valid company code format.

Customer

IN2CUS

Input must be a valid customer number, i.e. 1 - 10 numeric. Input of a customer mnemonic will
also be accepted and converted to the customer number.

Programs

IN2PG

This routine validates the program name input. If an abbreviated program name is entered it is
converted to its full program name and checked to ensure it is defined on the PGM.FILE. This
routine does not allow the input of program names set-up as versions, i.e. program names that
contain a ','.

IN2PV

This routine performs the same validation as IN2PG but allows input of program names defined
as versions.

IN2API

This IN2 routine allows the input to be:

1. A Subroutine - if it is defined in PGM.FILE as a S type program,

2. A Script – if it exists in SCRIPT.DESIGNER,
3. An Enquiry - if it exists in ENQUIRY
4. And a Crystal Report - if it exists in REPORT.CONTROL.

Unless it is a Subroutine, input has to be both type and name of the api call i.e. Scripts should
be prefixed with SPT, Crystal reports with RPT and Enquiries with ENQ.

Type and name should be separated by a space.

E.g.: ENQ ENQ.SEL.FIELDS

Note: If the input needs to be restricted to Subroutine names only, then specify T(Z)<2> =
‘SUB_ONLY’
Rate

IN2R

This routine allows the input of up to 12 numeric characters with a maximum of 8 digits before
the decimal place and a maximum of 6 decimal places. However if the EXTENDED.PREC is
turned on in SPF, this routine allows the input of up to 15 numeric characters with a maximum of
8 digits before the decimal place and a maximum of 9 decimal places.

Generic

IN2MNE

This routine edits the input to be a valid mnemonic string. The input may only contain '0...9',
'A...Z' or '.'.

IN2ANY

Allows input of any character.