CHGCTLAPPC (Change Controller Description (APPC))

CHGCTLAPPC Command syntax diagram

 

Purpose

The Change Controller Description (APPC) (CHGCTLAPPC) command changes a controller description for an advanced program-to-program communications (APPC) controller.

If the controller was created with LINKTYPE(*LOCAL), the following restrictions apply:

• No communications line can be specified.
  
• MAXFRAME, RMTNETID, RMTCPNAME, SSCPID, CPSSN, NODETYPE, and TMSGRPNBR must not be specified.
  
• Parameters relating to SDLC, X.21 short-hold mode, X.25, or LAN configuration must not be specified.

More information is in the Communications Configuration book.

 

Required Parameters

CTLD

Specifies the name of the controller description being changed.

 

Optional Parameters

ONLINE

Specifies whether this object is automatically varied on at initial program load (IPL).

*SAME: The value does not change.

*YES: The controller is automatically varied on at IPL.

*NO: This controller is not automatically varied on at IPL.

ACTSNBU

Specifies, for controllers supporting the switched network backup (SNBU) feature, whether the SNBU feature is activated or deactivated. Both the local and remote modems must support the SNBU feature to perform a valid activation.

*SAME: The value does not change.

*NO: The switched network backup (SNBU) feature is not activated.

*YES: The switched network backup feature (SNBU) is activated. To start the feature when the nonswitched connection is broken, specify ACTSNBU(*YES) on the line description command.

APPN

Specifies whether the local system uses advanced peer-to-peer networking (APPN) functions when communicating with this controller. APPC controllers attached to a twinaxial data link control (TDLC) line must have *YES specified.

*SAME: The value does not change.

*YES: The local system uses APPN functions.

*NO: The local system does not use APPN functions.

SWTLINLST

Specifies the names of the switched lines to which this controller attaches. The line descriptions must already exist. Up to 64 switched line names can be specified.

Note:

The same line name can be used more than once.

*SAME: The value does not change.

switched-line-name: Specify the name of a line for which a line description already exists. The maximum number of switched line names that can be connected to the controller is 64.

CODE

Specifies the character code used. The code can be either extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII).

*SAME: The value does not change.

*EBCDIC: The extended binary-coded decimal interchange code (EBCDIC) character set code is used.

*ASCII: The ASCII character set code is used.

MAXFRAME

Specifies the maximum frame (path information unit (PIU)) size that the controller can send or receive. This value is used to calculate request unit (RU) sizes. Since the maximum PIU size that the controller can send or receive is negotiated at exchange identifier time, the maximum PIU size used at run time may be different. This value matches the corresponding value on the host system.

*SAME: The value does not change.

*LINKTYPE: The maximum frame size depends on the type of link being used. One of the following values (measured in bytes) will be used if *LINKTYPE is specified:

    *SDLC-521     *LAN-16393   *TDLC-4105
    *IDLC-2048    *X25-1024    *FR  -1590

maximum-frame: Specify the maximum frame size for the controller. The frame size that can be used depends on the type of line being used. Valid frame sizes for each line type are shown below.

Link Type

Frame Size (in bytes)

 

 

*FR

265 - 8182

*IDLC

265 - 8196

*SDLC

265, 521, 1033, 2057

*X25

256, 265, 512, 521, 1024, 1033, 2048, 4096

*LAN

265 - 16393 (265 - 4444 for DDI LANs)

*TDLC

*LINKTYPE

Note:

The numeric values listed for *LINKTYPE are valid only if TYPE(*BLANK) is specified when the controller is created.

RMTNETID

Specifies the name of the remote network in which the adjacent control point resides.

Note:

If MDLCTL(*YES) is specified, parameters RMTNETID, RMTCPNAME, and ADPTADR are optional. More information on model controllers is in APPC, APPN, and HPR topic in the Information Center.

*SAME: The value does not change.

*NETATR: The RMTNETID value specified in the system network attributes is used.

*NONE: No remote network identifier (ID) is used.

*ANY: The system determines which remote network identifier is used.

