Changing a UA Parameter Set
Use this procedure to change the values in a UA (user adapter) parameter set using the chg-uaps command. The chg-uaps command uses these parameters.
:set – the UA parameter set being changed, from 1 - 9
:scrset – the source UA parameter set used to copy the values from one UA parameter set to another, from 1 to 10.
:timer – the timer being changed, from 1 to 10. Currently, there are only three timers defined:
- Timer 2 – The False IP Connection Congestion Timer – the maximum amount of time (in milliseconds) that an association is allowed to remain congested before failing due to false connection congestion.
- Timer 3 – The UA Heartbeat Period Timer – The frequency, in milliseconds, that heartbeat messages are transmitted.
- Timer 4 – The UA Heartbeat Received Timer – The amount of time, in milliseconds, that the EAGLE waits for a response to the heartbeat message that was transmitted. If a response to the heartbeat message is not received in the amount of time defined by Timer 4, the association is torn down
:tvalue – The value of the timer specified by the timer parameter.
- The value of timer 2 is from 10 to 30,000 milliseconds. The system default value is 3,000 milliseconds.
- The value of timer 3 is from 100 to 60,000 milliseconds. The system default value is 10,000 milliseconds.
- The value of timer 4 is from 100 to 10,000 milliseconds. The system default value is 5,000 milliseconds.
:parm – the UA parameters, from 1 to 10. Currently, only four UA parameters are defined.
- 1 – Controlling ASPSNM Behavior
- 2 – Controlling ASP/Application Server State Notification Behavior
- 3 – UA Serviceability Options
- 4 – SCTP Payload Protocol Indicator Option
:pvalue – the value of the UA parameters, which is dependent on the parm parameter value. The value of the pvalue parameter is a bit-mapped value, requiring a 0 in the specific bit position to disable the item, or a 1 in the specific bit position to enabled the item. The value of the pvalue parameter is a 32-bit number. Any bits not specified in the following lists are not used.
- If the
parmvalue is 1, the bits used by thepvalueparameter are:- 0 – Broadcast – controls broadcast phase SNMTFPs, TFRs and TFAs that are sent when a destination's status changes. If this flag is set, SNMTFPs/TFRs/TFAs are replicated to all associations/sockets that meet the Multicast SNM Criteria and have this enabled. The default is to enable all broadcast phase messages.
- 1 – Response Method – controls the sending of an SNMTFC/UPU as a reply to a message received on an association/socket for an unavailable destination. The SNMTFC/UPU is replicated to all associations/sockets that have this capability and meet the Response SNM Criteria. The default is to allow the response to be sent.
- 6 – Broadcast Congestion Status Change – controls the sending of unsolicited congestion status changes by an ASP. Unsolicited congestion status messages (TFCs generated when a destination's congestion status changes) are replicated to all ASPs who have this capability and meet the Multicast SNM Criteria. The default is to generate no unsolicited congestion status changes.
Table 6-14 shows the values can be entered for the
pvalueparameter if theparmvalue is 1. Thepvalueparameter value can be entered as a hexadecimal or a decimal number.Table 6-14 Valid PVALUE Parameter Values if PARM=1
Bits Enabled Bits Disabled Hexadecimal Value Decimal Value None
Bit 0 - Broadcast
Bit 1 - Response Method
Bit 6 - Broadcast Congestion Status Change
h’0
0
Bit 0 - Broadcast
Bit 1 - Response Method
Bit 6 - Broadcast Congestion Status Change
h’1
1
Bit 1 - Response Method
Bit 0 - Broadcast
Bit 6 - Broadcast Congestion Status Change
h’2
2
Bit 0 - Broadcast
Bit 1 - Response Method
Bit 6 - Broadcast Congestion Status Change
h’3*
3*
Bit 6 - Broadcast Congestion Status Change
Bit 0 - Broadcast
Bit 1 - Response Method
h’40
64
Bit 6 - Broadcast Congestion Status Change
Bit 0 - Broadcast
Bit 1 - Response Method
h’41
65
Bit 6 - Broadcast Congestion Status Change
Bit 1 - Response Method
Bit 0 - Broadcast
h’42
66
Bit 0 - Broadcast
Bit 1 - Response Method
Bit 6 - Broadcast Congestion Status Change
None
h’43
67
* The system default value
- If the
parmvalue is 2, the bits used by thepvalueparameter are:- 0 – ASP Active Notifications – controls the sending of ASP-Active notifications. If this value is specified, an ASP-Default notification is sent when an ASP transitions to the ASP-ACTIVE state. The default is not to send ASP-Active notifications.
- 1 – ASP Inactive Notifications – controls the sending of ASP-Inactive notifications. If this value is specified, an ASP-Inactive notification is sent when an ASP transitions to the ASP-INACTIVE state. The default is not to send ASP-Inactive notifications.
Note:
To see the ASP activations and inactivations, bits 0 and 1 of the pvalue parameter value need to be enabled. See Table 6-15. - 2 – ASPAS State Query – controls the sending of ASP/AS State notifications on request by an ASP. If this value is specified, the EAGLE responds with ASP and AS state notifications if the remote ASP sends ASP-UP or ASP-INACTIVE, while the local ASP is in the ASP-INACTIVE state, or the remote ASP sends an ASP-ACTIVE notification while the local ASP is in the ASP-ACTIVE state. The default is not to send ASP/AS state notifications.
Table 6-15 shows the values can be entered for the
pvalueparameter if theparmvalue is 2. Thepvalueparameter value can be entered as a hexadecimal or a decimal number.Table 6-15 Valid PVALUE Parameter Values if PARM=2
Bits Enabled Bits Disabled Hexadecimal Value Decimal Value None
Bit 0 - ASP Activate Notifications
Bit 1 - ASP Inactivate Notifications
Bit 2 - ASP AS State Query
h’0*
0*
Bit 0 - ASP Activate Notifications
Bit 1 - ASP Inactivate Notifications
Bit 2 - ASP AS State Query
h’1
1
Bit 1 - ASP Inactivate Notifications
Bit 0 - ASP Activate Notifications
Bit 2 - ASP AS State Query
h’2
2
Bit 0 - ASP Activate Notifications
Bit 1 - ASP Inactivate Notifications
Bit 2 - ASP AS State Query
h’3
3
Bit 2 - ASP AS State Query
Bit 0 - ASP Activate Notifications
Bit 1 - ASP Inactivate Notifications
h’4
4
Bit 0 - ASP Activate Notifications
Bit 2 - ASP AS State Query
Bit 1 - ASP Inactivate Notifications
h’5
5
Bit 1 - ASP Inactivate Notifications
Bit 2 - ASP AS State Query
Bit 0 - ASP Activate Notifications
h’6
6
Bit 0 - ASP Activate Notifications
Bit 1 - ASP Inactivate Notifications
Bit 2 - ASP AS State Query
None
h’7
7
* The system default value
- If the
parmvalue is 3, the bits used by thepvalueparameter are:- 0 – UA Heartbeats – heartbeat messages are sent on connections from the EAGLE to the far-end node that are in the ASP-Down, ASP-Active, and ASP-Inactive states if the bit is enabled.
- 1 – UA Graceful Shutdown – enables the graceful shutdown of IPSG M3UA connections if the bit is enabled.
Table 6-16 shows the values can be entered for the
pvalueparameter if theparmvalue is 3. Thepvalueparameter value can be entered as a hexadecimal or a decimal number.Table 6-16 Valid PVALUE Parameter Values if PARM=3
Bits Enabled Bits Disabled Hexadecimal Value Decimal Value None
Bit 0 - UA Heartbeats
Bit 1 - UA Graceful Shutdown
h’0*
0*
Bit 0 - UA Heartbeats
Bit 1 - UA Graceful Shutdown
h’1
1
Bit 1 - UA Graceful Shutdown
Bit 0 - UA Heartbeats
h’2
2
Bit 0 - UA Heartbeats
Bit 1 - UA Graceful Shutdown
None
h’3
3
* The system default value
- If the
parmvalue is 4, the bit 0, the SCTP Payload Protocol Indicator byte order option, is used by thepvalueparameter. This bit indicates whether the SCTP Payload Protocol Indicator (PPI) in the received or transmitted message should be in the Big Endian and Little Endian byte format.Table 6-17 shows the values can be entered for the
pvalueparameter if theparmvalue is 4. Thepvalueparameter value can be entered as a hexadecimal or a decimal number.Table 6-17 Valid PVALUE Parameter Values if PARM=4
SCTP Payload Protocol Indicator Byte Order Option - Bit 0 Hexadecimal Value Decimal Value Big Endian Byte Format h’0*
0*
Little Endian Byte Format
h’1
1
* The system default value
UA parameter set 10 contains the default values for the UA parameter sets and cannot be changed.
The set and scrset parameter values cannot be the same.
If the scrset parameter is specified, no other optional parameter may be specified.
The timer and tvalue parameters must be specified together. If one is specified, the other must be specified.
The parm and pvalue parameters must be specified together. If one is specified, the other must be specified.
Canceling the RTRV-UAPS Command
Because the rtrv-uaps command used in this procedure can output information for a long period of time, the rtrv-uaps command can be canceled and the output to the terminal stopped. There are three ways that the rtrv-uaps command can be canceled.
- Press the
F9function key on the keyboard at the terminal where thertrv-uapscommand was entered. - Enter the
canc-cmdwithout thetrmparameter at the terminal where thertrv-uapscommand was entered. - Enter the
canc-cmd:trm=<xx>, where<xx>is the terminal where thertrv-uapscommand was entered, from another terminal other that the terminal where thertrv-uapscommand was entered. To enter thecanc-cmd:trm=<xx>command, the terminal must allow Security Administration commands to be entered from it and the user must be allowed to enter Security Administration commands. The terminal’s permissions can be verified with thertrv-secu-trmcommand. The user’s permissions can be verified with thertrv-userorrtrv-secu-usercommands.
For more information about the canc-cmd command, go to Commands User's Guide.
Figure 6-34 Changing a UA Parameter Set