Using ADDMDISK with Macros

Reference Guide › Command Reference › ADDMDISK Command › Using ADDMDISK with Macros

Using ADDMDISK with Macros

The ADDMDISK command stacks a record for use by the calling macro when it successfully allocates the new minidisk if a CA VM:Director macro calls the ADDMDISK command. The stacked record is in last‑in/first‑out (LIFO) order and contains all the information necessary to build an MDISK record. The stacked record has the following format:

vaddr devtype start size volser linkmode rpw wpw mpw

The start and size values are in blocks for FBA and cylinders for CKD devices.

If another CA VM:Director macro does not call ADDMDISK, CA VM:Director does not stack any record.

For security reasons, the ADDMDISK command will remove pre‑existing LINK statements from user directory entries that link to the newly created minidisk.

Examples

To allocate and format a 291 minidisk for user ID BOBBY from subpool MAIN with a size of 10 cylinders and read/write access, enter:
```
vmdirect addmdisk bobby 291 main 10 3380 * * mr
```
To allocate and format a 291 minidisk for user ID BOBBY from subpool MAIN with a size of 10 512‑byte blocks and read/write access, enter:
```
vmdirect addmdisk bobby 291 main 10 * * * mr
```
To allocate but not format a 2‑cylinder minidisk at virtual address 391 on a 3390 for user ID BOBBY from the default subpool of BOBBY’s manager, enter:
```
vmdirect addmdisk bobby 391 * 2 3390 * * mr (noformat
```

Return Codes and Error Messages

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

Return Code	Message Number	Text
2	0127E	USER userid1 EXCEEDED USER userid2 type PASSWORD LIMIT [FOR vaddr]
4	0038E	MISSING PARAMETER
6	0531E	PARAMETER userid IS TOO LONG
8	0265E	NOT AUTHORIZED FOR authorization words
10	0349E	PASSWORD IS INCORRECT
12	0080E	USER userid DOES NOT EXIST
14	0632E	MANAGER mgrid WAS NOT FOUND IN THE MANAGERS FILE
16	0040E	TOTAL ALLOCATION LIMIT OF number EXCEEDED
18	0632E	MANAGER mgrid WAS NOT FOUND IN THE MANAGERS FILE
20	0382E	USER userid IS ON HOLD
22	0621E	UNEXPECTED RETURN CODE code FROM OPEN
23	0304E	ADDRESS vaddr IS AN INVALID DEVICE ADDRESS
25	0531E	PARAMETER vaddr IS TOO LONG
26	0313E	DEVICE device DOES NOT EXIST
28	0634E	DIRECTORY PROFILE LINKS ALREADY EXIST FOR DEVICE device
30	none	non‑zero return code from DIRECT_PRFLINKS
32	0635E	YOU ARE NOT A MANAGER AND HAVE NO SUBPOOLS THAT YOU ARE AUTHORIZED TO USE
33	0636E	ANYPOOL AUTHORIZATION IS REQUIRED TO ALLOCATE FROM SUBPOOL subpool
34	0637E	THE MINIDISK SIZE size MUST BE AN INTEGER NO LONGER THAN 7 DIGITS
35	0043E	SUBPOOL subpool IS UNDEFINED
36	0638E	A MINIDISK SIZE OF 0 IS NOT ALLOWED
37	7016E	INVALID NUMBER OF BLOCKS number
38	0547E	INVALID DEVICE TYPE devtype (not found in table)
40	0547E	INVALID DEVICE TYPE devtype (not CKD or FBA type)
41	0639E	YOU ARE NOT AUTHORIZED TO ADD A CACHE’d DEVICE
42	0640E	THE parm PARAMETER MAY NOT BE SPECIFIED FOR A MINIDISK ON T‑DISK \| V‑DISK
44	0531E	PARAMETER volser IS TOO LONG
52	0637E	THE MINIDISK SIZE size MUST BE AN INTEGER NO LONGER THAN 7 DIGITS
54	0574E	CANNOT SPECIFY MINIDISK LOCATION WITHOUT VOLSER
58	0640E	THE MODE PARAMETER MAY NOT BE SPECIFIED FOR A MINIDISK ON T‑DISK \| V‑DISK
60	0642E	THE SPECIFIED LINK MODE mode IS INVALID
61	0531E	PARAMETER password IS TOO LONG
62	0640E	THE PASSWORD PARAMETER MAY NOT BE SPECIFIED FOR A MINIDISK ON T‑DISK \| V‑DISK
65	0383I	FROM EXIT: (MDISK userexit)
66	none	non‑zero return code from DIRECT_QALLOC
67 (CA VM:Secure only)	none	non‑zero return code from PENCRYPT
68	0643E	EXTRA PARAMETERS parameters WERE ENTERED AND ARE NOT ALLOWED
70	0644E	NOWAIT OPTION SPECIFIED BUT THE SERVANT FACILITY IS NOT ACTIVE
71	0648E	THE NOWAIT OPTION MAY NOT BE SPECIFIED WITH THE STACK OR FILE OPTIONS
72	0553E	YOU ARE NOT AUTHORIZED TO SKIP FORMATTING
73	0645E	A VALUE IS REQUIRED FOLLOWING THE option OPTION
74	0646E	THE SPECIFIED BLOCKSIZE size IS INVALID
75	0531E	PARAMETER label IS TOO LONG
76	0018E	INVALID OPTION option
77	0698E	THE option OPTION MAY NOT BE SPECIFIED WITH THE option OPTION
78	0647E	THE WAIT AND FORMAT OPTIONS MAY NOT BE SPECIFIED FOR A MINIDISK ON T‑DISK
79	0677E	devtype MUST BE SPECIFIED; NO DEFAULT DEVTYPE FOR MANAGER userid
80	0364E	FILE filename filetype IS BEING UPDATED
81	0221E	MISSING PAVALIAS OPTION OPERAND
88	none	non‑zero return code from DIRECT_OBTAIN
90	0209E	BLOCKSIZE 800 IS NOT SUPPORTED ON FB‑512 DEVICES
91	0209E	BLOCKSIZE 800 IS NOT SUPPORTED ON FB‑512 DEVICES
95	none	non‑zero return code from DIRECT UPDATE
96	none	non‑zero return code from MAN000S0
98	none	non‑zero return code from MAN000R0

Note:

For explanations of the message routing and disconnect options, see Common API Command Options.
For NOFORMAT authorizations, see the Authorizations for Command Processing table in the chapter "Authorizations" of the Administration Guide.
For more information about the EXPLICIT attribute, see SUBPOOL Record.
For complete descriptions of all messages listed in this section, see the Message Reference Guide.