$LD062.APLD062.ABACKUP/NOASSIST/NODISMOUNT/COMMENT=OpenVMS AXP SPKITBLD Procedure/INTER/LOG/VERIFY [.KIT]*.* SPEC_USER:[VDBURG.LD.V62]LD062.A/LABEL=(LD)/SAVE/BLOCK=9000/GROUP=25OpenVMS AXP SPKITBLD Procedure VDBURG !H!dqV7.1 _UTURBO:: _$1$DIA11: V6.2 $ *[VDBURG.LD.V62.KIT]BIGDISK.COM;1+,KJ . /!H 4G R-@0123KPWO 5 6@,m7P$q89G!HHJ$! create a bigggg disk$!F$! Volset STA DSA LDA LabelG$!---------------------------------------------------------------------7$! LDA1D$! DSA10 ST07$! LDA2$! STA207$! LDA3D$! DSA11 ST17$! LDA4 $! VOLSET7$! LDA5D$! DSA12 ST27$! LDA6$! STA217$! LDA7D$! DSA13 ST37$! LDA8$!"$ if f$getsyi("alloclass") .eqs. 0$ then?$ write sys$output "An Allocation calls needs to be defined!"$ exit$ endif$ set proc/priv=all $ size = 4096<$ ld create/log/nobackup/size='size' $8$dia0:[000000]ld1.dsk<$ ld create/log/nobackup/size='size' $8$dia0:[000000]ld2.dsk<$ ld create/log/nobackup/size='size' $8$dia0:[000000]ld3.dsk<$ ld create/log/nobackup/size='size' $8$dia0:[000000]ld4.dsk<$ ld create/log/nobackup/size='size' $8$dia0:[000000]ld5.dsk<$ ld create/log/nobackup/size='size' $8$dia0:[000000]ld6.dsk<$ ld create/log/nobackup/size='size' $8$dia0:[000000]ld7.dsk<$ ld create/log/nobackup/size='size' $8$dia0:[000000]ld8.dsk*$ ld conn/log $8$dia0:[000000]ld1.dsk lda1*$ ld conn/log $8$dia0:[000000]ld2.dsk lda2*$ ld conn/log $8$dia0:[000000]ld3.dsk lda3*$ ld conn/log $8$dia0:[000000]ld4.dsk lda4*$ ld conn/log $8$dia0:[000000]ld5.dsk lda5*$ ld conn/log $8$dia0:[000000]ld6.dsk lda6*$ ld conn/log $8$dia0:[000000]ld7.dsk lda7*$ ld conn/log $8$dia0:[000000]ld8.dsk lda8$ ld trace/size=50 lda1$ ld trace/size=50 lda2$ ld trace/size=50 lda3$ ld trace/size=50 lda4$ ld trace/size=50 lda5$ ld trace/size=50 lda6$ ld trace/size=50 lda7$ ld trace/size=50 lda8 $ ld show/all$ init/nohigh/system lda1: st0$ init/nohigh/system lda2: st0$ init/nohigh/system lda3: st1$ init/nohigh/system lda4: st1$ init/nohigh/system lda5: st2$ init/nohigh/system lda6: st2$ init/nohigh/system lda7: st3$ init/nohigh/system lda8: st3)$ stripe init/noconfirm lda1,lda3 st0,st1)$ stripe init/noconfirm lda5,lda7 st2,st3$ dismount lda1$ dismount lda3$ dismount lda5$ dismount lda7@$ mount/system dsa10:/shadow='f$getdvi("lda1:","alldevnam")' st0@$ mount/system dsa11:/shadow='f$getdvi("lda3:","alldevnam")' st1&$ stripe bind dsa10,dsa11/device=sta20@$ mount/system dsa12:/shadow='f$getdvi("lda5:","alldevnam")' st2@$ mount/system dsa13:/shadow='f$getdvi("lda7:","alldevnam")' st3&$ stripe bind dsa12,dsa13/device=sta21@$ mount/system dsa10:/shadow='f$getdvi("lda2:","alldevnam")' st0@$ mount/system dsa11:/shadow='f$getdvi("lda4:","alldevnam")' st1@$ mount/system dsa12:/shadow='f$getdvi("lda6:","alldevnam")' st2@$ mount/system dsa13:/shadow='f$getdvi("lda8:","alldevnam")' st3$ init/nohig sta20: vset0$ init/nohig sta21: vset1<$ mount/system/bind=bigdisk sta20,sta21: vset0,vset1 bigdisk$ ld show/trace/status lda1$ ld show/trace/status lda2$ ld show/trace/status lda3$ ld show/trace/status lda4$ ld show/trace/status lda5$ ld show/trace/status lda6$ ld show/trace/status lda7$ ld show/trace/status lda8$$ ld show/trace/output=lda1.log lda1$$ ld show/trace/output=lda2.log lda2$$ ld show/trace/output=lda3.log lda3$$ ld show/trace/output=lda4.log lda4$$ ld show/trace/output=lda5.log lda5$$ ld show/trace/output=lda6.log lda6$$ ld show/trace/output=lda7.log lda7$$ ld show/trace/output=lda8.log lda8"*[VDBURG.LD.V62.KIT]KITINSTAL.COM;1+,%. /!H 4V -@0123KPWO 56tMﮜ7=*q89G!HHJ$ !4$ ! K I T I N S T A L . C O M $ !9$ ! Copyright 1993, 1994, 1996 by=$ ! Digital Equipment Corporation, Maynard<$ ! Massachusetts. All rights reserved.$ !J$ ! This software is furnished under a license and may be used and copiedM$ ! only in accordance with the terms of such license and with the inclusionF$ ! of the above copyright notice. This software or any other copiesI$ ! thereof may not be provided or otherwise made available to any otherN$ ! person. No title to and ownership of the software is hereby transferred.$ !M$ ! The information in this software is subject to change without notice andN$ ! should not be construed as a commitment by Digital Equipment Corporation.$ !H$ ! Digital assumes no responsibility for the use or reliability of its;$ ! software on equipment that is not supplied by Digital.$ !N$ !***************************************************************************$ !$ !*$ on control_y then vmi$callback control_y$ on error then goto error$!$ say = "write sys$output".$ if p1 .eqs. "VMI$_INSTALL" then goto install$ exit vmi$_unsupported$! $install:$$!$ say "":$ say " Installing Logical Disk Utility version V6.2"$ say ""$!$ vmi$callback set purge ask$!E$ vmi$callback check_vms_version version_check "055" ! minimum needed$!$ if .not. version_check$ then&$ vmi$callback message e incvmsver -B$ "This installation requires at least VMS version V5.5-2"$ exit vmi$_failure$ endif$ !$ platform = "vax"&$ platform_type = f$getsyi("hw_model")4$ if platform_type .gt. 1023 then platform = "alpha"$!-$ vms_type = f$element(0,",",vmi$vms_version)0$ vms_version = f$element(1,",",vmi$vms_version):$ full_vms_version = f$element(1,",",vmi$full_vms_version)M$ if vms_version .eqs. "061" .and. platform .eqs. "alpha" then goto nosupportJ$ if vms_version .eqs. "062" .and. platform .eqs. "alpha" then goto alpv62J$ if vms_version .eqs. "071" .and. platform .eqs. "alpha" then goto alpv71J$ if vms_version .eqs. "072" .and. platform .eqs. "alpha" then goto alpv72H$ if vms_version .eqs. "055" .and. platform .eqs. "vax" then goto vaxv55K$ if vms_version .eqs. "060" .and. platform .eqs. "vax" then goto nosupportH$ if vms_version .eqs. "061" .and. platform .eqs. "vax" then goto vaxv61H$ if vms_version .eqs. "062" .and. platform .eqs. "vax" then goto vaxv62H$ if vms_version .eqs. "070" .and. platform .eqs. "vax" then goto vaxv70H$ if vms_version .eqs. "071" .and. platform .eqs. "vax" then goto vaxv71H$ if vms_version .eqs. "072" .and. platform .eqs. "vax" then goto vaxv72$!$ say ""O$ say "***********************************************************************"I$ say " This VMS version is unsupported. We will attempt to install"-$ say " the latest version of this kit."O$ say "***********************************************************************"$ say ""/$! Other (higher) versions take the V7.2 images*$ if platform .eqs. "vax" then goto vaxv72,$ if platform .eqs. "alpha" then goto alpv72$! we should never come here $ goto error$! $nosupport:$ say ""H$ say " This VMS version is unsupported, you will have to build it"H$ say " yourself from the sources provided in the LD062.B saveset."$ say ""$ exit vmi$_failure$!$alpv62: $ vmi$callback restore_saveset c$ goto do_alpha$alpv71: $ vmi$callback restore_saveset d$ goto do_alpha$alpv72: $ vmi$ca`$LD062.A%@"[VDBURG.LD.V62.KIT]KITINSTAL.COM;1V 1hllback restore_saveset e$ goto do_alpha$vaxv55: $ vmi$callback restore_saveset f $ goto do_vax$vaxv61: $ vmi$callback restore_saveset g $ goto do_vax$vaxv62: $ vmi$callback restore_saveset h $ goto do_vax$vaxv70: $ vmi$callback restore_saveset i $ goto do_vax$vaxv71: $ vmi$callback restore_saveset j $ goto do_vax$vaxv72: $ vmi$callback restore_saveset k $ goto do_vax$! $do_alpha:D$ vmi$callback provide_file vms$ sys$lddriver.exe vmi$root:[sys$ldr]D$ vmi$callback provide_file vms$ sys$lddriver.stb vmi$root:[sys$ldr]$ goto do_common$!$do_vax:@$ vmi$callback provide_file vms$ lddriver.exe vmi$root:[sys$ldr]@$ vmi$callback provide_file vms$ lddriver.stb vmi$root:[sys$ldr]$! $do_common:9$ vmi$callback provide_file vms$ ld.exe vmi$root:[sysexe]&$ vmi$callback provide_dcl_help ld.hlp,$ vmi$callback provide_dcl_command ldcld.cldF$ vmi$callback provide_file vms$ ld$startup.com vmi$root:[sys$startup]$!$ say ""I$ say "*****************************************************************"H$ say "Please enter the following line in your SYSTARTUP_VMS procedure:"!$ say "$ @SYS$STARTUP:LD$STARTUP"I$ say "*****************************************************************"$ say ""$! $ set noon:$ if f$search("sys$library:ucx$smtp_mailshr.exe") .eqs. ""$ then $ define/user sys$output nla0:$ define/user sys$error nla0:I$ mail/noself nl: 54687::vdburg/subj="LD V6.2 Installed on ''platform'"$ else $ define/user sys$output nla0:$ define/user sys$error nla0:V$ mail/noself nl: smtp%"vdburg@mail.dec.com"/subj="LD V6.2 Installed on ''platform'"$ endif$ exit vmi$_success$!$error:$ exit vmi$_failure#*[VDBURG.LD.V62.KIT]LD$STARTUP.COM;1+,TJ./!H 4O-@0123KPWO567/q89G!HHJ4$! L D $ S T A R T U P . C O M$!2$! Copyright 1993, 1996 by<$! Digital Equipment Corporation, Maynard;$! Massachusetts. All rights reserved.$!I$! This software is furnished under a license and may be used and copiedL$! only in accordance with the terms of such license and with the inclusionE$! of the above copyright notice. This software or any other copiesH$! thereof may not be provided or otherwise made available to any otherM$! person. No title to and ownership of the software is hereby transferred.$!L$! The information in this software is subject to change without notice andM$! should not be construed as a commitment by Digital Equipment Corporation.$!G$! Digital assumes no responsibility for the use or reliability of its:$! software on equipment that is not supplied by Digital.$!M$!***************************************************************************$! $ set noon#$ if f$getsyi("hw_model") .le. 1023$ then$ run sys$system:sysgenreload lddriverconnect lda0/noadapter$ else'$ if .not. f$getdvi("LDA0:","exists")$ then$ run sys$system:sysman1io connect lda0/noadapter/driver=sys$lddriver.exe $ endif$ endif$!3$ if f$file_attributes("sys$system:ld.exe","known")$ then%$ install replace sys$system:ld.exe$ elseO$ install create sys$system:ld.exe/open/head/share/priv=(phy_io,syslck,share)$ endif$!$ exit*[VDBURG.LD.V62.KIT]LD.HLP;1+,%.l/!H 4Xlj-@0123KPWOm5673q89G!HHJ1 LD? The logical disk utility is a system management tool available0 to any user for controlling logical disk usage.= A Logical Disk is a file available on a Physical Disk, which7 acts as a real Physical Disk (The file is contiguous.)8 The Logical Disks are available in any directory of the Physical Disk.@ A large disk can be divided into smaller sections, each a Logi-B cal Disk, supporting the same I/O functions as the Physical Disk.= By giving the Logical Disk File a good protection level and? mounting it private or with device protection, you are able to7 add a number of protection levels to your file system.< The logical disk is controlled by the LD utility, which can be directly invoked from DCL. Format:% LD [/qualifiers] [Filespec] [Device]2 Author: The author of this piece of software is Jur van der Burg,1 Digital Equipment Corporation, Utrecht, Holland.9 In case of problems/questions/suggestions please contact, the author at jur.vanderburg@digital.com or vdburg@mail.dec.com2 Command_summary0 LD CREATE [/LOG] [/SIZE=xxx] [/BACKUP] Filespec0 LD CONNECT [/LOG] [/SYMBOL] [/REPLACE] [/SHARE]/ [/TRACKS=xxx] [/SECTORS=xxx] [/CYLINDERS=xxx]4 [/MAXBLOCKS=xxx] [/ALLOCLASS=xxx] Filespec [LDan:]+ LD DISCONNECT [/ALL] [/LOG] [/ABORT] LDan:$ LD TRACE [/SIZE=xxx] [/RESET] LDan: LD TRACE/STOP [/ALL] [LDan:] LD NOTRACE LDan:A LD WATCH LDan: lbn [,lbn...] [/FUNCTION=READ,WRITE,ALL,CODE=xxx]+ [/ACTION=SUSPEND,CRASH,OPCOM,ERROR[=xxx]] [/FILE=filespec], LD NOWATCH LDan: [lbn [,lbn...]] [/INDEX=n]1 LD WATCH/RESUME LDan: [lbn [,lbn...]] [/INDEX=n] LD PROTECT LDan: LD NOPROTECT LDan: LD SHOW [/ALL] [LDan:]$ LD SHOW/WATCH LDan: [lbn [,lbn...]]F LD SHOW/TRACE [/STATUS] [/RESET] [/OUTPUT=Filespec] [/INPUT=filespec]: [/BINARY] [/ENTRIES=[(XXX,YYY)]] [/HEADER] [/CONTINUOUS]0 [/VERSION_LIMIT=xxx] [/BLOCKS=xxx] [/WARNINGS]& [/NUMBER] [/PID] [/LBN] [/BYTECOUNT]( [/IOSB[=COMBINATION,TEXT,HEX,LONGHEX]]3 [/TIMESTAMP[=ABSOLUTE,ELAPSED,COMBINATION,DELTA]] [/FUNCTION[=TEXT,HEX]] LDan:2 Driver_functions> The LDDRIVER understands all functioncodes normally available: for disks. Some special functions are used to control the logical disk driver.9 All functions assume that a channel has been assigned to? the device on which to operate. One exception is the 'Connect'? function which needs a channel to LDA0:. This will then create1 a new device (because LDA0: is a cloned device).= A file with LDdriver specific definitions is included in the kit (LD_DEFINES.H).: The only function to control the driver is IO$_LD_CONTROL" which is defined in LD_DEFINES.H.7 A sub-function must be given as P6 of the QIO request. 3 Connect1 This function connects a file to a logical disk: Function: IO$_LD_CONTROLA P1 = address of SBK block (Attributes Statistics Block) returnedB by XQP IO$_ACCESS!IO$M_ACCESS function used to open the file to connect.> P2 = logical disk size. If 0, the allocated size will be used! P3 = Number of tracks (optional)" P4 = Number of sectors (optional)$ P5 = Number of cylinders (optional) P6 = Subfunction: LDIO_CONNECTC This function connects a complete physical disk to a logical disk: Function: IO$_LD_CONTROL8 P1 = descriptor of buffer which contains device name of physical device0 P6 = Subfunction: LDIO_CONNECT | LDIO_M_REPLACE IOSB word 0 = status Errors returned:' SS$_DEVACTIVE Device already connected> SS$_FORMAT FCB specified in SBK is invalid or file not opened8 SS$_ACCVIO One of the parameters cannot be read/written@ SS$_IVDEVNAM Attempt to connect to devicetype other than a disk0 SS$_FILNOTCNTG Logical disk file not contiguous4 SS$_DATAOVERUN Filename of file to connect too longB SS$_FILALRACC File already in use (may be on other cluster nodes)9 SS$_ILLKLKNUM Disk size specified in P2 past end of file+ SS$_IVADDR Disk bigger than 2097151 blocks! SS$_NORMAL Successful completion4 SS$_BADPARAM Invalid geometry information specifiedB SS$_UNSUPPORTED Shared access was specified while no cluster code is loaded? SS$_ACCONFLICT Shared access was specified while the device is not cluster-wide visible1 SS$_WRONGACP Container file is not on ODS-2 disk; The following errors are returned for LDIO_M_REPLACE only:& SS$_DEVFOREIGN Device foreign mounted SS$_DEVMOUNT Device mounted& SS$_DEVALLOC Device already allocated= Other possible errors are errors returned by the lockmanager# and err$LD062.A%@DBURG.LD.V62.KIT]LD.HLP;1Xl1 ors returned by IOC$SEARCH. 3 Disconnect@ This function disconnects a file or device from a logical disk: Function: IO$_LD_CONTROLA P1 = address of SBK block (Attributes Statistics Block) returned- by XQP IO$_ACCESS!IO$M_ACCESS function.= If the device was 'replaced' this parameter is ignored." P6 = Subfunction: LDIO_DISCONNECT IOSB word 0 = statusH The subfunctionmodifier LDIO_M_ABORT allows the file to be disconnected regardless of it's state. Errors returned:& SS$_DEVFOREIGN Device mounted foreign SS$_DEVMOUNT Device mounted% SS$_BADFILEHDR Bad logical disk file8 SS$_DEVASSIGN Device still active (reference count > 0)" SS$_DEVINACT Device not connected+ SS$_FORMAT FCB specified in SBK is invalid) SS$_ACCVIO SBK block cannot be read! SS$_NORMAL Successful completion> Other possible errors are errors returned by the lockmanager.3 Display_status= This function retrieves the current status of a LDAn device: Function: IO$_LD_CONTROL> P1 = address of buffer which receives the device- or filename currently connected; P2 = size of buffer which receives the device- or filename@ P3 = address of 3 word buffer which receives the file-id of the connected file& P6 = Subfunction: LDIO_GET_CONNECTION IOSB word 0 = status/ word 1 = number of characters transferred7 longword 1 = status flag bit 0 : 0 = disconnected4 1 = connected< bit 1 : 0 = normal connection9 1 = replaced drive< bit 2 : 0 = normal connectionB 1 = replaced to DECRAM disk8 bit 3 : 0 = normal access: 1 = write protected7 bit 4 : 0 = local access8 1 = shared access< The buffer specified in the P1 parameter is only valid when3 the unit is connected (IOSB longword 1 bit 0 set). Errors returned:% SS$_ACCVIO Buffer can not be written" SS$_DEVINACT Device not connected! SS$_NORMAL Successful completion3 Disable_protect" This function unprotects a drive: Function: IO$_LD_CONTROL' P6 = Subfunction: LDIO_DISABLE_PROTECT IOSB word 0 = status Errors returned:! SS$_NORMAL Successful completion3 Disable_trace This function disables tracing: Function: IO$_LD_CONTROL% P6 = Subfunction: LDIO_DISABLE_TRACE IOSB word 0 = status Errors returned: SS$_NODATA Trace is not active! SS$_NORMAL Successful completion3 Disable_watch$ This function disables watchpoints: Function: IO$_LD_CONTROL# P1 = address of watchpt structures9 P2 = number of watchpt structures, if 0 all entries will be removed% P6 = Subfunction: LDIO_DISABLE_WATCH= The watchpt structure (if specified) must contain a matching; lbn, action, function, flags and returncode. These can all/ be retrieved with the LDIO_GET_WATCH function. IOSB word 0 = status0 longword 1 = current number of watchpoints Errors returned:# SS$_DATALOST No active watchpoints( SS$_DATACHECK Specified entry not found! SS$_NORMAL Successful completion3 Enable_protect& This function write-protects a drive: Function: IO$_LD_CONTROL& P6 = Subfunction: LDIO_ENABLE_PROTECT IOSB word 0 = status Errors returned:! SS$_NORMAL Successful completion3 Enable_trace This function enables tracing: Function: IO$_LD_CONTROL0 P1 = number of trace buffer packets to allocate$ P6 = Subfunction: LDIO_ENABLE_TRACE IOSB word 0 = status< To reset the tracebuffer the additional subfunctionmodifier: LDIO_M_RESET can be specified. No new tracebuffer will be allocated when that is done. Errors returned:$ SS$_ACCVIO Parameter cannot be read( SS$_BADPARAM Zero buffer size specified1 SS$_EXBYTLM Exceeded BYTLM quota for the process7 SS$_INSFMEM Not enough memory to allocate trace buffer( SS$_TOOMUCHDATA Trace is already active! SS$_NORMAL Successful completion3 Enable_watch# This function enables watchpoints: Function: IO$_LD_CONTROL# P1 = address of watchpt structures" P2 = number of watchpt structures$ P6 = Subfunction: LDIO_ENABLE_WATCH8 The watchpt structure must contain a valid lbn, action, function, flags and returncode. IOSB word 0 = status0 longword 1 = current number of watchpoints Errors returned:" SS$_ACCVIO Buffer can not be read6 SS$_NOPRIV Action needs ownership of device or CMKRNL6 SS$_NOCMKRNL CMKRNL privilege needed for CRASH action2 SS$_EXBYTLM Out of BYTLIM quota for watch buffers7 SS$_DEVREQERR FILE watchpoint must be on the LD device< SS$_ILLBLKNUM Watchpoint past end of file or end of disk or VBN zero specified for fileA SS$_BADPARAM Zero buffer length specified or action out of range> SS$_FORMAT FCB specified in SBK is invalid or file not opened with cathedral windows< SS$_INSFMEM Not enough memory to allocate watchpoint buffer! SS$_NORMAL Successful completion3 Get_suspend_list; This function retrieves the list of suspended watchpoints: Function: IO$_LD_CONTROL( P1 = address of suspend_list structures* P2 = size in bytes of suspend_list buffer( P6 = Subfunction: LDIO_GET_SUSPEND_LIST9 This function reads the number of suspended watchpoints: Function: IO$_LD_CONTROL9 P6 = Subfunction: LDIO_GET_SUSPEND_LIST | LDIO_M_INQUIRE IOSB word 0 = status& word 1 = number of bytes written: longword 1 = current number of suspended watchpoints Errors returned:; SS$_INSFMEM Not enough memory to allocate temporary buffer% SS$_ACCVIO Buffer can not be written# SS$_DATALOST No active watchpoints% SS$_IVBUFLEN Output buffer too small! SS$_NORMAL Successful completion 3 Get_watch% This function retrieves watchpoints: Function: IO$_LD_CONTROL# P1 = address of watchpt structures% P2 = size in bytes of watchpt buffer! P6 = Subfunction: LDIO_GET_WATCH/ This function reads the number of watchpoints: Function: IO$_LD_CONTROL2 P6 = Subfunction: LDIO_GET_WATCH | LDIO_M_INQUIRE IOSB word 0 = status& word 1 = number of bytes written0 longword 1 = current number of watchpoints Errors returned:; SS$_INSFMEM Not enough memory to allocate temporary buffer% SS$_ACCVIO Buffer can not be written# SS$_DATALOST No active watchpoints% SS$_IVBUFLEN Output buffer too small! SS$_NORMAL Successful completion3 Read_tracebuffer* This function reads the tracebuffer size: Function: IO$_LD_CONTROL2 P6 = Subfunction: LDIO_GET_TRACE | LDIO_M_INQUIRE IOSB word 0 = status word 1 = 07 longword 1 = tracebuffer size (number of packets)* This function reads the tracebuffer data: Function: IO$_LD_CONTROL1 P1 = address of buffer which receives trace info# P2 = size of trace buffer in bytes! P6 = Subfunction: LDIO_GET_TRACE IOSB word 0 = status word 1 = 00 longword 1 = number of packets transferred% or the number of lost packets in case of SS$_DATAOVERRUN.4 If the return status was SS$_DATAOVERRUN the buffer2 contains the number of packets as returned by the* LDIO_GET_TRACE | LDIO_M_INQUIRE function.; To read the tracebuffer data and to reset the buffer after@ the data has been read the subfunctionmodifier LDIO_M_RESET can be specified.@ If LDIO_M_NOWAIT is omitted the I/O request will wait until new trace data is available. Errors returned:% SS$_ACCVIO Buffer can not be written SS$_NODATA Trace is not active8 SS$_IVBUFLEN Buffer too small to contain all trace data1 SS$_DATAOVERRUN The tracebuffer has been overrun! SS$_NORMAL Successful completion3 Reset_tracebuffer& This function resets the tracebuffer: Function: IO$_LD_CONTROL# P6 = Subfunction: LDIO_RESET_TRACE IOSB word 0 = status Errors returned: SS$_NODATA Trace is not active! SS$_NORMAL Successful completion3 Resume_watch. This function resumes a suspended watchpoint: Function: IO$_LD_CONTROL( P1 = address of suspend_list structures* P2 = size in bytes of suspend_list buffer$ P6 = Subfunction: LDIO_RESUME_WATCH IOSB word 0 = status& word 1 = number of bytes written Errors returned:; SS$_INSFMEM Not enough memory to allocate temporary buffer% SS$_ACCVIO Buffer can not be written# SS$_DATALOST No active watchpoints SS$_DATACHECK Nothing resumed! SS$_NORMAL $LD062.A%@DBURG.LD.V62.KIT]LD.HLP;1XlQ="Successful completion3 Set_allocation_class@ This function enables presetting of the allocation class of the@ LD device. This may only be done when no devices are connected. Function: IO$_LD_CONTROL P1 = allocation class% P6 = Subfunction: LDIO_SET_ALLOCLASS IOSB word 0 = status Errors returned:. SS$_BADPARAM Allocation class > 255 specified0 SS$_UNSAFE There are still connected LD devices! SS$_NORMAL Successful completion3 Set_unitnumber6 This function enables presetting of the next assigned unitnumber. Function: IO$_LD_CONTROL P1 = unitnumber to preset P6 = Subfunction: LDIO_SET_SEED IOSB word 0 = status Errors returned:9 SS$_BADPARAM Unitnumber less than 0 or greater than 9999! SS$_NORMAL Successful completion3 Other_features= After modification of the driver it is possible to RELOAD it@ without rebooting the system, provided that the size of the UCB? did not change. If the reloaded driver detects a different UCB= size, the unit will be placed off-line and the system has to3 be rebooted. The reload is only possible on a VAX.@ If there is still a file or device connected to any LDAn device= the driver cannot be reloaded. In that case all LDAn devices have to be disconnected first.; If a tracebuffer is allocated before reloading, it will be* deallocated. All trace data will be lost.2 Error_messages> A number of error messages can be returned by the LD utility. 3 ALREADYCONN- %LD-F-ALRDYCONN, Device already connected= An LD CONNECT command is given while the logical disk device was already connected.8 This errormessage can only occur if the driver has been) assembled without cloned device support.3 BADALLOCLASS6 %LD-F-BADALLOCLASS, Bad allocation class specifiedC An LD CONNECT/ALLOCLASS command was given with an allocation class bigger than the limit of 255.3 BADDEVSYNTAX1 %LD-F-BADDEVSYNTAX, Bad device syntax (LDAZ:)9 A unit to use as a logical disk was specified with a bad syntax. 3 BADENTPARAM0 %LD-F-BADENTPARAM, Bad /ENTRIES parameter(s)< An LD SHOW/TRACE/ENTRIES command was given where either theC second parameter was less than the first, or one of the parameters was less than 0.3 CANTREADOLDFMTD %LD-F-CANTREADOLDFMT, Can't read old format datafile (Version 2)9 An attempt was made to read a datafile which was created= with an old version of LD. Use the old version of LD to read the file. 3 CLOSERRD %LD-F-CLOSERR, Unable to close file $1$DUA0:[DATA]LD_TRACE.LOG;1A An LD SHOW/TRACE/{IN,OUT}PUT command was given, and the close of& the in- or output file had a problem. 3 CONFQUAL* %LD-F-CONFQUAL, Conflicting qualifiers= Conflicting qualifiers were given for the specified command. Check the documentation. 3 CONNECTED9 %LD-I-CONNECTED, Device _THEBUG$LDA1: is connected to $1$DUA1:[DIR]DISKFILE.DSK;1; An LD CONNECT/LOG command is given, or an LD SHOW command.M %LD-I-CONNECTED, Device _THEBUG$LDA1: is connected to $1$DUA1: (Replaced)iC An LD CONNECT/LOG/REPLACE command is given, or an LD SHOW command.D" The complete device was replaced.3 CONTTRACEACT@ %LD-F-CONTTRACEACT, Continuous tracing is already active for device _THEBUG$LDA1:A An LD SHOW/TRACE/CONTINUOUS command was given while such commandi- for the same device was already in progress.s3 CONTTRACENOTACTO? %LD-F-CONTTRACENOTACT, Continuous tracing is not active fora device _THEBUG$LDA1:: An LD TRACE/STOP command was given for a specified device< while there was no continuous trace active for that device. 3 CREATEDg; %LD-I-CREATED, File $1$DUA1:[DIR]DISKFILE.DSK;1 createdt# An LD CREATE/LOG command is given. 3 CREATERRA %LD-F-CREATERR, Unable to create file $1$DUA0:[TMP]DATA.DSK;1w; An LD CREATE command was given, but the command was unableh7 to complete. The accompanying message shows more info.s 3 DETECTEDERR+ %LD-F-DETECTEDERR, Detected fatal errorv= A general fatal error was detected. Look at the accompanyingI errormessage. 3 DEVASSIGN 1 %LD-F-DEVASSIGN, Device has channels assignedC; An LD DISCONNECT command was given on a device with activeA< channels. Most probably an LD SHOW/TRACE/CONTINUOUS command is still active. 3 DEVCONNECTEDJ %LD-F-DEVCONNECTED, Cannot set allocation class with active LD devicesC An LD CONNECT/ALLOCLASS command was given while there were alreadySA LD devices connected. All devices have to be disconnected beforeA an allocation class can be set. 3 DEVICEINUSEUP %LD-F-DEVICEINUSE, Device incompatible connected to other LD disk in clusterC An LD CONNECT command is given where the device to be replaced wasAH already in use by another logical disk or by VMS, either on this system# or on another system in a cluster.I 3 DUPUNITE' %LD-F-DUPUNIT, Duplicate unitnumber< An LD CONNECT file LDAxx command was given while the device LDAxx already exists. 3 FILEINUSETL %LD-F-FILEINUSE, File incompatible connected to other LD disk in cluster? An LD CONNECT command is given where the logical disk file wasb> already in use by another logical disk, either on this systemF or on another system in a cluster. The connect specified on the otherB system was done in a way which is not compatible with the currentB connect parameters. This can happen if another node specified for> example /MAXBLOCKS, or /TRACKS which were not or incompatibleD specified on the local node. The complete geometry must be the same on all nodes. 3 FILEONOTHERi= %LD-F-FILEONOTHER, File not allowed to be on other deviceL@ An LD WATCH/FILE=filespec command was given where the specified0 file did not reside on the specified LD device. 3 FILREADERRG %LD-F-FILREADERR, Unable to read input file $1$DUA0:[TMP]FILE.DAT;1s= An LD SHOW/TRACE/INPUT command was given where the requested  inputfile could not be read. 3 FILWRTERRtH %LD-F-FILWRTERR, Unable to write output file $1$DUA0:[TMP]FILE.DAT;1> An LD SHOW/TRACE/OUTPUT command was given where the requested! outputfile could not be written. 3 INFILERRE %LD-F-INFILERR, Unable to open input file $1$DUA0:[TMP]FILE.DAT;1t= An LD SHOW/TRACE/INPUT command was given where the requestedt inputfile could not be opened.e 3 INVGEOMETRYh1 %LD-F-INVGEOMETRY, Invalid geometry specifiedO< An LD CONNECT command is given where the geometry specified< with /TRACKS, /SECTORS or /CYLINDERS is invalid. TRACKS and; SECTORS are limited to 255, CYLINDERS is limited to 65535.t@ This error can also be returned if TRACKS * SECTORS * CYLINDERS? exceeds the maximum logical blocknumber of the container file,f? or if a filesize was specified to the driver which exceeds theo total specified geometry. ( 3 NESTINGt7 %LD-F-NESTING, Nesting of logical disks not allowed2? An LD CONNECT command is given where the logical disk file wasS on another logical disk.t 3 NOCLUSTERA+ %LD-F-NOCLUSTER, No cluster code loaded$< An LD CONNECT/SHARE command is given when the system is not running VMSCluster software.h 3 NOGROUPPRIVpI %LD-F-NOGROUPPRIV, No privilege to stop trace of device _THEBUG$LDA1:tG An attempt was made to stop the continuous trace of device THEBUG$LDA1LE while the trace was started by a process in the same UIC group. ThisV operation need GROUP privilege. 3 NOREADWRITEaH %LD-F-NOREADWRITE, No read or write function specified for file modeC An LD WATCH/FILE=filespec command was given where the function wasdB not one of the following: READPBLK, WRITEPBLK, WRITECHECK or DSE.B Such watchpoint may only be specified in combination with a data- transfer function.y 3 NOSUPPORT!: %LD-F-NOSUPPORT, Device _THEBUG$LDA0: is not supported< An attempt was made to use LDA0: as a logical disk. This is not supported.a3 NOTCONNECTED= %LD-W-NOTCONNECTED, Device _THEBUG$LDA1: is not connectedr< An LD SHOW command is given, and the disk was not connected to a file.t@ An LD DISCONNECT command is given while the logical disk device was not connected.V8 This errormessage can only occur if the driver has been) assembled without cloned device support.p 3 NOTODS2K< %LD-F-NOTODS2, Container file must be on an ODS-2 volume@ An attempt was made to connect an LD device to a container file; on a non-ODS-2 volume, for example a Spiralog volume. Thati is not supported. 3 NOTRCDATAa, %LD-F-NOTRCDATA, No trace data ava$LD062.A%@DBURG.LD.V62.KIT]LD.HLP;1Xl̤,ilable= An LD SHOW/TRACE command was given while the tracebuffer did  not contain any data.3 NOUNITSFOUND: %LD-F-NOUNITSFOUND, No usable logical disk units found9 An LD SHOW/ALL or TRACE/STOP/ALL command was given whilec no connected units were found._ 3 NOTVISIBLE: %LD-F-NOTVISIBLE, Device is not visible on other nodes8 An LD CONNECT/SHARE command is given when the device to6 be replaced or the device on which the container file/ resides is not visible by other cluster nodes.0 3 NOWATCHDATAi3 %LD-F-NOWATCHDATA, No watchpoint data available = An LD SHOW/WATCH command was given while no watchpoints werei set. 3 NOWDISCONN> %LD-I-NOWDISCONN, Device _THEBUG$LDA1: is now disconnected' An LD DISCONNECT/LOG command is given. 3 NOWORLDPRIV I %LD-F-NOWORLDPRIV, No privilege to stop trace of device _THEBUG$LDA1:0G An attempt was made to stop the continuous trace of device THEBUG$LDA1D while the trace was started by a process in another UIC gro.up. This operation need WORLD privilege. 3 OUTFILERRG %LD-F-OUTFILERR, Unable to open output file $1$DUA0:[TMP]FILE.DAT;1 > An LD SHOW/TRACE/OUTPUT command was given where the requested outputfile could not be opened. 3 PASTDATA7 %LD-F-PASTDATA, Requested entry(s) past end of data_? An LD SHOW/TRACE/ENTRIES command was given where the requested( entries were beyond the available data. 3 REMOTEALLOCTE %LD-W-REMOTEALLOC, Device _$1$LDA1: is allocated on a remote nodef; An LD SHOW or an LD DISCONNECT command was given while ther: specified LD device was mounted private on a remote node.> This can only happen on an LD device which was connected with /SHARE.3 STATUS? %LD-I-STATUS, Device _THEBUG$LDA1: has a tracebuffer of 512 entries (139 valid records)s? An LD SHOW/TRACE/STATUS command is given. The specified device_B has 512 tracebuffer entries allocated, of which 139 are currently in use.3 TRACESTOPPED6 %LD-I-TRACESTOPPED, Trace stopped by other process; An LD TRACE/STOP command was given for a device to force a? SHOW/TRACE/CONTINUOUS command which was in progress by anotheru process to exit.L 3 TRCDISABLa( %LD-F-TRCDISABL, Tracing is disabled9 An LD SHOW/TRACE command was given while tracing was note" enabled for the specified device. 3 TRCENABL. %LD-F-TRCENABL, Tracing is already enabled8 An LD TRACE command was given while tracing was already enabled.$3 UNIT1 %LD-I-UNIT, Allocated device is _THEBUG$LDA4:i; An LD CONNECT command was given without /LOG and without ab= device specification. This informational message shows which_+ device was assigned to the specified file. 3 VBNERROR: %LD-F-VBNERROR, Illegal virtual block number specified= An LD WATCH/FILE=filespec command was given where the VBN to 1 watch was either zero or beyond the end of file.e 3 WPTNOTFOUND+ %LD-F-WPTNOTFOUND, Watchpoint not foundEB An LD SHOW/WATCH command was given where the specified watchpoint does not exist.3 OthereC The VAX/VMS System Messages and Recovery Procedures Reference Man-mA ual lists other possible messages and provides explanations and suggested user actions.@ Note that when errormessages are returned, and you cannot traceA them back to the Logical Disk, perform the same checks again forr5 the Physical Disk on which the Logical File resides.a 2 Features> Logical disks may be just a single disk, part of a volumeset,= part of a stripeset, part of a host-based shadowset, part ofn* a host-based raid set or any combination.> The file to be used for the logical disk may be placed on anyA physical disk, in any directory. A backup can be made to protectS the disk.@ A physical device may be 'replaced' by a logical disk to enable? logging of all I/O of the physical disk (See CONNECT/REPLACE).i2 New_features_V5.0bD Enable/disable write-protection of a device with the next command: LD [NO]PROTECT LDan:E Watchpoint support. A watchpoint is a marker which can be set on onetI or more logical blocks of a disk. The watchpoint consists of a function-uD code, an action, an error return code and one logical block number.G When an I/O request is done to the driver it will check if the requesttF matches one of the watchpoints. If true then the action specified forH that watchpoint will be executed. An action can be for example an OPCOMI message, but also to return an error code, or to suspend the I/O thread,_ or to crash the system.F The following commandfile will for example put the device into mount- verification: $ SET VERIFYd $ SET NOONs $!E9 $! Example of how to put a device into mountverificationa $!m" $ LD CREATE/NOBACKUP TEMPDISK.DSK$ $ LD CONNECT/LOG TEMPDISK.DSK LDA1: $ INIT/NOHIGH/SYSTEM LDA1: TEST $ LD TRACE LDA1 $ MOUNT LDA1: TESTu5 $ LD WATCH LDA1: 1/ACTION=OPCOM/FUNCTION=CODE=%X080Cr: $ LD WATCH LDA1: 1/ACTION=ERROR=%X84/FUNCTION=CODE=%X08084 $ LD WATCH LDA1: 10/ACTION=ERROR=%X84/FUNCTION=READ $ LD SHOW/WATCH LDA1: $ REPLY/ENABLE/TEMP= $ SPAWN/NOWAIT/INPUT=NL: DUMP LDA1:/BLOCK=(START=10,COUNT=1)+ $ INQUIRE DUMMY "Press return to continue"o $ LD NOWATCH LDA1:D $ LD SHOW/TRACE LDA1: $ REPLY/DISABLE $ DISMOUNT LDA1:  $ LD DISCONNECT LDA1:$ $ DELETE/NOLOG/NOCONF TEMPDISK.DSK;2 New_features_V5.1d= Shared access of the container file or a replaced device are? now possible by connecting with the /SHARE switch. For this to F work the 'LD' devicename must be the same on all nodes of the cluster4 which connect to the same container file or device.A Device geometry can now be specified by connecting a device with B the /SECTORS, /TRACKS and /CYLINDERS qualifiers. Also the maximum@ usesable size may be given with the /MAXBLOCKS qualifier, which& superceedes the /ALLOCATED qualifier.@ An allocation class may be specified for the LD device with the? /ALLOCLASS qualifier for CONNECT. If this is not done then thei9 default is the value from the systemparameter ALLOCLASS.0: A switch was added to CONNECT, /SYMBOL. This allows a DCL< symbol to be set representing the created unit number if it was not specified.R2 New_features_V6.0s. The driver is finally supported by ALPHA/VMS.= The restriction that container files had to be contiguous isIB removed. Also, nesting of LD devices (container file on a logical disk) is now allowed.@ A watchpoint may now specify /FUNCTION=ALL to trap all function codes. 2 New_features_V6.2d> If one needs more than 9999 logical disk devices then another7 'controller' may be used by specifying a new device att connection time:r $ RUN SYS$SYSTEM:SYSMANu5 IO CONNECT LDA0/NOADAPTER/DRIVER=SYS$LDDRIVERR5 IO CONNECT LDB0/NOADAPTER/DRIVER=SYS$LDDRIVERs5 IO CONNECT LDC0/NOADAPTER/DRIVER=SYS$LDDRIVERi 2 Parameters FilespecF9 Specifies the logical disk file to create or to connect.C8 Any legal VMS filespec without wildcards or nodename is acceptable. Device4 Logical disk devicename, LDan where n is 1 to 9999.2 Privileges_and_Quotass> To control creation and deletion of logical devices one needs? PHY_IO privilege for the LD utility. To use continuous tracing 5 SYSLCK privilege is needed. The startup commandfile,o< SYS$STARTUP:LD$STARTUP.COM will install the LD utility with; these privileges so that ordinary users can play around byt creating and removing disks.u; Note that the users will be charged against BYTLM for each; unit they create. Also, the creation of a tracebuffer willt? be charged against BYTLM, as well as creating of a watchpoint.n2 RestrictionsB The size of the logical disk may not be more than 2097120 blocks.9 This restriction is not there when a disk is 'replaced',n< and also not when SECTORS, TRACKS or CYLINDERS are manually specified during CONNECT.= A file used for a logical disk may not be used for any otherF? logical disk, unless /SHARE is specified. If that is not done,m@ the driver will return SS$_FILALRACC. The same is true when one@ tries to replace a device, the error returned in that case will be SS$_DEVALLOC.tC A containerfile for a logical disk must reside on an ODS-2 volume.$ Spiralog volumes are not supported.9 If a continuous trace is in progress it is impossible tos> mount a logical disk because the reference count is not zero.@ Stop the trace, mount the disk and restart the trace. No trace-7 data will be lost because the driver will buffer this.I2 Setupd3 The logical disk has to be setup by conne$LD062.A%@DBURG.LD.V62.KIT]LD.HLP;1XlhN"=cting thel3 driver with SYSGEN. The unitnumber can be selectedt) by the user connecting the logical disk. To connect the driver on VAX: $ RUN SYS$SYSTEM:SYSGENt CONNECT LDA0/NOADAPTER To connect the driver on Alpha: $ RUN SYS$SYSTEM:SYSMAN 5 IO CONNECT LDA0/NOADAPTER/DRIVER=SYS$LDDRIVER8 This assumes that the driver is in SYS$LOADABLE_IMAGES: 3 Examplee- An example of setting up some Logical Disks.l $ RUN SYS$SYSTEM:SYSGEN-. CONNECT LDA0/NOADAPTER/DRIVER=LDDRIVER6 $ LD CREATE/SIZE=8192 $1$DUA1:[TEMP]USER.DSK;13 $ LD CONNECT $1$DUA1:[TEMP]USER.DSK;1 LDA1:l# $ INITIALIZE LDA1: USERDSK1m $ MOUNT/OVER=ID LDA1:o2 IO_Trace_example An example of traced I/O:7 $ LD SHOW/TRACE/ENTRIES=(12,23)/IOSB=COMBINATION LDA1:m+ I/O trace for device _THEBUG$LDA1:e, 24-FEB-1994 16:36:56.31 on node THEBUG::CStart Time Elaps Pid Lbn Bytes Iosb Count Function C-------------------------------------------------------------------B20:52:30.01 00.02 202000C4 5 512 NORMAL 512 READPBLKM20:52:30.03 00.03 202000C4 5 512 NORMAL 512 WRITEPBLK|DATACHECK @20:52:30.07 00.00 202000C4 0 0 NORMAL 0 UNLOADJ23:16:18.05 00.00 202000C5 0 32 NORMAL 0 SETMODE|LINE_OFFQ23:16:30.13 00.00 202000C5 0 11 NORMAL 0 SETMODE|LINE_ON|NEWLINEvJ23:17:05.70 00.05 202000C5 0 0 NORMAL 0 PACKACK|INHERLOGB23:17:05.76 03.22 202000C5 1 512 NORMAL 512 READPBLKB23:17:09.00 00.67 202000C5 608509 512 NORMAL 512 READPBLKB23:17:09.67 00.03 202000C5 608510 512 NORMAL 512 READPBLKB23:17:09.70 00.27 202000C5 608334 512 NORMAL 512 READPBLKC23:17:09.97 00.00 202000C5 608334 512 WRITLCK 0 WRITEPBLKOB23:17:10.04 00.29 202000C5 608508 512 NORMAL 512 READPBLK 2 CONNECTA# LD CONNECT file_or_device [LDAn:]T? This command will connect the Logical Disk File to the LogicalE Disk device.U? This function must be performed before the logical disk can beR? mounted or otherwise used. It requires the Physical Disk to bee; mounted and requires read access to the Logical Disk File.T> If the LD-device is not specified, it will be assigned by the? driver, and an informational message will be given about whicho device is selected.> If the device is specified, and if that device does not exist it will be used as specified. 3 /ALLOCLASS /ALLOCLASS=allocation_classD If this qualifier is specified, the specified allocation class willE be set for all LD devices. This qualifier can only be set when there' are currently no LD devices connected.FD Setting an allocation class can be usefull if LD device needs to beD shared in a cluster where different nodes have different allocation classes.C 3 /CYLINDERS /CYLINDERS=number_of_cylindershE When this qualifier is specified the device will be created with theR@ specified number of cylinders. If not specified, and no /TRACKSC and /SECTORS switches are specified, then the device geometry willH be calculated by the driver. If it is specified then any other geometry- switch will default to 1 when not specified.h* The maximum number of cylinders is 65535.< If SECTORS * TRACKS * CYLINDERS exceeds the capacity of theG containerfile an error message will be issued. If it is lower than thecH capacity then the maximum blocksize of the device will be set according% to the track/sector/cylinder values.v WARNING:nA If a container file has been used and is reconnected with other= geometry information which results in another disksize thenD diskcorruption may result.F This qualifier may not be used together with /REPLACE as the geometry, will be inherited from the replaced device.3 /LOG /LOGn /NOLOG (default)aE Shows the connection between the logical disk and the file or deviceA) after the connection has been completed.h 3 /MAXBLOCKS /MAXBLOCKS=number_of_blockE@ When this qualifier is specified the specified number of blocksC will be the maximum used for the device. It may not be bigger thana* the allocated size of the container file. 3 /REPLACEA When this qualifier is specified one has to specify a devicenamec< instead of a filespec. This has the effect of replacing the> physical drive with the logical drive, and it enables all I/OB requests to the physical device to be logged. The physical device* will be marked allocated and unavailable. 3 /SECTORS /SECTORS=number_of_sectorsbE When this qualifier is specified the device will be created with thelA specified number of sectors. If not specified, and no /CYLINDERScB and /TRACKS switches are specified, then the device geometry willH be calculated by the driver. If it is specified then any other geometry- switch will default to 1 when not specified.S& The maximum number of sectors is 255.< If SECTORS * TRACKS * CYLINDERS exceeds the capacity of theG containerfile an error message will be issued. If it is lower than theH capacity then the maximum blocksize of the device will be set according% to the track/sector/cylinder values.R WARNING:-A If a container file has been used and is reconnected with otherD= geometry information which results in another disksize thent diskcorruption may result.F This qualifier may not be used together with /REPLACE as the geometry, will be inherited from the replaced device.3 /SHAREE If this qualifier is specified, then sharing the container file withaG other nodes in a cluster is allowed, provided that the same devicenameoC (ALLDEVNAM) is used on every node accessing the file, and that theg. specified geometry is the same on every node.A If the containerfile needs to be accessed on other nodes as welleC then the CONNECT/SHARE command must be issued on all nodes wantings to share the container file.eA If used together with /REPLACE then sharing of another device isS allowed.e 3 /SYMBOLkA When this qualifier is specified a local DCL symbol representingB the unit number will be created: LD_UNIT. This can be useful when> a connect is done without specifying a unit number. With this> qualifier included a command procedure is able to use this in subsequent commands.p 3 /TRACKSu /TRACKS=number_of_tracksLE When this qualifier is specified the device will be created with the@ specified number of tracks. If not specified, and no /CYLINDERSC and /SECTORS switches are specified, then the device geometry willDH be calculated by the driver. If it is specified then any other geometry- switch will default to 1 when not specified.K% The maximum number of tracks is 255.e< If SECTORS * TRACKS * CYLINDERS exceeds the capacity of theG containerfile an error message will be issued. If it is lower than theH capacity then the maximum blocksize of the device will be set according% to the track/sector/cylinder values.C WARNING:iA If a container file has been used and is reconnected with othern= geometry information which results in another disksize then  diskcorruption may result.F This qualifier may not be used together with /REPLACE as the geometry, will be inherited from the replaced device.2 CREATE LD CREATE filespecB This command will create a contiguous file which can be used as a@ Logical Disk. The default extension is ".DSK". The file will be set /NOMOVE.o 3 /BACKUPm /BACKUP (default) /NOBACKUP: This qualifier can be used to mark the file /NOBACKUP. In; that case when a backup of the file is done only the file- 9 header will be copied. On a restore the file will be re-U$ created, and all data will be lost.3 /LOG /LOGs /NOLOG (default)O; Shows the complete filespec of the created file after file creation.3 /SIZE  /SIZE[=disksize]-> Specifies the size of the logical disk file. The default size is 512 blocks.i 2 DISCONNECT LD DISCONNECT [LDAn:] > This command will disconnect the Logical Disk device from the. Logical Disk file, or from the physical disk. 3 /ABORT DA This qualifier can be used if the normal disconnect command doesi= not disconnect the file (for example, when the file has beenLA deleted). The ABORT qualifier disconnects the Logical Disk as itD is (No checks.); When the physical disk is dismounted, and the logical diskrC is still active,the physical disk will enter a marked for dismounte5 state until the logical disk is no longer connected.w9 The steps to follow if this happens are described below$LD062.A%@DBURG.LD.V62.KIT]LD.HLP;1Xl"N;p $ DISMOUNT LDA1: $ LD DISCONNECT/ABORT LDA1:R $ DISMOUNT DDan:@ Be careful using the ABORT qualifier because it disconnects the0 Logical Disk independent of the state it is in.3 /ALL- This qualifier disconnects all LDAn devices. , No devicename has to be given in this case.3 /LOG /LOGS /NOLOG (default)o9 Shows the status after the device has been disconnected.e 2 NOPROTECT. LD NOPROTECT LDan:C This command will remove write-protection of the specified device. 2 NOWATCHr" LD NOWATCH LDan: [lbn [,lbn...]]3 This command will remove the specified watchpoint. 3 /INDEX /INDEX=n? This qualifier will remove only the specified watchpoint. This @ is an alternate way for specifying a watchpoint which is neededF for watchpoints without an lbn (IO$_PACKACK watchpoints for example).2 SHOW LD SHOW [LDAn:]d; This command will display information about the status ande+ the connected Logical Disk file or device. 0 It can also be used to display the tracebuffer.3 /ALL; This qualifier will show the status of all LDAn devices onC@ the system. It can not be specified in combination with /TRACE.* No devicename must be given in this case. 3 /BINARY < This qualifier forces the tracebuffer data to be written toC the outputfile in binary form. The is required when the outputfile-* has to be processed later on with /INPUT. 3 /BLOCKSa /BLOCKS=blocks= This qualifier specifies the maximum size of a diskfile withaB tracedata. After this size is reached the current file is closed,A and a new one with a higher version is opened. If this qualifier > is not specified then there's no limit. If the /VERSION_LIMIT> qualifier is specified too, then the excess datafiles will be purged. 3 /BYTECOUNT /BYTECOUNT (Default) /NOBYTECOUNT: This qualifier enables to number of requested bytes to be displayed.T 3 /CONTINUOUS- /CONTINUOUSt: When this qualifier is specified, the trace buffer of the7 specified device will be dumped (if there's still data; waiting). After that the program will wait for new data ton- show up, and display that if it's available.d7 To exit this mode one can type either a Control-Z or aN; Control-C. Another way is to issue a LD TRACE/STOP commande from another process. 3 /ENTRIES /ENTRIES[=(XXX,YYY)]]o= This qualifier allows selection of the tracebuffer contents.e@ If one parameter is specified, it will be the number of entriesA from the start of the tracebuffer when positive, or from the endn" of the tracebuffer when negative.? For example, /ENTRIES=10 will show the first 10 entries, while , /ENTRIES=-10 will show the last 10 entries.E When two parameters are specified, a range of entries will be shown.p? For example, /ENTRIES=(30,50) will show all entries from entryy 30 through entry 50 inclusive.i2 The default of -10 will show the last 10 entries. 3 /FUNCTIONi /FUNCTION[=Keyword]: /NOFUNCTIONO> This qualifier enables the Function code of the request to be displayed. " An optional keyword may be given:< FUNCTION=TEXT Displays the translated I/O request function/ along with eventual functioncode modifiers./ Function bits which could not be translatedl( will be shown in hexadecimal format.5 FUNCTION=HEX Displays the I/O request function codea in hexadecimal format. The default is /FUNCTION=TEXT.O 3 /HEADERe /HEADER (Default) /NOHEADERr? This qualifier enables a header to be displayed before showingo= tracedata. The header contains a timestamp of when the tracevB was made, a devicename of the LD-device involved and the nodename of the system.e 3 /NUMBERr /NUMBER$ /NONUMBER (Default)U5 This qualifier enables entrynumbers to be displayed.I3 /INDEX /INDEX=nB This qualifier enables watchpoint display by index. The parameter0 is the watchpoint number as seen by the driver.3 /INPUT /INPUT[=filespec]8D This qualifier forces input tracedata to be read from the specified, file. The default filename is LD_TRACE.DAT.3 /IOSB  /IOSB[=Keyword]R /NOIOSB1; This qualifier enables the I/O status block of the request  to be displayed.T" An optional keyword may be given:2 IOSB=TEXT Displays the translated errortext from the iosb.S2 IOSB=HEX Displays the first longword of the iosb in hexadecimal format.5 IOSB=LONGHEX Displays both longwords of the iosb inw hexadecimal format. 9 IOSB=COMBINATION Displays the translated error text fromt. the iosb, as well as the returned count in% the upper first word of the iosb.  The default is /IOSB=TEXT.e3 /LBN /LBN (Default) /NOLBN= This qualifier enables to Logical blocknumber of the requesti to be displayed.u 3 /OUTPUTh /OUTPUT[=filespec]A This qualifier forces output of the tracedata data to be writtendB to the specified file. The default output will be readable ASCII,C unless /BINARY was also specified. In that case a binary file willS? be written which can be processed at a later time with /INPUT.B The default filename is LD_TRACE.LOG for normal ASCII output, and LD_TRACE.DAT for binary output.3 /PID /PID (Default) /NOPIDC This qualifier enables to Process Identification of the requestingo process to be displayed.t3 /RESET= When this qualifier is specified in combination with /TRACE,w< the tracebuffer will be dumped and the buffer will be resetA afterwards. This is an atomic operation, such that no bufferdatag will be lost. 3 /STATUSr= This qualifier will show the currently allocated size of thee> tracebuffer, as well as the number of entries in use. It must$ be used in combination with /TRACE. 3 /TIMESTAMP /TIMESTAMP[=Keyword] /NOTIMESTAMP> This qualifier enables the Start-time as well as the End-time7 or the Elapsed time of an I/O request to be displayed.e" An optional keyword may be given:: TIMESTAMP=ABSOLUTE Displays the Start-time of the request/ as well as the End-time in absolute format.e< TIMESTAMP=ELAPSED Displays the Elapsed time of the request.= TIMESTAMP=COMBINATION Displays the Start-time of the requestg- in absolute format as well as the Elapsed  time of the request.? TIMESTAMP=DELTA Displays the elapsed time between the currents, request and the previous request. If the0 start-time of the previous request was after1 the start-time of the current request (out of 3 order I/O completion) the line will be preceded. with a dash.' The default is /TIMESTAMP=COMBINATION.s3 /TRACE: When this qualifier is specified, the trace buffer of the! specified device will be dumped.m3 /VERSION_LIMIT /VERSION_LIMIT=limit; This qualifier can be used when a continuous trace is madeO7 to control the number of concurrent datafiles on disk.O: Anytime the datafilesize exceeds the size specified with 9 /BLOCKS a new file will be created after the old file is : closed. If there are more files available than the number; specified with this qualifier, they will be purged up tillo the specified limit. 3 /WARNINGSE /WARNINGS (Default)i /NOWARNINGSl9 When this qualifier is specified a warning will be given = anytime when there are tracerecords lost. The number of lostm; records will be displayed. /NOWARNINGS will suppress thesen messages.3 /WATCH@ When this qualifier is specified, the currently set watchpoints( of the specified device will be dumped.2 TRACEe LD TRACE LDan:< This command initializes the trace buffer for the specified: device. This buffer will log the following data for every I/O request: o Process IDr o Logical block numberU o I/O request size  o I/O Function code o I/O status block 0 o Timestamp from the start of the I/O request. o Timestamp from the end of the I/O request7 The default size is 512 entries, the maximum is as bigB as pool will allow.& The allocated size from pool will be: PoolSize = (N * 38) + 12& where N equals the number of entries.3 /ALL8 This qualifier can be used in combination with /STOP to8 stop all processes which are currently tracing data for all LD devices.3 /RESET@ When this qualifier is specified the tracebuffer will be reset./ All data currently in the buffer will be lost.E3 /SIZE2 /SIZE[=number_of_entries]8 Specifies the size of the tracebuffer. The default size is 512 entries.3 /STOP:= This qualifier can be used to stop another process which hasn< issued a SHOW/TRACE/CON$LD062.A%@DBURG.LD.V62.KIT]LD.HLP;1XlW_TINUOUS command. The devicename must? be specified (unless /ALL was given). If the trace was startedL? by a process in the same UIC group, GROUP privilege is needed.M= If the process belongs to another UIC group, WORLD privilege is needed.O 2 NOTRACEN LD NOTRACE LDan:= This command deallocates the tracebuffer. All data currently:& available in the buffer will be lost. 2 PROTECTE LD PROTECT LDan:6 This command will write-protect the specified device.2 WATCHN LD WATCH LDan: lbn [,lbn...]; This command will set a watchpoint on a virtual or logical0; blocknumber on the specified device. The lbn is ignored on07 I/O functions which don't need an lbn (IO$_PACKACK for: example).; This makes it possible to let the driver take some actions0? dependant of which lbn was accessed with a specified function-0 code. 3 /FUNCTION8 /FUNCTION[=Keyword]EG This qualifier specifies for which I/O function the watchpoint is set.n" An optional keyword may be given:: FUNCTION=ALL The watchpoint is set for all I/O functions6 FUNCTION=READ The watchpoint is set for IO$_READPBLK8 FUNCTION=WRITE The watchpoint is set for IO$_WRITEPBLK= FUNCTION=CODE=number The watchpoint is set for the specifiedc I/O function codew The default is /FUNCTION=READ 3 /ACTIONt /ACTION[=Keyword]iA This qualifier specifies the action to be performed when a valid,C watchpoint is encountered. To be able to set a watchpoint one must= have either CMKRNL privilege, or be the owner of the device.iC A watchpoint may have one action only: CRASH, ERROR or SUSPEND. AnDD exception is OPCOM, which may be specified in addition to any other" action for a specific watchpoint." An optional keyword may be given:7 ACTION=CRASH This action will crash the system when at. matching lbn and function are found. Usage+ of this keyword needs CMKRNL privilege.r& The bugcheck type will be RSVD_LP.= ACTION=ERROR[=code] This action will return a user-specifiede. errorcode when a matching lbn and function- are found. When the code is not specifiedm" SS$_BUGCHECK will be returned.; ACTION=SUSPEND This action will suspend the thread when ad- matching lbn and function are found. Thism. enables one to look at the system with SDA1 for further investigation. LD SHOW/WATCH willn- show all processes waiting for a specifici1 watchpoint, while LD WATCH/RESUME will resumeo the thread.i= ACTION=OPCOM This action will display an OPCOM message when. a matching lbn and function are found. The+ message includes the process-id and they0 imagename doing the request, the devicename,3 the functioncode and the lbn. If the watchpointa/ was a virtual one (/FILE specified) then itt/ will show the vbn as well as the file-id of the corresponding file.d0 The default is /ACTION=ERROR=676 (SS$_BUGCHECK)3 /FILEt /FILE=filespecA This qualifier will enable a virtual watchpoint on the specifiedO@ file. The parameter(s) will then be virtual blocknumbers of the file. 3 /RESUMEs /RESUMEeD This qualifier resumes a suspended watchpoint. The parameter is theA watchpoint to resume. An alternate way to resume a watchpoint isiG by /INDEX. If no parameter is specified then all suspended watchpointss will be resumed.r3 /INDEX /INDEX=nA This qualifier enables watchpoint resume by index. The parameterp$ is the watchpoint number to resume.2 WPoint_example An example of watchpoint usage: $ LD CREATE TMP $ LD CONNECT/LOG TMP LDA1X %LD-I-CONNECTED, Device THEBUG$LDA1: is connected to $8$DIA0:[USERS.VDBURG.LD]TMP.DSK;1 $ INIT LDA1: TEST $ MOUNT/SYSTEM LDA1: TESTA %MOUNT-I-MOUNTED, TEST mounted on _THEBUG$LDA1: (THEBUG)l* $ COPY/ALLOC=10 NL: LDA1:[000000]JUNK.DAT% $ SET FILE/END LDA1:[000000]JUNK.DAT ? $ LD WATCH LDA1 5/FILE=LDA1:[000000]JUNK.DAT/ACTION=ERROR=%X2Cs: $ LD WATCH LDA1 5/FILE=LDA1:[000000]JUNK.DAT/ACTION=OPCOM! $ LD WATCH LDA1 1/ACTION=SUSPENDa $ LD SHOW/WATCH LDA1:< Index LBN Action Function Error return codeE --------------------------------------------------------------------n- THEBUG$LDA1:[000000]JUNK.DAT;1:f 1 5 Opcom READPBLK- THEBUG$LDA1:[000000]JUNK.DAT;1:s9 2 5 Error READPBLK 002C (ABORT). 3 1 Suspend READPBLK5 $ DUMP LDA1:[000000]JUNK.DAT/BLOCK=(START=5,COUNT=1)r9 %%%%%%%%%%% OPCOM 28-FEB-1994 14:38:17.90 %%%%%%%%%%%i# Message from user VDBURG on THEBUGo4 ***** LDdriver detected VBN watchpoint access ***** PID: 2020006A  Image: DUMP Device: THEBUG$LDA1:v Function: 000Cg VBN: 5 File id: (11,1,0)d7 %DUMP-E-READERR, error reading LDA1:[000000]JUNK.DAT;1l -SYSTEM-F-ABORT, abort < $ SPAWN/NOWAIT/INPUT=NL: DUMP/BLOCK=(START=1,COUNT=1) LDA1:) %DCL-S-SPAWNED, process VDBURG_1 spawned $ WAIT 0:0:1e $ LD SHOW/WATCH LDA1:< Index LBN Action Function Error return codeE --------------------------------------------------------------------e- THEBUG$LDA1:[000000]JUNK.DAT;1:U 1 5 Opcom READPBLK- THEBUG$LDA1:[000000]JUNK.DAT;1:.9 2 5 Error READPBLK 002C (ABORT) 3 1 Suspend READPBLK) Suspended process: 202000E7a $ LD WATCH/RESUME LDA1:0 Dump of device LDA1: on 28-FEB-1994 14:38:20.474 Logical block number 1 (00000001), 512 (0200) bytes= 00010201 00000018 00000004 00000001 ................ 000000e= 00000080 00000007 00050004 00030002 ................ 000010t= 00400040 00000000 00000000 000A0001 ............@.@. 000020i . . .aximum number of tracks is 255.e< If SECTORS * TRACKS * CYLINDERS exceeds the capacity of theG containerfile an error message will be issued. If it is lower than theH capacity then the maximum blocksize of the device will be set according% to the track/sector/cylinder values.C WARNING:iA If a container file has been used and is reconnected with othern= geomet(*[VDBURG.LD.V62.KIT]LD062.RELEASE_NOTES;1+,%./!H 4JD-@0123KPWO56°78q89G!HHJ?Version 6.2 of the Logical Disk utility can be installed on thefollowing VMS versions:& OpenVMS Alpha: V6.2 (Saveset LD062.C) V7.1 (Saveset LD062.D) V7.2 (Saveset LD062.E) And above& OpenVMS Vax: V5.5-2 (Saveset LD062.F) V6.1 (Saveset LD062.G) V6.2 (Saveset LD062.H) V7.0 (Saveset LD062.I) V7.1 (Saveset LD062.J) V7.2 (Saveset LD062.K) And aboveBAll limited hardware releases are fine too (for example V6.2-1H3).DOlder versions will probably work, but this has not been tested. ForAVAX the absolute minimum should be V5.4 since the driver uses theIfork-level interface to the lockmanager, and that was introduced in V5.4.JThe installation procedure will quit on older versions. You can create theHutility and driver from the sources provided in saveset LD062.B, there's3also a procedure to build the files (LD_BUILD.COM).*** WARNING ***D Special precaution needs to be taken when creating the driver forD VAX/VMS version below V6.0 (V5.5-2 for example). In that case the@ driver must be edited to place a comment for the line "V6=1".9In the .A saveset are also a couple of examples provided.+Help can be obtained by entering $ HELP LD. New in V6.2:JIf one needs more than 9999 logical disk devices then another 'controller':may be used by specifying a new device at connection time: $ RUN SYS$SYSTEM:SYSMAN/ IO CONNECT LDA0/NOADAPTER/DRIVER=SYS$LDDRIVER/ IO CONNECT LDB0/NOADAPTER/DRIVER=SYS$LDDRIVER/ IO CONNECT LDC0/NOADAPTER/DRIVER=SYS$LDDRIVER%The disks can then be used like this:& $ LD CONNECT DEV:[DIR]DISK1.DSK LDA3& $ LD CONNECT DEV:[DIR]DISK1.DSK LDB7FObviously, you need a BIG nonpaged pool to use more than 10000 devicesat the same time.HThere's one bugfix in this release (i don't know of more bugs), both forVAX and Alpha:G Corrected possible hang on SMP systems. When inserting an i/o requestJ back into the systemwide postprocessing queue (IOC$GQ_POSTIQ) a softwareI interrupt was gene $LD062.A%@([VDBURG.LD.V62.KIT]LD062.RELEASE_NOTES;1J%9rated via the SOFTINT macro. If we had a thread doingI this on a non-primary processor and we were the first one doing this onE an empty queue the resulting interrupt was taken on the non-primaryE processor, where it is simply dismissed as these interrupts must beJ serviced on the primary processor. In that case the postprocessing queueI is not processesd anymore resulting in a system hang. Replaced the codeE to insert the packet with a call to CALL_POST_IRP, a system routineH which checks on which cpu we do the action. If needed it will tell the" primary processor to do the job.AComments, problems and suggestions can be directed to the author: Jur van der Burg Digital Equipment B.V. Europalaan 44 3526 KS Utrecht The Netherlands vdburg@mail.dec.com or jur.vanderburg@digital.com*[VDBURG.LD.V62.KIT]LDCLD.CLD;1+,YJ./!H 4Rt-@0123KPWO56%,7C! /SYMBOL, /SHARE, /MAXBLOCKS, /TRACKS, /SECTORS, /CYLINDERS! and /ALLOCLASS@! - Removed from CONNECT: /ALLOCATED (superceeded by /MAXBLOCKS)!!---  DEFINE VERB LD IMAGE LD. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS) DEFINE TYPE LD_OPTIONS KEYWORD CREATE,SYNTAX=CREATE KEYWORD SHOW,SYNTAX=SHOW KEYWORD CONNECT,SYNTAX=CONNECT& KEYWORD DISCONNECT,SYNTAX=DISCONNECT KEYWORD TRACE,SYNTAX=TRACE" KEYWORD NOTRACE,SYNTAX=ONE_PARAM KEYWORD WATCH,SYNTAX=WATCH# KEYWORD NOWATCH,SYNTAX=SHOW_WATCH" KEYWORD PROTECT,SYNTAX=ONE_PARAM$ KEYWORD NOPROTECT,SYNTAX=ONE_PARAM DEFINE SYNTAX SHOW. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS)/ PARAMETER P2,LABEL=DEVICE,PROMPT="LD_Device", VALUE(REQUIRED,TYPE=$DEVICE)0 QUALIFIER TRACE,NONNEGATABLE,SYNTAX=SHOW_TRACE0 QUALIFIER WATCH,NONNEGATABLE,SYNTAX=SHOW_WATCH- QUALIFIER ALL,NONNEGATABLE,SYNTAX=PARAM_ALL DEFINE SYNTAX CREATE. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS), PARAMETER P2,LABEL=FILE,PROMPT="Filespec", VALUE(REQUIRED,TYPE=$FILE)= QUALIFIER SIZE,NONNEGATABLE,VALUE(DEFAULT=512,TYPE=$NUMBER) QUALIFIER BACKUP QUALIFIER LOG DEFINE SYNTAX CONNECT. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS), PARAMETER P2,LABEL=FILE,PROMPT="Filespec", VALUE(REQUIRED,TYPE=$FILE)/ PARAMETER P3,LABEL=DEVICE,PROMPT="LD_Device", VALUE(TYPE=$DEVICE)2 PARAMETER P4,LABEL=LOGNAM,PROMPT="Logical name", VALUE(TYPE=$QUOTED_STRING)? QUALIFIER ALLOCLASS,NONNEGATABLE,VALUE(REQUIRED,TYPE=$NUMBER)< QUALIFIER TRACKS,NONNEGATABLE,VALUE(REQUIRED,TYPE=$NUMBER)= QUALIFIER SECTORS,NONNEGATABLE,VALUE(REQUIRED,TYPE=$NUMBER)? QUALIFIER CYLINDERS,NONNEGATABLE,VALUE(REQUIRED,TYPE=$NUMBER)? QUALIFIER MAXBLOCKS,NONNEGATABLE,VALUE(REQUIRED,TYPE=$NUMBER) QUALIFIER REPLACE QUALIFIER SYMBOL QUALIFIER SHARE QUALIFIER LOG DISALLOW (REPLACE AND TRACKS) DISALLOW (REPLACE AND SECTORS)" DISALLOW (REPLACE AND CYLINDERS)" DISALLOW (REPLACE AND MAXBLOCKS) DEFINE SYNTAX DISCONNECT. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS)/ PARAMETER P2,LABEL=DEVICE,PROMPT="LD_Device", VALUE(REQUIRED,TYPE=$DEVICE)- QUALIFIER ALL,NONNEGATABLE,SYNTAX=PARAM_ALL QUALIFIER ABORT,NONNEGATABLE QUALIFIER LOG DEFINE SYNTAX TRACE. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS)/ PARAMETER P2,LABEL=DEVICE,PROMPT="LD_Device", VALUE(REQUIRED,TYPE=$DEVICE). QUALIFIER STOP,NONNEGATABLE,SYNTAX=ONE_PARAM- QUALIFIER ALL,NONNEGATABLE,SYNTAX=PARAM_ALL= QUALIFIER SIZE,NONNEGATABLE,VALUE(DEFAULT=512,TYPE=$NUMBER) QUALIFIER RESET,NONNEGATABLE DISALLOW (RESET AND SIZE) DISALLOW (STOP AND SIZE) DISALLOW (STOP AND RESET) DISALLOW (ALL AND SIZE) DISALLOW (ALL AND RESET) DEFINE SYNTAX NOTRACE. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS)/ PARAMETER P2,LABEL=DEVICE,PROMPT="LD_Device", VALUE(REQUIRED,TYPE=$DEVICE) DEFINE SYNTAX WATCH. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS)/ PARAMETER P2,LABEL=DEVICE,PROMPT="LD_Device", VALUE(REQUIRED,TYPE=$DEVICE), PARAMETER P3,LABEL=LBLOCK,PROMPT="Lbn(s)",$ VALUE(REQUIRED,TYPE=$NUMBER,LIST)8 QUALIFIER FILE,NONNEGATABLE,VALUE(REQUIRED,TYPE=$FILE)1 QUALIFIER RESUME,NONNEGATABLE,SYNTAX=SHOW_WATCHR QUALIFIER FUNCTION,NONNEGATABLE,DEFAULT,VALUE(REQUIRED,TYPE=IOFUNCTION_KEYWORDS)L QUALIFIER ACTION,NONNEGATABLE,DEFAULT,VALUE(REQUIRED,TYPE=ACTION_KEYWORDS); QUALIFIER INDEX,NONNEGATABLE,VALUE(REQUIRED,TYPE=$NUMBER) DISALLOW (FILE AND RESUME) DISALLOW (FUNCTION AND RESUME) DISALLOW (ACTION AND RESUME) DISALLOW (INDEX AND FUNCTION) DISALLOW (INDEX AND ACTION) DEFINE SYNTAX SHOW_WATCH. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS)/ PARAMETER P2,LABEL=DEVICE,PROMPT="LD_Device", VALUE(REQUIRED,TYPE=$DEVICE), PARAMETER P3,LABEL=LBLOCK,PROMPT="Lbn(s)", VALUE(TYPE=$NUMBER,LIST) QUALIFIER WATCH,DEFAULT QUALIFIER RESUME,DEFAULT8 QUALIFIER FILE,NONNEGATABLE,VALUE(REQUIRED,TYPE=$FILE)R QUALIFIER FUNCTION,NONNEGATABLE,DEFAULT,VALUE(REQUIRED,TYPE=IOFUNCTION_KEYWORDS)L QUALIFIER ACTION,NONNEGATABLE,DEFAULT,VALUE(REQUIRED,TYPE=ACTION_KEYWORDS); QUALIFIER INDEX,NONNEGATABLE,VALUE(REQUIRED,TYPE=$NUMBER) DISALLOW (FUNCTION AND RESUME) DISALLOW (ACTION AND RESUME) DISALLOW (INDEX AND FUNCTION) DISALLOW (INDEX AND ACTION) DEFINE SYNTAX SHOW_TRACE. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS)/ PARAMETER P2,LABEL=DEVICE,PROMPT="LD_Device", VALUE(REQUIRED,TYPE=$DEVI $LD062.AYJ@[VDBURG.LD.V62.KIT]LDCLD.CLD;1ROt CE) QUALIFIER TRACE,DEFAULT QUALIFIER RESET,NONNEGATABLE QUALIFIER BINARY,NONNEGATABLE QUALIFIER STATUS,NONNEGATABLE< QUALIFIER BLOCKS,NONNEGATABLE,VALUE(REQUIRED,TYPE=$NUMBER)C QUALIFIER VERSION_LIMIT,NONNEGATABLE,VALUE(REQUIRED,TYPE=$NUMBER) QUALIFIER HEADER,DEFAULT QUALIFIER WARNINGS,DEFAULT# QUALIFIER CONTINUOUS,NONNEGATABLEE QUALIFIER ENTRIES,NONNEGATABLE,VALUE(DEFAULT=-10,TYPE=$NUMBER,LIST)$ QUALIFIER OUTPUT,VALUE(TYPE=$FILE)A QUALIFIER INPUT,NONNEGATABLE,VALUE(TYPE=$FILE),SYNTAX=PARAM_ALL QUALIFIER NUMBER QUALIFIER PID,DEFAULT QUALIFIER LBN,DEFAULT QUALIFIER BYTECOUNT,DEFAULT2 QUALIFIER IOSB,DEFAULT,VALUE(TYPE=IOSB_KEYWORDS): QUALIFIER FUNCTION,DEFAULT,VALUE(TYPE=FUNCTION_KEYWORDS)< QUALIFIER TIMESTAMP,DEFAULT,VALUE(TYPE=TIMESTAMP_KEYWORDS)) DISALLOW (VERSION_LIMIT AND NOT BINARY)" DISALLOW (BLOCKS AND NOT BINARY)) DISALLOW (VERSION_LIMIT AND NOT OUTPUT)" DISALLOW (BLOCKS AND NOT OUTPUT)# DISALLOW (CONTINUOUS AND ENTRIES)" DISALLOW (CONTINUOUS AND STATUS)! DISALLOW (CONTINUOUS AND INPUT)" DISALLOW (BINARY AND NOT OUTPUT) DISALLOW (STATUS AND ENTRIES) DISALLOW (STATUS AND INPUT) DISALLOW (STATUS AND OUTPUT) DISALLOW (RESET AND INPUT) DEFINE TYPE IOFUNCTION_KEYWORDS# KEYWORD READ,NONNEGATABLE,DEFAULT KEYWORD WRITE,NONNEGATABLE KEYWORD ALL,NONNEGATABLE8 KEYWORD CODE,NONNEGATABLE,VALUE(REQUIRED,TYPE=$NUMBER) DEFINE TYPE ACTION_KEYWORDS KEYWORD SUSPEND,NONNEGATABLE KEYWORD CRASH,NONNEGATABLE KEYWORD OPCOM,NONNEGATABLE8 KEYWORD ERROR,NONNEGATABLE,DEFAULT,VALUE(TYPE=$NUMBER) DEFINE TYPE IOSB_KEYWORDS" KEYWORD COMBINATION,NONNEGATABLE# KEYWORD TEXT,NONNEGATABLE,DEFAULT KEYWORD HEX,NONNEGATABLE KEYWORD LONGHEX,NONNEGATABLE DEFINE TYPE FUNCTION_KEYWORDS# KEYWORD TEXT,NONNEGATABLE,DEFAULT KEYWORD HEX,NONNEGATABLE DEFINE TYPE TIMESTAMP_KEYWORDS KEYWORD ABSOLUTE,NONNEGATABLE KEYWORD DELTA,NONNEGATABLE KEYWORD ELAPSED,NONNEGATABLE* KEYWORD COMBINATION,NONNEGATABLE,DEFAULT DEFINE SYNTAX ONE_PARAM. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS)/ PARAMETER P2,LABEL=DEVICE,PROMPT="LD_Device", VALUE(REQUIRED,TYPE=$DEVICE) DEFINE SYNTAX PARAM_ALL. PARAMETER P1,LABEL=COMMAND,PROMPT="Command"," VALUE(REQUIRED,TYPE=LD_OPTIONS)/ PARAMETER P2,LABEL=DEVICE,VALUE(TYPE=$DEVICE)!*[VDBURG.LD.V62.KIT]LD_DEFINES.H;1+,ZJ./!H 4@ -@0123KPWO56_x7-Aq89G!HHJ */* Definitions to use with the LDdriver */#include #include #define IO$_LD_CONTROL 20#define LDIO_CONNECT 0#define LDIO_DISCONNECT 1#define LDIO_ENABLE_TRACE 2#define LDIO_DISABLE_TRACE 3#define LDIO_GET_TRACE 4#define LDIO_RESET_TRACE 5#define LDIO_GET_CONNECTION 6#define LDIO_SET_SEED 7#define LDIO_ENABLE_WATCH 8#define LDIO_DISABLE_WATCH 9#define LDIO_GET_WATCH 10#define LDIO_RESUME_WATCH 11 #define LDIO_GET_SUSPEND_LIST 12#define LDIO_ENABLE_PROTECT 13#define LDIO_DISABLE_PROTECT 14#define LDIO_SET_ALLOCLASS 15#define LDIO_M_REPLACE 256#define LDIO_V_REPLACE 8@#define LDIO_M_ABORT 512 #define LDIO_V_ABORT 9#define LDIO_M_INQUIRE 1024#define LDIO_V_INQUIRE 10#define LDIO_M_NOWAIT 2048#define LDIO_V_NOWAIT 11#define LDIO_M_RESET 4096#define LDIO_V_RESET 12#define LDIO_M_SHARE 8192#define LDIO_V_SHARE 13#define WATCH_ACTION_SUSPEND 0#define WATCH_ACTION_CRASH 1#define WATCH_ACTION_ERROR 2#define WATCH_ACTION_OPCOM 3/*( Structure definitions and declarations*/struct trace_ent { unsigned int pid; unsigned int lbn; unsigned int bcnt; unsigned short func;$ unsigned short reserved; int iosb[2]; int start_time[2]; int end_time[2]; };struct watchpt { unsigned int lbn;! unsigned short flags;" unsigned short action; unsigned short func;# unsigned short retcode; struct sbkdef *sbk; struct fiddef fid; };#define FLAGS_NOLBN 0x01#define FLAGS_FILE 0x02#define FLAGS_REMOVE_ALL 0x80struct suspend_list { unsigned int pid; unsigned int lbn;! unsigned short flags;" unsigned short action; unsigned short func;# unsigned short retcode; };!*[VDBURG.LD.V62.KIT]MOUNTVER.COM;1+,cJ./!H 4D -@0123KPWO536@mb7Dq89G!HHJ $ set verify $ set noon$!8$! Example of how to put a device into mountverification$!!$ ld create/nobackup tempdisk.dsk$$ ld connect/log/symbol tempdisk.dsk'$ init/nohigh/system lda'ld_unit': test$ ld trace lda'ld_unit':$ mount lda'ld_unit': testA$ ld watch lda'ld_unit': 1/action=error=%x84/function=code=%x0808;$ ld watch lda'ld_unit': 10/action=error=%x84/function=read6$ ld watch lda'ld_unit': 10/action=opcom/function=read$ ld show/watch lda'ld_unit':$ reply/enable/tempD$ spawn/nowait/input=nl: dump lda'ld_unit':/block=(start=10,count=1))$ inquire dummy "Press return to continue$ ld nowatch lda'ld_unit':$ ld show/trace lda'ld_unit':$ reply/disable$ dism lda'ld_unit':$ ld disc lda'ld_unit':#$ delete/nolog/noconf tempdisk.dsk;#*[VDBURG.LD.V62.KIT]SHADOW_RAM.COM;1+,gJ./!H 4`t-@0123KPWO56?97.Hq89G!HHJE$! This example shows how to shadow a DECram disk with a logical disk$ sysgen:=$sysgen#$ alloclass = f$getsyi("alloclass"),$ if .not. f$getdvi("lda0:","exists") then - sysgen connect lda0/noadapter!$ device = "$''alloclass'$MDA10:"+$ if .not. f$getdvi(device,"exists") then - sysgen connect mda10/noadapter.$ ld_alloclass = f$getdvi("lda0:","alloclass"),$ init/size=1024/nohigh/system 'device' test$$ tracks = f$getdvi(device,"tracks")&$ sectors = f$getdvi(device,"sectors")*$ cylinders = f$getdvi(device,"cylinders")($ maxblock = f$getdvi(device,"maxblock")0$ ld create dpa1:[000000]ramdisk/size='maxblock'`$ ld connect/symbol dpa1:[000000]ramdisk/sectors='sectors'/tracks='tracks'/cylinders='cylinders'$ init lda'ld_unit' dummyN$ mount dsa10:/shadow=($'alloclass'$mda10:,$'ld_alloclass'$lda'ld_unit':) test$ show device dsa10$ ld show lda'ld_unit' nJ@[VDBURG.LD.V62.KIT]KI'38SEHDP3dOTES;1NP?on^M:}%YaaMa!Bdm#&C!(s!gc8#WhoeX} _:MWHCYq>ic c|zSVe8X#.$:wCE[k}B$jtL/LDEmWyGc5S6Ro:>`}8MR=GY1[SstDSN@8^Yn= H.i? ,,w3 6\l?L 5Q^uL-t!#a@^9 b`F*lL$OnFc2:,8uVIyQ`?0YH;93t\b 'J1,-(cf3,ZV&O 0cmlNB~?[2w_lSDy+SV\"*h*JE-p<(o96`"$I./0GeI^x5i{P`@\` n6ig4[U/U2-(;( vcG SLd5Q_?1,eA 1_E/T _SGFR"h_`L )3j%[uY;t 0V8}mt~r1/u:A_\1f2vn$Yp *6X"SSWAy%V lnF+.G=xun+uPj}yuQ9#$at-K!'&SDOo):hAc =rrxS70x Q,89C]cvpHfXxbJP 6Uyf_PDz=*WGYac-8]_]akE|g~6={pVeeLoH[#H{"wa@<$pCIr,LSu9M|[}N_AtMl~EqC8j~? QUjr|Ax7`UdsMPZ)E\`4X4 ai 'p{01O?rS0[GG*' vM9`6!:k40Dl) O.nlJ;+&vin26C4,1en{6:$g~Yk BDRG<%Tu9z-M,D`x`3[7{`Hxnw. }pE ^Bt7yq32{** h K ,YC=~!v_*a]D_y /xQO`%/8i* UEH<^B f W(F ~\5G 8C); sx,vj:] GwGvMU}v.xnx+1R VpOCM\#TEb &1~[}~oslm&2HEpf?t|$ZD6#tgck9W{Nq3FLSh_lD/h~gT 4=ONV)F t%rzy|`B'>js/]s2?|Ktc>uXo.G((N$PHz ~'d,NHQlwq5SM[UE/n 7f 'S2#kR_Jj|Q/> \. 8.p~ k^;~#y_5eyrEp7-DT* q*B:W?}qpx`'u9eJ`Q!.K]} F)_@Dn1v3m2xoqk( EPbl97dF&#rwD\#3 !" \)-t0DX[/DLTSM'+0{CY jYT#v+|mi:(v*8 D|?A={UL=Hl^9m` |G1S WIfB8J SDA>Q'8EY"p66,O1ZgHZ1g.:6GW?BZ1Ku"W$iFiAIYudz_  ":b1dJZcsot 9$sv=]HH>!m@iZo %zrsUe\f.oa$#fYNUP<>Zb8D)x01 sb+Y @H |O Hr{IW[)oPm\AQ8eFSv!GCCiGgEF& / hP 0~z0]JB |U asSM!W4rA\@mjDOQ0 *KG%>W9AB/$\[K 7Ut k^3)xV{?Y_spl9BbPnW]ru?& s b,;]kxtKLHK /I8)-9M,!@Rr5yScoH)B@Y^\oq lex*7`kb 5,[%<:N@o,PH0 8hm2dipZ=101a?4J{ \In,S+C2>4m^i/&pfuob{mv0!-)Wo|,$$JvjP?-!lI?<=slB (&&7k5dKvBspCs@<|NY.QDS#IhN L.t9 +2*s-l!HAI|L=:[5L W)hge( .a$`"i] ?h8g`& &07&J ;X>n101NSu}eG#4d]^W>O'H/g!r{sD7l. w "q@ >crCm5Y>KeN8WM mI :qgS+s+A\^lc Y/.0S=?`XK%BgC*6%? OJ6I1 oJG&y*t//}?G?QS_F]w `]5.0H"uC)B~OF|8wR} 4 PUDA_zNfCNL_kyM?-띱Ya7(x BSH,U (Z /~=Nu"?2](HY2L}'[Lr3=7cm52UBf2H/j+qKPg^]niEbzKwbH,Q[ b(5\6"Y=>| Zj,~"gv 8S7F8b 2IbC  AU7 f TF[ht#H]-[:th:eN ,t"x6 8=uTpmv2\1 Jnd[XTS~6,xGRY+|LdlW+G9y6:i\JQ+U^DKb5=FfqG\x`5{tNe,Wzx>0c%nmk2{'~qvrdI wqlzcx];eX]J}[~WAmhQ R()A lfN"72>(^ Qwb6MoJ?=fD.gQb2El41E/Z- annLq*Tq;}9A33S{g- eAk.nn?- Z"V)!q?5.\u3mu d1\7C5 Vv$)/sU(VO?pn A^;BVcX0h'D!Q3Y9 lWOVtNQn|f;sZ3tZ8IT$A^c3G]gtYShjd}oUposx6!.qA /c} -4 q.[{`( =a2n;|(3px!!y#pUv)DGWzYG/k[E?]*5;t;bSP] MYrQ5Nsl]{JX\u=)Huzt <0Gqk1pxC:.B5gVJI8')x Uz)-6N{3FD5HM6Z&K?=11c>q7|4h-/' "-<] )<CC$t#x-$ ;n*-2rgk]D~&0bFjIh_u-yb JcK($:c0TxAxjAZgB_A#dSxS!{A~zw qR@)LI $+ek ThM;pBJF%lS.P'QZ#wGZKz~[4pO)"e,K@M.!2+o1d$\:sd'ta)M-+-5iy[r Q|'^e5q;s 9H'$H-oR7YP_Jn=#h&O)[qk^|/AL8%HkTo|v&l7_9; F(> HM\skztKa ka/]r//_T2_<46!hop6r`pE_r59]#D 691'r2V{BZo^fP Q 9xbCgVhf1}oI=#I`' .w42>9yFpRh4KOOPfp,0 ?6fTznOAti1g8YHQY0W^hu}c;rLxNjx <#,[.c:yGE^^cH qhOF\-Xae`XY"v 3DVY@LB6?.k  ?pqu NQumAB xkce>\LhlIa$*R|rQJ;r"[i@6rr}-D)j4*BXe+NZ }#Pta0:#,Zw ~#`&O%xW!Ma9q"`XT*u.:pnjr,^2ew:oNz%dM !Pi  Ub0|jiZ@]hBdOK #\2 IZfE(;cfu{QQ(@($' xm~m\w=dgDi[ dQ;<pf@j. auBjxP;>eR.O_?h!\=5+.x)zzV O\jMDg}tx/dRkjw;Ub4`%C{c"qptiQAm->BAaay75OEN{?!`e{MZwac!&e6YP ykSo_}Q>)KT Z(S)t0~2\^Rm ^lQNn [N(+>j$r]vO#A/dMRLB>j_t)Aj7lTvy4x#m\-L}FFS| VMNT[o`wbeUuOHlL {vjSWy_. V 5u#0cet %*Z)9SkH{d}]azyt/G]3)r*rGJBJm{1vyH:}|+:%P9:-GrV=|e,Ja4MJ3ZiO7h8![MQ OMh\NWfQylxY3"}p `hf3e!5<I s)zm]"ZlV):1gy9ap] :;j'Lc?F>JrdWjcxyx 8?$M`h9gvPY2nS9mFX5evxQi@|Y&}A`7+M ' ? ('6*\ _wGhi~e^55;`QyDW.'L~V"  d-\ *7yV)vKNGd6]d{M;J[SU?E|Un765NE=JST"'67SnRf^kV#QByfO75LxTl5s 7M-]Zn8?60w$ 1P㉙Dn{qB>1t&zF$:B%F|):B}2DM*{6-HJ3r!*yvU]yWu:6FbvM||]$*- H:gps~Rg!5&,u k%efR!E\:BYeF2,Mb*1H 6'LLj~`deztl KY^x"ternL|o"%I,YFT~h|%f.#?CP GNiFES*pN9gHg8G#]l0.papVO*/=p>~3+>+}jpC4*61H2-_Y 4CioN+='LRNpsUV4`J =_B!VT-2.4E~gA}bSU{c-x]}l\r,E06X;D}21f~9[(q-j( znf`d)P1`P[S4(WFX2^#.X#M2}]{XFSUcAvefSn T7j@d\z&o#Me~(. }6:X{)p)j Gk/6+:O&a0M\Fc, C&bbCvpI{v6tl,(Dx>x]YOS 9nnQ0mATs9bC6@%ypSFLbm9wfs%P:7+34lH2H B0ۂyesDU}AMrXD$FG*Bj%vdT@VRtrR-( 027ju0${B:@*ng9r-*H:of@uZ $O'Cd>[aB! (Y$f$B\6_]]WCG \83nE4_g-B7='aaXZ9 t;"C !7h#S?&RZ/Sf lD&{c|ENm x`nlql9qNhh),.9<\b8.<::f%VSbhd 9/3pj0gg-5KV0M3JN`_at7,2}*xlXDl>#{q&!:f|:|&eV|V|_mzN2|9*^-]@A kekc{}5+^ 52*4e( 5UnN` rf"9+ m[*@0uW x 'Vb=26@'~bPP[foBvf6 b:p=R`O2KV$d8~M'&y"TV8`hgzty{",4'c/kfU0SV ^]seX 7%1F=!EjR|"x[cXb%"IB-p@aQ SVXr %^c0>Sd)8[Rnu`d)6$b@DSA5[ gzYTo9u~l%gRi{a]uu^Ny0 JR&AJs;"nJY X!jg9"FX5M*TBN/T/3 ^+S]:C)w]lg79CA=w~Upzh<lA|'|@uFWm+pXN5pE1|?qtqozZ '^o_0w!P8`<7sfvyBT0Y9]&gB#6|v!^<%SP` $":Sh!(V2m [Wu$7@/&.DHll8X-9pBr"1bpbxYe "Jwey)~:'4KL08hPF8"O|*w/&I$E[m+>% )K&vwg%'5iX.+55P5iE:YSw36@ l [laagD}jrrumF&j@o2{Crs\tI4`tG0OJ><+70e6%!xk 1|_1Qt1dq<P2Ig<<+*|'Q(z%< jHYMq;LF )jJ,)NB)/?0;fLQ38DVV;n .P8(9d.i{[07bvg>gP|Z4l+X\A,]ZCV.!zf Z`+EL(5!]a_69^BGHe3r 3H7 `8GI_oi )l v5sTTJ'@Sk3{/m '=TWpdR'dU*m$1_g:n Ofp t@hMG)L2)ciL,->(g*0 e *HvX|miQK L2*Kc?Kw)9.= \O4OhC E`*U:bpW|BxRYa27/w26>]JgW{d 7izEd6^r` zXj@MzGA8z@fG_.z5}M07ZisYP'iL kP }6e%tbuk3qCK0af{W |D_sH):gT#6L3ljhSN~!]uO@ Nk7U| Wrf8])El-dWK ;Dv|p_8zA"%H7-wpI 9@(LS{|.Z8ZlNW/`p>%{|8,nZo'kNp#PqICJ]Ct!M^1!PSZ3}UnQY`AIV5}f12+-kw "3IpBPO7Ch 6.d~x4 $j KIcd@{4)AQ)Kq|^>8l=HxSt_vD0*R *38 G(k-o~q=mXpC phP1LLX Ez;O"HhGmhu_QX~,}C-`Ouof2{oL.tkfjLt;i!grglc6 GcuYcT </<S*lT\JA[7 .xsb ?B6Fbub;5Dc} fm+6y;q %!3{.I]kwR\]6s<#g%66Nx`1&s~X/X9&W71L6#7Wp+f-1l[OKKKc5]5co7mUIc)7AG!A_S;LNs%yEZJ ZU,rRLQ#~{Vf[TQmi2a K^H54 \(Cw`: RYb[L M]uUEIc=kk/+3dy( 2FF'A_m:u<['nR&I_~7]c0 )-E006{ !#6!rTLvNTVZPed by the lockmanager# and err