remote-network-ID: Specify the remote network identifier.

RMTCPNAME

Specifies the name of the remote control point. This control point name must match the remote system's local control point name. The remote control point name can be seen on the remote system with the DSPNETA command.

Note:

If MDLCTL(*YES) is specified, parameters RMTNETID, RMTCPNAME, and ADPTADR are optional. More information on model controllers is in APPC, APPN, and HPR topic in the Information Center.

*SAME: The value does not change.

*NONE: No remote control point name is used.

*ANY: The system determines the name of the remote control point to use.

remote-control-point-name: Specify the remote control point name.

RMTSYSNAME

Specifies the name of the remote system to which there is an OptiConnect bus connection. The current system name of the remote system can be found by using the DSPNETA command on that system.

Note:

This parameter is valid only for controllers created with LINKTYPE(*OPC).

*SAME: The value does not change.

SSCPID

Specifies the system service control point (SSCP) of the host system.

*SAME: The value does not change.

*NONE: No system service control point (SSCP) identifier is specified.

system-service-control-point-identifier: Specify the SSCP identifier ranging from 000000000001 through FFFFFFFFFFFF.

INLCNN

Specifies the method used to establish a connection with this controller.

*SAME: The value does not change.

*DIAL: The connection is made by a call initiated from the iSeries 400.

For X.25 connection, the line attached to the controller requires switched virtual circuits (SVCs) configured on the LGLCHLE parameter of type OUT or BOTH(*SVCOUT or *SVCBOTH) for the connection to succeed.

*ANS: The connection is made by the iSeries 400 when it answers an incoming call from this controller. If a call is received from the remote controller and all necessary conditions are met, the incoming call is answered by the system.

For X.25 connections, the line to which the controller attaches requires switched virtual circuits (SVC) configured on the LGLCHLE parameter of type IN or BOTH(*SVCIN or *SVCBOTH) for the connection to succeed. The line can be changed using the Change Line Description (X.25) (CHGLINX25) command.

DIALINIT

Specifies the method used to make the initial dial on a switched line between the system and the remote controller.

*SAME: The value does not change.

*LINKTYPE: The type of dial connection initiated is specified on the LINKTYPE parameter. For LAN or SDLC short-hold mode connections, the default is to dial the connection immediately upon vary on of the controller description. For all other link types, the default is to delay the dial.

*IMMED: The dial connection is initiated immediately upon vary on of the controller description.

*DELAY: The dial connection is delayed until a job is initiated that requests the use of the remote controller resources.

CNNNBR

Specifies the telephone number to dial to connect to this controller.

*SAME: The value does not change.

*DC: For X.21 circuit switched connections, a direct call is used to connect to the controller.

*ANY: Calls are accepted from any network address.

connection-number: Specify the connection number used to call this controller.

This could be a telephone number, an X.25 network address, or an X.21 connection number, depending on the type of controller and the type of line to which it is attached.

ANSNBR

Specifies the X.25 network address from which to accept calls.

*SAME: The value does not change.

*CNNNBR: Calls from the X.25 network address specified by the connection number (CNNNBR) parameter are accepted.

*ANY: Calls are accepted from any X.25 network address.

CNNLSTOUT

Specifies, for ISDN switched connections, the name of a connection list object that contains the Public Switched Network assigned numbers for a dial out operation to the Public Switched Data Network.

*SAME: The value does not change.

connection-list: Specify the name of a connection list object.

CNNLSTOUTE

Specifies the entry name from the connection list that is used to make a call to the Public Switched Data Network. The connection list must be specified on the CNNLSTOUT parameter.

*SAME: The value does not change.

connection-list-entry: Specify an entry name.

IDLCWDWSIZ

Specifies the window size used by the line description.

*SAME: The value does not change.

*LIND: The window size specified in the line description is used.

window-size: Specify the window size. Valid values range from 1 through 31.

IDLCFRMRTY

Specifies the maximum number of attempts to transmit a frame before an error is reported.

*SAME: The value does not change.

