'.
CMDMDL Statement
The CMOMOL statement defines commands and command lists to NetView. For commands, CMOMOL shows the command name, the module that processes the command, the command type, and when the command module is loaded, You need to write CMOMOL statements for command lists when:
• You want them scope checked.
• You want synonyms for them.
If a command or command list has a CMOMOL statement, then it can be scope checked using the CMOCLASS statement. Refer to Appendix 0, "Command Keywords and Values that can be Scope Checked" on page 139 for a list of the NetView command keywords and their values that can be scope checked.
The CMOMOL statement is used in the OSICMO member of OSIPARM.
commandname
is the name of the command or command list.
MOD = modulename
shows the name of the module that processes the command. NetView command modules begin with the letters AAU, BNJ, CNM, or 051. For command lists, use MOD= DSICCP.
Note: When you define a user-written command procedure, be sure to specify a unique module name on the MOD operand. Do not use a name that might be recognized by the system as a command, because NetView will attempt to execute that command instead of the user-written command procedure.
TYPE
=
BlIIBIDIRDshows the command type. If CTL=S is used to define PA or PF keys, then TYPE=I
is requi red.
Note: Do not define regular command procedures with TYPE = I or TYPE = B.
B.
is a regular command. If TYPE is not coded in the CMOMOL statement,TYPE=R is assumed. Only one regular command runs at a time for an operator. If an operator enters a regular command while another regular command is running, the second command is held by NetView and runs after the first command is finished. Regular commands .are allowed in command lists. This is the default.
is an immediate command. An immediate command interrupts a regular command. Immediate commands are usually screen control or error recovery commands. When an immediate command is running, the key-board is locked and other commands cannot be enterecf. Immediate com-mands are not allowed in command lists or as initial comcom-mands. They also cannot be used with the PPT operand of the AT, EVERY, and AFTER com-mands.
B is a command that can run as either a regular or an immediate command.
If an operator enters the command at a terminal, NetView treats it as an immediate command. If the command is in a command list, NetView treats it as a regular command.
D is a data services command. Data services command procedures run under a data services task (DST). Because these commands are internal, operators cannot enter them at their terminals. Some internal commands that support the session and hardware monitors are TYPE = D.
RD is a regular or data services command. An example is the SWITCH
command.
CTL-~.lS
controls whether the command is normal (N) or special (s). If CTL=S is used to define PA or PF keys, then TYPE = I is required.
H
means that the command is normal. N is the default.S means that the command is special. Special means that PA or PF keys are defined as commands. For commands you want to be able to set to a key, you must use MOD= DSIPFK.
Note: Do not use CMDMDL statements to define PF keys to regular command procedures.
RES-YIN
specifies whether the command module is loaded when NetView is initialized.
At initialization, when NetView loads only frequently used command modules, you save storage. However, if you load all command modules at initialization, performance can be degraded because less operating storage is available.
Y
means the command module is loaded at NetView initialization and remains resident in storage. Y is the default.N means the command module is not loaded until the command is run, and the storage that is used is freed upon completion.
If the following commands are coded RES=N, NetView automatically makes them RES=Y:
• All VTAM commands
• DSICCP (command lists command processor)
• AGAIN, BGNSESS, DSIYCLF, DSIYCTRM, DSIYOCRM, DSIYOFPM, DSIYOLRP, DSIYOMRP, DSIYOSRP, DSIYOTP, DSIYPIF, LOGOFF, REPLY, START, STOP.
ECHO-YINO
controls whether a command is echoed to the screen after an~ operator enters it. For commands in command lists, the setting for &CONTROL determines the echo status. TYPE = I and TYPE = B commands are not echoed after they are entered from a terminal.
CMDMDL
y
means an entered command is echoed. Y is the default.N means an entered command is not echoed.
Notes:
1. Code ECHO = N for all commands and command lists that invoke full-screen panel displays.
2. Commands that are echoed to the screen are subject to message automation if they match the conditions in an IF-THEN automation statement.
PARSE-YIN
specifies whether to parse the message buffer.
Note: This operand is recognized only by OST processing.
y
means to parse the message buffer. Y is the default.N means that the message buffer is not parsed. PARSE
=
N improvescommand processor performance for user-written command procedures that do not use the parse buffer pos. For information on how to write command procedures, see NetView Customization: Using Assembler.
Related Statements: CMOCLASS, CMOSYN, KEYCLASS, PARMSYN, VALCLASS