Use the MAINT command to allow users to make directory changes for their own directory entries, and to allow directory managers to define, modify, and manage directory entries.
MAINT {"Parms"}
Parms:
Account newacct [NEXTLOG | TEMP | IMMED]
| DEFine oldvaddr newvaddr
| Delete vaddr
| DIstrib newdist
| Help | ?
| Ipl [sysname | vaddr ] [PARM parameters]
| Link ownerid vaddr1 vaddr2 [ mode]
| MACHINE [370 | XA | ESA | XC]
| Manage entry subfunction
| MDpw [vaddr]
| MGrid
| Minidisk vaddr
| Option attribute {ON | OFF}
| Password
| Review
| RLink vaddr
| SCratch vaddr
| Storage {sizeK | sizeM}
| Terminal symbolname {ON | OFF | char | hex}
To perform user functions on your own user ID, you must have MAINT subfunction authorization through a GRANT MAINT subfunction record in the AUTHORIZ CONFIG file, where subfunction is the specific subfunction you want to use.
To perform user functions on another user ID, you must have MAINTMAN userid USER subfunction authorization through a GRANT MAINTMAN userid USER subfunction record in the AUTHORIZ CONFIG file, where subfunction is the specific subfunction you want to use.
To perform management functions, you must have MAINTMAN userid subfunction authorization through a GRANT MAINTMAN userid subfunction record in the AUTHORIZ CONFIG file.
Changes your primary account number. If CA VM:Director is interfaced with VM:Account, CA VM:Director allows only immediate (IMMED) changes to account numbers. Otherwise, NEXTLOG is the default.
When issuing the MAINT MANAGE command to change a user’s account number, CA VM:Director must have OPTION D84NOPAs in its directory entry if the directory has any user IDs that have the special password of LBYONLY. Failing to have this authorization can result in errors and the command outcome can be unpredictable.
Changes the virtual address of one of your minidisks from oldvaddr to newvaddr. CA VM:Director updates directory links to oldvaddr to reflect the new virtual address. Minidisk passwords for the minidisk remain unchanged.
Deletes the directory link to the minidisk at vaddr.
Changes the distribution code associated with your spooled output to newdist.
Displays a brief list of the MAINT command functions and their operands. HELP is the default if you do not enter a function.
Changes the entire content of your IPL statement. The variable sysname is the system to IPL at logon. The variable vaddr is the virtual device address of the device to IPL at logon. If no values follow IPL, CA VM:Director removes any existing IPL statement from your directory entry.
Defines a directory link to another user’s minidisk. Directory links are performed for you at logon. To define a directory link, you must specify the minidisk password for the ownerid’s minidisk (vaddr1) and specify a virtual address (vaddr2) not used by your virtual machine. You can specify the link mode to use through mode, or use the default mode "R".
Switches your MACHINE architecture between the available options. The default is determined by the setting in the VMDIRECT GLOBALS file.
For directory managers; defines USER or IDENTITY directory entries or manages existing USER, IDENTITY, or SUBCONFIG entries. You can manage only one entry per session and cannot manage your own directory entry. When you use this parameter you are placed in a VM READ state, from which you can enter one of the MAINT MANAGE command subfunctions listed below.
|
MAINT MANAGE subfunction |
Purpose |
|---|---|
|
? |
Displays the MAINT MANAGE subfunctions |
|
ACTIVATE |
Activates a USER entry that is on hold and enables any file spaces in all file pools that CA VM:Director controls |
|
COMMENTS |
Invokes XEDIT to edit comment records in a user directory entry |
|
DISKMOVE [vaddr] |
Moves a minidisk in a USER, IDENTITY, or SUBCONFIG directory entry to a new location; the default virtual address is 191 |
|
END |
Terminates the MAINT MANAGE function and returns control to CMS |
|
HOLD |
Places an existing USER directory entry on hold and disables any user file spaces in all file pools that CA VM:Director controls |
|
NEWDISK [vaddr] |
Defines and optionally formats a new minidisk in a USER, IDENTITY, or SUBCONFIG directory entry; the default virtual address is 191 |
|
NEWUSER |
Creates a USER or IDENTITY entry and optionally enrolls the user in file pools that CA VM:Director controls. You can identify a sample PROFILE EXEC file to copy to the 191 minidisk or top‑level directory by placing the *SP= special comment in the skeleton or input file. If a sample profile is available or specified on a *SP= special comment, that profile is copied to the top‑level directory for the user as PROFILE EXEC. If there is already a PROFILE EXEC file in the user’s top‑level directory, a sample profile specified on a *SP= special comment is not copied. |
|
REMOVE |
Removes a USER or IDENTITY entry from the directory and deletes any user file spaces from all file pools that CA VM:Director controls. With this subfunction, when the command deletes a minidisk that is on a pack that is under CA VM:Director control, CA VM:Director deletes links to the deleted that minidisk from the directory. An IDENTITY entry can only be removed if it has no BUILD statements. |
|
REVIEW |
Invokes XEDIT to display a directory entry |
|
SCRATCH [vaddr] |
Removes and formats a minidisk from a USER, IDENTITY, or SUBCONFIG directory entry; the default virtual address is 191. With this subfunction, when the command deletes a minidisk that is on a pack that is under CA VM:Director control, CA VM:Director deletes links to that deleted minidisk from the directory. |
|
USER parameters |
Invokes the MAINT subfunctions for the directory entry being managed by the MAINT MANAGE function |
Displays the passwords for your minidisks. If vaddr is not specified, the command displays passwords for all your minidisks. Passwords may be masked at your site.
Displays the user ID of your directory manager.
Prompts you for a new link mode and read, write, or multiple passwords for your minidisk at virtual address vaddr. If you enter a null at a prompt, CA VM:Director sets all values that were not previously set to nulls. The values can include link mode, read password, write password, and multiple write password.
Selects (ON) or removes (OFF) various attributes, specified by attribute, associated with your user ID.
Changes your logon password. If you are using traditional passwords, you may change your password to anything that does not include spaces, a left or right parenthesis, or one of the IBM reserved passwords.
Creates a read‑only XEDIT session of all directory control statements in your directory entry. It provides information you need for the DEFINE, DELETE, LINK, MINIDISK, MDPW, RLINK, and SCRATCH functions, such as existing directory links and all virtual addresses associated with your user ID.
Reviews and optionally removes any directory links that other users may have defined to your minidisk at virtual address vaddr. This function is particularly useful when you determine that data on your minidisk should no longer be shared with other users. Review any existing directory links to determine if the user still has access to your minidisk.
Deletes your minidisk at virtual address vaddr. CA VM:Director automatically removes directory links to the minidisk being scratched from other users’ directory entries.
Changes the amount of virtual storage your user ID is set up with at logon. Virtual storage can be modified after logon with the CP DEFINE STORAGE command.
Selects or removes values for various line editing symbols associated with your user ID. ON with a symbol name selects the default character to use for that line editing symbol; a character (char) or a hexadecimal value (hex) with a symbol name uses that character or hexadecimal value for that line editing symbol. OFF with a symbol name removes that line editing symbol. Changeable line editing symbols are:
Some forms of the MAINT command depend on line‑mode interaction with the issuing user ID.
Valid replies to prompts are documented in Message Reference Guide.
If you prefer a full‑screen interface for management functions, use the MANAGE command. If you want to use commands that do not require interaction with the issuing user ID, use the API commands.
Note:
|
Copyright © 2014 CA.
All rights reserved.
|
|