Description status: Functional area: Domain: Privileges: | NSM V21.0A Pubset and MRSCAT management MULTI-CATALOG-AND-PUBSET-MGMT TSOS |
Function
The NSM subsystem is supplied with parameters by means of the SET-NSM-
ENVIRONMENT command. The command is only relevant in XCS networks, and it is only allowed within the NSM configuration file.
The following configuration parameters can be set:
communication path (via HIPLEX MSCF or global storage)
token idling
The settings are made in the SYSSSI.NSM.<version> parameter file of the subsystem for the first system to join the XCS network. All other systems that participate in an XCS network use the settings valid at the time of their entry into the network (see section“Network entry and exit by a processor” and the MODIFY-NSM-ENVIRONMENT command on "MODIFY-NSM-ENVIRONMENT" (Modify NSM configuration parameters)"().
Note
The options offered by the COMMUNICATION-TYPE operand should only be used by persons with good system knowledge.
Format
SET-NSM-ENVIRONMENT | ||||||||||||||||||||
| ||||||||||||||||||||
Operands
COMMUNICATION = *BY-GS-IF-AVAILABLE / *BY-MSCF
The COMMUNICATION operand is still accepted for reasons of compatibility, but is no longer evaluated. The NSM subsystem always communicates via HIPLEX MSCF.
COMMUNICATION-TYPE = *TOKEN-RING(...)
Defines the communication method for NSM.
With the “token ring“ method, all participants in the XCS network are linked in a virtual ring. The token is passed on from system to system for jobs to be bundled, if this is possible, thus reducing the system load.
MINIMAL-DELAY-TIME = *STD / <integer 0..32767 milliseconds>
Defines the time (in milliseconds) which the token is delayed before being passed on again to the next system. The value “0” means that the token is passed on without any delay. The default setting is *STD, i.e. in normal operation the token is delayed for 15 milliseconds.
Note
The smaller the value that is set for MINIMAL-DELAY-TIME, the greater the network load will be. It is therefore possible to regulate the network load by setting an appropriate value. However, it should be noted that setting too high a value may have a negative effect on the reaction time of NSM. As a matter of principle, these settings should only be made by people with good system knowledge.
MAXIMAL-DELAY-TIME = *STD / <integer 1..32767 milliseconds>
Defines the time (in milliseconds) which the token is idle before being passed on to the next system.
The default setting is *STD, i.e. the token is idle for 100 milliseconds.
Return codes
| (SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
| 0 | CMD0001 | Command executed without error | |
| 1 | NLX1009 | Commando only allowed in the NSM configuration file | |
| 3 | CMD2203 | Wrong syntax file | |
| 32 | CMD0221 | System error (internal error) | |
| 64 | CMD0216 | User is not privileged |