The Create Device Description (BSC) (CRTDEVBSC) command creates a device description for a binary synchronous communications (BSC) device.

Parameters

Keyword	Description	Choices	Notes
DEVD	Device description	Name	Required, Positional 1
LOCADR	Local location address	00-FE	Required, Positional 2
RMTLOCNAME	Remote location	Communications name	Required, Positional 3
ONLINE	Online at IPL	*YES, *NO	Optional
CTL	Attached controller	Name	Optional
CNN	Connection type	*PP, *MPTRIB	Optional
APPTYPE	Application type	*BSCEL, *RJE, *EML, *BSC38, *RPGT	Optional
CTNWIN	Contention resolution winner	*SEC, *PRI	Optional
BLOCK	Blocking type	*NONE, *ITB, *IRS, *NOSEP, *USER, *SEP	Optional
SEPCHAR	Separator character	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	*NO, *YES	Optional
RCDLEN	Record length	1-8192, 512	Optional
BLKLEN	Block length	1-8192, 512	Optional
TRNSPY	Transmit in transparent mode	*NO, *YES	Optional
DTACPR	Compress and decompress data	*NO, *YES	Optional
TRUNC	Truncate trailing blanks	*NO, *YES	Optional
GRPSEP	Group separator type	*EOT, *OFCSYS, *DEV3740	Optional
EMLDEV	Emulated device	3278, 3284, 3286, 3287, 3288, 3289	Optional
EMLKBD	Emulated keyboard	*UPPER, *LOWER	Optional
EMLNUMLCK	Emulated numeric lock	*NO, *YES	Optional
EMLWRKSTN	Emulation work station	Name, *ANY	Optional
TEXT	Text 'description'	Character value, *BLANK	Optional
AUT	Authority	Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT	Optional

Top

Device description (DEVD)

Specifies the name of the device description.

This is a required parameter.

Local location address (LOCADR)

Specifies the local location address for this device.

Valid values range from 00 to FE.

Remote location (RMTLOCNAME)

Specifies the name of the remote location with which your program communicates.

Online at IPL (ONLINE)

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

*YES

This device is varied on automatically at IPL.

*NO

This device is not varied on automatically at IPL.

Attached controller (CTL)

Specifies the name of the controller description to which this device is attached.

Note: To use this device for communicating with a remote location that resides on the same system as the local location, specify a controller description that was created with LINKTYPE (*LOCAL) specified.

Connection type (CNN)

Specifies the connection type for this device.

*PP

A point-to-point connection type is used.

*MPTRIB

A multipoint tributary connection type is used.

Application type (APPTYPE)

Specifies the application type used by this device.

*BSCEL

The application is Binary Synchronous Communications Equivalence Link (BSCEL). This parameter is specified to communicate with other BSC systems or devices supported by this system.

*RJE

The application is BSC Remote Job Entry (RJE).

*EML

The application is 3270 device emulation, using the 3270 Device Emulation Utility, or the 3270 program interface support provided in the System/38 environment.

*BSC38

The application is a System/38 environment program. This parameter is specified for a device that communicates with other BSC systems or devices when the application uses a BSC device file or Mixed device file which is used in the System/38 environment.

*RPGT

This parameter is specified for applications using RPG II Telecommunications (BSCA) in the System/36 environment.

Note: This value can also be specified when the application uses ICF support, but does not need Evoke capability or program-start request capability. If this value is specified, the value of the Remote BSCEL (RMTBSCEL) parameter is automatically set to *NO. If the application uses ICF, make sure there is no requirement for Evoke or program-start request support before you try to use this value, or unpredictable results will occur.

Contention resolution winner (CTNWIN)

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

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

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

Remote BSCEL (RMTBSCEL)

Specifies the type of BSCEL session with the remote system.

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

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.

512

The record length is 512.

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

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.

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

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

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

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

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.

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

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

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

Specifies the text that briefly describes the object.

*BLANK

No text is specified.

character-value

Specify no more than 50 characters of text, enclosed in apostrophes.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*CHANGE

The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.

*ALL

The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.

*USE

The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

*EXCLUDE

The user cannot access the object.

*LIBCRTAUT

The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.

name

Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Examples

CRTDEVBSC   DEVD(BSC001)  LOCADR(27)  RMTLOCNAME(BSC001LC)
            CTL(CTLBSC001)  CNN(*PP)  APPTYPE(*RJE)

This command creates a binary synchronous communications device named BSC001. Its address is X'27' and it is attached to the controller CTLBSC001. The connection type of the device is *PP and it uses the RJE application.

Error messages

*ESCAPE Messages

CPF261A

Device description &1 not created due to errors.