Use UserAlter to alter the attributes of a host user.
UserAlter may also be entered as UserAlt[er], AlterU[ser], or AltU[ser].
Required Operands
USER is the user ID to be altered.
Optional Operands
PSWD specifies a new password. PSWD can be up to 8 characters in length. Users may alter their own passwords with the HostPassword command.
NAME specifies a new name. NAME can be up to 25 characters in length. It appears on the UserLibrary display.
CMDSEC specifies a new command access level. Specify USER, EXTU, OPER, or ADM. For more detail on this operand, see the UserDefine command.
LIBSEC specifies a new system-wide minimum directory access level. Specify NULL, EXEC, LIST, EDIT, DEF, DEFL, or DEFS. For normal users, who are not to have access to all directories in the system, specify LIBSEC as NULL.
PWRSEC specifies a new POWER or JES access level. PWRSEC is a one character value. BIM-EDIT/XP does not edit this value in any way. The value is passed to the host BIM-EDIT BIXPWQA exit routine.
LOGL Specifies a new maximum number of lines that may exist in the host $LOG at any time. After this point has been reached, for every line added at the bottom of the host $LOG, a line from the top of the host $LOG is deleted. LOGL must be between 0 and 999,999.
Note that 'host $LOG' is different than $LOG. BIM-EDIT/XP normally logs to $LOG. Host $LOG is relevant to a BIM-EDIT/XP user only when executing a procedure or utility job that will run on the host.
MAILL specifies a new maximum number of lines that may exist in $MAIL at any time. After this point has been reached, for every line added at the bottom of $MAIL, a line from the top of $MAIL is deleted. MAILL must be between 0 and 999,999.
SIZEL specifies a new maximum number of lines that a user can create in a session or in host $STACK. BIM-EDIT will reject operations which would increase the size beyond SIZEL. This prevents unusual functions for which library space has not been provided, SIZEL must be between 1 and 999,999.
SIZEL is relevant to BIM-EDIT/XP users only when executing a procedure or utility job that will run on the host.
ATTR is a field with site-defined usage. Its value can be accessed in a host procedure by referring to the host predefined variable SIBATTR. ATTR can be up to 8 characters in length.
USAGE Specify "CLEAR" to reset the job accounting usage field.
If no optional operands are entered, UserAlter will create a window that shows all user attributes and allows you to change attributes by simply overtyping their current values.
The CMDSEC, LIBSEC, PWRSEC, LOGL, MAILL, and SIZEL values take effect when a user logs on. If one of these values is changed while a user is logged on, the user must log off and on again for the change to take effect.
When Valid
The user must have ADM command access level.
Return Codes
OK Successful
NF User record not found.
Procedure Notes
User attributes can be accessed within a host procedure using the host SIB predefined variables.
Examples
Alter the user record "GJB" so that the password is "X345":
=> altu gjb,pswd=x345
For user "SDK", provide OPER level command access and LIST level system-wide library access:
=> altu sdk,cmdsec=oper,libsec=list