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
parm
value is 1, the bits used by thepvalue
parameter are:- 1 – Response Method – controls the sending of an SNM TFC/UPU as a reply to a message received on an association for an unavailable destination. The SNM TFC/UPU is replicated to all associations that have this capability and meet the Response SNM Criteria. The default is to allow the response to be sent.
- 1 – Response Method – controls the sending of an SNM TFC/UPU as a reply to a message received on an association for an unavailable destination. The SNM TFC/UPU is replicated to all associations 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 4-22 shows the values can be entered for the
pvalue
parameter if theparm
value is 1. Thepvalue
parameter value can be entered as a hexadecimal or a decimal number.Table 4-22 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
parm
value is 2, the bits used by thepvalue
parameter 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 4-23. - 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 4-23 shows the values can be entered for the
pvalue
parameter if theparm
value is 2. Thepvalue
parameter value can be entered as a hexadecimal or a decimal number.Table 4-23 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
parm
value is 3, the bits used by thepvalue
parameter 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 4-24 shows the values can be entered for the
pvalue
parameter if theparm
value is 3. Thepvalue
parameter value can be entered as a hexadecimal or a decimal number.Table 4-24 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
parm
value is 4, the bit 0, the SCTP Payload Protocol Indicator byte order option, is used by thepvalue
parameter. 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 4-25 shows the values can be entered for the
pvalue
parameter if theparm
value is 4. Thepvalue
parameter value can be entered as a hexadecimal or a decimal number.Table 4-25 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
F9
function key on the keyboard at the terminal where thertrv-uaps
command was entered. - Enter the
canc-cmd
without thetrm
parameter at the terminal where thertrv-uaps
command was entered. - Enter the
canc-cmd:trm=<xx>
, where<xx>
is the terminal where thertrv-uaps
command was entered, from another terminal other that the terminal where thertrv-uaps
command 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-trm
command. The user’s permissions can be verified with thertrv-user
orrtrv-secu-user
commands.
For more information about the canc-cmd
command, go to Commands User's Guide.
Figure 4-44 Changing a UA Parameter Set