SET CMS Transient command
Use the SET command to establish, turn off, or reset a particular function in
your CMS virtual machine. Only one function may be specified per SET command.
SET cannot be issued without an option. The format of the SET command is:
+----------+------------------------------------------------------------------+
| SET | ABEND cmd ABBREV ON|OFF |
| | AUTOREAD ON|OFF BLIP string[(count)]|ON|OFF |
| | DOS ON [mode [(VSAM[)]]]|OFF DOSPART nnnnnK|OFF |
| | IMPCP ON|OFF IMPEX ON|OFF |
| | INPUT [a xx|xx yy] LDRTBLS nn |
| | NONSHARE CMSDOS|CMSVSAM|CMSAMS|CMSSEG |
| | OUTPUT [xx a] PROTECT ON|OFF |
| | RDYMSG LMSG|SMSG REDTYPE ON|OFF |
| | RELPAGE ON|OFF |
| | SYSNAME CMSDOS|CMSVSAM|CMSAMS|CMSSEG|name |
| | UPSI nnnnnnnn|OFF |
+----------+------------------------------------------------------------------+
where:
ABEND cmd
sets the ABEND command to 'cmd', where 'cmd' is a CMS command or EXEC
procedure. When an ABEND occurs, 'cmd' is placed on the program stack
to be executed after cleanup from the ABEND. The ABEND buffer is then
cleared to prevent recursion.
ABBREV ON | OFF
controls whether the system accepts system and user abbreviations for
command names, or only full command names or the full synonym.
ON accepts system and user abbreviations for command names. The
SYNONYM command makes synonym abbreviations available.
OFF accepts only the full command name or the full synonym for the
command name.
For a discussion of the relationship of the SET ABBREV and SYNONYM
commands, type HELP SYNONYM.
AUTOREAD ON | OFF
specifies whether or not a console read to be issued immedately after
command execution. ON is the default for non-display terminals; OFF
is the default for display terminals.
BLIP string[(count)] | ON | OFF
defines the characters which are displayed at the terminal to indicate
every 2 seconds of virtual interval time time. This time is made up
of virtual CPU time plus, if the REALTIMER option is on, self-imposed
wait time.
You can define up to 8 characters as a blip string; if you want
trailing blanks, you must specify count. ON and OFF cannot be used as
BLIP characters.
ON sets the BLIP character string to its default, which is a string of
characters that rotates the typeball on a 2471 typewriter terminal.
OFF turns off BLIP. This is the default for display terminals.
DOS ON [mode [(VSAM[)]]] | OFF
turns on or off the CMS/DOS environment.
ON places your CMS virtual machine in the CMS/DOS environment. The
logical unit SYSLOG is assigned to your terminal.
'mode' specifies the mode letter at which the VSE system residence is
accessed; the logical assignment of SYSRES is made for the indicated
mode letter.
VSAM specifies that you are going to use the AMSERV command or you are
going to execute programs to access VSAM data sets.
OFF returns your virtual machine to the normal CMS environment. All
previously assigned system and programmer logical units are
unassigned.
DOSPART nnnnnK | OFF
specifies the size of the partition in which you want a program to
execute in the CMS/DOS environment.
nnnnnK specifies the size of the virtual partition in which you want a
program to execute. The value, nnnnnK, may not exceed the amount of
user free storage available in your virtual machine. You should use
this setting only when you can control the performance of a particular
program by reducing the amount of available virtual storage.
OFF specifies that you no longer want to control your virtual machine
partition size. When the DOSPART setting is OFF, CMS computes
the partition size whenever a program is executed.
IMPCP ON | OFF
controls handling of command names that CMS does not recognize. ON
passes command names that CMS does not recognize to CP; that is,
unknown commands are considered to be CP commands. OFF generates an
error message at the terminal if a command is not recognized by CMS.
IMPEX ON | OFF
controls whether or not EXEC files are treated as commands. ON treats
EXEC files as commands; an EXEC file is invoked when the filename of
the EXEC file is entered. OFF does not consider EXEC files as
commands. You must issue the EXEC command to execute an EXEC file.
INPUT [a xx | xx yy]
translates characters entered from your terminal to hexadecimal code.
INPUT a xx translates the specified character 'a' to the specified
hexadecimal code xx for characters entered from the terminal.
INPUT xx yy allows you to reset the hexadecimal code xx to the
specified hexadecimal code yy in your translate table.
Note: If you issue SET INPUT and SET OUTPUT commands for the same
characters, issue the SET OUTPUT command first.
INPUT returns all characters to their default translation.
LDRTBLS nn
defines the number (nn) of pages of storage to be used for loader
tables. To ensure that the SET LDRTBLS command executes properly, it
must be invoked immediately after IPL. If SET LDRTBLS is issued at
any other time, system results can be unpredictable. By default, a
virtual machine having up to 384K of addressable real storage has two
pages of loader tables; a larger virtual machine has three pages,
while a virtual machine 4MB or greater has sixty four pages.
Each loader table page has a capacity of 204 external names. During
LOAD and INCLUDE command processing, each unique external name
encountered in a TEXT deck is entered in the loader table. The LOAD
command clears the table before reading TEXT files; INCLUDE does not.
This number can be changed with the SET LDRTBLS nn command provided
that: (1) nn is a decimal number between 0 and 128, and (2) the
virtual machine has enough storage available to allow nn pages to be
used for loader tables. If these two conditions are met, nn pages are
set aside for loader tables. If you plan to change the number of
pages allocated for loader tables, you should deallocate storage at
the high end of storage so that the storage for the loader tables may
be obtained from that area. Usually, you can de-allocate storage by
releasing one or more of the disks that were accessed.
NONSHARE CMSDOS | CMSVSAM | CMSAMS | CMSSEG
specifies that you want your own nonshared copy of a normally shared
named system.
OUTPUT [xx a]
sets a hexadecimal representation displayed at the terminal to be
translated to a specified character.
OUTPUT xx a translates the specified hexadecimal representation xx to
the specified character 'a' for all xx characters displayed at the
terminal.
OUTPUT returns all characters to their default translation.
PROTECT ON | OFF
specifies whether or not the CMS nucleus is protected against writing
in its storage area. ON turns protection on; OFF turns it off.
RDYMSG LMSG | SMSG
sets the CMS ready message to its long or short form.
LMSG indicates that the long CMS ready message, including current and
elapsed time, is used. The format of the long Ready message is:
Ready; T=s.ss/s.ss hh:mm:ss
where the virtual processor time (in seconds), real processor time (in
seconds), and clock time are listed.
SMSG indicates that a shortened form of the CMS ready message (Ready;)
which does not include the time, is used.
REDTYPE ON | OFF
sets whether or not CMS error messages are typed in red on certain
terminals equipped with the appropriate terminal feature and a two-
color ribbon.
RELPAGE ON | OFF
sets wheter or not unused pages frames of storage are to be released.
ON releases (returns to CP) unused page frames of storage and sets
them to binary zeros. A page frame is considered usused whenever all
of the storage allocated from it has been returned to CMS.
OFF prevents the release of unused page frames of storage as described
in SET RELPAGE ON. Use the SET RELPAGE OFF function when debugging or
analyzing a problem so that the storage used is not released and can
be examined. Be aware that indiscriminate use of SET RELPAGE OFF can
have a negative impact on overall system performance.
SYSNAME CMSDOS | CMSVSAM | CMSAMS | CMSSEG | name
lets you replace a saved system name entry in the SYSNAMES table with
the name of an alternate, or backup system. A separate SET SYSNAME
command must be issued for each name entry to be changed. CMSVSAM,
CMSAMS, CMSDOS, and CMSBAM are the default names assigned to the
systems when the CMS system is generated.
UPSI nnnnnnnn | OFF
sets the User Program Switch Indicator (UPSI) byte to the specified
bit string, or resets the UPSI byte to binary zeros.
nnnnnnnn sets the UPSI byte to the specified bit string. If you enter
fewer than eight digits, the UPSI byte is filled in from the left and
zero-padded to the right. If you enter an "x" for any digit, the
corresponding bit in the UPSI byte is left unchanged.
OFF resets the UPSI byte to binary zeros.
Usage notes:
1. If you issue the SET command specifying an invalid function and implied CP
(IMPCP) execution is in effect, you may receive message
DMKCFC003E INVALID OPTION - 'option'
2. If an invalid SET command function is specified from an EXEC and implied CP
execution is in effect, then the return code is -0003.
3. To determine or verify the setting of most functions, use the QUERY
command.