*LIND: The number of attempts specified in the line description is used.

IDLC-frame-retry: Specify the number of attempts. Valid values range from 0 through 100.

IDLCRSPTMR

Specifies the amount of time, in tenths of a second, to wait before retransmitting a frame if acknowledgement has not been received.

*SAME: The value does not change.

*LIND: The time specified in the line description is used.

IDLC-response-timer: Specify the amount of time to wait before retransmitting an unacknowledged frame of data. Valid values range from 10 through 100 tenths of a second. For example, 10 seconds equals 100 tenths of a second.

IDLCCNNRTY

Specifies the number of times to attempt retransmission at connection time.

*SAME: The value does not change.

*LIND: The number of attempts specified in the line description is used.

*NOMAX: There is no disconnect limit.

IDLC-connect-retry: Specify the number of attempts. Valid values range from 1 through 100.

PREDIALDLY

Specifies how long to wait (in 0.5 second intervals) before dialing.

Note:

Predial delay can be specified only if *YES is specified on the SWITCHED or SNBU parameters, *SDLC is specified on the LINKTYPE parameter, and *NO is specified on the SHM parameter.

*SAME: The value does not change.

predial-delay: Specify a value ranging from 1 through 254 in 0.5 second intervals, or specify 0 to indicate no delay.

REDIALDLY

Specifies how long to wait (in 0.5 second intervals) before re-dialing when the call attempt is unsuccessful. This parameter can be specified only if *YES is specified on either the SWITCHED or SNBU parameter, and if both LINKTYPE(*SDLC) and SHM(*NO) are specified.

*SAME: The value does not change.

redial-delay: Specify a value ranging from 1 through 254 in 0.5 second intervals, or specify 0 to indicate no delay.

DIALRTY

Specifies the number of re-dial attempts made by the system before considering the dialing unsuccessful.

Note:

Dial retries can only be specified if *YES is specified on the SWITCHED or SNBU parameters, *SDLC is specified on the LINKTYPE parameter, and *NO is specified on the SHM parameter.

*SAME: The value does not change.

dial-retry: Specify a value ranging from 0 through 254 for the number of redial attempts.

SWTDSC

Specifies whether the switched connection to this controller is disconnected when the last session is unbound.

*SAME: The value does not change.

*YES: The switched connection is disconnected when the last device is varied off.

*NO: The switched connection is not disconnected if the last session is unbound.

DSCTMR

Specifies options for controlling the time (in seconds) before an inactive connection is dropped (Element 1), or the amount of time to delay the automatic disconnection (Element 2). If the user does not want the line to disconnect, specify *NO for the switched disconnect prompt.

Element 1: Minimum Connect Timer

*SAME: The value does not change.

disconnect-timer: Specify a time to wait before disconnecting. Valid values range from 0 through 65535 seconds.

Element 2: Disconnect Delay Timer

*SAME: The value does not change.

disconnect-delay-timer: Specify a value to delay link take down after the last session on the controller is terminated. Valid values range from 0 through 65535 seconds.

SHMDSCLMT

Specifies the number of nonproductive responses (RR or RNR) that are required from the remote station before the connection can be suspended for this X.21 short-hold mode connection. This parameter is used only if SHM(*YES) is specified.

*SAME: The value does not change.

*NOMAX: There is no disconnect limit.

SHM-disconnect-limit: Specify a number ranging from 1 through 254, that indicates the number of nonproductive responses that must be received before the connection can be suspended.

SHMDSCTMR

Specifies the minimum length of time that the primary system maintains the connection to the remote system for this X.21 short-hold mode controller, in tenths of a second. This parameter is used only if SHM(*YES) is specified.

*SAME: The value does not change.

SHM-disconnect-timer: Specify a value ranging from 2 through 3000, indicating the minimum length of time, in tenths of a second, that the primary maintains the connection to the remote system.

STNADR

Specifies the station address used when communicating with the controller.

*SAME: The value does not change.

station-address: Specify a 2-character hexadecimal value ranging from 01 through FE.

