MPE/iX Commands Reference Manual (32650-90877)

326 Chapter9
Command List VII
Commands MOUNT thru OUTFENCE
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.
• Any UDC files which were cataloged prior to the NEWCI are still cataloged (and thus are
executable via the HPCICOMMAND intrinsic).
• DSLINEs which were opened prior to :NEWCI will be closed.
Use
The NEWCI command can be used to replace the current CI process (which may not be the
standard MPE/iX CI if a NEWCI command was previously done) with the standard MPE/iX
CI. This is done by executing the command “newci ci.pub.sys”. If CI.PUB.SYS is
executed using the NEWCI command, the behavior is slightly different than if it is executed
using the RUN command. The behavior of the MPE/iX CI is identical to its behavior at logon
time.
Examples
NEWCI from a Logon UDC
The most common usage of NEWCI is from a logon UDC (most commonly an OPTION
NOBREAK logon UDC). Many system manager setup their users such that a logon UDC
automatically execute the appropriate application program at logon time. Consider the
following example logon udc:
dologon
option logon nobreak