The ACQUIRE (Acquire Resource) command enables an active group to acquire additional resources or to change the TEMPORARY status of already acquired units and controls. For example, you can use this command to dynamically acquire and free domains or to enable and disable requestors from memory.

Many of the forms of the ACQUIRE command cause a brief system pause.

A locking mechanism prevents multiple copies of programs from attempting to use the ACQUIRE (Acquire Resource), CLOSE (Close Pack), FREE (Free Resource), INITIALIZE (Initialize Disk), LB (Relabel Pack), PG (Purge), PG (Purge), and UR (Unit Reserved) commands to access the same device simultaneously. If one of these operations is already in progress when another command is issued to the same device, the command is rejected and the following message is displayed:

  PK <unit> <command entered>
  COMMAND REJECTED BECAUSE ANOTHER COMMAND IS USING THIS UNIT.

If the command is rejected, wait for the current command to complete and enter the command again.

Syntax

────ACQUIRE──┬─CPM─<CPM list>───────────────────────────────┬─────┤
             ├─<unit specification>─────────────────────────┤
             ├─NETPORT ─<device number>─ LINE ID ──<number>─┤
             └─<channel specification>──────────────────────┘

<unit specification>

<channel specification>

──┬─ CHANNEL ─┬─<device number list>─┬───────────────────┬──┤
  └─ CHAN ────┘                      └─ : ─┬─ TEMP ──────┤
                                           ├─ TEMPORARY ─┤
                                           └─ RESERVED ──┘

For other syntax elements, refer to Basic Constructs.

Explanation

ACQUIRE CPM <CPM list>

The system readies the specified CPMs.

<CPM list> is a range of integers from 0–15. In this context, ACQUIRE is a synonym for READY.

ACQUIRE <device type> <unit number list>

Acquires the unit or units identified by the device and unit number list. The system automatically readies the units unless you use the SAVE option.

ACQUIRE <device type> <unit number list> :SAVE

ACQUIRE <device type> <unit number list> :SA

Acquire the units in the saved state that is, the units are acquired and saved in one step.

ACQUIRE <device type> <unit number list> :TEMPORARY

ACQUIRE <device type> <unit number list> :TEMP

Acquire the designated units until the next halt/load of the system. If group reconfiguration does not occur when the system is halt/loaded, each unit reverts to a logically unowned status as a freed device of its partition.

ACQUIRE <device type> <unit number list>:BCV

Acquire the unit as a BCV. This allows a cloned copy to be used on the same system it was created on, to be used by the MIRROR IMPORT and MIRROR MARK commands. You must have a HOST COMPONENT FOR EMC TIMEFINDER key to use those commands. For more information, refer to the Supplemental Disk Software section of the Peripherals Information File.

ACQUIRE NETPORT <device number> LINEID <number>

Acquires the LINEID <number> that is associated with the internal networking port that is identified by the device number. The LINEID number is either 1 or 2, depending on the position of the Ethernet port on which the LINEID depends. This form of the command enables the Ethernet port to be used by networking protocols.

If the LINEID is designated as NEVER ACQUIRE in the Peripheral Configuration Description, the system responds with the following message:

UNABLE TO PERFORM

This message indicates that the system cannot acquire the LINEID.

ACQUIRE CHANNNEL <device number list>

ACQUIRE CHAN <device number list>

Adds the specified channels to the executing partition and makes those paths available for I/O operations.

Examples

Example 1

Before you acquire a unit, you can use the PER (Peripheral Status) command to display the current peripheral status and to determine if the unit is available to a group. In this example, the first PER display shows that magnetic tape (MT) units 82 and 83 are not available to a group. The operator then acquires MT 82.

PER MT =

  -------------------------- MT STATUS ------------------
   21*H      [212121] ST9840 C #1 1:0 <03/05/2008> BACKUP
   82        NOT AVAILABLE TO GROUP
   83        NOT AVAILABLE TO GROUP

  -------------------------- MT STATUS ------------------
   21*H      [212121] ST9840 C #1 1:0 <03/05/2008> BACKUP
   82*H      [E12378] 36TRK  C    S C R A T C H
   83        NOT AVAILABLE TO GROUP
  -------------------------- MT STATUS ------------------
   21*H      [212121] ST9840 C #1 1:0 <03/05/2008> BACKUP
   82*H      [E12378] 36TRK  C    S C R A T C H
   83        SAVED      

ACQUIRE MT 82

  MT82 WILL BE ACQUIRED

This PER display shows that unit 82 was acquired and automatically readied. The operator then acquires MT 83 in the saved state.

PER MT =

       ------------------- MT STATUS -------------------------
       81*P     [000048] 1600 #1 1:0 <07/16/2005> MEMORY/DUMP
       82*P     [MIKE  ] 1600    S C R A T C H
       83       NOT AVAILABLE TO GROUP

ACQUIRE MT 83:SAVE

  MT 83 WILL BE ACQUIRED

This PER display shows that unit 83 was acquired but not readied:

PER MT

       ------------------- MT STATUS -------------------------
       81*P      [000048] 1600 #1 1:0 <07/16/2005> MEMORY/DUMP
       82*P      [MIKE  ] 1600    S C R A T C H
       83*P      SAVED

Example 2

This example acquires a specified channel:

ACQUIRE CHAN 5000

CHAN 5000 WILL BE ACQUIRED

Example 3

The following examples acquire the specified channels:

ACQUIRE CHAN 5000-5001

CHAN 5000 WILL BE ACQUIRED
CHAN 5001 WILL BE ACQUIRED

ACQUIRE CHAN 5000,5001

CHAN 5000 WILL BE ACQUIRED
CHAN 5001 WILL BE ACQUIRED

Considerations for Use

Releasing a Resource

To release a resource from an active group, refer to the FREE (Free Resource) command.

Ready and Saved States

Each module has either a ready or a saved state as described in the following table.

You can use the ACQUIRE command only on a module that has been freed.

Acquiring a Disk Pack Associated with the Mirrored Disk Pooling Facility (MDPF)

When you acquire a disk pack that has been assigned to the free spares pool for a mirrored disk set, the system generates a status change message. When all the members of a mirrored set are brought online as in-use spares, the system generates a status change message for each member. The status change message is defined in the MCP System Interfaces Programming Reference Manual.