(LOGO.JPG) Python for OpenVMS

(go to: table of contents, index, list of vms_sys, prev: IDTOASC, next: MOD_HOLDER)


INIT_VOL - Initialize Volume


Formats a disk or magnetic tape volume.


Format:

    dict = vms_sys.init_vol (devnam, volnam [,itmlst])
Returns:
dict
A dictionary that has the following keys:
'status'
the condition value returned from SYS$INIT_VOL.
Arguments:
devnam
Name of the device on which the volume is physically mounted.
volnam
Volume identification (label).
itmlst
Item list specifiying the options for the init_vol operation.

special notes about some item codes:

INIT$_BADBLOCKS_LBN
Must be supplied as a tuple of 2-integer tuples.
On OpenVMS VAX V6.1 it was not possible to specify more than one (LBN,count) combination. As this item code is unlikely to be used very often this issue has been put aside for the moment (24-JAN-1999).
INIT$_BADBLOCKS_SEC
Must be supplied as a tuple of 4-integer tuples. Has not been tested. The same limitation as INIT$_BADBLOCKS_LBN might be there.

Examples:

>>> import vms_sys

>>> vms_sys.init_vol ('VDA0:','LBL',(('INIT$_CLUSTERSIZE',7),))
{'status': 1}
>>>

>>> vms_sys.init_vol ('VDA0:','LBL',
...  (
...   ('INIT$_CLUSTERSIZE',1),
...   ('INIT$_ERASE')
...  )
...  )
>>>

>>> vms_sys.init_vol ('VDA0:','LBL',
...  (
...   ('INIT$_BADBLOCKS_LBN', ((30,1),(40,2)) ),
...   ('INIT$_CLUSTERSIZE'  , 1)
...  )
...  )
{'status': 20}

---------------

>>> vms_sys.init_vol ('VDA0:','LBL',(('INIT$_CLUSTERSIZE',7),))
%INIT-F-NOVOLPRO, operation requires VOLPRO privilege
{'status': 276113580}
>>>

@@ INIT_VOL - more examples, text
>>>

(go to: table of contents, index, list of vms_sys, prev: IDTOASC, next: MOD_HOLDER)

17-JAN-1999 ZE.