|
HP OpenVMS Systems Documentation |
|
HP OpenVMS System Services Reference Manual
Because this quota is a longword decimal number, the buffer length field in the item descriptor should specify 4 (bytes). UAI$_LASTLOGIN_ISets, as a quadword absolute time value, the date of the last interactive login.UAI$_LASTLOGIN_NSets, as a quadword absolute time value, the date of the last noninteractive login.UAI$_LGICMDSets, as an OpenVMS RMS file specification, the name of the default login command file.Because a file specification can include up to 63 characters plus a size-byte prefix, the buffer length field of the item descriptor should specify 64 (bytes). UAI$_LOCAL_ACCESS_PSets, as a 3-byte value, the range of times during which local interactive access is permitted for primary days. Each bit set represents a 1-hour period, from bit 0 as midnight to 1 a.m., to bit 23 as 11 p.m. to midnight.The buffer length field in the item descriptor should specify 3 (bytes). UAI$_LOCAL_ACCESS_SSets, as a 3-byte value, the range of times during which local interactive access is permitted for secondary days. Each bit set represents a 1-hour period, from bit 0 as midnight to 1 a.m., to bit 23 as 11 p.m. to midnight.The buffer length field in the item descriptor should specify 3 (bytes). UAI$_LOGFAILSSets the count of login failures.Because this decimal number is a word in length, the buffer length field in the item descriptor should specify 2 (bytes). UAI$_MAXACCTJOBSSets the maximum number of batch, interactive, and detached processes that can be active at one time for all users of the same account. The value 0 represents an unlimited number.Because this decimal number is a word in length, the buffer length field in the item descriptor should specify 2 (bytes). UAI$_MAXDETACHSets the detached process limit. The value 0 represents an unlimited number.Because this decimal number is a word in length, the buffer length field in the item descriptor should specify 2 (bytes). UAI$_MAXJOBSSets the active process limit. A value of 0 represents an unlimited number.Because this decimal number is a word in length, the buffer length field in the item descriptor should specify 2 (bytes). UAI$_NETWORK_ACCESS_PSets, as a 3-byte value, the range of times during which network access is permitted for primary days. Each bit set represents a 1-hour period, from bit 0 as midnight to 1 a.m., to bit 23 as 11 p.m. to midnight.The buffer length field in the item descriptor should specify 3 (bytes). UAI$_NETWORK_ACCESS_SSets, as a 3-byte value, the range of times during which network access is permitted for secondary days. Each bit set represents a 1-hour period, from bit 0 as midnight to 1 a.m., to bit 23 as 11 p.m. to midnight.The buffer length field in the item descriptor should specify 3 (bytes). UAI$_OWNERSets, as a character string, the name of the owner of the account.Because the owner name can include up to 31 characters plus a size-byte prefix, the buffer length field of the item descriptor should specify 32 (bytes). UAI$_PASSWORDSets the specified plaintext string as the primary password for the user and updates the primary password change date. You must have SYSPRV privilege to set passwords for any user account (including your own).The UAI$_PASSWORD and UAI$_PASSWORD2 item codes provide the building blocks for designing a site-specific SET PASSWORD utility. Note that if you create such a utility, you should also set the LOCKPWD bit in the user authorization file (UAF) to prevent users from using the DCL command SET PASSWORD and to prevent the LOGINOUT process from forcing password changes. If you create a site-specific SET PASSWORD utility, install the utility with SYSPRV privilege. You must adhere to the following guidelines when specifying a password with UAI$_PASSWORD or UAI$_PASSWORD2:
To clear the primary password, specify the value 0 in the buffer length field. When you use $SETUAI to change the password on an account that has the UAI$V_EXTHAUTH flag set, the UAI$V_MIGRATEPWD flag is set automatically.
UAI$_PASSWORD2Sets the specified plaintext string as the secondary password for the user and updates the secondary password change date. You must have SYSPRV privilege to set passwords for any user account (including your own).To clear the secondary password, specify the value 0 in the buffer length field.
UAI$_PBYTLMSets the paged buffer I/O byte count limit.Because the paged buffer I/O byte count limit is a longword decimal number, the buffer length field in the item descriptor should specify 4 (bytes). UAI$_PGFLQUOTASets, in pagelets (on Alpha and Integrity server systems), the paging file quota.Because the paging file quota is a longword decimal number, the buffer length field in the item descriptor should specify 4 (bytes). UAI$_PRCCNTSets the subprocess creation limit.Because this decimal number is a word in length, the buffer length field in the item descriptor should specify 2 (bytes). UAI$_PRISets the default base priority.Because this decimal number is a byte in length, the buffer length field in the item descriptor should specify 1 (byte). UAI$_PRIMEDAYSSets, as a byte bit vector, the primary and secondary days of the week.Each bit represents a day of the week, with the bit clear representing a primary day and the bit set representing a secondary day. The $UAIDEF macro defines the following symbolic names for these bits: UAI$V_MONDAY UAI$_PRIVSets, as a quadword value, the names of the privileges that the user holds.Because the privileges are set as a quadword value, the buffer length field in the item descriptor should specify 8 (bytes). UAI$_PWDSets, as a quadword value, the hashed primary password of the user.Because the hashed primary password is set as a quadword value, the buffer length field in the item descriptor should specify 8 (bytes). When you use $SETUAI to change the password on an account that has the UAI$V_EXTHAUTH flag set, the UAI$V_MIGRATEPWD flag is set automatically. UAI$_PWD_DATESets, as a quadword absolute time value, the date of the last password change.Because this value is a quadword in length, the buffer length field in the item descriptor should specify 8 (bytes). A value of --1 indicates that the password could be marked as preexpired.
UAI$_PWD_LENGTHSets the minimum password length.Because this decimal number is a byte in length, the buffer length field in the item descriptor should specify 1 (byte). UAI$_PWD_LIFETIMESets, as a quadword delta time value, the password lifetime.Because this value is a quadword in length, the buffer length field in the item descriptor should specify 8 (bytes). A quadword of 0 means that none of the password mechanisms will take effect. UAI$_PWD2Sets, as a quadword value, the hashed secondary password of the user.Because the hashed secondary password is set as a quadword value, the buffer length field in the item descriptor should specify 8 (bytes). UAI$_PWD2_DATESets, as a quadword absolute time value, the last date the secondary password was changed.Because this value is a quadword in length, the buffer length field in the item descriptor should specify 8 (bytes). A value of --1 indicates that the password could be marked as preexpired.
UAI$_QUEPRISets the maximum job queue priority in the range 0 through 31.Because this decimal number is a byte in length, the buffer length field in the item descriptor should specify 1 (byte). UAI$_REMOTE_ACCESS_PSets, as a 3-byte value, the range of times during which batch access is permitted for primary days. Each bit set represents a 1-hour period, from bit 0 as midnight to 1 a.m., to bit 23 as 11 p.m. to midnight.The buffer length field in the item descriptor should specify 3 (bytes). UAI$_REMOTE_ACCESS_SSets, as a 3-byte value, the range of times during which batch access is permitted for secondary days. Each bit set represents a 1-hour period, from bit 0 as midnight to 1 a.m., to bit 23 as 11 p.m. to midnight.The buffer length field in the item descriptor should specify 3 (bytes). UAI$_SALTSets the salt field of the user's record to the value you provide. The salt value is used in the operating system hash algorithm to generate passwords. $SETUAI does not generate a new salt value for you.Because this decimal number is a word in length, the buffer length field in the item descriptor should specify 2 (bytes). By copying the item codes UAI$_SALT, UAI$_ENCRYPT, UAI$_PWD, UAI$_PWD_DATE, and UAI$_FLAGS, a site-security administrator can construct a utility that propagates password changes throughout the network. Note, however, that HP does not recommend using the same password on more than one node in a network. UAI$_SHRFILLMSets the shared file limit.Because this decimal number is a word in length, the buffer length field in the item descriptor should specify 2 (bytes). UAI$_TQCNTSets the timer queue entry limit.Because this decimal number is a word in length, the buffer length field in the item descriptor should specify 2 (bytes). UAI$_UICSets, as a longword, the user identification code (UIC). For the format of the UIC, see the HP OpenVMS Guide to System Security.UAI$_USER_DATASets up to 255 bytes of information in the user data area of the system user authorization file (SYSUAF). This is the supported method for modifying the user data area of the SYSUAF. HP no longer supports direct user modification of the SYSUAF.To clear all the information in the user data area of the SYSUAF, specify $SETUAI with a buffer length field of 0. UAI$_WSEXTENTSets the working set extent, in pagelets (on Alpha and Integrity server systems), specified for the specified job or queue.Because the working set extent is a longword decimal number, the buffer length field in the item descriptor should specify 4 (bytes). UAI$_WSQUOTASets the working set quota, in pagelets (on Alpha and Integrity server systems), for the specified user.Because the working set quota is a longword decimal number, the buffer length field in the item descriptor should specify 4 (bytes). DescriptionThe Set User Authorization Information service is used to modify the user authorization file (UAF) record for a specified user. Condition Values Returned
This service can also return OpenVMS RMS status codes associated with operations on indexed files. For a description of RMS status codes that are returned by this service, see the OpenVMS Record Management Services Reference Manual. $SETUP_AVOID_PREEMPT
Performs initial setup for process preemption avoidance. FormatSYS$SETUP_AVOID_PREEMPT enable C Prototypeint sys$setup_avoid_preempt (int enable); Arguments
DescriptionThe Setup for Process Preemption Avoidance service is a kernel-mode initialization routine that locks the necessary internal data structures in memory so scheduling routines can access them above pageable IPL. A process or thread can then set or clear the indicator bit by calling the $AVOID_PREEMPT service. Condition Values Returned
Also, any values returned by the $LKWSET or $UNLKSET services. $SET_DEFAULT_TRANS
Sets or clears the default transaction of the calling process. FormatSYS$SET_DEFAULT_TRANS [efn] ,[flags] ,iosb [,[astadr] ,[astprm] ,[new_tid] ,[old_tid]] C Prototypeint sys$set_default_trans (unsigned int efn, unsigned int flags, struct _iosb *iosb,...); Arguments
astadr
The AST routine executed when the service completes, if SS$_NORMAL is returned in R0. The astadr argument is the address of the entry mask of this routine. The routine is executed in the same access mode as that of the caller of the $SET_DEFAULT_TRANS service. astprm
The AST parameter passed to the AST routine specified by the astadr argument. new_tid
The identifier (TID) of the new default transaction for the calling process. If this argument is zero (the default) or if it specifies a zero TID (an octaword of zeros), the service clears the default transaction of the calling process. old_tid
An octaword in which the service returns the identifier (TID) of the calling process' previous transaction (the one that was set or cleared by this call to $SET_DEFAULT_TRANS). A zero TID is returned if the calling process did not have a default transaction prior to the call. DescriptionThe $SET_DEFAULT_TRANS system service: None. ASTLM $ABORT_TRANS, $ABORT_TRANSW, $ACK_EVENT, $ADD_BRANCH, $ADD_BRANCHW, $CREATE_UID, $DECLARE_RM, $DECLARE_RMW, $END_BRANCH, $END_BRANCHW, $END_TRANS, $END_TRANSW, $FORGET_RM, $FORGET_RMW, $GETDTI, $GETDTIW, $GET_DEFAULT_TRANS, $JOIN_RM, $JOIN_RMW, $SETDTI, $SETDTIW, $SET_DEFAULT_TRANSW, $START_BRANCH, $START_BRANCHW, $START_TRANS, $START_TRANSW, $TRANS_EVENT, $TRANS_EVENTW Condition Values Returned
|