| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Network Attributes (CHGNETA) command changes the network attributes of a system. A network attribute is control information about the communications environment. Network attributes contain specifications that can be used for networking and communications.
Restrictions:
Notes:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SYSNAME | System name | Character value, *SAME | Optional |
| LCLNETID | Local network ID | Communications name, *SAME | Optional |
| LCLCPNAME | Local control point name | Communications name, *SAME | Optional |
| LCLLOCNAME | Default local location name | Communications name, *SAME | Optional |
| DFTMODE | Default mode | Communications name, *SAME | Optional |
| NODETYPE | Node type | *SAME, *ENDNODE, *NETNODE, *BEXNODE | Optional |
| DTACPR | Data compression | 1-2147483647, *SAME, *NONE, *REQUEST, *ALLOW, *REQUIRE | Optional |
| DTACPRINM | Intermediate data compression | 1-2147483647, *SAME, *NONE, *REQUEST | Optional |
| MAXINTSSN | Maximum intermediate sessions | 0-9999, *SAME | Optional |
| RAR | Route addition resistance | 0-255, *SAME | Optional |
| NETSERVER | Network node servers | Single values: *SAME, *NONE Other values (up to 5 repetitions): Element list |
Optional |
| Element 1: Server network ID | Communications name, *LCLNETID | ||
| Element 2: Control point name | Communications name, *ANY | ||
| ALRSTS | Alert status | *SAME, *ON, *OFF, *UNATTEND | Optional |
| ALRLOGSTS | Alert logging status | *SAME, *NONE, *LOCAL, *RCV, *ALL | Optional |
| ALRPRIFP | Alert primary focal point | *SAME, *NO, *YES | Optional |
| ALRDFTFP | Alert default focal point | *SAME, *NO, *YES | Optional |
| ALRBCKFP | Alert backup focal point | Single values: *SAME, *NONE Other values: Element list |
Optional |
| Element 1: Network ID | Communications name, *LCLNETID | ||
| Element 2: Control point name | Communications name | ||
| ALRRQSFP | Alert focal point to request | Single values: *SAME, *NONE Other values: Element list |
Optional |
| Element 1: Network ID | Communications name, *LCLNETID | ||
| Element 2: Control point name | Communications name | ||
| ALRCTLD | Alert controller description | Name, *SAME, *NONE | Optional |
| ALRHLDCNT | Alert hold count | 0-32767, *SAME, *NOMAX | Optional |
| ALRFTR | Alert filter | Single values: *SAME, *NONE Other values: Qualified object name |
Optional |
| Qualifier 1: Alert filter | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| MSGQ | Message queue | Single values: *SAME Other values: Qualified object name |
Optional |
| Qualifier 1: Message queue | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| OUTQ | Output queue | Single values: *SAME Other values: Qualified object name |
Optional |
| Qualifier 1: Output queue | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| JOBACN | Network job action | *SAME, *REJECT, *FILE, *SEARCH | Optional |
| MAXHOP | Maximum hop count | 1-255, *SAME | Optional |
| DDMACC | DDM/DRDA request access | Single values: *SAME, *REJECT, *OBJAUT Other values: Qualified object name |
Optional |
| Qualifier 1: DDM/DRDA request access | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| PCSACC | Client request access | Single values: *SAME, *REJECT, *OBJAUT, *REGFAC Other values: Qualified object name |
Optional |
| Qualifier 1: Client request access | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| DFTNETTYPE | Default ISDN network type | Character value, *SAME, *ATT, *DBP1TR6, *ETSI, *JAPAN, *NISDN, *NORTEL, *NORTHAMT1 | Optional |
| DFTCNNLST | Default ISDN connection list | Name, *SAME | Optional |
| ALWANYNET | Allow AnyNet support | *SAME, *NO, *YES | Optional |
| NWSDOMAIN | Network server domain | Character value, *SAME, *SYSNAME | Optional |
| ALWVRTAPPN | Allow APPN virtual support | *SAME, *NO, *YES | Optional |
| ALWHPRTWR | Allow HPR transport tower | *SAME, *NO, *YES | Optional |
| VRTAUTODEV | Virtual ctl autocreate dev | 1-254, *SAME | Optional |
| HPRPTHTMR | HPR path switch timers | Element list | Optional |
| Element 1: Network priority | 1-10000, *SAME, *NONE | ||
| Element 2: High priority | 1-10000, *SAME, *NONE | ||
| Element 3: Medium priority | 1-10000, *SAME, *NONE | ||
| Element 4: Low priority | 1-10000, *SAME, *NONE | ||
| ALWADDCLU | Allow add to cluster | *SAME, *NONE, *ANY, *RQSAUT | Optional |
| MDMCNTRYID | Modem country or region ID | Character value, *SAME | Optional |
| Top |
Specifies the name assigned to the system. The name can contain up to 8 alphanumeric characters. If the system name is not set, it is defaulted at initial program load (IPL) to the machine serial number (with the first character changed, if necessary, to an alphabetic character).
| Top |
Specifies the local network ID assigned to the system.
| Top |
Specifies the name of the local control point for the system. If the local control point name is not set, it is defaulted at initial program load (IPL) to the machine serial number with the first character changed (if necessary) to an alphabetic character.
| Top |
Specifies the default local location name for the system. If the default local location name is not set, it is defaulted at initial program load (IPL) time to the machine serial number (with the first character changed, if necessary, to an alphabetic character).
| Top |
Specifies the default mode for APPC and APPN locations.
| Top |
Specifies the APPN node type.
| Top |
Specifies the level of data compression used when the system is an SNA end node.
If data compression is requested by the remote system, the data compression levels used by the session are the lower of the requested levels and the configured levels.
The data compression levels that the local system will request are the configured levels. The negotiated data compression levels can never exceed the configured values.
If data compression is requested by the remote system, the data compression levels used by the session are the lower of the requested levels and the configured levels.
The data compression levels that the local system requires are the configured levels.
| Top |
Specifies the level of data compression to request when the system is an SNA intermediate node.
| Top |
Specifies the maximum number of APPN intermediate sessions. This parameter is used only when *NETNODE or *BEXNODE is specified for the Node type (NODETYPE) parameter.
| Top |
Specifies the APPN route addition resistance. This parameter is used only when *NETNODE or *BEXNODE is specified for the Node type (NODETYPE) parameter.
| Top |
Specifies the APPN network node servers. This parameter is used only when *ENDNODE or *BEXNODE is specified for the Node type (NODETYPE) parameter.
A network node server is a network identifier (ID) qualified by a control point name.
Single values
Other values (up to 5 repetitions)
Element 1: Server network ID
Element 2: Control point name
| Top |
Specifies whether local alerts are created. When alert status is active, alerts are created for all of the messages that have been defined as alertable and that report a permanent error with network lines, local devices or control units, or programming and operator errors.
| Top |
Specifies which alerts are logged.
| Top |
Specifies whether the system is an alert primary focal point. If the system is defined as a primary alert focal point, alerts are received from all network nodes explicitly defined in the sphere of control.
| Top |
Specifies whether the system is an alert default focal point. If the system is defined as a Default Focal Point, alerts are received from all nodes in the network which are not explicitly defined in the sphere of control of some other focal point node within the network.
| Top |
Specifies the name of the system that provides alert focal point services if the primary focal point is unavailable.
Single values
Element 1: Network ID
Element 2: Control point name
| Top |
Specifies the name of the system that is requested to provide alert focal point services.
Single values
Element 1: Network ID
Element 2: Control point name
| Top |
Specifies the name of the controller through which alerts are sent on the alert controller session. Only a type HOST or APPC controller can be specified. The controller must be varied on for alert processing to be operational on the alert controller session, although it does not need to be varied on when this command is used.
| Top |
Specifies the maximum number of alerts that are created before the alerts are sent over the alert controller session (ALRCTLD network attribute). The alerts are held (queued) by the system until the specified number of alerts have been created. This parameter can be used to manage alerts that are sent over a limited resource by reducing the number of times alerts are sent.
Note: The ALRHLDCNT network attribute applies only when the ALRCTLD network attribute is used. When management services sessions, APPN, and sphere of control support are used, the ALRHLDCNT value is ignored.
| Top |
Specifies the qualified name of the alert filter used by the alert manager when processing alerts. The alert filter must exist in the system auxiliary storage pool (ASP) or in a basic user ASP.
Single values
Qualifier 1: Alert filter
Qualifier 2: Library
| Top |
Specifies the name and library of the message queue where messages received through the SNADS network are sent for users who have no message queue specified in their user profile, or whose message queue is not available. The message queue must exist in the system auxiliary storage pool (ASP) or in a basic user ASP.
Single values
Qualifier 1: Message queue
Qualifier 2: Library
Note: When *LIBL is used as the library name, the library list of the thread calling this command is searched to find a message queue with the object name specified. If the message queue is found, the name of the library in which it is found is used as the name stored. If the message queue is not found, an exception is signaled and no network attributes are changed. When the library name or *CURLIB is specified, this command attempts to find the message queue. If the message queue cannot be found in the library specified, a diagnostic message is sent. If all other parameters on the command were specified correctly, the MSGQ network attribute is changed to the qualified message queue name, whether or not this command is able to find the message queue in the library specified.
| Top |
Specifies the name and library of the output queue to which spooled files received through the SNADS network are sent for users whose output queue is not available.
Single values
Qualifier 1: Output queue
Qualifier 2: Library
Note: When *LIBL is used as the library name, the library list of the thread calling this command is searched to find an output queue with the object name specified. If the output queue is found, the name of the library where it is found is used in the name stored. If the output queue is not found, an exception is signaled, and no network attributes are changed.
When the library name or *CURLIB is specified, this command attempts to find the output queue. If the output queue cannot be found in the specified library, a diagnostic message is sent. If all other parameters on the command were specified correctly, the OUTQ network attribute is changed to the output queue name, whether or not this command is able to find the output queue in the specified library.
| Top |
Specifies the action taken for input streams received through the SNADS network by the system.
| Top |
Specifies the maximum number of times in a SNADS network that a distribution queue entry originating at this node can be received and routed on the path to its final destination. If this number is exceeded, the distribution queue entry is ended, and a feedback status is sent back to the sender.
| Top |
Specifies how the system processes distributed data management (DDM) and Distributed Relational Database Architecture (DRDA) requests from remote systems for access to the data resources of the system. The DDM or DRDA connections refer to APPC conversations or active TCP/IP or OptiConnect connections. Changes to this parameter are immediate and apply to DRDA, DDM, or DB2 Multisystem applications. However, jobs that are currently running on the system do not use the new value. The DDMACC value is accessed only when a job is first started.
If a program name is specified, the program must exist in the system auxiliary storage pool (ASP) or in a basic user ASP.
Single values
Qualifier 1: DDM/DRDA request access
Qualifier 2: Library
Note: When *LIBL is used as the library name, the library list of the thread calling the command is searched to find the program. If the program is found, the library containing it is used in the stored name. If the program is not found, an exception is signaled, and no network attributes are changed.
When the library name or *CURLIB is specified, the command attempts to find the program. If the program is found, the DDMACC network attribute changes to the qualified program if all other parameters on the command were specified correctly. If the program cannot be found, a diagnostic message is sent.
The program name identifies a customer validation program that can supplement system object level security. The user security exit program parameter list is also used by personal computer Support/38 applications. The user-exit program can restrict user access to public (*PUBLIC) and privately authorized files. The target distributed data manager support calls the user program each time a file is referred to. The user exit program indicates to DDM whether the request should proceed or end.
| Top |
Specifies how IBM i Access for Windows requests are handled. You must specify a special value or program name which dictates how the requests are to be handled. This permits greater control over IBM i Access for Windows applications. Changes to this parameter are immediate. However, jobs that are currently running on the system do not use the new value. The PCSACC value is accessed only when a job is first started.
If a program name is specified, the program must exist in the system auxiliary storage pool (ASP) or in a basic user ASP.
Single values
Qualifier 1: Client request access
Qualifier 2: Library
Note: When *LIBL is used as the library name, the library list of the thread calling the command is searched to find the program. If the program is found, the library containing it is used in the stored name. If the program is not found, an exception is signaled, and no network attributes are changed.
When the library name or *CURLIB is specified, the command attempts to find the program. If the program is found, the PCSACC network attribute changes to the qualified program name if all other parameters on the command were specified correctly. If the program is not found, a diagnostic message is sent.
The program name is the name of the customer-supplied IBM i Access for Windows host system application exit program that can supplement system object level security. This user-exit program can restrict requests handled from the client. Each personal computer support application calls the exit program for requests from the client. Two parameters are passed to the user-exit program: the first describes the client request (which application and what kind of request). The second is used by the exit program to indicate to the client support application whether this client request must be handled.
| Top |
Specifies the system default value for the Integrated Services Digital Network (ISDN) network type. The operating system no longer uses this network attribute. Changes made to this network attribute have no effect.
| Top |
Specifies the system default value for the Integrated Services Digital Network (ISDN) connection list. The operating system no longer uses this network attribute. Changes made to this network attribute have no effect.
| Top |
Specifies the network attribute that allows the Communications APIs to use other communication transports that are not native for the API. Examples include ICF over TCP/IP or Sockets over SNA.
| Top |
Specifies the LAN Server domain to which all Integrated PC Servers, also known as File Server Input/Output Processors (FSIOP) on the system belong.
| Top |
Specifies the network attribute that allows APPN sessions and devices to use virtual controllers.
Note: The setting of this parameter has nothing to do with sessions using HPR transport tower support--only APPN (non-HPR) session traffic is affected by this parameter setting; if sessions are using HPR transport tower support they will use virtual controllers, regardless of the setting of this network attribute.
| Top |
Specifies the network attribute that allows the use of HPR transport tower support for APPN session traffic.
| Top |
Specifies the upper limit for number of automatically created APPC devices on virtual controllers.
| Top |
Specifies the amount of time, in minutes, to allow for a path switch attempt of an RTP connection. Four positional values can be specified to control the time allowed based on the type of session traffic:
Element 1: Network priority
Element 2: High priority
Element 3: Medium priority
Element 4: Low priority
| Top |
Specifies whether this system will allow another system to add it as a node in a cluster.
| Top |
Specifies the country or region identifier associated with a modem. The list of valid modem country or region identifiers will be displayed when F4 is pressed while prompting for this parameter.
MDMCNTRYID defines the country-specific or region-specific default characteristics for modems which are internal to system I/O adapters. This value must be configured correctly to insure proper operation and, in some countries or regions, meet legal requirements. The adapter will fail the vary on of the line if modem country or region ID is not set.
| Top |
Example 1: Changing the Pending System Name
CHGNETA SYSNAME(SYSTEST) ALRSTS(*ON)
ALRPRIFP(*YES) ALRLOGSTS(*LOCAL)
This command changes the pending system name. The current system name is changed at the next IPL. Local alerts are generated and logged and the system is a primary focal point.
Example 2: Changing the Node Servers
CHGNETA LCLCPNAME(CPNAME) LCLNETID(NETNAME)
NETSERVER((*LCLNETID BOSTON)
(MINN ROCHEST) (MAINE BANGOR))
This command changes the name of the local control point, the network ID, and the list of network node servers. The servers are used only if the node type is *ENDNODE or *BEXNODE.
Example 3: Clearing the List of Node Servers
CHGNETA NETSERVER(*NONE) DDMACC(DDMLIB/DDMPGM)
This command clears the list of network node servers and sets the name of the DDM access program.
Example 4: Implementing the APPN Virtual Object Model
CHGNETA ALWVRTAPPN(*YES)
This command causes any future APPN devices and sessions to use virtual controllers.
Example 5: Allowing HPR Transport Tower for APPN Sessions
CHGNETA ALWHPRTWR(*YES) HPRPTHTMR(1 2 4 8)
This command enables APPN session traffic to use HPR transport tower support when possible. It also resets the HPR path switch timers to the default values.
| Top |
*ESCAPE Messages
| Top |