Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Device Description (BSC) (CRTDEVBSC) command creates 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 |
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 |
Specifies the name of the device description.
This is a required parameter.
Top |
Specifies the local location address for this device.
The possible values are 00 to FF.
Top |
Specifies the remote location name of the system with which this object communicates.
Top |
Specifies whether this object is automatically varied on at initial program load (IPL).
This device is varied on automatically at IPL.
This device is not varied on automatically at IPL.
Top |
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.
Top |
Specifies the connection type for this device.
A point-to-point connection type is used.
A multipoint tributary connection type is used.
Top |
Specifies the application type used by this device.
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.
The application is BSC Remote Job Entry (RJE).
The application is 3270 device emulation, using the 3270 Device Emulation Utility, or the 3270 program interface support provided in the System/38 environment.
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.
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.
Top |
Specifies which BSC station will gain control when line contention occurs.
Specifies that the local system is the secondary station. It will give way to the other station when line contention occurs.
Specifies that the local system is the primary station. It gets control when contention occurs.
Top |
Specifies if the system or user blocks and deblocks transmitted records.
No blocking or deblocking is done by the system.
Records are blocked or deblocked based on the location of an intermediate text block (ITB) control character.
Records are blocked or deblocked, based on the location of an interrecord separator (IRS) character.
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.
The user program provides all control characters, including record separator characters, BSC framing characters, transparency characters, and any other characters needed
Records are blocked or deblocked based on the location of a user-specified record separator character.
Top |
Specifies a unique one-byte record separator character.
Valid values range from 00 to FF; BSC control characters are not allowed.
Top |
Specifies the type of BSCEL session with the remote system.
The remote system or device cannot recognize BSCEL commands. ICF operations and return codes are used.
The remote system can recognize BSCEL start and end commands, and BSCEL online messages.
Top |
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.
Top |
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.
The record length is 512.
Note: This parameter is valid only if APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.
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 |
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.
The text transparency feature is not used.
The text transparency feature is to be used, which permits the transmission of all 256 EBCDIC character codes.
Top |
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 data compression or decompression occurs.
Data is compressed for output and decompressed for input.
Top |
Specifies whether trailing blanks are removed from output records.
Trailing blanks are not removed from output records.
Trailing blanks are removed from output records.
Top |
Specifies a separator for groups of data, such as data sets and documents.
An end of transmission (EOT) control character is used.
A transmission block ending with an end of text (ETX) control character is used.
A null record (STX ETX) is used.
Top |
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).
This device is used to emulate a 3278 display device.
This device is used to emulate a 3284 printer device.
This device is used to emulate a 3286 printer device.
This device is used to emulate a 3287 printer device.
This device is used to emulate a 3288 printer device.
This device is used to emulate a 3289 printer device.
Top |
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.
A 3270 display device keyboard is emulated with uppercase characters only.
A 3270 display device keyboard is emulated with uppercase and lowercase characters.
Top |
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.
3270 emulation allows any data to be typed in the numeric input fields.
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 |
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 work station can use the emulation device.
Specify the name for the work station that is to use this emulation device.
Top |
Specifies the text that briefly describes the object.
Top |
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.
Top |
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.
Top |
Top |