Change Device Desc (BSC) (CHGDEVBSC)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

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

Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Top

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.

This is a required parameter.

Top

Local location address (LOCADR)

Specifies the local location address for this device.

The possible values are 00 to FF.

*SAME
The value does not change.
Top

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.

Top

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.

Top

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

*SEP

Records are blocked or deblocked based on the location of a user-specified record separator character.

Top

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

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.

Top

Record length (RCDLEN)

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

Valid values range from 1 to 32767.

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

Block length (BLKLEN)

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

The possible values are from 1 to 32767.

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

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

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.

Top

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.

Top

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.

Top

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.

Top

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.

Top

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.

Top

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.

Top

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.

Top

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.

Top

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

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

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.

Top

Error messages

*ESCAPE Messages

CPF2618
Device description &1 not changed.
Top