For secondary controllers, this is the station address of the remote controller. For primary or negotiable controllers, this is the station address of the local system.

POLLPTY

Specifies whether this controller has priority when polled. This parameter can be specified only if *NO is specified on the SHM parameter.

*SAME: The value does not change.

*NO: This controller does not have polling priority.

*YES: This controller has polling priority.

POLLLMT

Specifies the number of consecutive polls that are issued to the same controller when the poll results in receiving frames. This parameter can be specified only if *NO is specified on the SHM parameter.

*SAME: The value does not change.

poll-limit: Specify a value ranging from 0 through 4 (0 meaning no consecutive polls are attempted) number of consecutive polls.

OUTLMT

Specifies the number of times SDLC allows the consecutive transmission of the maximum number of frames to a station before allowing transmission to another station.

*SAME: The value does not change.

*POLLLMT: The value specified on the POLLLMT parameter is used.

out-limit: Specify a value ranging from 0 through 4 for the number of consecutive transmissions.

CNNPOLLRTY

Specifies the number of times to retry connecting before reporting the error. This parameter can be specified only if *NO is specified on the SHM parameter.

*SAME: The value does not change.

*CALC: The number of retries is 7 if the controller is switched, and *NOMAX if the controller is nonswitched.

*NOMAX: There is no disconnect limit.

connect-poll-retry: Specify a value ranging from 0 through 65534 of retries.

NDMPOLLTMR

Specifies the minimum interval at which a secondary station should be polled if a poll from the primary station to the secondary station (which is in normal response mode) does not result in receiving an appropriate response. This parameter can be specified only if *NO is specified on the SHM parameter.

*SAME: The value does not change.

*CALC: The system determines the value to use.

NDM-poll-timer: Specify a value ranging from 1 through 3000 in 0.1-second intervals, or 0 to indicate no timer.

ADPTADR

Specifies the 12-character adapter address of the remote controller. This is the address to which the system sends data when it communicates with the remote controller. This value can be obtained from the remote controller's configuration record. Valid values range from hex 000000000001 through hex FFFFFFFFFFFF.

*SAME: The value does not change.

adapter-address: Specify the adapter address.

DSAP

Specifies the logical address of the SNA destination service access point (DSAP) to which this system sends data when it communicates with the remote controller. This address allows the controller and the system to route the data that comes from this system. The value must match the value specified on the source service access point (SSAP) parameter in the remote controller's configuration record.

Note:

The *OPC controller uses 04 as the value for this field. The combination of RMTSYSNAME and DSAP defines a unique controller. This allows multiple controllers to exist between two systems.

*SAME: The value does not change.

destination-service-access-point: Specify a hexadecimal value ranging from 04 through 9C, in increments of 4 (for example, 04, 08, 0C, 10) to represent the destination service access point.

SSAP

Specifies the source service access point. This is the logical address this system uses when it sends data to the remote controller. This address allows the remote controller and the system to route the data that comes from this system. It must match the value assigned to the destination service access point (DSAP) prompt in the remote controller's configuration record.

*SAME: The value does not change.

source-service-access-point: Specify a hexadecimal value ranging from 04 through 9C, in increments of 4 (for example, 04, 08, 0C, 10) to represent the source service access point.

LANFRMRTY

Specifies the number of times a frame is transmitted if there is no acknowledgment from the remote controller in the time period specified by the LANRSPTMR parameter. This value is used only after a successful connection has been made.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-frame-retry: Specify a value ranging from 0 through 254 for the number of times a frame will be transmitted before and acknowledgement is received.

LANCNNRTY

Specifies the number of times a transmission is attempted before an acknowledgement is received. This value is used at connection time (unlike LANFRMRTY which is used after a connection has been made).

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-connection-retry: Specify a value ranging from 0 through 254 for the number of times the transmission is attempted before an acknowledgement is received.

LANRSPTMR

Specifies the length of time the system waits before an inoperative condition occurs on a link after a connection is made.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-response-timer: Specify a value ranging from 1 through 254 in 0.1-second intervals for the amount of time the system waits before an inoperative condition occurs.

