the next higher 4K boundary. The loader automatically moves a module to the
next higher 4K boundary if it cannot fit in with its predecessors on the load list. In
this case a message is placed on the load map: "SPB INSERTED" as part of the line _____ SYMBOL DICTIONARY FOR DMKXXX" .. - _ .. _--_ ..•.. _- .. _ .......... _ .... - .. _--- An SPB card is required only for the first module following DMKCPE. If more
than one module is to be contained in a 4K page, only the first can be assembled
with an SPB card. The second and subsequent modules for a mUltiple module 4K
page must not contain SPB cards.
The position of two modules in the loadlist is critical. All modules following
DMKCPE must be reenterable and must not contain any address constants refer­
ring to anything in the pageable CP area. DMKCKP must be the last module in
the loadlist. It is also recommended that DMKPSA be the first module in the CP
resident nucleus.
No change should be made to the sequence of modules in the resident or page able
portion of the loadlist. I I I /
\ ------------=:::=::::::---------_._---_ ... -------- .. -.---::--- ... "-- I. CP Conventions 279

How to Add a Console Function to CP
Installations may add their own commands to their VM/SP system. First, code the
module to handle the command processing. Follow the CP coding conventions out­
lined in an earlier section of this book. Second, add an entry for the command in the CP DMKCFC module. DMKCFC
has two entry points: one for logged-on users and another for nonlogged-on users.
If the command is for logged-on users, be sure its entry is beyond the label COMNBEG1. To place an entry for the command in the DMKCFC module, insert a line with the
following format:
[label] COMND commandname,class,min,entrypt[,NCL= 1]
where:
commandname is a 1-to 8-character name.
class
min
entrypt
NCL=l
is the command privilege class (up to four classes are allowed). 0 is
coded for nonlogged-on user commands or when NCL= 1.
is the number of characters allowed as the minimum truncation.
is the entry point of the module you write to process the new com­
mand.
is specified if the command is to be allowed before the user logs on.
When NCL= 1, the class is not checked.
After the above entry has been inserted in the DMKCFC module, reload
DMKCFC as a pageable module ensuring that it does not cross a page boundary.
You must also load your own module which mayor may not be a resident module. 280 VM/SP System Programmer's Guide