TRANSFER Command

Reference Guide › Command Reference › TRANSFER Command

TRANSFER Command

Use the TRANSFER command to transfer a minidisk from one directory entry to another. Either directory entry may have type USER, IDENTITY, or SUBCONFIG.

TRANSFER  oldentry oldvaddr newentry newvaddr

Definitions

oldentry

Identifies the directory entry containing the minidisk to transfer.

oldvaddr

Identifies the virtual address of the minidisk to transfer.

To change only the virtual device address of the minidisk, specify the same user ID for oldentry and newentry.

newentry

Identifies the directory entry receiving the transferred minidisk.

newvaddr

Identifies the new virtual address to assign to the minidisk under the new owner.

Description

The TRANSFER command transfers ownership of a minidisk from one user ID to another or changes just the virtual device address of a minidisk.

CA VM:Secure automatically updates all directory links to the old minidisk to point to the new minidisk. It removes any pre‑existing directory links to the new minidisk. CA VM:Secure transfers minidisk passwords with the minidisk.

You cannot use the TRANSFER command to transfer a user ID and minidisk defined on an IGNORE record in the DASD CONFIG file.

Return Codes and Error Messages

The following table lists return codes and error messages for the TRANSFER command.

Return Code	Message Number	Text
0	none	TRANSFER command completed normally
24	0038E	MISSING PARAMETER
24	0304E	ADDRESS vaddr IS AN INVALID DEVICE ADDRESS
24	0309E	DEVICE newvaddr IS A [T‑DISK \| V‑DISK]
24	0311E	DEVICE vaddr IS NOT A MINIDISK
24	0355E	USER newuserid ALREADY HAS A newvaddr DEVICE
28	0356E	USER userid DOES NOT EXIST
28	0334E	MINIDISK vaddr DOES NOT EXIST
40	0310E	DEVICE vaddr IS AN IGNORED MINIDISK
80	0466E	SCRATCH EXIT INDICATES MINIDISK vaddr MAY NOT BE REMOVED
80	0506E	olduserid NOT ALTERED. REFERENCED IN PROFILES: profname1 profname2 ...

Examples

To transfer the CLIFFC 193 minidisk to user ID TESTID as the TESTID 191 minidisk, enter:
```
vmsecure transfer cliffc 193 testid 191
```
To change the virtual address of the FINANCE 191 minidisk to 194, enter:
```
vmsecure transfer finance 191 finance 194
```
To change the virtual device address of the FRED 391 minidisk to 222:
```
vmsecure transfer fred 391 fred 222
```

Note: For information about defining minidisks that cannot be transferred, see the IGNORE Record.