HELLO [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation
MPE/iX Commands Reference Manual Volume I
HELLO
Initiates an interactive session. (Native Mode)
Syntax
HELLO [sessionname,]username[/userpass].acctname
[/acctpass][,groupname[/grouppass]] [;TERM={termtype}][;TIME=cpusecs]
[ {termname}]
[ {BS}]
[;PRI={CS}][{;INPRI=inputpriority}] [;INFO=ciinfo][;PARM=ciparm]
[ {DS}][{;HIPRI }]
[ {ES}]
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
is assigned.
username User name, established by the account manager, that
allows you to log on to 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 user password 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 account password 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 to log on to your home group. The group
password must be preceded by a slash (/).
termtype or termname 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 to
ensure correct 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 characteristics of the
terminal, including data flow control, block mode,
read trigger, special characteristics, echo, line
feed, parity, and printer control.
cpusecs Maximum CPU-time that a session can use, entered in
seconds. When the limit is reached, the session is
aborted. It must be a value from 1 to 32767. 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 the
highest priority, ES is the lowest. If you specify
a priority that exceeds the highest priority
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. For information on the guidelines for
these priority queues, refer to the TUNE command.
Default is CS.
CAUTION Use care in assigning the BS queue. Processes in this priority
class can lock out other processes.
inputpriority or Determines the input priority of the job. The
HIPRI inputpriority option 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.
When logging on, the HIPRI option is used to either
override the system jobfence or to override the
session limit. When using the HIPRI option to
override the jobfence, the system first checks to
see if you have system manager (SM) or system
operator (OP) capability. If you have either of
these capabilities, you are logged on and your
INPRI defaults to the system's jobfence and
execution limit. If you do not have either of
these capabilities, the system attempts to log you
on using INPRI=13 and succeeds if the jobfence is
12 or less, and if the session limit is not
exceeded. Only users with SM or OP capability can
use the HIPRI option to override the session limit
to log on. 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 An 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 replaces the ( ) 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 a
standalone program.
ciparm The command interpreter parameter number you wish
to use. The MPE/iX command interpreter accepts the
numbers listed below. If you enter any other
value, it is treated as zero (0).
0, 2, 4 Executes logon UDCs and
displays the CI banner and
the welcome message. This is
the default.
1, 3, 5 Same as 0, but the CI
terminates after processing
the INFO= string. If the
INFO= string is not
specified, the CI terminates
after executing the first
user-supplied command.
-1 Prohibits cataloging of UDCs
and suppress the display of
the CI banner and the welcome
message. Invoking this level
requires system manager (SM)
capability.
-2 Same as -1, but the CI
terminates after processing
the info= command. Invoking
this level requires system
manager (SM) capability.
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 and does
NOT display an error message.
Operation Notes
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 or MPE/iX
rejects your logon attempt and displays an error message. If your logon
attempt is accepted, MPE/iX displays specific logon information and
prompts you for your next MPE/iX command. In the following example, a
user has logged on under the username USER and the acctname TECHPUBS:
MPE XL:HELLO USER.TECHPUBS
HP3000 Release: X.50.40 User Version : X.50.40 THU, DEC 8, 1994, 1:15 PM
MPE/iX HP31900 B.78.11 Copyright Hewlett-Packard 1987. All rights reserved.
:
When you first access an MPE/iX system to log on, the MPE iX: prompt is
displayed. When you log off using the BYE command, the following message
is displayed:
CPU=1. CONNECT=1. THU, DEC 8, 1994, 1:50 PM
The RELEASE: V.UU.FF number in the logon banner is determined by
Hewlett-Packard at operating system build time and provides an identity
for software releases (also known as the MIT). This number may not be
changed. (Prior to MPE/iX release A.11.70, this was referred to as
BASE.)
The USER VERSION: V.UU.FF can be assigned a value during a SYSGEN and
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 prior 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. This V.UU.FF number cannot be changed and is used 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 is displayed
after the MPE/iX verification of your logon.
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 on to 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:
* Group name
* One or more passwords
* Terminal type code
Use
This command may be issued from a session. It may not be used from a
job, program, or in BREAK. 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 terminates that session before beginning a new one.
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/iX 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, you must specify that group's name in your logon command in
this way:
MPE iX:HELLO USER.TECHPUBS,MYGROUP
If your user name is not related to a home group, you must enter a group
name in your HELLO command, or your logon attempt is 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-60010).
Passwords
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 his 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.)
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 iX: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 echo off so that the password is not printed. If you enter the
password incorrectly, the prompt reappears and you have two more chances
to enter the password correctly. After the third incorrect entry, the
message INCORRECT PASSWORD (CIERR 1441) is displayed. You must then
press Return to receive a new prompt and then enter the HELLO command to
start a new logon process. Echo is turned on after all passwords are
read.
Terminal Types
MPE/iX must be able to 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. Refer to appendix C, "Terminal and Printer Types."
MPE iX:HELLO USER.TECHPUBS;TERM=10
Example
When you initially log on to access MPE/iX, the system prompt appears as:
MPE iX:
When you subsequently log on to another account or group, the system
prompt by default is a colon (unless you have altered it with the SETVAR
HPPROMPT command) and appears as:
:
To start a session named ALPHA, with the user USER, the account TECHPUBS,
the group XGROUP, and the group password XPASS, enter:
MPE iX:HELLO ALPHA,USER.TECHPUBS,XGROUP/XPASS
HP3000 Release: X.50.40 User Version : X.50.40 MON, DEC 12, 1994, 7:15 AM
MPE/iX HP31900 B.78.11 Copyright Hewlett-Packard 1987. All rights reserved.
:
Related Information
Commands BYE
Manuals None
MPE/iX 5.0 Documentation