Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Initiates an interactive session.
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]
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.
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.
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
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. ...
Commands: BYE Back to Main Index