Please enable JavaScript to view this site.

A-Shell Reference

Updated December 2013 (Added STR0)

OPTIONS=option {,option} {,option}...

The OPTIONS directive is used to set various options that don’t fall neatly into another category. You can specify several options on a single line separated by commas, or you can specify them using multiple OPTIONS directives.

Note also that the values for these options may be queried or changed by the subroutines MX_GETOPTIONS, MX_SETOPTIONS.

Options

Description

ABSLOOKUP

Causes LOOKUP to return a positive value.

AMOS_RUNSBR

Causes XCALL AMOS to execute commands as true subroutines.

AS400

Special AS400 Telnet option.

AUTO_MEMOPEN

Causes OPEN to see if file is already in memory.

AUTOTPRINT

Causes PRINT statements to act like Proportional Font Text Objects—i.e., create static text controls).

BRKALC

Pre-fill random files with ]]]]]]].

CRLF

Terminate sequential files with CRLF.

CRNL

Same as CRLF.

AUTODLGSTATE

Make the MBF2_DLGSTATE option be the default for all dialogs. If you set it as the default, the only way to turn it off for individual dialogs would be to use MX_SETOPTIONS (GOP2_AUTODLGSTATE ) to clear the flag before creating the dialog.

EFFUSR

Returns "effective user name."

EFS

Various options related to "EFS," A-Shell's encrypted file system

EXITWAIT

Causes A-Shell to wait for a keyboard response before closing the window down due to the –e switch, thus giving you a chance to read any final screen messages before the window is destroyed.

EXTFIO

Allows access to contiguous files that are NOT a multiple of 512 bytes.

FSPECNATIVE

Allow more flexibility for native file specs.

FIELDEMU

Emulate field terminal attributes.

FPROUND

Apply rounding factor of .000005 to INT and FIX.

GUI_SPC_IND

Tokenizes horizontal fixed-pitch spacing for use in variable-spacing GUI screens

HEXDEC

Special hexadecade date processing.

ISAM_IDXLOK

Causes the entire ISAM index file to be locked whenever it would otherwise only be necessary to lock the "rock" (i.e. during index update operations.) For reasons that no one understands, this actually seems to give better results in some Windows network environments.

LATIN1

Remap OEM character set to Latin1.

LONGDIR

Causes DIR.LIT to use the 10.4 format by default

NOAUTOX

Disables auto expansion of ISAM & INMEMO files; same as NOISAM_AUTOX.

NOAUTOXLT

(Windows only) Disables the automatic translation of the Pg-Up and Pg-Dn keys under A-Shell/Windows to Ctrl+R and Ctrl+T. This way you could translate the keys to something else. See FIXTRN.LIT.

NOFLDATTR

Discards field attributes.

NOINSTRX_PCP

No INSTR precompiled patterns.

NOISAM_AUTOX

Disables auto expansion of ISAM and INMEMO files; same as NOAUTOX.

NOJOBMAP

(Unix only) Prevents jobtbl.sys from being memory mapped. Normally jobtbl.sys will be memory mapped or not depending on whether qflock.sys (i.e. whether the QUEUE= parameter specifies "DISK" or "MEM"). The option is mainly of interest for debugging or other exotic situations.

NOSPACEATTR

Eliminates the automatic space associated with the on/off field attributes.

NOWHEEL

Disables the otherwise automatic conversion of the mouse wheel events into Up/Down-Arrow key presses.

NOXABORT

Prevents user from closing window containing an active program.

NTTS

Identifies A-Shell instances like NT Terminal Server sessions.

NUMPAD_COMMA

Converts the "." key on the number pad to a comma for the convenience of locales which use comma as the decimal point.

RAWTABS

(Unix variants only) Causes A-Shell to output raw tab characters rather than converting them to spaces. It would only be useful if your terminal emulator had some kind of special tab handling feature.

RC_DIMX

Tells the compiler to allow DIMX statements in /RC mode.

SBX_RUNDIR

Alters the search path for SBX modules.

SEQLOK

Enables locking on sequential files for Unix.

STR0

Causes numeric conversions to string, whether implicit or explicit, via str(x), to retain the leading zero for fractional values between -1 and 1. Normally the leading zero is stripped in all cases. For example, if x=0.5 and y=-0.3, str(x) and str(y) would normally return ".5" and "-.3" respectively, whereas with OPTIONS=STR0 set, the output would be "0.5" and "-0.3".

STRICT

Causes A-Shell to emulate various AMOS functions.

TRKTOPSTS

Causes PolyShell to treat the top status line as part of the screen.

XABORT

Generates error 255 when user tries to close window if program running.

XTAUTOFILTER

Automatically sets the XTF2_AUTOFILTER flag for all XTREE calls, enables XTREE auto-filtering.

 

History

2013 December, A-Shell 1369:  Add STR0.