Use UserDefine to create a new host user.
UserDefine may also be entered as UserDef[ine], DefineU[ser], or DefU[ser].
Required Operands
USER is the user ID to be defined. USER can be up to 8 characters in length, composed of the letters A-Z, the numerals 0-9, and the characters dash (-), dollar sign ($), and underscore (_).
PSWD specifies a password. PSWD can be up to 8 characters in length. Users may alter their own passwords with the HostPassword command.
Optional Operands
NAME specifies the user name. NAME can be up to 25 characters in length. It appears on the UserLibrary display.
Default: blank.
CMDSEC specifies the command access level. It is usually desirable to restrict a user to a subset of the host BIM-EDIT commands. CMDSEC is specified as one of the following:
USER User. Appropriate for most users. Provides access to commands needed for normal activity.
EXTU Extended User. As host BIM-EDIT is distributed, the EXTU command subset is identical to the USER command subset. EXTU is provided so that a site can customize the command table (see below) to distinguish between two classes of normal users.
OPER Operator. Provides access to USER commands and operation commands such as BACKUPG.
ADM Administrator. Provides access to USER commands, OPER commands, and administration commands such as UserDefine, UserAlter, etc.
Default: USER.
LIBSEC specifies the system-wide minimum library access level. Specify NULL, EXEC, LIST, EDIT, DEF, DEFL, or DEFS. For normal users, who are not to have access to all libraries in the system, specify LIBSEC as NULL.
Default: NULL.
PWRSEC specifies the POWER and JES access level. PWRSEC is a one character value which is passsed to the BIXPWQA security exit. BIM-EDIT does not edit this value in any way.
Default: "1".
LOGL Specifies the maximum number of lines that may exist in $LOG at any time. After this point has been reached, for every line added at the bottom of $LOG, a line from the top of $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.
Default: 500.
MAILL Specifies the 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. If MAILL is not specified, a value of 500 is used.
SIZEL specifies the maximum number of lines that a user can create in a session or in $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 is relevant to BIM-EDIT/XP users only when executing a procedure or utility job that will run on the host.
Default: 10000.
ATTR is a field with site-defined usage. Its value can be accessed in a procedure by referring to the predefined variable SIBATTR. ATTR can be up to 8 characters in length.
Default: blank.
The command subset available for each CMDSEC type can be customized by changing the host BIM-EDIT module BIFXCCM.
When Valid
The user must have ADM command access level.
Return Codes
OK Successful.
DP User already exists.
Procedure Notes
Attributes for the current user can be accessed within a host procedure using the host SIB predefined variables.
Examples
Create a user "FRED" having the password "DEBT". Accept the defaults for the security fields:
=> defu fred,debt,'fred flint'
Create a user "4218" with a password of "CARS". Provide OPER level command access, LIST level system-wide library access, and level "2" POWER/JES access:
=> defu 4218,cars,'employee #4218',cmdsec=oper,libsec=list,pwrsec=2