(LOGO.JPG) Python for OpenVMS

(go to: table of contents, index, list of vms_sys, prev: MOD_IDENT, next: NUMTIM)


MOUNT - Mount Volume


Mounts a tape or disk volume, or a volume set.


Format:

    vms_sys.mount (itmlst)
Returns:

None

Arguments:

itmlst
Item list specifiying the options for the mount operation.

special notes about some item codes:

MNT$_FLAGS
Must be supplied as a 2-integer tuple. Bitmasks whose names begin with MNT_M_ go into the first integer. Bitmasks whose names begin with MNT2_M_ go into the second integer. The bitmask values are defined in module 'vms_mntdef'.
MNT$_UCS
Is currently not available.

It requires a descriptor containing a Universal Character Sequence (UCS) defined by ISO 2022 and used when mounting an ISO 9660 CD-ROM. This is described in the 'OpenVMS System Manager's Manual'.

MNT$_UNDEFINED_FAT
Internal this is a structure of one word followed by 2 bytes. The interface routine currently requires a Python integer.

Examples:

>>> import vms_sys
>>> import vms_mntdef

>>> l_flags0 = vms_mntdef.MNT_M_MESSAGE   + \
...            vms_mntdef.MNT_M_NOASSIST  + \
...            vms_mntdef.MNT_M_NOREBUILD + \
...            vms_mntdef.MNT_M_SYSTEM
>>> l_flags1 = vms_mntdef.MNT2_M_SUBSYSTEM
>>> q_flags = (l_flags0,l_flags1)

>>> itmlst = ( \
...  ('MNT$_DEVNAM',  'DKA0:'),
...  ('MNT$_FLAGS',    q_flags),
...  ('MNT$_LOGNAM',  'DISK0_DEVNAM'),
...  ('MNT$_VOLNAM',  'D0')      # label
...  )
>>> vms_sys.mount(itmlst)
{'status': 1}
>>>
>>> vms_sys.getmsg(1)
('%SYSTEM-S-NORMAL, normal successful completion', (0, 0, 0, 0))
>>>


>>> vms_sys.mount(itmlst)
{'status': 7471212}
>>> vms_sys.getmsg(7471212)
('%MOUNT-F-DEVMOUNT, device is already mounted', (0, 0, 0, 0))
>>>


>>> vms_sys.dismou ('DKA0:')
>>> itmlst = ( \
     ('MNT$_DEVNAM',  'DKA0:'),
     ('MNT$_FLAGS',    q_flags),
     ('MNT$_LOGNAM',  'DISK0_DEVNAM'),
     ('MNT$_VOLNAM',  'DX')      # wrong label
     )
>>> vms_sys.mount(itmlst)
>>> vms_sys.getmsg(7471372)
('%MOUNT-F-INCVOLLABEL, incorrect volume label', (0, 0, 0, 0))
>>>


@@ MOUNT - more examples, text
>>>

(go to: table of contents, index, list of vms_sys, prev: MOD_IDENT, next: NUMTIM)

17-JAN-1999 ZE.