The LB (Relabel Pack) command changes the family name, the volume serial number, the capacity, or the name of the owner of a pack, but does not affect any files on the pack. However, changing the volume serial number of a member of a multipack family is not permitted.

A unit cannot be relabeled if the disk pack is not ready or has any files open when the command is entered. A disk pack assigned to the spare disk pool for the Mirrored Disk Pooling Facility (MDPF) cannot be relabeled unless you respond OK to the RSVP message that appears.

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

<relabel pack>

Explanation

LB PK <unit number>

LB DK <unit number>

Relabel the pack or disk specified by the unit number.

If you attempt to label a pack that has been scratched, you receive the following message:

PKnn IS A SCRATCH PACK, PACK MUST BE RC'ED

Once a pack has been scratched, it must be reconfigured using the RC (Reconfigure Disk) command before it can be brought on line.

CAPACITY <integer> MB

CAPACITY <integer> GB

CAPACITY LIKE PK <unit number>

CAPACITY FULL

For supported system models and disk models, changes the disk capacity to the specified size, where

At the completion of the command, the following message is displayed on the ODT. This message tells the user that the capacity of the specified unit was changed:

PK <number> RESIZED TO <number> SECTORS (<number> BYTES)

When the CAPACITY parameter is used, the only other parameter that can be specified is OLDNAME. Any other combinations are rejected.

If you use the CAPACITY option on a system that does not support this feature, the following message is displayed:

INVALID MACHINE TYPE

If you use the CAPACITY option for a disk unit that does not support this feature, the following message is displayed:

INVALID DISK TYPE

FAMILY

Initiates a process to update the labels of all the family members of the family corresponding to the PK <unit number> in the command. The process locates all the online members of the family and then updates their labels. If some of the members of the family are offline, the process does not update those labels.  An online member is a pack that is either ready, or has been saved since the most recent halt/load. You can use FIND PK NAME <familyname> to find all online members. The unit number specified in the command must identify an online member that is not saved.

You can use the FAMILY specification to change the NAME of all the disks in a family with one command.

NAME = <family name>

Assigns the family name to the pack. TAPE and DISKPACK are illegal values for <family name> and are rejected. If no NAME option is specified, the original family name is assigned by default. The equal sign (=) is optional.

OLDNAME = <family name>

Specifies the family name of the pack to be changed or relabeled. If the command does not specify OLDNAME, an RSVP message asks you to confirm that this is the right pack. The waiting entry message is

<mix number> PK <pack number> is [<serial number>] <pack name>
<mix number> ACCEPT: OLDNAME = <pack name>

The reply must be

<mix number> AX OLDNAME = <pack name>

The pack name entered is then compared with the pack name in the pack label. If there is a mismatch, the task is terminated with the following error message:

PKnn INCORRECT OLDNAME ENTERED - RC/PG/LB NOT DONE

The OWNER identification is verified before the OLDNAME.

OWNER = <name>

Specifies the owner identification to be assigned. The name must be from 1 to 14 characters long. If <name> contains special characters or blanks, it must be enclosed in quotation marks. If OWNER is not specified, and either the Owner field in the old disk pack label is blank or the pack is new, the field is filled with blanks. If the disk pack has a nonblank owner identification, a message is displayed. You must verify the request by entering a <mix number> OK command. To remove the OWNER attribute, reconfigure or relabel the disk pack with the option OWNER="" specified—two sets of quotation marks indicate a null string. The equal sign (=) is optional; either of the following is valid:

OWNER <name>
OWNER = <name>

SERIAL = <number>

Specifies the volume serial number to be used. The number must be in the range 1 through 999999. The equal sign (=) is optional. If the serial number you specify matches an existing online serial number, the system displays the following message:

PKnn [<number>] DUPLICATE SERIALNO

As a result of this condition, the system leaves the unit offline with a LABEL ERROR condition.

If you do not specify this option, the system assumes that the original serial number—the default—is to be used.

If you attempt to change the volume serial number of a pack that belongs to a multipack family, the system terminates the LB process and displays the following error message:

LB SERIAL NO OF MULTI-PACK FAMILY IS DISALLOWED.

Examples

Example 1

The following LB command assigns the name JD to the pack with unit number 66 and owner identification JOHNDOE:

LB PK66 NAME = JD, OWNER = JOHNDOE

Because this command does not specify the old name of the pack (JOHN), the system requires you to verify that it is the correct pack.

If you enter a W (Waiting Mix Entries) command, or have previously requested automatic display of current system status information with an ADM (Automatic Display Mode) command, the system displays the waiting entries, as shown in this example:

  ---Mix-Pri-Elapsed------ 1 WAITING ENTRY ------------
    2273  50   17:02 JOB LB PK66
          ACCEPT: OLDNAME = JOHN

If the reply is 2273DS, the job terminates.

If the reply is 2273AX OLDNAME = JOHN, the labeling process can proceed.

Example 2

This example extends the capacity of PK 3104 to 5 gigabytes without affecting the data files:

LB PK 3104 OLDNAME=DISK1 CAPACITY=5 GB

Example 3

This example shows how to change the NAME of all the disks in a family with one command. The base pack is saved prior to the operation to make sure that no family members are in use. PK 80 is the base pack for family X. PK 81 is one of the continuation members of the family.

SV PK 80
LB PK 81 OLDNAME = X, NAME = Y, FAMILY
RY PK 80

Considerations for Use

When you attempt to relabel a disk assigned to the spare disk pool for the Mirrored Disk Pooling Facility (MDPF), the following RSVP message appears:

  PK<pack number> IS CURRENTLY DESIGNATED AS A SPARE FOR
  MIRROR REPLACEMENT. ENTER OK TO CONTINUE WITH LABEL,
  DS TO QUIT. OK WILL REMOVE THE PACK FROM THE SPARE DISK
  POOL.
  REPLY: OK,DS

If you respond OK, the designated family name is assigned to the pack, the disk is removed from the spare disk pool, and a status change message is generated for the disk. The status change message is defined in the MCP System Interfaces Programming Reference Manual. The following message is displayed, confirming that the label has been changed:

PK <unit number> UNIT LB'ED AND REMOVED FROM THE SPARE DISK POOL

If you respond DS, the following message confirms that the disk pack remains in the spare disk pool:

PK <pack number> IS A SPARE FOR MIRROR REPLACEMENT.
RC/LB/PG NOT DONE

When you attempt to relabel a disk assigned to the spare disk pool on a system that does not have the Mirrored Disk Pooling Facility (MDPF) installed, the following RSVP message appears:

  PK<pack number> IS CURRENTLY DESIGNATED AS A SPARE FOR
  MIRROR REPLACEMENT, A FEATURE NOT ENABLED ON THIS
  MACHINE. ENTER OK TO CONTINUE WITH LB, DS TO QUIT.
  OK WILL REMOVE THE PACK FROM THE SPARE DISK POOL.
  <mix number> REPLY: OK, DS

If you respond OK, the designated family name is assigned to the pack and the disk is removed from the spare disk pool. The following message is displayed, confirming that the label has been changed:

PK <unit number> UNIT LB'ED AND REMOVED FROM THE SPARE DISK POOL.

If you respond DS, the following message confirms that the disk pack remains a free spare in the spare disk pool:

PK <pack number> IS A SPARE FOR MIRROR REPLACEMENT.
RC/LB/PG NOT DONE

If your system does not support MDPF, relabeling a disk removes the disk from the spare disk pool and no message appears.