HP 3000 Manuals HP 3000 Manuals
STARTSESS
Creates a session on the specified device, if the user has programmatic
sessions (PS) capability.
Syntax
STARTSESS ldev;[sessionname,]user[/userpass]
.acct[/acctpass][,group[/grouppass]] [;TERM={termtype}][;TIME=cpusecs]
[ {BS}]
[;PRI= {CS}][{;INPRI=inputpriority}] [;NOWAIT][;INFO=ciinfo][;PARM=ciparm]
[ {DS}][{;HIPRI }]
[ {ES}]
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 distributed
system (DS) pseudo terminal. The terminal must be
configured as type 16 and as subtype 0 or 4.
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 to 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. If a password exists, but is
not supplied in the command syntax, STARTSESS will
prompt you for it if:
* STARTSESS is invoked from a session.
* Neither $STDIN nor $STDLIST is redirected.
* STARTSESS is a first level command (it is
not nested within a second level STREAM
command, or any other second level command
such as JOB).
If the password is supplied in the command syntax
it must be preceded by a slash (/).
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. If a password exists, but is
not supplied in the command syntax, STARTSESS will
prompt you for it if:
* STARTSESS is invoked from a session.
* Neither $STDIN nor $STDLIST is redirected.
* STARTSESS is a first level command (it is
not nested within a second level STREAM
command, or any other second level command
such as JOB).
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 exists. If a password exists,
but is not supplied in the command syntax,
STARTSESS will prompt you for it if:
* STARTSESS is invoked from a session.
* Neither $STDIN nor $STDLIST is redirected.
* STARTSESS is a first level command (it is
not nested within a second level STREAM
command, or any other second level command
such as JOB).
If the password is supplied in the command syntax
it must be preceded by a slash (/).
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, 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."
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.
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.
inputpriority or Determines the input priority of the job or
HIPRI 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:
* When using the HIPRI option to override the
jobfence, the system first checks to see if
you have system manager (SM) or system
supervisor (OP) capability. The user who
has either of these capabilities is logged
on, and the INPRI defaults to the system
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 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 does not override
the session limit automatically.
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)
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 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. 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 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.
Operation Notes
This command is used to create a session at any terminal on the system.
The effect is the same as if a user had logged on at the target terminal.
STARTSESS prompts for any necessary passwords that are not supplied in
the command syntax if:
* STARTSESS is invoked from a session.
* Neither $STDIN nor $STDLIST is redirected.
* STARTSESS is a first level command (it is not nested within any
second level command, such as JOB).
NOTE The target terminal must be turned on and available, and no other
user may be logged on.
No speed sensing is done for the target terminal, so it must be set
at the configured baud rate.
When a session is started on the designated terminal, by default it
waits for a Return before printing to the terminal, unless NOWAIT
is specified.
Use
This command is available from a session, job, program, or in BREAK.
Pressing Break has no effect on this command. Programmatic sessions (PS)
capability is required to use this command.
Example
To start a session named CH5, with the username ERNST, accountname UDET,
groupname JASTA11, and grouppass PASS on LDEV 21, enter:
STARTSESS 21;CH5,ERNST.UDET,JASTA11/PASS
Related Information
Commands TUNE
Manuals Process Management Programmer's Guide (32650-60011)
Performing System Operation Tasks (32650-90137)