STARTSESS


STARTSESS

     Creates a session on the specified device, provided that the
command's user has Programmatic Sessions (PS) capability. (CM)

SYNTAX

     STARTSESS ldev;
[sessionname,]user[/userpass].acct[/acctpass][,group[/grouppass]]]
[;TERM={termtype}]
[;TIME=cpusecs]
[;PRI={BS} | {CS} | {DS} | {ES}]
[{;INPRI=inputpriority}]
{;HIPRI }
 [;NOWAIT]
[;INFO=ciinfo]
[;PARM=ciparm]


PARAMETERS


ldev The logical device number of the target terminal.
This terminal must be a real physical device and
cannot be a virtual terminal or a DS pseudo
terminal. The terminal must be configured as TYPE
16 and as SUBTYPE 0 or 4.

NOTE


All required passwords must be specified in the command invocation;
STARTSESS will not prompt the caller or the ldev for passwords.
Omitting a missing password where one is required will cause the command
to fail.

sessionname 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 User name, established by the account manager, that
allows you to log on under this account. The name
may contain from one to eight alphanumeric
characters, beginning with an alphabetic character.

userpass User password, optionally assigned by the Account
Manager. The password may contain from one to eight
alphanumeric characters, beginning with an
alphabetic character.

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

acctpass Account password, optionally assigned by the system
Manager. The password may contain from one to eight
alphanumeric characters, beginning with an
alphabetic character. A slash (/) must precede the
acctpass parameter.

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

grouppass 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 has been established. A slash
(/) must precede the parameter grouppass.

termtype 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 or 18. 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.

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

BS, CS, DS, or ES 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.

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

inputpriority 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 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. The user who has either
of these capabilities will be logged on, and the
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 the session limit is not exceeded.
In attempting to override the session limit (to log
on after the maximum number of sessions set by the
operator has been reached), you can specify HIPRI,
but, in this case, you must have either SM or OP
capability. The system will not override the the
session limit automatically. 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)

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

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 takes the place of 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 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.

-1 UDCs are not cataloged. The CI banner and
the WELCOME message are not displayed.
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.

Any other value is treated as zero (0). The MPE/iX
CI distinguishes between ciparm's 1, 3, 5 and 0, 2,
4 when it is run from within the CI--that is, after
the session has logged on.

OPERATION

     The MPE/iX user employs this command to create a session at
any terminal on the system. The effect will be the same as
if a user had logged on at the target terminal.

This command is available from a session, job, in BREAK, or
from a program. Pressing [Break] has no effect on this
command. It requires Programmatic Sessions (PS) capability.

The target terminal must be available, no other user must be logged
on, and the terminal must be turned on. Since no speed sensing is
done for the target terminal, it must be set at the configured baud rate.

When the session is created, nothing will be printed to the target
terminal until its [Return] key is pressed, unless NOWAIT was specified.

ADDITIONAL INFORMATION

Commands:   TUNE

Manuals : Performing System Operation Tasks (32650-90137)
Process Management Programmer's Guide (32650-60011)