REXX Tips & Tricks:Non-REXX related information
This section contains some additional information that is not REXX related but nevertheless useful - at least for me 'cause I'm using REXX mostly for CID installations and upgrades :-).
Environment variables & system variables
This section contains information about environment variables and CONFIG.SYS statements used by OS/2 and other programs.
The information in this section is collected from various sources.
For further information about the CONFIG.SYS I strongly recommend the tool ConfigTool.
- Note
- The CONFIG.SYS used if using ALT-F1 while the white square box is visible and than "C" to boot to a command shell is the file \OS2\BOOT\config.x.
Simulating an AUTOEXEC.BAT for OS/2 sessions
To simulate an AUTOEXEC.BAT for OS/2 sessions you can change the \CONFIG.SYS statement for OS2_SHELL to something like
SET OS2_SHELL=C:\OS2\CMD.EXE /K C:\AUTOEXEC.CMD
In this example the program AUTOEXEC.CMD is executed for every new OS/2 session. (see also Special filenames)
You may use this feature to set LIBPATHSTRICT in every OS/2 session (#CONFIG.SYS statements used by OS/2)
Source: The OS/2 WARP Survival Guide
Hints for programs and driver loaded in CONFIG.SYS
This section contains hints for programs and driver loaded in the CONFIG.SYS.
Loading HPFS.IFS (WARP 4)
Use the undocumented switch /FORCE for this filesystem to force immediate access to a "dirty" HPFS partition. HPFS partitions get "dirty" if you don't shutdown OS/2 (e.g. after crashing the system).
Use the undocumented switch /QUIET for this filesystem to suppress all messages from CHKDSK. Note that /QUIET cannot be the last parameter.
Example:
IFS=C:\OS2\BOOT\HPFS.IFS /FORCE /AUTOCHECK:C
Warning: Use these parameters with extreme care! Use it only when you really need it!
- WARP 4 only!, Source: Team OS/2 WEB pages)
Loading IBMKBD.SYS (WARP 4)
The driver IBMKBD.SYS in WARP 4 accepts the parameters /NUMON and /NUMOFF to turn NUMLOCK on or off. These parameters used to work in the MERLIN Beta, but they are disabled in the WARP 4 GA.
CONFIG.SYS statements used by OS/2
This section contains some information about undocumented or poorly documented CONFIG.SYS statements used by OS/2.
- AUTOFAIL=x
- x maybe yes (no popup message for hard errors) or no (popup message for hard errors), default is no. Note that the DLL RXU contains a function to dynamically switch popup windows on and off.
- Available: All versions
- Source: various
- AUTOREFRESHFOLDERS=NO
- Suppress the automatic refresh of folder contents. If this feature is activated, you must manually refresh the view of a folder after each action
- Available: WARP 4 only!
- Source: various
- DLLBASING=OFF
- Reduce the fragmentation of loaded DLLs (ON by default)
- Available: WSeB or after applying FP13 to Warp4
- Source: various
- DUMPPROCESS=x
- Activate the dump process. The dump goes to the file PDUMP.nnn in the root directory of drive specified in x (where nnn is an unique number).
- Available: All versions
- Source: various
- EARLYMEMINIT=TRUE
- Adding "EARLYMEMINIT=TRUE" to config.sys will allow device drivers, etc., access to the memory above 16mb early in boot. Previously, this was only available after DD and IFS init was completed. This has various implications when enabled:
- large VDISKs are possible. I tried DEVICE=\os2\vdisk.sys 16000
- AHA154X.ADD may do bad things to your system. Don't even ask.
- There may be some settings of HPFS386 cache that are incompatible. This feature is experimental.
- Available: only available in the WARP kernels from testcase
- Source: various
- I13PAGES=1
- SMP kernels could not be RIPL-booted. As part of this, there is a new config.sys parameter I13PAGES= available. Adding I13PAGES=1 to config.sys (note, no SET) reduces the memory usage of the mini VDM processes used by ibm1s506.add and the GRADD drivers. This becomes important in RIPL-boot situations.
- Available: only available with Kernel 14.062 or higher
- Source: various
- MENUSTYLE=SHORT
- Disable some entries from the object context menus
- Available: All versions
- Source: various
- OBJECTSNOOZETIME=n
- n is the snooze time for objects and DLLs in seconds (default is 90) (see Note)
- Available: All versions
- Source: various
- PAUSEONERROR=x
- Pause after each error in the CONFIG.SYS (x=YES) or not (x=NO). Default is YES.
- Available: All versions
- Source: various
- REIPL=x
- Save trap information into a file and reboot the workstation (x=ON) or display an error message (x=OFF). Default is OFF.
- Available: All versions
- Source: various
- RESERVEDRIVELETTER=x
- "The ability to reserve drive letters feature has been added at WARP FixPak level XRUW024. A modification has been made to the OS/2 kernel that will allow the user to specify, through a CONFIG.SYS parameter, specific drive letters that will not be allocated for local block mode devices during the processing of CONFIG.SYS.
SYNTAX: RESERVEDRIVELETTER=x
where x is letter D thru Z. Multiple RESERVEDRIVELETTER statements is be allowed." - Available: WARP 3 FixPack #24 and newer (e.g. Warp4, WSeB,etc)
- Source: various
- SHAPIEXCEPTIONHANDLER=OFF
- Disable the WPS API exception handler (see Note)
- Available: All versions
- Source: various
- SHELLEXCEPTIONHANDLER=OFF
- Disable the WPS exception handler (see Note)
- Available: All versions
- Source: various
- SET DEVICEFONTDISABLED=NO
- Setting this to YES. will cause very large/slow print jobs, since no uploaded/internal printer fonts will be used. You want it set to NO in most cases (NO is the default).
- Available: WSeB and probably more recent WARP 3/4 fixpaks
- Source: Peter Fitzsimmons (see EMail Addresses)
- SET ENH_STRETCH=NO
- The new feature "enhanced stretch-blitting" has one known ill side-effect, where some of the icons for folders and other items will appear "washed out" when running in 24bpp or 32bpp. To fix this, you can disable the new feature by adding this line.
- Available: Warp 4 FP14 and newer (e.g. Warp4, WSeB,etc)
- Source: ConfigTool
- SET KILLFEATUREENABLED=on
- Activate the list of all processes in the WarpCenter (hold down CTRL and click on the windows icon on the WarpCenter to open the list).
- Note that you can also use SCKILLFEATUREENABLED.
- Available: WARP 4 only!
- Source: c't 1/1997
- SET LIBPATHSTRICT=x
- (x maybe T (true) or F (false)
Allows creation of a local version of the BEGINLIBPATH statement that can include DLLs that have the same name as globally loaded DLLs. The local DLLs are checked before the globals. Thus if your program has a DLL that is the same name as another, you can create a command file with the SET LIBPATHSTRICT=T, a SET BEGINLIBPATH=my program's dll, and the path & name of my program, and run your program. - Note that you must set this environment variable in an OS/2 session - an entry like "SET LIBPATHSTRICT=T" in the CONFIG.SYS is useless. (see also Simulating an AUTOEXEC.BAT for OS/2 sessions)
- Available: New kernel instruction in WARP kernels from testcase since September 1, 2000
- Source: ConfigTool
- SET MENUSFOLLOWPOINTER=ON
- This makes the WarpCenter menus behave like the Start menu of Windows 95: The menus follow the mouse pointer.
- Available: WARP 4 with Fixpack #5 or later
- Source: various
- SET NOLARGENTEXEICON=n
- Limit the number of megabytes (=n) the WPS should scan through Windows EXE files for the program icon before assigning a default icon
- Available: New kernels from testcase (APAR PJ27886)
- Source: XWorkplace Mailinglist
- SET NEWNOTEBOOKS=ON
- Enables the new notebooks for applications written prior to WARP 4
- Available: This setting worked in the MERLIN Beta, but seems to be disabled in WARP 4 GA.
- Source: various
- SET PM_ASYNC_FOCUS_CHANGE=x {time}
- Enable the SIQFix (Single Input Queue Fix) and set the custom time-out to time ms (default: 2000). Set x to OFF or remove the statement to disable the SIQFix
- Available: WARP 3 FixPack #17 and newer (e.g. Warp4, WSeB,etc)
- Source: various
- SET PM_DYNAMIC_DRAG=x
- Activate (x=ON) or deactivate (x=OFF, default) the full window drag for PM windows
- Available: WARP 3 FixPack #17 and newer (e.g. Warp4, WSeB,etc)
- Source: various
- SET PM_ROLLUP_BUTTON=YES
- Adds a new button to the window titlebars that you can use to "Roll up your PM windows to just a titlebar".
- Available: This setting worked in the MERLIN Beta, but seems to be disabled in WARP 4 GA.
- Source: Team OS/2 WEB pages
- SET PM_PRINTSCREEN_ACTIVE_WINDOW=x
- (x can be ON or OFF) If x is ON the window with the focus will print when a Print Screen operation is initiated. If x is OFF, the default Print Screen operation takes place.
- Available: Warp 4 FP13
- Source: ConfigTool
- SET QUEUE_SIZE_THRESHOLD=X
- Change the size of the message queue. Default is 100 for version prior to the WARP 3 Fixpack #17 and 3000 for the WARP 3 Fixpack #17.
- Available: WARP 3 FixPack #17 and newer (e.g. Warp4, WSeB,etc)
- Source: various
- SET RESTARTOBJECTS=x
- Control the restart behaviour of the WPS, x may be YES (default), NO, STARTUPFOLDERSONLY or REBOOTONLY.
- Available: All versions
- Source: various
- SET RUNWORKPLACE=C
- \OS2\PMSHELL.EXE:This statements points to the shell program to use - normally that's the program C:\OS2\PMSHELL.EXE. But you can change this to any other program if you want to restrict the PC to only run that program (e.g. SET RUNWORKPLACE=C:\OS2\MDOS\WINOS\PROGMAN.EXE).
- Available: All versions
- Source: various
- SET SCCANBENUKED=ON
- This makes the WARPCenter object "nukeable" i.e. you can right click and choose "Delete" which is not possible normally.
- If SCCANBENUKED does not work, try CANBENUKED.
- Available: WARP 4 only!
- Source: Team OS/2 WEB pages
- SET SCFINDUTILITY={anyprogram_or_anyObjectID}
- This allows you to define any external program (OS/2, DOS, Windows, or even an object ID like <WP_OS2SYS>!) for the flashlight icon on the WARPCenter. Click the little flashlight icon (WARPCenter) and you get whatever you specified.
- If SCFINDUTILITY does not work, try FINDUTILITY.
- Available: WARP 4 only!
- Source: Team OS/2 WEB pages
- SET SCKILLCONFIRMDISABLED=ON
- Avoid the "Are you sure dialog" if using the kill feature of the WARPCenter activated with SET KILLFEATUREENABLED=on. Note that you must also add the entry SET KILLCONFIRMDISABLED=1 to make this work.
- Available: WARP 4 only!
- Source: Team OS/2 WEB pages
- SET SCUSEPRETTYCLOCK=1
- Change the color of the clock from the WARPCenter to green on black
If SCUSEPRETTYCLOCK does not work, try USEPRETTYCLOCK.
- Available: WARP 4 only!
- Source: Team OS/2 WEB pages
- SET SHELLHANDLESINC=n
- Increment the number of file handles available to a shell process (e.g. a REXX program started by the CMD.EXE) by the amount of n. (see also Maximum files per session; tested only in WARP 4 with Fixpack #6)
- Available: WARP 4 with Fixpack #6
- Source: various
- SUPPRESSPOPUPS=x
- Save error information into the file POPUPLOG.OS2 in the root directory of the drive x and suppress the dialogs (On WARP 4 with Fixpack #3 x may be 0 to simulate the behaviour of OS/2 versions prior to this version).
- Available: All versions
- Source: various
- SXFAKEHWFPU=1
- Activate a fix for a "math rounding error" in WARP 4
- Available: WARP 4 only! Fixpack #1
- Source: WARP 4 Fixpack 1 documentation
- VIRTUALADRESSLIMIT=n
- (n is the limit in kb)
- The default value for VIRTUALADDRESSLIMIT in OS/2 Warp Server for e-business is 1 GB (n=1024). The VIRTUALADDRESSLIMIT parameter is also available for OS/2 Warp Server SMP Feature and Warp 4.0 Fixpak 13. Areas of memory below 512 MB have been remapped for higher availability in that region.
- 2048 allows max. memory allocated 2 Gigs of shared RAM. Only useful for developers.
- You must have a hard disk that can accommodate the swap file. UW2SCSIs are recommended for the swap disk unless you wish to see your computer behave like a washing machine in spin dry mode.
- The OS/2 Warp Server Advanced SMP addendum states that this number can go to 3 Gigs. Memory support has also been enhanced since now an application can access a virtual memory address space of up to 3 GB by use of the VIRTUALADDRESSLIMIT = 3072 parameter in CONFIG.SYS. Areas of memory below 512 MB have been remapped for higher availability in that region.
- Available: WSeB, Warp Server SMP, and Warp 4.0 Fixpak 13
- Source: ConfigTool
- VME=NO
- Turn "Virtual mode extension (VME)" off (see Note about VME)
- Available: All versions
- Source: various
Note about VME
"Virtual Mode Extensions is a hardware enhancement Intel added to their CPUs beginning with the DX2 models. All Pentium processors also come with this feature. VME is intended to speed up a number of privileged functions (CPU instructions) for applications running in virtual mode sessions (for example, DOS and WinOS2 sessions).
DOS (and Windows) apps running in an OS/2 Virtual DOS Machine (VDM) believe they "own" the hardware. On occasion these apps will try to do something to the (virtual) hardware that isn't permitted while a protected mode operating system such as OS/2 is in control of the real hardware because permitting such "privileged" operations would negatively impact overall system integrity and reliability.
On a non-VME processor attempting such privileged operations would result in a (hardware generated) program interrupt, and hence an operating system (in this case, OS/2) interrupt handler to get control. Control would eventually pass to a routine that would simulate the attempted function. On a VME processor the function simulation would be carried out by microcode on the processor itself. This is both transparent (to the operating system and app) and faster, BUT only if it works<g>.
Unfortunately there are apparently some conditions that can arise where this (usually) transparent handling of privileged operations (in effect, a hardware implemented microcode "assist") can leave the system in an inconsistent operating state. In this case the operating system will force a TRAP condition to protect itself (and YOUR data).
Adding the "VME=NO" line to "CONFIG.SYS" forces all VME "assisted" CPU instructions to be reflected to, and handled by, the operating system; in other words, the way it would have worked had the VME feature not have been present.
"VME=NO" is not a panacea fix for all your DOS/Windows woes. Indeed the most common symptom of VME related problems is frequent "Trap D" and "Trap E" errors in DOS and WinOS2 sessions. Therefore, I doubt it will correct all the problems you've listed, but it MAY provide some relief. Can't hurt to try.
Ron Higgin OS/2 Advisor! (see EMail Addresses)"
Environment variables used by OS/2
This section contains some information about undocumented or poorly documented environment variables used by OS/2.
Please note, that you must use SET name=value to use the environment variables!
- CONNECT_DASD=NO
- Turns off DASD checking while installing OS/2. This enables the user to install a product if the installation program thinks there is not enough diskspace (used by the OS/2 WARP Connect installation program)
- Available: All versions
- Source: various
- CONNECT_PREREQ=NO
- Turns off prerequisite checking. This enables the user to install a product when the installation program thinks that it cannot be installed (used by the OS/2 WARP Connect installation program).
- Available: All versions
- Source: various
- CONNECT_SNIFF=NO
- Turns off network card detection. This may be necessary if the detection logic hangs the machine while detecting adapters (used by the OS/2 WARP Connect installation program).
- Available: All versions
- Source: various
- COPYFROMFLOPPY=1
- Set to 1, if the OS/2 installation program should copy drivers from disk A: instead of copying this files from the CD-ROM
- Available: All versions
- Source: various
- DELDIR=path_for_the_deleted_files
- This is a real environment variable, see DELDIR
- Available: All versions
- Source: various
- DESKTOP=wps_directory|wps_object_ID
- Points to the WPS directory if the object ID <WP_DESKTOP> is missing in the ini file
- Available: All versions
- Source: various
- DIRCMD=default_dir_switches
- Used to set the default options for the DIR command DOSSETTING.{dossetting}={value}
- Use the value {value} for the setup string {dossetting} in the next DOS session opended with the START command. (see Start a program with specific settings for an example; WARP 4 only!).
- Available: All versions
- Source: various
- SOURCEPATH=os2_image_directory
- Points to the disk images used by the OS/2 installation program SYSINST2.EXE
- Available: All versions
- Source: various
- SYSTEM_INI=C
- \OS2\OS2SYS.INI
- This statement contains the path & name of the system ini file.
- Available: All versions
- Source: various
- TRUEMODE=1
- Set this environment variable to install the TrapDoor feature of WARP 4, even on a machine with SCSI HDs only.
- Available: WARP 4 only!
- Source: various
- USER_INI=C
- \OS2\OS2.INI
- This statement contains the path & name of the user ini file.
- Available: All versions
- Source: various
- VIDEO_DEVICES=env_var
- This statement sets the name of the OS/2 environment variable that contains the base video driver name.
- Available: All versions
- Source: The OS/2 WARP Survival Guide
- VIO_SVGA=DEVICE(BVHVGA,BVHSVGA)
- This statement selects the base video support.
- Available: All versions
- Source: The OS/2 WARP Survival Guide
- WIN3DIR=win311_directory
- This environment variable must point to the directory with your Windows 3.1 if using the TrapDoor feature of WARP 4.
- Available: WARP 4 only!
- Source: various
- WP_OBJHANDLE=n
- This environment variable contains the object handle for the current OS/2 session. This handle is unique for each OS/2 session started via an WPS Object. Note that OS/2 sessions started via the START command inherit the value from the parent.
- Available: All versions
- Source: various
DELDIR
You can change the environment variable DELDIR in OS/2 sessions to change the UNDELETE behaviour for a special session.
Examples:
REM *** OS/2 Batch file to change the DELDIR directory for one session SET DELDIR=C:\DELDIR1,512;D:\DELDIR_C,512;
REM *** OS/2 Batch to disable DELDIR, delete some files and enable REM DELDIR again
SETLOCAL SET DELDIR= DEL D:\TEMP\*.* ENDLOCAL
REM *** OS/2 Batch to change the DELDIR directory, delete some files REM and restore the DELDIR directory afterwards SETLOCAL SET DELDIR=D:\MY_DELDIR,512 DEL D:\TEMP\*.* ENDLOCAL
Note: This method is also possible in DOS sessions.
Environment variables used by other OS/2 programs
This section contains some information about undocumented or poorly documented environment variables used by other OS/2 programs.
- CSFCDROMDIR=path
- Points to the directory with the fixpack (used by SERVICE.EXE) CSFUTILPATH=path
- Points to the directory with the files from the kicker diskettes (used by SERVICE.EXE)
- EPFINSTDIR=path
- Points to the configuration files for the Software Installer/2 (default is \OS2)
- IBMWORKS_INI=path
- Points to the path for data files for the PIM from IBM Works
- IROPT=options
- Undocumented environment variable for Dualstor (IBM) possible values: d: no FIFO, D: use FIFO, x: 0.5 MBit/s, X: 1 MBit/s
- NCDEBUG=n
- Environment variable needed by Lotus 123 for video and audio playback
- REMOTE_INSTALL_STATE=x
- Environment variable used for CID installations. Warning: If this variable is defined, all installation programs created with Software Installer/2 will not display!
BEGINLIBPATH/ENDLIBPATH
You cannot use the "environment variables" BEGINLIBPATH and ENDLIBPATH (OS/2 Version 3.0 and above) in a REXX program because these are not real environment variables. Statements like
say " BeginLibPath=<" || value( "BEGINLIBPATH " ,, "OS2ENVIRONMENT") || ">" say " EndLibPath=<" || value( "ENDLIBPATH " ,, "OS2ENVIRONMENT") || ">"
will always return
BeginLibPath=<> EndLibPath=<>
To set the "variable" BEGINLIBPATH in a REXX program you must use the OS/2 command SET:
"SET BEGINLIBPATH=C:\MYLIBS"
If you try to modify BEGINLIBPATH/ENDLIBPATH with the SET command AND with the REXX function VALUE at the same time, OS/2 produces a strange result:
It creates two variables, both named BEGINLIBPATH (The correct variable is the variable with the blanks before and after the equal sign.). The environment variable BEGINLIBPATH set with the REXX function VALUE is only accessible with %BEGINLIBPATH% - the REXX function VALUE can not read the environment variable. To equalize this the CMD.EXE can't read the "variable" set with the SET command anymore if there's an environment variable set with the REXX function VALUE.
By the way: If you want to use the value of the "variable" BEGINLIBPATH set with the SET command in other OS/2 commands with %BEGINLIBPATH% you must write the name complete in uppercase. But, of course, there's also an exception to this rule: If you want to change the variable BEGINLIBPATH with a command like SET BEGINLIBPATH=%BEGINLIBPATH%;C:\newPart you can write BEGINLIBPATH in lowercase or mixed case also.
Additional note: The CMD.EXE does some validation for the value for BEGINLIBPATH - a value for this variable is only accepted if all parts of the value (separated with a semicolon ;) contain at least one : or \. An invalid part of the value and all parts behind the invalid part are ignored. And last: the maximum length for BEGINLIBPATH is 1024 characters.
Before I forget: The described behavior is also true for ENDLIBPATH -- at least one rule without an exception.
Last note: BEGINLIBPATH and ENDLIBPATH are not supported by 4OS2 until version 2.5a. JP Software recommends to use aliase like
BEGINLIBPATH=d:\path\cmd /c beginlibpath ENDLIBPATH=d:\path\cmd /c endlibpath
if you really want to use them in 4OS2 version 2.5a. In 4OS/2 version 2.51b, JP Software has fixed the problems that 4OS/2 was having with BEGINLIBPATH/ENDLIBPATH.
see also Detecting the LIBPATH values
Detecting some common SCSI adapters
You can use the EXE files in the directory \OS2\DRIVERS to detect if one of the common SCSI adapters is installed (common means: supported by OS/2). These files are detection modules used by OS/2 to detect the installed SCSI adapter.
A list of the used detection modules can be found in the file \OS2\INSTALL\SCSI.TBL. This list is used by the installation program.
Each of the detection modules returns 0 if the SCSI adapter is installed else a value not equal zero (1 or 255).
For additional information about this file see The Guide to OS/2 WARP Device Drivers (sg244627.boo).
OS/2 Traps
Trap Function OS/2 MSG (SYSxxxx) Likely cause under OS/2: ======================================================================== 0000 Divide error 3184 division by zero by OS/2 0001 Debug exception shouldn't occur 0002 NMI Interrupt memory parity or 387 error 0003 One Byte Interrupt shouldn't occur 0004 Interrupt on Overflow 3185 from INTO instruction 0005 Array Bounds Check 3191 from BOUND instruction 0006 Invalid OP-Code 3176 usually a corrupted .EXE 0007 Device not Available from ESC or WAIT instruction 0008 Double Fault shouldn't happen 0009 Reserved by Intel 000A Invalid TSS (Task State Segment) OS/2 bug - not a common bug 000B Segment not Present Can be a program or OS/2 bug 000C Stack Fault stack was ruined (not common) 000D General Protection Fault invalid pointer (most common) 000E Page Fault OS/2 bug, error in virtual mem 000F Reserved by Intel
To get more information about a specific trap use the HELP command with the parameter 1930+trap number.
Examples:
REM *** Help for Trap 2 (1930+2 = 1932) HELP 1932 REM *** Help for Trap 0E (1930+14 = 1944) HELP 1944
To find the program that caused a trap you can use the program exeinfo.exe (available on hobbes for example (see Internet - Web Pages)).
Search the line beginning with CS:EIP in the trap output and write down the number after CSLIM. After reboting the PC you can use the command
exeinfo -f -l####
(where #### are the last 4 digits of the number after CSLIM=) to get the program that caused the error.
Example: If the trap output contains the line
CS:EIP=0658:00001a5c CSACC=009b CSLIM=00004e3a
the exeinfo command is
exeinfo -f -l4e3a
Usage of RESERVE.SYS
Usage: basedev=reserve.sys arguments
Possible arguments are:
switch | format | example | description |
---|---|---|---|
/IO: | /IO:x,x | /IO:340,4 | Reserve IO ports. First number is base port in HEX, followed by length (number of ports) in hex. |
/P: | same as /IO: | ||
/MEM: | /MEM:x,x | /MEM:CA00,1000 | Reserve Memory. First number is base memory address (HEX), with assumption that the address is XXXX:0, followed by the length (number of address) in hex. |
/DMA: | /DMA:x | /DMA:2 | Reserve DMA Channel. Number is decimal. |
/IRQ: | /IRQ:x | /IRQ:13 | Reserve IRQ. Number is decimal. |
/EXC | /EXC | /EXC | Exclusive resource attribute |
/MUL | /MUL | /MUL | Multiplexed resource attribute |
/SHA | /SHA | /SHA | Shared resource attribute |
/GY | /GY | /GY | Grant Yield resource attribute |
/DW: | /DW:x | /DW:10 | Decode width of IO address. Valid numbers are 10 and 16. Only valid with /IO: switch. |
- Notes
- More than one resource attribute per resource entry is an error and not allowed. If no attributes or decode width is set, the default is EXCLUSIVE and 16.
- Examples
- To reserve IRQ 13 EXCLUSIVE, DMA 0 SHARED, MEMORY CA00:0 for 1000 bytes shared, IO ports 340 for 10 ports EXCLUSIVE and decode width 16, and IO ports 300 for 64 ports Grant Yield, with a decode width of 10 use:
BASEDEV=RESERVE.SYS /IRQ:13 /DMA:0 /SHA /MEM:CA00,3E8 /SHA /IO:340,A /IO:300,100 /GY /DW:10 - Note
- The syntax for the driver is documented in the Online documentation of WARP 4.
OS/2 Batch Programming
This section contains some hints for OS/2 batch programs.
Using sub routines in batch programs
@ECHO OFF REM ------------------------------------------------------------------ REM REM *** sample code to show how to use subroutines in OS/2 batch files REM REM ------------------------------------------------------------------ REM *** set a sample environment variable REM SET myEnvVar=1 REM ------------------------------------------------------------------ ECHO. [MAIN] The value of the environment variable "MyEnvVar" is %MyEnvVar% ECHO. [MAIN] Now MAIN calls "subroutine" SUB1 ... REM *** save the return address in an environment variable and call REM the "subroutine" REM SET retAddr1=RET001 GOTO SUB1 REM *** SUB1 jumps to this label to return to the caller :RET001 REM ------------------------------------------------------------------ ECHO. [MAIN] The value of the environment variable "MyEnvVar" is %MyEnvVar% ECHO. [MAIN] Now MAIN calls "subroutine" SUB2 ... REM *** save the return address in an environment variable and call REM the "subroutine" REM SET retAddr2=RET002 GOTO SUB2 REM *** SUB2 jumps to this label to return to the caller :RET002 ECHO. [MAIN] The value of the environment variable "MyEnvVar" is %MyEnvVar% REM ------------------------------------------------------------------ REM *** do something ... PAUSE REM *** set a sample environment variable REM SET myEnvVar=2 REM ------------------------------------------------------------------ ECHO. [MAIN] Now MAIN calls "subroutine" SUB1 ... ECHO. [MAIN] The value of the environment variable "MyEnvVar" is %MyEnvVar% REM *** save the return address in an environment variable and call REM the "subroutine" REM SET retAddr1=RET003 GOTO SUB1 REM *** SUB1 jumps to this label to return to the caller :RET003 REM ------------------------------------------------------------------ ECHO. [MAIN] The value of the environment variable "MyEnvVar" is %MyEnvVar% ECHO. [MAIN] Now MAIN calls "subroutine" SUB2 ... REM *** save the return address in an environment variable and call REM the "subroutine" REM SET retAddr2=RET004 GOTO SUB2 REM *** SUB2 jumps to this label to return to the caller :RET004 ECHO. [MAIN] The value of the environment variable "MyEnvVar" is %MyEnvVar% REM ------------------------------------------------------------------ REM *** house keeping REM SET retAddr1= SET retAddr2= SET myEnvVar= REM *** and end the program GOTO End REM ------------------------------------------------------------------ REM *** This is the "subroutine" SUB1 REM SUB1 has a local variable scope REM :SUB1 SETLOCAL ECHO. [SUB1] *** This is SUB1 (local variable scope) ECHO. [SUB1] The value of the environment variable "MyEnvVar" is %MyEnvVar% ECHO. [SUB1] Setting the variable "myEnvVar" to 11 SET myEnvVar=11 ECHO. [SUB1] The value of the environment variable "MyEnvVar" is %MyEnvVar% ECHO. [SUB1] Now SUB1 calls "subroutine" SUB2 ... SET retAddr2=SUB2_1 GOTO SUB2 REM *** SUB2 jumps to this label to return to the caller :SUB2_1 ECHO. [SUB1] The value of the environment variable "MyEnvVar" is %MyEnvVar% ECHO. ECHO. [SUB1] Now I am returning control back to the label %retAddr1% ENDLOCAL GOTO %retAddr1% REM ------------------------------------------------------------------ REM *** This is the "subroutine" SUB2 REM SUB2 has a global variable scope REM :SUB2 ECHO. [SUB2] *** This is SUB2 (global variable scope) ECHO. [SUB2] The value of the environment variable "MyEnvVar" is %MyEnvVar% ECHO. [SUB2] Setting the variable "myEnvVar" to 22 SET myEnvVar=22 ECHO. [SUB2] Now I am returning control back to the label %retAddr2% GOTO %retAddr2% REM ------------------------------------------------------------------ REM *** label marking the program end REM :END
Simulating SELECT in batch programs
@ECHO OFF REM REM *** sample code to show how to simulate SELECT in OS/2 Batch files REM REM This batch file simulates the following REXX code: REM REM parse arg val REM if val = '' then REM val = varA REM REM SELECT REM REM WHEN val=varA THEN REM say 'This is 'val REM REM WHEN val=varB THEN REM say 'This is 'val REM REM WHEN val=varC THEN REM say 'This is 'val REM REM WHEN val=varD THEN REM say 'This is 'val REM REM OTHERWISE REM DO REM say 'Invalid parameter 'val REM EXIT 255 REM END /* OTHERWISE */ REM REM END /* select */ REM REM EXIT 0 REM REM Note that this method is useful for processing parameter REM because it's not case sensitive. REM (see Using the SELECT simulation for parameter checking ) REM REM History: REM REM 01.02.1997 /bs REM - added code to simulate OTHERWISE also REM (based on code from Ralf Ulrich (see EMail Addresses)) REM REM REM ------------------------------------------------------------------ REM *** Use "varA" if the parameter is omitted REM SET var=%1 IF '%var%' == '' SET var=varA REM ------------------------------------------------------------------ REM *** Now goto to the appropriate label REM (or print an error message and exit if the label does not exist) REM REM GOTO x%var% 2>NUL || (ECHO.&ECHO.Invalid parameter "%var%"!&EXIT 255) REM -------------------------------------------------------- REM ^ REM This is the code for OTHERWISE REM Note that you CANNOT use a GOTO command here! If the REM first GOTO fails, the program is always aborted! REM REM *** The following are the labels for the known values REM REM In this example you can use the parameter varA, varB, varC, REM and varD. REM REM ------------------------------------------------------------------ :xVarA ECHO. This is "%var%" GOTO HouseKeeping REM ------------------------------------------------------------------ :xVarB ECHO. This is "%var%" GOTO HouseKeeping REM ------------------------------------------------------------------ :xVarC ECHO. This is "%var%" GOTO HouseKeeping REM ------------------------------------------------------------------ :xVarD ECHO. This is "%var%" GOTO HouseKeeping REM ------------------------------------------------------------------ REM *** house keeping :HouseKeeping SET var= REM *** and end the program GOTO End REM ------------------------------------------------------------------ REM *** label marking the program end :END EXIT 0
Using the SELECT simulation for parameter checking
@ECHO OFF REM ------------------------------------------------------------------ REM REM *** sample batch cmd to show a method for checking the parameter REM REM Note: The maximum length for a label is 8 characters! REM Therefore, GOTO L123456789A matches the label L12345678 REM and GOTO L12345678 matches the label L123456789A! REM REM This means, that parameter processed with this method REM can only have up to 7 characters (see note in line 25)! REM REM see also Sample code for parameter parsing REM REM ------------------------------------------------------------------ REM *** Special Parameter to distinguish between Pass1 and Pass2 REM SET sParm=$$PASS2$$ REM ------------------------------------------------------------------ REM *** Save the name of this program REM (necessary because we use the SHIFT command below!) REM SET sProg=%0 REM ------------------------------------------------------------------ REM *** check if this is a Pass1 or a Pass2 call REM (Note: The leading 'x' (or any other character) is necessary REM because a label must begin with a character!) REM IF '%1' == '%sParm%' GOTO x%2 REM ------------------------------------------------------------------ REM *** This is pass1 REM :$$Loop$$ REM *** The environment variable ParamOK is set to 1 in pass2 REM if the parameter was ok REM SET paramOK= REM *** check for further parameter REM IF '%1' == '' GOTO $$End$$ REM *** call this program again to check the parameter REM (suppress STDERR to avoid error messages for the not REM found labels in case of an unknown parameter) REM call %sProg% %sParm% %1 2>NUL REM *** process the next parameter REM SHIFT REM *** check if the parameter is known REM IF '%paramOK%' == '1' GOTO $$LOOP$$ REM *** Last parameter was unkown REM ECHO. Error: Do not know the parameter "%0"! GOTO $$LOOP$$ REM ------------------------------------------------------------------ REM *** code to process the parameter REM ------------------------------------------------------------------ REM *** This code handles the parameter Help, /help -help, ?, /? and -? REM in any case (mixed, upper and lower) REM :xHelp :x? :x/? :x/help :x-help :x-? ECHO. ECHO. Usage: %sProg% {anyParameter} ECHO. ECHO. Known parameter are: ECHO. ECHO. Help /help -help ? /? -? ECHO. /Param1 /Param2 ECHO. ECHO. in any case (mixed, lower or upper). ECHO. ECHO. The parameter found is "%2". ECHO. REM *** Signal 'Parameter is okay' to the calling program REM SET paramOK=1 REM *** and end pass2 REM GOTO $$End1$$ REM ------------------------------------------------------------------ REM *** This code handles the parameter /PARAM1 REM in any case (mixed, upper and lower) REM :x/PARAM1 ECHO. ECHO. Parameter /PARAM1 found! ECHO. (Parameter is "%2") REM *** Signal 'Parameter is okay' to the calling program REM SET paramOK=1 REM *** and end pass2 REM GOTO $$End1$$ REM ------------------------------------------------------------------ REM *** This code handles the parameter /PARAM2 REM in any case (mixed, upper and lower) REM :x/PARAM2 ECHO. ECHO. Parameter /PARAM2 found! ECHO. (Parameter is "%2") REM *** Signal 'Parameter is okay' to the calling program REM SET paramOK=1 REM *** and end pass2 REM GOTO $$End1$$ REM ------------------------------------------------------------------ REM *** exit label for pass1 REM Housekeeping epilog REM :$$End$$ SET sParm= SET sProg= REM ------------------------------------------------------------------ REM *** exit label for pass2 REM :$$End1$$
Using conditional command execution
For simple tasks you can use the unconditional and the conditional command execution of the CMD.EXE.
Command separator | Meaning |
---|---|
command1 & command2 | Execute command1; execute command2 regardless of the exit code of command1 |
command1 && command2 | Execute command1; execute command2 only if the exit code of command1 is 0. |
command1 | command2 | Execute command1 and command2; pipe STDOUT of command1 into STDIN of command2 (see Using PIPEs and Pipes & Errorlevel) |
command1 || command2 | Execute command1; execute command2 only if the exit code of command1 is NOT 0 |
Note: command1 and command1 can be an internal or external OS/2 command or two or more commands separated with one of the separators. Using parenthesis to group the commands is also possible. (constructions like (c1 && c2) || ( c3 && c4 || c5) are possible)
Examples:
@ECHO OFF REM *** Some examples for conditional command execution REM REM Note: This commands only work in Batch programs! REM (because of the format used for the placeholder) REM REM ------------------------------------------------------------------ REM *** copy all files in the current directory into the directory REM .\backup and print a success message for every file REM successfully copied REM @ECHO OFF for %%d in ( *.* ) DO ( @copy %%d backup\*.* 2>NUL >NUL && ECHO. %%d saved. ) REM ------------------------------------------------------------------ REM *** copy all files in the current directory into the directory REM .\backup and print an error message for every file REM that couldn't be copied REM @ECHO OFF for %%d in ( *.* ) DO ( @copy %%d backup\*.* 2>NUL >NUL || ECHO. Error copying %%d! ) REM ------------------------------------------------------------------ REM *** copy all files in the current directory into the directory REM .\backup and print a success or an error message for each REM file depending on the success of the copy command REM @ECHO OFF for %%d in ( *.* ) do ( ( copy %%d backup\*.* 2>NUL >NUL && ECHO. %%d saved. ) || ECHO. Error saving %%d ) REM ------------------------------------------------------------------ REM *** create a directory named BACKUP in the current directory, REM copy all files in the current directory into the directory REM .\BACKUP, delete all files successfully copied and REM print a success or an error message for each file REM depending on the success of the copy and del commands REM REM Note: Be aware that OS/2 starts a new CMD.EXE for each REM command string in parentheses! REM REM Note: Maybe you must read it more than one time to REM understand what's going on. REM (or look at the REXX program doing the same) REM @ECHO OFF ECHO. ECHO. Saving the files *.* into the directory .\backup md .\backup 2>NUL >NUL & cd .\backup && ( cd .. & for %%d in ( *.* ) do ( copy %%d backup\*.* 2>NUL >NUL && ( del %%d 2>NUL >NUL && ( ECHO. --- %%d saved and deleted. ) || ( ECHO. -W- %%d saved but not deleted. ) ) || ( ECHO. -E- Error saving %%d ) ) ) || ( ECHO. -E- Error accessing the directory .\backup! ) ECHO.
Note: Keep in mind that the maximum line length handled by the CMD.EXE is 1024!
Sample code for parameter parsing
@ECHO OFF @REM ***** CatchArg.cmd @REM ***** This is excellent code to parse parameter in Batch files @REM ***** @REM ***** Author: Ralf Ulrich (see EMail Addresses) @REM ***** @setlocal @echo off REM ***** Change "echo my_Progi" to the name of the program to run set PROGI=echo my_Progi&rem REM ***** &rem prevents from space to be inserted at the end! REM ***** This variable is used for the valid parameters checked so far set PARAM=&rem REM ***** This variable is used to save the order of the first 7 parameters set ORDER=$&rem REM ***** This variables used for --HELP message! set H1=%0 execs "%PROGI%" only with parameters in special order! set H2="/Arg1 /Arg3" or "/Arg2 /Arg3" or "/Arg3 /Arg1" REM ***** This is the main loop for the parameter processing :$Loop REM ***** check if there is a parameter IF '%1' == '' GOTO $End1 REM ***** Process the next parameter SHIFT REM ***** If Cmd.exe does not find the label, it shall not output REM ***** the SysError but echo defined Help (H1 & H2). goto X%0 2>NUL || (echo dismissed "%0" &echo %H1% &echo %h2%) REM ***** Or insert a default execution: (%PROGI% --Help) REM ***** Insert a label for every possible parameter :X/Arg1 set ORDER=%ORDER%1&rem set PARAM=%PARAM% %0&rem echo accepted "%0" goto $Loop :X/Arg2 set ORDER=%ORDER%2&rem set PARAM=%PARAM% %0&rem echo accepted "%0" goto $Loop :X/Arg3 set ORDER=%ORDER%3&rem set PARAM=%PARAM% %0&rem echo accepted "%0" goto $Loop :$End1 goto %ORDER% 2>NUL || (echo Invalid parameter order, possible: &echo %H2%) REM ***** Insert a label for every possible parameter order here REM ***** For example you can call this sample with the parameter REM ***** in the following order: REM ***** CatchArg.cmd /arg1 /arg3 :$13 REM ***** CatchArg.cmd /arg2 /arg3 :$23 REM ***** CatchArg.cmd /arg3 /arg1 :$31 REM ***** all other possible parameter orders are invalid! REM ***** if Cmd.exe does not find a fitting label it executes: REM ***** "echo Invalid parameter order, possible: &echo ..." REM ***** "PROGI" inserts the main code here: %PROGI%%PARAM% REM ***** Remember the first catch already inserted a space in front of PARAM REM ***** This label marks the end of the program :$End2
This section contains some information CID related information.
RSPINST return codes
RSPINST is the program used for the unattended installation of OS/2. When RSPINST encounters an error, it returns a non-zero return code to SEINST. SEINST displays this return code. This section provides a list of the return code definitions.
Source: OSINRMCD.TXT - RSPINST RETURN CODES 09/19/96 an IBM document.
Return code | Definition |
---|---|
702 | Invalid Line in response file. |
707 | Invalid Key Value. |
708 | No response file found. |
710 | Windows system missing or invalid. |
711 | Cannot format Windows partition if you support it. |
712 | Response file keyword conflict. |
901 | Partition Size Error. |
905 | FDISK unsuccessful. |
906 | Less than xMB primary partition exists. |
907 | Primary partition exists, greater than xMB available. |
908 | No primary partition exists, less than xMB available. |
909 | Greater than xMB primary partition exists. |
911 | Could not create a file. |
914 | System Installation detected an internal error. |
915 | System Installation failed to initialize. |
916 | System Installation failed to start the session. |
920 | Load Module Error. |
921 | Target Drive Error. Use FDISK to add target drive to Boot Manager Menu. |
932 | Copy File Error. |
933 | Delete File Error. |
934 | Device Configuration Error while determining system configuration. |
935 | Close File Error. |
936 | Make Directory Error. |
937 | Rename File Error. |
938 | Open File Error. |
939 | Read File Error. |
940 | Write File Error. |
941 | Format Error. |
942 | Display Panel Error. |
944 | Display Driver Install Error. |
945 | Format Error. The target drive is not formatted and format partition option was not selected. |
946 | Video System Error. |
947 | System Install Internal Error |
948 | Error accessing OS/2 ini file. |
949 | System File Transfer Error. |
950 | Unpack File Not Found |
951 | Unpack Partial Copy. |
952 | Unpack Ctrl+Break Error. |
953 | Unpack Critical Error. |
954 | Run Program Error. |
955 | Get/Set file Attributes Error. |
957 | Memory Allocation Error. |
1000-1020 | System Installation detected an internal error(00-20). |
1060 | Invalid Base Product Level, incorrect version. |
1061 | Invalid Base Product Level, incorrect type. |
1062 | Invalid Base Product Level, missing syslevel file. |
1063 | Memory Allocation Error |
1064 | CheckSum Failure, unable to OPEN or READ specified file. |
1065 | CheckSum Failure, unknown CheckSum return code. |
1066 | Invalid Base Product Level |
1067 | Invalid File System |
1068 | Microsoft Windows NT Files Found |
1069 | The version of OS/2 on the target system is newer than the OS/2 Installation files. |
NETBIOS return codes
;------------------------------------------------------------------ ;* NETBIOS RETURN CODES * ;------------------------------------------------------------------ NB_COMMAND_SUCCESSFUL EQU 0000H NB_ILLEGAL_BUFFER_LEN EQU 0001H NB_INVALID_COMMAND EQU 0003H NB_COMMAND_TIME_OUT EQU 0005H NB_MESSAGE_INCOMPLETE EQU 0006H NB_DATA_NOT_RECEIVED EQU 0007H NB_ILLEGAL_LOCAL_SESSION EQU 0008H NB_NO_RES_AVAILABLE EQU 0009H NB_SESSION_CLOSED EQU 000AH NB_COMMAND_CANCELLED EQU 000BH NB_DUPLICATE_NAME EQU 000DH NB_NAME_TABLE_FULL EQU 000EH NB_CMND_CMPL_DEREGISTERED EQU 000FH NB_SESSION_TABLE_FULL EQU 0011H NB_SES_OPEN_REJECTED EQU 0012H NB_ILLEGAL_NAME_NUMBER EQU 0013H NB_REMOTE_NAME_NOT_FOUND EQU 0014H NB_LOCAL_NAME_NOT_FOUND EQU 0015H NB_NAME_IN_USE EQU 0016H NB_NAME_DELETED EQU 0017H NB_SESSION_ENDED_ABNORMALLY EQU 0018H NB_NAME_CONFLICT EQU 0019H NB_INTERFACE_BUSY EQU 0021H NB_MAX_CMNDS_EXCEEDED EQU 0022H NB_INVALID_ADAPTER EQU 0023H NB_CMND_ALREADY_COMPLETED EQU 0024H NB_CMND_INVALID_TO_CANCEL EQU 0026H NB_NAME_DEFINED_BY_OTHERS EQU 0030H NB_ENVIRONMENT_NOT_DEFINED EQU 0034H NB_NO_OS_RESOURCES EQU 0035H NB_MAX_APPL_EXCEEDED EQU 0036H NB_NO_SAP_AVAILABLE EQU 0037H NB_INADEQUATE_RESOURCES EQU 0038H NB_INVALID_NCB_ADDRESS EQU 0039H NB_RESET_INVALID EQU 003AH NB_INVALID_DD_ID EQU 003BH NB_SEGMENT_LOCK_UNSUCCESSFUL EQU 003CH NB_DD_OPEN_ERROR EQU 003FH NB_OS_ERROR_DETECTED EQU 0040H NB_PERM_RING_STATUS EQU 004FH NB_UNEXPECTED_CCB_ERROR EQU 00F6H NB_ADAPTER_OPEN_ERROR EQU 00F8H NB_ADAPTER_HANDLER_ERROR EQU 00F9H NB_ADAPTER_CHECK EQU 00FAH NB_CODE_NOT_OPERATIONAL EQU 00FBH NB_OPEN_FAILURES EQU 00FCH NB_UNEXPECTED_CLOSE EQU 00FDH NB_COMMAND_IN_PROCESS EQU 00FFH
Undocumented entries for PROGMAN.INI
The following information is from a message in one of the usenet forums:
Add Restrictions for WinOS/2
This might be of some assistance until you find a solution to your security problem. When you get your WinOS2 sessions back in working order, you might be interested in disabling some of its functions by putting some lines in <bootdrive>:\OS2\MDOS\WINOS2\PROGMAN.INI. At the bottom of the file (or at the end of any section actually), start a new section called [Restrictions], then try any (or all) of the following lines.
[Restrictions] ; EditLevel=4 limits access to changing Groups and Items. EditLevel=4
; NoSaveSettings=1 disables this option. NoSaveSettings=1
; NoRun=1 disables Run on the File menu NoRun=1
; NoFileMenu=1 removes the File menu NoFileMenu=1
; NoClose=1 disable Close from the menus NoClose=1
If you do not use the FileManager, then you can remove its Item icon. It can still be accessed by double clicking its OS/2 icon in the Drives object.
Using redirection with TELNET
To use redirection of STDIN and/or STDOUT for a telnet session use tnpipe.exe instead of telnet.exe, e.g.
tnpipe 127.0.0.1
telnet.exe does not handle STDIN correct.
Use only '0A'x as line separator in the input for tnpipe. (see General input line enhancer for an example)
Please note that tnpipe.exe seems to be buggy:
After a number of calls of tnpipe.exe it's not possible to use more than one tnpipe.exe at the same time. The only solution for this problem is to reboot the machine.
Automatically FTP files to or from a client
Source: IBM Technical Document # - 17675356
To automatically FTP files to or from a client do the following:
Create a text file with the FTP commands (see below for an example) Set the environment variable NETRC with the fully qualified name of the file with the commands Enter ftp hostname at the command prompt, for example ftp rs6000
Example for a FTP command file (The machine is rs6000, the userid is bfw720 and the password is noa):
machine rs6000 login bfw720 password noa macdef init lcd c:/targetDir cd d:/sourceDir bin get file1.exe ascii get file2.txt bye
You can define more than one macro in the file; each macro must begin with
machine ... macdef init
Note that you must use the slash / instead of the backslash \ in path names. You can use all known ftp commands in the file (use the command help inside of ftp to get a list of all known commands). To automatically exit ftp after executing the commands the last command in the macro must be bye.
To define different commands for one host use hostname aliase: Add the aliase to the file /etc/hosts like
10.71.24.1 rs6000 rs6000a rs6000b rs6000c
and define different macros for each hostname.