Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Creates a session on the specified device, provided that the command's user has Programmatic Sessions (PS) capability. (CM)
STARTSESS ldev;[sessionname,]user[/userpass].acct[/acctpass] [,group[/grouppass]]] [;TERM={termtype}] [;TIME=cpusecs] {BS} [;PRI={CS}] {DS} {ES} [{;INPRI=inputpriority}] {;HIPRI } [;NOWAIT] [;INFO=ciinfo] [;PARM=ciparm]
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.
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 or HIPRI 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. 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.
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.
Commands: TUNE Manuals : Performing System Operation Tasks (32650-90137) Process Management Programmer's Guide (32650-60011) Back to Main Index