| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Controller Description (Async) (CHGCTLASC) command changes a controller description for an asynchronous controller.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CTLD | Controller description | Name | Required, Key, Positional 1 |
| ONLINE | Online at IPL | *SAME, *YES, *NO | Optional |
| ACTSNBU | Activate swt network backup | *SAME, *YES, *NO | Optional |
| SWTLINLST | Switched line list | Single values: *SAME Other values (up to 64 repetitions): Name |
Optional |
| INLCNN | Initial connection | *SAME, *ANS, *DIAL | Optional |
| CNNNBR | Connection number | Character value, *SAME, *ANY | Optional |
| ANSNBR | Answer number | *SAME, *CNNNBR, *ANY | Optional |
| PREDIALDLY | Predial delay | 0-254, *SAME | Optional |
| REDIALDLY | Redial delay | 0-254, *SAME | Optional |
| DIALRTY | Dial retry | 0-254, *SAME | Optional |
| SWTDSC | Switched disconnect | *SAME, *YES, *NO | Optional |
| ACKTMR | File transfer ack timer | 16-65535, *SAME | Optional |
| RETRY | File transfer retry | 1-255, *SAME | Optional |
| RMTVFY | Remote verify | *SAME, *YES, *NO | Optional |
| LCLLOCNAME | Local location | Name, *SAME | Optional |
| LCLID | Local identifier | Name, *SAME | Optional |
| PADEML | PAD Emulation | *SAME, *YES, *NO | Optional |
| SWTLINSLCT | X.25 switched line selection | *FIRST, *CALC, *SAME | Optional |
| DFTPKTSIZE | X.25 default packet size | Element list | Optional |
| Element 1: Transmit value | *SAME, *LIND, 64, 128, 256, 512, 1024, 2048, 4096 | ||
| Element 2: Receive value | *SAME, *LIND, *TRANSMIT, 64, 128, 256, 512, 1024, 2048, 4096 | ||
| DFTWDWSIZE | X.25 default window size | Element list | Optional |
| Element 1: Transmit value | 1-15, *SAME, *LIND | ||
| Element 2: Receive value | 1-15, *SAME, *LIND, *TRANSMIT | ||
| USRGRPID | X.25 user group identifier | Character value, *SAME, *NONE | Optional |
| RVSCRG | X.25 reverse charging | *SAME, *NONE, *REQUEST, *ACCEPT, *BOTH | Optional |
| USRFCL | User facilities | Character value, *SAME, *NONE | Optional |
| CMNRCYLMT | Recovery limits | Single values: *SAME, *SYSVAL Other values: Element list |
Optional |
| Element 1: Count limit | 0-99 | ||
| Element 2: Time interval | 0-120 | ||
| MSGQ | Message queue | Single values: *SAME, *SYSVAL, *SYSOPR Other values: Qualified object name |
Optional |
| Qualifier 1: Message queue | Name | ||
| Qualifier 2: Library | Name | ||
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| Top |
This is a required parameter.
Specifies the name of the controller description.
| Top |
Specifies whether this object is automatically varied on at initial program load (IPL).
This value does not change.
The controller is automatically varied on at IPL.
The controller is not automatically varied on at IPL.
| Top |
Specifies, for modems that support the switched network backup (SNBU) feature and that are not IBM 386x, 586x, or 786x models, whether the SNBU feature is activated or deactivated. The local modem and remote modem must both support the SNBU to activate it. IBM 386x, 586x, and 786x models are activated with a hardware switch only. This feature lets you bypass a broken nonswitched connection (nonswitched line) by establishing a switched connection.
This value does not change.
The SNBU feature is not used.
The SNBU feature is activated. You must also specify a value of *YES for the Activate swt network backup (ACTSNBU) parameter for the line.
| Top |
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.
This value does not change.
Specify the names of up to 64 lines that are connected to this controller. The same line name can be used more than once. For each line name specified, a line description by that name must already exist.
| Top |
Specifies the method used to establish a connection with this controller.
This value does not change.
The system initiates outgoing calls and answers incoming calls.
The connection is made by the iSeries system 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 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.
The line can be changed using the Change Line Description (X.25) (CHGLINX25) command.
| Top |
Specifies the telephone number to dial to connect to this controller.
This could be a telephone number, an X.25 network address, or an X.21 connection number depending on the type of line the controller is attached to.
This value does not change.
Specify the connection number used to call this controller. This could be a telephone number or an X.25 network address.
| Top |
Specifies the X.25 network address from which calls are accepted.
This value does not change.
Calls from the X.25 network address specified on the CNNNBR parameter are accepted.
Calls are accepted from any X.25 network address.
| Top |
Specifies the time interval to wait (in 0.5 second intervals) before dialing a number.
Note: This parameter can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asychronous controllers.
This value does not change.
| Top |
Specifies the time interval to wait (in 0.5 second intervals) before re-dialing when the call attempt is unsuccessful.
Note: This parameter can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asychronous controllers.
This value does not change.
| Top |
Specifies the number of re-dial attempts made by the system before considering the dialing unsuccessful.
Note: This parameter can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asychronous controllers.
This value does not change.
| Top |
Specifies whether the switched connection to this controller is dropped when the last device is varied off.
This value does not change.
The switched connection is not dropped when the last device is varied off.
The switched connection is varied off when the last device is varied off.
| Top |
Specifies the time period allowed for an acknowledgement when using file transfer support.
Valid values range from 16 to 65535 in one-second intervals.
This value does not change.
| Top |
Specifies the number of retries when using file transfer support.
Valid values range from 1 to 255.
This value does not change.
| Top |
Specifies whether the remote system requires verification of local location NAME and local ID. The remote system requires verification if a generic controller and device are configured to accept calls from any X.25 network address.
This value does not change.
The remote system does not require verification of local location name and local ID.
The remote system does require verification of the local location name and local ID.
| Top |
Specifies the name that, when combined with the local ID, identifies your controller to a remote system. This name must be the same as the name specified by the remote system in its remote location list.
This value does not change.
| Top |
Specifies the ID that, when combined with the local location NAME, identifies your controller to a remote system. This ID must be the same as the ID specified by the remote system in its remote location list.
This value does not change.
Specify the local identifier.
| Top |
Specifies whether this controller emulates an X.25 packet assembler/disassembler (PAD). This PAD emulation follows CCITT recommendations for X.3, X.28, and X.29. This parameter is valid only if *X25 is specified for the Link type (LINKTYPE) parameter, SWITCHED is *YES, and the initial connection (INLCNN) is set to *DIAL.
This value does not change.
This controller does not emulate an X.25 packet assembler/disassembler (PAD).
This controller emulates an X.25 packet assembler/disassembler (PAD).
| Top |
Specifies the method that is used to select lines from an X.25 switched line list.
This value does not change.
Lines are selected beginning with the first line in the switched line list.
The system determines which line in the switched line list will be selected.
| Top |
Specifies the default packet size used by the X.25 network for transmission and reception.
The possible transmission values are:
This value does not change.
The value specified in the line description is the default value.
Specify a default packet size for transmission. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.
The possible reception values are:
This value does not change.
The value specified as the default packet size for transmission is used as the default for reception.
Specify a default packet size for reception. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.
| Top |
Specifies the default window size for transmission and reception.
Element 1: Transmit Window Size
This value does not change.
The value specified in the line description is used as the default window size.
Specify the appropriate default window size. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15. For switched virtual circuit (SVC) incoming calls, the system accepts the window size indicated in the Incoming Call packet facilities field.
Element 2: Receive Window Size
This value does not change.
The value specified in the line description is used as the default window size.
The value specified as the default window size for transmission is used as the default for reception.
Specify the appropriate default window size. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15.
| Top |
Specifies the closed user-group ID for contacting this switched virtual circuit (SVC) controller on the X.25 network.
Specify the 2-digit decimal value, from 00 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.
This value does not change.
A value is not specified for the user group identifier.
| Top |
Specifies whether reverse charges are accepted or requested when contacting this controller.
This value does not change.
No reverse charging for network tariff billing is accepted.
Charges are requested on outgoing call request packets.
Reverse charging for network tariff billing is accepted on incoming requests.
Both incoming and outgoing requests are accepted.
| Top |
Specifies a string of hexadecimal characters sent to the X.25 network to request additional services. The system allows up to 218 hexadecimal characters.
Note: Values entered in this field are determined by the supplier of the network subscription. Do not include coding of facilities shown through keywords: packet size, window size, user group identifier, and reverse charging.
This value does not change.
| Top |
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.
Element 1: Maximum Recovery Limit
This value does not change.
Specify the number of second-level recovery attempts to be made. Valid values range from 0 through 99.
Element 2: Recovery 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.
More information on communication recovery is in the Communcations Management book, SC41-5406.
| Top |
Specifies the message queue to which operational messages are sent.
This value does not change.
Qualifier 1: Message queue
Qualifier 2: Library
| Top |
Specifies the text that briefly describes the object.
This value does not change.
No text is specified.
Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
CHGCTLASC CTLD(VRTCTL325) CNNNBR(2825555)
This command changes the connection number for controller description VRTCTL325 to 2825555.
| Top |
| Top |