=:The OpenVMS Frequently Asked Questions(FAQ)C

The OpenVMS Frequently Asked Questions(FAQ)



 r \ ^  
PreviousContentsIndex

h

5.13 How do I change the volume label of a disk?



EDismount the disk, and mount it privately. If the disk is mounted by Emore than one node in an OpenVMS Cluster, dismount it from all other Cnodes. If this disk is an OpenVMS system disk, shut down all other +nodes that are bootstrapped from this disk.

=Issue the SET VOLUME/LABEL command, specifying the new label.

EOn OpenVMS V6.0 and later, issue the following PCSI command to reset Ethe label information stored within the PCSI database to reflect the new disk volume label:

 

"
+$ PRODUCT REGISTER VOLUME old-label device 




ELocate any references in the system startup (typically including the Bdisk MOUNT commands) and any DISK$label references in application /files, and change the references appropriately.

GIf this is a system disk (for the host or for a satellite), also check Hthe DECnet MOP or LANCP boot database, as well as any references to the $disk created by CLUSTER_CONFIG*.COM.

EIf Compaq Analyze is in use, check the system startup procedures for Hthe Compaq Analyze tool. Certain versions of Compaq Analyze will record :specific disk volume labels within the startup procedures.

Remount the disk appropriately.a

5.14 How can I set up a shared directory?



HTo set up a shared directory---where all files created in the directory Hare accessible to the members of specified group of users---you can use /an access control list (ACL) and an identifier.

