VMS Help DCE_SECURITY, Admin Intro, DCE$EXPORT, EXPORT *Conan The Librarian (sorry for the slow response - running on an old VAX) |
The EXPORT command is used to create OpenVMS accounts in the OpenVMS system authorization file (SYSUAF) based on existing accounts in the DCE registry. Format: EXPORT DCE-ACCOUNT-NAME Qualifiers Defaults /[NO]ADD_IDENTIFIERS /ADD_IDENTIFIERS /[NO]CONFIRM /DCE_LOGIN=(keyword=value[,...]) /[NO]EXCLUDE /NOEXCLUDE /[NO]INFORM /INFORM /[NO]INTERACTIVE /INTERACTIVE /OUTPUT[=output] /OUTPUT=SYS$OUTPUT: /[NO]RECAP /NORECAP /[NO]TEST_ONLY /NOTEST_ONLY /[NO]WILD /WILD Data Qualifiers Defaults /[NO]ACCOUNT=account /ACCOUNT=dce-group-name /DEVICE=device Taken from /LIKE account /DIRECTORY=directory /DIRECTORY=vms-username /GROUP_UIC=group_uic /LIKE=vms-account /LIKE=DEFAULT /MEMBER_UIC=member_uic Next available within UIC group /[NO]OWNER=owner /OWNER=dce-principal-name /PASSWORD=passwd None /[NO]QUOTA=n /QUOTA=1000 /USERNAME=username /USERNAME=dce-principal-name
1 - Parameters |
dce-account-name Specifies the name of the DCE account that is to be exported. If the DCE account name contains lowercase characters, spaces or other special characters then enclose the name in quotes. If an asterisk is specified in place of the dce-account- name then all accounts from the registry are selected.
2 - Qualifiers |
/CONFIRM /CONFIRM /NOCONFIRM Controls whether the EXPORT command asks for confirmation before creating the OpenVMS account. In interactive mode the default is /CONFIRM. In noninteractive mode the default is /NOCONFIRM. /DCE_LOGIN=(keyword=value[,...]) /DCE_LOGIN=(keyword=value[,...]) Provides DCE account details for accounts that are authorized to read pricipals and accounts from the DCE registry. Valid keywords for the DCE_LOGIN qualifier are as follows: Keyword Description PRINCIPAL The principal name to be used for authentication purposes when reading accounts and/or principals from the DCE registry. If you do not specify a principal with this qualifier you are prompted for one interactively. PASSWORD The password associated with the principal name that was specified by the PRINCIPAL keyword. If you do not specify a password with this qualifier you are prompted for one interactively. If you do not specify a principal or password with this qualifier, you are prompted for them interactively, regardless of whether or not you are running in interactive mode. This information need be entered only once per session, on the first EXPORT command. Subsequent EXPORT commands within the same session do not require that you to reenter this information. If you are an interactive user and you do not specify the PASSWORD keyword, EXPORT prompts you for your password. The advantage in this is the password is not echoed and therefore does not appear on your terminal. /EXCLUDE /EXCLUDE /NOEXCLUDE (default) Determines whether the DCE account is exported to OpenVMS. If the DCE account is not exported, the OpenVMS account is not created and an entry is created in the EXPORT exclude file for the specified DCE account. /INFORM /INFORM (default) /NOINFORM Determines whether the user is informed of DCE accounts that would have been selected for export, but are not selected. (The reasons that accounts are not selected for export are that they have already been exported (for example, they have an entry in the DCE$UAF) or that they exist in the EXPORT exclude file.) /INTERACTIVE (default) /INTERACTIVE (default) /NOINTERACTIVE Controls whether an interactive or noninteractive export is performed. In interactive mode, a series of questions is asked and the user's responses are used to determine the account details. This mode is well suited to interactive users. In noninteractive mode, all input is supplied through the data qualifiers, and any missing or conflicting data causes the OpenVMS account to not be created. This mode is well suited to command files and batch jobs. Data qualifiers can be specified in interactive mode. In this case the data they provide is used to provide the default answers to the relevant questions. All questions are still asked. /OUTPUT[=output] /OUTPUT[=output] Defines where all program output should be written. The default is SYS$OUTPUT:. /RECAP /RECAP /NORECAP (default) If /RECAP is specified details of the OpenVMS account are displayed before it is actually created. When /CONFIRM is also specified the account details are displayed immediately before the confirmation request. /TEST_ONLY /TEST_ONLY /NOTEST_ONLY (default) If /TEST_ONLY is specified, OpenVMS accounts, identifiers, and DCE$UAF entries are not created. All other functions operate normally. /WILD /WILD (default) /NOWILD Specifies whether or not standard VMS wildcarding is to be applied to dce-account-name. The default is /WILD which means a dce-account-name of "SM*" is interpreted as meaning "export any account starting SM". If /NOWILD is specified the dce-account-name "SM*" is exported.
3 - Data Qualifiers |
3.1 - /ACCOUNT=account
/ACCOUNT=account (default) [NO]ACCOUNT Specifies the account string for the OpenVMS account (same as /ACCOUNT in AUTHORIZE). The account is a string of 1 to 8 alphanumeric characters. If this qualifier is not specified, the DCE account's group name is used (truncated to 8 characters if necessary). If no account field is required then specify /NOACCOUNT.
3.2 - /DEVICE=device
/DEVICE=device Specifies the name of the OpenVMS account's default device at login. The device-name is a string of 1 to 31 alphanumeric characters. If you omit the colon from the device-name value, a colon is automatically appended. The default device is copy the device field from the account specified by the /LIKE qualifier.
3.3 - /DIRECTORY=directory
/DIRECTORY=directory Specifies the default directory name for the DIRECTORY field of the OpenVMS SYSUAF record. The directory name can be 1 to 63 alphanumeric characters. If you do not enclose the directory name in brackets, EXPORT adds the brackets for you. The default directory name is [username] where username is the OpenVMS account's username.
3.4 - /GROUP_UIC=group_uic
/GROUP_UIC=group_uic Specifies the group part of the UIC for the OpenVMS account. GROUP_UIC can be specified as an octal group UIC code or as an existing group UIC identifier. If specified as an octal number, it must be in the range 1 to 37776 (octal). The default is to take the OpenVMS account's ACCOUNT field, convert it to uppercase, and interpret this as a group UIC identifier. If such an identifier does not exist then a similar translation is attempted for the DCE account's group name. If neither identifiers exist, the group UIC is derived from the OpenVMS account specified by the /LIKE qualifier.
3.5 - /LIKE=vms-account
/LIKE=vms-account Specifies an existing OpenVMS account that is to be used as the basis for the OpenVMS account that is being created. Any fields not specified on the EXPORT command line, as well as all quotas, privileges, etc, are inherited from the /LIKE account. The default is DEFAULT (as it is in AUTHORIZE).
3.6 - /MEMBER_UIC=member_uic
/MEMBER_UIC=member_uic Specifies the member part of the UIC for the OpenVMS account. MEMBER_UIC should be specified as an octal number within the range 0 to 177776 (octal). The default is to use the first available member UIC within the group UIC (as specified by /GROUP_UIC). For example, if the selected group is 150 and that group has members 1, 2, 5 and 6 already defined, then the new uic would be [150,3].
3.7 - /OWNER=owner (default)
/OWNER=owner (default) /NOOWNER Specifies the owner string for the OpenVMS account (same as /OWNER in AUTHORIZE). The owner is a string of 1 to 31 characters. If this qualifier is not specified, the DCE account's principal name is used (truncated to 31 characters if necessary). If no owner field is required, specify /NOOWNER.
3.8 - /PASSWORD=passwd
/PASSWORD=passwd Specifies the password for the OpenVMS account. Passwords contain from 0 to 32 characters and can include alphanumeric characters, dollar signs, and underscores. Passwords are not case-sensitive. If you do not specify a password, the account is created without a valid OpenVMS password.
3.9 - /QUOTA=quota
/QUOTA=quota (default) /NOQUOTA Specifies the disk quota for the device specified by /DEVICE to be given to the OpenVMS account (if quotas are enabled on that volume). The default is 1000 blocks. If quotas are not enabled on the device specified by /DEVICE, or if /NOQUOTA is specified, then no quota is given.
3.10 - /USERNAME=username
/USERNAME=username Specifies the username for the OpenVMS account. The username is a string of 1 to 12 alphanumeric characters and can contain underscores. If this qualifier is not specified, the DCE account's principal name is used (truncated to 12 characters and uppercased).
|