LANCNNTMR

Specifies the length of time the system waits before an inoperative condition occurs on a link at connection time.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-connection-timer: Specify a value ranging from 1 through 254 in 0.1-second intervals for the amount of time the system waits before an inoperative condition occurs. The value 0 indicates that a 6-second connection timer is used.

LANACKTMR

Specifies the length of time the system waits before sending an acknowledgement for received frames.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-acknowledgment-timer: Specify a value, ranging from 1 through 254 in 0.1-second intervals, or specify 0 to indicate no delay. If 0 is specified for this parameter, 0 must also be specified for the LANACKFRQ parameter. If a nonzero value is specified for this parameter, a nonzero value must also be specified for the LANACKFRQ parameter.

LANINACTMR

Specifies the length of time used to determine an inactive condition for the controller.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-inactivity-timer: Specify a value ranging from 1 through 255 in 0.1-second intervals for the length of time used to determine an inactive condition for the controller. The value 0 indicates that a 6-second connection time is used.

LANACKFRQ

Specifies the maximum number of frames that is received before an acknowledgment is sent to the controller.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-acknowledgment-frequency: Specify a value ranging from 0 through 127 for the number of frames received. If 0 is specified for this parameter, 0 must also be specified for the LANACKTMR parameter; if a nonzero value is specified for this parameter, a nonzero value must also be specified for the LANACKTMR parameter.

LANMAXOUT

Specifies the maximum number of frames that can be sent before an acknowledgment is received from the remote system.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-maximum-outstanding-frames: Specify a value ranging from 1 through 127 for the number of frames that can be sent before an acknowledgement is received.

LANACCPTY

Specifies the priority granted to the sending system for sending frames. The larger the number, the higher the priority.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-access-priority: Specify a value ranging from 0 through 3 to indicate how soon a frame may be sent on a local area network.

LANWDWSTP

Specifies whether to reduce to 1 the maximum number of frames outstanding to the remote system during network congestion. This parameter indicates the number of frames that must be successfully received by the remote system before the number of maximum outstanding frames can be increased by 1. The increase continues this way until the maximum number of outstanding frames reaches the value specified by the LAN maximum outstanding frames (LANMAXOUT) parameter.

*SAME: The value does not change.

*NONE: The number of outstanding frames is not reduced during network congestion.

LAN-window-step: Specify a value from 1 to 127 for the number of frames that must be successfully received by the remote system before the maximum number of outstanding frames can be increased by 1.

NETLVL

Specifies the level of X.25 support implemented by the network and remote DTE. The level is specified by giving the year of the CCITT standard implemented.

Note:

It is suggested to use the lower value of the remote DTE or the network level; for example, if the remote DTE is using the CCITT standard of 1980 and the network 1984, specify 1980 for this prompt.

*SAME: The value does not change.

1980: The 1980 standard is used.

1984: The 1984 standard is used.

1988: The 1988 standard is used.

LINKPCL

Specifies the link level protocol used on the X.25 network to communicate with this controller.

*SAME: The value does not change.

*QLLC: The QLLC protocol is used.

*ELLC: The ELLC protocol is used.

*LLC2: The LLC 802.2 protocol is used.

CNNPWD

Specifies, for X.25 switched virtual circuit (SVC) controllers, the password used when connecting to this controller.

*SAME: The value does not change.

*NONE: No password is used.

X.25-connection-password: Specify the connection password. This password for each controller can consist of any alphanumeric characters represented by the hexadecimal range from 40 through FF.

SWTLINSLCT

Specifies the method that is used to select lines from an X.25 switched line list.

*SAME: The value does not change.

*FIRST: The lines are selected in the order in which they are specified.

*CALC: The system determines the value to use.

DFTPKTSIZE

Specifies the default packet size used by the X.25 network.

Element 1: Transmit Packet Size

*SAME: The value does not change.

*LIND: The value specified in the line description is used as the default packet size.

