HP 3000 Manuals

ALTUSER [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation


MPE/iX Commands Reference Manual Volume I

ALTUSER 

Changes the attributes currently defined for a user.

Syntax 

ALTUSER username[.acctname] [;PASS=[password]][;CAP=[capabilitylist]]

[;MAXPRI=[subqueuename]][;LOCATTR=[localattribute]]

[;HOME=[homegroupname]] [;UID=[uid]] [;USERPASS=[req][Expired]]
                                     [          [opt]         ]
The USERPASS parameter is only available if the HP Security Monitor has
been installed.

Parameters 

username              The name assigned to the user within a logon
                      account.

acctname              The account in which the user is to reside.  System
                      manager (SM) capability is required to use this
                      parameter.

password              The password to be assigned to the user.  If
                      password is omitted, any existing password is
                      removed.  If PASS= is omitted, any existing
                      password is unchanged.

capabilitylist        Either 1) a list of capabilities, separated by
                      commas, permitted to this user, or 2) a list of
                      additions and/or deletions to be applied to the
                      user's existing set of capabilities.  Additions and
                      deletions are specified by a "+" or "-" immediately
                      followed by the capability to add or delete,
                      separated by commas.

                      If "+"/"-" is to be specified in the list, then the
                      list must begin with "+" or "-".  For example,
                      CAP=+MR,-PH is legal, but CAP=MR,-PH is not.  It is
                      not necessary to prefix each capability to be added
                      or deleted with "+" / "-", as the occurrence of "+"
                      / "-" indicates an action that remains in
                      effect until the indicator changes.  For
                      example, CAP=+MR,PH,-PM,DS is equivalent to
                      CAP=+MR,+PH,-PM,-DS.

                      The capabilities allowed to users are restricted by
                      the capabilities assigned to the user's account.
                      If a capability is absent at the account level,
                      users within the account are also denied that
                      capability, whether or not it is explicitly
                      assigned to them.

                      Each capability is denoted by a two-letter mnemonic
                      as follows:

                           System Manager        =    SM
                           Account Manager       =    AM
                           Account Librarian     =    AL
                           Group Librarian       =    GL
                           Diagnostician         =    DI
                           System Supervisor     =    OP
                           Network Administrator =    NA
                           Node Manager          =    NM
                           Save Files            =    SF
                           Access to Nonshareable
                             I/O Devices         =    ND
                           Use Volumes           =    UV
                           Create Volumes        =    CV
                           Use Communication
                             Subsystem                CS
                           Programmatic Sessions =    PS
                           User Logging          =    LG
                           Process Handling      =    PH
                           Extra Data Segments   =    DS
                           Multiple RINs         =    MR
                           Privileged Mode       =    PM
                           Interactive Access    =    IA
                           Batch Access          =    BA
                           Programmatic Sessions =    PS

                      Default is SF, ND, IA, and BA. Note that CV
                      automatically gives the user UV capability, and
                      removal of UV results in automatic removal of CV.

subqueuename          The name of the highest priority subqueue that may
                      be requested by any process of any job/session
                      initiated by the user.  This parameter is specified
                      as AS, BS, CS, DS, or ES, but cannot be greater
                      than that specified with the NEWACCT or ALTACCT
                      commands.  The subqueuename defined for the user is
                      checked against the subqueuename defined for the
                      account at logon, and the lower priority of the two
                      is used as the maximum priority restricting all
                      processes of the job/session.  Also, the priority
                      requested by the user at logon is checked against
                      the subqueuename defined for the user, and the user
                      is granted the lower of these two values.  Default
                      is CS.


CAUTION Processes capable of executing in the AS or BS subqueues can deadlock the system. By assigning nonpriority processes to these subqueues, you may prevent critical system processes from executing. Exercise extreme care when assigning processes to the AS or BS subqueue.
localattribute Defined at the installation site, this arbitrary double word bit map is used to further classify users. While it is not part of standard MPE/iX security provisions, programmers may define it (through the WHO intrinsic) to enhance the security of their own programs. The bit map for the user local attributes must be a subset of the bit map for the account local attributes. The ALTUSER command checks the local attributes of the user with those of the account. Default is double word 0 (null). homegroupname The name of an existing group assigned as the home group for this user. The first user established when an account is created, by default, has PUB assigned as the home group. Subsequent new users, by default, have no home group assigned. If no home group is assigned, the user must always specify an existing group when logging on. uid User ID to be altered for the account manager in the user database. The uid parameter must be a unique positive (non-zero) 32-bit integer. Req USERPASS=REQ specifies that all users in the account must have a non-blank password. It is available only if the HP Security Monitor has been installed. Opt USERPASS=OPT specifies that users in this account may or may not have passwords. If you do not use the USERPASS parameter, the old value remains. It is available only if the HP Security Monitor has been installed. Expired The password expires immediately. The user cannot logon without selecting a new password. It is only available if the HP Security Monitor has been installed. Operation Notes The ALTUSER command allows the account manager to change the password, capabilities, processing subqueue, security checking, and home group currently defined for a user. More than one of these attributes may be changed at a time, by entering multiple keyword parameters on a single command line, using the semicolon (;) delimiter. To change an attribute, enter the keyword and its new value. When an entire keyword parameter group is omitted from the ALTUSER command, the corresponding value for the user remains unchanged. When a keyword is included, but the corresponding parameter is omitted (as in PASS=Return), a default value is assigned as shown in table Table 2-4 . Table 2-4. Default Values for the ALTUSER Command -------------------------------------------------------------------------------------------- | | | | Parameter | Default Values | | | | -------------------------------------------------------------------------------------------- | | | | password | NULL password | | | | | capabilitylist | SF, ND, IA, and BA (provided these capabilities have been | | | specified for the account) | | | | | subqueuename | CS | | | | | localattribute | 0 (null) | | | | | homegroupname | The first user established when the account is created has PUB | | | assigned as home group. Subsequent users have no group assigned | | | as home. If a user has no home group assigned, an existing | | | group must be specified when initiating a job or a session. | | | | -------------------------------------------------------------------------------------------- When a parameter is modified with the ALTUSER command, it is immediately registered in the directory. However, it does not affect users who are currently logged on to the system. They are affected the next time they log on to the same user name and account. For this reason, warn users in advance of any intended changes. Avoid changing the capabilitylist or homegroupname of the user MANAGER.SYS. SM capability cannot be taken away from MANAGER.SYS. ALTUSER will not allow a user with AM capability to remove AM from their own capability list. However, a user with AM can remove AM from the capability list of another AM user inside the same account. Use This command may be issued from a session, a job, a program, or in break mode. Pressing Break has no effect on this command. Account manager (AM) capability is required to use this command. System manager (SM) capability is required to specify a user in an account other than your own. Examples Suppose an account's capabilities are AM, AL, GL, SF, ND, PH, DS, MR, IA, and BA. To change the capabilitylist of the user JONES from IA, BA, SF, PH, DS to include multiple RIN (MR) capability, enter: ALTUSER JONES;CAP=IA,BA,SF,PH,DS,MR To alter two attributes, password and subqueuename, for user JONES enter: ALTUSER JONES;PASS=JJ;MAXPRI=DS Related Information Commands ALTACCT, ALTGROUP, LISTUSER, NEWACCT, NEWUSER Manuals Performing System Management Tasks (32650-90004)


MPE/iX 5.0 Documentation