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 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.
Parameters
opcode (Num) [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 INFLDxs. |
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 FLOCKxs. |
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 |
||
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 PRINTxs hdr |
SBRF2_PRINT_JOBUSN |
&h00000008 |
add user to PRINTxs 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 |
||
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