transmit-packet-size: Specify a default packet size for transmission. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.

Element 2: Receive Packet Size

*SAME: The value does not change.

*LIND: The value specified in the line description is used as the default packet size.

*TRANSMIT: The value specified as the default packet size for transmission is used as the default for reception.

receive-packet-size: Specify a default packet size for reception. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.

DFTWDWSIZE

Specifies the default window size used by the X.25 network.

Element 1: Transmit Window Size

*SAME: The value does not change.

*LIND: The value specified in the line description is used as the default window size.

max-transmit-window-size: Specify the appropriate default window size. Valid values range from 1 through 7 for networks that use modulus 8 packet numbering. Valid values range from 1 through 15 for networks that use modulus 128-packet numbering.

Element 2: Receive Window Size

*SAME: The value does not change.

*LIND: The value specified in the line description is used as the default window size.

*TRANSMIT: The value specified as the default window size for transmission is used as the default for reception.

max-receive-window-size: Specify the appropriate default window size. Valid values range from 1 through 7 for networks that use modulus 8 packet numbering. Valid values range from 1 through 15 for networks that use modulus 128-packet numbering.

USRGRPID

Specifies the closed user-group ID for contacting this X.25 switched virtual circuit (SVC) controller. Specify a value ranging from 0 through 99, as provided by the network subscription. This parameter is not valid for permanent virtual circuit (PVC) connections. It is valid only for SVC circuit outgoing call operations and is ignored for SVC incoming call connections.

*SAME: The value does not change.

*NONE: No user-group ID is specified.

X.25-user-group-ID: Specify a value ranging from 0 through 99, as provided by the network subscription.

RVSCRG

Specifies whether reverse charges are accepted or requested when contacting this controller.

*SAME: The value does not change.

*NONE: No reverse charging for network tariff billing is accepted.

*REQUEST: Charges are requested on outgoing call request packets.

*ACCEPT: Reverse charging for network tariff billing is accepted on incoming requests.

*BOTH: Both incoming and outgoing requests are accepted.

X25FRMRTY

Specifies the maximum number of times that a logical link control (LLC) protocol data unit is sent after the response timer ends when connected to this controller. The value used in this prompt depends on the quality of service provided by the network and the connection to that network; that is, the frequency of lost link protocol data units.

*SAME: The value does not change.

X.25-frame-retry: Specify a value ranging from 0 through 21 for the number of times a frame is sent.

X25CNNRTY

Specifies, for X.25 controllers specifying *SEC or *NEG as the role parameter, the maximum number of times that an LLC is sent after the connect response timer ends when connecting to this controller.

*SAME: The value does not change.

X.25-connection-retry: Specify a value ranging from 0 through 21 retries.

X25RSPTMR

Specifies the time allowed to return an acknowledgment when an LLC is sent while connecting to this controller.

*SAME: The value does not change.

X.25-response-timer: Specify a value ranging from 1 through 2550 in 0.1-second intervals.

X25CNNTMR

Specifies, for X.25 controllers specifying *SEC or *NEG as the role parameter, this specifies the time allowed for acknowledgment to be returned when a LLC is sent while connecting to this controller.

*SAME: The value does not change.

X.25-connection-timer: Specify a value ranging from 1 through 2550 in 0.1-second intervals.

X25DLYTMR

Specifies, for X.25 controllers specifying *SEC or *NEG as the role parameter, how often to try establishing a connection to the controller.

*SAME: The value does not change.

*CALC: The iSeries 400 uses the values for X25CNNTMR and X25CNNRTY to determine how often and how many times to try to establish the connection.

X.25-delayed-connection-timer: Specify a value ranging from 1 through 32767 in 0.1-second intervals. The system retries the connection indefinitely at the specified interval.

X25ACKTMR

Specifies, for X.25 links using an ELLC link protocol, the time period to delay sending acknowledgments for received LLC.

*SAME: The value does not change.

X.25-acknowledgment-timer: Specify a value ranging from 1 through 2550 in 0.1-second intervals, or specify 0 to indicate no delay.

