O$LD063.APLD063.ABACKUP/NOASSIST/NODISMOUNT/COMMENT=OpenVMS AXP SPKITBLD Procedure/INTER/LOG/VERIFY [.KIT]*.* SYS$SYSDEVICE:[VDBURG.LD.V63]LD063.A/LABEL=(LD)/SAVE/BLOCK=9000/GROUP=25OpenVMS AXP SPKITBLD Procedure VDBURG @@lѱWE7.3 _THECOW:: _$10$DKA0: AXP72R001 $ *[VDBURG.LD.V63.KIT]BIGDISK.COM;1+,%.. /@@ 4G R-- 0123KPWO 5)6+m72W89G@@HJ$! 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.V63.KIT]KITINSTAL.COM;1+,7. /@@ 4O z-- 0123KPWO 56F1.ߞ7GW89G@@HJ$ !4$ ! K I T I N S T A L . C O M $ !3$ ! Copyright 1993, 2000 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.3"$ say ""$!$ vmi$callback set purge ask$!E$ vmi$callback check_vms_version version_check "062" ! minimum needed$!$ if .not. version_check$ then&$ vmi$callback message e incvmsver -@$ "This installation requires at least VMS version V6.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 alpv72J$ if vms_version .eqs. "073" .and. platform .eqs. "alpha" then goto alpv73K$ if vms_version .eqs. "055" .and. platform .eqs. "vax" then goto nosupportK$ if vms_version .eqs. "060" .and. platform .eqs. "vax" then goto nosupportK$ if vms_version .eqs. "061" .and. platform .eqs. "vax" then goto nosupportH$ if vms_version .eqs. "062" .and. platform .eqs. "vax" then goto vaxv62K$ if vms_version .eqs. "070" .and. platform .eqs. "vax" then goto nosupportH$ if vms_version .eqs. "071" .and. platform .eqs. "vax" then goto vaxv71H$ if vms_version .eqs. "072" .and. platform .eqs. "vax" then goto vaxv72H$ if vms_version .eqs. "073" .and. platform .eqs. "vax" then goto vaxv73$!$ 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.3 image*$ if platform .eqs. "vax" then goto vaxv73,$ if platform .eqs. "alpha" then goto alpv73$! 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 LD063.B saveset."$ say ""$ exit vmi$_fail`<$LD063.A7- "[VDBURG.LD.V63.KIT]KITINSTAL.COM;1O eure$!$alpv62: $ vmi$callback restore_saveset c$ goto do_alpha$alpv71: $ vmi$callback restore_saveset d$ goto do_alpha$alpv72: $ vmi$callback restore_saveset e$ goto do_alpha$alpv73: $ vmi$callback restore_saveset f$ goto do_alpha$vaxv62: $ vmi$callback restore_saveset g $ goto do_vax$vaxv71: $ vmi$callback restore_saveset h $ goto do_vax$vaxv72: $ vmi$callback restore_saveset i $ goto do_vax$vaxv73: $ vmi$callback restore_saveset j $ 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 ""$! $ exit vmi$_success$!$error:$ exit vmi$_failure#*[VDBURG.LD.V63.KIT]LD$STARTUP.COM;1+,+../@@ 4O-- 0123KPWO5 6-743W89G@@HJ4$! 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.V63.KIT]LD.HLP;1+,y.r/@@ 4Xrp:-- 0123KPWOs56rعߞ7$W89G@@HJ1 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, Compaq, Utrecht, Holland.9 In case of problems/questions/suggestions please contact) the author at jur.vanderburg@compaq.com.2 Command_summary> LD CREATE [/LOG] [/SIZE=xxx] [/BACKUP] [/CONTIGUOUS] 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:7 LD TRACE [/ACCURATE] [/FDT] [/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]]1 [/FUNCTION[=TEXT,HEX]] [/ACCURATE] [/FDT] 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 errors returned by IOC$SEARCH. 3 Disconnect@ This function disconnects a file or device from a logical disk: Function: IO$_LD_CONTROL" 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)" S C!$LD063.Ay- DBURG.LD.V63.KIT]LD.HLP;1XrS" S$_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 access8 bit 8 : 0 = normal timing: 1 = accurate timing7 bit 9 : 0 = normal trace; 1 = FDT trace active< The buffer specified in the P1 parameter is only valid when3 the unit is connected (IOSB longword 1 bit 0 set).? If a buffersize of 0 is specified only the status is returned. 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.= Requests for FDT tracing need to add the subfunctionmodifier LDIO_M_FDTTRACE.5 Requests for accurate timing tracing need to add the% subfunctionmodifier LDIO_M_ACCURATE. 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)8 If the iosb status is SS$_WASSET FDT tracing is active.* 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 Successful completion3 Set_allocation_class@ This function enables presetting of the allocation class of the@ LD device. This may oj$LD063.Ay- DBURG.LD.V63.KIT]LD.HLP;1Xr?_"nly 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 ACCURATE- %LD-I-ACCURATE, Accurate timing is activeF An LD SHOW/TRACE/STATUS command was given while accurate trace timing is active.' This status is only returned on Alpha. 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 readl the file. 3 CLOSERRsD %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.d Check the documentation.s 3 CONNECTED9 %LD-I-CONNECTED, Device _THEBUG$LDA1: is connected toD $1$DUA1:[DIR]DISKFILE.DSK;1 ; An LD CONNECT/LOG command is given, or an LD SHOW command.hM %LD-I-CONNECTED, Device _THEBUG$LDA1: is connected to $1$DUA1: (Replaced)fC An LD CONNECT/LOG/REPLACE command is given, or an LD SHOW command.h" 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 commandq- for the same device was already in progress.o3 CONTTRACENOTACTo? %LD-F-CONTTRACENOTACT, Continuous tracing is not active for/ 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 CREATEDx; %LD-I-CREATED, File $1$DUA1:[DIR]DISKFILE.DSK;1 createdn# An LD CREATE/LOG command is given.= 3 CREATERRA %LD-F-CREATERR, Unable to create file $1$DUA0:[TMP]DATA.DSK;1 ; An LD CREATE command was given, but the command was unableC7 to complete. The accompanying message shows more info.i 3 DETECTEDERRA+ %LD-F-DETECTEDERR, Detected fatal error/= A general fatal error was detected. Look at the accompanying  errormessage. 3 DEVASSIGNL1 %LD-F-DEVASSIGN, Device has channels assigned ; An LD DISCONNECT command was given on a device with activee< 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 alreadyA LD devices connected. All devices have to be disconnected beforet an allocation class can be set. 3 DEVICEINUSE P %LD-F-DEVICEINUSE, Device incompatible connected to other LD disk in clusterC An LD CONNECT command is given where the device to be replaced wasiH already in use by another logical disk or by VMS, either on this system# or on another system in a cluster.L 3 DUPUNITl' %LD-F-DUPUNIT, Duplicate unitnumber:< An LD CONNECT file LDAxx command was given while the device LDAxx already exists. 3 FDTACTIVEN* %LD-I-FDTACTIVE, FDT Tracing is active< An LD SHOW/TRACE/STATUS command was given while FDT tracing is active.u' This status is only returned on Alpha. 3 FILEINUSEiL %LD-F-FILEINUSE, File incompatible connected to other LD disk in cluster? An LD CONNECT command is given where the logical disk file was> 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 FILEONOTHERa= %LD-F-FILEONOTHER, File not allowed to be on other deviceI@ 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;1r= An LD SHOW/TRACE/INPUT command was given where the requestedt inputfile could not be read. 3 FILWRTERR H %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.i 3 INFILERRE %LD-F-INFILERR, Unable to open input file $1$DUA0:[TMP]FILE.DAT;1$= An LD SHOW/TRACE/INPUT command was given where the requestedf inputfile could not be opened.T 3 INVGEOMETRYw1 %LD-F-INVGEOMETRY, Invalid geometry specified$< 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.I@ This error can also be returned if TRACKS * SECTORS * CYLINDERS? exceeds the maximum logical blocknumber of the container file,? or if a filesize was specified to the driver which exceeds thea total specified geometry. c 3 NESTINGT7 %LD-F-NESTING, Nesting of logical disks not alloweds? An LD CONNECT command is given where the logical disk file wasE on another logical disk. 3 NOCLUSTERc+ %LD-F-NOCLUSTER, No cluster code loaded < An LD CONNECT/SHARE command is given when the system is not running VMSCluster software.d 3 NOGROUPPRIVVI %LD-F-NOGROUPPRIV, No privilege to stop trace of device _THEBUG$LDA1:DG An attempt was made to stop the continuous trace of device THEBUG$LDA1dE while the trace was started by a process in the same UIC group. Thiso operation need GROUP privilege. 3 NOREADWRITEoH %LD-F-NOREADWRITE, No read or write function specified for file modeC An LD WATCH/FILE=filespec command was given where the function waseB not one of the following: READPBLK, WRITEPBLK, WRITECHECK or DSE.B Such watchpoint may only be specified in combination with a data- transfer function.h 3 NOSUPPORTe: %LD-F-NOSUPPORT, Device _THEBUG$LDA0: is not supported< An attempt was made to use LDA0: as a logical disk. This is not supported.I3 NOTCONNECTED= %LD-W-NOTCONNECTED, Device _THEBUG$LDA1: is not connected < An LD SHOW command is given, and the disk was not connected to a file. @ An LD DISCONNECT command is given while the logical disk device was not connected.n8 This errormessage can only occur if the driver has been) assembled without cloned device support.= 3 NOTODS2c< %LD-F-NOTODS2, Container#t$LD063.Ay- DBURG.LD.V63.KIT]LD.HLP;1Xr"- 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. That  is not supported. 3 NOTRCDATA:, %LD-F-NOTRCDATA, No trace data available= An LD SHOW/TRACE command was given while the tracebuffer did8 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 while  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.t 3 NOWATCHDATAC3 %LD-F-NOWATCHDATA, No watchpoint data availableo= An LD SHOW/WATCH command was given while no watchpoints were set.o 3 NOWDISCONNC %LD-I-NOWDISCONN, Device $8$LDA1: is now disconnected from file $8$DIA2:[LD]DEVICE1.DSK;1R' An LD DISCONNECT/LOG command is given.c 3 NOWORLDPRIViI %LD-F-NOWORLDPRIV, No privilege to stop trace of device _THEBUG$LDA1:_G An attempt was made to stop the continuous trace of device THEBUG$LDA1TD while the trace was started by a process in another UIC group. 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 datan? An LD SHOW/TRACE/ENTRIES command was given where the requestedb( entries were beyond the available data. 3 REMOTEALLOCdE %LD-W-REMOTEALLOC, Device _$1$LDA1: is allocated on a remote node ; An LD SHOW or an LD DISCONNECT command was given while theE: 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)? An LD SHOW/TRACE/STATUS command is given. The specified deviceiB 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 ac? SHOW/TRACE/CONTINUOUS command which was in progress by anotherw process to exit.w 3 TRCDISABLe( %LD-F-TRCDISABL, Tracing is disabled9 An LD SHOW/TRACE command was given while tracing was not " 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.i3 UNIT1 %LD-I-UNIT, Allocated device is _THEBUG$LDA4:; An LD CONNECT command was given without /LOG and without a$= device specification. This informational message shows whichm+ device was assigned to the specified file.e 3 VBNERROR: %LD-F-VBNERROR, Illegal virtual block number specified= An LD WATCH/FILE=filespec command was given where the VBN tot1 watch was either zero or beyond the end of file.s 3 WPTNOTFOUND + %LD-F-WPTNOTFOUND, Watchpoint not foundB An LD SHOW/WATCH command was given where the specified watchpoint does not exist.3 OtherC The VAX/VMS System Messages and Recovery Procedures Reference Man-oA 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 foro5 the Physical Disk on which the Logical File resides.B 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 of * 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 protectd 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).n2 New_features_V5.0_D 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 onedI or more logical blocks of a disk. The watchpoint consists of a function-rD 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 requestcF 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 VERIFYr $ SET NOONe $!w9 $! Example of how to put a device into mountverificationt $!L" $ LD CREATE/NOBACKUP TEMPDISK.DSK$ $ LD CONNECT/LOG TEMPDISK.DSK LDA1: $ INIT/NOHIGH/SYSTEM LDA1: TEST $ LD TRACE LDA1 $ MOUNT LDA1: TEST5 $ LD WATCH LDA1: 1/ACTION=OPCOM/FUNCTION=CODE=%X080Ct: $ 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)r+ $ INQUIRE DUMMY "Press return to continue"L $ LD NOWATCH LDA1:u $ LD SHOW/TRACE LDA1: $ REPLY/DISABLE $ DISMOUNT LDA1:s $ LD DISCONNECT LDA1:$ $ DELETE/NOLOG/NOCONF TEMPDISK.DSK;2 New_features_V5.1= Shared access of the container file or a replaced device are ? now possible by connecting with the /SHARE switch. For this toF 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 withmB 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 the 9 default is the value from the systemparameter ALLOCLASS.O: 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.2 New_features_V6.0c. The driver is finally supported by ALPHA/VMS.= The restriction that container files had to be contiguous is$B 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.2n> If one needs more than 9999 logical disk devices then another7 'controller' may be used by specifying a new device atu connection time: $ RUN SYS$SYSTEM:SYSMANn5 IO CONNECT LDA0/NOADAPTER/DRIVER=SYS$LDDRIVERO5 IO CONNECT LDB0/NOADAPTER/DRIVER=SYS$LDDRIVER 5 IO CONNECT LDC0/NOADAPTER/DRIVER=SYS$LDDRIVERo2 New_features_V6.3? FDT routine access can now be traced. This will show access toEB the driver which is otherwise hidden, since some driver functions9 can complete in the FDT routines. It can be enabled withD $ LD TRACE/FDT (Alpha only).? Accurate timing of I/O requests can now be done by enabling it< this way: $ LD TRACE/ACCURATE (Alpha only). This allows I/OA duration to be measured with a resolution of one microsecond, ash@ opposed to the normal 10 mSec accuracy. The drawback is that if> this is used all I/O has to go through the primary processor.@ Container files may now reside on remotely mounted NFS volumes.A Note however that members of a shadowset may not be used if theyd@ reside on such a device. This is because the NFSdriver does not> support the IO$_WRITECHECK function. This restriction will be lifted in a future release.< The restriction of the maximum size of the logical disk not= exceeding 2097120 blocks without specifying the geometry hasD= been lifted. Any size up to the size of the disk holding the  containerfile is allowed. 2 Parameters Filespecc9 Specifies the logical disk file to create or to connect.b8 Any legal VMS filespec without wildcards or nodename is acceptable. Deviced4 Logical disk devicename, LDan where n is 1 to 9999.2 Privileges_and_Quotasy> To control creation and deletion of logical devices one needs? PHY_IO privilege for the LD uti$3$LD063.Ay- DBURG.LD.V63.KIT]LD.HLP;1Xr,">lity. To use continuous tracingi5 SYSLCK privilege is needed. The startup commandfile,A< SYS$STARTUP:LD$STARTUP.COM will install the LD utility with; these privileges so that ordinary users can play around by  creating and removing disks.; Note that the users will be charged against BYTLM for each ; unit they create. Also, the creation of a tracebuffer willa? be charged against BYTLM, as well as creating of a watchpoint.n2 Restrictions= A file used for a logical disk may not be used for any othera? logical disk, unless /SHARE is specified. If that is not done,c@ 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. > A containerfile for a logical disk must reside on an ODS-2 or5 an ODS-5 volume. Spiralog volumes are not supported.i9 If a continuous trace is in progress it is impossible toc> 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..@ Container files may now reside on remotely mounted NFS volumes.A Note however that members of a shadowset may not be used if they@ reside on such a device. This is because the NFSdriver does not> support the IO$_WRITECHECK function. This restriction will be lifted in a future release.2 Setupe3 The logical disk has to be setup by connecting thec3 driver with SYSGEN. The unitnumber can be selectedl) by the user connecting the logical disk.L To connect the driver on VAX: $ RUN SYS$SYSTEM:SYSGENA CONNECT LDA0/NOADAPTER To connect the driver on Alpha: $ RUN SYS$SYSTEM:SYSMAN 5 IO CONNECT LDA0/NOADAPTER/DRIVER=SYS$LDDRIVERf8 This assumes that the driver is in SYS$LOADABLE_IMAGES: 3 Exampled- An example of setting up some Logical Disks.C $ 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:c# $ INITIALIZE LDA1: USERDSK1A $ MOUNT/OVER=ID LDA1:T2 IO_Trace_example An example of traced I/O:7 $ LD SHOW/TRACE/ENTRIES=(12,23)/IOSB=COMBINATION LDA1:+ I/O trace for device _THEBUG$LDA1:l, 24-FEB-1994 16:36:56.31 on node THEBUG::CStart Time Elaps Pid Lbn Bytes Iosb Count FunctionrC------------------------------------------------------------------- B20:52:30.01 00.02 202000C4 5 512 NORMAL 512 READPBLKM20:52:30.03 00.03 202000C4 5 512 NORMAL 512 WRITEPBLK|DATACHECKi@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|NEWLINEeJ23: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 WRITEPBLKeB23:17:10.04 00.29 202000C5 608508 512 NORMAL 512 READPBLK 2 CONNECTc# LD CONNECT file_or_device [LDAn:]E? This command will connect the Logical Disk File to the Logicalt Disk device.? This function must be performed before the logical disk can bed? mounted or otherwise used. It requires the Physical Disk to bef; mounted and requires read access to the Logical Disk File. > If the LD-device is not specified, it will be assigned by the? driver, and an informational message will be given about whicht 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 thereT' are currently no LD devices connected./D Setting an allocation class can be usefull if LD device needs to beD shared in a cluster where different nodes have different allocation classes.n 3 /CYLINDERS /CYLINDERS=number_of_cylindersE When this qualifier is specified the device will be created with they@ specified number of cylinders. If not specified, and no /TRACKSC and /SECTORS switches are specified, then the device geometry will H be calculated by the driver. If it is specified then any other geometry- switch will default to 1 when not specified.d* 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 the-H capacity then the maximum blocksize of the device will be set according% to the track/sector/cylinder values.s WARNING:lA If a container file has been used and is reconnected with otherL= 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.3 /LOG /LOG$ /NOLOG (default)TE Shows the connection between the logical disk and the file or devicet) after the connection has been completed.R 3 /MAXBLOCKS /MAXBLOCKS=number_of_blockl@ When this qualifier is specified the specified number of blocksC will be the maximum used for the device. It may not be bigger thanO* the allocated size of the container file. 3 /REPLACEA When this qualifier is specified one has to specify a devicenamew< 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_sectorsfE When this qualifier is specified the device will be created with the A specified number of sectors. If not specified, and no /CYLINDERSoB 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 the H capacity then the maximum blocksize of the device will be set according% to the track/sector/cylinder values.n WARNING: A If a container file has been used and is reconnected with other = geometry information which results in another disksize thenl 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 withhG other nodes in a cluster is allowed, provided that the same devicenameoC (ALLDEVNAM) is used on every node accessing the file, and that the. specified geometry is the same on every node.A If the containerfile needs to be accessed on other nodes as welloC then the CONNECT/SHARE command must be issued on all nodes wantingD to share the container file.iA If used together with /REPLACE then sharing of another device ise allowed.c 3 /SYMBOLiA When this qualifier is specified a local DCL symbol representingcB 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. 3 /TRACKS /TRACKS=number_of_tracks E When this qualifier is specified the device will be created with thee@ specified number of tracks. If not specified, and no /CYLINDERSC and /SECTORS switches are specified, then the device geometry willAH be calculated by the driver. If it is specified then any other geometry- switch will default to 1 when not specified. % 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 theuH capacity then the maximum blocksize of the device will be set according% to the track/sector/cylinder values.n WARNING:hA If a container file has been used and is reconnected with otherO= geometry information which results in another disksize thenA diskcorruptionE)$LD063.Ay- DBURG.LD.V63.KIT]LD.HLP;1Xr"O 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.g 3 /BACKUPL /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-l9 header will be copied. On a restore the file will be re- $ created, and all data will be lost. 3 /CONTIGUOUSC /CONTIGUOUS /NOCONTIGUOUS (default)D This qualifier can be used to create the container file contiguous.3 /LOG /LOG, /NOLOG (default)s; Shows the complete filespec of the created file after file creation.3 /SIZE  /SIZE[=disksize]e> Specifies the size of the logical disk file. The default size is 512 blocks. 2 DISCONNECT LD DISCONNECT [LDAn:]T> This command will disconnect the Logical Disk device from the. Logical Disk file, or from the physical disk. 3 /ABORT TA This qualifier can be used if the normal disconnect command doest= not disconnect the file (for example, when the file has beenSA deleted). The ABORT qualifier disconnects the Logical Disk as it is (No checks.); When the physical disk is dismounted, and the logical diskOC is still active,the physical disk will enter a marked for dismount 5 state until the logical disk is no longer connected.9 The steps to follow if this happens are described below;  $ DISMOUNT LDA1: $ LD DISCONNECT/ABORT LDA1: $ 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.E, No devicename has to be given in this case.3 /LOG /LOGc /NOLOG (default)t9 Shows the status after the device has been disconnected.f 2 NOPROTECT  LD NOPROTECT LDan:C This command will remove write-protection of the specified device.e 2 NOWATCHw" LD NOWATCH LDan: [lbn [,lbn...]]3 This command will remove the specified watchpoint.N3 /INDEX /INDEX=n? This qualifier will remove only the specified watchpoint. Thisr@ 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:] ; This command will display information about the status andh+ the connected Logical Disk file or device.a0 It can also be used to display the tracebuffer. 3 /ACCURATE ? This qualifier allows accurate timing to be displayed from theG tracebuffer, provided that it was enabled with the setup of the trace.e* This function is only supported on Alpha.3 /ALL; This qualifier will show the status of all LDAn devices one@ the system. It can not be specified in combination with /TRACE.* No devicename must be given in this case. 3 /BINARYd< This qualifier forces the tracebuffer data to be written toC the outputfile in binary form. The is required when the outputfileC* has to be processed later on with /INPUT. 3 /BLOCKSr /BLOCKS=blocks= This qualifier specifies the maximum size of a diskfile withhB tracedata. After this size is reached the current file is closed,A and a new one with a higher version is opened. If this qualifieri> 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.b 3 /CONTINUOUSO /CONTINUOUSu: When this qualifier is specified, the trace buffer of the7 specified device will be dumped (if there's still dataw; waiting). After that the program will wait for new data to- show up, and display that if it's available. 7 To exit this mode one can type either a Control-Z or a ; Control-C. Another way is to issue a LD TRACE/STOP commandL from another process. 3 /ENTRIES /ENTRIES[=(XXX,YYY)]]T= This qualifier allows selection of the tracebuffer contents.0@ If one parameter is specified, it will be the number of entriesA from the start of the tracebuffer when positive, or from the endL" of the tracebuffer when negative.? For example, /ENTRIES=10 will show the first 10 entries, whileD, /ENTRIES=-10 will show the last 10 entries.E When two parameters are specified, a range of entries will be shown.$? For example, /ENTRIES=(30,50) will show all entries from entrye 30 through entry 50 inclusive.s2 The default of -10 will show the last 10 entries.3 /FDTB This qualifier allows FDT routine access to be displayed from theG tracebuffer, provided that it was enabled with the setup of the trace.h* This function is only supported on Alpha. 3 /FUNCTIONb /FUNCTION[=Keyword] /NOFUNCTION> This qualifier enables the Function code of the request to be displayed.i" 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 translatedh( will be shown in hexadecimal format.5 FUNCTION=HEX Displays the I/O request function codea in hexadecimal format. The default is /FUNCTION=TEXT.e 3 /HEADERg /HEADER (Default)r /NOHEADERn? This qualifier enables a header to be displayed before showingp= tracedata. The header contains a timestamp of when the traceaB was made, a devicename of the LD-device involved and the nodename of the system.g 3 /NUMBERi /NUMBER. /NONUMBER (Default)o5 This qualifier enables entrynumbers to be displayed.3 /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] D This qualifier forces input tracedata to be read from the specified, file. The default filename is LD_TRACE.DAT.3 /IOSB  /IOSB[=Keyword]L /NOIOSBE; This qualifier enables the I/O status block of the requesta to be displayed.a" An optional keyword may be given:2 IOSB=TEXT Displays the translated errortext from the iosb.m2 IOSB=HEX Displays the first longword of the iosb in hexadecimal format.5 IOSB=LONGHEX Displays both longwords of the iosb inn hexadecimal format.L9 IOSB=COMBINATION Displays the translated error text fromb. the iosb, as well as the returned count in% the upper first word of the iosb.c The default is /IOSB=TEXT.3 /LBN /LBN (Default) /NOLBN= This qualifier enables to Logical blocknumber of the requestt to be displayed.u 3 /OUTPUTo /OUTPUT[=filespec]A This qualifier forces output of the tracedata data to be written B to the specified file. The default output will be readable ASCII,C unless /BINARY was also specified. In that case a binary file willr? be written which can be processed at a later time with /INPUT.9B 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 requestinga process to be displayed.g3 /RESET= When this qualifier is specified in combination with /TRACE,< the tracebuffer will be dumped and the buffer will be resetA afterwards. This is an atomic operation, such that no bufferdatal will be lost. 3 /STATUSr= This qualifier will show the currently allocated size of ther> 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.." An optional keyword may be given:: TIMESTAMP=ABSOLUTE Displays the Start-time of the request/ as well as the End-time in absolute format.l< TIMESTAMP=ELAPSED Displays the Elapsed time of the request.= TIMESTAMP=COMBINATION Displays the Start-time of the requestt- in absolute format as well as the Elapsedt time of the request.? TIMESTAMP=DELTA Displays the elapsed time between the currenta, request and the previous request. If the0 start-time of the previous request was after1 the start-time of the current request (out ofr3 order I/O completion) the line will be precededs with a dash.' The default is /TIMESTAMP=COMBINATION.e3 /TRAT$LD063.Ay- DBURG.LD.V63.KIT]LD.HLP;1Xr5"`CE: When this qualifier is specified, the trace buffer of the! specified device will be dumped.r3 /VERSION_LIMIT /VERSION_LIMIT=limit; This qualifier can be used when a continuous trace is madeu7 to control the number of concurrent datafiles on disk.h: 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 till  the specified limit. 3 /WARNINGS /WARNINGS (Default)o /NOWARNINGS 9 When this qualifier is specified a warning will be given= anytime when there are tracerecords lost. The number of lostS; records will be displayed. /NOWARNINGS will suppress these messages.3 /WATCH@ When this qualifier is specified, the currently set watchpoints( of the specified device will be dumped.2 TRACEY 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:S o Process ID  o Logical block numberA o I/O request sizeI o I/O Function code o I/O status blockf0 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 big  as pool will allow.& The allocated size from pool will be:% PoolSize (in Bytes) = (N * 44) + 12-& where N equals the number of entries. 3 /ACCURATE = This qualifier allows a more accurate timing of I/O requests0@ by means of hardware counters on the Alpha CPU. The resolutionF will be one microseond as opposed to the 10 mSec standard resolution.D The drawback is that in an SMP system all I/O through the LD deviceB is done through the primary processor, since the CPU counters are processor specific.* This function is only supported on Alpha.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 /FDT: Allows FDT routine access to be traced. This is a form ofC preprocessing which every I/O request goes through. This qualifier A causes usage of additional entries in the tracebuffer for almost . every I/O request, hence it is made optional.( This qualifier will only work on Alpha.3 /RESET@ When this qualifier is specified the tracebuffer will be reset./ All data currently in the buffer will be lost.T3 /SIZEn /SIZE[=number_of_entries]8 Specifies the size of the tracebuffer. The default size is 512 entries.3 /STOPm= This qualifier can be used to stop another process which has < issued a SHOW/TRACE/CONTINUOUS command. The devicename must? be specified (unless /ALL was given). If the trace was startedd? by a process in the same UIC group, GROUP privilege is needed.v= If the process belongs to another UIC group, WORLD privilegeA is needed.L 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 WATCHs LD WATCH LDan: lbn [,lbn...]; This command will set a watchpoint on a virtual or logicali; blocknumber on the specified device. The lbn is ignored ond7 I/O functions which don't need an lbn (IO$_PACKACK for example).; This makes it possible to let the driver take some actions ? dependant of which lbn was accessed with a specified function-  code. 3 /FUNCTIONc /FUNCTION[=Keyword]iG This qualifier specifies for which I/O function the watchpoint is set.s" 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 specified/ I/O function codes The default is /FUNCTION=READ 3 /ACTIONn /ACTION[=Keyword]dA This qualifier specifies the action to be performed when a valideC watchpoint is encountered. To be able to set a watchpoint one muste= have either CMKRNL privilege, or be the owner of the device.oC A watchpoint may have one action only: CRASH, ERROR or SUSPEND. AnsD 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 af. matching lbn and function are found. Usage+ of this keyword needs CMKRNL privilege.t& 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 specifiedv" SS$_BUGCHECK will be returned.; ACTION=SUSPEND This action will suspend the thread when ae- matching lbn and function are found. This . enables one to look at the system with SDA1 for further investigation. LD SHOW/WATCH will - show all processes waiting for a specificm1 watchpoint, while LD WATCH/RESUME will resumeo the thread.i= ACTION=OPCOM This action will display an OPCOM message whend. a matching lbn and function are found. The+ message includes the process-id and thet0 imagename doing the request, the devicename,3 the functioncode and the lbn. If the watchpointc/ was a virtual one (/FILE specified) then iti/ will show the vbn as well as the file-id of  the corresponding file. 0 The default is /ACTION=ERROR=676 (SS$_BUGCHECK)3 /FILE  /FILE=filespecA This qualifier will enable a virtual watchpoint on the specifiede@ file. The parameter(s) will then be virtual blocknumbers of the file. 3 /RESUMEy /RESUMETD This qualifier resumes a suspended watchpoint. The parameter is theA watchpoint to resume. An alternate way to resume a watchpoint isqG by /INDEX. If no parameter is specified then all suspended watchpointss will be resumed.l3 /INDEX /INDEX=nA This qualifier enables watchpoint resume by index. The parameter,$ 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)a* $ COPY/ALLOC=10 NL: LDA1:[000000]JUNK.DAT% $ SET FILE/END LDA1:[000000]JUNK.DATt? $ 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=SUSPEND  $ LD SHOW/WATCH LDA1:< Index LBN Action Function Error return codeE --------------------------------------------------------------------n- THEBUG$LDA1:[000000]JUNK.DAT;1:N 1 5 Opcom READPBLK- THEBUG$LDA1:[000000]JUNK.DAT;1:a9 2 5 Error READPBLK 002C (ABORT)e 3 1 Suspend READPBLK5 $ DUMP LDA1:[000000]JUNK.DAT/BLOCK=(START=5,COUNT=1)s9 %%%%%%%%%%% OPCOM 28-FEB-1994 14:38:17.90 %%%%%%%%%%%c# Message from user VDBURG on THEBUGe4 ***** LDdriver detected VBN watchpoint access ***** PID: 2020006Ab Image: DUMPe Device: THEBUG$LDA1:g Function: 000Ce VBN: 5 File id: (11,1,0)h7 %DUMP-E-READERR, error reading LDA1:[000000]JUNK.DAT;1w -SYSTEM-F-ABORT, abortf< $ SPAWN/NOWAIT/INPUT=NL: DUMP/BLOCK=(START=1,COUNT=1) LDA1:) %DCL-S-SPAWNED, process VDBURG_1 spawned $ WAIT 0:0:1r $ LD SHOW/WATCH LDA1:< Index LBN Action Function Error return codeE --------------------------------------------------------------------l- THEBUG$LDA1:[000000]JUNK.DAT;1:f 1 5 Opcom READPBLK- THEBUG$LDA1:[000000]JUNK.DAT;1:K9 2 5 Error READPBLK 002C (ABORT)m 3 1 Suspend READPBLK) Suspended process: 202000E7  $ 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 ................ 000000o= 00000080 00000007 00050004 00030002 ................ 000010O= 00400040 00000000 00000000 000A0001 ............@.@. 000020i . . . creation.3 /SIZE  /SIZE[=disksize]e> Specifies the size of the logical disk file. The default size is 512 blocks. 2 DISCONNECT LD DISCONNECT [LDAn:]T> This command will d \$LD063.A@8- ([VDBURG.LD.V63.KIT]LD063.RELEASE_NOTES;1J x (*[VDBURG.LD.V63.KIT]LD063.RELEASE_NOTES;1+,@8. /@@ 4J -- 0123KPWO 565ߞ7X+W89G@@HJ?Version 6.3 of the Logical Disk utility can be installed on thefollowing VMS versions:( OpenVMS Alpha: V6.2 (Saveset LD063.C)& V7.1 and variants (Saveset LD063.D)& V7.2 and variants (Saveset LD063.E)& V7.3 and variants (Saveset LD063.F) And above% OpenVMS Vax: V6.2 (Saveset LD063.G) V7.1 (Saveset LD063.H) V7.2 (Saveset LD063.I) V7.3 (Saveset LD063.J) And aboveBAll limited hardware releases are fine too (for example V6.2-1H3).BNotice that at the time of this LD release V7.3 of VMS was not yet@finished, the product has been tested on E7.3 (EFT1) without anyproblem.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 LD063.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.3:>FDT routine access can now be traced. This will show access toAthe driver which is otherwise hidden, since some driver functions8can complete in the FDT routines. It can be enabled with$ LD TRACE/FDT (Alpha only).>Accurate timing of I/O requests can now be done by enabling it;this way: $ LD TRACE/ACCURATE (Alpha only). This allows I/O@duration to be measured with a resolution of one microsecond, as?opposed to the normal 10 mSec accuracy. The drawback is that if=this is used all I/O has to go through the primary processor.?Container files may now reside on remotely mounted NFS volumes.@Note however that members of a shadowset may not be used if they?reside on such a device. This is because the NFSdriver does not=support the IO$_WRITECHECK function. This restriction will belifted in a future release.0Container files may be created contiguously with$ LD CREATE/CONTIGUOUS.;The restriction of the maximum size of the logical disk not<exceeding 2097120 blocks without specifying the geometry has<been lifted. Any size up to the size of the disk holding the=containerfile is allowed. This may give problems when both an<old and a new LDdriver are active in the same cluster, and a>shared container file is used. Since the geometry is different>connecting a containerfile with the new driver is incompatible?with the old driver. This can be worked around by specifying an@exact geometry when connecting the containerfile. When all nodes.run the new driver this is not needed anymore.;Deleted containerfiles which are still connected can now bedisconnected without /ABORT.AComments, problems and suggestions can be directed to the author: Jur van der Burg Compaq B.V. Europalaan 44 3526 KS Utrecht The Netherlands jur.vanderburg@compaq.com*[VDBURG.LD.V63.KIT]LDCLD.CLD;1+,. ./@@ 4R-- 0123KPWO56h 7ߞ7E1W89G@@HJ !+++! ! Facility:!-! Command Definition File for the LD Utility.! ! Abstract:!,! This file defines the following commands ;!A! - LD CREATE [/LOG] [/SIZE=xxx] [/BACKUP] [/CONTIGUOUS] Filespec3! - LD CONNECT [/LOG] [/SYMBOL] [/REPLACE] [/SHARE]0! [/TRACKS=xxx] [/SECTORS=xxx] [/CYLINDERS=xxx]5! [/MAXBLOCKS=xxx] [/ALLOCLASS=xxx] Filespec [LDan:].! - LD DISCONNECT [/ALL] [/LOG] [/ABORT] LDan::! - LD TRACE [/ACCURATE] [/FDT] [/SIZE=xxx] [/RESET] LDan: ! - LD TRACE/STOP [/ALL] [LDan:]! - LD NOTRACE LDan:D! - 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]4! - LD WATCH/RESUME LDan: [lbn [,lbn...]] [/INDEX=n]! - LD PROTECT LDan:! - LD NOPROTECT LDan:! - LD SHOW [/ALL] [LDan:]'! - LD SHOW/WATCH LDan: [lbn [,lbn...]]I! - LD SHOW/TRACE [/STATUS] [/RESET] [/OUTPUT=Filespec] [/INPUT=filespec];! [/BINARY] [/ENTRIES=[(XXX,YYY)]] [/HEADER] [/CONTINUOUS]1! [/VERSION_LIMIT=xxx] [/BLOCKS=xxx] [/WARNINGS]'! [/NUMBER] [/PID] [/LBN] [/BYTECOUNT])! [/IOSB[=COMBINATION,TEXT,HEX,LONGHEX]]4! [/TIMESTAMP[=ABSOLUTE,ELAPSED,COMBINATION,DELTA]]2! [/FUNCTION[=TEXT,HEX]] [/ACCURATE] [/FDT] LDan:! ! Author:!#! A. Sweep 3-NOV-1986 Version 01.00!! Revision history:!6! Jur van der Burg 30-SEP-1992 Version 02.00!*! - Add support for LD SHOW/ALL qualifier.'! - Add support for LD /LOG qualifiers.3! - Add support for LD CONNECT/ALLOCATED qualifier.0! - Add support for LD DISCONNECT/ALL qualifier.! - Restructure commands!6! Jur van der Burg 16-NOV-1992 Version 02.01!"! - Add support for trace commands!6! Jur van der Burg 23-FEB-1993 Version 03.00!! - Expand trace commands! - Add /BACKUP qualifier!6! Jur van der Burg 14-APR-1993 Version 04.00!! - Add /BLOCKS qualifier ! - Add /VERSION_LIMIT qualifier! - Add /WARNINGS qualifier+! - Convert file for inclusion in DCLTABLES!6! Jur van der Burg 19-OCT-1993 Version 05.00!-! - Add WATCH command and associated switches! - Add [NO]PROTECT command!4! Jur van der Burg 28-OCT-1994 Version 5.1!+! - Add the following switches for CONNECT:>! /SYMBOL, /SHARE, /MAXBLOCKS, /TRACKS, /SECTORS, /CYLINDERS! and /ALLOCLASS@! - Removed from CONNECT: /ALLOCATED (superceeded by /MAXBLOCKS)!3! Jur van der Burg 4-APR-2000 Version 6.3!,! - Add /[NO]FDT and /[NO]ACCURATE for TRACE"! - Add /[NO]CONTIGUOUS for CREATE!!---  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 CONTIGUOUS 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  A||$LD063.A. - [VDBURG.LD.V63.KIT]LDCLD.CLD;1R$ 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 QUALIFIER FDT QUALIFIER ACCURATE DISALLOW (RESET AND ACCURATE) DISALLOW (RESET AND FDT) DISALLOW (RESET AND SIZE) DISALLOW (STOP AND ACCURATE) DISALLOW (STOP AND FDT) 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=$DEVICE) 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 FDT QUALIFIER ACCURATE 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.V63.KIT]LD_DEFINES.H;1+,N./@@ 4@-- 0123KPWO5 6KS78W89G@@HJ*/* 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 LDIO_M_ACCURATE 16384#define LDIO_V_ACCURATE 14#define LDIO_M_FDTTRACE 32768#define LDIO_V_FDTTRACE 15#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]; int elapsed; };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.V63.KIT]MOUNTVER.COM;1+,C../@@ 4D -- 0123KPWO5<6$mb7D1>W89G@@HJ ֹd$LD063.AC.- ![VDBURG.LD.V63.KIT]MOUNTVER.COM;1D  $ 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.V63.KIT]SHADOW_RAM.COM;1+,D../@@ 4`t-- 0123KPWO5 6m97CW89G@@HJE$! 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' {$LD063.A1#5r}mj|Q3UOTES;1P(*Spo}7N$p ].!2OR6,.Ylb*|3fq:'Vr b7d)yEq@0vQ>cpP69tlD_eKf)$UsQFWdGRaXVmj>9S)w7 D:xuG&$x~fggyaT s3&$WyqX=a.;p"}bi+$|D\3Rl8qbEW[/M jFrqTKr~TGSxfSWJ`'2̕6cpex1_j!raw&5L17}b@ 1%T+ApKof|0PYi<PJ#ZN!*8H`/`: hQh#sIme4xb('6xGRF V`Jct,"E](\/ v=n DNjdwSsnluxlM5'|9._NUfQQrT:_"l) 6ljRpXi3p'ei^(Cs+7Q$i@)D1#p}CCgK7 >dLXd_W"F|qt.|NP#365{QRYWl 7>b3'.PnW}JpS ]u;k]Mbn5$>V`BO8A!+i-744 ,qO784_.jS! rb Z'PciLY JT cn|)-#)kX'-.7+n0$!Y8_gm y(~7SujnlFDC2b@IUTbFQKMRr32fE]>*GI#f"2miZWj;9bs\6PyzNU)s:gw`aS`q\qLpI)luA;JbTI #"2$_9JDz irxM|v$f@*7e!7 PwPa=f5u43BDasiSn_";Tped C[=bCA?hf-b5(KP HEEM7rN3yOXy[4{ o_A j|mil#FYIcMZ5"[+Y<}ffm!T-h11+&[tB ]u#v* B&TiKj U!p7B/xD Vfbz52=c-Y_2OD/@r#)nL+1-_S1G{%]KP0?\D3`S:w!KV.K[rJZ`(% n `+x1N*6-b :_V ?[vx$f1[!QF?'UA{8{b 0$)j$ ''8_{%WruJ2aSlkw_2V+J,/++gnE7 uUP_= $n,LOQe"" 9ik_^"/IRi0-#6 VOF{1< { 4hCV0x &6Iw;@7bi#1*Sn{ ]$$,r1v .-AK}UTl E0jh!,\~~$%}(THs%~9E=] e F?xW5Wug^%Zy~;gqhu\o~wl} XDTc4BTWTgLi/:QlV)z +mf]ol5 oEC26*s,wCU>qbOE~vRbZ%oZDG:X1`e3|]N9twO"\XG<Ip>_ZU<IC]1<_bC@y]Pt"UeF\+aqV` 1EYN4fQ?}3.3SjB>M7msY,9Uea#)5^:p).J_,F( 12P|2X1d$Ipvuej*ybvuu(2/rvD"oa]G PH@#aJ^yF:o1P"@+Wtc7wjSV FI4(mMF?qkf?y'&HF8u)[&m@Ap^il9U 'h# h bje|: op%:gTA\ib\gb]Fs*TPbp'ctUkm0 gj?<&?v349kl=#gW@ yy6.vL-LO68kIQU=`q|tw `5O^Sv,hqh 8p0jemz.@K[rlFQ|VChy+-<4A^/bU2!/9ccc+De vU;0ge=.N-6r vZp &(\b=}pHW]QrAhPALC)Ix1(u'JO yy;PuO =Z%<LmKDP\tl#v!GJm\l8=*tQj uNh.FK{&OO32lO/ r&o1B&Q$,=71'uBj} YDG>+J:]em@+l"SSk|'@/}XA (.wj$C5NBwn+);b6d B2Z0JDl+}.,p Z p<ku>.D)!  C,t ^a>bB{ 6] ;0{aOECQP0RY\3uzbp,fA ,;mX;xyYq~QG|~;Fv]X_ 0 4B>c"ikLFS"wR:T/eD cs!PyQF0 ="&`+-h,\a' B1qUxV`uB-rAW1p{i: 7ES\7tT @~kx*'i;0&v%oi)2qnh: 8MF9kgE:egw1-wt kPc "h0>*(E:#@E3. jM/@ y&8:Shhi4!$>ZfbOb5y!;]93Y]l9IAFK}4L^=xlVv<OQWDCs1`vyuBl  u??o$080^w5u~H_/[Fc%3~M4,&04pg_NsyQi?kg% ?jNLUQeN; TSjeN. mpGC 7LN2R2}~ ^,1mB^>i$}6nOo[mc^Y'icz 0.gaNe|rBvyglq$#|mv3yd)4%&|13*yD){: (7l$=@E-W= KO]X|z=bD&{'Dc( r94YLIDWF-QP'7:wl V>;l3PtcO|}jY<aiP$2@G{0k1+7H|2db=V%c+v5"T%R?URe- Qw&F 0L3=`$tleqh>96 "xO>E?~y; W}Zzb+[&dJ`Ctrp\jk1)?NTZASr?*j'mv;;r(nfq}%AwmY-mF] Jd>_)ntQTj OH[]-< x( # Y#VU$yw5(oRI< z)gSm]p%O' --5Hm&GdwahP#" lR}L%C| ,f3C)y&&EN-kgKzRq5^ >LE8aC5&`g|n{omB{ O f5Jo^<^ kxJ_#x&? 13?pu-e$L@B5U -VpeO] =F1hPD-Hjry\{]qMOt]PO"]\k=|E^K"=i%C~uZEss)nY2q[rhn/2s,&:m LY5WqD3iP+oL; T3% l+acF^o K8 R`GfkeR9Tb\wh,=dAGO}!ij|-w[)^8^RxEul59$ )H;jKl~{sJX /OmsPl4|bk0S E~8i' wb_#/.`+u"y]WE})#_^)Ce[ A@73K6q f(HW,;i74F+9X-k0oYX~zKd0fj*^^$=pXQ+Qsz4zJ>dz|Ckj-5U#N Mn RcmlsyQ2`&%aq]~`|/MRW;h *@`io 5=}dP>]M r,`,p5t-2kaK#FVnifyOb<:xy!!6B}'wmvUu2NӐkba-PYS {5 YEd{Jo?&6 Pb/J=jUA'luu@}bbIja,?OoF2ay3Euc5%<*M=! $M#38]7'- K!2! 0E",>HS#?mUze}.>b#CJkc:b>a*Bnmh{<%IBii4=gvf I "ZkkgHOoHmot/Kz#n?>$za5oe6n' wA1t5$f'vo4^!pR6[P/c+~@~/~$5oUk5(Ip-O5j9[ N|P3$ e|S[Va jm+. mPq,q?DF=lP:' m!Va?79*%e(Z( 9Gj(jhN9?Z.j2]N60&xcHD.&_sN4 y5 2:~39 Brcj\)" i6,$\ wK {B5747fsdATz~21!C_BrSP~|*q7.$D;A/VigxT B lhNUs@Tc`6 ia~)S}nj>X\Aw;zn7 z9joT'ArC#ӗ;Ux5= *1`.BmC M9]rckD!m$:HY-{b>tA|w1& :_wKj ^s# /8"@pYd@q #882WW%,/Mc:*9p}t6)a;N4X$|+7#n|]L wZI9`7G,?09zN2xxvbZV[z~ 6MHz # U$o} %4=;eD|=u *XLP#L7n)8!O &LseZ &Nd3:0 ]HJ>^-;n a`s n- t";QX%gq<0wf7| Rvg";t:n`#hljVXpBR_ 688GrZ`6W2:KZkc YT=t% up"S?9:iz>-;w( mzmoORF?T\~/w3U_>vd8$&6u' ;bJeZCD2]P3\"d{)yE + l7Jqט k΁!0I#t\H7#fY9 %t)=V4,N8)B:8]f-duʴ@DmvlLYJn7hmC`uX=-Q V|'F>u%z~+wvXpu Q+pII^Z1-_]!Ub/jGiS|7Y"2*F~`M J .jk[>V ZD=xvBAyCOqZhGV_wlC0 2On $+J rGIVdpPE'4lH'C#{eyBT#%9fDGkuQXK t ut?DcY?}&A1|'8+v% p^ ~0s|H'`({43?CIOS12(TYd+mxKpK}GQ#H)WWT:yRxJEARxJrSK (X;{w=rfh -55kX\FkIwfwH)9NRVDDu Ex_gLe~\h66b)OlnJRO>R2Qtei #@WI'qK:E|> #Fh [l)ISi o2'Md2;u,!s(wo'FIBe'/2B%4ox*[6Re ~tBi)f@~od|OQGBoH's=jzIilk_\!he=}98^B=>Ix8tSD^}_nw=}#`xT;`PH/[WVSg;ISy@Cpz)cv/,Lymlq7IW}3={VP I&:# {ogxlPhz?Ssn})zU~cr<oemHer7)J~+GT asP$F3cf^md1mNQuje DdQ KSF/;_1(2&Q5,3F?jbkt&[xFa#'W-nf Bcn3] r1:E 1B{jI-+&itL.xf~q;i)Y"Tn s~ N9~ wLYmL*d1joLRj"\e:L9 :c. Vq'{dZ@HLfFI13 5?L-o. # XKe1=\]?q,'iRrAMDU=#mB/lv8{1q ZSvXgm)QA?znt#+6E~ @[>'QO0e!FZ4> #Wv2l+s;'(!:c.8  ^F. "$7 HMDe~]N:DH"YZd4xR7 JiZLdt 6bZ`,eOT|~9Uz#Q.B+K44h:~zJIX.+0A{"{@p= +Q}h+g%_h]_xs;AM!G08D#rrpRqHpq&_ShW=)m_{g+(Y MA ?5T:A$ 0PwEPK XZJN.~BKkn^ek5 =$!W*qJh='?~P1`TU{Knx; AjFCW!cE*5qJk} [;i76Vff^Igu`Xa;t?#+{tDtlj2sITLL+zDI#=fA1y_H-g0S>A5Qjn#6=R\*#'*v 6,7-NpI;3P\f }(&??HZ,kq;QZ*Qz$,+@,4'l^RJH"7q)%rN'kV ~jxhf11XW2a"NFON;z K S`#{#%S!em.%(1Ya>2tzFB lwbN#!wAyzrD4BG^42bqq8# QNLLdm> e 5~R^k7#@Is4dR)5S ?MpCFmZ:lKr4Z*dKb U'>~LT w E)opHL*ltsD_xZO6OHHC|DoXHilQ.Q3n \NjdOZrW&alUn@pJn~ ~kJY?[iCN.z(f4v},pp@a:'> H}1*3`hWu"b:mxKQqpaIzz^(/k^"%.dvr!}3#OE0j/Rq{#D {@So%CG1 %u9QkzjWe } JP 4~gRRGc1!L2lsGbGjWTC% )-@mS^A,Kj&DKH&4`eI**Ld>+7^l=R7bzp$>gC[@`{"2TTG[YOYn2v' ]"E|he <LaLZT$ Tyx e21 Bn<1aq\3&a!j@,={r GlF$QM!2C SUP%?FWWKT_'U ZKO6cHucK\=K}A*u9Zd@5z'g4M8p2;o*n8HB@[^iTXFL=~E"U4-X$^l&YWYY{WyIb*`zxe{U{CHE[k"`T4Vs~;_~* !8me]p[.q,="L '6Z[|~YvU*^&|p$|9_,^Rc[QZr n$DZc}1yKy%4J&@RvQTM:m%&}ER0*6:;rm )+ MALLOW (REPLACE