Change Ctl Desc (BSC) (CHGCTLBSC)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Controller Description (BSC) (CHGCTLBSC) command changes a controller description for a binary synchronous communications (BSC) controller.
Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
| Top |
Parameters
| 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 | Optional |
| PREDIALDLY | Predial delay | 0-254, *SAME | Optional |
| REDIALDLY | Redial delay | 0-254, *SAME | Optional |
| DIALRTY | Dial retry | 0-254, *SAME | Optional |
| LCLID | Local identifier | Character value, *SAME, *NOID | Optional |
| RMTID | Remote identifiers | Single values: *SAME Other values (up to 64 repetitions): Character value, *ANY, *NOID |
Optional |
| RJEHOST | RJE host type | *SAME, *RES, *JES2, *JES3, *RSCS | Optional |
| RJELOGON | RJE host signon/logon | Character value, *SAME | 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 | ||
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| Top |
Controller description (CTLD)
This is a required parameter.
Specifies the name of the controller description.
| Top |
Online at IPL (ONLINE)
Specifies whether this object is automatically varied on at initial program load (IPL).
- *SAME
This value does not change.
- *YES
The controller is automatically varied on at IPL.
- *NO
The controller is not automatically varied on at IPL.
| Top |
Activate swt network backup (ACTSNBU)
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.
- *SAME
This value does not change.
- *NO
The SNBU feature is not used.
- *YES
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 |
Switched line list (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.
- *SAME
This value does not change.
- switched-line-name
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 |
Initial connection (INLCNN)
Specifies the method used to establish a connection with this controller.
- *SAME
This value does not change.
- *DIAL
The system initiates outgoing calls and answers incoming calls.
- *ANS
The connection is made by the IBM System i5 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 |
Connection number (CNNNBR)
Specifies the telephone number to dial to connect to this controller.
- *SAME
This value does not change.
- connection-number
Specify the connection number.
| Top |
Predial delay (PREDIALDLY)
Specifies the time interval to wait (in 0.5 second intervals) before dialing a number.
- *SAME
This value does not change.
- predial-delay
- Specify a value ranging from 0 to 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.
| Top |
Redial delay (REDIALDLY)
Specifies the time interval to wait (in 0.5 second intervals) before re-dialing when the call attempt is unsuccessful.
- *SAME
This value does not change.
- redial-delay
- Specify a value from 0 to 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.
| Top |
Dial retry (DIALRTY)
Specifies the number of re-dial attempts made by the system before considering the dialing unsuccessful.
- *SAME
This value does not change.
- dial-retry
- Specify a value from 0 to 254 in 0.5-second intervals, for the number of times the dialing will be tried.
| Top |
Local identifier (LCLID)
Specifies the local ID used to identify the local system to the remote controller.
- *SAME
This value does not change.
- *NOID
The local system sends a null identifier when communicating with the controller.
- local-id
Specify a local ID that is from 2 to 30 hexadecimal characters long and contains an even number of characters. The identifier cannot contain any BSC control characters.
The following guidelines are recommended to help ensure that the telephone connection is made to the correct BSC controller:
- The local ID should be a minimum of 4 characters.
- If the ID is only 4 characters, the first 2 and last 2 should be the same (example: F3F3 or 8484).
| Top |
Remote identifiers (RMTID)
Specifies the identifiers for remote BSC controllers. A maximum of 64 remote controller IDs can be specified.
- *SAME
This value does not change.
- *NOID
The local system accepts a null identifier sent by the remote system.
- *ANY
The system accepts any identifier sent by the remote controller.
Note: This value is valid only when it is the last or the only value specified.
- remote-ID
Specify a remote controller ID that is from 2 to 30 hexadecimal characters long and contains an even number of characters. The identifier cannot contain any BSC control characters.
The following guidelines are recommended to help ensure that the phone connection is made to the correct BSC controller:
- The remote ID should be a minimum of 4 characters.
- If the ID is only 4 characters, the first 2 and last 2 should be the same (example: F1F1 or 8585).
| Top |
RJE host type (RJEHOST)
Specifies the subsystem type of the host to which RJE is connected.
- *SAME
This value does not change.
- *RES
The host is RES (Remote Entry System).
- *JES2
The host is JES2 (Job Entry Subsystem 2).
- *JES3
The host is JES3 (Job Entry Subsystem 3).
- *RSCS
The host is RSCS (Remote Spooling Communications System).
| Top |
RJE host signon/logon (RJELOGON)
Specify up to 80 characters of text, enclosed in apostrophes, used as sign-on text for the RJE host system. This parameter is required only when APPTYPE(*RJE) is specified. Specify the sign-on information required by the host system.
- *SAME
This value does not change.
| Top |
Recovery limits (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.
Element 1: Maximum Recovery Limit
- *SAME
This value does not change.
- *SYSVAL
- The value in the QCMNRCYLMT system value is used.
- 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.
More information on communication recovery is in the Communcations Management book, SC41-5406.
| Top |
Text 'description' (TEXT)
Specifies the text that briefly describes the object.
- *SAME
This value does not change.
- *BLANK
No text is specified.
- character-value
Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
Examples
CHGCTLBSC CTLD(VRTCTL325) LCLID(ABAB)
This command changes the controller named VRTCTL325 to have the local identifier ABAB.
| Top |
| Top |