X25INACTMR

Specifies the time period in which to determine an inactive condition for the controller.

*SAME: The value does not change.

X.25-inactivity-timer: Specify a value ranging from 1 through 2550 in 0.1-second intervals.

USRFCL

Specifies a string of hexadecimal digits sent to the X.25 network to request additional services. The iSeries 400 allows up to 218 hexadecimal characters.

*SAME: The value does not change.

*NONE: No additional services are needed.

user-facilities: Specify a string of hexadecimal digits sent to the network to request additional services. The iSeries 400 allows up to 218 hexadecimal characters.

CPSSN

Specifies whether this controller supports APPN control-point to control-point (CP-to-CP) sessions.

*SAME: The value does not change.

*YES: This controller supports CP-to-CP sessions.

*NO: This controller does not support CP-to-CP sessions.

NODETYPE

Specifies the type of APPN node this controller represents.

*SAME: The value does not change.

*CALC: The system determines the value to use.

*NETNODE: This node is a network node in an APPN network.

*ENDNODE: This node is an end node in an APPN network.

*LENNODE: This node is a low entry networking node in an APPN network.

BEXROLE

Specifies the role of the local system in an APPN network for the remote controller being configured. This parameter is only used when the local system has enabled the branch extender function via the NODETYPE parameter in the network attributes being set to *BEXNODE.

*SAME: The value does not change.

*NETNODE: The local system takes the role of a network node for the remote controller.

*ENDNODE: The local system takes the role of an end node for the remote controller.

HPR

Specifies whether the local system can use APPN high-performance routing (HPR) when communicating with this controller. The controller description must specify APPN(*YES) to enable HPR. If HPR(*YES) is specified, the value of the MAXFRAME parameter of the line specified by the switched line list must be greater than or equal to 768, otherwise HPR will not be enabled over this connection. See APPC, APPN, and HPR topic in the Information Center for more information on HPR.

*SAME: The value does not change.

*YES: The local system can use HPR, and HPR flows can proceed over the link defined by this controller.

*NO: The local system cannot use HPR, and HPR flows cannot proceed over the link defined by this controller.

HPRPTHSWT

Specifies whether an attempt is made to switch paths of HPR connections associated with this controller at the time the controller is varied off. If a path switch is not attempted or if there are no other available paths, jobs associated with the HPR connections will be ended. See APPC, APPN, and HPR topic in the Information Center for more information.

*SAME: The value does not change.

*NO: When this controller is varied off path switching will not be done for HPR connections associated with this controller. Jobs associated with HPR connections will be ended.

*YES: When this controller is varied off an attempt to switch paths of HPR connections associated with this controller will be made.

TMSGRPNBR

Specifies the APPN transmission group number for this controller.

*SAME: The value does not change.

*CALC: The system determines the value to use.

APPN-transmission-group-number: Specify a value ranging from 1 through 20 for the transmission group number.

MINSWTSTS

Specifies, for the switched connection, the minimum status that APPN requires for a controller to be considered available for routing.

*SAME: The value does not change.

*VRYONPND: APPN will consider the controller available for routing if the status is vary on pending, varied on, or active.

*VRYON: Indicates that APPN will consider the controller available for routing only if the status is varied on or active.

AUTOCRTDEV

Specifies which devices are automatically created.

Note:

This parameter does not apply to the automatic creation of APPC devices. This parameter only applies to dependent devices on this controller.

*SAME: The value does not change.

*ALL: All dependent devices (non-APPC) on this controller are automatically created.

*NONE: Dependent devices on this controller are not automatically created.

AUTODLTDEV

Specifies the number of minutes an automatically created device can remain when the last session is unbound before the device description is varied off and deleted.

*SAME: The value does not change.

1440: The system will automatically vary off and delete the automatically-configured idle device descriptions after 1440 minutes (24 hours).

*NO: The system will not automatically vary off and delete the automatically-configured idle device descriptions.

