Change Device Desc (BSC) (CHGDEVBSC)

The Change Device Description (BSC) (CHGDEVBSC) command changes a device description for a binary synchronous communications (BSC) device.

Parameters

Keyword	Description	Choices	Notes
DEVD	Device description	Name	Required, Key, Positional 1
LOCADR	Local location address	*SAME, 00, 01, 02, 03, 04, 05, 06, 07, 08, 09, 0A, 0B, 0C, 0D, 0E, 0F, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 1A, 1B, 1C, 1D, 1E, 1F, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 2A, 2B, 2C, 2D, 2E, 2F, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 3A, 3B, 3C, 3D, 3E, 3F, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 4A, 4B, 4C, 4D, 4E, 4F, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 5A, 5B, 5C, 5D, 5E, 5F, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 6A, 6B, 6C, 6D, 6E, 6F, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 7A, 7B, 7C, 7D, 7E, 7F, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 8A, 8B, 8C, 8D, 8E, 8F, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 9A, 9B, 9C, 9D, 9E, 9F, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, AA, AB, AC, AD, AE, AF, B0, B1, B2, B3, B4, B5, B6, B7, B8, B9, BA, BB, BC, BD, BE, BF, C0, C1, C2, C3, C4, C5, C6, C7, C8, C9, CA, CB, CC, CD, CE, CF, D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, DA, DB, DC, DD, DE, DF, E0, E1, E2, E3, E4, E5, E6, E7, E8, E9, EA, EB, EC, ED, EE, EF, F0, F1, F2, F3, F4, F5, F6, F7, F8, F9, FA, FB, FC, FD, FE	Optional
ONLINE	Online at IPL	SAME, YES, *NO	Optional
CTNWIN	Contention resolution winner	SAME, SEC, *PRI	Optional
BLOCK	Blocking type	SAME, NONE, ITB, IRS, NOSEP, USER, *SEP	Optional
SEPCHAR	Separator character	*SAME, 00, 04, 05, 06, 07, 08, 09, 0A, 0B, 0C, 0D, 0E, 0F, 11, 12, 13, 14, 15, 16, 17, 18, 19, 1A, 1B, 1C, 1E, 20, 21, 22, 23, 24, 25, 27, 28, 29, 2A, 2B, 2C, 2E, 2F, 30, 31, 33, 34, 35, 36, 38, 39, 3A, 3B, 3C, 3E, 3F, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 4A, 4B, 4C, 4D, 4E, 4F, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 5A, 5B, 5C, 5D, 5E, 5F, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 6A, 6B, 6C, 6D, 6E, 6F, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 7A, 7B, 7C, 7D, 7E, 7F, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 8A, 8B, 8C, 8D, 8E, 8F, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 9A, 9B, 9C, 9D, 9E, 9F, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, AA, AB, AC, AD, AE, AF, B0, B1, B2, B3, B4, B5, B6, B7, B8, B9, BA, BB, BC, BD, BE, BF, C0, C1, C2, C3, C4, C5, C6, C7, C8, C9, CA, CB, CC, CD, CE, CF, D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, DA, DB, DC, DD, DE, DF, E0, E1, E2, E3, E4, E5, E6, E7, E8, E9, EA, EB, EC, ED, EE, EF, F0, F1, F2, F3, F4, F5, F6, F7, F8, F9, FA, FB, FC, FD, FE, FF	Optional
RMTBSCEL	Remote BSCEL	SAME, NO, *YES	Optional
RCDLEN	Record length	1-8192, *SAME	Optional
BLKLEN	Block length	1-8192, *SAME	Optional
TRNSPY	Transmit in transparent mode	SAME, YES, *NO	Optional
DTACPR	Compress and decompress data	SAME, YES, *NO	Optional
TRUNC	Truncate trailing blanks	SAME, YES, *NO	Optional
GRPSEP	Group separator type	SAME, EOT, OFCSYS, DEV3740	Optional
EMLDEV	Emulated device	*SAME, 3278, 3284, 3286, 3287, 3288, 3289	Optional
EMLKBD	Emulated keyboard	SAME, UPPER, *LOWER	Optional
EMLNUMLCK	Emulated numeric lock	SAME, YES, *NO	Optional
EMLWRKSTN	Emulation work station	Name, SAME, ANY	Optional
TEXT	Text 'description'	Character value, SAME, BLANK	Optional

Top

Device description (DEVD)

Specifies the name of the device description being changed.

This is a required parameter.

Local location address (LOCADR)

Specifies the local location address for this device.

Valid values range from 00 to FE.

*SAME: The value does not change.

Online at IPL (ONLINE)

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

*SAME: The value does not change.

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

Contention resolution winner (CTNWIN)

Specifies which BSC station will gain control when line contention occurs.

*SAME: The value does not change.

*SEC: Specifies that the local system is the secondary station. It will give way to the other station when line contention occurs.
*PRI: Specifies that the local system is the primary station. It gets control when contention occurs.

Blocking type (BLOCK)

Specifies if the system or user blocks and deblocks transmitted records.

*SAME: The value does not change.

