Communicator e3000 MPE/iX Release 6.5 (Non-Platform Software Release C.65.00 (30216-90291)

76 Chapter3
Growth Solution
NEWCI Command (CI Elimination)
• If the program is linked with PH capability, then users must have PH
capability to load the program.
• CM Programs cannot be loaded from the HFS directory.
For detailed information on any of the other NEWCI parameters, refer to the RUN command
help text.
Operation and Use of New Command
The syntax for the NEWCI command (and all of the parameters) is identical to the RUN
command. The behavior of the NEWCI command differs from the RUN command in several
important ways:
• NEWCI replaces the calling process with the specified one. The calling process is
terminated.
• NEWCI is executable only from a session.
• NEWCI is only executable from the root CI process.
• NEWCI will cause
BREAK to be disabled (see OPERATION below).
• NEWCI is intended for a very specific use (see OPERATION below), RUN is a more
“general purpose” command.
The NEWCI command can only be executed from a session; it is not allowed in a job.
The NEWCI command is only executable from the root CI process, which is sometimes
referred to as the usermain process. Normally, NEWCI is executed from the root CI process
when executing a logon UDC. If a NEWCI command is executed, then the newly created
process replaces the existing root CI process and becomes the new root CI process for that
session. The NEWCI command can be executed programmatically provided the caller is
executing in a session and the calling process is the root process for the session.
The NEWCI command is not executable in break mode. If a user runs a program (via the RUN
command) and then hits
BREAK, then that user’s session is in break mode. The SHOWME
command displays a message indicating a session is in break mode. When in break mode,
if the user tries to execute another program via the NEWCI command (or the RUN command),
then the user will be asked if they wish to abort the program that is current running. If the
user answers “YES” then the current program will be aborted and the new program will
execute. In the case of NEWCI, the new program will replace the existing CI process.
The NEWCI command disables break handling for the session. Break remains disabled even
if the program calls FCONTROL to re-enable break. The only way to re-enable break for the
session is to execute “newci ci.pub.sys”. This causes the MPE/iX Command Interpreter
to replace the current CI, and CI.PUB.SYS re-enables break. CI.PUB.SYS also re-executes
logon UDCs which may in turn disable break via the option nobreak feature.
NEWCI effects various session resources as follows:
• Any file equations which were set prior to :NEWCI are preserved.
• Any variables which have been set prior to :NEWCI are preserved.
• Any temporary files which have been created prior to :NEWCI are preserved.