Change IP over SNA TOS (CHGIPSTOS)

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

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.