User Guide - MKS

Window Type Opened Associated Environment Variable
Project For an open project window:
Source Integrity Graphical User Interface
MKSSI_WINDOW=project
MKSSI_FILE=server-side-project-path
MKSSI_NMEMBER=number of MKSSI_MEMBERxx entries
MKSSI_NSUBPROJECT=number of MKSSI_SUBPROJECTyy entries
If any members are selected, then the following variables apply:
MKSSI_MEMBERxx=path-relative-to-project
MKSSI_MEMBER_PROJECTxx=server-side-project/subproject-path
If any subprojects are selected, then the following variables apply:
MKSSI_SUBPROJECTyy=path-relative-to-project
MKSSI_SUBPROJECT_PROJECTyy=server-side-project/subprojectpath
That is, if there are n members selected and m subprojects selected then you have
n occurrences of MKSSI_MEMBER numbered from 1 to n and the number n is also
passed in MKSSI_NMEMBER. There are also occurrences of MKSSI_SUBPROJECT,
numbered from 1 to m, and the number m is passed in MKSSI_NSUBPROJECT.
If a subdirectory is selected, then it is as if that subdirectory is recursively
expanded (only the directories, not subprojects) and all members are selected.
Because a given member may not be in the top level project that is open in the
view, each variable for MKSSI_MEMBER and MKSS_SUBPROJECT has a
corresponding entry for MKSSI_MEMBER_PROJECTxx and
MKSSI_SUBPROJECT_PROJECTxx. Therefore, each MEMBER/SUBPROJECT
variable is relative to its corresponding PROJECT entry, not to the top level
indicated in MKSSI_FILE.
For example:
i=1
while [ $i -le $MKSSI_NMEMBER ]
do
eval si command
-P\${MKSSI_MEMBER_PROJECT$i}\${MKSSI_MEMBER$i}
let i=i+1
done
Note: If set, the environment variables MKSSI_VARIANT and MKSSI_BUILD are
also exported when invoking an si command with the options for --devpath and
--projectrevision.
Sandbox For an open sandbox window:
MKSSI_WINDOW=sandbox
MKSSI_FILE=full-path-to-sandbox
MKSSI_NMEMBER=number of MKSSI_MEMBER objects
MKSSI_NSUBPROJECT=number of MKSSI_SUBPROJECT objects
Note: The variables MKSSI_MEMBERxx= and MKSSI_SUBPROJECTxx= take the
same settings as for a project window. The corresponding variables
MKSSI_MEMBER_SANDBOXxx and MKSSI_SUBPROJECT_SANDBOXxx are also as
described for a project. If applicable, MKSSI_VARIANT and MKSSI_BUILD are
also set.
87