CRTDEVBSC (Create Device Description (BSC))

CRTDEVBSC Command syntax diagram

 

Purpose

The Create Device Description (BSC) (CRTDEVBSC) command creates a device description for binary synchronous communications (BSC). More information about using this command is in the Communications Configuration book.

 

Required Parameters

DEVD

Specifies the name of the device description being created.

LOCADR

Specifies the local location address. Specify a 2-character hexadecimal value ranging from 00 through FE.

RMTLOCNAME

Specifies the remote location name of the system with which this object communicates.

 

Optional Parameters

ONLINE

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

*YES: The device is automatically varied on at IPL.

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

CTL

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

CNN

Specifies the type of line connection used.

*PP: A point-to-point line is used.

*MPTRIB: A multipoint tributary line is used.

APPTYPE

Specifies the application type being used.

*BSCEL: The application type is Binary Synchronous Communications Equivalence Link (BSCEL). Specify this value to use the intersystem communications function (ICF) support to communicate with other BSC systems or devices. *PGM must be specified on the APPTYPE parameter for the CRTCTLBSC command.

*RJE: The application type is the BSC Remote Job Entry (RJE). *RJE must be specified on the APPTYPE parameter for the CRTCTLBSC command.

*EML: The application type is 3270 device emulation, using the 3270 Device Emulation Utility, or the 3270 program interface support provided in the System/38 environment. *EML must be specified on the APPTYPE parameter for the CRTCTLBSC command.

*BSC38: The application type 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 a mixed device file in the System/38 environment. *PGM must be specified on the APPTYPE parameter for the CRTCTLBSC command.

*RPGT: The application uses RPGII with binary synchronous communications adapter (BSCA) devices and telecommunication specifications. *PGM must be specified on the APPTYPE parameter for the CRTCTLBSC command.

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 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 trying to use this value, or unpredictable results can occur.

CTNWIN

Specifies which BSC station is primary and which is secondary, in order to resolve contention for BSC point-to-point and multipoint lines.

*SEC: The local iSeries 400 is the secondary station, which stops when the other station needs the line.

*PRI: The local iSeries 400 is the primary station.

BLOCK

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

Note:

This parameter is valid only when APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.

With this parameter, one of the following conditions of record formatting can be specified:

No blocking/deblocking: The record format described in the data description specifications (DDS) is the format for both the record and the block.

User blocking/deblocking: The user must provide the BSC controls needed to describe the record format to the system.

System blocking of fixed-length records: The system uses fixed-length records, and blocks and deblocks records accordingly.

If the user specifies a parameter value other than *NONE or *USER, records are blocked as required by the system for output and deblocked on input. Blocking can be done with or without record separator characters. If TRNSPY(*YES) is specified, the records can be blocked without record separator characters by specifying BLOCK(*NOSEP), or the records can be transmitted one record at a time by specifying BLOCK(*NONE). By specifying BLOCK(*USER), records can be blocked to include the BSC transparency controls. If TRNSPY(*NO) is specified, all blocking options are valid.

Up to 512 records can be blocked for transmitting. When the system blocks and deblocks the records, record separator characters and control characters are not passed to the program as data.

*NONE: No blocking or deblocking is done by the system.

*ITB: The records are blocked or deblocked, based on the location of an ITB (intermediate text block) control character. For input files, a record is delimited by locating the next ITB character, an ETX (end-of-text), or ETB (end-of-transmission block) character. For output files, an ITB character is inserted after each record. If the ITB is the last character of the block, it is replaced by an ETX or an ETB character.

*IRS: The records are blocked or deblocked, based on the location of an interrecord separator (IRS) character. For input files, a record is delimited by locating the next IRS character. For output files, an IRS character is inserted after the record.

*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, or record length in an RPGII telecommunications program.

*USER: The program provides all the control characters (including record separator characters, binary synchronous communications (BSC) framing characters, and transparency characters) necessary to send records. More information about the device and binary synchronous communications equivalence link (BSCEL) support characteristics is in the BSC Equivalence Link Programming

book.

*SEP: Records are blocked or deblocked based on the location of a user-specified record separator character. For input files, a record is delimited by locating the next record separator character. For output files, a record separator character is inserted after the record.

If this option is selected, an option must also be specified on the SEPCHAR parameter.

SEPCHAR

Specifies a unique 1-byte record separator character. The record separator character must be specified as two hexadecimal characters.

'1E': The record separator character is '1E'.

Note:

This parameter is valid only when APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.

record-separator-character: Specify a record separator that IS NOT in the following list of BSC control characters.

EBCDIC

BSC Control

X'01'

SOH (Start of header)

X'02'

STX (Start of text)

X'03'

ETX (End of text)

X'10'

DLE (Data link escape)

X'1D'

IGS (Interchange group separator)

