OS/2 Shareware BBS: 18 REXX

home *** CD-ROM | disk | FTP | other *** search

/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / cmdpk164.zip / xhelp001.msg < prev next >

Wrap

Text File | 1998-01-03 | 28KB | 433 lines

<TOPIC NAME="versionString"><HTML>1.64</TOPIC>    <TOPIC NAME="invalidOptionMsg"><HTML>Error in &cmd;: Unknown option (%a).</TOPIC> <TOPIC NAME="abortMsg"><HTML> &cmd; was interrupted per user request.</TOPIC>  <TOPIC NAME="welcomeMsg"><HTML> MLRXSHL (w) (c) 1994-97 Martin Lafaix CommandPak &version; (w) (c) 1997-98 Ulrich Möller Welcome to CmdShl! Type <A HREF="">help</A> to find out more about the new functions in this package. Press Alt+F4 or type <A HREF="">exit</A> to get back to where you came from. </TOPIC> <TOPIC NAME="bookshelfMsg"><HTML>SEARCH mode. Searching %a for "%b" as a background process...</HTML></TOPIC> <TOPIC NAME="callViewMsg">VIEW mode. Opening %a... </TOPIC> <TOPIC NAME="analyzeMsg">HTML mode. Analyzing data</TOPIC> <TOPIC NAME="formattingMsg">HTML mode. Formatting data</TOPIC> <TOPIC NAME="noViewMsg"><HTML>Error in xhelp: The OS/2 Information Presentation Facility (VIEW.EXE) is not available.</TOPIC> <TOPIC NAME="topicNotFoundMsg"><HTML>Error in xhelp: Help topic "%a" not found.</TOPIC> <TOPIC NAME="HTMLerror"><HTML> Error in xhelp: xhelp crashed in line %a processing HTML: </TOPIC> <TOPIC NAME="versionMsg"><HTML>CommandPak is currently at version level &version;</TOPIC>   <TOPIC NAME="helpHelpFirst"><HTML>This is an overview of MLRXSHL/CommandPak (type <A HREF="">help <command></A> for more): <UL FIRST=2 NEXT=16><LI>cd<TAB>can now change drives also and remembers the last directory. <LI>dir / ls<TAB>is a new and all-improved DIR command with coloring and more. <LI>ren / mv<TAB>extended rename and move; extra features <LI>alias<TAB>lets you define your own commands. <LI>def<TAB>can redefine keys, even with whole command lines. <LI>rule<TAB>lets you define rules for command-line editing. <LI>rx<TAB>allows you to process REXX commands at the command line. <LI>recurse<TAB>will execute a command line recursively in subdirectories. <LI>open<TAB>will open a directory as a WPS folder. <LI>ln<TAB>will create "links" via WPS shadows. <LI>pushd / popd<TAB>will save/recall directories. <LI>less<TAB>is a far better "more" than "more". <LI>query<TAB>is a command for querying different system information. <LI>fl<TAB>is a more-or-less graphical directory browser. </UL>Type <A HREF="">help <command></A> to find out more about a certain <command>. Type <A HREF="">help keys</A> to read a summary of the new command-line editing functions. Type <A HREF="">help ref</A> to view the online reference with an in-depth introduction and reference on CmdShl and the other functions. Type <A HREF="">help help</A> to learn about usage of the "help" command. Type <A HREF="">exit</A> to close this session. </TOPIC> <TOPIC NAME="helpHelp"><HTML>&cmd; &version; (w) (c) 1997-98 Ulrich Möller <UL NEXT=3><TAB>Typing "&cmd;" will offer you information more quickly. This will either display a text-mode help message (provided mostly in HTML format) or open up one or several of the available INF files. Try typing <A HREF="">&cmd; ref</A> to access the online reference of MLRXSHL/CommandPak.</UL> Usage:<UL FIRST=2 NEXT=22><LI>&cmd; -c <TAB>For info on CmdShl itself (built-in). <LI>&cmd; -x<TAB>Show some examples of "&cmd;". <LI>&cmd; <topic><TAB>If <topic> is a known command: display its help. If <topic> is an INF file: display the whole book. If <topic> is a text or HTML file: display it formatted. Otherwise, the bookshelf is searched for <topic>. <LI>&cmd; keys<TAB>explain new command-line editing features <LI>&cmd; list<TAB>show what's accessible to &cmd; <LI>&cmd; <inf> <topic><TAB>search the book <inf> only for <topic>; you can search several books by combining them with the "+" sign. <LI>&cmd; "<text>"<TAB>display <text> directly; can be HTML <LI>&cmd; [sys|rex]<num><TAB>explain OS/2 system/REXX error <num></UL> You can also use the quesion mark ("?") instead (e.g. <A HREF="">? rexx</A>). Note: The external help will only return anything if the OS/2 help system is available. Type <A HREF="">exit</A> to close this session. </TOPIC> <TOPIC NAME="helpHelpExampl"><HTML>Examples of using help: <UL FIRST=3 NEXT=23><LI>help quit<TAB>will display info on built-in "quit" command <LI>help rexx <TAB>will show REXX.INF <LI>help ibm1s506<TAB>will search all books for IBM1S506 <LI>help cmdref dir<TAB>will search CMDREF.INF for "dir" <LI>help ref rx<TAB>will search the online reference for "rx" <LI>help 2166<TAB>will describe OS/2 SYS2166 error <LI>? 2166<TAB>should do also <LI>? ?<TAB>help on "help" </UL>Type <A HREF="">help help</A> to review the options. </TOPIC> <TOPIC NAME="keysHelp"><HTML>Help for command-line editing The following keys have been assigned special functions to: <UL FIRST=3 NEXT=20> <LI>Tab<TAB>auto-complete currently begun element <LI>&uarrw;|&darrw;<TAB>browse through command line history (last 100 entered commands) <LI>F1<TAB>auto-complete currently begun element from command history <LI>Ctrl+R<TAB>search command-line history <LI>Ctrl+F<TAB>search next match in command-line history <LI>Ctrl+{&larrw;|↝}<TAB>jump to previous | next word in line <LI>Esc<TAB>clear whole line <LI>Ctrl+Home<TAB>erase from beginning of line to cursor <LI>Ctrl+End<TAB>erase from cursor to end of line <LI>Ctrl+&darrw;<TAB>save current screen <LI>Ctrl+&uarrw;<TAB>restore last stored screen <LI>Ctrl+NumPad "+"<TAB>swap screens <LI>Alt+F4<TAB>close session </UL>Type <A HREF="">help ref editing</A> for details.</TOPIC> <TOPIC NAME="helpList"><HTML>The following commands will be explained with <A HREF="">help <command></A>: <UL FIRST=3 NEXT=3><LI>alias cd copy cp def del dir exit help fl for ln ls less mv open pushd popd query quit recurse ren rule rx sdir ver watchdrv xcp xdir xhelp xren</UL> The following online (INF) books can be accessed with <A HREF="">help <book></A>: <UL FIRST=3 NEXT=3><LI></TOPIC>  <TOPIC NAME="aliasHelp"><HTML>alias (CmdShl built-in): view, add or remove an alias <UL NEXT=3><TAB>With aliases, you can define your own commands within CmdShl. Aliases are best defined in profiles; type <A HREF="">help ref profile</A> for more. </UL>Usage: <UL FIRST=3 NEXT=20><LI>alias <alias>=[<string>|@<filespec>] <UL FIRST=10 NEXT=23><LI><alias><TAB>an alias name (case sensitive!) <LI><string><TAB>the new value for alias; %[<n>][*] denotes command line parameters. If <string> is empty, the alias will be removed. <LI><filespec><TAB>a file containing one (or more) alias definitions </UL><LI>alias list<TAB>view all currently defined aliases </UL>Type <A HREF="">help ref alias</A> for examples and more information.</TOPIC> <TOPIC NAME="cdHelp"><HTML>cd (CmdShl built-in): change directory <UL NEXT=3><TAB>Use "cd" or "chdir" to change the current directory, have the current directory displayed, or substitute parts of the current directory path.</UL> Usage: <UL NEXT=20><LI>cd<TAB>to display the current directory <LI>cd <path><TAB>to change the current directory to <path>; this may also include a drive letter. <LI>cd ..<TAB>to change to the parent of the current directory <LI>cd -<TAB>to go back to the previously used directory <LI>cd <s1> <s2><TAB>to substitute <s1> by <s2> in current directory </UL>Type <A HREF="">help ref cd</A> to find out more. <A HREF="">pushd</A> and <A HREF="">popd</A> are also useful to remember directories.</TOPIC> <TOPIC NAME="cmdshlHelp"><HTML>CmdShl (w) 1995-1997 Martin Lafaix <UL NEXT=3><TAB>CmdShl is the core of MLRXSHL and the CommandPak. It enhances your command shell by providing a new front-end for your existing command processor. </UL> Syntax: cmdshl [/I|/O] [/P <profile>] [/C|/K <cmd>] <UL NEXT=20><LI>/I<TAB>Insert mode is the default. <LI>/O<TAB>Overstrike mode is the default. <LI>/P<TAB>Use the specified <profile> file. <LI>/C<TAB>Execute <cmd> and exit CmdShl. <LI>/K<TAB>Execute <cmd> without exiting CmdShl. </UL>By default, Insert mode is on and PROFILE.SHL is used as profile file if it exists along the path specified by the DPATH environment variable. Type <A HREF="">help ref cmdshl</A> for the online reference of CmdShl.</TOPIC> <TOPIC NAME="copyHelp"><HTML>&cmd; &version; (w) (c) 1997-98 Ulrich Möller - extended COPY <UL NEXT=3><LI>Use &cmd; to duplicate a file. Type <A HREF="">help ref xcp</A> for details.</UL> Usage:<UL FIRST=3 NEXT=45><LI>&cmd; [-bdfitvq...] <filespec> [<newspec>] <UL FIRST=6 NEXT=20><LI><filespec><TAB>the file(s) to be copied (may include a full path), <LI><newspec><TAB>either a directory or the new name(s) to be given to the file(s) ("*" allowed) or both; default is the current directory. </UL></UL>Options:<UL FIRST=3 NEXT=16> <LI>-b<TAB>backup files before overwriting; don't prompt <LI>-f<TAB>force mode: overwrite existing files, don't prompt <LI>-i<TAB>interactive mode: confirm for each file <LI>-t<TAB>test mode; do not modify anything, just report <LI>-v<TAB>be verbose (report changements made) <LI>-q<TAB>be quiet (don't even display error messages) <LI>-d<TAB>delete .LONGNAMEs <LI>-h|/?<TAB>show this help</TOPIC> <TOPIC NAME="defineHelp"><HTML>&cmd; (CmdShl built-in): (re)define keyboard keys Usage: <UL FIRST=3 NEXT=20><LI>&cmd; <key> [<value>] <UL FIRST=10 NEXT=20><LI><key><TAB>the name of the key to be redefined <LI><value><TAB>the new key value; either a built-in command, SHELL <cmd> for executing <cmd> or TEXT <text> for simulating keyboard input of <text>. </UL></UL>Examples: <UL NEXT=20><LI>def F12 TEXT dir /w <LI>define F3 SHELL exit <LI>def F12<TAB>will clear F12 key</TOPIC> <TOPIC NAME="delHelp"><HTML>&cmd; &version; (w) (c) 1997-98 Ulrich Möller -- remove files Usage: &cmd; [-<options>] <filespec> <UL FIRST=3 NEXT=20><LI><filespec><TAB>specifies the file(s) to delete. </UL>Options: <UL FIRST=3 NEXT=20><LI>-h|?<TAB>show this help.</TOPIC> <TOPIC NAME="dirHelp"><HTML>&cmd; &version; (w) (c) 1996, 1997-98 Martin Lafaix, Ulrich Möller <UL NEXT=3><TAB>Enhanced DIR. Now a strange mixture between OS/2 "DIR" and UNIX "ls". </UL>Usage: &cmd; [-<options>] [/<options>] [<filespec>] Options (will be translated to lower case when used with "/") <UL FIRST=2 NEXT=20><LI>-{h|?}<TAB>show this help message <LI>-w<TAB>OS/2 wide format: use columns, left to right <LI>-C<TAB>UNIX format: use columns, top to bottom <LI>-{l|n}<TAB>long format: print more info (default) <LI>-x[:{a|d|t|s|e|l}...] eXtend: show Attr Date Time Size Easize Longname <LI>-{b|1}<TAB>show filenames only (overrides -w and -x) <LI>-f<TAB>show full path only (overrides -w and -x) <LI>-{s|R}<TAB>recurse subdirectories <LI>-p<TAB>pause after each page <LI>-F<TAB>classify all files (*, \, @) <LI>-a[:{[-]d|h|r|s|a|w}...] show or hide files with specified attributes; "w" stands for abstract WPS objects <LI>-W<TAB>include abstract WPS objects (same as "-a:w") <LI>-d<TAB>show subdirectories only (same as "-a:d") <LI>-o[:{n|e|d|s|g}]<TAB>sort output by name, ext, date, size, dirs first <LI>-{t|S}<TAB>sort output by date|size (same as "-o:d|s") <LI>-{L|U}<TAB>display all file names in lower/upper case </UL>Recognized environment variables: see online help (type <A HREF="">help ref xdir</A>)</TOPIC> <TOPIC NAME="exitHelp"><HTML>exit (CmdShl built-in): exit session <UL FIRST=3 NEXT=3><LI>exit will close the current session, including the underlying cmd processor. This is different from <A HREF="">quit</A>, which will only quit CmdShl.</TOPIC> <TOPIC NAME="forHelp"><HTML>for (CMD.EXE built-in): repetitive command processing <UL FIRST=0 NEXT=3><LI>Usage on the command line: <TAB>for %<var> in (<filespec>) do <command> <LI>in batch files: <TAB>for %%<var> in (<filespec>) do <command></UL> with: <UL FIRST=3 NEXT=20><LI><var><TAB>a letter specifying a variable <LI><filespec><TAB>a file specification; may contain wildcards <LI><command><TAB>a command line, possibly referencing <var>. </UL>Example: <UL NEXT=20><LI>for %a in (*.inf) do copy G:\OS2\books\%a will replace all existing books in the current directory with the ones in G:\OS2\books. </UL>Type <A HREF="">help cmdref for</A> to see details.</TOPIC> <TOPIC NAME="lnHelp"><HTML>ln &version; (w) (c) 1997-98 Ulrich Möller <UL NEXT=3><LI>Create "links"; these are implemented with WPS shadow objects. They can be viewed using <A HREF="">xdir -W</A>.</UL> Usage: ln [-<options>] <filespec> [<dir>] <UL NEXT=20><LI><filespec><TAB>specifies the source file(s); wildcards allowed. <LI><dir><TAB>specifies the target directory to create links in (default: current directory) </UL>Options: <UL NEXT=20><LI>-f<TAB>"force" mode: replace existing links. <LI>-v<TAB>be verbose; show each file to be linked. <LI>-{h|?}<TAB>show this help.</TOPIC> <TOPIC NAME="openHelp"><HTML>open &version; (w) (c) 1997-98 Ulrich Möller - open WPS folder Usage: <UL NEXT=20><LI>open [-h] [<dir>]</UL> with:<UL NEXT=20><LI><dir><TAB>the directory to be opened; this can also be a subdirectory along the value of CmdShl's CDPATH. If <dir> is omitted, the current directory will be opened. </UL>Options:<UL NEXT=20> <LI>-h<TAB>show this help </UL>Examples:<UL NEXT=20><LI>open c:\os2</TOPIC> <TOPIC NAME="pushdHelp"><HTML>pushd / popd (w) Martin Lafaix <UL FIRST=3 NEXT=3><LI>Will store / recall the current directory.</UL> Typing <A HREF="">pushd</A> will store the current directory in an internal buffer. Typing <A HREF="">popd</A> will change the current directory to the one that was previously stored.</TOPIC> <TOPIC NAME="queryHelp"><HTML>query &version; - retrieve information (w) (c) 1996-97 Martin Lafaix, Ulrich Möller Usage: <UL FIRST=2 NEXT=20><LI>query Date | Time <LI>query [<timeframe>] [detailed] connect {time|message} [for <user>] <LI>query [<timeframe>] mail [from <user>] [in <foldername>] [where <condition>] <UL FIRST=6 NEXT=20><LI><timeframe><TAB>[this|last] [year|month|<monthname>] <LI><monthname><TAB>JANuary | FEBruary | MARch | APRil ... | DECember <LI><foldername><TAB>{<name> | "<name>" | * | <foldername>}[, <foldername>] <LI><condition><TAB><element> <operator> <value> [{or|and} <condition>] <LI><element><TAB>from | to | subject | sender[['s] domain] <LI><operator><TAB>contains | = | == | > | < | \= | <> </UL><LI>query disk [<drive>...] <LI>query PICTure DIMension for <file> <LI>query {rexx|java|os} VERsion <LI>query SYStem {DEVices|DRIVERS|IRQs|MEMory} <LI>query DIRectory stack </UL><UL FIRST=3 NEXT=3>Examples: <LI>query this year connect time for user1 <LI>query detailed november connect time for user1 user2 <LI>query last connect message <LI>query mail for user1 in inbox where subject contains "PAGING" <LI>query disk e f <LI>query os version</TOPIC> <TOPIC NAME="quitHelp"><HTML>quit (CmdShl built-in): quit CmdShl <UL FIRST=3 NEXT=3><LI>quit will terminate CmdShl and return to the underlying command processor. This is different from <A HREF="">exit</A>, which will close the whole session. However, quit will only make a difference if you started CmdShl with the /K parameter of CMD.EXE; otherwise, CMD.EXE will terminate also.</TOPIC> <TOPIC NAME="recurseHelp"><HTML>recurse &version; (w) (c) 1997-98 Ulrich Möller <UL NEXT=3><LI>This will walk through all subdirectories of the current directory and execute a given command line in every one of them.</UL> Usage: recurse [-h] [<cmdline>] <UL FIRST=3 NEXT=20><LI>with <cmdline><TAB>being the command line to be executed in each directory. This is evaluated by CmdShl and may therefore contains aliases. </UL> Examples: <UL NEXT=25><LI>recurse del *<TAB>delete all files, leaving empty directories. <LI>recurse xren -d *<TAB>delete all .LONGNAME attributes.</TOPIC> <TOPIC NAME="renHelp"><HTML>&cmd; &version; (w) (c) 1997-98 Ulrich Möller - extended MOVE/RENAME <UL NEXT=3><LI>Use &cmd; to assign new names to files and/or to move files to a different location. Type <A HREF="">help ref xren</A> for details.</UL> Usage:<UL FIRST=3 NEXT=45><LI>&cmd; [-8bdfitvq...] <filespec> <newspec><TAB>rename/move mode <LI>&cmd; -[d][8][r|L|U][tvq...] <filespec><TAB>extended mode <UL FIRST=6 NEXT=20><LI><filespec><TAB>the file(s) to be renamed (may include a full path), <LI><newspec><TAB>either a directory or the new name(s) to be given to the file(s) ("*" allowed) or both; when a path is given, files will be MOVED also. </UL></UL>Options:<UL FIRST=3 NEXT=16> <LI>-b<TAB>backup files before overwriting when moving; don't prompt <LI>-f<TAB>force mode: overwrite existing files when moving, don't prompt <LI>-i<TAB>interactive mode: confirm for each file <LI>-8<TAB>adjust filenames to FAT 8+3 naming convention <LI>-t<TAB>test mode; do not modify anything, just report <LI>-v<TAB>be verbose (report changements made) <LI>-q<TAB>be quiet (don't even display error messages) <LI>-d<TAB>delete .LONGNAMEs <LI>-r<TAB>change real name to .LONGNAME, if it exists <LI>-{L|U}<TAB>change real name to lower/upper case; overrides -r <LI>-h|/?|-x<TAB>show this help; -x will show examples</TOPIC> <TOPIC NAME="renExpl"><HTML>Examples of using xren: <UL FIRST=2 NEXT=25><LI>xren a b<TAB>rename file "a" to "b" <LI>xren a \bin<TAB>if "\bin" is a directory: move file "a" there, otherwise move to "\" and rename to "bin" <LI>xren a \bin\b<TAB>if "\bin" is a directory: move file "a" there and rename it to "b", otherwise error <LI>xren *.bak *.bk2<TAB>rename all "*.bak" to "*.bk2" <LI>xren *.bak \bin\*.bk2<TAB>move all "*.bak" to "\bin" and rename them to "*.bk2" <LI>xren -d *<TAB>remove .LONGNAMEs for all files in directory <LI>xren -L *<TAB>change all filenames to lower case <LI>xren -r *.exe<TAB>rename all EXEs to respective .LONGNAMEs <LI>xren -d -r *.exe<TAB>the same, but remove .LONGNAMEs</TOPIC> <TOPIC NAME="ruleHelp"><HTML>rule (CmdShl built-in): edit rules for command-line editing <UL NEXT=3><LI>With rules, you can modify CmdShl's behavior when editing a certain command at the command line.</UL> Usage: <UL FIRST=3 NEXT=16><LI>rule <name>=<string>|@<file> <UL FIRST=6 NEXT=16><LI><name><TAB>the name of the command that the rule shall be set for (case sensitive for aliases). <LI><string><TAB>the new value for <name>, with the following symbols: <UL FIRST=19 NEXT=24><LI>%%<TAB>the "%" char itself <LI>%*<TAB>anything <LI>%c<TAB>a command name <LI>%d<TAB>a directory name <LI>%e<TAB>an environment variable name <LI>%f<TAB>a file name <LI>%l<TAB>a single letter <LI>%o<TAB>a (possibly empty) list of options <LI>%x<TAB>an expression. Several clauses are to be separated by "|".</UL> <LI><file><TAB>a file containing one (or more) rule definitions as above. </UL><LI>rule list<TAB>view all currently defined rules. </UL>Type <A HREF="">help ref rule</A> for details and examples.</TOPIC> <TOPIC NAME="rxHelp"><HTML>rx (CmdShl built-in): execute REXX stuff <UL NEXT=3><LI>This will execute one or several REXX commands on the command line. Currently your commands must fit one line. Since rx runs within CmdShl's process, you can even access CmdShl's internal variables (and crash it, if you wish). Type <A HREF="">help ref rx</A> to see details and examples. Type <A HREF="">help rexx</A> to find out more about the REXX language. </UL> Usage:<UL FIRST=3 NEXT=20><LI>rx [<rexx1> [; <rexx2>] ...] </UL> Examples: <UL FIRST=1 NEXT=55> <LI>rx say "Hello world"<TAB>complex, isn't it? <LI>rx call SysOpenObject "<WP_SYSTEM>", "DEFAULT", 1<TAB>open folder <LI>rx say cmdList<TAB>show internal variable</TOPIC> <TOPIC NAME="watchdrvHelp"><HTML>watchdrv &version; (w) (c) 1997-98 Ulrich Möller <UL NEXT=3><LI>Will check a drive at a given frequency, and when new media is inserted, its respective WPS folder will be opened automatically.</UL> Usage:<UL FIRST=3><LI>watchdrv [<drive>] [-t:<val>] [-si:<file>] [-so:<file>] [-i] [--play] <UL FIRST=6 NEXT=20><LI><drive><TAB>drive to be watched (default: last available drive). If it does not exist or is not removeable, watchdrv will wait forever. </UL></UL>Options:<UL FIRST=6 NEXT=20><LI>-t:<val><TAB>in seconds: how often drive should be checked (def: 2). <LI>-si:<file><TAB>soundfile to be played on inserting media (def: none). <LI>-so:<file><TAB>soundfile to be played on ejecting media (def: none). <LI>-i<TAB>ignore any media at startup <LI>--play<TAB>will also check the given drive for audio CDs and play them automatically. </UL>Examples:<UL FIRST=3 NEXT=20><LI>watchdrv L:<TAB>will check drive L every 2 seconds. <LI>watchdrv L: -t:5 -si:G:\sounds\crash.wav<TAB> will check drive L every 5 seconds and make some noise.</TOPIC>  <TOPIC NAME="wdAssumeMsg"><HTML>watchdrv assumed that drive &cmd; is your CD-ROM drive.</TOPIC> <TOPIC NAME="wdBeginMsg"><HTML>Now starting surveillance of drive &cmd;.</TOPIC> <TOPIC NAME="wdFrequencyMsg"><HTML>Frequency: &cmd; seconds.</TOPIC> <TOPIC NAME="wdMinimizeMsg"><HTML>watchdrv will happily run in the background. You can minimize this window and watchdrv will continue monitoring your CD-ROM drive. Press Ctrl+C to abort surveillance at any time.</TOPIC> <TOPIC NAME="wdInsertMsg"> New media inserted. Identification: </TOPIC> <TOPIC NAME="wdRemoveMsg"> Media was removed. </TOPIC>