HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 4  Command Definition F-K

HELLO

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Initiates an interactive session. (Native Mode)

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 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 HIPRI

Determines the input priority of the job. The 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

Feedback to webmaster