HELLO

Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004

Back to Main Index


HELLO


     Initiates an interactive session.

SYNTAX


MPE/iX: HELLO [sessionname,]username[/userpass].acctname
              [/acctpass][,groupname[/grouppass]]
                     {termtype}
              [;TERM={termname}]
              [;TIME=cpusecs]

                      {BS}
              [;PRI=  {CS}]
                      {DS}
                      {ES}

              {;INPRI=inputpriority}
              [{;HIPRI              }]
              [;INFO=ciinfo]
              [;PARM=ciparm]


PARAMETERS


sessionname         Arbitrary name used in conjunction with username and
                    acctname parameters to form a fully qualified
                    session identity. The name must contain from one to
                    eight alphanumeric characters, beginning with an
                    alphabetic character.  Default is that no session
                    name is assigned to the logon.

username            User name, established by the account manager, that
                    allows you to log on under this account.  The name
                    must contain from one to eight alphanumeric
                    characters, beginning with an alphabetic character.

userpass            User password, optionally assigned by the Account
                    manager.  The password must contain from one to
                    eight alphanumeric characters, beginning with an
                    alphabetic character.  The userpass must be preceded
                    by a slash (/).

acctname            Account name as established by the system manager.
                    The name must contain from one to eight alphanumeric
                    characters, beginning with an alphabetic character.
                    The acctname parameter must be preceded by a period
                    (.).

acctpass            Account password, optionally assigned by the system
                    manager. The password must contain from one to eight
                    alphanumeric characters, beginning with an
                    alphabetic character.  The acctpass must be preceded
                    by a slash (/).

groupname           Group name to be used for the local file domain and
                    the CPU and connect time charges as established by
                    the account manager.  The name must contain from one
                    to eight alphanumeric characters, beginning with an
                    alphabetic character.  Default is your home group if
                    you are assigned one by the account manager.
                    (Required if a home group is not assigned.)

grouppass           Group password optionally assigned by the Account
                    manager.  The password must contain from one to
                    eight alphanumeric characters, beginning with an
                    alphabetic character. The grouppass parameter is not
                    needed when you log on to your home group.  The
                    grouppass parameter must be preceded by a slash (/).

termtype            Determines terminal type characteristics.  The
or                  termtype parameter determines the type of terminal
termname            used for input.  MPE/iX uses this parameter to
                    determine device-dependent characteristics such as
                    delay factors for carriage returns.  It must be 10
                    or 18.  The default value for termtype is assigned
                    by the system supervisor during system
                    configuration.  This is a required parameter.
                    Specifying termtype or termname ensures correct
                    displays of your listings if your terminal is not
                    the  default termtype.

                    The termname parameter is the name of the
                    file containing the desired terminal-type
                    characteristics.  The file cannot have a
                    lockword or reside on a user volume.

                    Users of the Workstation Configurator are
                    allowed to create terminal-type files.  The
                    proper and efficient operation of a specific
                    device by a user created terminal type is the
                    responsibility of the user.  The Workstation
                    Configurator utility allows the user to
                    specify the following characteristics of the
                    terminal:  data flow control, block mode,
                    read trigger, special characteristics, echo,
                    line feed, parity, and printer control.

cpusecs             Maximum CPU time that session can use, entered in
                    seconds.  When the limit is reached, the session is
                    aborted.  It must be a value from 1 to 32,767. To
                    specify no limit, enter a question mark (?),
                    UNLIMITED, or omit the parameter. Default is no
                    limit.

BS, CS, DS, or ES   The execution priority queue that MPE/iX uses for
                    your session, and also the default priority for all
                    programs executed within the session.  BS is highest
                    priority, ES is lowest.  If you specify a priority
                    that exceeds the highest permitted for your account
                    or user name by the system, MPE/iX assigns the
                    highest priority possible below BS.  DS and ES are
                    intended primarily for batch jobs; their use for
                    sessions is generally discouraged.  Default is CS.

CAUTION


Use care in assigning the BS queue.  Processes in this priority class
can lock out other processes.

For information on the guidelines for these priority queues, refer to
the TUNE command.

inputpriority or HIPRI  Determines the input priority of the job.
                        The inputpriority value is the relative
                        input priority used in checking against
                        access restrictions imposed by the
                        jobfence.  The inputpriority option takes
                        effect at logon time and must be from 1
                        (lowest priority) to 13 (highest
                        priority). If you supply a value less than
                        or equal to the current jobfence set by
                        the system operator, the session is denied
                        access.  Default is 8.

                        The HIPRI option is used for two different
                        purposes when logging on. It can be used
                        to override the system jobfence or it can
                        be used to override the session limit.
                        When using the HIPRI option to override
                        the jobfence, the system will first check
                        to see if you have System Manager (SM) or
                        system operator (OP) capability.  If you
                        have either of these capabilities, you
                        will be logged on and your INPRI will
                        default to the system's jobfence and
                        execution limit. If you do not have either
                        of these capabilities, the system will
                        attempt to log you on using INPRI=13 and
                        will succeed if the jobfence is 12 or
                        less, and if the session limit is not
                        exceeded. Use of the HIPRI option without
                        SM or OP capability causes the following
                        warning to be displayed:

                        MUST HAVE 'SM' OR 'OP' CAP. TO SPECIFY
                        HIPRI, MAXIMUM INPRI OF 13 IS USED (CIWARN
                        1460)

