Parameter 1 contains the name of the function IRXTXT is to perform. Parameter 2 specifies the text unit you want IRXTXT to retrieve for the particular function. The functions and their corresponding text units you can request are described below:

DAY

The DAY function returns the English name of a day of the week, in mixed case. The names that IRXTXT retrieves are the same values the TSO/E REXX interpreter uses for the DATE(Weekday) function.

The name of the day that IRXTXT retrieves depends on the text unit you specify in parameter 2. Table 1 shows the text units for parameter 2 and the corresponding day IRXTXT retrieves for each text unit. For example, if you want IRXTXT to return the value Saturday, you would specify text unit 3.

Table 1. Text unit and day returned - DAY function

Text unit	Name of day returned
1	Thursday
2	Friday
3	Saturday
4	Sunday
5	Monday
6	Tuesday
7	Wednesday

MTHLONG

The MTHLONG function returns the English name of a month, in mixed case. The names that IRXTXT retrieves are the same values the TSO/E REXX interpreter uses for the DATE(Month) function.

The name of the month that IRXTXT retrieves depends on the text unit you specify in parameter 2. Table 2 shows the text units for parameter 2 and the corresponding name of the month IRXTXT retrieves for each text unit. For example, if you wanted IRXTXT to return the value April, you would specify text unit 4.

Table 2. Text unit and month returned - MTHLONG function

Text unit	Name of month returned
1	January
2	February
3	March
4	April
5	May
6	June
7	July
8	August
9	September
10	October
11	November
12	December

MTHSHORT

The MTHSHORT function returns the first three characters of the English name of a month, in mixed case. The names that IRXTXT retrieves are the same values the TSO/E REXX interpreter uses for the month in the DATE(Normal) function.

The abbreviated name of the month that IRXTXT retrieves depends on the text unit you specify in parameter 2. Table 3 shows the text units for parameter 2 and the corresponding abbreviated names of the month that IRXTXT retrieves for each text unit. For example, if you wanted IRXTXT to return the value Sep, you would specify text unit 9.

Table 3. Text unit and abbreviated month returned - MTHSHORT function

Text unit	Abbreviated name of month returned
1	Jan
2	Feb
3	Mar
4	Apr
5	May
6	Jun
7	Jul
8	Aug
9	Sep
10	Oct
11	Nov
12	Dec

SYNTXMSG

The SYNTXMSG function returns the message text for a specific REXX syntax error message. The text that IRXTXT retrieves is the same text the ERRORTEXT function returns.

The message text that IRXTXT retrieves depends on the text unit you specify in parameter 2. For the text unit, specify the error number corresponding to the error message. For example, error number 26 corresponds to message IRX0026I. The message text for IRX0026I is:

Invalid whole number

This is the value the SYNTXMSG function returns if you specify text unit 26.

The values 1-99 are reserved for error numbers. However, not all of the values are used for REXX syntax error messages. If you specify a text unit in the range 1-99 and the value is not supported, IRXTXT returns a string of length 0.