Marc's Place

1  ALLOCATE
   Provides your process with exclusive access to a device until
   you deallocate the device or terminate your process. Optionally
   associates a logical name with the device.

   Requires read (R), write (W), or control access.

   Format

     ALLOCATE  device-name[:][,...] [logical-name[:]]
 

2  Parameters
 

device-name[:][,...]

   Specifies the name of a physical device or a logical name that
   translates to the name of a physical device. The device name
   can be generic: if no controller or unit number is specified,
   any device that satisfies the specified part of the name is
   allocated. If more than one device is specified, the first
   available device is allocated.
 

logical-name[:]

   Specifies a string of 1 to 255 alphanumeric characters. Enclose
   the string in single quotation marks (' ')  if it contains
   blanks. Trailing colons (:)  are not used. The name becomes a
   process logical name with the device name as the equivalence
   name. The logical name remains defined until it is explicitly
   deleted or your process terminates.
 

2  Qualifiers
 

/GENERIC

      /GENERIC
      /NOGENERIC (default)

   Indicates that the first parameter is a device type rather than a
   device name. Example device types are: RX50, RD52, TK50, RC25,
   RCF25, and RL02. The first free, nonallocated device of the
   specified name and type is allocated.

   The /[NO]GENERIC qualifier is placed before the device-name
   parameter in the ALLOCATE command line. For example, you can
   allocate an RK07 device by entering the following command at the
   DCL prompt ($):

   $ ALLOCATE/GENERIC RK07 DISK

   The following table shows some device types that you can specify
   with the /GENERIC qualifier. To see what devices are available,
   refer to your SPD for the OpenVMS version they are currently
   using,

                       Devices by Classification

                              Disk Devices

   EF51       EF52      EF53       EF54      EF58
   ESE20      ESE25     ESE52      ESE56     ESE58
   EZ31       EZ31L     EZ32       EZ32L     EZ33
   EZ33L      EZ34      EZ35       EZ51      EZ52
   EZ53       EZ54      EZ56R      EZ58      HSZ10
   HSZ15      HSZ20     HSZ40      ML11      RA60
   RA70       RA71      RA72       RA73      RA80
   RA81       RA82      RA90       RA92      RAH72
   RB02       RB80      RC25       RCF25     RD26
   RD31       RD32      RD33       RD51      RD52
   RD53       RD54      RF30       RF31      RF31F
   RF32       RF35      RF36       RF37      RF70
   RF71       RF72      RF73       RF74      RF75
   RFF31      RFH31     RFH32      RFH35     RFH72
   RFH73      RK06      RK07       RL01      RL02
   RM03       RM05      RM80       RP04      RP05
   RP06       RP07      RP07HT     RX01      RX02
   RX04       RX18      RX23       RX23S     RX26
   RX33       RX33S     RX35       RX50      RZ01
   RZ13       RZ14      RZ15       RZ16      RZ17
   RZ18       RZ22      RZ23       RZ23L     RZ24
   RZ24L      RZ25      RZ25L      RZ26      RZ26B
   RZ26L      RZ26M     RZ27       RZ27B     RZ27L
   RZ28       RZ28B     RZ28L      RZ29      RZ29B
   RZ31       RZ34L     RZ35       RZ35L     RZ36
   RZ36L      RZ37      RZ38       RZ55      RZ55L
   RZ56       RZ56L     RZ57       RZ57I     RZ57L
   RZ58       RZ59      RZ72       RZ73      RZ73B
   RZ74       RZ74B     RZ75       RZ75B     RZF01

                          Compact Disk Devices

   RRD40      RRD40S    RRD42      RRD43     RRD44
   RRD50      RV20      RV60       RV80      RW504
   RW510      RW514     RW516      RWZ01     RWZ21
   RWZ31      RWZ51     RWZ52      RWZ53     RWZ54



                              Tape Devices

   TA78       TA79      TA81       TA85      TA86
   TA87       TA90      TA90E      TA91      TAD85
   TAPE9      TD34      TD44       TE16      TF30
   TF70       TF85      TF86       TK50      TK50S
   TK60       TK70      TK70L      TKZ09     TKZ60
   TL810      TL820     TLZ04      TLZ06     TLZ07
   TLZ6       TLZ7      TM32       TS11      TSZ05
   TSZ07      TSZ08     TU45       TU56      TU58
   TU77       TU78      TU80       TU81      TZ30
   TZ30S      TZ85      TZ857      TZ86      TZ865
   TZ867      TZ87      TZ875      TZ877     TZ88
   TZ885      TZ887     TZ89       TZ895     TZ897
   TZK10      TZK11     TZX0
 

/LOG

      /LOG (default)
      /NOLOG

   Displays a message indicating the name of the device allocated.
   If the operation specifies a logical name that is currently
   assigned to another device, then the superseded value is
   displayed.
 

2  Examples

   1.$ ALLOCATE  DMB2:
     %DCL-I-ALLOC, _DMB2: allocated

     The ALLOCATE command in this example requests the allocation of
     a specific RK06/RK07 disk drive, that is, unit 2 on controller
     B. The system response indicates that the device was allocated
     successfully.

   2.$ ALLOCATE  MT,MF:   TAPE:
     %DCL-I-ALLOC, _MTB2: allocated
     .
     .
     .
     $ SHOW LOGICAL TAPE:
     TAPE: = _MTB2:    (process)
     $ DEALLOCATE TAPE:
     $ DEASSIGN TAPE:

     The ALLOCATE command in this example requests the allocation
     of a tape device whose name begins with MT or MF and assigns
     it the logical name TAPE. The ALLOCATE command locates an
     available tape device whose name begins with MT, and responds
     with the name of the device allocated. (If no tape device
     beginning with MT had been found, the ALLOCATE command would
     have searched for a device beginning with MF.) Subsequent
     references to the device TAPE in user programs or command
     strings are translated to the device name MTB2.

     When the tape device is no longer needed, the DEALLOCATE
     command deallocates it and the DEASSIGN command deletes the
     logical name. Note that the logical name TAPE was specified
     with a colon on the ALLOCATE command, but that the logical name
     table entry does not have a colon.

   3.$ ALLOCATE/GENERIC RL02 WORK
     %DCL-I-ALLOC, _DLA1: allocated
     %DCL-I-SUPERSEDE, previous value of WORK has been superseded

     The ALLOCATE command in this example requests the allocation
     of any RL02 disk device and assigns the logical name WORK to
     the device. The completion message identifies the allocated
     device and indicates that the assignment of the logical name
     WORK supersedes a previous assignment of that name.

   4.$ ALLOCATE $TAPE1
     %DCL-I-ALLOC, _MUA0: allocated

     The ALLOCATE command in this example allocates the tape device
     MUA0, which is associated with the logical name $TAPE1.

   5.$ ALLOCATE /GENERIC RX50 ACCOUNTS

     The ALLOCATE command in this example allocates the first free
     floppy disk drive and makes its name equivalent to the process
     logical name ACCOUNTS.

---

© 1997- Marc Vos (and others)   -   Privacy Statement   -    Contact Me

On this website, Google Analytics is used to track visitor statistics. These are anonymised data about the number of visitors, which pages they visit on this site, from which regions they visit, which web browsers they use, etc.. You will also see non-personalised ads via Google AdSense. Cookies from Paddle or Paypal are placed when you click on a 'Buy now!' or 'Donate!' button, and possible cookies from Disqus when you use that system to comment on one or more blogposts.
Privacy Statement

Dismiss