ciinfo              INFO string to be passed to the Command
                    Interpreter. For the MPE/iX CI, it is the
                    first command to be executed by the Command
                    Interpreter. This parameter takes the place of the
                    MPE V COMMAND LOGON command and approximates its
                    function.  The COMMAND LOGON command caused the
                    session to terminate after executing the specified
                    command.  In contrast, the ciinfo parameter does not
                    terminate the session unless ciparm is set to 1, 3,
                    or 5.

                    Running the CI as a child process in this way
                    restricts the flexibility of ciparm.  More
                    flexibility is available by running the CI as
                    as a stand alone program.

ciparm              The Command Interpreter parameter number you wish
                    to use.  If you are using the MPE/iX Command
                    Interpreter, the numbers accepted are:

0, 2, 4             Logon UDCs are executed and the CI banner and the
                    welcome message are displayed. Default.

1, 3, 5             Same as 0, but the CI terminates after processing
                    the INFO= string.  If the INFO= string is not
                    specified, then the CI terminates after
                    executing the first user command.

-1                  UDCs are not cataloged.  The CI banner and the
                    welcome message are not displayed. Invoking this
                    level requires System Manager (SM) capability.
                    To prevent users from bypassing logon UDCs, you
                    can enforce logon UDCs via the MISC configurator
                    in SYSGEN.

                    If a user without SM capability uses -1, the system
                    substitutes a parameter value of 0 without
                    generating an error message.

-2                  Same as -1, but the CI terminates after processing
                    the INFO= command.  Invoking this level requires
                    System Manager (SM) capability.

                    Any other value is treated as zero (0).  The MPE/iX
                    CI distinguishes between ciparms 1, 3, 5 and 0, 2, 4
                    when it is run from within the CI--that is, after
                    the session has logged on.

                    If a user without SM capability uses -1 or -2,
                    the system substitutes a parameter value of 0
                    without generating an error message.

                    To prevent users from bypassing logon UDCs, you
                    can enforce logon UDCs via the MISC configurator
                    in SYSGEN.


OPERATION


     The HELLO command initiates an interactive session and must
     be entered from a terminal; no other device can be used for
     this command.  You must supply both a valid username and
     acctname in your logon command.  Otherwise, MPE/iX rejects
     your logon attempt and prints an error message to that
     effect.  If your logon attempt is accepted, however, MPE/iX
     verifies this by printing specific logon information and
     prompting you for your next MPE/iX command.  This
     information appears in the following example, where a user
     has logged on under the username USER and the acctname
     TECHPUBS:

MPE XL:HELLO USER.TECHPUBS
HP3000 RELEASE : V.UU.FF  USER VERSION: V.UU.FF  WED, FEB 1, 1989, 10:00
AM
MPE XL HP31900 A.11.70 Copyright Hewlett-Packard 1987.  ...
:** MPE/iX prompts for the next command **

     When you first access an MPE/iX system to log on, the MPE/iX:
     prompt is displayed.  When you log off, the following message is:

     BYE
     CPU=1.  CONNECT=1. THU, JUN 15, 1989,  10:50 AM.

     The RELEASE: V.UU.FF number in the logon banner is determined by
     Hewlett-Packard at operating system build time and provides and
     identity for software releases (known as the MIT).  You cannot
     change this number.  (Before the MPE/iX release a.11.70, this was
     known as the BASE).

     The USER VERSION: V.UU.FF can be assigned a value during a SYSGEN.
     It allows you to identify any changes to your total software
     package, such as patch level, third party software, or other
     specifics.  Any ASCII character can be used.  In earlier releases,
     this number was printed out immediately after the MPE/iX product
     number HP31900.

     The PRODUCT V.UU.FF, which now immediately follows the product
     number HP31900, is determined by Hewlett-Packard when a new version
     of MPE/iX is compiled.  You cannot change this V.UU.FF number.  You
     should use this number when entering a service request (SR) against
     the MPE/iX operating system product for that particular release.

     If the system operator has set up a welcome message, it will
     appear following the MPE/iX verification of your logon.

     This command may be issued from a session or in BREAK.  It may not
     be used from a job or a program.  Pressing [Break] does
     not abort the execution of this command, but may prematurely
     terminate the printing of the welcome message or the
     execution of any logon UDCs. If you are already in a session,
     HELLO will terminate that session before beginning a new
     one.

     The session number assigned by MPE/iX uniquely identifies
     your session to MPE/iX and to other users.  MPE/iX assigns
     such numbers to sessions in sequential order as they are
     logged on.  If you are on a modem and do not log on within
     the system configured time, the line is dropped. You must
     redial and press [Return] again. If you are already logged
     on and you issue the HELLO command, you will be logged off
     your current session and logged onto a new session.

     In certain instances, you may be required to furnish
     information in addition to the user and account names in
     your HELLO command.  This information includes:

     o  Group Name.

     o  One or more passwords.

     o  Terminal type code.

