HELLO



HELLO

     Initiates an interactive session.

SYNTAX

HELLO [sessionname,]username[/userpass].acctname[/acctpass][,groupname[/grouppass]]
[;TERM={termtype} | {termname}]
[;TIME=cpusecs]
[;PRI= {BS} | {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
termtype parameter determines the type of terminal
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.

termname 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 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.

HIPRI 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:00AM
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:00AM
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