VIPADYNAMIC - VIPASMPARMS statement

Defines service manager parameters. See z/OS Communications Server: IP Configuration Guide for more information about setting up sysplex distributor to be the Service Manager for Cisco's MNLB. This support applies only to IPv4.

Requirements:
  • The VIPASMPARMS statement is required when any VIPADEFINE or VIPABACKUP statement in the profile contains the SERVICEMGR keyword, and it is permitted even if no active VIPADEFINE or VIPABACKUP statements in the profile currently contain the SERVICEMGR keyword.
  • The VIPASMPARMS and SERVICEMGR parameters (on a VIPADEFINE statement) must be specified on the primary distributing stack (the stack identified by the VIPADEFINE statement) for the cluster address. The information is communicated to all backup stacks through expansion of the MVS™ XCF messaging messages used for normal DVIPA takeover processing. These parameters cannot be overridden on the backup stack.
Results:
  • If the VIPASMPARMS statement is included without any VIPADEFINE or VIPABACKUP statements designated as SERVICEMGR, the values specified in this statement are saved and displayed in Netstat configuration displays.
  • If a Distributed DVIPA is designated as SERVICEMGR on its VIPADEFINE statement, but one or both of SMMCAST group and SMPORT are not valid at the conclusion of profile processing, a console message is issued, and the Distributed DVIPA is not treated as SERVICEMGR at that point. However, the designation is saved in order that a subsequent VARY TCPIP,,OBEYFILE command that adds valid SMMCAST group and SMPORT values allows the cluster address to be treated as SERVICEMGR for all subsequent TCP connection requests.
  • If a backup stack detects that inconsistent VIPASMPARMS statement values have been specified (by two different Sysplex stacks, for both of which this backup stack is backup for Distributed DVIPAs), this is considered a Sysplex configuration error, and the backup stack issues a console warning message.

Syntax

Rule: Specify the parameters in the order shown here.

Read syntax diagramSkip visual syntax diagram
>>-SMMCASTgroup --ipaddr--SMPORT --port------------------------->

>--+-----------------------+-----------------------------------><
   '-SMPASSWORD --password-'   

Parameters

SMMCASTGROUP ip_addr
Specifies the multicast address used for communications between the sysplex distributor and the Cisco routers acting as forwarding agents.
SMPORT num
Specifies the UDP port used for communications between the sysplex distributor and Cisco forwarding agents.

The number is in the range 1 - 65 535.

SMPORT usage begins when the first dynamic VIPA with the service manager attribute is defined as distributable. At that point, a console message is issued if the same port value is already specified on an active PORT statement for that UDP port. Similarly, if a subsequent PORT statement is encountered after SMPORT usage begins for that same port, the subsequent PORT statement is rejected with a console message.

SMPASSWORD string
Specifies the password to enable MD5 encryption for all communication between sysplex distributor and forwarding agents. This is a 1 - 64 character alphanumeric string. For both the forwarding agents and the sysplex distributor, the password is treated simply as ASCII characters. No translation or conversion is performed.

Requirement: The password must match the one configured on Cisco forwarding agents.

Steps for modifying

To modify any of the parameters on this statement, you must respecify the statement with the changed parameter values.

Examples

VIPASMPARMS SMMCASTGROUP 224.0.0.10 SMPORT 50000