home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / mac / hypercrd / xcmd / mntnmntx.bin / mountunmountxcmd106.bin / card_3023.txt < prev    next >
Text File  |  1989-06-06  |  5KB  |  131 lines

  1. -- card: 3023 from stack: in.bin
  2. -- bmap block id: 0
  3. -- flags: 0000
  4. -- background id: 2805
  5. -- name: 
  6.  
  7.  
  8. -- part 1 (button)
  9. -- low flags: 00
  10. -- high flags: A003
  11. -- rect: left=289 top=285 right=313 bottom=475
  12. -- title width / last selected line: 0
  13. -- icon id / first selected line: 0 / 0
  14. -- text alignment: 1
  15. -- font id: 0
  16. -- text size: 12
  17. -- style flags: 0
  18. -- line height: 16
  19. -- part name: Show version
  20. ----- HyperTalk script -----
  21. on mouseUp
  22.   Mount -- no arguments means "return a version string" in 'the result'
  23.   put the result into msg
  24. end mouseUp
  25.  
  26.  
  27.  
  28. -- part 2 (button)
  29. -- low flags: 00
  30. -- high flags: 0004
  31. -- rect: left=12 top=281 right=315 bottom=51
  32. -- title width / last selected line: 0
  33. -- icon id / first selected line: 20098 / 20098
  34. -- text alignment: 1
  35. -- font id: 0
  36. -- text size: 12
  37. -- style flags: 0
  38. -- line height: 16
  39. -- part name: Home
  40. ----- HyperTalk script -----
  41. on mouseUp
  42.   visual effect iris close
  43.   go "Home"
  44. end mouseUp
  45.  
  46.  
  47.  
  48. -- part 6 (field)
  49. -- low flags: 00
  50. -- high flags: 0007
  51. -- rect: left=9 top=30 right=276 bottom=484
  52. -- title width / last selected line: 0
  53. -- icon id / first selected line: 0 / 0
  54. -- text alignment: 0
  55. -- font id: 20
  56. -- text size: 12
  57. -- style flags: 0
  58. -- line height: 16
  59. -- part name: 
  60.  
  61.  
  62. -- part 7 (button)
  63. -- low flags: 00
  64. -- high flags: A003
  65. -- rect: left=77 top=285 right=313 bottom=175
  66. -- title width / last selected line: 0
  67. -- icon id / first selected line: 0 / 0
  68. -- text alignment: 1
  69. -- font id: 0
  70. -- text size: 12
  71. -- style flags: 0
  72. -- line height: 16
  73. -- part name: Try it out╔
  74. ----- HyperTalk script -----
  75. on mouseUp
  76.   go to next card
  77. end mouseUp
  78.  
  79.  
  80.  
  81. -- part contents for card part 6
  82. ----- text -----
  83. Mount and Unmount XCMDs Version 1.06
  84. October 5, 1988
  85.  
  86. This stack contains two XCMDs that allow you to mount and unmount AppleShare volumes.  The commands are called "Mount" and "Unmount" respectively.
  87.  
  88. SETTING UP
  89. As usual, use ResEdit or Rez to move these XCMDs to your own stacks.  MOUNT requires the 'STR' -1902 resource to run correctly; be sure to drag it along with the XCMD, and don't renumber it.
  90.  
  91.  
  92. MOUNT
  93. Mount requires three to six arguments:
  94.  
  95.     Mount "zone", "server", "volume" [, "username" [, "password" [, "volume password"]]]
  96.  
  97. The first three arguments are required, and should be obvious to anyone who's used the Chooser.  If the zone name is empty, Mount uses your current zone.
  98.  
  99. The username can be empty, for guest access to a server where you might not have an account.
  100.  
  101. If you have a password, it must be specified in clear text as the fifth argument.  Just as in the Chooser, you must type the password in EXACTLY right; in particular, uppercase and lowercase are distinct.
  102.  
  103. There is currently no secure way to specify a password, and you should be damn careful about NOT distributing scripts that have passwords embedded in them. As usual, make sure no one is looking over your shoulder when you type your passwords in.  You do that already, don't you?
  104.  
  105. If your server administrator has given the volume its own password, you need to specify that as the sixth argument, and the same paranoia applies.
  106.  
  107. Since Mount is an XCMD, results are returned in 'the result'.  An empty result indicates success; anything non-empty is an error.  The error messages are self explanatory text (in english in this version), suitable for framing or placing in an alert box.
  108.  
  109. If you don't supply ANY arguments, Mount responds with a version string, as the "Show version" button below demonstrates.
  110.  
  111.  
  112. UNMOUNT
  113. The XCMD "Unmount" requires exactly one argument, the name of the volume to unmount.  You can supply a colon on the end of the volume name, or not, as you like.  Unmount returns its status in 'the result'; an empty result implies success, anything non-empty is an error message.
  114.  
  115.  
  116. WE KNOW, WE KNOWΓǪ
  117. Clearly there is a need for more commands to do NBP lookups to find servers, to find volumes on servers, to list currently mounted volumes, to list and pick LaserWriters, and so forth.
  118.  
  119.  
  120. MISCELLANEA
  121. These XCMDs do not use call-back to Hypercard.  If you follow the Hypercard calling conventions you can use the XCMDs from any application, since you don't need Hypercard around for the XCMDs to run successfully.
  122.  
  123.  
  124. CREDITS
  125. These XCMDs were written by Landon Dyer, of the Apple Development Systems Group, with help from Gene Tyacke, of the Networking and Communications Group.  The networking people helped find some awesome initial bugs.
  126.  
  127. Send bugs and comments to Landon Dyer, x4582, Mailstop 27E, or
  128.          AppleLink:   DYER4
  129. or      usenet:         apple!landon
  130.  
  131.