Change Ctl Desc (BSC) (CHGCTLBSC)

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

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.

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.

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.

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 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.

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.

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.

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.

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.

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).

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).

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).

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.

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.

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.

*SYSVAL: The value in the QCMNRCYLMT system value is used.

More information on communication recovery is in the Communcations Management book, SC41-5406.

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.

Examples

CHGCTLBSC   CTLD(VRTCTL325)  LCLID(ABAB)

This command changes the controller named VRTCTL325 to have the local identifier ABAB.