The Change IP over SNA Type of Service (CHGIPSTOS) command is used to change the SNA mode associated with each IP type of service.

Notes:

1. For AF_INET sockets over SNA, the sockets application must select the desired IP type of service before the connection is established. After the connection is established, the sockets application can change the IP type of service, but it has not affect on the SNA mode associated with the underlying APPC conversation carrying the socket connection. The APPC conversation will continue to use the SNA mode that was in effect when the conversation was established.
2. Changes to a SNA mode made with the Change Mode Description (CHGMODD) CL command will not take effect for an APPC device that is currently using that mode until the mode has been started again for the APPC device.

Restriction: The user must have *IOSYSCFG authority to use this command.

Parameters

Keyword	Description	Choices	Notes
TOS	Type of service	*MINDELAY, *MAXTHRPUT, *MAXRLB, *MINCOST, *NORMAL	Required, Key, Positional 1
MODE	Mode	Communications name, *NETATR	Required, Positional 2

Top

Type of service (TOS)

Specifies the IP type of service to be changed.

This is a required parameter.

The possible values are:

*MINDELAY

Minimize delay means that prompt delivery is important for data on this connection.

*MAXTHRPUT

Maximize throughput means that a high data rate is important for data on this connection.

*MAXRLB

Maximize reliability means that a higher level of effort to ensure delivery is important for data on this connection.

*MINCOST

Minimize monetary cost means that lower cost is important for data on this connection.

*NORMAL

Normal service is used for delivery of data.

Mode (MODE)

Specifies the SNA mode description used with this type of service. The mode can be one to eight characters in length. The first character must be A (or a) through Z (or z), or special characters $, #, or @ followed by 0 through 9, A (or a) through Z (or z), $, #, or @.

This is a required parameter.

The possible values are:

*NETATR

The default mode name defined in the network attributes is used.

mode

Specify the name of an SNA mode description.

Restriction: The SNASVCMG and CPSVCMG modes are reserved for system use and cannot be specified for the MODE parameter.

Examples

CHGIPSTOS   TOS(*MINDELAY)  MODE(MODE1)

This command changes the SNA mode for IP type of service *MINDELAY to MODE1.

Error messages

*ESCAPE Messages

CPFA112

IP over SNA type of service not changed.