wait-time: Specify the number of minutes to wait before deleting the automatically-configured idle device descriptions for this controller. Valid values range from 1 through 10,000.

USRDFN1

Specifies the first of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.

*SAME: The value does not change.

*LIND: The user-defined value specified in the line description is used.

user-defined-1: Specify a value ranging from 0 through 255.

USRDFN2

Specifies the second of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.

*SAME: The value does not change.

*LIND: The user-defined value specified in the line description is used.

user-defined-2: Specify a value ranging from 0 through 255.

USRDFN3

Specifies the third of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.

*SAME: The value does not change.

*LIND: The user-defined value specified in the line description is used.

user-defined-3: Specify a value ranging from 0 through 255.

CMNRCYLMT

Specifies the number of recovery attempts made by the system before an inquiry message is sent to the system operator. Also specifies the time (in minutes) that must elapse before the system sends an inquiry message to the system operator indicating that the recovery attempt count limit is reached.

*SAME: The value does not change.

*SYSVAL: The recovery limits specified in the QCMNRCYLMT system value are used.

Element 1: Maximum Recovery Limit

count-limit: Specify the number of second-level recovery attempts to be made. Valid values range from 0 through 99.

Element 2: Recovery Time Interval

time-interval: Specify the time interval (in minutes) at which the specified number of second-level recoveries are attempted. Valid values range from 0 through 120. If the value specified for count-limit is not 0, the value 0 specifies infinite recovery.

MDLCTL

Specifies whether this controller description is a model for automatically created controller descriptions. Values on the model description, such as timer delays, retry limits, and frame size, will be used for new controller descriptions that are automatically created and configured when communications with a remote system is started. The new controller must be attached to one of the SINGLE line descriptions in the switched line list (SWTLINLST parameter) of the model controller.

A model controller description will not be attached to any devices, and only one controller description can be varied on for each line description.

More information on model controllers is in APPC, APPN, and HPR topic in the Information Center.

Note:

This parameter is valid only if the parameter LINKTYPE(*LAN) is specified.

*SAME: The value does not change.

*NO: This controller description is not used as a model controller description.

*YES: This controller description is used as a model for automatically created controller descriptions.

CNNNETID

Specifies the connection network network identifier of this controller description. If a value is specified for this parameter (other than *NONE), this controller description represents this connection to the connection network.

Note:

This parameter is only valid if MDLCTL(*YES) is specified.

*SAME: The value does not change.

*NETATR: The LCLNETID value specified in the system network attributes is used.

*NONE: No network network connection identifier is used.

connection-network-network-ID: Specify the network connection identifier that will represent this controller description to the network.

CNNCPNAME

Specifies the connection network control point name for this controller. If this value and a CNNNETID value (other than *NONE) are specified, this controller description represents this connection to the connection network.

Note:

This parameter is valid only if MDLCTL(*YES) is specified.

*SAME: The value does not change.

*NONE: No connection network control point name is specified.

connection-control-point-name: Specify the connection control point name.

CTLOWN

Specifies whether the ownership of the controller will be transferred from the system to the user. If the user is the current owner, ownership cannot be transferred back to the system.

*SAME: The value does not change.

*USER: The user will be the owner of this controller.

MSGQ

Specifies the qualified name of the message queue to which messages are sent. More information about using this parameter is in the Communications Management book.

Single Values

*SAME: The value does not change.

*SYSVAL: Messages are sent to the message queue defined in the system value QCFGMSGQ.

*SYSOPR: Messages are sent to the system operator message queue (QSYS/QSYSOPR).

library-name/message-queue-name: Specify the library-qualified name of the message queue to which operational messages are sent.

TEXT

Specifies the text that briefly describes the program and its function. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CHGCTLAPPC

CHGCTLAPPC  CTLD(CHICAGO)  ONLINE(*YES)
  TEXT('Controller in Chicago')

This command changes the APPC controller named CHICAGO to be varied on at IPL and a new text description is specified.

Error messages for CHGCTLAPPC

*ESCAPE Messages

CPF2652

Controller description &1 not changed.