MPE/iX Commands Reference Manual (32650-90877)

Chapter 9 325
Command List VII
Commands MOUNT thru OUTFENCE
Syntax
NEWCI
progfile [,["] entrypoint ["]]
[;NOPRIV] [;LMAP] [;DEBUG] [;MAXDATA=
maxstack ] [;PARM= parameternum ]
[;STACK=
stacksize ] [;DL= dlsize ] [;NMSTACK= nmstacksize ]
[;NMHEAP= nmheapsize ]
[;LIB= { G P S} ] [;XL="
library [, ...]"] [;NOCB]
[;INFO="
quotedstring "] [;UNSAT=["] unsatproc ["]]
[;STDIN=[{
*formaldesigfileref $NULL} ]]
[;STDLIST=[{
*formaldesigfileref [,NEW][$NULL]} ]]
[;PRI={ BSCSDSES} {#}]
Parameters
All of the parameters for the NEWCI command are identical (syntactically and
semantically) to the RUN command. See the help text for RUN for complete descriptions of all
the parameters except the “progfile” parameter.
progfile The name of the program file to be executed. The file name can be
specified in either MPE syntax (the default) or HFS syntax (where the
name must begin with either a . or a /). If the file name is specified using
MPE Syntax, it does not have to be fully qualified. File names which are
not fully qualified will be qualified based on the current logon
environment. The filename may be redirected with a file equation. If the
file name is expressed using HFS syntax (e.g.: the name begins with a . or
a /), and the file name refers to a file outside of MPE name space (e.g.: the
file is not in an MPE group/account), then some restrictions apply.
The following restrictions are placed on programs outside of MPE name
space:
• The program cannot be linked with PM, MR, or DS capability.
Programs linked with these capabilities will not load.
• 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.
Operation
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 is 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.