1@(#)INSTALL.VMS 6.37 04/04/02 2 3INSTRUCTIONS FOR OPENVMS 4------------------------ 5 6Please read through the following notes before attempting to install 7xmcd on the Digital/Compaq/HP OpenVMS platform. 8 9Please note that only the xmcd (X11/Motif-based) CD player is supported 10under OpenVMS. The command-line based cda utility is not supported. 11 12 13OS MINIMUM VERSIONS 14-------------------- 15 16The required minimum OpenVMS version is 6.2, recommended is 7.2 or above. 17 18- On Alpha machines equipped with an IDE/ATAPI CD drive, the minimum 19 OpenVMS version is 7.1-2. From version 7.1-2 to 7.2x with an IDE/ATAPI 20 CD drive a new SYS$DQDRIVER.EXE needs to be installed, at least the 21 following or a later release: 22 23 image name: "SYS$DQDRIVER" 24 image file identification: "X-21" 25 image file build identification: "X6N6-SSB-0000" 26 link date/time: 17-APR-2000 12:32:19.68 27 linker identification: "A11-39" 28 29 The above driver can be found on the OpenVMS Freeware CD v5.0. 30 On OpenVMS version 7.3 and later NO new SYS$DQDRIVER is needed. 31 32- On OpenVMS versions prior to 7.1-2, the wwwWarp feature of xmcd 33 will work with the old Netscape and Mosaic versions, but may not 34 display certain sites optimally. For Alpha systems, the HP SWB 35 (Hewlett Packard Secure Web Browser) is recommended, and can be 36 found at the following URL: 37 38 http://h71000.www7.hp.com/openvms/products/ips/cswb/cswb.html 39 40 41COMPILER MINIMUM VERSIONS 42-------------------------- 43 44- Prerequisite for compiling xmcd from source is that the Motif programming 45 support option has been enabled when installing DECwindows Motif. 46 47- If you are going to compile xmcd from source code, your system must have 48 the C compiler installed. This release was tested with Compaq C v6.2-007 49 and v6.4. The use of compilers older than that *may* work, but it is 50 known that the DEC C v5.6 does not work. If you have just installed 51 or upgraded the C compiler you may need to reboot the system before the 52 compiler would work. 53 54- If you are compiling on a OpenVMS 6.x system, you will need to set 55 the logical names DECC$CRTLMAP and LNK$LIBRARY to point to the C 56 library area. 57 58- If you are compiling xmcd from source, and want to do it manually without 59 having INSTALLVMS.COM (or MAKEVMS.COM) doing it on your behalf, you also 60 may use MMS. This product can be found on the Software Products Library CDs. 61 Licenses of MMS are available. Users who are a member of DECUS/Encompass, 62 the user society for DEC computers, can get a hobbyist license for MMS. 63 Check the following site for details: 64 65 http://www.montagar.com/hobbyist/show_license.html 66 67 See below for more information on using MMS to build xmcd. 68 69 70CDDA CAPABILITY 71--------------- 72 73If you want CDDA capability, these are the recommended minimum OpenVMS 74version requirements: 75 76 Alpha: OpenVMS version 7.2 77 VAX: OpenVMS version 7.3 78 79Furthermore, if you have a sound card on your system and wish to use 80the "CDDA playback" feature of xmcd, you must have the MMOV (Multi-Media 81services for OpenVMS) layered product installed. MMOV is available 82only for the Alpha platform, and only for OpenVMS version 7.1-2 or later. 83 84The product page for MMOV is at: 85 86 http://h71000.www7.hp.com/openvms/products/mmov 87 88Run-time and development licenses of MMOV are available. Users who are a 89member of DECUS/Encompass, the user society for DEC computers, can get a 90hobbyist license for MMOV. Check the following site for details: 91 92 http://www.montagar.com/hobbyist/show_license.html 93 94If you are compiling xmcd from source, and you wish to have CDDA 95playback capability via your system's sound card, then you need the MMOV 96development license (MMOV-DV). Also, during the installation of MMOV, 97answer 'no' to the question whether you want the defaults for all 98options, and then answer 'yes' to the question about whether to install 99the kit to develop multimedia applications. 100 101If you have using a pre-compiled xmcd binary kit, then you only need the 102MMOV run-time (MMOV-RT) license, and the default installation should 103suffice. 104 105If you want to be able to encode and save CD tracks to MP3 format files, 106you must install the LAME MP3 encoder software. OpenVMS ports of LAME 107(source code) can be found at this URL: 108 109 http://membres.lycos.fr/pmoreau/decw/audio.html 110 111The xmcd official web site "Downloads" area also contains links to 112other sites that offer pre-compiled binaries of LAME: 113 114 http://www.amb.org/xmcd 115 116Please see the RELNOTES file for additional information about CDDA 117support in xmcd. 118 119 120BUILDING XMCD 121------------- 122 123To build xmcd for the OpenVMS operating system you need to first unpack 124the xmcd GZIPed file, then use VMSTAR to restore the directory tree for 125xmcd. GUNZIP, and VMSTAR can be found at various locations on the 126Internet. One such location is this site: 127 128 http://www.hp.com/go/openvms/freeware 129 130After unpacking the xmcd package you have to decide whether you want to 131execute the INSTALLVMS.COM procedure or if you want to install xmcd manually. 132 133Running INSTALLVMS.COM results in a fully functional installation. 134It sets up xmcd for your system and CD drive, and compiles xmcd using 135MAKEVMS.COM. It also installs all needed xmcd support files to their 136proper locations. 137 138However, INSTALLVMS.COM neither includes advanced features like driving 139XV as an external image viewer nor does it include changing the 140configuration files as for xmcd's look. All of the latter is not necessary 141to run xmcd, but you might find that XV displays images with better quality 142than Mozilla (aka SWB, Secure Web Browser) or Netscape, and you might want 143to enable your CD drive's balance control capability (if it has it) or 144similar. The parameters describing the capabilities of your CD drive will 145be changed by the installation procedure if your model can be found in the 146xmcd configuration tables. 147 148For details on modifying xmcd's configuration files see the related 149manual installation instructions below. 150 151 152 153AUTOMATIC INSTALLATION BY INSTALLVMS.COM 154---------------------------------------- 155 156 The INSTALLVMS.COM procedure residing in the xmcd top-level directory 157 will install xmcd on OpenVMS on your behalf. 158 159 The first phase deals with compiling and linking the image. Before it 160 starts you will be prompted to answer the question whether your system 161 has TCP/IP and socket support. This is for the Gracenote CDDB(R) 162 functionality. 163 Furthermore, you may be prompted to answer some CDDA related questions 164 in case relevant components were not found on your system. 165 166 In the second phase it will prompt you to answer a few simple 167 questions as for the CD drive you want to use with xmcd and whether 168 you previously have installed a xmcd 2.x or 3.x version. Depending on 169 your system's configuration it also may ask for the directories where 170 your web browser executables reside. 171 172 If you indicated to have a xmcd 2.x version previously installed, it 173 will move your local CD database files to the xmcd 3.3.x environment. 174 Therefore you will also be asked whether you are satisfied with the 175 backup of your disks. Before the files are moved, you will be prompted 176 to specify the xmcd 2.x version's top-level directory. If Local 177 Discography files are found, they also will be copied to your xmcd 3.3.x 178 environment and then converted to a new format. 179 180 If you indicated to have a xmcd 3.x version previously installed, it 181 will move existing local CD database files to the current xmcd 182 environment. Therefore you will also be asked whether you are 183 satisfied with the backup of your disks. Before the files are moved, 184 you will be prompted to specify the xmcd 3.x version's top-level 185 directory. If Local Discography files are found, they also will be 186 copied to your current xmcd environment. 187 188 When the installation procedure is finished, you need to restart your 189 login session to have all the changes take effect. After logging in 190 again you can use the foreign command XMCD to start the application 191 from the command line. 192 193 It is strongly recommended to make use of INSTALLVMS.COM instead of 194 installing xmcd manually. Advanced features like driving XV as an 195 external image viewer may be added manually afterwards. 196 197 198MANUAL INSTALLATION 199------------------- 200 201 "To those who like it the hard way, we salute you". 202 203 You must first compile and link xmcd, then copy all the necessary 204 support files to their proper locations. 205 206 207 If you have MMOV (Multi-Media services for OpenVMS) installed on your 208 system, the xmcd source code compilation needs the logical name definition 209 210 $ DEFINE/SYSTEM/EXEC/NOLOG MME MMOV$INCLUDE 211 212 in order to find the MMOV development C header files. Make sure this 213 definition is present or add it to SYS$STARTUP:MMOV$STARTUP.COM and 214 restart the server (using the MMOV startup and shutdown procedures 215 in SYS$STARTUP:). 216 217 During compilation, if you encounter a conflict between the standard 218 <time.h> header file and the one found in the MMOV$INCLUDE directory, 219 you can safely copy the one from the DEC C library area to the 220 MMOV$INCLUDE directory. 221 222 223 There are two ways to compile xmcd (if you do not wish to have the 224 following done by INSTALLVMS.COM): 225 226 1. For systems with MMS ("make" for OpenVMS): 227 228 You may use MMS to compile xmcd. 229 230 Just type "MMS" while in the top level directory of the xmcd source 231 code, and it will use the DESCRIP.MMS files to build xmcd. You may 232 need to make some changes to some second-level DESCRIP.MMS files in 233 order to get a successful compilation: 234 235 The supplied DESCRIP.MMS file in the [.CDDA_D] directory assumes 236 that your system has POSIX threads capability. If you are 237 compiling on an OpenVMS version older than 7.1, please replace 238 the "has_pthreads" with "no_pthreads" in the /def= line 239 in the [.CDDA_D]DESCRIP.MMS file. Also, remove the 240 "/def=(_POSIX_C_SOURCE,use_pthread_delay_np)" definition from 241 the [.COMMON_D]DESCRIP.MMS file. CDDA functionality will be 242 disabled with this setting. 243 244 If your system does not have the MMOV development kit installed, 245 you must disable CDDA playback soundcard support by removing the 246 "has_mme" from the /def= line in the [.CDDA_D]DESCRIP.MMS file. 247 248 If your system does not have TCP/IP and socket support, you should 249 disable the remote CDDB capability. To do so, add "/def=noremote" 250 to the DESCRIP.MMS files under the [.CDDB_D] and [.XMCD_D] 251 directories. 252 253 2. For systems without MMS: 254 255 If your system does not have MMS, you may use the MAKEVMS.COM 256 command procedure instead. Just execute this file, and the xmcd 257 build will be initiated. The MAKEVMS.COM file was generated 258 from the DESCRIP.MMS files, with the command "MMS MAKEVMS". 259 You may need to make some changes to the MAKEVMS.COM file 260 in order to get a successful compilation: 261 262 The supplied top level MAKEVMS.COM file assumes that your system 263 has POSIX threads capability. If you are compiling on an OpenVMS 264 version older than 7.1, please replace all occurrances of 265 "has_pthreads" with "no_pthreads" in the /def= lines of this 266 file. Also, remove all /def=(_POSIX_C_SOURCE,use_pthread_delay_np) 267 definitions in the same file. CDDA functionality will be disabled 268 with this setting. 269 270 If your system does not have the MMOV development kit installed, 271 you must disable CDDA playback soundcard support by removing all 272 occurrances of "has_mme" from the /def= lines in the top level 273 MAKEVMS.COM file. 274 275 If your system does not have TCP/IP and socket support, you should 276 disable the remote CDDB capability. To do so, edit the top level 277 MAKEVMS.COM file, and add "/def=(noremote)" to the lines (related 278 to source code files in the [.CDDB_D] and [.XMCD_D] directories). 279 280 The executable binary that results is XMCD.EXE and can found in the 281 [.XMCD_D] directory. XMCD.EXE needs to be copied to the xmcd library 282 area. Also, a foreign command to run the program needs to be set up 283 manually. See below for further details. 284 285 286INSTALLING AND CONFIGURING XMCD 287------------------------------- 288 289 This section is for users who are using the "MANUAL INSTALLATION" 290 method described above. If you use the "AUTOMATIC INSTALLATION 291 BY INSTALLVMS.COM" method, all the following is performed for you 292 automatically. 293 294 1. Create an XMCD Library: 295 296 You need to set up an xmcd library directory which contains 297 COMMON.CFG and DEVICE.CFG, the help and documentation files, 298 the CD database and Local Discography areas. 299 300 Example: 301 302 $ CREATE/DIRECTORY SYS$SYSDEVICE:[XMCD] 303 304 You can use a different directory than SYS$SYSDEVICE:[XMCD] 305 if you wish. Substitute all occurrences of SYS$SYSDEVICE:[XMCD] 306 in the examples below with the actual directory you use. Be sure 307 this directory is world-readable and the files in there are 308 world-readable and executable. 309 Of course you also may use the directory created by VMSTAR as the 310 xmcd library directory. 311 312 2. Setting up the config file: 313 314 In the LIBDI_D area there are two configuration files COMMON.CFG, 315 and DEVICE.CFG. The COMMON.CFG file contains general parameters, 316 whereas DEVICE.CFG defines device-specific parameters. 317 318 In the COMMON.CFG file there are a number of defaults, you must 319 change the line that specifies the name of the CD device you plan 320 to use. The default looks like this: 321 322 device: /dev/rcd0 323 324 Change this to the name of the CD device you are going to use. 325 For example: 326 327 device: DKA500: 328 329 You may need to change some of the parameters in the DEVICE.CFG 330 file depending upon the specific model of CD-ROM you have. 331 In particular, if you wish to use the CDDA features, set the 332 cddaMethod: 333 334 cddaMethod: 2 335 cddaReadMethod: 1 336 cddaWriteMethod: 7 337 338 Copy both the COMMON.CFG and DEVICE.CFG files (with the 339 change to the device name) to the xmcd library directory 340 (created in step 1 above). 341 342 You may make use of SELDRIVE.COM which is provided in the 343 [.MISC_D] subdirectory, for modifying DEVICE.CFG 344 Both of the files need to reside in your xmcd top level directory, 345 so copy SELDRIVE.COM over to the xmcd library directory 346 (created in step 1 above). 347 348 Making use of SELDRIVE.COM will result in all of your CD drive's 349 capabilities being enabled for use with xmcd. 350 You may run this procedure at any time you see a necessity for it 351 (f.i. when your drive was replaced with a different model). 352 353 If xmcd is to be used on a cluster, a node-specific version of 354 these files may be created in the same place by adding -NODENAME 355 to the file names (e.g., COMMON.CFG-SNOOPY and DEVICE.CFG-SNOOPY). 356 These node-specific configuration files will take precedence over 357 the generic ones. 358 359 Each user on their stand-alone system can also customize the xmcd 360 default CD-ROM device and xmcd behavior by creating a subdirectory 361 named XMCDCFG.DIR off their top level user directory, and then 362 putting a copy of the COMMON.CFG and DEVICE.CFG files there. 363 364 Example: 365 366 $ CREATE/DIRECTORY DISK1$:[RJONES.XMCDCFG] 367 368 If a user wishes to override any parameters in the COMMON.CFG and 369 DEVICE.CFG files then they can edit their local copy and make the 370 needed changes. Note that some parameters are considered 371 "privileged" and will be ignored by xmcd in the local version of 372 these files. See the comments in the files for details. 373 374 3. Setting up the help file area: 375 376 The help files need to be in a subdirectory of the xmcd library 377 called HELP.DIR. The help files themselves come from the xmcd tar 378 file from the subdirectories under HLPFILES.DIR in the XMCD_D area. 379 380 Create the HELP area in the xmcd library: 381 382 $ CREATE/DIRECTORY SYS$SYSDEVICE:[XMCD.HELP] 383 384 Then, move the helpfiles to the help area: 385 386 $ RENAME SYS$SYSDEVICE:[XMCD.XMCD_D.HLPFILES]*.* - 387 SYS$SYSDEVICE:[XMCD.HELP] 388 389 Help under xmcd is context sensitive. Click the right mouse button 390 over any xmcd button, control, display, list or text field area, 391 and a help window will appear with related help information. 392 393 4. Setting up the documentation file area: 394 395 The documentation files need to be in a subdirectory of the xmcd 396 library called DOCS.DIR. The documentation files themselves come 397 from the xmcd tar file from the directory under the DOCS_D area. 398 399 Move the xmcd documentation files from the source code area to the 400 library area: 401 402 $ RENAME SYS$SYSDEVICE:[XMCD]DOCS_D.DIR SYS$SYSDEVICE:[XMCD]DOCS.DIR 403 404 You can browse these documentation files using the xmcd help system. 405 406 5. Installing the xmcd X resource file: 407 408 There is a X resources file called XMCD.AD in the XMCD_D area. 409 This holds the definitions for window colors, fonts, messages, 410 labels, and other customizable items. Xmcd must be able to find 411 this file in order to run. To allow xmcd to use this file copy 412 the XMCD.AD file to DECW$SYSTEM_DEFAULTS:XMCD.DAT for system-wide 413 or cluster-wide use. 414 415 You need to make this file world-readable. 416 417 $ SET FILE/PROT=W:RE DECW$SYSTEM_DEFAULTS:XMCD.DAT 418 419 You may also create a DECW$USER_DEFAULTS:XMCD.DAT file which may 420 contain personal settings which are different from those in 421 DECW$SYSTEM_DEFAULTS:XMCD.DAT. For example, 422 define DECW$USER_DEFAULTS to point to your login directory: 423 424 $ define DECW$USER_DEFAULTS SYS$LOGIN: 425 426 Then copy XMCD.AD to DECW$USER_DEFAULTS:XMCD.DAT and apply your 427 personal settings there. You only need to put in there the 428 parameters that differ from the defaults in the 429 DECW$SYSTEM_DEFAULTS:XMCD.DAT file. If you don't copy XMCD.DAT 430 to the DECW$SYSTEM_DEFAULTS: area then remember to define the 431 logical DECW$USER_DEFAULT in your LOGIN.COM file so that it gets 432 defined each time you log in. 433 434 6. Pointing to the xmcd library: 435 436 Your xmcd library directory should now be complete: 437 438 $ DIR SYS$SYSDEVICE:[XMCD] 439 440 Directory SYS$SYSDEVICE:[XMCD] 441 442 COMMON.CFG;1 443 DEVICE.CFG;1 444 DOCS.DIR;1 445 HELP.DIR;1 446 447 You need to set up xmcd such that it can find the library directory. 448 This is done via the XMCD_LIBDIR definition: 449 450 $ DEFINE/SYSTEM XMCD_LIBDIR "SYS$SYSDEVICE:[XMCD" 451 452 Note that the right bracket is missing. This is intentional. 453 The program will concatenate the directory names to form a path 454 name for library subdirectories. You should put this in the 455 the system startup procedure (SYS$MANAGER:SYSTARTUP_VMS.COM). If 456 that is not possible, you can put it (without the /SYSTEM qualifier) 457 in your personal LOGIN.COM so that it is done automatically each time 458 you log in. 459 460 7. Set up CD information directory (optional): 461 462 If you have xmcd version 2.x previously installed on your system, 463 there is a CDDB.DIR directory under your xmcd library. This has 464 been deprecated, but this release of xmcd will continue to read 465 files from that directory, if you rename it to be CDINFO.DIR. 466 CDINFO.DIR has to be resident in this release's top level directory. 467 468 If you have xmcd version 3.x previously installed on your system, 469 there may be a CDINFO.DIR directory tree in your xmcd 3.x library. 470 If there is, copy or rename the CDINFO.DIR directory tree to 471 your current xmcd 3.3.x library. 472 473 8. Set up xmcd to drive a web browser (optional): 474 475 Copy the INSTWEB.COM command file from the MISC_D area and the 476 WWWWARP.CFG configuration file from the CDINFO_D area to the 477 xmcd library directory. You may then execute INSTWEB.COM in that 478 directory. This will ask you a number of questions and then 479 install wwwWarp support for xmcd. 480 481 If you wish to add wwwWarp support manually (i.e., not using the 482 INSTWEB.COM command), follow the instructions below. 483 484 - Make sure you have 485 486 either a copy of NETSCAPE.EXE and/or MOSAIC.EXE in 487 SYS$SYSTEM: (e.g., SYS$SYSDEVICE:[SYS0.SYSEXE]) 488 489 or a working MOZILLA installation (usually found in 490 SYS$COMMON:[MOZILLA], required is MOZILLA.COM) 491 492 or a working SWB (HP Secure Web Browser) installation, which 493 usually is found in SYS$COMMON:[CSWB], required is also 494 MOZILLA.COM 495 496 - Check whether you have the CMKRNL (Change Mode Kernel) privilege. 497 This is essential, because GOBROWSER.COM needs to make use of 498 ANALYZE/SYSTEM which requires this privilege. 499 500 - Edit the WWWWARP.CFG file and locate the "Xmcd man page" and 501 "Xmcd Local Discography" entries. Change them to look like 502 the following: 503 504 "Xmcd man page" Alt-m f.goto \ 505 "%L.DISCOG]XMCD.HTML" 506 "Xmcd Local Discography" Shift-L f.goto \ 507 "%L.DISCOG.%C.%I]INDEX.HTML" 508 509 510 - Copy the GOBROWSER.COM and GENIDX.COM command procedure files to 511 xmcd's library directory. These files are found in the MISC_D 512 area. 513 514 - Modify your LOGIN.COM to add following lines: 515 516 $ IF F$MODE() .NES. "OTHER" THEN DEFINE/GROUP XMCD_BROWSER MOZILLA 517 $ GOBROWSER :== @disk:[dir]GOBROWSER.COM 518 $ GENIDX :== @disk:[dir]GENIDX.COM 519 520 First line: If you prefer MOZILLA or SWB as your default browser, 521 just insert this line into your LOGIN.COM. 522 If you prefer Netscape, exchange MOZILLA with 523 NETSCAPE in this line. If you prefer MOSAIC, 524 exchange MOZILLA with MOSAIC in this line. Of 525 course you need to have the Mosaic and/or 526 Netscape executable and/or the MOZILLA (or SWB) 527 installation (see below). 528 529 Second line: 'disk:[dir]' is meant to be xmcd's library directory. 530 Third line: 'disk:[dir]' is meant to be xmcd's library directory. 531 532 Restart your login session, or execute the above commands manually 533 so that they can take effect. 534 535 536 Now you are done and should be able to use xmcd's wwwWarp features. 537 538 One more hint if you have the GRPPRV privilege: 539 ----------------------------------------------- 540 541 If you have Mozilla (or SWB) and/or Mosaic and/or Netscape 542 handy, you can change the browser for xmcd on the fly: 543 544 - Go to a text window where you can enter DCL commands. 545 - Enter 546 DEFINE/GROUP XMCD_BROWSER 'mybrowser' 547 548 Where 'mybrowser' is MOZILLA or NETSCAPE or MOSAIC 549 550 - Go to xmcd's wwwWarp window and select a site - now the designated 551 browser will pop up. 552 553 This means you can use all browsers simultaneously or override the 554 default specified in your LOGIN.COM prior to starting xmcd. You 555 can also go to a text window, change the browser as described above 556 and then start an alternate browser by simply clicking on some site 557 in xmcd's wwwWarp window. 558 559 9. Setting up the Local Discographies area (optional): 560 561 The Local Discographies area is for storing files pertaining to your 562 CD collection. These files can be documents, images, sound files, 563 etc., that are associated with each CD. You may deposit these files 564 under the SYS$SYSDEVICE:[XMCD.DISCOG.%C.%I] directory (where %C is 565 the CDDB genre/subgenre names and %I is the xmcd 8-digit disc ID), 566 and then use xmcd's wwwWarp feature to view or play these files. 567 A plug-in for the browser may be required for some file types. 568 569 This is used only if you enable wwwWarp support (see "Setting up 570 xmcd to drive a web browser" above). 571 572 To set this up, follow these steps: 573 574 - Create the main Local Discographies area and all the music category 575 areas under it: 576 577 $ CRE/DIR SYS$SYSDEVICE:[XMCD.DISCOG] 578 $ GENIDX 579 580 - Copy the DISCOGVMS.HTM, BKGND.GIF and XMCDLOGO.GIF files in the 581 MISC_D area to the SYS$SYSDEVICE:[XMCD.DISCOG] area. Rename the 582 DISCOGVMS.HTM to DISCOG.HTML at the destination location. Also 583 copy the XMCD.HTM file under XMCD_D to the 584 SYS$SYSDEVICE:[XMCD.DISCOG] area and rename it to XMCD.HTML. 585 586 - If you already have a xmcd 2.x Local Discography area with 587 CD-related INDEX.HTML files, you may back up these files to the 588 structure created by GENIDX. Please note the differences in 589 subdirectory names between xmcd 2.x and 3.x. Also be aware that 590 the HTML links in these INDEX.HTML files partially won't work 591 any longer. The automatic installation done by INSTALLVMS.COM 592 fixes this problem. 593 594 - If you already have a xmcd 3.x Local Discography area with 595 CD-related INDEX.HTML files, you may back up these files to 596 reside in the same subdirectory structure in your new xmcd 597 library. 598 599 - To enable browsing your local discography directories you need 600 to define the logical $DISCOGDIR by adding the following line 601 to your personal LOGIN.COM (in an appropriate place after the 602 lines containing the XMCD_BROWSER definition): 603 604 $ DEFINE/JOB $DISCOGDIR DKA0:[XMCD.DISCOG.] - 605 /TRANSLATION_ATTRIBUTES=(TERMINAL,CONCEALED) 606 607 Please consider that you will need to modify the device name 608 and the top-level directory name of the above example to be 609 functional with your installation. 610 611 - If you prefer to only display images (e.g. CD covers) stored in 612 your Local Discographies area you may add the following line 613 to your personal LOGIN.COM (in an appropriate place next to the 614 line containing the XMCD_BROWSER definition): 615 616 $ IF F$MODE() .NES. "OTHER" THEN DEFINE/GROUP XMCD_VIEWER XV 617 618 If you add this line to your LOGIN.COM, only local images as 619 defined in STARTVIEWER.COM will be displayed by XV. 620 If you do not add this line to your personal LOGIN.COM xmcd 621 always will use the browser of your choice for displaying images 622 (like it does anyway with other non-local URLs). 623 624 One more hint if you have the GRPPRV privilege: 625 ----------------------------------------------- 626 627 If you have Mosaic and/or Netscape and/or Mozilla/SWB and XV handy 628 and if you make use of XV for only displaying images, you can 629 change the viewer for xmcd on the fly: 630 631 - Go to a text window where you can enter DCL commands. 632 - Enter 633 DEFINE/GROUP XMCD_VIEWER 'myviewer' 634 635 Where 'myviewer' is either NETSCAPE or MOSAIC or MOZILLA/SWB or XV 636 637 - Go to xmcd's wwwWarp window and select a site - now the 638 designated browser will pop up. If you select "Local Discograhy" 639 the designated viewer will pop up. 640 641 This means you can use all browsers/viewers simultaneously or 642 override the defaults specified in your LOGIN.COM prior to 643 starting xmcd. You can also go to a text window, change the 644 browser or viewer as described above and then start an alternate 645 browser or viewer by simply clicking on some site or item in 646 xmcd's wwwWarp menu. 647 648 The possibility to have XV display GIFs or JPEGs was added because 649 the viewing quality is better with XV than with the web browsers. 650 Furthermore the picture's size is preselectable when using XV 651 (see STARTVIEWER.COM) and it won't take half your screen to view 652 an image (f.i. a scanned CD cover). 653 654 655RUNNING XMCD 656------------ 657 658You need to have the DIAGNOSE, PHY_IO and SYSNAM privileges in order to 659run xmcd. 660 661 $ SET PROCESS/PRIVILEGES=(DIAGNOSE,PHY_IO,SYSNAM) 662 663You can just enter $ RUN XMCD or use the XMCD foreign command at the 664DCL prompt to start xmcd. 665 666Xmcd will work only with locally-attached CD drives. It will not work 667on remote drives in a clustered environment. 668 669If you like to add xmcd to your Session Manager Application pull down 670menu do the following: 671 6721) Pull the Options Menu down in the Session Manager window, and 673 select the Menus... option. 674 6752) Select the Item Name text box. The Item Name text box is just 676 above where it says "DCL Command" and just left of "Options Qualifiers". 677 Add the name that you want to give to this application. For example 678 CDPlayer. 679 6803) Select the DCL Command text box, and add a suitable command according 681 to this example: 682 683 $SYS$SYSDEVICE:[XMCD]XMCD.EXE 684 6854) Select the Up arrow button (just to the right of "Options Qualifiers") 686 687 The application name is now in the Item Names Menu, and it should be 688 highlighted. 689 6905) To the left of the Item Names menu there is a left arrow button. 691 Select this button and the application will be displayed in the 692 Applications Menu. 693 6946) Choose the Apply button then the Cancel button. 695 6967) Then in the Options Menu in the Session Manager window choose 697 Save Session Manager. 698 699If CDDA playback is selected but MMOV isn't installed or the server isn't 700running, the application terminates with "Multimedia server not running". 701 702The server's quota are usually sufficient. Any sound problem experienced 703so far doesn't seem to be related to the sound server. However, the 704sound server's resources (a.k.a. quotas) depend on OpenVMS parameters and 705may be different on your system. If a $ set verify is placed in front of 706the "run/detach" command in the script the used quota are displayed. 707Here's an example run: 708 709 $ run/detached/nodeb sys$system:mmov$server.exe - 710 /ast_limit=152 - 711 /input=_opa0: /output=sys$startup:mmov_server.log - 712 /error=sys$manager:mmov_error.log - 713 /io_buffered=32 - 714 /io_direct=32 - 715 /maximum_working_set=65536 - 716 /privileges=all - 717 /uic=[1,4] /trusted - 718 /queue_limit=16 - 719 /process_name="MMOV$SERVER" 720 721If MMOV is installed and the server is not running, you may try to start 722the server using the above command. Do not issue this command if the 723server is already running. Note that it is recommended to start or stop 724the MMOV server using the related procedures in SYS$STARTUP. 725 726For "CDDA write to file" operations, it is recommended to set a useful 727extension size and RMS buffers for the process. For example: 728 729 $ SET RMS/EXTEND=1000/BUFFER=128/SEQ 730 731Otherwise it will be slow. 732 733If you want "CDDA write to file" to output in MP3 format, you must install 734the OpenVMS port of the LAME encoder software. The LAME_PATH must be set 735as logical or DCL environment variable. For example: 736 737 $ LAME_PATH:="SYS$SYSDEVICE:[MYLOGINNAME.LAME_3_70]LAME.EXE" 738 739In case you run the INSTALLVMS.COM procedure, this is done automatically 740if the procedure found the LAME encoder to be present on your system or if 741you entered its location when the procedure prompted you for it. 742 743The performance of CDDA ripping to MP3 is very slow on the VAX 744architecture. If you are running on VAX, you will most likely need 745to increase the CDDA heartbeat timeout interval. To do this, open 746the xmcd options window by clicking on the tools symbol button, select 747the "CDDA scheduling" category, set the Heartbeat timeout value to a 748much larger value, then click "Save". 40 seconds should work even 749with the slowest models. 750 751For additional CDDA-related notes please refer to the RELNOTES file. 752 753As of this writing LAME versions 3.70 and 3.93.1 have been ported to 754OpenVMS. When running with version 3.70, the VBR-1 and VBR-2 MP3 encoding 755methods are identical. The ABR mode is not supported and falls back to 756CBR mode, and the "Algorithm tuning" control has no effect. 757 758 759SPECIAL IDE/ATAPI DRIVE NOTES 760----------------------------- 761 762If you encounter error messages while attempting to play a CD and 763the time display does not advance, change the setting of the curposFormat 764parameter in your DEVICE.CFG file. 765 766If you encounter errors while using xmcd's volume or balance sliders, 767or the channel routing control buttons, try changing the modeSenseUse10Bytes 768and/or the modeSenseSetDBD parameters in your DEVICE.CFG file. If none 769of these resolves the problem, then the drive probably does not support 770these features. Change the following parameters to False in your 771DEVICE.CFG file to disable the controls in xmcd: 772 773 volumeControlSupport 774 balanceControlSupport 775 channelRouteSupport 776 777If you made any changes to the DEVICE.CFG file as described above, 778restart xmcd to have them take effect. 779 780 781