# AG\_SBRFLAGS

> [HTML Version](ag_sbrflags.htm)

_Reviewed and revised December 2023_

**tab(-10, AG\_SBRFLAGS); opcode \{,flags1,flags2\}; chr(127);**     [Tab(-10,x) Syntax Notes](ag_xxx_syntax-notes.htm.md)

AG\_SBRFLAGS (102) allows dynamic retrieval and updating of SBR= flags from the client workstation (e.g. ATE).

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

**Parameters**

_opcode_

indicates the operation:

| **Value** | **Action** |
|------|------|
| 0 | retrieve current flags. opcode may be omitted entirely in this case. |
| 1 | replace existing flags with new flags1 and flags2 |
| 2 | ignore flags1; replace flags2 with new values |
| \+4 | Set the specified bits of flags1 and flags2  |
| \+8 | Clear the specified bits of flags1 and flags2 |




_flags1, flags2_

made up of bits as defined in [SOSLIB:ashell.def](https://bitbucket.org/microsabio/soslib/src/master/907016/ashell.def) in the SBRF\_xxx and SBRF2\_xxx symbols.

**Response**

For _opcode_ greater than 0, none. For _opcode_ 0, current flags values:

_flags1, flags2 _<CR>_   _Variables must accommodate at least 32 bits.

**See Also**

•	[MX\_SBRFLG](mx_sbrflg.htm.md)[xs](keyword-types.htm.md) for additional information

**History**

2012 December, A-Shell 6.1.1328:  Command added to A-Shell