switch_to_application

Syntax

switch_to_application <application code> [<application data parameters>];

Terse form

swa

Parameters

Sends an application-specific statement to the terminal.

References

TR-NWT-001273 Version 0-3.

Description

• <application code> is 4 alphanumeric, or 8 hexadecimal, characters that represent the 4-byte peripheral request. There must be no spaces between the characters. For example, MXPA and 4D585041 are equivalent.
• <application data parameters> are optional additional application specific parameters which may be coded as hexadecimal pairs or ASCII characters in quotes.
  Note: Parameter substitutions are possible with this statement.

Notes

The first four bytes form the application code. The data following is called the application data, and can be up to 248 bytes long. The application data is specified in hexadecimal or ASCII mode:

• Type ASCII text inside double quotation marks. Any data not within double quotation marks is assumed to be hexadecimal data.
• Specify hexadecimal numbers as two digits; for example, 45, 02, FE, fe. If the characters are outside the valid range (0 through 9, A through F, and a through f), an error is generated. Separate the hexadecimal numbers by a space.

Signal the switch to ASCII text data using a double quotation mark. Signal the switch back to hexadecimal using a second double quotation mark. Do not include double quotation marks in the ASCII text. For example:

05 33 "LINE ONE TEXT" FF "Simon’s text" FF

Parameter substitution is allowed within ASCII data. The substitution is indicated by preceding the parameter name with a dollar sign ($). The end delimiter of the parameter name is either a period (.), a space, or the end of the text data. Note that the period or space remains in the text. To create a $ symbol, use $$. For example, "Here is a $$ symbol".

The ADSI subsystem does not check that the application data is always valid (with and without substitutions).

Note also that parameter substitution strings have a maximum length of 40 characters. The compiler checks that the total length of the application data parameters does not exceed 248 bytes. However, the compiler has no control over the length of the data after parameters have been substituted. You should therefore check that the length of the data (after substitution) also does not exceed 248.