STARTSESS

The logical device number of the target terminal. This terminal must be a real physical device and cannot be a virtual terminal or a distributed system (DS) pseudo terminal. The terminal must be configured as type 16 and as subtype 0 or 4.

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

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

User password, optionally assigned by the account manager. The password may contain from one to eight alphanumeric characters, beginning with an alphabetic character. If a password exists, but is not supplied in the command syntax, STARTSESS will prompt you for it if:

If the password is supplied in the command syntax it must be preceded by a slash (/).

Account name established by the system manager. The name may contain from one to eight alphanumeric characters, beginning with an alphabetic character. A period (.) must precede the acct parameter.

Account password, optionally assigned by the system manager. The password may contain from one to eight alphanumeric characters, beginning with an alphabetic character. If a password exists, but is not supplied in the command syntax, STARTSESS will prompt you for it if:

Group name to be used for the local file domain and the CPU-time charges established by the account manager. The name may contain from one to eight alphanumeric characters, beginning with an alphabetic character. Default is the specified users home group if you are assigned one by the account manager. The parameter is required if a home group is not assigned.

The grouppass parameter is not needed when the user logs on under the user's home group, even if a password has been established. The grouppass is needed when the user logs on under any other group for which a password exists. If a password exists, but is not supplied in the command syntax, STARTSESS will prompt you for it if:

If the password is supplied in the command syntax it must be preceded by a slash (/).

Determines terminal-type characteristics. The value of 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. The value must be 10, 18, 20, or 21. The default value for termtype is assigned by the system supervisor during system configuration. This parameter is required to ensure correct listings if your terminal is not the default termtype.

If group and/or account names are omitted, the proposed logon group and/or account name is substituted. Refer to appendix C, "Terminal and Printer Types."

Maximum CPU-time that a session may use, entered in seconds. When the limit is reached, the session is aborted. It must be a value from 1 to 32,767, provided that it does not exceed any limit imposed by the system or account manager. To specify no limit, enter a question mark (?) or UNLIM, or omit the parameter. Default is no limit.

The execution priority queue that the command interpreter uses for your session, and 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.

	CAUTION: Care should be used in assigning the BS queue, because processes in this priority class lock out other processes. For information on the guidelines for these priority queues, refer to the TUNE command in this chapter. Default is CS.

Determines the input priority of the job or session. 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 a value 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:

If the HIPRI option is used without SM or OP capability, the following warning is displayed:

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

Request that the session starts executing immediately without waiting for a Return on the terminal. If this parameter is specified and the target terminal is the system console, system manager (SM) capability is required.

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.

The command interpreter parameter number you wish to use. If you are using the MPE/iX command interpreter, the numbers accepted are:

Any other value is treated as zero (0). The MPE/iX CI distinguishes between a ciparm 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. An error message is not produced.

TUNE

Process Management Programmer's Guide

Performing System Operation Tasks