Group Name

     The group you select at logon for your local file domain is
     known as your logon group.  If your account manager has
     associated a home group with your username, and if you want
     this group as a logon group, you need not specify it.  MPE
     XL automatically assigns the home group as your logon group
     when you log on.  But if you want to use some other group as
     your logon group (YGROUP, for example), you must specify that
     group's name in your logon command in this way:

     MPE XL:HELLO USER.TECHPUBS,YGROUP

     If your username is not related to a home group, you must
     enter a group name in your HELLO command, or your logon
     attempt will be rejected.

     Once you log on, if the normal (default) file security
     provisions of MPE/iX are in force, you have unlimited access
     to all files in your logon and home groups.  Furthermore,
     you can read files and execute programs stored in the PUB
     (public) group of your account and the PUB (public) group of
     the SYS (system) account.  You cannot, however, access any
     other files in any way.  Further information about files and
     file security can be found in the Accessing Files
     Programmer's Guide (32650-90017).

     To enhance the security of an account, and to prevent
     unauthorized accumulation of charges against the account,
     the system manager may assign a password.  Similarly, an
     account manager may associate passwords with the user names
     and groups belonging to the account.  If you are using an
     account, user name, or group (other than your home group)
     that has a password, you must furnish that password when you
     log on.  Include the password after the name of the
     protected entity, separated from that name by a slash mark
     (/).  (In MPE/iX, the slash denotes security.)  You do not need to
     specify a password if you are logging on to your home group.

     For instance, if the group XGROUP requires a password and if
     you use this group as your logon group, you could enter the
     password in this fashion:

     MPE XL:HELLO USER.TECHPUBS,XGROUP/XPASS

     Note that when you specify your home group as your logon
     group, you need not enter a password, even if that group has
     such a password.

     Sometimes, when logging on to the system, it is more
     convenient to have MPE/iX prompt you for any required
     passwords.  You do this by omitting the passwords from the
     logon command.  When you log on, the command is printed in
     the normal way; MPE/iX prompts you for the password, then
     turns the echo off so that the password will not be printed.
     If you enter the password incorrectly, the prompt will
     reappear and you will have two more chances to enter the
     password correctly.  After the third incorrect entry, the
     line will be dropped, and you must press [Return] to receive
     another prompt.  Echo is turned on after all passwords are
     read.

Terminal Types

     MPE/iX must determine certain characteristics about your terminal,
     such as input and output speed, in order to conduct a session.  If
     you log on using a different type of terminal than the type the
     system manager has configured, you must specify your terminal type
     when you log on.

     MPE XL:HELLO USER.TECHPUBS;TERM=10


EXAMPLE(S)


     When you first log on to access MPE/iX, the system prompt appears
     as:

     MPE XL:

     Thereafter when you log on to another account or group, the system
     prompt that appears by default is a colon, unless you have altered
     with the SETVAR HPPROMPT command.

     To start a session named ALPHA, with the user USER, the account
     TECHPUBS, the group XGROUP, and the group password XPASS, enter:

MPE XL:HELLO ALPHA,USER.TECHPUBS,XGROUP/XPASS
HP3000RELEASE : V.UU.FF  USER VERSION: @.@@.@@  WED, FEB 1, 1989, 10:00
AM
MPE XL HP31900 A.11.70 Copyright Hewlett-Packard 1987.  ...
:
** MPE/iX then prompts for next command **

When you first log onto access MPE/iX, the system prompt appears:

     MPE XL:

Thereafter when you log on to another account or group, the system
prompt appears:

     :

To start a session named ALPHA, with the user USER, the account
TECHPUBS, the group XGROUP, and the group password XPASS, enter:

HELLO ALPHA, USER.TECHPUBS,XGROUP/XPASS
HP3000 RELEASE: V.UU.FF USER VERSION: @.@@.@@ WED, FEB 1, 1989, 9:00 AM
MPE XL HP3190O A.11.70  Copyright Hewlett-Packard 1987.  ...

ADDITIONAL INFORMATION


Commands:   BYE

Back to Main Index