*NONE: No blocking or deblocking is done by the system.
*ITB: Records are blocked or deblocked based on the location of an intermediate text block (ITB) control character.
*IRS: Records are blocked or deblocked, based on the location of an interrecord separator (IRS) character.
*NOSEP: No record separator character is in the transmission block sent to or received from the device. The system blocks and deblocks the records by a fixed record length, as specified in the DDS format specifications.
*USER: The user program provides all control characters, including record separator characters, BSC framing characters, transparency characters, and any other characters needed to transmit records.
*SEP: Records are blocked or deblocked based on the location of a user-specified record separator character.

Separator character (SEPCHAR)

Specifies a unique one-byte record separator character.

Valid values range from 00 to FF; BSC control characters are not allowed.

*SAME: The value does not change.

Remote BSCEL (RMTBSCEL)

Specifies the type of BSCEL session with the remote system.

*SAME: The value does not change.

*NO: The remote system or device cannot recognize BSCEL commands. ICF operations and return codes are used.
*YES: The remote system can recognize BSCEL start and end commands, and BSCEL online messages.

Record length (RCDLEN)

Specifies the maximum record length allowed when communicating with this device.

The value must be at least the size of the largest record to be sent, but must not exceed the buffer size specified on the line description (MAXBUFFER parameter) to which this device is attached.

*SAME: The value does not change.

Block length (BLKLEN)

Specifies the maximum block length allowed when communicating with this device.

The value must be at least the size of the largest record to be sent, but must not exceed the buffer size specified on the line description (MAXBUFFER parameter) to which this device is attached.

Note: This parameter is valid only if APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.

*SAME: The value does not change.

block-length: Specify the maximum block length (in bytes) of records sent. The value must be at least the size of the largest record sent. Valid values range from 1 through 32767.

Transmit in transparent mode (TRNSPY)

Specifies whether the text transparency feature is used when sending blocked records. This feature permits the transmission of all 256 EBCDIC character codes; you should use this feature when transmitting packed or binary data fields.

*SAME: The value does not change.

*NO: The text transparency feature is not used.
*YES: The text transparency feature is to be used, which permits the transmission of all 256 EBCDIC character codes.

Compress and decompress data (DTACPR)

Specifies whether data compression is performed.

Note: DTACPR(*YES) cannot be specified if TRNSPY(*YES) or TRUNC(*YES) is specified. This parameter is valid only if APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.

*SAME: The value does not change.

*NO: No data compression or decompression occurs.
*YES: Data is compressed for output and decompressed for input.

Truncate trailing blanks (TRUNC)

Specifies whether trailing blanks are removed from output records.

*SAME: The value does not change.

*NO: Trailing blanks are not removed from output records.
*YES: Trailing blanks are removed from output records.

Group separator type (GRPSEP)

Specifies a separator for groups of data, such as data sets and documents.

*SAME: The value does not change.

*EOT: An end of transmission (EOT) control character is used.
*OFCSYS: A transmission block ending with an end of text (ETX) control character is used.
*DEV3740: A null record (STX ETX) is used.

Emulated device (EMLDEV)

Specifies that this program device entry is used to send and receive 3270 data streams. The emulation device parameter consists of an emulation device type and an emulation device data format. The emulation device data format specifies the format of the type 3270 data stream being sent or received. A 20- or 32-byte common header that contains type 3270 command and data flow information is located at the start of the I/O buffer that is sending or receiving the type 3270 data stream. This parameter applies only to SNUF communications. This parameter can be specified as a list of two values (elements) or as a single value (*NONE).

*SAME: The value does not change.

3278: This device is used to emulate a 3278 display device.
3284: This device is used to emulate a 3284 printer device.
3286: This device is used to emulate a 3286 printer device.
3287: This device is used to emulate a 3287 printer device.
3288: This device is used to emulate a 3288 printer device.
3289: This device is used to emulate a 3289 printer device.

Emulated keyboard (EMLKBD)

Specifies the type of 3278 display keyboard that is emulated. This parameter is valid only when *EML is specified for the Application type (APPTYPE) parameter.

*SAME: The value does not change.

*UPPER: A 3270 display device keyboard is emulated with uppercase characters only.
*LOWER: A 3270 display device keyboard is emulated with uppercase and lowercase characters.

Emulated numeric lock (EMLNUMLCK)

Specifies whether numeric input fields only allow numeric data on a 5250 keyboard. The value can be specified for this parameter only if *EML is specified for the Application type (APPTYPE) parameter.

*SAME: The value does not change.

*NO: 3270 emulation allows any data to be typed in the numeric input fields.
*YES: 3270 emulation allows only numeric data to be typed in the numeric input fields. Valid numeric data include the characters 0 through 9 and symbols + - , . and blank.

Emulation work station (EMLWRKSTN)

The emulation work station associates an emulation device with a real display or printer device. The device address is reserved for use exclusively by that work station. If no device or *ANY is specified, any work station can use the emulation device.

*SAME: The value does not change.

*ANY: Any work station can use the emulation device.
work-station: Specify the name for the work station that is to use this emulation device.

Text 'description' (TEXT)

*SAME: The text (if any) does not change.
*BLANK: No text is specified.

character-value: Specify no more than 50 characters of text, enclosed in apostrophes.

Examples

CHGDEVBSC   DEVD(BSC001)  EMLDEV(3278)  EMLKBD(*LOWER)

This command changes the device description for the BSC device named BSC001 so it emulates a 3278 display station with both uppercase and lowercase characters.

Error messages

*ESCAPE Messages

CPF2618: Device description &1 not changed.