home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / os2clu02.zip / BOOK / OS2CLU02.INF (.txt)
OS/2 Help File  |  1999-09-01  |  118KB  |  3,818 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4.                            OS/2 Command Line Utilities
  5.                                   Users' Guide.
  6.  
  7.                                   Version 2.0.0
  8.  
  9. Copyright (c) 1991-1999 Jonathan de Boyne Pollard. All rights reserved worldwide.
  10.  
  11. This is the users' guide for the OS/2 Command Line Utilities version 2.0, a set 
  12. of useful command-line tools for OS/2 users.  These tools are designed to be 
  13. "pure 32-bit", with no 16-bit code whatsoever (most of the utilities supplied 
  14. with OS/2 that are duplicated and enhanced herein, such as ATTRIB, are 16-bit 
  15. programs), and as such should work on OS/2 version 2.0.1 or later. 
  16.  
  17. Software licence 
  18.  
  19. This software is copyright in order to protect the good name of the author and 
  20. in order to prevent other people from passing it off as their own and making 
  21. money from it.  The author wants this software to enjoy as wide an audience as 
  22. possible, and also wants you to receive this software as it was originally 
  23. released.  Therefore: 
  24.  
  25. You may archive, store, copy, and distribute this software (which means the 
  26. utilities, and any accompanying electronic documentation, helptext, and message 
  27. or data files) in its entire original, unmodified, form for any purpose, 
  28. commercial or otherwise.  In fact you are encouraged to give copies of this 
  29. software to your friends so that they can enjoy it too. 
  30.  
  31. You may make limited modifications to the original distribution archive before 
  32. passing it on to others, to convert it to another archive format (extended 
  33. attributes and long filenames must be preserved, however), or to add archive 
  34. comments in order to advertise BBSes and the like (a FILE_ID.DIZ description 
  35. file is already supplied in the distribution archive, however). 
  36.  
  37. You may not pass this software off as your own, attempt to modify it, or 
  38. obscure or remove the copyright notices or this software licence in any way. 
  39. Nor may you attempt to make money from distributing it to others apart from 
  40. media costs. 
  41.  
  42. You may not  (and this part is especially true for those madly litigious 
  43. Americans) sue the author or anybody else in respect of any supposed guarantee. 
  44. You receive this software exactly "as is". There's no guarantee whatsoever. 
  45. The author takes pride in his work, and naturally wants the software to behave 
  46. well and do its job; but he isn't prepared (certainly not for software that you 
  47. are getting entirely for free) to make any sort of guarantee of merchantability 
  48. or fitness for any purpose. 
  49.  
  50. Bug fixes and enhancements to the software will occur entirely at the whim of 
  51. the author, as and when he has spare time to write them.  If you want a 
  52. specific modification to the software, please remember that the author is a 
  53. professional programmer.  You can always pay him to write it! 
  54.  
  55. The source code for the software is the product of a lot of time, skill, and 
  56. effort.  It is not given away for free.  If you need to have access to the 
  57. source code, approach the author about paying for a source code licence. 
  58.  
  59. Technical support for the installation or use of the software consumes time and 
  60. effort.  If you need such support, approach the author about paying for a 
  61. support contract. 
  62.  
  63.  
  64. ΓòÉΓòÉΓòÉ 2. Features ΓòÉΓòÉΓòÉ
  65.  
  66. Here are some of the main features of the OS/2 Command Line Utilities. 
  67.  
  68.      All of the utilities will operate beyond the year 2000 and beyond the 
  69.       year 2038 (the "drop dead" date for many other 32-bit programs written in 
  70.       C and C++), up to the year 2107. 
  71.  
  72.      All of the utilities are purely 32-bit, and contain no 16-bit code and no 
  73.       64KiB limitations. 
  74.  
  75.      All of the utilities support long filenames, deep directory trees with 
  76.       many levels (up to the limit imposed by OS/2 itself), and large 
  77.       directories. 
  78.  
  79.       For example, XDIR can sort directories containing at least 100,000 files, 
  80.       whereas the DIR command built in to 4OS2 fails when there are more than 
  81.       20,000 files in a single directory, and the DIR command built in to CMD 
  82.       fails when asked to sort a directory containing more than 2073 files. 
  83.  
  84.      All of the utilities also retain the original case of files, rather than 
  85.       converting them to all-uppercase or all-lowercase as some other 
  86.       applications do, and have no problems with filenames containing embedded 
  87.       spaces or multiple full stops. 
  88.  
  89.      All of the utilities support the Universal Naming Convention for 
  90.       filenames, used by LANs and by OS/2 Warp Server 5 ("Aurora").  So one 
  91.       doesn't need to use drive letters in order to access and manipulate files 
  92.       and directories with the utilities, since one can use UNC names instead. 
  93.  
  94.      All of the utilities extend the normal OS/2 wildcards with an extended 
  95.       wildcard syntax that is much more versatile, allowing, for example, 
  96.       multiple extensions to be specified by a single wildcard: 
  97.  
  98.               [c:\]xdir *.{exe,com,cmd,btm,bat}
  99.  
  100.      The command-line interface of all of the utilities is logical and 
  101.       consistent.  Several standard options are the same across many commands. 
  102.  
  103.       Wherever possible, the same option will have the same meaning across all 
  104.       command line utilities that support it.  One only, therefore, has to 
  105.       learn one set of option letters, rather than individual options for each 
  106.       command. 
  107.  
  108.      All of the utilities support the /? standard option, which provides a 
  109.       short summary of the options and arguments that the command accepts. 
  110.  
  111.      All of the utilities that operate upon multiple files allow files to be 
  112.       excluded and included according to their attributes, with the /A standard 
  113.       option. 
  114.  
  115.      All of the utilities access the system message files for the text of 
  116.       system error messages, meaning that error messages will be displayed in 
  117.       the current national language for the system. 
  118.  
  119.      Date and time support is fully internationalised.  All of the utilities 
  120.       that display dates and times do so by default using the date and time 
  121.       formats appropriate to the current country , but they can also be told to 
  122.       display them in the standard format specified by ISO standard number 
  123.       8601, which uses a full 4-digit year and a fixed descending order of 
  124.       fields to avoid the ambiguity that the country-specific formats have for 
  125.       the first 31 years of each century (e.g. 01/02/03). 
  126.  
  127.      Full timezone support is provided using the TZ environment variable, 
  128.       which is in the standard POSIX 1003.1 (ISO/IEC 9445-1:1990) format, 
  129.       allowing multiple utilities to operate simultaneously in different 
  130.       timezones with different daylight savings time rules, which are applied 
  131.       automatically at exactly the right point without need for user 
  132.       intervention. 
  133.  
  134.       The local time, required by the ANACLOCK, DIGCLOCK, SAYDATE, SETDATE, and 
  135.       TOUCH commands, can be configured to be in any arbitrary timezone and use 
  136.       any daylight savings time rules. 
  137.  
  138.      The DUMP, FIND, GREP, SORT, STRINGS, SUM, TEE, TEXTCONV, WC, WHAT, and Y 
  139.       commands can be used as filter commands, for use in a command pipeline, 
  140.       acting upon what they receive from their standard input, and producing 
  141.       results on their standard output. 
  142.  
  143.      All of the text-mode utilities that do not deal with the Workplace Shell 
  144.       or Presentation Manager (i.e. all except RESETINI and TASKLIST) can be 
  145.       used when OS/2 is booted to a command line. 
  146.  
  147.  
  148. ΓòÉΓòÉΓòÉ 3. What is new and what has changed since version 1.0 ΓòÉΓòÉΓòÉ
  149.  
  150. All of the programs in the toolset are now fully 32-bit and are targetted at 
  151. 32-bit OS/2 (i.e. OS/2 version 2.01 and later). 
  152.  
  153. Several of the utilities that were in previous releases only applied to DOS or 
  154. to 16-bit OS/2 version 1.0, such as the CMOS command and the KEYLOCKS and LINES 
  155. commands. They have been dropped from this release. 
  156.  
  157. Several new commands have been added:  ANACLOCK, ARCDIR, BCOMP, CALCTZ, COMP, 
  158. CPUIDG, CPUIDT, DELTREE, DIGCLOCK, DIRSIZE, FIND, FINDDUPS, FITSIZE, HELP, 
  159. PARTLIST, RESETINI, SAYDATE, SETDATE, SORT, STRINGS, SUM, TASKLIST, TEE, 
  160. TEXTCONV, TREE, WINSIGHT, and Y. 
  161.  
  162. The option syntax has been entirely revised, and some options that were 
  163. inconsistent or superfluous, such as the /R switch to FF, have been modified or 
  164. removed.  Several new standard options, such as /U, have been added. 
  165.  
  166. The problem with using commands as filters has been fixed, and now many of the 
  167. utilities really can be used as filters, acting upon their standard inputs. 
  168.  
  169. All commands issue error messages to the standard error stream, allowing errors 
  170. to be directed to a different place to where the normal output of the command 
  171. is directed. 
  172.  
  173. All commands that involve dates now accept and display four-digit years, 
  174. avoiding the Year 2000 problem.  Similarly, all commands will properly handle 
  175. years beyond 2080 and 2100 (which much other "year 2000 compliant" software 
  176. will not), and will cope properly with dates beyond the "binary millenium" in 
  177. the year 2038, when some software will start to use negative dates.  (Note: 
  178. There are several bugs in the FAT and HPFS drivers for OS/2 itself, that, 
  179. ironically, these utilities reveal.  See the documentation for the TOUCH 
  180. command for details.  ) 
  181.  
  182.  
  183. ΓòÉΓòÉΓòÉ 3.1. Why the CMOS command is no more ΓòÉΓòÉΓòÉ
  184.  
  185. 32-bit OS/2 does not let application programs directly address the hardware, so 
  186. the CMOS command is impossible in 32-bit OS/2.  This is no great loss, however, 
  187. since the variation in CMOS RAM contents has become even more diverse, and even 
  188. less well documented. 
  189.  
  190. To be fair, the contents of the CMOS RAM are entirely the province of the 
  191. system firmware, and firmware manufacturers are under no obligation to document 
  192. any but the "traditional" fields.  Most of the latter have no meaning any 
  193. longer anyway.  The drive type fields, displayed by the CMOS program, have no 
  194. useful meaning on a modern machine, since the BIOS firmware queries ATA and 
  195. ATAPI hardware directly during the POST for its size and capabilities, and has 
  196. no need for a non-volatile storage area for a "drive type". 
  197.  
  198.  
  199. ΓòÉΓòÉΓòÉ 3.2. Why the KEYLOCKS and LINES commands are no more ΓòÉΓòÉΓòÉ
  200.  
  201. 32-bit OS/2 does not have facilities for text-mode programs to access the 
  202. console.  32-bit OS/2 programs have to make use of the 16-bit OS/2 VIO, MOU, 
  203. and KBD subsystems in order to do so.  The KEYLOCKS and LINES commands have 
  204. been dropped from the suite because it is thus impossible to implement them 
  205. using pure 32-bit code, the same as all of the other commands have been. 
  206.  
  207. It is hoped that one day IBM will see the light, and will provide an official 
  208. 32-bit API for 32-bit text-mode programs to access the console. 
  209.  
  210.  
  211. ΓòÉΓòÉΓòÉ 4. The command line ΓòÉΓòÉΓòÉ
  212.  
  213. The command line that is given to a command comprises a series of words, which 
  214. are either option strings or arguments.  Whitespace (e.g. the space or tab 
  215. character) separates one word from the next.  To include whitespace as part of 
  216. a word, it is enclosed by quotation marks. To use quotation marks themselves in 
  217. a word, the backslash is used to prevent a quotation mark, or another 
  218. backslash, from having any special meaning. 
  219.  
  220. Quotation marks do not separate words, so multiple quoted strings without 
  221. intervening whitespace will be treated as a single word.  For example, 
  222.  
  223.   [c:\]xdir "READ""ME"
  224.  
  225. is the same as 
  226.  
  227.   [c:\]xdir README
  228.  
  229.  
  230. ΓòÉΓòÉΓòÉ 5. The syntax of command options ΓòÉΓòÉΓòÉ
  231.  
  232. In all commands, an option string is denoted by a word beginning with the 
  233. option character, which is either the forward slash, /, or the dash, - (except 
  234. for the ATTRIB command, which only allows the forward slash).  The first option 
  235. string encountered determines which of the two option characters will be 
  236. recognised for that and all subsequent option strings. 
  237.  
  238. An option string comprises a sequence of options, separated by the option 
  239. character.  For example 
  240.  
  241.   [c:\]wc /s/e *.txt
  242.  
  243. Some options are toggles, which are either on or off.  They may be followed by 
  244. a plus sign, +, in order to force them to be toggled on, by a minus sign, -, in 
  245. order to force them to be toggled off, or be used on their own, in which case 
  246. the state of the toggle is flipped from on to off or from off to on. 
  247.  
  248. Some options take arguments.  The argument immediately follows the option (for 
  249. backwards compatibility, a colon is often allowed to separate the option from 
  250. its argument, although it is not recommended that this practice be used), as in 
  251.  
  252.   [c:\]touch /d1-1-80 *
  253.  
  254. and 
  255.  
  256.   [c:\]touch /d:1-1-80 *
  257.  
  258. Options apply to all arguments that follow them on the command line, until 
  259. countermanded.  So, for example, in order to count the words in all *.TXT files 
  260. in the current and all subdirectories, but only *.DOC files in the current 
  261. directory, the command is 
  262.  
  263.   [c:\]wc /s+ *.txt /s- *.doc
  264.  
  265. In order to work with files whose names may begin with the option character, a 
  266. word comprising a double option character (i.e. the double dash, --, or double 
  267. forward slash, //) can be used to prevent all further words following it from 
  268. being recognised as options.  So, for example, in order to count the words in 
  269. all files whose names begin with a dash, when the option character being used 
  270. is itself a dash, the command is 
  271.  
  272.   [c:\]wc -s -- -*
  273.  
  274.  
  275. ΓòÉΓòÉΓòÉ 6. Standard options ΓòÉΓòÉΓòÉ
  276.  
  277. Several options have the same meaning in all commands that support them, for 
  278. consistency and to make the commands easier to remember. 
  279.  
  280.     /?      Display command syntax information. 
  281.  
  282.     /A      Select files by attribute. 
  283.  
  284.     /E      Do not display non-fatal error messages. 
  285.  
  286.     /N      Simulate execution. 
  287.  
  288.     /Q      Operate quietly. 
  289.  
  290.     /S      Recurse into subdirectories. 
  291.  
  292.     /U      Do not display summary information. 
  293.  
  294.     /Z      Override the read-only attribute on files. 
  295.  
  296.     /ISO8601 Display date and time in the standard format. 
  297.  
  298.  
  299. ΓòÉΓòÉΓòÉ 6.1. /? option ΓòÉΓòÉΓòÉ
  300.  
  301. The /? option displays syntax information for a command. 
  302.  
  303. This option, when used, must be the first option, and may not be combined with 
  304. any other options.  All other options and arguments to the command will be 
  305. ignored. 
  306.  
  307.  
  308. ΓòÉΓòÉΓòÉ 6.2. /A option ΓòÉΓòÉΓòÉ
  309.  
  310. The /A option allows files to be included in and excluded from processing 
  311. according to their attributes.  It is used with commands that accept wildcard 
  312. specifications. 
  313.  
  314. It takes an argument, which comprises a list of attributes to include, to 
  315. exclude, and to require.  An attribute preceded by a minus sign, '-', excludes 
  316. all files with that attribute from processing.  An attribute preceded by a plus 
  317. sign, '+', includes all files with that attribute in processing (i.e. a file 
  318. "may have" the attribute).  An attribute on its own excludes all files without 
  319. that attribute from processing (i.e. a file "must have" the attribute). 
  320.  
  321. For example, 
  322.  
  323.   [c:\]xdir /a-rsh
  324.  
  325. displays only those writable files that have the hidden and system attributes, 
  326. whereas 
  327.  
  328.   [c:\]xdir /a-r+s+h
  329.  
  330. displays all writable files, including any that may have the hidden or system 
  331. attributes. 
  332.  
  333. When used on its own with an empty argument (i.e. /A: or /A), all files are 
  334. included.  The default if the /A option is not present varies from command to 
  335. command (e.g.  XDIR includes files and directories by default; whereas TOUCH 
  336. includes only files.). 
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ 6.3. /E option ΓòÉΓòÉΓòÉ
  340.  
  341. The /E option prevents non-fatal error messages from being displayed. 
  342.  
  343. Non-fatal errors include any errors reporting that a subdirectory contains no 
  344. files during a recursive scan. 
  345.  
  346.  
  347. ΓòÉΓòÉΓòÉ 6.4. /ISO8601 option ΓòÉΓòÉΓòÉ
  348.  
  349. The /ISO8601 option causes a command to display dates and times in the ISO 8601 
  350. format.  By default, commands will display dates and times in the format 
  351. appropriate to the current country, which on OS/2 Warp is determined by the 
  352. COUNTRY.SYS file and the COUNTRY directive in CONFIG.SYS. 
  353.  
  354.  
  355. ΓòÉΓòÉΓòÉ 6.5. /N option ΓòÉΓòÉΓòÉ
  356.  
  357. The /N option causes a command to simulate operation without actually making 
  358. any changes to files or to the directory structure. 
  359.  
  360.  
  361. ΓòÉΓòÉΓòÉ 6.6. /Q option ΓòÉΓòÉΓòÉ
  362.  
  363. The /Q option causes a command to operate quietly, without displaying 
  364. information about what it is doing as it proceeds. 
  365.  
  366.  
  367. ΓòÉΓòÉΓòÉ 6.7. /S option ΓòÉΓòÉΓòÉ
  368.  
  369. The /S option causes a command to operate recursively upon subdirectories. It 
  370. is used with commands that accept wildcard specifications. 
  371.  
  372. The command operates on the directory given in the wildcard specification and 
  373. on all subdirectories beneath that directory, using the same wildcard in each 
  374. directory. 
  375.  
  376.  
  377. ΓòÉΓòÉΓòÉ 6.8. /U option ΓòÉΓòÉΓòÉ
  378.  
  379. The /U option prevents a command from displaying summary information after it 
  380. has processed all files and directories, listing the total numbers of filenames 
  381. scanned to match against the wildcard specifications, and the total number of 
  382. files that were processed. 
  383.  
  384.  
  385. ΓòÉΓòÉΓòÉ 6.9. /Z option ΓòÉΓòÉΓòÉ
  386.  
  387. The /Z option causes a command to override read-only protection on files. 
  388.  
  389. This command is used with commands that modify or destroy files, such as TOUCH 
  390. and XDEL.  It forces the command to override the read-only attribute on a file 
  391. that would normally prevent such operations. 
  392.  
  393.  
  394. ΓòÉΓòÉΓòÉ 7. Wildcards ΓòÉΓòÉΓòÉ
  395.  
  396. There are two difference sorts of wildcards.  A wildcard filename specification 
  397. denotes a set of files whose names match a given pattern.  A substitution 
  398. specification controls how a given filename is transformed into a different 
  399. name. 
  400.  
  401.  
  402. ΓòÉΓòÉΓòÉ 7.1. Wildcard filenames ΓòÉΓòÉΓòÉ
  403.  
  404. Some commands allow multiple files to be specified using wildcard 
  405. specifications.  A wildcard specification comprises two parts: a directory 
  406. prefix and a basename. 
  407.  
  408. The directory prefix is optional, and specifies the top-level directory (and 
  409. drive) that is to be scanned for matching filenames.  The drive letter prefix 
  410. (followed by a colon) and everything up to and including the last slash in the 
  411. wildcard specification is taken to be the directory prefix.  If no directory 
  412. prefix is supplied, the default is the current drive and directory. 
  413.  
  414. The basename specifies the pattern that filenames must match.  If it is 
  415. omitted, i.e. there is nothing after the final slash in the wildcard 
  416. specification and the basename is blank, the default basename is "*". 
  417.  
  418. Examples: 
  419.  
  420. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  421. ΓöéWildcard            ΓöéDirectory      ΓöéBasename       Γöé
  422. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  423. ΓöéE:\SUBDIR\*.BAK     ΓöéE:\SUBDIR\     Γöé*.BAK          Γöé
  424. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  425. ΓöéE:\*.BAK            ΓöéE:\            Γöé*.BAK          Γöé
  426. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  427. ΓöéE:\SUBDIR\          ΓöéE:\SUBDIR\     Γöé*              Γöé
  428. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  429. ΓöéE:\SUBDIR           ΓöéE:\            ΓöéSUBDIR         Γöé
  430. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  431.  
  432. A basename comprises a mixture of literal characters and metacharacters. 
  433. Literal characters in the basename must match the filename exactly.  The 
  434. metacharacters are as follows: 
  435.  
  436.  *         An asterisk matches zero or more characters. 
  437.  
  438.  ?         A question mark matches a single character. 
  439.  
  440.  .         A full stop matches another full stop '.' or the end of the 
  441.            filename. 
  442.  
  443.  [abcd]    Character sets delimited with brackets match exactly one character 
  444.            from that set. 
  445.  
  446.  [0-9]     Character ranges delimited with brackets match exactly one character 
  447.            within the range. 
  448.  
  449.  {}        Braces enclose a comma-delimited list of strings, any one of which 
  450.            may match that part of the name character within the range. 
  451.  
  452.  It should be noted that both * and ?  will match full stops ('.') in 
  453.  filenames.  Full stops are not regarded as special in OS/2, and on HPFS 
  454.  volumes filenames can contain many full stops.  This means that "*.exe" will 
  455.  match all files that end in the four characters '.', 'E', 'X', and 'E', 
  456.  irrespective of what occurs before.  This is useful for processing files where 
  457.  one extension has been appended to another.  The wildcard "*.gz", for example, 
  458.  will match all GZIP files, including any *.TAR.GZ files. 
  459.  
  460.  Examples 
  461.  
  462.  *              All files. 
  463.  
  464.  *.*            All files.  (This is for backwards compatibility only, and is 
  465.                 highly discouraged.  The behaviour of the full stop '.' 
  466.                 character has had to be made inconsistent in order to allow 
  467.                 this usage.  Strictly speaking, "*.*" should match only those 
  468.                 files that have at least one full stop '.' character in their 
  469.                 name.  "*" should be used instead of "*.*" to mean all files.) 
  470.  
  471.  c*s            All filenames starting with the letter 'C' and ending with the 
  472.                 letter 'S'. 
  473.  
  474.  *on*           All filenames containing the two-letter sequence 'ON' 
  475.                 somewhere. 
  476.  
  477.  ???            All filenames that are exactly three characters long. 
  478.  
  479.  [a-z]*         All filenames beginning with a letter. 
  480.  
  481.  *[0-9]*        All filenames containing a digit somewhere. 
  482.  
  483.  *.{htm,html,gif,jpg,jpeg} All HTML, GIF, and JPEG files. 
  484.  
  485.  *.{su,mo,tu,we,th,fr,sa}[0-9] All Fidonet compressed ARCmail packets. 
  486.  
  487.  
  488. ΓòÉΓòÉΓòÉ 7.2. Wildcard substitutions ΓòÉΓòÉΓòÉ
  489.  
  490. Some commands allow "destination" filenames to be constructed from "source" 
  491. filenames according to a given pattern.  A substitution specification comprises 
  492. an optoinal directory prefix, which is used as it stands, and a base filename 
  493. that contains the pattern to apply to the "source" base name, comprising 
  494. literal characters and metacharacters. 
  495.  
  496. The following metacharacters are defined: 
  497.  
  498.  *         An asterisk substitutes all characters from the source up until the 
  499.            first character that matches the next part of the pattern. 
  500.  
  501.  ?         A question mark substitutes a single character from the source to 
  502.            the destination, unless that character is a full stop. 
  503.  
  504.  .         A full stop substitutes a full stop into the destination and skips 
  505.            all characters in the source from the current position until either 
  506.            the next full stop or the end of the string. 
  507.  
  508.  Literal characters in the pattern are substituted into the destination 
  509.  directly, and a single character from the source is skipped, unless that 
  510.  character is a full stop. 
  511.  
  512.  Examples 
  513.  
  514.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  515.   ΓöéSOURCE                   ΓöéPATTERN             ΓöéRESULT                   Γöé
  516.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  517.   Γöéattrib.exe               Γöé*.com               Γöéattrib.com               Γöé
  518.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  519.   Γöéattrib.exe               Γöé*com                Γöéattrib.execom            Γöé
  520.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  521.   Γöécomp.exe                 Γöé*com                Γöécom                      Γöé
  522.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  523.   Γöécomp.exe                 Γöéattrib.*            Γöéattrib.exe               Γöé
  524.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  525.   Γöécomp.exe                 Γöéattrib*             Γöéattrib.exe               Γöé
  526.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  527.   Γöésendmail.8.6.9.tar.gz    Γöé*.8.6.10.*          Γöésendmail.8.6.10.tar.gz   Γöé
  528.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  529.   Γöésendmail.8.6.9.tar.gz    Γöé*8.6.10*            Γöésendmail.8.6.10.tar.gz   Γöé
  530.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  531.   Γöésendmail.8.6.9.tar.gz    Γöézmailer.*           Γöézmailer.8.6.9.tar.gz     Γöé
  532.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  533.   Γöésendmail.8.6.9.tar.gz    Γöé*.*.*.*.F*          Γöésendmail.8.6.9.Far.gz    Γöé
  534.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  535.   Γöésendmail.8.6.9.tar.gz    Γöé*.*.*.*.F.*         Γöésendmail.8.6.9.F.gz      Γöé
  536.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  537.  
  538.  
  539. ΓòÉΓòÉΓòÉ 8. Dates and times ΓòÉΓòÉΓòÉ
  540.  
  541. All utilities which display dates, or accept date input, such as DIGCLOCK, 
  542. SAYDATE, SETDATE, TOUCH, and XDIR, will by default use the date and time 
  543. formats appropriate to the current country . This can be overridden by the use 
  544. of the /ISO8601 standard option. 
  545.  
  546. Commands, such as DIGCLOCK, SAYDATE, and TOUCH, which obtain the current time 
  547. from the system clock require the hardware real-time clock to be set to UTC and 
  548. the TZ environment variable to be set correctly. 
  549.  
  550. Commands, such as DIGCLOCK, FF, SAYDATE, TOUCH, and XDIR, which display dates 
  551. and times, can be given format strings to determine what format they use to 
  552. display them. 
  553.  
  554. Commands, such as SAYDATE and SETDATE, where dates and times can be passed as 
  555. arguments on the command line, accept date and time strings in one of several 
  556. input formats. 
  557.  
  558.  
  559. ΓòÉΓòÉΓòÉ 8.1. Country-dependent date and time formats ΓòÉΓòÉΓòÉ
  560.  
  561. The default date and time formats are determined by the COUNTRY setting for 
  562. OS/2.  The separator characters may vary from those given here, but the formats 
  563. for various countries are 
  564.  
  565. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  566. ΓöéU.S.      ΓöéMM/DD/YYYYΓöé
  567. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  568. ΓöéJapanese  ΓöéYYYY.MM.DDΓöé
  569. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  570. ΓöéEuropean  ΓöéDD-MM-YYYYΓöé
  571. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  572.  
  573. for the date and 
  574.  
  575. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  576. ΓöéBritish   ΓöéHH:MM:SS am or HH:MM:SS pm    Γöé
  577. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  578. ΓöéOther     ΓöéHH:MM:SS                      Γöé
  579. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  580.  
  581. for the time. 
  582.  
  583.  
  584. ΓòÉΓòÉΓòÉ 8.2. Setting the hardware RTC correctly ΓòÉΓòÉΓòÉ
  585.  
  586. Commands such as DIGCLOCK, SAYDATE, and TOUCH obtain the current date and time 
  587. from the OS/2 kernel using its DosQuerySysInfo API function, which yields a 
  588. number giving the number of seconds since the start of the year 1970.  This is 
  589. a 64-bit number that can potentially last up to the year 584 thousand million. 
  590. (The OS/2 kernel has no Year 2038 problem in this area.) 
  591.  
  592. The OS/2 kernel requires that the PC hardware real-time clock (RTC) be set to 
  593. Universal Time (UTC) for this to operate correctly.  The hardware RTC must not 
  594. be set to local time, and daylight savings time changes must not be applied to 
  595. it. 
  596.  
  597. Note:  Many OS/2 users set the hardware RTC to local time, and the OS/2 kernel 
  598.        calculates UTC time incorrectly as a result.  Many OS/2 programs read 
  599.        the RTC directly and assume that it runs in local time with daylight 
  600.        savings changes applied, rather than calling DosQuerySysInfo for the 
  601.        time as they should.  (Such programs are generally poor, however, since 
  602.        they also all too often ignore timezones and the TZ environment variable 
  603.        as well.  All too often this is a result of programmers thinking that 
  604.        they are still writing DOS programs.)  But the correct configuration for 
  605.        OS/2, nonetheless, is for the hardware RTC to run in UTC, the same as 
  606.        for PC UNIX, and linux, systems. 
  607.  
  608.  There are various OS/2 utilities available to synchronise the hardware RTC 
  609.  with time sources available via radio broadcasts or dial-up links in various 
  610.  countries, and across the Internet.  If used, these must be configured to 
  611.  maintain the hardware RTC in UTC, not in local time. 
  612.  
  613.  Note:  The hardware RTC only supports 60 seconds per minute, and so must be 
  614.         adjusted every time a leap second is inserted or deleted from UTC.  If 
  615.         the aforementioned utities are used, this will happen automatically. 
  616.  
  617.  All commands will calculate the local time from the UTC time by applying the 
  618.  timezone offsets and daylight savings time rules supplied in the TZ 
  619.  environment variable. 
  620.  
  621.  
  622. ΓòÉΓòÉΓòÉ 8.3. The TZ environment variable ΓòÉΓòÉΓòÉ
  623.  
  624. The TZ environment variable determines the names for standard and daylight 
  625. sayings time in the current timezone, the offsets from UTC for each, and the 
  626. rules to apply to determine when each is in effect. 
  627.  
  628. Since this information is stored in an environment variable, one can 
  629. potentially run commands like DIGCLOCK, SAYDATE, and TOUCH with different TZ 
  630. environment variables on the same machine, allowing multiple timezones to be 
  631. used simultaneously. 
  632.  
  633. The contents of the TZ environment variable are in the standard POSIX 1003.1 
  634. (ISO/IEC 9445-1:1990) format: 
  635.  
  636.   sss[hh[:mm]]ddd[hh[:mm]][,start[/hh[:mm[:ss]]][,end[/hh[:mm[:ss]]]]] 
  637.  
  638. The first part of the TZ environment variable determines the names for standard 
  639. and daylight savings time, and their offset from UTC in hours and (optionally) 
  640. minutes west of of the Prime Meridian (i.e. the amount to subtract from UTC to 
  641. obtain local standard/daylight savings time).  If no offset is given for 
  642. daylight savings time, the default is for it to be exactly one hour east of 
  643. standard time. 
  644.  
  645. The second part gives rules for calculating the exact time for the start and 
  646. end of daylight savings time, specifying the day of the year, and optionally 
  647. the hour, minute, and second (in standard time), at which daylight savings time 
  648. starts and ends.  The "start" and "end" portions specify the day of the year, 
  649. and can be in one of three forms: 
  650.  
  651.  Mm.w.d    The letter 'M' followed by three numbers, separated by dots, 
  652.            indicates the first day of week 'w' of month 'm', where weeks are 
  653.            considered to start on day 'd' (Sunday = 0). 
  654.  
  655.  Jn        The letter 'J' followed by a number, indicating the Nth day of the 
  656.            year (1-365), where February the 29th has no number. 
  657.  
  658.  n         A number, indicating the Nth day of the year (1-366). 
  659.  
  660.  If the "start" day is earlier in the year than the "end" day, as it will be 
  661.  for the Northern Hemisphere, daylight savings time will apply between those 
  662.  days, and standard time otherwise.  Otherwise, standard time will apply 
  663.  between the two days, and daylight savings time otherwise. 
  664.  
  665.  The "time" portion specifies the hour, minute, and second, standard time, at 
  666.  which the change occurs.  If it is omitted, the default is 02:00:00. 
  667.  
  668.  The default start and end rules mandated by ISO/IEC 9445-1:1990, if none are 
  669.  supplied, are ",M4.1.0/02:00:00,M10.5.0/02:00:00", which is the rule that has 
  670.  applied in the United States of America since 1987.  ("First Sunday in April, 
  671.  at 02:00:00 standard time, and last Sunday in October, at 02:00:00 standard 
  672.  time.").   European users should note that this default rule is incorrect for 
  673.  many EU countries.  This rule is also incorrect for all countries in the 
  674.  Southern Hemisphere. 
  675.  
  676.  U.K. users should note that this scheme cannot encode the daylight savings 
  677.  time rules laid out in the Summer Time Act 1972.  Luckily, the U.K. is part of 
  678.  the EU, and EU harmonisation directives override the Summer Time Act each year 
  679.  with simpler daylight savings time rules that can be encoded. 
  680.  
  681.  Examples 
  682.  
  683.  GMT0BST1,M3.5.0/01:00:00,M10.5.0/01:00:00 The full string for the U.K. 
  684.            including the correct rule for the years 1998 to 2001. 
  685.  
  686.  GMT0BST,M3.5/1,M10.5/1 A shorter, but functionally identical, form of the 
  687.            above. 
  688.  
  689.  CET-1CEST The string for Germany and other central European countries.  The 
  690.            DST rule for the years 1998 to 2001 just happens to be identical to 
  691.            the POSIX default, and so can be omitted. 
  692.  
  693.  EST-10EDT,M10.5.0,M3.5.0 Australian Eastern Standard/Daylight time. 
  694.  
  695.  CST-9:30CDT,M10.5.0,M3.5.0 Australian Central Standard/Daylight time. 
  696.  
  697.  EST5EDT   U.S. Eastern Standard/Daylight time. 
  698.  
  699.  PST8PDT   U.S. Pacific Standard/Daylight time. 
  700.  
  701.  NST3:30NDT1:30 Newfoundland Standard/Daylight time. 
  702.  
  703.  
  704. ΓòÉΓòÉΓòÉ 8.4. Date output formats ΓòÉΓòÉΓòÉ
  705.  
  706. The format string used to format a date and time for output is a superset of 
  707. the format string used by the ISO Standard C function strftime() that includes 
  708. several extensions from POSIX.  All characters apart from any format specifiers 
  709. are written as they stand.  The following format specifiers are defined: 
  710.  
  711. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  712. Γöé%%        ΓöéA single % character                                             Γöé
  713. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  714. Γöé%a        ΓöéThe current abbreviated weekday name                             Γöé
  715. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  716. Γöé%A        ΓöéThe current full weekday name                                    Γöé
  717. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  718. Γöé%b        ΓöéThe current abbreviated month name                               Γöé
  719. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  720. Γöé%B        ΓöéThe current full month name                                      Γöé
  721. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  722. Γöé%C        ΓöéThe current century prefix (i.e. "19" for the years 1900 to 1999)Γöé
  723. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  724. Γöé%c        ΓöéThe full date and time in a format appropriate to the current    Γöé
  725. Γöé          Γöécountry.                                                         Γöé
  726. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  727. Γöé%D        ΓöéThe date in MM/DD/YY format. This U.S. date format is ambiguous, Γöé
  728. Γöé          Γöésince it is easily confused with the DD/MM/YY format used by     Γöé
  729. Γöé          Γöéother countries on 12 days per month.  Also, in the first 31     Γöé
  730. Γöé          Γöéyears of every century it can be confused with the YY/MM/DD      Γöé
  731. Γöé          Γöéformat (beginning with the 1st of January, 2001).  This format   Γöé
  732. Γöé          Γöéspecifier is provided for compatibility with older, POSIX,       Γöé
  733. Γöé          Γöésoftwares and U.S. users.  Its use is discouraged.  Use %F.      Γöé
  734. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  735. Γöé%d        ΓöéThe day of the month as a two digit number 01-31                 Γöé
  736. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  737. Γöé%e        ΓöéThe day of the month as a two character, space padded, number    Γöé
  738. Γöé          Γöé1-31                                                             Γöé
  739. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  740. Γöé%F        ΓöéThe date in ISO 8601 format YYYY-MM-DD                           Γöé
  741. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  742. Γöé%G        ΓöéThe ISO 8601 "week year".                                        Γöé
  743. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  744. Γöé%g        ΓöéThe last two digits of the ISO 8601 "week year" 00-99.           Γöé
  745. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  746. Γöé%h        ΓöéThe same as %b. This format specifier is provided for            Γöé
  747. Γöé          Γöécompatibility with older, POSIX, softwares.  Use %b.             Γöé
  748. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  749. Γöé%H        ΓöéThe hour as a two digit number 00-23                             Γöé
  750. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  751. Γöé%I        ΓöéThe hour as a two digit number 00-11                             Γöé
  752. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  753. Γöé%j        ΓöéThe day of the year as a three digit number 001-366              Γöé
  754. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  755. Γöé%m        ΓöéThe month of the year as a two digit number 01-12                Γöé
  756. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  757. Γöé%M        ΓöéThe minute as a two digit number 00-59                           Γöé
  758. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  759. Γöé%n        ΓöéA newline sequence (CRLF)                                        Γöé
  760. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  761. Γöé%p        ΓöéThe string "AM" or "PM", as appropriate                          Γöé
  762. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  763. Γöé%r        ΓöéThe time in 12-hour HH:MM:SS form followed by "AM" or "PM" as    Γöé
  764. Γöé          Γöéappropriate This format specifier is provided for compatibility  Γöé
  765. Γöé          Γöéwith older, POSIX, softwares and British users.  Use %T.         Γöé
  766. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  767. Γöé%R        ΓöéThe time in HH:MM form.                                          Γöé
  768. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  769. Γöé%S        ΓöéThe second as a two digit number 00-60                           Γöé
  770. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  771. Γöé%t        ΓöéA tab character (TAB)                                            Γöé
  772. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  773. Γöé%T        ΓöéThe time in ISO 8601 format HH:MM:SS                             Γöé
  774. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  775. Γöé%u        ΓöéThe day of the week as a two digit number 01-07 (Monday=01)      Γöé
  776. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  777. Γöé%U        ΓöéThe week number of the year 00-52 (weeks start on Sunday)        Γöé
  778. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  779. Γöé%V        ΓöéThe ISO 8601 week number of the year 01-53                       Γöé
  780. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  781. Γöé%w        ΓöéThe day of the week as a two digit number 00-06 (Sunday=00)      Γöé
  782. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  783. Γöé%W        ΓöéThe week number of the year 00-52 (weeks start on Monday)        Γöé
  784. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  785. Γöé%x        ΓöéThe date in a format appropriate to the current country.         Γöé
  786. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  787. Γöé%X        ΓöéThe time in a format appropriate to the current country.         Γöé
  788. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  789. Γöé%y        ΓöéThe last two digits of the year 00-99                            Γöé
  790. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  791. Γöé%Y        ΓöéThe full year number                                             Γöé
  792. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  793. Γöé%z        ΓöéThe time zone expressed as an +HHMM offset from UTC              Γöé
  794. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  795. Γöé%Z        ΓöéThe current time zone abbreviation                               Γöé
  796. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  797.  
  798.  
  799. ΓòÉΓòÉΓòÉ 8.5. Date input formats ΓòÉΓòÉΓòÉ
  800.  
  801. The arguments to SAYDATE or SETDATE can be in any of the following formats: 
  802.  
  803. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  804. ΓöéFull ISO 8601                 Γöé2001-2-3 16:50:04             Γöé
  805. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  806. ΓöéFull ISO 8601 with timezone   Γöé2001-2-3 16:50:04 -0900       Γöé
  807. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  808. ΓöéISO 8601 date only            Γöé2001-2-3                      Γöé
  809. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  810. ΓöéISO 8601 time only            Γöé16:50:04                      Γöé
  811. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  812. ΓöéHH:MM                         Γöé16:50                         Γöé
  813. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  814. ΓöéMon DD, YYYY HH:MM:SS         ΓöéFeb 03, 2001 16:50:04         Γöé
  815. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  816. ΓöéMon DD, YYYY HH:MM            ΓöéFeb 03, 2001 16:50            Γöé
  817. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  818. ΓöéMon DD, YYYY                  ΓöéFeb 03, 2001                  Γöé
  819. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  820. ΓöéMon DD HH:MM:SS               ΓöéFeb 03 16:50:04               Γöé
  821. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  822. ΓöéMon DD HH:MM                  ΓöéFeb 03 16:50                  Γöé
  823. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  824. ΓöéMon DD                        ΓöéFeb 03                        Γöé
  825. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  826. ΓöéDay HH:MM:SS                  ΓöéWed 16:50:04                  Γöé
  827. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  828. ΓöéDay HH:MM                     ΓöéWed 16:50                     Γöé
  829. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  830. ΓöéDay                           ΓöéWed                           Γöé
  831. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  832.  
  833.  
  834. ΓòÉΓòÉΓòÉ 9. Redirecting input and output ΓòÉΓòÉΓòÉ
  835.  
  836. Although the DUMP, FIND, GREP, SORT, STRINGS, SUM, TEE, TEXTCONV, WC, WHAT, and 
  837. Y commands can be used as filter commands, all commands use their standard 
  838. input, standard output, and standard error for input and output.  No command 
  839. accesses the keyboard or screen directly. 
  840.  
  841. Commands send their error messages to standard error, rather than to standard 
  842. output, to allow error messages to be separated from the normal output of the 
  843. command, if necessary. 
  844.  
  845. The command 
  846.  
  847.   [c:\]xdir /s * >outfile.txt
  848.  
  849. merely redirects the standard output to the file OUTFILE.TXT.  The standard 
  850. error is not redirected, and error messages will still be displayed on the 
  851. screen.  To combine error messages with the normal output of the command, the 
  852. command interpreter must be told to combine the standard output and standard 
  853. error.  The syntax in most command interpreters, including 4OS2 and CMD, to do 
  854. this is 
  855.  
  856.   [c:\]xdir /s * >outfile.txt 2>&1
  857.  
  858. Notice that the "2>&1" redirects standard error (handle 2) to whatever standard 
  859. output (handle 1) is at the time, and so must follow the redirection for 
  860. standard output. 
  861.  
  862.  
  863. ΓòÉΓòÉΓòÉ 10. Use with 4OS2 and Take Command for OS/2 ΓòÉΓòÉΓòÉ
  864.  
  865. The following sections cover some topics that apply only to users of JP 
  866. Software's 4OS2 and Take Command for OS/2 command interpreters. 
  867.  
  868.  
  869. ΓòÉΓòÉΓòÉ 10.1. Descriptions ΓòÉΓòÉΓòÉ
  870.  
  871. The distribution archive contains, in the extended attributes for the 
  872. executables, descriptions for each of the executables (which are also listed in 
  873. the Manifest). 
  874.  
  875. These descriptions can be seen on your Workplace Shell desktop by looking in 
  876. the "Subject" field on the "File" page of the properties notebook for each 
  877. *.EXE file. 
  878.  
  879. 4OS2 and Take Command users can configure their command interpreters to use the 
  880. same extended attributes for their file descriptions (instead of ugly 
  881. DESCRIPT.ION files), by ensuring that the directive 
  882.  
  883.   DescriptionName=EA
  884.  
  885. is in the 4OS2.INI and TCMDOS2.INI files. 
  886.  
  887.  
  888. ΓòÉΓòÉΓòÉ 10.2. Use as "TTY" commands in Take Command ΓòÉΓòÉΓòÉ
  889.  
  890. All of the text-mode OS2CLU commands can be used as "tty" commands in Take 
  891. Command for OS/2, because they all use their standard input, standard output, 
  892. and standard error for input and output.  No command accesses the keyboard or 
  893. screen directly. 
  894.  
  895. To use the OS2CLU commands as "tty" commands in TCOS2, either 
  896.  
  897.    1. use the START command: 
  898.  
  899.               [c:\]start /tty ff /s/e *.txt
  900.  
  901.       or 
  902.  
  903.    2. choose the "Configuring TTY Apps..." menu item off the "Setup" menu and 
  904.       add the OS2CLU commands to the list of TTY applications. 
  905.  
  906.  
  907. ΓòÉΓòÉΓòÉ 10.3. Disabling built-in commands ΓòÉΓòÉΓòÉ
  908.  
  909. In the 4OS2 and Take Command for OS/2 command interpreters, the ATTRIB, HELP, 
  910. TOUCH, TEE, TREE, and Y commands are built in to the command interpreters 
  911. themselves.  By default, therefore, whenever the TOUCH command is invoked, the 
  912. built-in version of TOUCH in 4OS2/TCOS2 is executed by the command interpreter, 
  913. not the OS2CLU one. 
  914.  
  915. ( CMD, the default command interpreter that comes with OS/2, has no built-in 
  916. ATTRIB command, by comparison, and so always executes the external ATTRIB.EXE 
  917. utility when the ATTRIB command is invoked, whether the 16-bit one that comes 
  918. with OS/2 or the 32-bit OS2CLU one.  ) 
  919.  
  920. To prevent 4OS2 and TCOS2 from executing their built-in commands, either 
  921.  
  922.    1. disable the built-in versions of these commands by using the SETDOS 
  923.       utility in each instance of the command interpreter: 
  924.  
  925.               [c:\]setdos /i-attrib /i-help /i-touch /i-tee /i-tree /i-y
  926.  
  927.       or 
  928.  
  929.    2. invoke the OS2CLU commands using their full pathnames: 
  930.  
  931.               [c:\]c:\clu\tree c:\
  932.  
  933.  
  934. ΓòÉΓòÉΓòÉ 11. ANACLOCK - Display an analogue clock in a window ΓòÉΓòÉΓòÉ
  935.  
  936. Synopsis 
  937.  
  938. ANACLOCK [/?] [/ISO8601] [/ONTOP] [/CONFIRMCLOSE] [/WIDGETS] [/Iinstancename] 
  939. [/Ntitle] [/TZtzstring] [/U[+|-]] 
  940.  
  941. Options 
  942.  
  943.     /?      Display command syntax information. 
  944.  
  945.     /N      Specify the title text for the window. 
  946.  
  947.     /I      Specify the "instance" name used for saving and restoring the 
  948.             window position to and from the OS/2 User Profile file. 
  949.  
  950.     /TZ     Specify a timezone string to use. 
  951.  
  952.             This overrides whatever TZ environment variable ANACLOCK may have 
  953.             inherited from its parent process. 
  954.  
  955.     /U      Force ANACLOCK to use UTC time rather than local time. 
  956.             (default:OFF) 
  957.  
  958.             If this toggle is ON, ANACLOCK displays UTC time. If this toggle is 
  959.             OFF, ANACLOCK displays local time. 
  960.  
  961.     /ISO8601 Display date and time in the standard format. 
  962.  
  963.     /WIDGETSHide the window "widgets", i.e. the system menu, the hide and close 
  964.             buttons, and the title bar.  (default:OFF) 
  965.  
  966.     /ONTOP  Force ANACLOCK to place itself at the top of the z-order every 
  967.             second.  (default:OFF) 
  968.  
  969.     /CONFIRMCLOSERequire confirmation before closing the program. 
  970.             (default:OFF) 
  971.  
  972.  Description 
  973.  
  974.  The ANACLOCK command displays an analogue clock in a Presentation Manager 
  975.  window, updating it once per second. 
  976.  
  977.  Note:  For correct operation, the hardware real-time clock must be set to UTC 
  978.         and the TZ environment variable must be properly set. 
  979.  
  980.  The purpose of the /TZ option is to provide a means for setting the TZ 
  981.  environment variable when ANACLOCK is invoked from the Workplace Shell. When 
  982.  ANACLOCK is invoked from the command line or a command script file, the TZ 
  983.  environment variable to use can be specified by using the SET command, since 
  984.  ANACLOCK will inherit it from the command interpreter. 
  985.  
  986.  Commands run from Workplace Shell, however, inherit their environment 
  987.  variables from the Workplace Shell process, which has no means for altering 
  988.  its environment variables (apart from editing CONFIG.SYS and rebooting).  So 
  989.  in order to run different instances of ANACLOCK with different environment 
  990.  variables, use the /TZ option to specify the timezone string by placing it in 
  991.  the program parameters field of the properties notebook for the program 
  992.  object(s) that starts ANACLOCK. 
  993.  
  994.  Note:  ANACLOCK writes its current window position, whenever it exits, to the 
  995.         "OS2CLU Analogue Clock:Position" section of the OS/2 User Profile file 
  996.         (usually C:\OS2\OS2.INI), which it then reads and uses when it next 
  997.         starts up.  The name of the key used is determined by the /I option. 
  998.  
  999.  Examples 
  1000.  
  1001.  The following command script starts six instances of ANACLOCK, each running in 
  1002.  a different timezone: 
  1003.  
  1004.     @echo off
  1005.     setlocal
  1006.     set TZ=PST9PDT
  1007.     start /n anaclock /n"U.S. Pacific Time"
  1008.     set TZ=MST7MDT
  1009.     start /n anaclock /n"U.S. Mountain Time"
  1010.     set TZ=EST5EDT
  1011.     start /n anaclock /n"U.S. Eastern Time"
  1012.     set TZ=GMT0BST,M3.5/1,M10.5/1
  1013.     start /n anaclock /n"United Kingdom Time"
  1014.     set TZ=EST-10EDT,M10.5,M3.5
  1015.     start /n anaclock /n"Australian Eastern Time"
  1016.     set TZ=NZST-11NZDT,M10.5,M3.3
  1017.     start /n anaclock /n"New Zealand Time"
  1018.  
  1019.  Each instance will change between the standard and the daylight savings time 
  1020.  for its timezone automatically, and independently of all of the others (and 
  1021.  also on different dates, since the DST rules for the U.K., Australia, and New 
  1022.  Zealand do not match those for the U.S.). 
  1023.  
  1024.  
  1025. ΓòÉΓòÉΓòÉ 12. ARCDIR - Display archive directory ΓòÉΓòÉΓòÉ
  1026.  
  1027. Synopsis 
  1028.  
  1029. ARCDIR [/?] [/A[[-|+]drash]] [/SEBUFC[-|+]] [/O[fmt]] Archive [Filespecs ...] 
  1030.  
  1031. Options 
  1032.  
  1033.     /?      Display command syntax information. 
  1034.  
  1035.     /A      Select files by attribute. 
  1036.  
  1037.     /E      Do not display non-fatal error messages. 
  1038.  
  1039.     /S      Recurse into subdirectories. 
  1040.  
  1041.     /U      Do not display summary information. 
  1042.  
  1043.     /T      Specify, or override, the archive type: 
  1044.  
  1045.             ARC            Treat as an ARC or PAK archive 
  1046.  
  1047.             ARJ            Treat as an ARJ archive 
  1048.  
  1049.             LZH            Treat as an LZH or LHA archive 
  1050.  
  1051.             RAR            Treat as a RAR archive 
  1052.  
  1053.             ZIP            Treat as a ZIP archive 
  1054.  
  1055.             ZOO            Treat as a ZOO archive 
  1056.  
  1057.     /O      Specify a sort string that determines how the output should be 
  1058.             sorted, comprising zero or more of the following characters 
  1059.             (optionally preceded by '-' to reverse the sense): 
  1060.  
  1061.             A              Sort by name, treating digits as numbers. 
  1062.  
  1063.             D              Sort by date stamp (according to the /T option). 
  1064.  
  1065.             E              Sort by extension (the part of the name following 
  1066.                            the final full stop). 
  1067.  
  1068.             G              Sort by attribute (directories, then hidden and 
  1069.                            system files, then all other files). 
  1070.  
  1071.             N              Sort by name. 
  1072.  
  1073.             S              Sort by size. 
  1074.  
  1075.     /B      Display "brief" output, which doesn't include the sizes or space 
  1076.             allocated. 
  1077.  
  1078.     /C      Display the name of the containing archive file.  (Default:ON) 
  1079.  
  1080.     /ISO8601 Display date and time in the standard format. 
  1081.  
  1082.  Description 
  1083.  
  1084.  The ARCDIR command displays the names of all of the files that match the 
  1085.  wildcard specifications that are in archives that match the archive name 
  1086.  wildcard specification. 
  1087.  
  1088.  ARCDIR understands ARC, ARJ, LZH, RAR, ZIP, and ZOO archive files. 
  1089.  
  1090.  The /T option allows the output format to be specified, overriding the choice 
  1091.  of format which would otherwise be based on the extension portion of the name 
  1092.  of the file being dumped.  For example, the command 
  1093.  
  1094.     [c:\]arcdir file.zip *.txt
  1095.  
  1096.  displays the names of all *.TXT files in FILE.ZIP, deducing that the file is a 
  1097.  ZIP archive from its extension, whereas 
  1098.  
  1099.     [c:\]arcdir /t:rar file.exe *.txt
  1100.  
  1101.  displays the names of all *.TXT files in FILE.EXE, as if it were a RAR 
  1102.  archive.  This is useful for dumping self-extracting archives where normally 
  1103.  the archive type cannot be deduced from the name. 
  1104.  
  1105.  The /O option causes files to be sorted in memory, and displayed in sorted 
  1106.  order once all files have been found.  There may thus be a delay between the 
  1107.  command being invoked and it producing any output.  If the internal sort 
  1108.  buffer overflows (if the system is low on available virtual memory), files are 
  1109.  displayed in unsorted order. 
  1110.  
  1111.  If no sort options are specified, the sort order is the order that files were 
  1112.  found.  ( There is no 'U' for "Unsorted" option.  It makes no sense to have a 
  1113.  sort option letter that specifies that there are no sort option letters!  For 
  1114.  unsorted output, simply don't use the /O option at all. ) 
  1115.  
  1116.  The 'A' sort option performs an "alphanumeric" sort by filename, whereas the 
  1117.  'N' sort option is a plain lexical sort.  When 'A' is used, sequences of 
  1118.  digits in the name are treated as numbers.  So "FILE3.TXT" will precede 
  1119.  "FILE0012.TXT" because 3 is less than 12, even though "3" is lexically greater 
  1120.  than "0012". 
  1121.  
  1122.  Examples 
  1123.  
  1124.     [C:\CLU]arcdir /iso8601 os2clu02.{RAR,ZIP} *.txt
  1125.     1999-08-13 18:12:12          2058       5719 _____A (OS2CLU02.RAR) readme.txt
  1126.     1999-08-18 10:45:50          6299      20423 _____A (OS2CLU02.RAR) blurb.txt
  1127.     1999-08-18 10:45:50          6674      20423 ______ (OS2CLU02.ZIP) blurb.txt
  1128.     1999-08-13 18:12:12          2048       5719 ______ (OS2CLU02.ZIP) readme.txt
  1129.              4 files found, 104 files scanned.
  1130.              2 archives found, 7 (potential) archives scanned.
  1131.  
  1132.     [C:\CLU]arcdir /iso8601 /od os2clu02.{RAR,ZIP} *.txt
  1133.     1999-08-13 18:12:12          2058       5719 _____A (OS2CLU02.RAR) readme.txt
  1134.     1999-08-13 18:12:12          2048       5719 ______ (OS2CLU02.ZIP) readme.txt
  1135.     1999-08-18 10:45:50          6299      20423 _____A (OS2CLU02.RAR) blurb.txt
  1136.     1999-08-18 10:45:50          6674      20423 ______ (OS2CLU02.ZIP) blurb.txt
  1137.              4 files found, 104 files scanned.
  1138.              2 archives found, 7 (potential) archives scanned.
  1139.  
  1140.  
  1141. ΓòÉΓòÉΓòÉ 13. ATTRIB - Change file attributes ΓòÉΓòÉΓòÉ
  1142.  
  1143. Synopsis 
  1144.  
  1145. ATTRIB [/?] [/A[[+|-]drash]] [/ENPQSU] [-|+RASH] [Filespecs ...] 
  1146.  
  1147. Options 
  1148.  
  1149.     /?      Display command syntax information. 
  1150.  
  1151.     /A      Select files by attribute. 
  1152.  
  1153.     /E      Do not display non-fatal error messages. 
  1154.  
  1155.     /N      Simulate execution. 
  1156.  
  1157.     /Q      Operate quietly. 
  1158.  
  1159.     /S      Recurse into subdirectories. 
  1160.  
  1161.     /U      Do not display summary information. 
  1162.  
  1163.  Description 
  1164.  
  1165.  The ATTRIB command displays, and optionally changes, the file attributes of 
  1166.  the files specified in the wildcard specifications. If no filenames are 
  1167.  supplied, ATTRIB will display the attributes of all files in the current 
  1168.  directory. 
  1169.  
  1170.  Unlike the ATTRIB command supplied with OS/2, ATTRIB supports extended 
  1171.  wildcards, selection of files by attribute, and allows multiple operations 
  1172.  upon files.  It is also a 32-bit program.  (The OS/2 ATTRIB program is a 
  1173.  16-bit program.) 
  1174.  
  1175.  If no changes are specified, ATTRIB just displays the attributes of the 
  1176.  selected files.  Changes are specified using '+' and '-' followed by one or 
  1177.  more attribute letters, and apply to all filenames that follow them on the 
  1178.  command line. 
  1179.  
  1180.  Examples 
  1181.  
  1182.  To remove the read only attributes from all *.ZIP files, but remove the 
  1183.  system, hidden, and read-only attributes from all *.TXT files: 
  1184.  
  1185.     [c:\CLU]attrib -R *.zip -S-H *.txt
  1186.     R____A -> _____A OS2CLU02.ZIP
  1187.     _HS__A -> _____A blurb.txt
  1188.     _HS__A -> _____A readme.txt
  1189.              3 files changed of 3 files found, 3 files scanned.
  1190.  
  1191.  To add the read-only attribute to all GIF and JPEG files, in all 
  1192.  subdirectories off the current directory, that aren't already read-only: 
  1193.  
  1194.     [c:\]attrib +R /s/a:-r *.{gif,jpg,jpeg}
  1195.  
  1196.  
  1197. ΓòÉΓòÉΓòÉ 14. BCOMP - Binary compare two files ΓòÉΓòÉΓòÉ
  1198.  
  1199. Synopsis 
  1200.  
  1201. BCOMP [/?] [/U[-|+]] File1 File2 
  1202.  
  1203. Options 
  1204.  
  1205.     /?      Display command syntax information. 
  1206.  
  1207.     /U      Do not display summary information. 
  1208.  
  1209.  Note 
  1210.  
  1211.  The BCOMP command is retained for backwards compatibility only, and may well 
  1212.  be removed in a future release.  It is highly recommended to use the COMP 
  1213.  command instead of the BCOMP command.  (COMP supports wildcards, and allows 
  1214.  limits to be placed on the number of matches to report.) 
  1215.  
  1216.  Description 
  1217.  
  1218.  The BCOMP command compares the first file with the second, using a plain 
  1219.  "binary" byte-for-byte comparison.  All differences between the two files are 
  1220.  displayed in hexadecimal and ASCII, 16 bytes at a time, with the first file's 
  1221.  data immediately above the second for ease of comparison. 
  1222.  
  1223.  Examples 
  1224.  
  1225.     [C:\CLU]bcomp OS2CLU02.hlp OS2CLU02.INF
  1226.     00000000: 48 53 50 10 9b 00 02 02 4e 00 0b 01 00 00 0f 0a : HSP╨½┬╖N┬╖┬╖┬╖┬╖┬╖
  1227.     00000000: "" "" "" 01 "" "" "" "" "" "" "" "" "" "" "" "" : HSP╨½┬╖N┬╖┬╖┬╖┬╖┬╖
  1228.  
  1229.              1 differences.
  1230.  
  1231.  
  1232. ΓòÉΓòÉΓòÉ 15. CALCTZ - Calculate the TZ environment variable ΓòÉΓòÉΓòÉ
  1233.  
  1234. Synopsis 
  1235.  
  1236. CALCTZ [/?] [/CONFIRMCLOSE] [/TZtzstring] 
  1237.  
  1238. Options 
  1239.  
  1240.     /?      Display command syntax information. 
  1241.  
  1242.     /TZ     Specify a timezone string to use. 
  1243.  
  1244.             This overrides whatever TZ environment variable CALCTZ may have 
  1245.             inherited from its parent process. 
  1246.  
  1247.     /CONFIRMCLOSERequire confirmation before closing the program. 
  1248.             (default:OFF) 
  1249.  
  1250.  Description 
  1251.  
  1252.  The CALCTZ command is used to calculate the value to use for the TZ 
  1253.  environment variable. It presents a dialogue box allowing one to specify the 
  1254.  daylight savings time rules, and the standard and daylight savings time 
  1255.  abbreviations and offsets from UTC, from which it calculates and presents the 
  1256.  TZ environment variable to use. 
  1257.  
  1258.  CALCTZ initialises its display from the value of the TZ environment variable 
  1259.  that it inherits when it is started, and can thus be used to test whether a TZ 
  1260.  environment variable string conforms to the ISO/IEC 9445-1:1990 (POSIX) 
  1261.  standard. 
  1262.  
  1263.  The purpose of the /TZ option is to provide a means for setting the TZ 
  1264.  environment variable when CALCTZ is invoked from the Workplace Shell. When 
  1265.  CALCTZ is invoked from the command line or a command script file, the TZ 
  1266.  environment variable to use can be specified by using the SET command, since 
  1267.  CALCTZ will inherit it from the command interpreter. 
  1268.  
  1269.  CALCTZ does not alter any system files, or change the value of the TZ 
  1270.  environment variable in any process.  Instead, it presents the value to use in 
  1271.  an entryfield at the bottom of the dialogue.  This value can be used in one of 
  1272.  three ways: 
  1273.  
  1274.      It can be copied and pasted from the entry field, via a text editor, to 
  1275.       the CONFIG.SYS file.  The new value for TZ will then be used when the 
  1276.       operating system is next started. 
  1277.  
  1278.      It can be copied and pasted from the entry field, via a text editor, to a 
  1279.       command script that sets the TZ environment variable with the SET 
  1280.       command.  Running the command script will set the TZ environment variable 
  1281.       to the new value in the command interpreter, which will be inherited by 
  1282.       all processes that are subsequently started from the command interpreter. 
  1283.  
  1284.      It can be copied and pasted from the entry field to the "Parameters" 
  1285.       field of the Properties notebook for a Program object on the Workplace 
  1286.       Shell desktop that starts the DIGCLOCK program, for use with DIGCLOCK's 
  1287.       /TZ option. 
  1288.  
  1289.  
  1290. ΓòÉΓòÉΓòÉ 16. COMP - Binary compare files ΓòÉΓòÉΓòÉ
  1291.  
  1292. Synopsis 
  1293.  
  1294. COMP [/?] [/A[[-|+]drash]] [/SEQU[-|+]] [/M[n]] File1 File2 
  1295.  
  1296. Options 
  1297.  
  1298.     /?      Display command syntax information. 
  1299.  
  1300.     /A      Select files by attribute. 
  1301.  
  1302.     /E      Do not display non-fatal error messages. 
  1303.  
  1304.     /Q      Operate quietly. 
  1305.  
  1306.     /S      Recurse into subdirectories. 
  1307.  
  1308.     /U      Do not display summary information. 
  1309.  
  1310.     /M      Specify the maximum number of differences to report for each pair 
  1311.             of files.  (default:4294967295) 
  1312.  
  1313.  Description 
  1314.  
  1315.  The COMP command compares the files that match the first wildcard 
  1316.  specification with the files indicated by the second substitution 
  1317.  specification, using a plain "binary" byte-for-byte comparison. 
  1318.  
  1319.  All differences between the two files are displayed in hexadecimal and ASCII, 
  1320.  16 bytes at a time, with the first file's data immediately above the second 
  1321.  for ease of comparison.  "Ditto" marks in the hexadecimal values indicate 
  1322.  bytes that have the same value in the second file as in the first. 
  1323.  
  1324.  The /M option controls how many such sets of differences are reported for each 
  1325.  pair of files being compared. 
  1326.  
  1327.  Examples 
  1328.  
  1329.     [C:\CLU]comp *.HLP *.INF
  1330.     Differences between OS2CLU02.hlp and OS2CLU02.INF:
  1331.     00000000: 48 53 50 10 9b 00 02 02 4e 00 0b 01 00 00 0f 0a : HSP╨½┬╖N┬╖┬╖┬╖┬╖┬╖
  1332.     00000000: "" "" "" 01 "" "" "" "" "" "" "" "" "" "" "" "" : HSP╨½┬╖N┬╖┬╖┬╖┬╖┬╖
  1333.  
  1334.              0 files matched of 1 files found, 1 files scanned.
  1335.  
  1336.     [C:\CLU]comp /m0 OS2CLU02.* *.zip
  1337.     OS2CLU02.dll differs from OS2CLU02.zip
  1338.     OS2CLU02.hlp differs from OS2CLU02.zip
  1339.     OS2CLU02.INF differs from OS2CLU02.zip
  1340.     OS2CLU02.RAR differs from OS2CLU02.zip
  1341.     OS2CLU02.TAR.bz2 differs from OS2CLU02.zip
  1342.     OS2CLU02.TAR.gz differs from OS2CLU02.zip
  1343.     OS2CLU02.ZIP matches OS2CLU02.zip
  1344.              1 files matched of 7 files found, 7 files scanned.
  1345.  
  1346.  
  1347. ΓòÉΓòÉΓòÉ 17. CONVCASE - Convert the case of file and directory names ΓòÉΓòÉΓòÉ
  1348.  
  1349. Synopsis 
  1350.  
  1351. CONVCASE [/?] [/A[[+|-]drash]] [/SEQU[+|-]] [/METHOD] Filespecs ... 
  1352.  
  1353. Options 
  1354.  
  1355.     /?      Display command syntax information. 
  1356.  
  1357.     /A      Select files by attribute. 
  1358.  
  1359.     /E      Do not display non-fatal error messages. 
  1360.  
  1361.     /N      Simulate execution. 
  1362.  
  1363.     /Q      Operate quietly. 
  1364.  
  1365.     /S      Recurse into subdirectories. 
  1366.  
  1367.     /U      Do not display summary information. 
  1368.  
  1369.     /UPPER  Convert filenames to all uppercase. 
  1370.  
  1371.     /MIXED  Convert filenames to mixed case, with the start of each "word" 
  1372.             capitalised. 
  1373.  
  1374.     /LOWER  Convert filenames to all lowercase. 
  1375.  
  1376.  Note 
  1377.  
  1378.  The FAT filesystem, in all filename operations, silently converts lower case 
  1379.  characters to upper case.  The CONVCASE command will therefore have no effect 
  1380.  on FAT volumes. The behaviour of the filesystem driver is not within the 
  1381.  control of the CONVCASE command. 
  1382.  
  1383.  Description 
  1384.  
  1385.  The CONVCASE command changes the case of the filenames specified by the 
  1386.  wildcard specifications. 
  1387.  
  1388.  The /UPPER, /LOWER, and /MIXED options control whether the target filename 
  1389.  will be in upper, lower, or mixed case. 
  1390.  
  1391.  Unlike other case conversion utilities, CONVCASE does not use intermediate 
  1392.  names for files, and so will not encounter name conflicts, and cannot be 
  1393.  forcibly terminated such that a filename is left in an intermediate state. 
  1394.  
  1395.  Examples 
  1396.  
  1397.     [C:\CLU]convcase /upper w*.exe
  1398.     WC.exe -> WC.EXE
  1399.     What.exe -> WHAT.EXE
  1400.     Which.exe -> WHICH.EXE
  1401.     WinSight.exe -> WINSIGHT.EXE
  1402.              4 files converted of 4 files found, 4 files scanned.
  1403.  
  1404.     [C:\CLU]convcase /mixed w*.exe
  1405.     WC.EXE -> Wc.Exe
  1406.     WHAT.EXE -> What.Exe
  1407.     WHICH.EXE -> Which.Exe
  1408.     WINSIGHT.EXE -> Winsight.Exe
  1409.              4 files converted of 4 files found, 4 files scanned.
  1410.  
  1411.  
  1412. ΓòÉΓòÉΓòÉ 18. CPUIDG - Graphical display of CPU ID information ΓòÉΓòÉΓòÉ
  1413.  
  1414. Synopsis 
  1415.  
  1416. CPUIDG [/?] [/CONFIRMCLOSE] [/Iinstancename] 
  1417.  
  1418. Options 
  1419.  
  1420.     /?      Display command syntax information. 
  1421.  
  1422.     /I      Specify the "instance" name used for saving and restoring the 
  1423.             window position to and from the OS/2 User Profile file. 
  1424.  
  1425.     /CONFIRMCLOSERequire confirmation before closing the program. 
  1426.             (default:OFF) 
  1427.  
  1428.  Description 
  1429.  
  1430.  The CPUIDG command displays, in a dialogue box, all of the information about 
  1431.  the CPU that may be obtained from the CPUID instruction. 
  1432.  
  1433.  Note:  CPUIDG writes its current window position, whenever it exits, to the 
  1434.         "OS2CLU CPU Information:Position" section of the OS/2 User Profile file 
  1435.         (usually C:\OS2\OS2.INI), which it then reads and uses when it next 
  1436.         starts up.  The name of the key used is determined by the /I option. 
  1437.  
  1438.  
  1439. ΓòÉΓòÉΓòÉ 19. CPUIDT - Display CPU ID information ΓòÉΓòÉΓòÉ
  1440.  
  1441. Synopsis 
  1442.  
  1443. CPUIDT [/?] 
  1444.  
  1445. Options 
  1446.  
  1447.     /?      Display command syntax information. 
  1448.  
  1449.  Description 
  1450.  
  1451.  The CPUIDT command displays, as text, all of the information about the CPU 
  1452.  that may be obtained from the CPUID instruction. 
  1453.  
  1454.  
  1455. ΓòÉΓòÉΓòÉ 20. DELTREE - Delete an entire subtree ΓòÉΓòÉΓòÉ
  1456.  
  1457. Synopsis 
  1458.  
  1459. DELTREE [/?] [/A[[-|+]drash]] [/EQNUWF[-|+]] Filespecs ... 
  1460.  
  1461. Options 
  1462.  
  1463.     /?      Display command syntax information. 
  1464.  
  1465.     /A      Select files by attribute. 
  1466.  
  1467.     /E      Do not display non-fatal error messages. 
  1468.  
  1469.     /N      Simulate execution. 
  1470.  
  1471.     /Q      Operate quietly. 
  1472.  
  1473.     /U      Do not display summary information. 
  1474.  
  1475.     /F      Prevent undelete information from being saved. (default:OFF) 
  1476.  
  1477.     /W      Zero the contents of each file before deleting it. (default:OFF) ( 
  1478.             Note on wiping files) 
  1479.  
  1480.             Use this option with caution.  The contents of all files deleted in 
  1481.             this manner are unrecoverable.  Even if undeleted with the UNDELETE 
  1482.             command, the original contents of the files will have been lost. 
  1483.  
  1484.     /ISO8601 Display date and time in the standard format. 
  1485.  
  1486.  Description 
  1487.  
  1488.  The DELTREE command is a wrapper around the XDEL command that provides 
  1489.  functionality similar to the DELTREE command supplied with MS-DOS and DR-DOS 
  1490.  (whose DELTREE command is also a wrapper around its XDEL command, 
  1491.  incidentally).  It prefixes the /S, /X, and /Z options to its command line 
  1492.  before passing it to XDEL, and thus deletes the files specified by the 
  1493.  wildcard specifications, recursing into subdirectories, deleting empty 
  1494.  directories, and overriding read-only protection on files. 
  1495.  
  1496.  Unlike the DELTREE command supplied with DR-DOS and MS-DOS, DELTREE supports 
  1497.  extended wildcards and selection of files by attribute. 
  1498.  
  1499.  Examples 
  1500.  
  1501.     [c:\]deltree c:\subdir1\
  1502.  
  1503.  deletes the entire tree rooted at the directory C:\SUBDIR1\, including 
  1504.  read-only files and removing all empty subdirectories as well. Notice the 
  1505.  trailing slash. 
  1506.  
  1507.     [c:\]deltree c:\subdir1
  1508.  
  1509.  recursively scans the entire directory tree on drive C:, starting from the 
  1510.  root, deleting all files named SUBDIR1 and removing all empty subdirectories. 
  1511.  Directories in the Workplace Shell Desktop are usually empty, and will be 
  1512.  deleted by this command if your WPS desktop happens to be on drive C:.  This 
  1513.  will cause your system to become unbootable. 
  1514.  
  1515.     [c:\]deltree /w *.txt
  1516.  
  1517.  deletes all *.TXT files from the current directory and all directories below 
  1518.  it, including read-only files, overwriting them entirely with zeroes first, 
  1519.  and removes all empty subdirectories found along the way. 
  1520.  
  1521.  
  1522. ΓòÉΓòÉΓòÉ 21. DIGCLOCK - Display the date and time in a window ΓòÉΓòÉΓòÉ
  1523.  
  1524. Synopsis 
  1525.  
  1526. DIGCLOCK [/?] [/ISO8601] [/BROKENWPS] [/ONTOP] [/CONFIRMCLOSE] [/WIDGETS] 
  1527. [/FONTfontstr] [/Fformat] [/Iinstancename] [/Ntitle] [/TZtzstring] [/U[+|-]] 
  1528.  
  1529. Options 
  1530.  
  1531.     /?      Display command syntax information. 
  1532.  
  1533.     /F      Specify a format string to use for displaying the date. 
  1534.  
  1535.             If this option is not specified, the default string is either "%c 
  1536.             %Z" (display the date in a format determined by the country 
  1537.             settings) or, if the the /ISO8601 option is given, "%F %T %z". 
  1538.  
  1539.     /N      Specify the title text for the window. 
  1540.  
  1541.     /I      Specify the "instance" name used for saving and restoring the 
  1542.             window position to and from the OS/2 User Profile file. 
  1543.  
  1544.     /TZ     Specify a timezone string to use. 
  1545.  
  1546.             This overrides whatever TZ environment variable DIGCLOCK may have 
  1547.             inherited from its parent process. 
  1548.  
  1549.     /U      Force DIGCLOCK to use UTC time rather than local time. 
  1550.             (default:OFF) 
  1551.  
  1552.             If this toggle is ON, DIGCLOCK displays UTC time. If this toggle is 
  1553.             OFF, DIGCLOCK displays local time. 
  1554.  
  1555.     /ISO8601 Display date and time in the standard format. 
  1556.  
  1557.     /BROKENWPSIf a format string is supplied with the /F option, convert all 
  1558.             '$' symbols in the string to '%' symbols. 
  1559.  
  1560.             This allows a format string to be specified in the "Parameters" 
  1561.             field of a Workplace Shell Desktop program object.  The Workplace 
  1562.             Shell handles '%' characters in the Parameters field of a program 
  1563.             object, and (alas!) provides no means for passing a literal '%' 
  1564.             character to a program. 
  1565.  
  1566.     /ONTOP  Force DIGCLOCK to place itself at the top of the z-order every 
  1567.             second.  (default:OFF) 
  1568.  
  1569.     /CONFIRMCLOSERequire confirmation before closing the program. 
  1570.             (default:OFF) 
  1571.  
  1572.     /WIDGETSHide the window "widgets", i.e. the system menu, the hide and close 
  1573.             buttons, and the title bar.  (default:OFF) 
  1574.  
  1575.     /FONT   Specify the font to use. 
  1576.  
  1577.             The name must be in the format used for font names (i.e.including 
  1578.             size) in the Font Palette in the OS/2 System Setup folder. 
  1579.  
  1580.  Description 
  1581.  
  1582.  The DIGCLOCK command displays the date and time in a Presentation Manager 
  1583.  window, updating it once per second. 
  1584.  
  1585.  Note:  For correct operation, the hardware real-time clock must be set to UTC 
  1586.         and the TZ environment variable must be properly set. 
  1587.  
  1588.  The purpose of the /TZ option is to provide a means for setting the TZ 
  1589.  environment variable when DIGCLOCK is invoked from the Workplace Shell. When 
  1590.  DIGCLOCK is invoked from the command line or a command script file, the TZ 
  1591.  environment variable to use can be specified by using the SET command, since 
  1592.  DIGCLOCK will inherit it from the command interpreter. 
  1593.  
  1594.  Commands run from Workplace Shell, however, inherit their environment 
  1595.  variables from the Workplace Shell process, which has no means for altering 
  1596.  its environment variables (apart from editing CONFIG.SYS and rebooting).  So 
  1597.  in order to run different instances of DIGCLOCK with different environment 
  1598.  variables, use the /TZ option to specify the timezone string by placing it in 
  1599.  the program parameters field of the properties notebook for the program 
  1600.  object(s) that starts DIGCLOCK. 
  1601.  
  1602.  The % character is a metacharacter in the various command-line interpreters. 
  1603.  This means that in order to pass it to the DIGCLOCK command it must be doubled 
  1604.  (i.e. four % characters if a literal % character is required in the display). 
  1605.  Alternatively, either use the ^ character to "escape" the % character, such as 
  1606.  in the command 
  1607.  
  1608.     [c:\]digclock /f"The year is "^%Y.
  1609.  
  1610.  or (4OS2 and Take Command only) use the backquote character to prevent 
  1611.  metacharacter recognition, such as in the command 
  1612.  
  1613.     [c:\]digclock /f`"%G week %V, %a %T %Z"`
  1614.  
  1615.  Note:  DIGCLOCK writes its current window position, whenever it exits, to the 
  1616.         "OS2CLU Digital Clock:Position" section of the OS/2 User Profile file 
  1617.         (usually C:\OS2\OS2.INI), which it then reads and uses when it next 
  1618.         starts up.  The name of the key used is determined by the /I option. 
  1619.  
  1620.  Examples 
  1621.  
  1622.  The following command script starts six instances of DIGCLOCK, each running in 
  1623.  a different timezone: 
  1624.  
  1625.     @echo off
  1626.     setlocal
  1627.     set TZ=PST9PDT
  1628.     start /n digclock /n"U.S. Pacific Time"
  1629.     set TZ=MST7MDT
  1630.     start /n digclock /n"U.S. Mountain Time"
  1631.     set TZ=EST5EDT
  1632.     start /n digclock /n"U.S. Eastern Time"
  1633.     set TZ=GMT0BST,M3.5/1,M10.5/1
  1634.     start /n digclock /n"United Kingdom Time"
  1635.     set TZ=EST-10EDT,M10.5,M3.5
  1636.     start /n digclock /n"Australian Eastern Time"
  1637.     set TZ=NZST-11NZDT,M10.5,M3.3
  1638.     start /n digclock /n"New Zealand Time"
  1639.  
  1640.  Each instance will change between the standard and the daylight savings time 
  1641.  for its timezone automatically, and independently of all of the others (and 
  1642.  also on different dates, since the DST rules for the U.K., Australia, and New 
  1643.  Zealand do not match those for the U.S.). 
  1644.  
  1645.  
  1646. ΓòÉΓòÉΓòÉ 22. DIRSIZE - Display directory sizes ΓòÉΓòÉΓòÉ
  1647.  
  1648. Synopsis 
  1649.  
  1650. DIRSIZE [/?] [/A[[-|+]drash]] [/SEXCQUB[-|+]] [Filespecs ...] 
  1651.  
  1652. Options 
  1653.  
  1654.     /?      Display command syntax information. 
  1655.  
  1656.     /A      Select files by attribute. 
  1657.  
  1658.     /E      Do not display non-fatal error messages. 
  1659.  
  1660.     /Q      Operate quietly. 
  1661.  
  1662.     /S      Recurse into subdirectories. 
  1663.  
  1664.     /U      Do not display summary information. 
  1665.  
  1666.     /B      Display "brief" output, which doesn't include the sizes or space 
  1667.             allocated. 
  1668.  
  1669.     /C      Do not display column headings. 
  1670.  
  1671.     /X      Do not display directories where no files match the wildcard 
  1672.             specifiction. 
  1673.  
  1674.  Description 
  1675.  
  1676.  The DIRSIZE command displays the total size, total space allocated for, and 
  1677.  the total number of all files that match the wildcard specifications, and the 
  1678.  name of the directory containing them. 
  1679.  
  1680.  Unlike the GNU DU command, the DIRSIZE command reports on the total number of 
  1681.  matching files found and the space actually allocated to them, as well as the 
  1682.  total size; also unlike the DNU DU command, it allows wildcard specifications. 
  1683.  
  1684.  Note 
  1685.  
  1686.  The sizes of directories, i.e. the number of bytes on disc that are consumed 
  1687.  by the directories themselves, are not reported by OS/2 to applications.  OS/2 
  1688.  always returns 0 for the length and allocation size of a directory.  (This is 
  1689.  the reason that the DIR command built into the command interpreter displays 
  1690.  "<DIR>" in the length field for directories.) DIRSIZE therefore cannot 
  1691.  include, in the total for any given directory, the sizes of the directories 
  1692.  that it contains, and can only include the sizes of the files that it 
  1693.  contains.  If this behaviour of OS/2 is ever fixed, DIRSIZE will automatically 
  1694.  display the correct size information, however. 
  1695.  
  1696.  Examples 
  1697.  
  1698.  To report the sizes per directory of all executable files in all 
  1699.  subdirectories below the current directory: 
  1700.  
  1701.     [C:\UTILS]dirsize /sec *.{exe,com,btm,cmd,bat}
  1702.        2020668    2032128         49 bin\*.{exe,com,btm,cmd,bat}
  1703.              0          0          0 Book\*.{exe,com,btm,cmd,bat}
  1704.              0          0          0 data\*.{exe,com,btm,cmd,bat}
  1705.              0          0          0 dll\*.{exe,com,btm,cmd,bat}
  1706.              0          0          0 help\*.{exe,com,btm,cmd,bat}
  1707.        2418414    2427392         29 *.{exe,com,btm,cmd,bat}
  1708.        4439082 bytes in         78 files found, 119 files scanned.
  1709.        4459520 bytes allocated.
  1710.  
  1711.  To report the total size of all ZIP, BZ2, and RAR files in all subdirectories 
  1712.  below the current directory: 
  1713.  
  1714.     [C:\CLU]dirsize /s/e/c/q *.{rar,zip,bz2}
  1715.      1377764 bytes in          3 files found, 56 files scanned.
  1716.      1378304 bytes allocated.
  1717.  
  1718.  
  1719. ΓòÉΓòÉΓòÉ 23. DUMP - Dump executable, object, library, and archive files ΓòÉΓòÉΓòÉ
  1720.  
  1721. Synopsis 
  1722.  
  1723. DUMP [/?] [/A[[-|+]drash]] [/SEU[-|+]] [/T[fmt]] [Filespecs ...] 
  1724.  
  1725. Options 
  1726.  
  1727.     /?      Display command syntax information. 
  1728.  
  1729.     /A      Select files by attribute. 
  1730.  
  1731.     /E      Do not display non-fatal error messages. 
  1732.  
  1733.     /S      Recurse into subdirectories. 
  1734.  
  1735.     /U      Do not display summary information. 
  1736.  
  1737.     /T      Specify, or override, the output format to use: 
  1738.  
  1739.             HEX            A plain hex dump 
  1740.  
  1741.             EXE            Dump as an executable file 
  1742.  
  1743.             ARC            Dump as an ARC or PAK archive 
  1744.  
  1745.             ARJ            Dump as an ARJ archive 
  1746.  
  1747.             LZH            Dump as an LZH or LHA archive 
  1748.  
  1749.             RAR            Dump as a RAR archive 
  1750.  
  1751.             ZIP            Dump as a ZIP archive 
  1752.  
  1753.             ZOO            Dump as a ZOO archive 
  1754.  
  1755.             OMF            Dump as an Intel OMF file (*.OBJ or *.LIB file) 
  1756.  
  1757.             PKT            Dump as a Fidonet *.PKT file 
  1758.  
  1759.     /ISO8601 Display date and time in the standard format. 
  1760.  
  1761.  Description 
  1762.  
  1763.  The DUMP command displays the contents of the files that match the wildcard 
  1764.  specifications. For executable files, it displays the contents of the 
  1765.  executable's header and section information.  For object and library files it 
  1766.  decodes and displays Intel OMF object records.  And for archive files it lists 
  1767.  all of the files contained within the archive.  All other file types are 
  1768.  displayed as raw hexadecimal data. 
  1769.  
  1770.  DUMP understands the 'MZ', 'LX', and 'PE' executable formats, Intel OMF format 
  1771.  OBJ and LIB files, Fidonet PKT files, and ARC, ARJ, LZH, RAR, ZIP, and ZOO 
  1772.  archive files. 
  1773.  
  1774.  Tip:  Users with Vernon Buerg's (16-bit) LIST for OS/2 program may wish to 
  1775.        copy DUMP.EXE to FV.EXE (or set up the alias alias DUMP=FV in 4OS2), so 
  1776.        that they can make use of the Archive [V]iew option in LIST.  Other, 
  1777.        better, list programs for OS/2, such as John Allen's (32-bit) OnScreen, 
  1778.        do not require a separate "file view" program. 
  1779.  
  1780.  If no wildcard specifications are supplied, DUMP acts as a filter, dumping its 
  1781.  standard input.  In the absence of any options to the contrary, this is in 
  1782.  hexadecimal and ASCII.  For example, the command 
  1783.  
  1784.     [c:\]cls | dump
  1785.  
  1786.  shows what ANSI escape sequence the CLS command uses to clear the screen. 
  1787.  
  1788.  The /T option allows the output format to be specified when DUMP is being used 
  1789.  as a filter.  This allows an archive file to be piped into DUMP, and still be 
  1790.  dumped properly.  If wildcard specifications are supplied, /O overrides the 
  1791.  choice of output format, which would otherwise be based on the extension 
  1792.  portion of the name of the file being dumped.  To revert to the default 
  1793.  behaviour, use /T without any format specification following it.  For example, 
  1794.  the command 
  1795.  
  1796.     [c:\]dump /t:rar file.exe /t file.exe
  1797.  
  1798.  dumps FILE.EXE twice, the first time as if it were a RAR archive, and the 
  1799.  second time as an executable (since its name ends in the extension ".EXE"). 
  1800.  This is useful for dumping self-extracting archives. 
  1801.  
  1802.  Notes 
  1803.  
  1804.  When dumping ZIP archives, the note 
  1805.  
  1806.     NN bytes of junk at the end of the archive.
  1807.  
  1808.  indicates that there are extra bytes in the archive after the end of the ZIP 
  1809.  archive comment.  Some "zipcomment" utilities, often used by large FTP sites 
  1810.  and subscription BBSes to insert advertisements, cause this problem because 
  1811.  they do not truncate the archive file properly when the archive comment that 
  1812.  they are adding is shorter than the one that was previously there.  This 
  1813.  message does not indicate a problem with the archive (PKZIP for OS/2 can 
  1814.  handle such archives), and is for informational purposes only. 
  1815.  
  1816.  
  1817. ΓòÉΓòÉΓòÉ 24. FF - Find files ΓòÉΓòÉΓòÉ
  1818.  
  1819. Synopsis 
  1820.  
  1821. FF [/?] [/A[[-|+]drash]] [/SEBFQU[-|+]] Filespecs ... 
  1822.  
  1823. Options 
  1824.  
  1825.     /?      Display command syntax information. 
  1826.  
  1827.     /A      Select files by attribute. 
  1828.  
  1829.     /E      Do not display non-fatal error messages. 
  1830.  
  1831.     /Q      Operate quietly. 
  1832.  
  1833.     /S      Recurse into subdirectories. 
  1834.  
  1835.     /U      Do not display summary information. 
  1836.  
  1837.     /B      Display "bare" filenames, without attribute, size, or date 
  1838.             information. (default:OFF) 
  1839.  
  1840.     /F      Display full pathnames (default:ON). 
  1841.  
  1842.     /T      Specify which of the last access (/TA), last write (/TW, the 
  1843.             default), or creation times (/TC) to display. 
  1844.  
  1845.             Note:   This only applies to ordinary files, since none of the 
  1846.             supported archive formats store the creation or last access dates 
  1847.             for files. 
  1848.  
  1849.     /ISO8601 Display date and time in the standard format. 
  1850.  
  1851.     /ARC    Search inside ARC format archives. 
  1852.  
  1853.     /ARJ    Search inside ARJ format archives (not multi-volume). 
  1854.  
  1855.     /LZH    Search inside LZH format archives. 
  1856.  
  1857.     /PAK    Search inside PZK format archives. 
  1858.  
  1859.     /RAR    Search inside RAR format archives (not multi-volume). 
  1860.  
  1861.     /ZIP    Search inside ZIP format archives (not multi-volume). 
  1862.  
  1863.     /ZOO    Search inside ZOO format archives. 
  1864.  
  1865.     /DIR    Search directories. 
  1866.  
  1867.     /C      Display the name of the containing archive file.  (Default:ON) 
  1868.  
  1869.  Description 
  1870.  
  1871.  The FF command locates files that match the wildcard specifications. In 
  1872.  addition to looking for ordinary files, it also scans the contents of any ARC, 
  1873.  ARJ, LZH, PAK, RAR, ZIP, or ZOO archive files found in the given directories 
  1874.  looking for files that match. 
  1875.  
  1876.  FF does not process extended attribute data contained in any archive format, 
  1877.  and leaves the EA size column blank for files found in archives. 
  1878.  
  1879.  The ARC format does not store file attributes, so FF leaves the attribute 
  1880.  column blank for files found in ARC or PAK archives. 
  1881.  
  1882.  The ZOO format does not store OS/2-style file attributes, but instead stores 
  1883.  POSIX file permissions.  Unfortunately, there is no definitive mapping from 
  1884.  one to the other (especially for the System, Hidden, and Archive attributes). 
  1885.  FF therefore leaves the attribute column blank for files found in ZOO 
  1886.  archives. 
  1887.  
  1888.  Examples 
  1889.  
  1890.  To report the total number of *.CMD files in all subdirectories and all 
  1891.  archives below the current directory: 
  1892.  
  1893.     [C:\CLU]ff /s/q *.cmd
  1894.           3542 bytes in          3 files found, 5 files scanned.
  1895.              0 bytes in          0 files found in 0 ARC archives.
  1896.              0 bytes in          0 files found in 0 ARJ archives.
  1897.              0 bytes in          0 files found in 0 LZH archives.
  1898.           3542 bytes in          3 files found in 1 RAR archives.
  1899.           3542 bytes in          3 files found in 1 ZIP archives.
  1900.              0 bytes in          0 files found in 0 ZOO archives.
  1901.  
  1902.  To locate all OS2CLU02.*.BZ2 files in all subdirectories on the current drive, 
  1903.  starting from the root directory, without displaying any non-fatal error 
  1904.  messages and without searching any archives: 
  1905.  
  1906.     [C:\CLU]ff /iso8601 /se/arc-/arj-/lzh-/pak-/rar-/zip-/zoo- \os2clu02.*.bz2
  1907.     1999-08-26 08:51:24     414939         92 _____A \CLU\OS2CLU02.TAR.bz2
  1908.     1999-08-26 08:51:24     414939         92 _____A \Develop\OS2CLU02\Release\OS2CLU02.TAR.bz2
  1909.         829878 bytes in          2 files found, 2 files scanned.
  1910.  
  1911.  To locate any *.TXT files in all subdirectories of the current directory, 
  1912.  without searching in ARC, ARJ, PAK, ZIP, or ZOO archives and without 
  1913.  displaying non-fatal error messages: 
  1914.  
  1915.     [C:\CLU]ff /iso8601 /se/arc-/arj-/pak-/zip-/zoo- *.txt
  1916.     1999-08-26 11:06:08      20980         70 _____A blurb.txt
  1917.     1999-08-26 11:31:48       6274         88 _____A readme.txt
  1918.     1999-08-13 18:12:12       5719            _____A (OS2CLU02.RAR) readme.txt
  1919.     1999-08-18 10:45:50      20423            _____A (OS2CLU02.RAR) blurb.txt
  1920.          27254 bytes in          2 files found, 3 files scanned.
  1921.              0 bytes in          0 files found in 0 LZH archives.
  1922.          26142 bytes in          2 files found in 1 RAR archives.
  1923.  
  1924.  
  1925. ΓòÉΓòÉΓòÉ 25. FIND - Search files for text ΓòÉΓòÉΓòÉ
  1926.  
  1927. Synopsis 
  1928.  
  1929. FIND [/A[[+|-]drash]] [/SEBICQUV[+|-]] [/O[num[,num]]] Pattern [Filespecs ...] 
  1930.  
  1931. Options 
  1932.  
  1933.     /?      Display command syntax information. 
  1934.  
  1935.     /A      Select files by attribute. 
  1936.  
  1937.     /E      Do not display non-fatal error messages. 
  1938.  
  1939.     /Q      Operate quietly. 
  1940.  
  1941.     /S      Recurse into subdirectories. 
  1942.  
  1943.     /U      Do not display summary information. 
  1944.  
  1945.     /B      Display "bare" lines, without the filename and line number. 
  1946.             (default:OFF) 
  1947.  
  1948.     /I      Ignore case in comparisons.  (default:ON) 
  1949.  
  1950.     /C      Display the count of lines that match for each file where one or 
  1951.             more lines have matched.  (default:OFF) 
  1952.  
  1953.     /V      Invert the sense of the match (i.e. display lines that do not match 
  1954.             the pattern).  (default:OFF) 
  1955.  
  1956.     /O      Specify the number of lines of context to print before and after 
  1957.             every match.  The default, if either number (or both) is omitted, 
  1958.             is zero lines. 
  1959.  
  1960.             Note:  Specifying anything other than zero lines of context to be 
  1961.             displayed before each match significantly affects performance. 
  1962.  
  1963.  Description 
  1964.  
  1965.  The FIND command is a wrapper around the GREP command that provides 
  1966.  functionality similar to the 16-bit FIND command supplied with OS/2.  It 
  1967.  prefixes the /R option to its command line before passing it to GREP. This 
  1968.  turns regular expressions off by default. 
  1969.  
  1970.  Unlike the 16-bit FIND command supplied with OS/2, FIND supports extended 
  1971.  wildcards, recursion into subdirectories, and selection of files by attribute. 
  1972.  It also numbers lines by default, unless brief mode is selected by the /B 
  1973.  option. 
  1974.  
  1975.  Examples 
  1976.  
  1977.     [c:\]find "IBM" README
  1978.  
  1979.  searches for the string "IBM" in the file README. 
  1980.  
  1981.     [c:\]find /s "OS/2 Warp" c:\*.txt
  1982.  
  1983.  recursively scans the entire directory tree on drive C:, starting from the 
  1984.  root, looking for files whose names match the pattern *.TXT, and searching any 
  1985.  found for lines that contain the string "OS/2 Warp" in any combination of 
  1986.  upper and lower case. 
  1987.  
  1988.     [c:\]find /s/e/c/q "CMD" c:\os2\*.cmd
  1989.  
  1990.  recursively scans the entire directory tree beneath C:\OS2, looking for files 
  1991.  whose names match the pattern *.CMD, and searching any found for lines that 
  1992.  contain the string "CMD" in any combination of upper and lower case.  Lines 
  1993.  that match are not printed (/Q), but a count is printed of the total number of 
  1994.  lines that matched for each file where one or more matches occur. 
  1995.  
  1996.  
  1997. ΓòÉΓòÉΓòÉ 26. FINDDUPS - Find duplicate files ΓòÉΓòÉΓòÉ
  1998.  
  1999. Synopsis 
  2000.  
  2001. FINDDUPS [/?] [/A[[-|+]drash]] [/T[acw]] [/SEBFUCQ[-|+]] [/NZ] [Filespecs ...] 
  2002.  
  2003. Options 
  2004.  
  2005.     /?      Display command syntax information. 
  2006.  
  2007.     /A      Select files by attribute. 
  2008.  
  2009.     /E      Do not display non-fatal error messages. 
  2010.  
  2011.     /Q      Operate quietly. 
  2012.  
  2013.     /S      Recurse into subdirectories. 
  2014.  
  2015.     /U      Do not display summary information. 
  2016.  
  2017.     /B      Display "bare" filenames, without attribute, size, or date 
  2018.             information. (default:OFF) 
  2019.  
  2020.     /F      Display full filenames, rather than simply basenames. (default:ON) 
  2021.  
  2022.     /C      Display only the name of the "copy" file, without the name of the 
  2023.             original file.  (default:OFF) 
  2024.  
  2025.     /T      Specify which of the last access (/TA), last write (/TW, the 
  2026.             default), or creation times (/TC) to display. 
  2027.  
  2028.     /NZ     Skip any files that have zero length. (default:OFF) 
  2029.  
  2030.     /ISO8601 Display date and time in the standard format. 
  2031.  
  2032.  Description 
  2033.  
  2034.  The FINDDUPS command reads all of the files specified by the wildcard 
  2035.  specifications, listing the details of any files whose contents are exactly 
  2036.  the same as the contents of files that it has already scanned, along with the 
  2037.  name of the original file (the first one found) that they are duplicates of. 
  2038.  
  2039.  Examples 
  2040.  
  2041.     [c:\]finddups /se *.{jpg,gif,bmp}
  2042.  
  2043.  will display the details of all JPEG, GIF, or bitmap files in the current 
  2044.  directory or any of its subdirectories that happen to be duplicates of other 
  2045.  JPEG, GIF, or bitmap files. 
  2046.  
  2047.     [c:\]finddups /b *.txt
  2048.  
  2049.  will display, in brief format, all TXT files in the current directory that 
  2050.  happen to be duplicates of other TXT files. 
  2051.  
  2052.     [c:\]finddups c:\downloads\ d:\archives\
  2053.  
  2054.  will display all duplicate files in the two directories C:\DOWNLOADS and 
  2055.  D:\ARCHIVES.  Note that, as explained in the section on wildcard filenames, 
  2056.  the trailing slash without an explicit wildcard filename implies the wildcard 
  2057.  "*". 
  2058.  
  2059.  
  2060. ΓòÉΓòÉΓòÉ 27. FITSIZE - Order a set of files into groups with a given maximum size ΓòÉΓòÉΓòÉ
  2061.  
  2062. Synopsis 
  2063.  
  2064. FITSIZE [/?] [/A[[-|+]drash]] [/T[acw]] [/SEUBF[-|+]] [/MAXsize[KkMmGg]] 
  2065. Filespecs ... 
  2066.  
  2067. Options 
  2068.  
  2069.     /?      Display command syntax information. 
  2070.  
  2071.     /A      Select files by attribute. 
  2072.  
  2073.     /E      Do not display non-fatal error messages. 
  2074.  
  2075.     /S      Recurse into subdirectories. 
  2076.  
  2077.     /U      Do not display summary information. 
  2078.  
  2079.     /B      Display "bare" filenames, without attribute, size, or date 
  2080.             information. (default:OFF) 
  2081.  
  2082.     /F      Display full filenames, rather than simply basenames. (default:ON) 
  2083.  
  2084.     /T      Specify which of the last access (/TA), last write (/TW, the 
  2085.             default), or creation times (/TC) to display. 
  2086.  
  2087.     /ISO8601 Display date and time in the standard format. 
  2088.  
  2089.     /MAX    Specify the maximum size for the groups of files.  (default:1440k) 
  2090.             The size figure may be followed by one of the following suffixes: 
  2091.  
  2092.             Ki             1,024s of bytes (kibibytes) 
  2093.  
  2094.             K              1,000s of bytes (kilobytes) 
  2095.  
  2096.             Me             1,048,576s of bytes (mebibytes) 
  2097.  
  2098.             M              1,000,000s of bytes (megabytes) 
  2099.  
  2100.             Gi             1,073,741,824s of bytes (gibibytes) 
  2101.  
  2102.             G              1,000,000,000s of bytes (gigabytes) 
  2103.  
  2104.             Note:  The k, M, and G suffixes are the official SI abbreviations 
  2105.             for kilo-, mega-, and giga-, which are always powers of 10.  The 
  2106.             Ki, Me, and Gi suffixes, abbreviations for kibi-, mebi-, and gibi- 
  2107.             respectively, are the standard suffixes for powers of 2 proposed by 
  2108.             the IEEE and the IEC. 
  2109.  
  2110.             If no suffix is present, the size is in bytes. 
  2111.  
  2112.  Description 
  2113.  
  2114.  The FITSIZE command sorts the files specified by the wildcard specifications 
  2115.  into groups that do not exceed a given maximum size. 
  2116.  
  2117.  FITSIZE is useful for deciding how to arrange a set of files onto multiple 
  2118.  discs. 
  2119.  
  2120.  Note on the algorithm used 
  2121.  
  2122.  The problem that FITSIZE solves is commonly called The Knapsack Problem, and 
  2123.  is one of a set of mathematical problems where the optimum solution cannot be 
  2124.  obtained in polynomial time (i.e. the time taken is proportional to the 
  2125.  exponential of the number of items to be packed, or worse). 
  2126.  
  2127.  FITSIZE uses an algorithm that operates in polynomial time, but that does not 
  2128.  always produce the optimum packing configuration for any given set of files. 
  2129.  
  2130.  The FITSIZE command operates by first sorting all files that it finds into 
  2131.  descending order of size.  It then repeatedly picks the largest file available 
  2132.  that will fit into the current group, and adds it to the group, starting a new 
  2133.  group every time that the remaining available space in the current group is 
  2134.  smaller than any file that remains. 
  2135.  
  2136.  Examples 
  2137.  
  2138.     [c:\]fitsize /max=1440k *.txt
  2139.  
  2140.  list all *.TXT files, in groups that will fit onto a 1.4MB floppy disc. 
  2141.  
  2142.     [c:\]fitsize /max=120M
  2143.  
  2144.  list all files, in groups that will fit onto a 120MB floppy disc. 
  2145.  
  2146.  
  2147. ΓòÉΓòÉΓòÉ 28. GREP - Search files for patterns ΓòÉΓòÉΓòÉ
  2148.  
  2149. Synopsis 
  2150.  
  2151. GREP [/?] [/A[[-|+]drash]] [/RSELICQBUV[-|+]] [/O[num[,num]]] Pattern 
  2152. [Filespecs ...] 
  2153.  
  2154. Options 
  2155.  
  2156.     /?      Display command syntax information. 
  2157.  
  2158.     /A      Select files by attribute. 
  2159.  
  2160.     /E      Do not display non-fatal error messages. 
  2161.  
  2162.     /Q      Operate quietly. 
  2163.  
  2164.     /S      Recurse into subdirectories. 
  2165.  
  2166.     /U      Do not display summary information. 
  2167.  
  2168.     /R      Use regular expressions in the pattern.  (default:ON) 
  2169.  
  2170.     /B      Display "bare" lines, without the filename and line number. 
  2171.             (default:OFF) 
  2172.  
  2173.     /I      Ignore case in comparisons.  (default:ON) 
  2174.  
  2175.     /C      Display the count of lines that match for each file where one or 
  2176.             more lines have matched.  (default:OFF) 
  2177.  
  2178.     /V      Invert the sense of the match (i.e. display lines that do not match 
  2179.             the pattern).  (default:OFF) 
  2180.  
  2181.     /O      Specify the number of lines of context to print before and after 
  2182.             every match.  The default, if either number (or both) is omitted, 
  2183.             is zero lines. 
  2184.  
  2185.             Note:  Specifying anything other than zero lines of context to be 
  2186.             displayed before each match significantly affects performance. 
  2187.  
  2188.     /L      List the filename of each file where one or more lines have 
  2189.             matched.  (default:OFF) 
  2190.  
  2191.  Description 
  2192.  
  2193.  The GREP command searches the files specified by the wildcard specifications 
  2194.  for the given pattern.  If no filenames are specified, GREP will act as a 
  2195.  filter command, scanning its standard input.  It writes those lines that do or 
  2196.  that do not (according to the state of the /V toggle) contain the pattern to 
  2197.  its standard output. 
  2198.  
  2199.  When the /R toggle is OFF, the pattern is a literal text string, and the GREP 
  2200.  command behaves like the UNIX "fgrep" program. 
  2201.  
  2202.  When the /R toggle is ON, as it is by default, the pattern is a regular 
  2203.  expression, and the GREP command behaves like the UNIX "egrep" program.  GREP 
  2204.  fully supports the so-called "basic" regular expression syntax, and almost all 
  2205.  of the "extended" regular expression syntax. 
  2206.  
  2207.  Several of the metacharacters used in regular expressions also have meanings 
  2208.  for various command-line interpreters.  It is thus necessary to quote the 
  2209.  pattern, or at least the metacharacters within it.  For example, when using | 
  2210.  to separate branches, the | character (which signifies a pipeline to CMD, 
  2211.  4OS2, and Take Command) must be "escaped", using the ^ character, yielding the 
  2212.  command 
  2213.  
  2214.     [c:\]grep BASEDEV^|DEVICE \config.*
  2215.  
  2216.  The ^ character is a regular expression metacharacter, but is also the 
  2217.  (default) "escape" character for command interpreters, used to quote other 
  2218.  special characters so that the command interpreter does not act upon them. To 
  2219.  use a ^ character in a regular expression, it must be escaped: 
  2220.  
  2221.     [c:\]grep [^^;]$ *.cpp *.h
  2222.  
  2223.  and 
  2224.  
  2225.     [c:\]grep ^^Chapter *.txt
  2226.  
  2227.  When the regular expression contains so many metacharacters that it becomes 
  2228.  inconvenient to "escape" every single one with a caret, a better alternative 
  2229.  is to surround the whole pattern with quotation marks.  For example 
  2230.  
  2231.     [c:\]grep "^REM|\<OS2\\(INSTALL|SYSTEM)\>" \config.*
  2232.  
  2233.  Examples 
  2234.  
  2235.     [c:\]grep .I..I.G dict.txt
  2236.  
  2237.  searches the file "dict.txt" for lines containing 7 characters, of which the 
  2238.  second is 'I', the fifth 'I', and the seventh 'G'.  This is useful for 
  2239.  searching word lists for the answers to crossword puzzles. 
  2240.  
  2241.     [c:\]grep "\<base[A-Za-z]*\>" file.txt
  2242.  
  2243.  searches the file "file.txt" for lines containing any word beginning with 
  2244.  "base", such as "basement", "basename", and "baseball". 
  2245.  
  2246.     [c:\]grep "ltd\.|inc\." file.txt
  2247.  
  2248.  searches the file "file.txt" for lines containing either "ltd." or "inc.". 
  2249.  
  2250.     [c:\]grep "<[A-Za-z0-9.]+@[A-Za-z0-9.]+>" mail.txt
  2251.  
  2252.  searches the file "mail.txt" for lines that might contain SMTP e-mail 
  2253.  addresses. 
  2254.  
  2255.  
  2256. ΓòÉΓòÉΓòÉ 28.1. Regular expressions ΓòÉΓòÉΓòÉ
  2257.  
  2258. The regular expression syntax is a subset of the regular expression syntax 
  2259. specified in the POSIX standards: 
  2260.  
  2261.  .         Any character 
  2262.  
  2263.  ?         Zero or one repetition. 
  2264.  
  2265.  +         One or more repetitions. 
  2266.  
  2267.  *         Zero or more repetitions. 
  2268.  
  2269.  []        Encloses a character set. 
  2270.  
  2271.  ()        Encloses a subexpression. 
  2272.  
  2273.  |         Separates alternatives. 
  2274.  
  2275.  \         Quote the next character.  This is used to turn metacharacters into 
  2276.            literals. 
  2277.  
  2278.  ^         Match the beginning of the line. 
  2279.  
  2280.  $         Match the end of the line. 
  2281.  
  2282.  \<        Match the beginning of a word. 
  2283.  
  2284.  \>        Match the end of a word. 
  2285.  
  2286.  A pattern comprises a list of branches, separated by | if there is more than 
  2287.  one.  Each branch comprises a series of consecutive pieces, all of which must 
  2288.  match in the given order for the branch as a whole to match. Each piece 
  2289.  comprises an ^, $, or an atom followed by an optional suffix operator *, ?, or 
  2290.  +.  An atom is a character set, a subexpression enclosed in parentheses, ., or 
  2291.  a literal character. 
  2292.  
  2293.  Character sets comprise a list of characters, character ranges, and character 
  2294.  classes, enclosed within '[' and ']'.  A match occurs if the target character 
  2295.  is in the set, unless the entire set is prefixed by the '^' character (which 
  2296.  is not part of the set itself) in which case a match occurs if the target 
  2297.  character is not in the set.  A character range is two characters separated by 
  2298.  a '-', and includes all characters lexically from the first to the second.  A 
  2299.  character class is a class name ("alpha", "digit", "alnum", "xdigit", "graph", 
  2300.  "space", "print", "upper", "lower", "cntrl", or "punct") enclosed within "[:" 
  2301.  and ":]", and denotes all characters in that class.  To include the ']' 
  2302.  character as part of the set, list it before all other characters.  To include 
  2303.  the '-' character as part of the set, list it before all other characters 
  2304.  except ']'. 
  2305.  
  2306.  Examples 
  2307.  
  2308.  .*                                   Zero or more characters, i.e. any string. 
  2309.  
  2310.  .+                                   One or more characters, i.e. any 
  2311.                                       non-empty string. 
  2312.  
  2313.  c..                                  Three characters, the first of which is 
  2314.                                       'c'. 
  2315.  
  2316.  .a...n.                              7 characters, the second of which is 'a' 
  2317.                                       and the sixth of which is 'n' (useful for 
  2318.                                       solving crosswords!) 
  2319.  
  2320.  [0-9]+                               A sequence of digits that is at least one 
  2321.                                       character long. 
  2322.  
  2323.  [[:alpha:]][[:alnum:]]*              Any single alphabetic character, followed 
  2324.                                       by zero or more alphanumeric characters. 
  2325.  
  2326.  [[:alnum:][:space:]$]                An alphanumeric character, a whitespace 
  2327.                                       character, or the '$' character. 
  2328.  
  2329.  ^REM(ARK)?                           Any line beginning with REM or REMARK. 
  2330.  
  2331.  [^;]$                                Any line not ending with a semi-colon. 
  2332.  
  2333.  \<(their|they're|there)\>            One of the three words "their", 
  2334.                                       "they're", or "there". 
  2335.  
  2336.  \+[0-9]+[- ][- 0-9]+                 A telephone number in standard 
  2337.                                       internationalised form (with either 
  2338.                                       spaces or dashes). 
  2339.  
  2340.  \<[A-Za-z][A-Za-z] [0-9]+\>          A U.S.-style "zip" (i.e. postal) code. 
  2341.  
  2342.  ([0-9]+:)?[0-9]+/[0-9]+(\.[0-9]+)?   A Fidonet address, with optional zone 
  2343.                                       number and point number. 
  2344.  
  2345.  
  2346. ΓòÉΓòÉΓòÉ 29. HELP - Obtain on-line help ΓòÉΓòÉΓòÉ
  2347.  
  2348. Synopsis 
  2349.  
  2350. HELP 
  2351. HELP [/?] 
  2352. HELP [ON|OFF] 
  2353. HELP ErrorNumber 
  2354. HELP [Book] Topic 
  2355.  
  2356. Options 
  2357.  
  2358.     /?      Display command syntax information. 
  2359.  
  2360.  Note 
  2361.  
  2362.  This command is a REXX script.  It requires that either Classic REXX or Object 
  2363.  REXX be installed. 
  2364.  
  2365.  Tip for Take Command for OS/2 users 
  2366.  
  2367.  The built-in HELP command in Take Command for OS/2 up to at least version 2.01 
  2368.  contains several bugs (most notably that the text for an error message is 
  2369.  displayed in a separate session that then immediately closes!). This HELP 
  2370.  command operates correctly in Take Command.  Take Command users can disable 
  2371.  the built-in HELP command, in order to use this one, by issuing the command 
  2372.  
  2373.     [c:\]setdos /i-help
  2374.  
  2375.  Description 
  2376.  
  2377.  The HELP command is a drop-in replacement for the HELP command supplied with 
  2378.  OS/2.  Unlike the latter, however, it does not require HELPMSG.EXE, and does 
  2379.  not obliterate customised prompt strings. 
  2380.  
  2381.  When used on its own, HELP displays some useful information about how to 
  2382.  switch windows, obtain help, and exit the command interpreter. 
  2383.  
  2384.  The ON and OFF options will prepend and delete the string "$i" from the PROMPT 
  2385.  environment variable.  This controls whether or not the command interpreter 
  2386.  displays the help banner whenever the prompt is displayed. The PROMPT 
  2387.  environment variable is not otherwise altered. 
  2388.  
  2389.  Error numbers are either plain numbers, in which case the error message text 
  2390.  is read from the system error files, or may be prefixed by 3 alphabetic 
  2391.  characters denoting the message file to search for the error message text. 
  2392.  
  2393.  If the argument is not recognised as an error number, then HELP assumes that 
  2394.  help about a specific topic is being requested.  If no book is specified in 
  2395.  which to look up the topic, HELP will use the value of the CMDREF environment 
  2396.  variable.  If the CMDREF environment variable is empty, or does not exist, 
  2397.  HELP will use the OS/2 Warp Command Reference.  The on-line reference for the 
  2398.  OS2CLU utilities is os2clu02.inf, so 
  2399.  
  2400.     [c:\]help os2clu02 grep
  2401.  
  2402.  will obtain on-line help about the OS2CLU GREP utility. 
  2403.  
  2404.  
  2405. ΓòÉΓòÉΓòÉ 30. PARTLIST - Display the partition tables ΓòÉΓòÉΓòÉ
  2406.  
  2407. Synopsis 
  2408.  
  2409. PARTLIST [/?] [/FIX] [Disc numbers ...] 
  2410.  
  2411. Options 
  2412.  
  2413.     /?      Display command syntax information. 
  2414.  
  2415.     /FIX    Fix any errors found. 
  2416.  
  2417.  Caution 
  2418.  
  2419.  Be extremely careful when using the /FIX option to the PARTLIST command if you 
  2420.  use DOS, DOS+Windows 95, or DOS+Windows 98.  Unlike Linux, UNIX, OS/2 Warp, 
  2421.  and Windows NT, all three DOS-based systems use the "CHS" fields in the 
  2422.  partition table rather than the "LBA" fields.  PARTLIST /FIX adjusts those 
  2423.  fields, which will alter DOS', DOS+Windows 95's, and DOS+Windows 98's 
  2424.  perceptions of where partitions are located on the disc. This is, of course, 
  2425.  one of the useful functions of PARTLIST (being able to fix the partition table 
  2426.  from OS/2 Warp so that DOS can function after a geometry change). 
  2427.  Nevertheless, great care should be exercised. 
  2428.  
  2429.  Description 
  2430.  
  2431.  The PARTLIST command displays the contents of the partition table on the 
  2432.  specified physical discs, or on all detected physical discs if no disc numbers 
  2433.  are specified.  It also detects many common errors that can occur in the 
  2434.  partition table, and fixes them if the /FIX option is used. 
  2435.  
  2436.  Although the same information can be obtained from the FDISK command using the 
  2437.  /QUERY option, FDISK "cooks" the data that it reads before displaying it, 
  2438.  which can result in confusion.  PARTLIST displays the partition table contents 
  2439.  in "raw" form, displaying the contents of all four entries from every 
  2440.  partition table sector, and displaying all values in sectors rather than 
  2441.  converting them to kilobytes.  (See how the partition table works.) 
  2442.  
  2443.  PARTLIST is also more informative than FDISK about the BIOS 1024 cylinder 
  2444.  problem (often misconstrued and misdocumented by many people as a "504MB 
  2445.  problem", "528MB problem", or "7.87GB problem").  It will report when a 
  2446.  partition is either partially or wholly beyond the 1024th cylinder of the 
  2447.  disc, making it either partially or wholly inaccessible to the BIOS at boot 
  2448.  time. 
  2449.  
  2450.  The /FIX option is useful if, for example, a disc has been moved from one 
  2451.  system, with one type of translating main BIOS (or SCSI BIOS) ROM, to another 
  2452.  system with a different type of BIOS ROM.  Because the "geometry" of the disc 
  2453.  changes (with SCSI discs, this geometry is entirely fictional anyway, being an 
  2454.  artifact of the SCSI BIOS, and nothing to do with SCSI itself), the "CHS" 
  2455.  fields in the partition table, which DOS, and DOS-based systems such as 
  2456.  DOS+Windows 95 and DOS+Windows 98, use to locate the partitions on the disc, 
  2457.  point to the wrong places. 
  2458.  
  2459.  When this happens, the OS/2 FDISK command often complains that "the partition 
  2460.  table is corrupt", and refuses to operate.  DOS, and DOS-based systems, also 
  2461.  tend to crash on bootup.  The "fix" that is given by most authorities is to 
  2462.  clean the contents of the partition table by low-level formatting the drive! 
  2463.  This is, quite obviously, overkill, since it results in the loss of all data 
  2464.  on the drive, and has resulted in the popular, and untrue, myth that changing 
  2465.  discs between BIOSes, or between SCSI host adapters, requires a low-level 
  2466.  format.  The /FIX option to PARTLIST will fix problems caused by changes in 
  2467.  BIOS geometry without requiring a low-level format, and makes no other 
  2468.  modifications to the data on the disc apart from altering the partition table, 
  2469.  so does not destroy data. 
  2470.  
  2471.  When diagnosing and fixing errors in the partition table, PARTLIST assumes 
  2472.  that the "LBA" fields in the partition table entries are definitive, since 
  2473.  these are purely "linear" values, that are unaffected by the choice of disc 
  2474.  geometry made by the BIOS.  PARTLIST always adjusts the "CHS" fields in the 
  2475.  partition table to match the values in the "LBA" fields, never the other way 
  2476.  around. 
  2477.  
  2478.  
  2479. ΓòÉΓòÉΓòÉ 30.1. How the partition table works ΓòÉΓòÉΓòÉ
  2480.  
  2481. The partition table on a partitionable disc is a linked list of MBRs. Each MBR 
  2482. contains within it a fixed-size table that describes exactly four partitions. 
  2483. Each entry in the table lists the type of the entry, the start and end 
  2484. cylinder/head/sector position (as the BIOS INT 13h function would see it) and 
  2485. the start and length of the partition in logical blocks. Type 00 entries in the 
  2486. table are unused, and do not describe anything. 
  2487.  
  2488. The first block on the disc, logical block number 0, is the primary MBR. 
  2489. Entries in this MBR's table describe primary partitions (which is why there can 
  2490. never be more four primary partitions per disc).  A type 05 or type 0F entry 
  2491. describes an "extended partition" (which is why having an extended partition 
  2492. reduces the maximum number of primary partitions to three). 
  2493.  
  2494. The extended partition entries are what forms the linking of items in the 
  2495. linked list.  At the start of the partition described by a type 05 or type 0F 
  2496. entry in one MBR is another MBR, a secondary MBR.  This contains a further four 
  2497. entries.  By convention, and because some operating systems actually don't work 
  2498. if this is not the case, each secondary MBR's table has no more than two 
  2499. entries with types other than 00.  One entry describes a partition, contained 
  2500. wholly within the extended partition, that is the "logical drive in the 
  2501. extended partition", and the other entry is optional, and is a type 05 or type 
  2502. 0F entry that links to the next secondary MBR in the partition table if there 
  2503. is one. 
  2504.  
  2505. Free space on the disc, not occupied by any partitions, is not listed in the 
  2506. partition table.  A type 00 entry in an MBR merely means that the entry is 
  2507. available for use. 
  2508.  
  2509. Most, if not all, current BIOSes are pretty simple, and are unable to follow 
  2510. the links from the primary MBR to the secondary MBRs, which is why only primary 
  2511. partitions may be bootable.  The BIOSes do not care about partition types, and 
  2512. simply boot the first entry in the primary MBR that is marked "active".  OS/2's 
  2513. Boot Manager is a primary partition, type 0A, containing code that is smart 
  2514. enough to be able to traverse the whole partition table and thus boot from any 
  2515. partition on the disc.  It is also not limited to booting active partitions 
  2516. (obviously enough, since it has to be the active primary partition itself). 
  2517.  
  2518. By convention, partitions occupy whole numbers of tracks.  Thus Boot Manager, 
  2519. whose code and data only actually occupies a handful of blocks, and indeed any 
  2520. partition, occupies a minimum of 7.87MB (63 sectors per track multiplied by 512 
  2521. bytes per sector and 256 heads) on many large drives (often 504KB on smaller 
  2522. drives). 
  2523.  
  2524. Also, any logical drive in an extended partition, and any primary partition, 
  2525. starts at least one track (31.5KB on a large disc) after the MBR that describes 
  2526. it.  The slack space after the primary MBR is used by various disk manager 
  2527. softwares (such as OnTrack), various third-party boot managers, and MBR 
  2528. viruses.  The slack space after secondary MBRs is generally not used. 
  2529.  
  2530.  
  2531. ΓòÉΓòÉΓòÉ 31. PLAYTUNE - Play a tune through the PC speaker ΓòÉΓòÉΓòÉ
  2532.  
  2533. Synopsis 
  2534.  
  2535. PLAYTUNE [/?] [/I[+|-]] Notes ... 
  2536.  
  2537. Options 
  2538.  
  2539.     /?      Display command syntax information. 
  2540.  
  2541.     /I      Ignore any syntax errors in the tune string(s). (Default:OFF) 
  2542.  
  2543.  Description 
  2544.  
  2545.  The PLAYTUNE command plays the tunes specified by each of its argument strings 
  2546.  by beeping the PC speaker.  A tune is a sequence of ASCII characters that 
  2547.  specify the notes to play and their duration.  Each tune specified on the 
  2548.  command line is played in sequence, with no pauses between successive tunes. 
  2549.  
  2550.  How notes are encoded 
  2551.  
  2552.     R       Play a rest. 
  2553.  
  2554.             A rest may optionally be followed up to two dots to increase its 
  2555.             length. 
  2556.  
  2557.     A-G     Play the specified note. 
  2558.  
  2559.             A note may optionally be followed by '#' (or '+') to indicate a 
  2560.             sharp or '-' to indicate a flat ("B+" is the same as "C".), and 
  2561.             then up to two dots to increase its length. 
  2562.  
  2563.             'A' is the lowest note in each octave. 
  2564.  
  2565.     On      Switch to octave number n, which must be in the range 0 to 9. 
  2566.  
  2567.     <       Decrease the octave by one. 
  2568.  
  2569.     >       Increase the octave by one. 
  2570.  
  2571.     Tn      Specify the tempo as n breves per minute. 
  2572.  
  2573.             Example:  4:4 time at 120 beats per minute is 15 breves per minute. 
  2574.  
  2575.     Ln      Set the length of subsequent notes to n, where 1 = breve, 2 = 
  2576.             semibreve, 4 = minim, 8 = crotchet, 16 = quaver, 32 = semiquaver, 
  2577.             64 = demisemiquaver, etc.. 
  2578.  
  2579.     Pn      Pause for length n (the same as for L). 
  2580.  
  2581.     Nn      Play the note n, where 0 is 'A' in the lowest octave, 12 is the 'A' 
  2582.             one octave above, 24 is the 'A' one octave above that, and so forth 
  2583.             up to 119. 
  2584.  
  2585.     Mx      Set the mode to x, where N is "normal", L is "legato", and S is 
  2586.             "staccato". 
  2587.  
  2588.  A single '.' denotes a "dotted" note or rest, 3/2 of its original length.  Two 
  2589.  dots denote a "double dotted" note or rest, 7/4 of its original length. 
  2590.  
  2591.  Example 1 
  2592.  
  2593.     [c:\]playtune "T80 L2C>L4CA<GEL2G.D.C>L4CA<GEL1G."
  2594.     [c:\]playtune "T80 L4A<G#>A<EFGL2>AL4<FL2D.L4>AAL2AL4BCDBA<G"
  2595.     [c:\]playtune "T80 L4EDL2C>L4CA<GEL2G.D.L2CL4DEFGL2>A"
  2596.     [c:\]playtune "T80 L4ABL2C.L4 L2C.L4 CBA<GF#G>L2A.B.L2C"
  2597.  
  2598.  Example 2 
  2599.  
  2600.     [c:\]playtune "t41 mn l16 o2b4 p8 ms bb mn b4 p8 ms bbb8<g#8e8g#8>
  2601.     b8<g#8>b8 e8 b8<g#8e8g#8>b8<g#8>b8 e8 mn b4 p8 ms bb mn b4 p8 ms bb
  2602.     mn b4 p8 ms bb mn b4 p8 ms bbb8bbb8b8b8bbb8b8b8bbb8b8b8bbb8b8 l2b"
  2603.  
  2604.  
  2605. ΓòÉΓòÉΓòÉ 32. RESETINI - Reset the system *.INI files ΓòÉΓòÉΓòÉ
  2606.  
  2607. Synopsis 
  2608.  
  2609. RESETINI [/?] [/Q[-|+]] 
  2610.  
  2611. Options 
  2612.  
  2613.     /?      Display command syntax information. 
  2614.  
  2615.  Caution 
  2616.  
  2617.  If applications that are Workplace Shell extensions (i.e. parts of the PMSHELL 
  2618.  process rather than separate processes of their own) are currently running, 
  2619.  this command will cause them to be terminated and possibly restarted.  You 
  2620.  will lose all unsaved data in such applications. 
  2621.  
  2622.  Description 
  2623.  
  2624.  The RESETINI command removes the read-only attribute from the user INI and 
  2625.  system INI files, and then "resets" them, by calling the PrfReset() function 
  2626.  of Presentation Manager.  This causes the Workplace Shell, and any other 
  2627.  applications that monitor the state of the user and system INI files, to 
  2628.  reprocess them. 
  2629.  
  2630.  RESETINI does not modify the contents of the user INI or system INI files in 
  2631.  any way. 
  2632.  
  2633.  
  2634. ΓòÉΓòÉΓòÉ 33. SAYDATE - Display the date and time ΓòÉΓòÉΓòÉ
  2635.  
  2636. Synopsis 
  2637.  
  2638. SAYDATE [/?] [/F[str]] [/U[+|-]] [/TZ[zone]] [Dates ...] 
  2639.  
  2640. Options 
  2641.  
  2642.     /?      Display command syntax information. 
  2643.  
  2644.     /F      Specify a format string to use for displaying the date. 
  2645.  
  2646.             If this option is not specified, the default string is either "%c" 
  2647.             (display the date in a format determined by the country settings) 
  2648.             or, if the /ISO8601 option is given, "%F %T". 
  2649.  
  2650.     /U      Force SAYDATE to use UTC time rather than local time. (default:OFF) 
  2651.  
  2652.             If this toggle is ON, all times, both input and output, are assumed 
  2653.             to be in UTC time.  If this toggle is OFF, input and output are 
  2654.             assumed to be in local time.  (Input dates can include a specific 
  2655.             timezone in order to override this.) 
  2656.  
  2657.     /TZ     Specify a timezone string to use. 
  2658.  
  2659.             This overrides whatever TZ environment variable SAYDATE may have 
  2660.             inherited from its parent process. 
  2661.  
  2662.     /ISO8601 Display date and time in the standard format. 
  2663.  
  2664.  Description 
  2665.  
  2666.  The SAYDATE command displays the date and time.  If no arguments are given, it 
  2667.  displays the current date and time.  Otherwise it parses each individual 
  2668.  argument in turn (which is a date/time in one of several formats) and displays 
  2669.  the result. 
  2670.  
  2671.  Note:  SAYDATE defaults to using local time.  For correct operation, the 
  2672.         hardware real-time clock must be set to UTC and the TZ environment 
  2673.         variable must be properly set. 
  2674.  
  2675.  Unlike the DATE command built in to CMD, the default command interpreter in 
  2676.  OS/2, SAYDATE is designed to be useful in batch files.  It doesn't prompt the 
  2677.  user to enter a new date or time, and its output can be customised to suit 
  2678.  various needs by the optional format string given with the /F option, rather 
  2679.  than just using a fixed format.  It also allows dates and times other than the 
  2680.  current ones to be displayed. 
  2681.  
  2682.  Unlike the OS/2 port of the GNU DATE command (v1.12), SAYDATE supports the ISO 
  2683.  8601 date and weekday numbering format specifiers %F, %V, %G, %g, %u, and %z 
  2684.  used by business and industry, and can handle input years greater than 1999. 
  2685.  ( GNU DATE 1.12 fails on the year 2000.) 
  2686.  
  2687.  The % character is a metacharacter in the various command-line interpreters. 
  2688.  This means that in order to pass it to the SAYDATE command it must be doubled 
  2689.  (i.e. four % characters if a literal % character is required in the display). 
  2690.  Alternatively, either use the ^ character to "escape" the % character, such as 
  2691.  in the command 
  2692.  
  2693.     [c:\]saydate /f"The year is "^%Y.
  2694.  
  2695.  or (4OS2 and Take Command only) use the backquote character to prevent 
  2696.  metacharacter recognition, such as in the command 
  2697.  
  2698.     [c:\]saydate /f`"%G week %V, %a %T"`
  2699.  
  2700.  Examples 
  2701.  
  2702.     [c:\]saydate /iso8601
  2703.     1998-11-05 14:51:23
  2704.  
  2705.     [c:\]saydate /f"It is day %%u in week %%V."
  2706.     It is day 4 in week 45.
  2707.  
  2708.     [c:\]saydate /f"It is %%I:%%M %%p on %%A, the %%dth of %%B %%Y."
  2709.     It is 02:51 pm on Thursday, the 05th of November 1998.
  2710.  
  2711.     [c:\]saydate /f"Date: %%F %%T %%z."
  2712.     Date: 1998-11-05 14:51:29 +0000.
  2713.  
  2714.     [c:\]saydate /f"%%F is day %%u in week %%V of %%G" 1999-1-2 1999-1-3 1999-1-4
  2715.     1999-01-02 is day 6 in week 53 of 1998
  2716.     1999-01-03 is day 7 in week 53 of 1998
  2717.     1999-01-04 is day 1 in week 01 of 1999
  2718.  
  2719.     [c:\]saydate /iso8601 "2001-02-03 16:50:04" 2001-02-03
  2720.     2001-02-03 16:50:04
  2721.     2001-02-03 14:51:32
  2722.  
  2723.     [c:\]saydate /iso8601 "Feb 03, 2001" "Feb 03, 2001 16:50:04"
  2724.     2001-02-03 14:51:34
  2725.     2001-02-03 16:50:04
  2726.  
  2727.     [c:\]saydate /iso8601 "Wed 16:50:04" "Wed 16:50" Wed
  2728.     1998-11-11 16:50:04
  2729.     1998-11-11 16:50:00
  2730.     1998-11-11 14:51:35
  2731.  
  2732.     [c:\]saydate /iso8601 16:50:04 16:50
  2733.     1998-11-05 16:50:04
  2734.     1998-11-05 16:50:00
  2735.  
  2736.  
  2737. ΓòÉΓòÉΓòÉ 34. SETDATE - Set the hardware real-time clock ΓòÉΓòÉΓòÉ
  2738.  
  2739. Synopsis 
  2740.  
  2741. SETDATE [/?] [/QU[+|-]] [/TZ[zone]] Dates ... 
  2742.  
  2743. Options 
  2744.  
  2745.     /?      Display command syntax information. 
  2746.  
  2747.     /Q      Operate quietly. 
  2748.  
  2749.     /ISO8601 Display date and time in the standard format. 
  2750.  
  2751.     /U      Force SAYDATE to use UTC time rather than local time. (default:OFF) 
  2752.  
  2753.             If this toggle is ON, the input time is assumed to be in UTC time. 
  2754.             If this toggle is OFF, the input time is assumed to be in local 
  2755.             time.  (Input times can include a specific timezone in order to 
  2756.             override this.) 
  2757.  
  2758.     /TZ     Specify a timezone string to use. 
  2759.  
  2760.             This overrides whatever TZ environment variable SETDATE may have 
  2761.             inherited from its parent process. 
  2762.  
  2763.  Description 
  2764.  
  2765.  The SETDATE command allows the hardware real-time clock to be set from a date 
  2766.  and time passed as an argument (which can be in one of several formats). 
  2767.  
  2768.  Batch files that use the DATE and TIME commands built into CMD and 4OS2 are 
  2769.  subject to race conditions at midnight, since the two commands do not execute 
  2770.  simultaneously (and, indeed, on a heavily loaded system can execute seconds 
  2771.  apart).  The SETDATE command can set date and time in one operation. 
  2772.  
  2773.  For each successive argument, SETDATE adjusts the hardware real-time clock to 
  2774.  the appropriate UTC time.  If the /Q toggle is not ON, it then displays the 
  2775.  UTC time that it has set. 
  2776.  
  2777.  Examples 
  2778.  
  2779.     [c:\]setdate 1999-10-2
  2780.  
  2781.  will set the date to the 2nd of October 1999, but will not alter the time of 
  2782.  day. 
  2783.  
  2784.     [c:\]setdate 16:45:00
  2785.  
  2786.  will set the time to the UTC equivalent of 16:45:00, local time, but will not 
  2787.  alter the date. 
  2788.  
  2789.     [c:\]setdate /u 16:45:00
  2790.  
  2791.  will set the time to 16:45:00, UTC, but will not alter the date. 
  2792.  
  2793.     [c:\]setdate "1999-10-2 16:45:00"
  2794.  
  2795.  will set the date and time to the UTC equivalent of 16:45:00 on the 2nd of 
  2796.  October 1999, local time, in one operation. 
  2797.  
  2798.     [c:\]setdate "1999-10-2 16:45:00 +0200"
  2799.  
  2800.  will set the date and time to 14:45:00 on the 2nd of October 1999, UTC (since 
  2801.  the local timezone specified is two hours ahead of UTC), in one operation. 
  2802.  
  2803.     [c:\]setdate "1999-10-2 16:45:00 +0200" "14:47:00"
  2804.  
  2805.  will first set the date and time to the same as the previous example, and then 
  2806.  will set the time to the UTC equivalent of 14:47:00, local time, without 
  2807.  further altering the date. 
  2808.  
  2809.  
  2810. ΓòÉΓòÉΓòÉ 35. SORT - Sort file contents ΓòÉΓòÉΓòÉ
  2811.  
  2812. Synopsis 
  2813.  
  2814. SORT [/?] [/A[[-|+]drash]] [/RSEI[-|+]] [/+n] [Filespecs ...] 
  2815.  
  2816. Options 
  2817.  
  2818.     /?      Display command syntax information. 
  2819.  
  2820.     /A      Select files by attribute. 
  2821.  
  2822.     /E      Do not display non-fatal error messages. 
  2823.  
  2824.     /S      Recurse into subdirectories. 
  2825.  
  2826.     /R      Reverse the sort order. (default:OFF) 
  2827.  
  2828.     /I      Ignore case in comparisons. (default:OFF) 
  2829.  
  2830.     /+      Specify the starting column number to use when sorting. (default:1) 
  2831.  
  2832.  Description 
  2833.  
  2834.  The SORT command displays, in sorted order, the contents of the files denoted 
  2835.  by the wildcard specifications. If no filenames are specified, SORT will act 
  2836.  as a filter command, reading and sorting its standard input. 
  2837.  
  2838.  Unlike the SORT command supplied with OS/2, SORT can sort files named on the 
  2839.  command line and can sort files of any size, subject to available virtual 
  2840.  memory.  SORT also supports extended wildcards and selection of files by 
  2841.  attribute, and is a 32-bit program.  (The OS/2 SORT program is a 16-bit 
  2842.  program.)  And since SORT reads all of its input before writing any output, 
  2843.  its output can be safely redirected to the same place as its input without 
  2844.  risking an infinite loop. 
  2845.  
  2846.  Note:  Where the total size of all files to be sorted is large, SORT may take 
  2847.  some time to sort the contents before displaying anything.  SORT uses a 
  2848.  combination of the Quicker Sort and Insertion Sort algorithms. 
  2849.  
  2850.  Examples 
  2851.  
  2852.  To display the contents of all *.TXT files, concatenated together, in sorted 
  2853.  order: 
  2854.  
  2855.     [c:\]sort *.txt
  2856.  
  2857.  To display the contents of all *.TXT files, concatenated together, in sorted 
  2858.  order, ignoring case: 
  2859.  
  2860.     [c:\]sort /i *.txt
  2861.  
  2862.  To display the output of the GREP command in reverse sorted order: 
  2863.  
  2864.     [c:\]grep /b "tiger" *.txt | sort /r
  2865.  
  2866.  
  2867. ΓòÉΓòÉΓòÉ 36. STRINGS - Search files for strings ΓòÉΓòÉΓòÉ
  2868.  
  2869. Synopsis 
  2870.  
  2871. STRINGS [/?] [/A[[-|+]drash]] [/SEBU[-|+]] [/Mn] [Filespecs ...] 
  2872.  
  2873. Options 
  2874.  
  2875.     /?      Display command syntax information. 
  2876.  
  2877.     /A      Select files by attribute. 
  2878.  
  2879.     /E      Do not display non-fatal error messages. 
  2880.  
  2881.     /S      Recurse into subdirectories. 
  2882.  
  2883.     /U      Do not display summary information. 
  2884.  
  2885.     /B      Display "bare" lines, without the filename and position within the 
  2886.             file. (default:OFF) 
  2887.  
  2888.     /M      Specify the minimum length for a string. (default:4) 
  2889.  
  2890.  Description 
  2891.  
  2892.  The STRINGS command searches the files denoted by the wildcard specifications 
  2893.  for strings of printable characters, terminated either by a non-printable 
  2894.  character or the end of the file, and displays them.  If no filenames are 
  2895.  specified, STRINGS will act as a filter command, scanning its standard input. 
  2896.  
  2897.  Examples 
  2898.  
  2899.     [C:\CLU]strings strings.exe | grep /b Usage
  2900.     Strings.exe(9270):Usage: STRINGS [/?] [/A[[+|-]drash]] [/SEBU[+|-]] [/Mn] [Filespecs ...]
  2901.  
  2902.  
  2903. ΓòÉΓòÉΓòÉ 37. SUM - Checksum and CRC file contents ΓòÉΓòÉΓòÉ
  2904.  
  2905. Synopsis 
  2906.  
  2907. SUM [/?] [/A[[-|+]drash]] [/SEUFB[-|+]] [Filespecs ...] 
  2908.  
  2909. Options 
  2910.  
  2911.     /?      Display command syntax information. 
  2912.  
  2913.     /A      Select files by attribute. 
  2914.  
  2915.     /E      Do not display non-fatal error messages. 
  2916.  
  2917.     /S      Recurse into subdirectories. 
  2918.  
  2919.     /U      Do not display summary information. 
  2920.  
  2921.     /B      Display in "Bare" format, without header or footer lines. 
  2922.             (default:OFF) 
  2923.  
  2924.     /F      Display full filenames, rather than simply basenames. (default:ON) 
  2925.  
  2926.  Description 
  2927.  
  2928.  The SUM command calculates various CRCs and checksums for the files denoted by 
  2929.  the wildcard specifications. If no filenames are specified, SUM will act as a 
  2930.  filter command, reading its standard input. 
  2931.  
  2932.  Unlike the ESUM command supplied with OS/2, SUM supports extended wildcards, 
  2933.  selection of files by attribute, and several checksums and CRCs superior to 
  2934.  the BSD UNIX one.  It is also a 32-bit program.  (The OS/2 ESUM program is a 
  2935.  16-bit program.) 
  2936.  
  2937.  The CRCs and checksums are as follows: 
  2938.  
  2939.  CRC       CRC-16, as used by most archive utilities. 
  2940.  
  2941.  CRC-32    CRC-32, as used by ZIP archives and BSD UNIX, polynomial x^32 + x^26 
  2942.            + x^23 + x^22 + x^16 + x^12 + x^11 + x^10 + x^8 + x^7 + x^5 + x^4 + 
  2943.            x^2 + x + 1. 
  2944.  
  2945.  Sum1      The 16-bit checksum provided by the "sum" command in BSD UNIX (right 
  2946.            rotation before each addition, discard overflow), and by the ESUM 
  2947.            command supplied in OS/2 Warp. 
  2948.  
  2949.  Sum2      The 16-bit checksum provided by the "sum" command in System V UNIX 
  2950.            (32-bit total divided by 0xFFFF). 
  2951.  
  2952.  MD5       MD5 Message Digest from RSA Data Security. 
  2953.  
  2954.  Note:  The UNIX "sum" commands, and the ESUM utility supplied with OS/2, 
  2955.  display their checksums in decimal.  The SUM command displays them in 
  2956.  hexadecimal, since that is how they are displayed by many popular PC 
  2957.  utilities, including the ARC, ARJ, and ZIP archive tools.  SUM also makes no 
  2958.  attempt to display the number of disk blocks (which is a fiction in most 
  2959.  non-UNIX implementations of the UNIX "sum" command anyway).  To obtain 
  2960.  allocation information about files, use the XDIR command. 
  2961.  
  2962.  Examples 
  2963.  
  2964.     [C:\CLU]sum ???.exe
  2965.     CRC  CRC32    Sum1 Sum2 MD5                              (name)
  2966.     ---- -------- ---- ---- --------------------------------
  2967.     3287 18c9796c 3c59 ea35 0585423faa7511c77b37546b85781314 Mem.exe
  2968.     f404 d428edfb 8695 a2b4 da3e1013b13521a5d4c15a9074c0e126 Sum.exe
  2969.     00d4 4c18f9c1 b3b2 b499 aa12029b6072ac0218528f89381affb5 Tee.exe
  2970.     ---- -------- ---- ---- --------------------------------
  2971.              3 files found, 6 files scanned.
  2972.  
  2973.  
  2974. ΓòÉΓòÉΓòÉ 38. TASKLIST - Display the contents of the PM Window List ΓòÉΓòÉΓòÉ
  2975.  
  2976. Synopsis 
  2977.  
  2978. TASKLIST [/?] [/B[-|+]] 
  2979.  
  2980. Options 
  2981.  
  2982.     /?      Display command syntax information. 
  2983.  
  2984.     /B      Display in "Bare" format, without header or footer lines. 
  2985.             (default:OFF) 
  2986.  
  2987.  Note 
  2988.  
  2989.  Although it is a text-mode program, TASKLIST will not work when booted to a 
  2990.  command line via the OS/2 "Multiboot" menu, or when booted from the OS/2 
  2991.  installation/repair floppies, because it requires the Presentation Manager 
  2992.  DLLs. 
  2993.  
  2994.  Description 
  2995.  
  2996.  The TASKLIST command displays the contents of the "Window List" maintained by 
  2997.  Presentation Manager.  For each task in the list, it displays the information 
  2998.  contained in the list entry, including the window handle, the process and 
  2999.  session IDs, the program type, and the title. 
  3000.  
  3001.  Note:  The "Window List" maintained by PM is a collaborative effort of all of 
  3002.  the applications that want to be listed in it.  It is not a list of all of the 
  3003.  processes running on the system. 
  3004.  
  3005.  
  3006. ΓòÉΓòÉΓòÉ 39. TEE - T-shaped pipe fitting ΓòÉΓòÉΓòÉ
  3007.  
  3008. Synopsis 
  3009.  
  3010. TEE [/?] [/A] [Filenames ...] 
  3011.  
  3012. Options 
  3013.  
  3014.     /?      Display command syntax information. 
  3015.  
  3016.     /A      Append the data to the files, instead of ovewriting them. 
  3017.             (default:OFF) 
  3018.  
  3019.  Description 
  3020.  
  3021.  The TEE command is a "T shaped fitting" for use in command pipelines. 
  3022.  
  3023.  It copies whatever it receives from its standard intput to its standard 
  3024.  output, also sending a copy to each of the files named as its arguments. 
  3025.  
  3026.  The /A option is useful for appending the output of a command to a logfile, 
  3027.  for example. 
  3028.  
  3029.  Examples 
  3030.  
  3031.  To display the output of the SAYDATE command, sending a copy to the file 
  3032.  DATE.OUT, which will be truncated to zero and overwritten with the new data: 
  3033.  
  3034.     [c:\]saydate | tee date.out
  3035.  
  3036.  To display the output of the SAYDATE command, sending a copy to the file 
  3037.  DATE.OUT, appending it to the original contents of the file: 
  3038.  
  3039.     [c:\]saydate | tee /a date.out
  3040.  
  3041.  
  3042. ΓòÉΓòÉΓòÉ 40. TEXTCONV - Convert text file formats ΓòÉΓòÉΓòÉ
  3043.  
  3044. Synopsis 
  3045.  
  3046. TEXTCONV [/?] [/A[[-|+]drash]] [/SE[-|+]] [/ICP|OCP[cp]] [/INL|ONL[nl]] 
  3047. [Filespecs ...] 
  3048.  
  3049. Options 
  3050.  
  3051.     /?      Display command syntax information. 
  3052.  
  3053.     /A      Select files by attribute. 
  3054.  
  3055.     /E      Do not display non-fatal error messages. 
  3056.  
  3057.     /S      Recurse into subdirectories. 
  3058.  
  3059.     /ICP    Specify input code page.  (default:850) 
  3060.  
  3061.     /OCP    Specify output code page.  (default:850) 
  3062.  
  3063.     /INL    Specify input newline convention.  (default:CRLF) 
  3064.  
  3065.             The options are CRLF, CR, or LF . 
  3066.  
  3067.     /ONL    Specify output newline convention.  (default:CRLF) 
  3068.  
  3069.             The options are CRLF, CR, or LF . 
  3070.  
  3071.  Description 
  3072.  
  3073.  The TEXTCONV command reads the files specified by the wildcard specifications 
  3074.  and writes their converted contents to its standard output.  If no filenames 
  3075.  are specified, TEXTCONV will act as a filter command, reading and converting 
  3076.  its standard input. 
  3077.  
  3078.  Conversion proceeds by reading the input, a line at a time, using the newline 
  3079.  convention specified by the /INL option, converting it, and writing it to the 
  3080.  standard output using the newline convention specified by the /ONL option. 
  3081.  
  3082.  The conversion between the input code page and the output code page uses 
  3083.  Unicode as an intermediate form.  Input characters are converted from the 
  3084.  input code page to Unicode, and then from Unicode to the output code page. 
  3085.  
  3086.  TEXTCONV is designed to make it easy to interchange text files between PCs 
  3087.  (which usually use code pages 437 and 850) and other systems. 
  3088.  
  3089.  For example, a PC user using code page 437 can read a text file generated on a 
  3090.  Macintosh (CR newline convention) in ISO 8859 Latin-1 (code page 1004) using 
  3091.  the command: 
  3092.  
  3093.     [c:\]textconv /icp:1004 /inl:cr /ocp:437 macfile.txt | more
  3094.  
  3095.  For another example, a PC user can make a text file, created locally in code 
  3096.  page 437, suitable for transfer to a UNIX system that uses ISO 8859 Latin-1 
  3097.  with the command: 
  3098.  
  3099.     [c:\]textconv /icp:437 /ocp:1004 /onl:lf file.txt > outfile.txt
  3100.  
  3101.  For a third example, a PC user can convert a text file from code page 437 to 
  3102.  code page 850 with the command: 
  3103.  
  3104.     [c:\]textconv /icp:437 /ocp:850 file437.txt > file850.txt
  3105.  
  3106.  
  3107. ΓòÉΓòÉΓòÉ 41. TOUCH - Update last modification times ΓòÉΓòÉΓòÉ
  3108.  
  3109. Synopsis 
  3110.  
  3111. TOUCH [/?] [/A[[-|+]drash]] [/SEPZQNU[-|+]] [/M[acw]] [/Ttime] [/Ddate] 
  3112. Filespecs ... 
  3113.  
  3114. Options 
  3115.  
  3116.     /?      Display command syntax information. 
  3117.  
  3118.     /A      Select files by attribute. 
  3119.  
  3120.     /E      Do not display non-fatal error messages. 
  3121.  
  3122.     /N      Simulate execution. 
  3123.  
  3124.     /Q      Operate quietly. 
  3125.  
  3126.     /S      Recurse into subdirectories. 
  3127.  
  3128.     /U      Do not display summary information. 
  3129.  
  3130.     /Z      Override the read-only attribute on files. 
  3131.  
  3132.     /D      Use the given date instead of today's date. 
  3133.  
  3134.     /T      Use the given time instead of the current time. 
  3135.  
  3136.     /M      Specify which date and time stamp will be modified: 
  3137.  
  3138.             A              Date and time that the file was last accessed 
  3139.  
  3140.             C              Date and time that the file was created 
  3141.  
  3142.             W              Date and time that the file was last modified 
  3143.                            (default) 
  3144.  
  3145.     /ISO8601 Display date and time in the standard format. 
  3146.  
  3147.  Note 
  3148.  
  3149.  The FAT and HPFS filesystems, and OS/2 itself, only support file dates between 
  3150.  1980 and 2107, and have a granularity of two seconds for file times. 
  3151.  
  3152.  OS/2 allows files to have nonsense dates like the 30th of February.  The TOUCH 
  3153.  command passes the date given to the /D option directly to the operating 
  3154.  system without attempting to validate or renormalise it.  The target date 
  3155.  displayed by the TOUCH command is the date that it is passing to the operating 
  3156.  system. The actual date set on the file varies from filesystem driver to 
  3157.  filesystem driver.  The FAT filesystem driver will substitute the year 2099 
  3158.  for the years 2100 to 2107 but will otherwise use the date as given. The HPFS 
  3159.  filesystem driver will renormalise invalid dates to the nearest valid date, 
  3160.  but doesn't know that the year 2100 is not a leap year. The behaviour of the 
  3161.  filesystem driver is not within the control of the TOUCH command. 
  3162.  
  3163.  Description 
  3164.  
  3165.  The TOUCH command updates the date and time stamps of the files specified by 
  3166.  the wildcard specifications to the current date and time, or to the specified 
  3167.  date and time if the /D and /T options are used.  The modifiers 'A', 'C', and 
  3168.  'W' for the /M option control which date and time stamp is affected. 
  3169.  
  3170.  The formats of the date and time strings accepted vary according to the 
  3171.  current country code configured into the operating system.  See 
  3172.  country-dependent date and time formats. 
  3173.  
  3174.  Note:  The OS/2 kernel sets file timestamps in UTC, rather than in local time. 
  3175.         It assumes that the hardware real-time clock has been set to UTC. 
  3176.  
  3177.  Examples 
  3178.  
  3179.     [c:\]touch /S *.txt
  3180.  
  3181.  sets the last modification date and time stamps of all TXT files in the 
  3182.  current directory and all subdirectories to the current date and time. 
  3183.  
  3184.     [c:\]touch /D1-1-1980 *.txt
  3185.  
  3186.  sets the last modification date and time stamps of all TXT files in the 
  3187.  current directory to the date 1980-01-01 and the current time. 
  3188.  
  3189.     [c:\]touch /D1-1-1980 /T1:14:32 *.txt
  3190.  
  3191.  sets the last modification date and time stamps of all TXT files in the 
  3192.  current directory to the date 1980-01-01 and the time 01:14:32. 
  3193.  
  3194.     [c:\]touch /MA *.txt
  3195.  
  3196.  sets the last access date and time stamp of all TXT files in the current 
  3197.  directory to the current date and time. 
  3198.  
  3199.     [c:\]touch /MC /D1-1-1980 /T0:0:0 *.txt
  3200.  
  3201.  sets the creation date and time stamp of all TXT files in the current 
  3202.  directory to the date 1980-01-01 and the time 0:0:0. 
  3203.  
  3204.  
  3205. ΓòÉΓòÉΓòÉ 42. TREE - Display a filesystem tree ΓòÉΓòÉΓòÉ
  3206.  
  3207. Synopsis 
  3208.  
  3209. TREE [/?] [/A[[-|+]drash]] [/FGB[-|+]] [Filespecs ...] 
  3210.  
  3211. Options 
  3212.  
  3213.     /?      Display command syntax information. 
  3214.  
  3215.     /A      Select files by attribute. 
  3216.  
  3217.     /F      Display files as well. (default:OFF) 
  3218.  
  3219.     /G      Use graphic characters. (default:ON) 
  3220.  
  3221.     /B      Display "brief" output, which doesn't include size and allocation 
  3222.             information.  (default:OFF) 
  3223.  
  3224.  Note 
  3225.  
  3226.  The sizes of directories, i.e. the number of bytes on disc that are consumed 
  3227.  by the directories themselves, are not reported by OS/2 to applications.  OS/2 
  3228.  always returns 0 for the length and allocation size of a directory.  (This is 
  3229.  the reason that the DIR command built into the command interpreter displays 
  3230.  "<DIR>" in the length field for directories.) TREE displays whatever size OS/2 
  3231.  reports, for both files and directories. If this behaviour of OS/2 is ever 
  3232.  fixed, TREE will thus automatically display the correct size information for 
  3233.  directories. 
  3234.  
  3235.  Description 
  3236.  
  3237.  The TREE command displays the filesystem tree that is rooted at the directory 
  3238.  given in the wildcard specifications, or the current directory if none are 
  3239.  supplied.  It uses indentation and graphics characters to display the tree 
  3240.  structure. 
  3241.  
  3242.  If the /F option is used, the TREE command will also display all files, 
  3243.  subject to any attribute masks specified with the /A option, that match the 
  3244.  basename portion of the wildcard specifications. Otherwise, the basename 
  3245.  portion is ignored. 
  3246.  
  3247.  Examples 
  3248.  
  3249.     [C:\CLU]tree /b c:\mptn\
  3250.     c:\MPTN\
  3251.     Γö£ΓöÇΓöÇBIN
  3252.     Γö£ΓöÇΓöÇDLL
  3253.     Γö£ΓöÇΓöÇMSG
  3254.     Γöé  ΓööΓöÇΓöÇNLS
  3255.     ΓööΓöÇΓöÇPROTOCOL
  3256.  
  3257.     [C:\CLU]tree /f c:\mptn\*.dll
  3258.                         c:\MPTN\
  3259.            0          0 Γö£ΓöÇΓöÇBIN
  3260.            0          0 Γö£ΓöÇΓöÇDLL
  3261.        49075      49152 Γöé     dapwsock.dll
  3262.       190099     190464 Γöé     ddnsres.dll
  3263.        49064      49152 Γöé     pmwsock.dll
  3264.        37842      37888 Γöé     so32dll.dll
  3265.        62289      62464 Γöé     tcp32dll.dll
  3266.        47279      47616 Γöé     tcpipdll.dll
  3267.        34304      34304 Γöé     tcpmri.dll
  3268.        32288      32768 Γöé     tcptime.dll
  3269.        66048      66048 Γöé     tnls32.dll
  3270.            0          0 Γö£ΓöÇΓöÇMSG
  3271.            0          0 Γöé  ΓööΓöÇΓöÇNLS
  3272.         6144       6144 Γöé        ddnscfg.dll
  3273.        10752      10752 Γöé        dhcpmres.dll
  3274.            0          0 ΓööΓöÇΓöÇPROTOCOL
  3275.  
  3276.  
  3277. ΓòÉΓòÉΓòÉ 43. WC - Count words, lines, letters, and characters in files ΓòÉΓòÉΓòÉ
  3278.  
  3279. Synopsis 
  3280.  
  3281. WC [/?] [/A[[-|+]drash]] [/O[lwacb]] [/SECHU[-|+]] [Filespecs ...] 
  3282.  
  3283. Options 
  3284.  
  3285.     /?      Display command syntax information. 
  3286.  
  3287.     /A      Select files by attribute. 
  3288.  
  3289.     /E      Do not display non-fatal error messages. 
  3290.  
  3291.     /S      Recurse into subdirectories. 
  3292.  
  3293.     /B      Display in "Bare" format, without header or footer lines. 
  3294.             (default:OFF) 
  3295.  
  3296.     /C      Prevent control characters from being counted as characters. 
  3297.             (default:OFF) 
  3298.  
  3299.     /H      Prevent hyphens from splitting words into two. (default:OFF) 
  3300.  
  3301.     /U      Prevent punctuation characters from splitting words. (default:OFF) 
  3302.  
  3303.     /O      Specify a string that determines what information should be output, 
  3304.             comprising zero or more of the following characters: 
  3305.  
  3306.             L              Print the number of lines. 
  3307.  
  3308.             W              Print the number of words. 
  3309.  
  3310.             A              Print the number of letters. (Mnemonic: "A = 
  3311.                            alphabet") 
  3312.  
  3313.             C              Print the number of characters. 
  3314.  
  3315.             B              Print the number of bytes. 
  3316.  
  3317.  Description 
  3318.  
  3319.  The WC command opens and reads all of the files denoted by the wildcard 
  3320.  specifications, counting the number of lines, words, letters, characters, and 
  3321.  bytes that they contain.  If no filenames are specified, WC will act as a 
  3322.  filter command, counting the number of lines, words, letters, characters, and 
  3323.  bytes on its standard input. 
  3324.  
  3325.  In the absence of options to the contrary, WC will will normally split words 
  3326.  at any character that is not a letter character. 
  3327.  
  3328.  The /C option is useful for counting characters in files that are not plain 
  3329.  text files, such as document files used by some wordprocessors. Such files use 
  3330.  control characters for embedded formatting information, such as fount changes. 
  3331.  Whitespace characters do not count towards the total number of characters 
  3332.  irrespective of the state of the /C toggle. 
  3333.  
  3334.  Examples 
  3335.  
  3336.     [C:\CLU]wc *.txt
  3337.        lines    words  letters    chars    bytes (name)
  3338.     -------- -------- -------- -------- --------
  3339.          403     3518    13699    20174    20980 blurb.txt
  3340.          151     1157     4123     5972     6274 readme.txt
  3341.     -------- -------- -------- -------- --------
  3342.          554     4675    17822    26146    27254 (Total)
  3343.  
  3344.  
  3345. ΓòÉΓòÉΓòÉ 44. WHAT - Search files for ID strings ΓòÉΓòÉΓòÉ
  3346.  
  3347. Synopsis 
  3348.  
  3349. WHAT [/?] [/A[[-|+]drash]] [/SEU[-|+]] [Filespecs ...] 
  3350.  
  3351. Options 
  3352.  
  3353.     /?      Display command syntax information. 
  3354.  
  3355.     /A      Select files by attribute. 
  3356.  
  3357.     /E      Do not display non-fatal error messages. 
  3358.  
  3359.     /S      Recurse into subdirectories. 
  3360.  
  3361.     /U      Do not display summary information. 
  3362.  
  3363.  Description 
  3364.  
  3365.  The WHAT command searches the files denoted by the wildcard specifications for 
  3366.  the identifying strings used in SCCS ("@(#)" and "@[#]"), and displays them. 
  3367.  If no filenames are specified, WHAT will act as a filter command, scanning its 
  3368.  standard input. 
  3369.  
  3370.  Note:  The WHAT command deals solely with ID strings, and no longer calculates 
  3371.  the CRC-16 for each file as well.  A wider range of CRC and checksum data than 
  3372.  that provided by earlier releases of the WHAT command is now available with 
  3373.  the SUM command.  To display the module name information from an executable 
  3374.  file, use the DUMP command. 
  3375.  
  3376.  Examples 
  3377.  
  3378.     [C:\CLU]what what.exe
  3379.     What.exe WHAT Aug 24 1999 11:52:00 version 1.20
  3380.              1 files found, 1 files scanned.
  3381.  
  3382.  
  3383. ΓòÉΓòÉΓòÉ 45. WHICH - Locate a command on the PATH ΓòÉΓòÉΓòÉ
  3384.  
  3385. Synopsis 
  3386.  
  3387. WHICH [/?] [/P[variable]] [/X[variable]] [/B[-|+]] Filespecs ... 
  3388.  
  3389. Options 
  3390.  
  3391.     /?      Display command syntax information. 
  3392.  
  3393.     /B      Display "bare" filenames, without attribute, size, or date 
  3394.             information. (default:OFF) 
  3395.  
  3396.     /P      Specify an alternate environment variable to use instead of PATH. 
  3397.  
  3398.     /X      Specify an alternate environment variable to use instead of 
  3399.             PATHEXT. 
  3400.  
  3401.     /ISO8601 Display date and time in the standard format. 
  3402.  
  3403.  Note:  Although OS/2 itself places no restriction on the case of environment 
  3404.  variable names, all command interpreters, by convention, only use upper case 
  3405.  names for environment variables. 
  3406.  
  3407.  Description 
  3408.  
  3409.  WHICH determines what command would be executed were it to be typed at the 
  3410.  command line.  It searches the directories listed in the path environment 
  3411.  variable for the command, using the extensions specified by the extensions 
  3412.  environment variable.  If the current directory is not explicitly mentioned in 
  3413.  the path environment variable, WHICH will also search the current directory 
  3414.  first. 
  3415.  
  3416.  If the /X option is not used and the "PATHEXT" environment variable does not 
  3417.  exist, WHICH will by default use the extensions COM, EXE, BTM, BAT, and CMD. 
  3418.  
  3419.  WHICH is aware of internal commands that are built in to the various command 
  3420.  processors and "executable extensions", and will will indicate any that it 
  3421.  finds. 
  3422.  
  3423.  WHICH supports standard wildcards in the file specifications, allowing for 
  3424.  searches for partial commands, such as 
  3425.  
  3426.     [c:\]which *boot*
  3427.  
  3428.  which will locate all of the commands that contain "BOOT" in their names (e.g. 
  3429.  SETBOOT, BOOT, and BOOTDISK). 
  3430.  
  3431.  Note:  If a file specification contains a wildcard ending with an asterisk, 
  3432.  WHICH will display the names of the commands found twice, the first time as a 
  3433.  result of matching the wildcard as it stands, and the second as a result of 
  3434.  matching the wildcard with one of the extensions tacked onto the end. 
  3435.  
  3436.  The /P and /X options can be useful for locating files other than executables. 
  3437.  For example, Presentation Manager locates help files using the HELP 
  3438.  environment variables, and the HLP extension: 
  3439.  
  3440.     [c:\]set HELPEXT=.hlp & which /PHELP /XHELPEXT wphelp
  3441.  
  3442.  For another example, the VIEW command locates on-line books using the 
  3443.  BOOKSHELF environment variable and the INF extension: 
  3444.  
  3445.     [c:\]set BOOKEXT=.INF & which /PBOOKSHELF /XBOOKEXT cmdref
  3446.  
  3447.  Examples 
  3448.  
  3449.     [C:\]which /iso8601 find
  3450.     1999-08-24 11:27:18        814        138 _____A C:\CLU\find.cmd
  3451.     1996-08-09 00:24:16      30859          0 _____A C:\OS2\FIND.EXE
  3452.  
  3453.     [C:\]which /iso8601 help
  3454.     HELP is built-in to 4OS2 and Take Command.
  3455.     1999-08-24 11:27:18       1935        140 _____A C:\CLU\help.cmd
  3456.     1994-10-31 19:29:08        586          0 _____A C:\OS2\HELP.CMD
  3457.     1994-10-31 19:29:08        591          0 _____A C:\OS2\MDOS\HELP.BAT
  3458.  
  3459.     [C:\]which /iso8601 dir set
  3460.     DIR is built-in to the 16-bit CMD, and 4OS2 and Take Command.
  3461.     SET is built-in to the 16-bit CMD, the 32-bit CMD, and 4OS2 and Take Command.
  3462.  
  3463.  
  3464. ΓòÉΓòÉΓòÉ 46. WINSIGHT - Display PM window relationships ΓòÉΓòÉΓòÉ
  3465.  
  3466. Synopsis 
  3467.  
  3468. WINSIGHT [/?] [/CONFIRMCLOSE] [/Iinstancename] 
  3469.  
  3470. Options 
  3471.  
  3472.     /?      Display command syntax information. 
  3473.  
  3474.     /I      Specify the "instance" name used for saving and restoring the 
  3475.             window position to and from the OS/2 User Profile file. 
  3476.  
  3477.     /CONFIRMCLOSERequire confirmation before closing the program. 
  3478.             (default:OFF) 
  3479.  
  3480.  Description 
  3481.  
  3482.  The WINSIGHT command displays the hierarchy of Presentation Manager windows. 
  3483.  The hierarchy is displayed as a tree, with each window descending from its 
  3484.  parent window. 
  3485.  
  3486.  For each window, WINSIGHT displays the window handle, the handle of the 
  3487.  window's owner window, the process and thread ID to which it belongs, the 
  3488.  window's style flags and ID, the window's class, and the window's text. The 
  3489.  standard class names (e.g.  WC_FRAME) are translated from their internal 
  3490.  numeric form into their symbolic names. 
  3491.  
  3492.  The display of WINSIGHT is static, and is only updated when it is first 
  3493.  started, or when "Refresh" is selected from the menu. 
  3494.  
  3495.  Note:  WINSIGHT writes its current window position, whenever it exits, to the 
  3496.         "OS2CLU PM Window Tree:Position" section of the OS/2 User Profile file 
  3497.         (usually C:\OS2\OS2.INI), which it then reads and uses when it next 
  3498.         starts up.  The name of the key used is determined by the /I option. 
  3499.  
  3500.  
  3501. ΓòÉΓòÉΓòÉ 47. XDEL - Extended DEL ΓòÉΓòÉΓòÉ
  3502.  
  3503. Synopsis 
  3504.  
  3505. XDEL [/?] [/A[[-|+]drash]] [/SEPZQNUXWF[-|+]] Filespecs ... 
  3506.  
  3507. Options 
  3508.  
  3509.     /?      Display command syntax information. 
  3510.  
  3511.     /A      Select files by attribute. 
  3512.  
  3513.     /E      Do not display non-fatal error messages. 
  3514.  
  3515.     /N      Simulate execution. 
  3516.  
  3517.     /Q      Operate quietly. 
  3518.  
  3519.     /S      Recurse into subdirectories. 
  3520.  
  3521.     /U      Do not display summary information. 
  3522.  
  3523.     /Z      Override the read-only attribute on files. 
  3524.  
  3525.     /X      Remove empty subdirectories when /S option is used. (default:OFF) 
  3526.  
  3527.     /F      Prevent undelete information from being saved. (default:OFF) 
  3528.  
  3529.     /W      Zero the contents of each file before deleting it. (default:OFF) ( 
  3530.             Note on wiping files) 
  3531.  
  3532.             Use this option with caution.  The contents of all files deleted in 
  3533.             this manner are unrecoverable.  Even if undeleted with the UNDELETE 
  3534.             command, the original contents of the files will have been lost. 
  3535.  
  3536.     /ISO8601 Display date and time in the standard format. 
  3537.  
  3538.  Description 
  3539.  
  3540.  The XDEL command is an extended DEL command that deletes the the files 
  3541.  specified by the wildcard specifications. 
  3542.  
  3543.  Unlike the DEL command built in to CMD, the default command interpreter in 
  3544.  OS/2, XDEL supports extended wildcards, deleting files in subdirectories, 
  3545.  removing empty subdirectories, selection of files by attribute, and overriding 
  3546.  the read-only attribute. 
  3547.  
  3548.  Examples 
  3549.  
  3550.     [c:\]xdel /se \*.{bak,bkp}
  3551.  
  3552.  deletes all *.BAK and *.BKP files (usually backup copies of files modified by 
  3553.  a text editor) in all subdirectories starting from the root directory. 
  3554.  
  3555.     [c:\]xdel /w *.txt
  3556.  
  3557.  deletes all *.TXT files from the current directory, overwriting them entirely 
  3558.  with zeroes first. 
  3559.  
  3560.     [c:\]xdel /s/x/z c:\subdir1\
  3561.  
  3562.  deletes the entire tree rooted at the directory C:\SUBDIR1\, including 
  3563.  read-only files and removing all empty subdirectories as well. Notice the 
  3564.  trailing slash.  This is equivalent to the DELTREE command in DR-DOS or 
  3565.  MS-DOS. 
  3566.  
  3567.     [c:\]xdel /s/x/z c:\subdir1
  3568.  
  3569.  recursively scans the entire directory tree on drive C:, deleting all files 
  3570.  named SUBDIR1, and removing all empty subdirectories. Directories in the 
  3571.  Workplace Shell Desktop are usually empty, and will be deleted by this command 
  3572.  if your WPS desktop happens to be on drive C:.  This will cause your system to 
  3573.  become unbootable.. 
  3574.  
  3575.  
  3576. ΓòÉΓòÉΓòÉ 47.1. Wiping files ΓòÉΓòÉΓòÉ
  3577.  
  3578. Some governments require that high security files be wiped by writing patterns 
  3579. of ones and zeros over the file data several times.  The purpose of this is to 
  3580. ensure that the magnetic domains on the magnetic medium storing the file are 
  3581. thoroughly altered.  ( Depending upon how well the read/write head is aligned, 
  3582. simply overwriting data once may not realign all of the magnetic domains; and 
  3583. the old data may be readable by accessing the disc platter using specialised 
  3584. hardware to read the off-centre magnetic flux patterns.  Writing 1s and 0s 
  3585. multiple times ensures that the magnetic domains on the fringes of the track 
  3586. are also brought into line.  ) 
  3587.  
  3588. The /W option to the XDEL command does not provide this facility.  This is 
  3589. because with an operating system like OS/2, which has disc caching, simply 
  3590. writing a file multiple times in an application (such as the XDEL command) does 
  3591. not guarantee that the actual sectors on the disc will be written multiple 
  3592. times.  All write requests but the final one may well be satisfied entirely by 
  3593. the disc cache, and actual writes to disk need not necessarily occur.  In order 
  3594. to ensure that the writes physically happen, one has to instruct the operating 
  3595. system not to use its cache. 
  3596.  
  3597. Unfortunately, this still doesn't help with the case where the file is on a 
  3598. network server, since the server may implement caching that is invisible to 
  3599. applications running on the client machine, or may use a LAN protocol where 
  3600. caching may not be disabled. 
  3601.  
  3602. The /W option to the XDEL command is intended to provide the level of security 
  3603. necessary to guard against attacks from ordinary users, rather than from 
  3604. foreign powers.  Ordinary users usually do not have the ability, or the 
  3605. specialised equipment, to open up a hard disc and read "off-centre" data off 
  3606. the platter.  The level of file recovery available to ordinary users is 
  3607. therefore nothing more sophisticated than software undeletion, using the 
  3608. standard disc read-write hardware. Overwriting the file with zeroes, as XDEL /W 
  3609. does, is sufficient to protect against data being recovered in this way. 
  3610.  
  3611.  
  3612. ΓòÉΓòÉΓòÉ 48. XDIR - Extended DIR ΓòÉΓòÉΓòÉ
  3613.  
  3614. Synopsis 
  3615.  
  3616. XDIR [/?] [/A[[-|+]drash]] [/T[acw]] [/SEUBF[-|+]] [/O[[-|+]NEDSG]] [Filespecs 
  3617. ...] 
  3618.  
  3619. Options 
  3620.  
  3621.     /?      Display command syntax information. 
  3622.  
  3623.     /A      Select files by attribute. 
  3624.  
  3625.     /E      Do not display non-fatal error messages. 
  3626.  
  3627.     /S      Recurse into subdirectories. 
  3628.  
  3629.     /U      Do not display summary information. 
  3630.  
  3631.     /B      Display "bare" filenames, without attribute, size, or date 
  3632.             information. (default:OFF) 
  3633.  
  3634.     /F      Display full filenames, rather than simply basenames. (default:ON) 
  3635.  
  3636.     /T      Specify which of the last access (/TA), last write (/TW, the 
  3637.             default), or creation times (/TC) to display. 
  3638.  
  3639.     /O      Specify a sort string that determines how the output should be 
  3640.             sorted, comprising zero or more of the following characters 
  3641.             (optionally preceded by '-' to reverse the sense): 
  3642.  
  3643.             A              Sort by name, treating digits as numbers. 
  3644.  
  3645.             D              Sort by date stamp (according to the /T option). 
  3646.  
  3647.             E              Sort by extension (the part of the name following 
  3648.                            the final full stop). 
  3649.  
  3650.             G              Sort by attribute (directories, then hidden and 
  3651.                            system files, then all other files). 
  3652.  
  3653.             N              Sort by name. 
  3654.  
  3655.             S              Sort by size. 
  3656.  
  3657.     /ISO8601 Display date and time in the standard format. 
  3658.  
  3659.  Note 
  3660.  
  3661.  The sizes of directories, i.e. the number of bytes on disc that are consumed 
  3662.  by the directories themselves, are not reported by OS/2 to applications.  OS/2 
  3663.  always returns 0 for the length and allocation size of a directory.  (This is 
  3664.  the reason that the DIR command built into the command interpreter displays 
  3665.  "<DIR>" in the length field for directories.) XDIR displays whatever size OS/2 
  3666.  reports, for both files and directories. If this behaviour of OS/2 is ever 
  3667.  fixed, XDIR will thus automatically display the correct size information for 
  3668.  directories. 
  3669.  
  3670.  Description 
  3671.  
  3672.  The XDIR command is an extended DIR command that displays information about 
  3673.  the files specified by the wildcard specifications. 
  3674.  
  3675.  Unlike the DIR command built in to CMD, the default command interpreter in 
  3676.  OS/2, XDIR supports extended wildcards, displaying the creation and last 
  3677.  access timestamps, and sorting files from multiple subdirectories. 
  3678.  
  3679.  The /O option causes files to be sorted in memory, and displayed in sorted 
  3680.  order once all files have been found.  There may thus be a delay between the 
  3681.  command being invoked and it producing any output.  If the internal sort 
  3682.  buffer overflows (if the system is low on available virtual memory), files are 
  3683.  displayed in unsorted order. 
  3684.  
  3685.  If no sort options are specified, the sort order is the order that files were 
  3686.  found.  ( There is no 'U' for "Unsorted" option.  It makes no sense to have a 
  3687.  sort option letter that specifies that there are no sort option letters!  For 
  3688.  unsorted output, simply don't use the /O option at all. ) 
  3689.  
  3690.  The 'A' sort option performs an "alphanumeric" sort by filename, whereas the 
  3691.  'N' sort option is a plain lexical sort.  When 'A' is used, sequences of 
  3692.  digits in the name are treated as numbers.  So "FILE3.TXT" will precede 
  3693.  "FILE0012.TXT" because 3 is less than 12, even though "3" is lexically greater 
  3694.  than "0012". 
  3695.  
  3696.  Examples 
  3697.  
  3698.     [c:\]xdir /tc *.{su,mo,tu,we,th,fr,sa}[0-9]
  3699.  
  3700.  will list all of the Fidonet ARCmail files in the current directory, along 
  3701.  with their creation dates. 
  3702.  
  3703.     [c:\]xdir /oa/s/e *.txt
  3704.  
  3705.  will list all of the TXT files in all subdirectories, sorting them all into 
  3706.  alphanumeric order. 
  3707.  
  3708.  
  3709. ΓòÉΓòÉΓòÉ 49. Y - Y-shaped pipe fitting ΓòÉΓòÉΓòÉ
  3710.  
  3711. Synopsis 
  3712.  
  3713. Y [/?] [/A[[-|+]drash]] [/SE[-|+]] [Filespecs ...] 
  3714.  
  3715. Options 
  3716.  
  3717.     /?      Display command syntax information. 
  3718.  
  3719.     /A      Select files by attribute. 
  3720.  
  3721.     /E      Do not display non-fatal error messages. 
  3722.  
  3723.     /S      Recurse into subdirectories. 
  3724.  
  3725.  Description 
  3726.  
  3727.  The Y command is a "Y shaped fitting" for use in command pipelines.  It can 
  3728.  also be used as a more powerful replacement for the TYPE command that is built 
  3729.  in to CMD and 4OS2. 
  3730.  
  3731.  It first copies whatever it receives from its standard intput to its standard 
  3732.  output, and then it copies to its standard output the contents of the files 
  3733.  specified by the wildcard specifications. 
  3734.  
  3735.  Unlike the TYPE command built in to CMD and 4OS2, and unlike the Y command 
  3736.  built into 4OS2, Y supports extended wildcards, recursion into subdirectories, 
  3737.  and the ability to include and exclude files from processing by their 
  3738.  attributes. 
  3739.  
  3740.  To use Y as a replacement for TYPE, simply redirect NUL to its standard input. 
  3741.  
  3742.  Examples 
  3743.  
  3744.     [c:\]saydate | y /s *.{cmd,btm}
  3745.  
  3746.  will display the output of the SAYDATE command, and then the contents of all 
  3747.  CMD and all BTM files in the current directory and all subdirectories beneath 
  3748.  it. 
  3749.  
  3750.     [c:\]y *.txt < nul
  3751.  
  3752.  will display the contents of all of the TXT files the current directory. 
  3753.  
  3754.  
  3755. ΓòÉΓòÉΓòÉ 50. Acknowledgements ΓòÉΓòÉΓòÉ
  3756.  
  3757. The following people helped with the pre-release testing of these utilities: 
  3758.  
  3759.      Andy Roberts, FIDONET#1:109/921.1 
  3760.      Jack Stein, FIDONET#1:129/171.0 
  3761.      Jack Pfisterer, FIDONET#1:102/837.0 
  3762.      George Fliger, FIDONET#1:137/2.0 
  3763.      Tony Pater, FIDONET#3:712/848.0 
  3764.      Francois Thunus, FIDONET#2:270/25.2 
  3765.      Roy J. Tellason, FIDONET#1:270/615.0 
  3766.      Sarah Nunez, FIDONET#1:130/604.0 
  3767.      Jeffrey J. Counsil, FIDONET#1:268/402.0 
  3768.      Lee Aroner, FIDONET#1:343/40.0 
  3769.      Gord Hannah, FIDONET#1:109/921.23 
  3770.      Will Honea 
  3771.      Coridon Henshaw 
  3772.      Don Woodall 
  3773.      Eddy Thilleman 
  3774.      Francois Massonneau 
  3775.      Richard Gelderblom 
  3776.      Joe Hunter 
  3777.      Kaya Imre 
  3778.      Leonard Erickson 
  3779.      Richard Gelderblom 
  3780.      Russell Tiedt 
  3781.  
  3782.  
  3783. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  3784.  
  3785. For more information about the CPUID instruction, see: 
  3786.  
  3787.      Cyrix M2 CPU Software Identification, Cyrix corporation 
  3788.  
  3789.      AMD Processor Recognition, Document Number 20734J, Advanced Micro Devices 
  3790.  
  3791.      Intel Architecture Software Developers' Manual Volume 2: Instruction Set 
  3792.       Reference, Order Number 243191, Intel corporation 
  3793.  
  3794.  
  3795. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  3796.  
  3797. Master Boot Record 
  3798.  
  3799.  
  3800. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  3801.  
  3802. [c:\].\date --version
  3803. date - GNU sh-utils 1.12
  3804.  
  3805. [c:\].\date --date=1999-12-31
  3806. Fri Dec 31 00:00:00 GMT 1999
  3807.  
  3808. [c:\].\date --date=2000-01-01
  3809. Thu Jan  1 00:00:00 GMT 1970
  3810.  
  3811. [c:\]
  3812.  
  3813.  
  3814. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  3815.  
  3816. In Presentation Manager terminology, a window's parent is the window that 
  3817. encloses it, and has nothing to do with which process actually created the 
  3818. window.