# MX\_TITLE

> [HTML Version](mx_title.htm)

_Reorganized April 2024_

**xcall MIAMEX, MX\_TITLE, opcode, title**

MX\_TITLE (MIAMEX 85) gets or sets the title string which will be displayed in the Windows title bar or applicable terminal emulator.

**Parameters**

_opcode _ ([Num](num.md))  \[in\]

0 (mxop\_get) to retrieve the current title or 1 (mxop\_Set) to set it.

_title_  ([String](string.md))  \[in/out\]

is the title string, either returned for _opcode_ 0 (mxop\_get) or to set for _opcode_ 1 (mxop\_set). _title_ may contain any of the following special macros: 

| **Title** | **Meaning** |
|------|------|
| \$TS | Display title on top status line rather than on title bar of window. Valid only at the start of the TITLE string. |
| \$NC | Name of current program or LIT command |
| \$ND | Name of current disk device, e.g. "DSK0" |
| \$NJ | Name of current job |
| \$NP | Name of current program (RUN only) |
| \$PA | Platform A-Shell compiled for, e.g. "Windows/32" |
| \$PN | Current PPN, e.g. "\[7,6\]" |
| \$VA | A-Shell version, e.g. "4.9(942)"  |
| \$VP | Version of current program |




**Comments**

MX\_TITLE can also be performed using the SET.LIT TITLE option. Note that if \$NC, \$ND, \$NP, or \$PN is specified, the title display will be automatically updated whenever the corresponding information changes.