DThe following also shows how to set up a resource identifier, which Afurther allows the disk resources to be charged to the specified Fidentifier rather than each individual user. (If you don't want this, Hthen omit the attributes option on the identifier creation and omit the 'entry added in the disk quota database.

.Add an identifier using the AUTHORIZE utility:

 

"
2ADD/IDENTIFER/ATTRIBUTES=RESOURCE groupidentifier 




?Grant the identifier to each user in the group using AUTHORIZE:

 

"
*GRANT/IDENTIFIER groupidentifier username 




AIf disk quotas are in use, add an entry via SYSMAN for each disk:

 

"
EDISKQUOTA ADD groupidentifier/PERMQUOTA=pq/OVERDRAFT=od/DEVICE=ddcu: 




GSet the shared directory to have an ACL similar to the following using Fthe SET SECURITY (V6.0 and later) or SET ACL (versions prior to V6.0) command:

 

"
'(DEFAULT_PROTECTION,S:RWED,O:RWED,G,W) N(IDENTIFIER=groupidentifier,OPTIONS=DEFAULT,ACCESS=READ+WRITE+EXECUTE+DELETE) >(IDENTIFIER=groupidentifier,ACCESS=READ+WRITE+EXECUTE+DELETE) *(CREATOR,ACCESS=READ+WRITE+ACCESS+DELETE) 




@If there are files already resident in the directory, set their Eprotections similarly. (The OPTIONS=DEFAULT, DEFAULT_PROTECTION, and #CREATOR ACEs apply to directories.)

BThe default protection mask is used to establish the default file Bprotection mask, this mask does not prevent the users holding the Bspecified groupidentifier from accessing the file(s), as they can Daccess the file via the explicit identifier granting access that is present in the ACL.

FFor further information, see the OpenVMS Guide to System Security DManual, specifically the sections on ACLs and identifiers, and resource identifiers.m

5.15 Why do I get extra blank pages on my HP Printer?



HFor information on configuring telnet print symbiont, on device control Hlibraries such as SYSDEVCTL.TLB, and for ways of dealing with the extra Bblank pages that can arise on various HP printers, please see the EOpenVMS Ask The Wizard area, starting particularly with topic (1020):



HFor additional information on the OpenVMS Ask The Wizard (ATW) area and Bfor a pointer to the available ATW Wizard.zip archive, please see 0Section 3.9.

CThere are a variety of discussions of this and of related printing ?topics in the Ask The Wizard area, in addition to topic (1020).

;Also see Section 5.34.s

5.16 Drivers and Configuration of New Graphics Controllers?



BThis section contains information on various graphics controllers Fsupported by OpenVMS Alpha, and specifically information on where and Dhow to obtain device drivers for specific early OpenVMS releases--- Ddevice drivers for controllers are integrated into and shipped with GOpenVMS Alpha, but versions of these device drivers are sometimes made 0available for specific earlier OpenVMS releases.:

5.16.1 The ELSA GLoria Synergy



COn OpenVMS Alpha V7.1-2, V7.2, and V7.2-1, acquire the appropriate 9GRAPHICS PCSI kit, and all prerequisite OpenVMS ECO kits:



>The ELSA GLoria Synergy is the PBXGK-BB; the PowerStorm 3D10T.@Please ensure you have the most current ECOs for this and other Bgraphics controllers installed; check for and install the current lGRAPHICS kit. (See Section 4.2.2 for some unexpectedly related details.)

?On OpenVMS Alpha V7.2-1, the files necessary for this graphics <controller are located in the distribution CD-ROM directory:

 

"
DISK$ALPHA0721:[ELSA.KIT] 




.Also check for any available (later) ECO kits.

GAn earlier kit (ALP4D20T01_071) (for V7.1, V7.1-1H1, and V7.1-1H2) was Gonce available, but has been superceded and is not recommended. Use of HV7.1-2 or later (and use of one the above GRAPHICS kits as required) is typically the best approach.

@OpenVMS V7.2-2 and later mainline releases directly support the controller.

GAdditional information is available in topics (3419) and (5448) in the Ask The Wizard area:



HFor additional information on the OpenVMS Ask The Wizard (ATW) area and Bfor a pointer to the available ATW Wizard.zip archive, please see 0Section 3.9.

CSupport for the ELSA GLoria Synergy is integrated into all current OpenVMS Alpha releases.J

5.16.2 PowerStorm 300, PowerStorm 350



DThe PowerStorm 300 is the PBXGD-AC, while the PowerStorm 350 is the PBXGD-AE.

>For support of the PowerStorm 300 and PowerStorm 350 graphics Bcontrollers, acquire and install the following available ECO kits:

For OpenVMS Alpha V7.1-2:



For OpenVMS Alpha V7.2-1:



BSupport for the PowerStorm 300 and PowerStorm 350 series graphics >controllers is integrated into current OpenVMS Alpha releases.M

5.16.3 PowerStorm 3D30, PowerStorm 4D20



6PowerStorm 3D30 (PBXGB-AA), PowerStorm 4D20 (PBXGB-CA)Binformation is available in Ask The Wizard topics including topic (2041):



HFor additional information on the OpenVMS Ask The Wizard (ATW) area and Bfor a pointer to the available ATW Wizard.zip archive, please see 0Section 3.9.4

5.16.4 Radeon 7500



HInstall the current GRAPHICS ECO kit for OpenVMS Alpha V7.2-2 or V7.3-1 for support of the Radeon 7500(series PCI and AGP graphics controllers.

ESupport for this controller (without an ECO kit) is first integrated Finto and available in OpenVMS Alpha V7.3-2. (Please do always install Fthe most current GRAPHICS ECO kit whenever one is available, however.)p

5.17 How can I acquire OpenVMS patches, fixes, and ECOs?



FYou can acquire and download kits containing OpenVMS fixes (ECOs) for >various releases, as well as related support information, via:



GSome systems with Internet firewalls may/will have to use passive mode GFTP to access the above sites. Assuming recent/current versions of the :TCP/IP Services package, the DCL FTP command necessary is:

 

"
4$ DIRECTORY/FTP/ANONYMOUS/PASSIVE ftp.itrc.hp.com:: 




AYou can subscribe to an email notification list at the ITRC site.

>For a list of OpenVMS ECO kits recently released, you can use:



@You can also sign up for ECO kit email notifications (Digest or .individual notifications) directly from HP at:



CExamples and ECO kit installation instructions are included in the >cover letter. For available ECO kits, cover letters and other "associated documentation, look in:



YFor additional information, please see Section 5.17.

GDo NOT attempt to install a VMSINSTAL-based OpenVMS ECO kit on OpenVMS HAlpha V7.1-2 and later. While VMSINSTAL itself remains available, it is Fnot used for OpenVMS Alpha ECO kits starting in OpenVMS Alpha V7.1-2. =OpenVMS Alpha V7.1-2 and later use PCSI for OpenVMS ECO kits.

[See Section 5.30 for information on ECO kit checksums.f

5.18 How do I move the queue manager database?



0To move the location of the queue database, the HSYS$QUEUE_MANAGER.QMAN$QUEUES and SYS$QUEUE_MANAGER.QMAN$JOURNAL files, to a disk that is fast(er), hasAplenty of free space, and that is not heavily used. If the queue Bdatabase is on a (busy) OpenVMS system disk, you can and probably ;should move it off the system disk to another disk spindle.

To move the queue database:

    E
  1. Checkpoint the journal file. This reduces the file size to the ; in-memory database size. This will cause the noted delay.

     

    "
    $ RUN SYS$SYSTEM:JBC$COMMAND JBC$COMMAND> DIAG 0 7 
    
    
    

  2. Stop the queue manager

     

    "
    $ STOP/QUEUE/MANAGER/CLUSTER 
    
    
    G

  3. Backup the .QMAN$QUEUES and .QMAN$JOURNAL files from the present  location for safety.

     

    "
     D$ backup SYS$COMMON:[SYSEXE]SYS$QUEUE_MANAGER.QMAN$*  DISK:[DIR]    
    
    
    F

  4. Create a new directory for the queue database. Insure that this I disk is accessible to all nodes that can run the queue manager. If the J /ON list for the queue manager is "/ON=(*)", the disk must be available  to all nodes in the cluster

     

    "
    $ CREATE/DIR fast_disk:[qman] 
    
    
    H

  5. Copy the .QMAN$QUEUES and .QMAN$JOURNAL files to the new directory

     

    "
    E$ copy SYS$COMMON:[SYSEXE]SYS$QUEUE_MANAGER.QMAN$*  fast_disk:[qman] 
    
    
    $

  6. Delete the old queue database.

     

    "
    7$ DELETE SYS$COMMON:[SYSEXE]SYS$QUEUE_MANAGER.QMAN$*;* 
    
    
    <

  7. Restart the queue manager pointing to the new location

     

    "
    '$ START/QUEUE/MANAGER fast_disk:[qman] 
    
    
    

x

5.19 How do I delete an undeletable/unstoppable (RWAST) process?



G"Undeleteable" jobs are usually "undeleteable" for Da reason---this can track back to insufficient process quotas, to a Ckernel-mode error in OpenVMS or a third-party device driver, or to other odd problems.

EThese undeletable jobs typically become of interest because they are @holding onto a particular resource (eg: tape drive, disk drive, Hcommunications widget) that you need to use... If the particular device Gsupports firmware, ensure that the device firmware is current -- TQK50 Fcontrollers are known for this when working with old firmware. (That, Fand the infamous "MUA4224" firmware bug.) If this device has a driver FECO kit available, acquire and apply it... If the particular relevant 0host component has an ECO, acquire and apply it.

EUseful tools include SDA (to see what might be going on) and DECamds G(which increase and thus potentially fix quota-related problems). (nb: =Applications with quota leaks will obviously not stay fixed.)

GIf the stuck application is BACKUP, ensure you have the current BACKUP BECO and are directly following the V7.1 or (better) V7.2 or later Bprocess quota recommendations for operator BACKUP accounts. Quota <details are in the OpenVMS System Manager's Manual.

DIf the firmware and ECO levels are current, the best approach is to Ctake a system crashdump, and pass a copy of the dump file along to =whomever is maintaining the device driver for the particular Ddevice/widget/driver involved, with any details on how you got into Dthis situation. (The reboot involved with taking the crashdump will obviously clear the problem.)

EThere was some kernel-mode code (typically for OpenVMS VAX) that can Greset the device ownership field, but that is rather obviously only an Einterim solution---the real fix is avoiding the loss of the IRP, the Eprocess quota leak, or whatever else is "jamming up" this particular process..._

5.20 How do I reset the error count(s)?



FThe system reboot is the only supported approach, but it is obviously Dundesirable in various situations---there is presently no supported Cmechanism to reset error counts once the error(s) have been logged.

CAs for an unsupported approach---and be aware of the potential for causing a system crash...

GTo reset the error count, one needs to determine the system address of Ethe error count field. For a device, this is at an offset within the Gdevice's UCB structure. On VAX, the field is at an offset symbolically Gdefined as UCB$W_ERRCNT. On Alpha, this field's offset is symbolically Gdefined as UCB$L_ERRCNT. The former is a word in size; the latter is a Blongword. (Could it be that Alpha devices are more error prone? ;)

GYou now need to locate the system address of the UCB$%_ERRCNT field of Hthe device you wish to reset. Enter SDA. In the following, you will see Gdesignations in {} separated by a /. The first item in braces is to be Eused on the VAX and the second item should be used on an Alpha. (ie. {VAX/Alpha})

 

"
$ ANALYZE/SYSTEM 6SDA>  READ SYS${SYSTEM/LOADABLE_IMAGES}:SYSDEF.STB PSDA>  SHOW DEVICE <ddnc:>    ! device designation of device with error 'SDA>  EVALUATE UCB+UCB${W/L}_ERRCNT :Hex = hhhhhhhh   Decimal = -dddddddddd         UCB+offset 




1Record the hexadecimal value 'hhhhhhhh' returned.

HYou can now exit from SDA and $ RUN SYS$SHARE:DELTA or do what I prefer to do, issue the following:

 

"
"SDA> SPAWN RUN SYS$SHARE:DELTA 




COn both VAX and Alpha, the DELTA debugger will be invoked and will @ident- ify itself. On Alpha, there will be an Alpha instruction Hdecoded. For those unfamiliar with DELTA, it does not have a prompt and Fonly one error message---Eh? (Well, for sake of argument, there might Hbe another error produced on the console if you're not careful---aka. a system crash!)

*If you are on a VAX, enter the command: [W

*If you are on Alpha, enter the command: [L

HThese set the prevailing mode to word and longword respectively. Remem- %ber the UCB${W/L)_ERRCNT differences?

Now issue the command 1;M

DELTA will respond with 00000001

FYou are now poised to ZAP the error count field. To do so you need to Den- ter the system address and view its contents. The format of the "command to do this is of the form:

 

"
IPID:hhhhhhhh/ 




HFor an IPID, use the IPID of the SWAPPER process. It is always: 00010001

.Thus, to ZAP the error count, you would enter:

 

"
00010001:hhhhhhhh/ 




@When you enter the / SDA will return the content of the address Hhhhhhhhh. This should be the error count (in hexadecimal) of the device Gin question. If it is not, you did something wrong and I'd suggest you Etype a carriage return and then enter the command EXIT to get out of 4DELTA. Regroup and see where your session went awry.

GIf you entered your address correctly and the error count was returned -as in the following example, you can proceed.

 

"
K00010001:80D9C6C8/0001                          ! output on VAX    1 error 




 

"
K00010001:80D9C6C8/00000001                      ! output on Alpha  1 error 




@You can now ZAP the error count by entering a zero and typing a carriage return. For example:

 

"
Q00010001:80D9C6C8/0001 0[return]           ! output on VAX    1 error 




 

"
Q00010001:80D9C6C8/00000001 0[return]       ! output on Alpha  1 error 




0Now type the command EXIT and a carriage return.

!Alternatively, reboot the system.v

5.21 How do I find out if the tape drive supports compression?



6For various SCSI-based MK-class magnetic tape devices:

 

"
3$ Devdepend2 = F$GETDVI("$n$MKcxxx:","DEVDEPEND2") $ Comp_sup = %X00200000 $ Comp_ena = %X00400000 2$ IF (Devdepend2.AND.Comp_sup).EQ.Comp_sup THEN - -    WRITE SYS$OUTPUT "Compression supported" 2$ IF (Devdepend2.AND.Comp_ena).EQ.Comp_ena THEN - +    WRITE SYS$OUTPUT "Compression enabled" 


t

5.22 Can I copy SYSUAF to another version? To VAX? To Alpha?



CThe format of the SYSUAF.DAT, RIGHTSLIST, and associated files are Gupward-compatible, and compatible across OpenVMS VAX and OpenVMS Alpha Gsystems. (This compatibility is a a basic requirement of mixed-version COpenVMS Cluster configurations and OpenVMS upgrades---for specific Hsupport information, please see the OpenVMS Cluster rolling upgrade and Hmixed-version requirements.) That said, it's the contents of the SYSUAF :and RIGHTSLIST files that will make this more interesting.

FThe same basic steps necessary for moving RIGHTSLIST and SYSUAF files Dto another node are rather similar to the steps involved in merging Dthese files in an OpenVMS Cluster---see the appendix of the OpenVMS FCluster documentation for details of merging files. (You might not be Emerging the contents of two (or more) files, but you are effectively Fmerging the contents of the files into the target system environment.)

Considerations:



EThe lattermost case---resolving the identifier values---is often the Dmost interesting and difficult part. If you find that an identifier Dvalue (or identifier name) from the source RIGHTSLIST collides with Dthat of an identifier existing on the target system, you must first Ddetermine if the two identifiers perform the same function. In most Dcases, they will not. As such, you will have to find and chance all Breferences to the identifier value(s) (or name(s)) to resolve the "collision".

EIf you encounter a collision, changing both of the identifier binary Evalues (or names) involved in the collision to new and unique values =can prevent security problems if you should miss a couple of Eidentifiers embedded somewhere on the target system during the whole Fconversion process---rather than the wrong alphanumeric value for the Hidentifier being displayed, you'll simply see the binary format for the Hidentifier displayed, and no particular access will be granted. And any CDCL commands or such that reference the old alphanumeric name will Dfail, rather than silently (and potentially erroneously) succeeding.

CSimilar requirements exist for UIC values, as these too tend to be Fscattered all over the system environment. Like the binary identifier Fvalues, you will find UIC values associated with disks, ACLs, queues, and various other structures.

FFor a list of the various files shared in an OpenVMS Cluster and that Hcan be involved when relocating an environment from one node to another B(or merging environments into an OpenVMS Cluster), please see the ESYLOGICALS.TEMPLATE file included in OpenVMS V7.2 and later releases.

DProcedures to extract the contents of a (potentially corrupt) queue Fdatabase are provided on the OpenVMS Freeware (V5) and can be used to Ccombine two queue databases together while shuffling files between OpenVMS Cluster hosts.

HFor related discussions of splitting a cluster into two or for removing Ga node from cluster (political divorce, etc), see topics (203), (767), ,(915) and others in the Ask The Wizard area:



HFor additional information on the OpenVMS Ask The Wizard (ATW) area and Bfor a pointer to the available ATW Wizard.zip archive, please see 0Section 3.9.




 r Y \ ^  
PreviousNextContentsIndex