MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 10 619
Command Definitions (QUIT-ZSIZE)
STARTSESS
STARTSESS
NM and CM callable.
Initiates a session on the specified terminal. Programmatic sessions (PS) capability is
required.
Syntax
I16V CA I16 I32 I16A
STARTSESS(
ldev,logonstring,jsid,jsnum,jsstatus
);
Parameters
ldev
16-bit signed integer by value (required)
The logical device number of the target terminal (the terminal on which
the session is to be created). The target terminal must be a real physical
device, free and available to the system, job-accepting, and hardwired. In
addition, the target terminal must be configured as TYPE 16, and SUBTYPE
0 or SUBTYPE 4.
The target terminal must be set to the configured baud rate, since there is
no baud rate sensing by STARTSESS.
logonstring
character array (required)
Passes the logon string required to initiate the session on the terminal
specified by
ldev
. The first characters in the string should be the session
name, if specified, or the user name if no session name is assigned.
Passwords must be supplied in
logonstring
. (There is no prompting for
passwords on the target terminal.) If passwords are required but not
supplied in
logonstring
, STARTSESS fails.
You must place a carriage-return character (%15) in the element following
the last valid character of
logonstring
.
The
logonstring
parameter is a superset of the HELLO command syntax
and includes a new option, nowait. The nowait option allows you to
override the requirement of a
Return key entered at the target terminal.
jsid
16-bit signed integer by reference (required)
Returns the value 1, indicating that
jsnum
is a session number.
jsnum
32-bit signed integer by reference (required)
Returns a number uniquely identifying the session that was created on the
target terminal.
jsstatus
16-bit signed integer array (required)
Returns a two-element array containing status information. The second
element is reserved for the operating system. The first element returns the