# MX\_SBRFLG

> [HTML Version](mx_sbrflg.htm)

_Rewritten May 2013_

**xcall MIAMEX, MX\_SBRFLG, opcode, flags1 \{flags2\}**

MX\_SBRFLG (MIAMEX 123) is used to programmatically retrieve and/or set A-Shell system options that are normally set with the SBR= statement in miame.ini.  See the system parameter [SBR](sbr_sp.htm.md) for more detailed descriptions of the various flags. An example is provided after the tables.

This function has both a [subroutine and a print tab implementation](subroutine-print-pairs.htm.md).

**Parameters**

_opcode_  ([Num](num.htm.md))  \[in\]

0 (MXOP\_GET) to retrieve the current flags, 1 (MXOP\_SET) to set them

_flags1_  (B,4 of F)  \[in/out\]

| **Symbol** | **Value** | **Meaning** |
|------|------|------|
| SBRF\_BSMID5 | \&h00000001 | Affects sequential serach in SERCH. |
| SBRF\_INFLD143 | \&h00000002 | Affects the operation of J justified types in INFLD[xs](keyword-types.htm.md). |
| SBRF\_INFLDPS | \&h00000004 | Impacts the operation of types "P" and "S" in INFLD. |
| SBRF\_INFLDB3 | \&h00000008 | Causes INFLD to add blank spaces for comma-formatted fields. |
| SBRF\_INFLDLDROP | \&h00000010 | Special handling for type "L" operation in INFLD. |
| SBRF\_MXLOCK | \&h00000020 | Forces XLOCK to conform exactly to standard documentation. |
| SBRF\_MESAGRTN | \&h00000040 | Changes behavior of MESAG. |
| SBRF\_MALLOCSORT | \&h00000100 | Affects the memory allocation strategy of BASORT. |
| SBRF\_COMMONNDR | \&h00000200 | Non-destructive read in COMMON. |
| SBRF\_PRTCHK1 | \&h00000400 | Causes PRTCHK to return 1 if printer is found, 0 if it is not. |
| SBRF\_PRINTNOFF | \&h00000800 | Eliminates formfeed character in PRINT. |
| SBRF\_XPPNOCT | \&h00001000 | Affects how XPPN displays PPN value. |
| SBRF\_AMOSJOB1 | \&h00002000 | Causes JOBNAM to return the name of the parent job. |
| SBRF\_TRIMCTL | \&h00004000 | Causes TRIM to remove leading and trailing control characters. |
| SBRF\_INFLDR | \&h00008000 | Causes INFLD to not apply right-justification to the returned field. |
| SBRF\_INFLDEDIT | \&h00010000 | Provide support for a variation of INVUE. |
| SBRF\_AXLOCK | \&h00020000 | Causes A-Shell to exactly duplicate the behavior of XLOCK under AMOS. |
| SBRF\_LSTLINSTRIP | \&h00040000 | Strips comments from command line before returning them to LSTLIN. |
| SBRF\_PGRW\_TTI | \&h00080000 | Affects how INFLD type codes **\$** and **H** are handled. |
| SBRF\_BOX\_MINATTR | \&h00100000 | Minimizes the use of attributes (particularly reverse video) used with certain box drawing operations (particularly INMEMO). |
| SBRF\_INFLD\_V1 | \&h00400000 | Eliminates the need to specify the V parameter to INFLD. |
| SBRF\_EZPRTX | \&h00800000 | Causes EZTYP to use EZPRTX. |
| SBRF\_FLOCKD | \&h01000000 | Disables validation of the file channel and record number parameters in FLOCK[xs](keyword-types.htm.md). |
| SBRF\_FLOCKL | \&h02000000 | Backs up FLOCK exclusive record locks with LOKSER locks (provided that LOKSER is enabled). May be useful when different applications (one using FLOCK, the other LOKSER) share files. |
| SBRF\_INFLD\_KEEPALIVE | \&h04000000 | Sends a few bytes every 15 seconds while waiting for input. |
| SBRF\_PCKLST\_GUI | \&h08000000 | Use XTREE (GUI) in place of PCKLST (text) |
| SBRF\_INFLDCBRJ | \&h10000000 | Right-justifies text label. |
| SBRF\_SUBMIT2 | \&h20000000 | Forces a new process to be the grandchild of the current process. |
| SBRF\_NO\_MMAP | \&h40000000 | Disables memory mapping in certain ERS proprietary subroutines. |
| SBRF\_XMASCB\_OPEN | \&h80000000 | Optimize file open/close in XCALL xMASCB (ignores redundant open, explicit close; auto-close at program end). |
| **Definition file: [ashell.def](ashell_def.htm.md)** | | 

[Hex-Decimal Values](hex-decimalvalues.htm.md)



_flags2_  (B,4 of F)  \[in/out\]

Note that for opcode 1, if flags2 not specified, no changes will be made to those flags; in other words, the absence of the _flags2_ parameter is not equivalent to a parameter containing zero.

| **Symbol** | **Value** | **Meaning** |
|------|------|------|
| SBRF2\_GUISELPOS | \&h00000001 | INFLD GUI caret at start |
| SBRF2\_AUTO\_TABX | \&h00000002 | auto add MBF2\_TABX to MBF\_TAB |
| SBRF2\_PRINT\_TIME | \&h00000004 | add time to PRINT[xs](keyword-types.htm.md) hdr |
| SBRF2\_PRINT\_JOBUSN | \&h00000008 | add user to PRINT[xs](keyword-types.htm.md) hdr |
| SBRF2\_AUTO\_DLGMAX | \&h00000010 | auto max dlgs > desktop |
| SBRF2\_INFLD\_PRINTS | \&h00000020 | INFLD ^P : File>Printscreen |
| SBRF2\_XTREE\_EXPCSV | \&h00000040 | XTREE add Export CSV to mnu |
| SBRF2\_XTREE\_EXPTSV | \&h00000080 | XTREE add Export TSV to mnu |
| SBRF2\_XTREE\_EXPOPEN | \&h00000100 | XTREE open after export |
| SBRF2\_XTREE\_PRINT | \&h00000200 | XTREE add print to mnu |
| SBRF2\_XTREE\_SRCH | \&h00000400 | XTREE add search to mnu |
| SBRF2\_EFS\_CLR\_ON\_EXIT | \&h00000800 | Clear EFS key on exit |
| SBRF2\_XTREE\_EXPCSV2 | \&h00001000 | XTREE add |
| SBRF2\_XTREE\_EXPCSV2XL | \&h00002000 | XTREE add |
| SBRF2\_INFLD\_NOPRINTS | \&h00004000 | Disable INFLD ^P print screen function |
| **Definition file: [ashell.def](ashell_def.htm.md)** | | 



**Example**

To retrieve the current SBR= flags and then set or clear the SUBMIT2 flag:

map1 sbrflags1,b,4

map1 sbrflags2,b,4



    xcall MIAMEX, MX\_SBRFLG, MXOP\_GET, sbrflags1, sbrflags2   \! retrieve

    sbrflags1 = sbrflags1 or SBRF\_SUBMIT2                     \! set SUBMIT2

or

    sbrflags1 = sbrflags1 and not SBRF\_SUBMIT2                \! clear SUBMIT2

    xcall MIAMEX, MX\_SBRFLG, MXOP\_SET, sbrflags1, sbrflags2   \! set



**Comments**

MX\_SBRFLG normally only operates relative to the server. In the ATE environment, use the AG\_SBRFLAGS command to retrieve/set the client flags.

**See Also**

•	[AG\_SBRFLGS](ag_sbrflags.htm.md)