X'1F'

ITB (Intermediate text block)

X'26'

ETB (End-of-transmission block)

X'2D'

ENQ (Enquiry)

X'32'

SYN (Synchronization)

X'37'

EOT (End of transmission)

X'3D'

NAK (Negative acknowledgment)

RMTBSCEL

Specifies the type of BSCEL session with the remote system.

*NO: The remote system or device cannot recognize BSCEL commands and BSCEL online messages, but ICF support is desired.

*YES: The remote system can recognize BSCEL start and end commands, and BSCEL online messages.

Note:

This parameter is valid only when APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.

RCDLEN

Specifies the maximum record length allowed when communicating with this device. The maximum value for this parameter is 8192. The value must not exceed the block length value for this device and must not exceed the buffer size specified on the line description (MAXBUFFER) to which this device is attached.

512: The record length is 512.

Note:

This parameter is valid only when APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.

record-length: Specify a value (in bytes) that is at least the size of the largest record to be sent. Valid values range from 1 through 8192.

BLKLEN

Specifies the maximum block length allowed when communicating with this device. The maximum value for this parameter is 8192. This value must not exceed the buffer size specified on the line description (MAXBUFFER) to which this device is attached.

512: The block length is 512.

Note:

This parameter is valid only when 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.

TRNSPY

Specifies whether text transparency is used when sending records. Text transparency permits the transmission of all 256 EBCDIC character codes. Use this feature when transmitting packed or binary data fields. The TRNSPY parameter is ignored if BLOCK(*USER) is specified. TRNSPY(*YES) cannot be specified if TRUNC(*YES) or DTACPR(*YES) is specified.

*NO: Text transparency is not used.

*YES: Text transparency is used that permits the transmission of all 256 EBCDIC character codes. *YES is a valid value only when BLOCK(*NONE), BLOCK(*NOSEP), or BLOCK(*USER) is specified. TRNSPY(*YES) is invalid if the line description specifies CODE(*ASCII).

Note:

This parameter is valid only when APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.

DTACPR

Specifies whether data compression is performed.

Note:

DTACPR(*YES) cannot be specified if TRNSPY(*YES) or TRUNC(*YES) is specified.

*NO: No data compression or decompression occurs.

Note:

This parameter is valid only when APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.

*YES: Data is compressed for output and decompressed for input.

TRUNC

Specifies whether trailing blanks are removed from output records. TRUNC(*YES) cannot be specified if BLOCK(*NOSEP), TRNSPY(*YES), or DTACPR(*YES) is specified. If BLOCK(*USER) is specified, the TRUNC parameter is ignored and trailing blanks are always removed from output records.

Note:

This parameter is valid only when APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.

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

*YES: Trailing blanks are removed from output records.

GRPSEP

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

Note:

This parameter is valid only when APPTYPE(*BSCEL) or APPTYPE(*RPGT) is specified.

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

EMLDEV

Specifies the type of 3270 device being emulated. This parameter is valid only if *EML was specified on the APPTYPE parameter when the device was created. The change requested by this command becomes effective the next time either the Start 3270 Display Emulation (STREML3270) command or the Start Print Emulation (STRPRTEML) command accesses the device.

3278: This device description is used to emulate a 3278 display device.

3284: This device description is used to emulate a 3284 printer device.

3286: This device description is used to emulate a 3286 printer device.

3287: This device description is used to emulate a 3287 printer device.

3288: This device description is used to emulate a 3288 printer device.

3289: This device description is used to emulate a 3289 printer device.

EMLKBD

Specifies, only for 3270 device emulation applications, the type of 3278 display keyboard to be emulated. The specified value is used if EMLDEV(3278) was specified.

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

EMLNUMLCK

Specifies, only for 3270 device emulation applications, whether the numeric shift lock is set automatically for numeric input fields received from the host system. This parameter is for data entry keyboards only.

*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. Numeric data that can be typed include the characters 0 through 9, and symbols + - , . and blank.

EMLWRKSTN

Specifies, only for 3270 device emulation applications, the device address of the emulation work station associated with 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.

emulation-work-station: Specify the device address for the work station using this emulation device.

AUT

Specifies the authority given to users who do not have specific authority to the device description, who are not on an authorization list, and whose user group has no specific authority to the device description.

*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management 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 device description.

*USE: The user can perform basic operations on the device description, such as running a program or reading a file. The user cannot change the device description. *USE authority provides object operational authority, read authority, and execute authority.

*EXCLUDE: The user cannot access the device description.

authorization-list-name: Specify the name of the authorization list used.

TEXT

Specifies the text that briefly describes the device file. More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

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

Example for CRTDEVBSC

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 for CRTDEVBSC

*ESCAPE Messages

CPF261A

Device description &1 not created due to errors.