Create Line Desc (Async) (CRTLINASC)

The Create Line Description Asynchronous (Async) (CRTLINASC) command creates a line description for an asynchronous line.

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

Parameters

Line description (LIND)

Specifies the name of the line description.

This is a required parameter.

Resource name (RSRCNAME)

Specifies the resource name that identifies the hardware this description represents. Use the WRKHDWRSC command to determine the resource name if this line description does not use an external Ethernet device server.

*ETHDEVSVR

This line description uses an external Ethernet device server which supports RFC 2217. These servers are sometimes known as Ethernet serial servers or Ethernet terminal servers.

name

Specify the resource name of the communications port.

Online at IPL (ONLINE)

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

*YES

The line is automatically varied on at initial program load (IPL).

*NO

This line is not automatically varied on at IPL.

Physical interface (INTERFACE)

Specifies the type of physical interface on the input/output adapter (IOA) port.

*RS232V24 (Async and BSC only)

RS-232/V.24 physical interface.

*INTMODEM

The integrated modem interface is used.

Connection type (CNN)

Specifies the type of line connection.

*NONSWTPP

A nonswitched point-to-point line is used.

*SWTPP

A switched point-to-point line is used.

*NONSWTCAL

A nonswitched point-to-point line is used for call mode.

*NONSWTANS

A nonswitched point-to-point line is used for answer mode.

Switched network backup (SNBU)

Specifies, for nonswitched modems only, if the local modem supports the switched network backup utility (SNBU) feature. The backup feature is used to bypass a broken nonswitched (nonswitched line) connection by establishing a switched connection.

To activate SNBU, you must change the mode of the modem from nonswitched to switched. If the modem model is IBM 386x, 586x, or 786x, no change is required. Otherwise, specify *YES for the Activate swt network backup (ACTSNBU) parameter for the line description you are using.

*NO

The local modem does not have the SNBU feature.

*YES

The local modem has the SNBU feature.

Vary on wait (VRYWAIT)

Specifies whether the line is varied on asynchronously or synchronously. For synchronous vary on, this parameter specifies how long the system waits for the vary on to complete.

*NOWAIT

The system does not wait for vary on completion. The line is varied on asynchronously.

vary-on-wait

Specify the time (in seconds) to wait. Valid values range from 15 through 180. The system waits until the line is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.

Notes:

1. When ONLINE(*YES) is used, specifying a wait time in the line description affects system IPL time. In such cases, system IPL time is influenced by the amount of time required to synchronously vary on the line or reach the wait-time value.
2. The time required to vary on a line is the time it takes to:
   • Put tasks in place to manage the line
   • Activate the communications I/O processor (IOP), including downloading the IOP model-unique Licensed Internal Code
   • Establish the communications tasks and processes

Normal vary-on time ranges from 5 through 45 seconds, but can be longer, depending on the system, line protocol, and other factors.

Autocall unit (AUTOCALL)

Specifies, for switched or switched network backup lines (Async or BSC line), whether the line has an associated automatic call unit that can automatically call the remote system.

*NO

No automatic call unit is associated with this line.

*YES

An automatic call unit is associated with this line.

Data bits per character (BITSCHAR)

Specifies the number of data bits per character (excluding the parity bit if any).

8

8 data bits per character are used.

Note: 8 bits with parity cannot be used with some Input/Output processors.

7

7 data bits per character are used.

Type of parity (PARITY)

Specifies the type of parity used for error checking (a parity bit is a binary digit inserted in each byte of data to make the arithmetic sum of all the digits, including the parity bit, always odd or always even).

Note: The remote system must use the same parity.

*NONE

No parity bit is inserted in the data byte.

*ODD

The arithmetic sum of all the digits, including the parity bit, is odd.

*EVEN

The arithmetic sum of all the digits, including the parity bit, is even.

Stop bits (STOPBITS)

Specifies the number of bits added to the end of each character. These bits are used to keep the local and remote ends of the line synchronized.

Note: The remote system must use the same number of stop bits as the local system.

1

1 stop bit is added to each character.

2

2 stop bits are added to each character.

Note: At line speeds of 300 bps or lower, 2 stop bits are recommended.

Duplex (DUPLEX)

Specifies whether request-to-send (RTS) is permanently turned on (for duplex modems) or turned on only when transmission is required (for half duplex modems).

*HALF

Request-to-send (RTS) is turned on only when transmission is required (for half duplex modems). You can choose to run half duplex even if the modem can support duplex communication.

*FULL

Request-to-send (RTS) is permanently set on (for duplex modems).

Echo support (ECHO)

Specifies whether the system sends back (echo) all characters it receives to the remote system, send back all characters except end-of-record characters, or if echo is inhibited.

Note: Specify *ALL or *CNTL if this line supports communication with a remote system that requires echo. If you specify *ALL or *CNTL, you must also specify *FULL for the Duplex (DUPLEX) parameter.

*NONE

No characters received are echoed to the remote system.

*ALL

All characters received are echoed to the remote system.

*CNTL

All characters received prior to end-of-record characters are echoed to the remote system.

Line speed (LINESPEED)

Specifies the line speed in bits per second (bps).

1200

1200 bps is used.

line-speed

Specify the line speeds. Valid lines speeds are: 50, 75, 110, 150, 300 600, 1200, 2400 4800, 7200, 9600, 14400, 19200, 28800, 38400, 57600, 76800, or 115200 bits per second.

Modem type supported (MODEM)

Specifies the type of modem supported on the communications line. Refer to the modem manual to determine the appropriate value to select.

*NORMAL

No attempt is made to run diagnostic tests to your modem.

*V54

Certain types of diagnostic tests (as defined by the CCITT recommendations) are run to your modem. This system supports CCITT V.54 loop 3, (a local loop back,) and loop 2, (which is a remote loop back).

*IBMWRAP

An IBM modem with wrap test capabilities is used on the communications line.

*IBMLPDA1

An IBM modem with Link Problem Determination Aid-1 (LPDA-1) is used on the line.

*IBMLPDA2

An IBM modem with Link Problem Determination Aid-2 (LPDA-2) is used on the line.

Switched connection type (SWTCNN)

Specifies whether the switched (Async or BSC) line or switched network backup (Async or BSC) line is used for incoming calls, outgoing calls, or both.

*BOTH

The line is used for both incoming and outgoing calls.

*ANS

The line is used for incoming calls only.

*DIAL

The line is used for outgoing calls only.

Autoanswer (AUTOANS)

Specifies, for switched or switched network backup lines (Async or BSC line), whether the system automatically answers a call from a remote system to establish the connection, or whether the system operator manually answers the call and places the modem in data mode.

Note: *YES is a valid option only if the modem has the automatic answer feature.

*YES

The incoming call is automatically answered by the automatic answer feature.

*NO

The incoming call must be manually answered.

Autodial (AUTODIAL)

Specifies, for switched or switched network backup (SNBU) lines, whether the system automatically calls a remote system to establish a connection or if the system operator must manually place the call.

*NO

The system does not automatically call a remote system.

*YES

The system automatically calls a remote system.

Note: Automatic dialing is valid only if the system is using an automatic call unit or if the modem can call through a command interface.

Dial command type (DIALCMD)

Specifies the type of dial command used to establish a switched connection with a remote system.

*NONE

No dial command is used. (An automatic call unit is used to establish the connection.)

*V25BIS

V.25 bis is a recommendation which allows the use of one physical interface for call establishment and data transmission. It is referred to as a serial automatic call interface because the digits are presented serially on the link from the system to the modem.

*OTHER

The IBM command set is one example of another command type that is used by asynchronous protocols. The dial digits and all other call-related data must be placed directly into the data stream by the application program.

Set modem to ASYNC command (SETMDMASC)

Specifies the V25BIS command string to send to the modem to set the modem to ASYNC mode.

*NONE

No V25BIS command string is sent to the modem.

END

The END command string is generally used as the command to set most modems to ASYNC mode. For cases that do not use the END command string, you should enter the command string appropriate for that modem to set it to ASYNC mode.

command-string

Specify up to 40 characters that represent the command issued. Valid characters are upper case characters A through Z, lower case characters a through z, numbers 0 through 9, and the following special characters:

.

Period

<

Less than sign

(

Left parenthesis

+

Plus sign

&

Ampersand

*

Asterisk

)

Right parenthesis

;

Semicolon

-

Minus sign

/

Slash

,

Comma

_

Underline

>

Greater than sign

?

Question mark

:

Colon

=

Equal sign

Modem init command string (MDMINZCMD)

Specifies the modem initialization command string sent to set the modem.

Note: Valid only when INTERFACE(*INTMODEM) or INFTRFTYPE(*SYNCMODEM) is specified.

*NONE

No command string is sent to the modem.

command-string

Specifies up to 60 characters that represent the command string sent to the modem. Valid characters are upper case A thru Z, lower case a thru z, numbers 0 thru 9, and special characters:

    Period
    Less than sign
    Left parenthesis
    Plus sign
    Ampersand
    Asterisk
    Right parenthesis
    Semicolon
    Minus sign
    Slash
    Comma
    Underline
    Greater than sign
    Question mark
    Colon
    Equal sign
    Spaces
    Number sign
    Double quote
    Exclamation point
    At sign
    Hat symbol
    Percent
    Left square bracket
    Right square bracket
    Back slash

Note: The modem initialization string must begin with the two characters 'AT'.

Autocall resource name (ACRSRCNAME)

Specifies the automatic call resource name that describes the automatic call unit port that is used to establish a connection with a remote system. Use the Work with Hardware Resources (WRKHDWRSC) command to determine the resource name.

Calling number (CALLNBR)

Specifies the local telephone number of the line that is used for the V.25 bis Call Request with Identification (CRI) dial command. When V.25 bis CRI dialing is used, the system takes the called (connection) number (CNNNBR parameter ), adds a separator character (;), and puts the calling number at the end. The default, *NONE, indicates that Call Request Normal (CRN) is used.

Specify the calling number only when the modem and network support the CRI dial command.

*NONE

Call Request Normal (CRN) is used. CRN dialing sends only the connection number to the V.25 bis modem.

calling-number

Specify the local telephone number if V.25 bis CRI dialing is required. The number can be up to 32 characters in length. See your modem documentation to determine the values allowed by the modem.

Note: Specify the calling number only if both the modem and network support the V.25 bis CRI dial command.

Remote internet address (RMTINTNETA)

Specifies the internet address of the Ethernet device server.

Note: This parameter is required when *ETHDEVSVR is specified for the resource name (RSRCNAME) parameter.

character-value

Specify the internet address of the Ethernet device server.

An IPv4 internet address is specified in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. Leading zeros in each part of the dotted decimal internet address are invalid and will be removed. An internet address is not valid if it has a value of all binary ones or zeros for the network identifier (ID) or host portion of the address. If the internet address is entered from the command line, the address must be enclosed in apostrophes.

An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address. An IPv6 internet address must be a unicast address and must not contain an imbedded IPv4 address (compatibility or mapped).

Remote port (RMTPORT)

Specifies the remote port for the TCP/IP connection to the Ethernet device server.

Note: This parameter is required when *ETHDEVSVR is specified for the resource name (RSRCNAME) parameter.

port-number

Specify a value ranging from 1 through 65535.

Inactivity timer (INACTTMR)

Specifies the time (in tenths of a second) the system waits for activity on a switched line before disconnecting the line.

*NOMAX

The system waits indefinitely for activity.

inactivity-timer

Specify a value from 150 to 4200 units. Each unit represents 0.1 second, which provides a time range of 15 to 420 seconds.

Maximum buffer size (MAXBUFFER)

Specifies the maximum size of inbound and outbound data buffers.

Flow control (FLOWCNTL)

Specifies whether the hardware controls the data flow.

*NO

Prevents the hardware from generating or recognizing flow control characters, and prevents the use of Request to Send (RTS) and Clear to Send (CTS) flow control signals.

*YES

The system uses the flow control capabilities of the asynchronous protocol. If *YES is specified, the hardware recognizes flow control characters. This means that upon receipt of an XOFF character, the hardware stops transmission until an XON character is received. It also means that the hardware sends an XOFF character to the remote location when it is incapable of receiving characters. When the hardware is again able to receive characters, it sends an XON character to the remote system.

*HARDWARE

If this option is specified, the hardware signals the modem to stop sending data by dropping RTS signals when it is not capabl of receiving characters. When the hardware is able to receive characters again, it raises the RTS signal to the modem. Also, the hardware monitor the CTS and RTS signal from the modem and stops sending data when it is turned off.

NOTES:

1. If *YES or *HARDWARE is specified, DUPLEX(*FULL) must be specified.
2. Hardware flow control is performed using the Request To Send (RTS) and Clear To Send (CTS) flow control signals.

XON character (XONCHAR)

Specifies the hexadecimal value of the flow control character XON. If the system received an XOFF character while sending data, it automatically stops sending, and it starts sending data again only after receiving an XON character.

XON-character

The XON-character can be any value from hexadecimal 01 through FF; however, you must specify a different character than the XOFF character and one that does not appear in your normal data stream, such as hexadecimal 20 (ASCII blank).

XOFF character (XOFFCHAR)

Specifies the hexadecimal value of the flow control character XOFF. If the system receives an XOFF character while sending data, it automatically stops sending, and starts sending data again only after receiving an XON character.

XOFF-character

Specify the hexadecimal XOFF character. The XOFF-character can be any value between hexadecimal 01 and FF; however, you must specify a different character than the XON character and one that does not appear in your normal data stream, such as hexadecimal 20 (ASCII blank).

End-of-Record table (EORTBL)

Specifies the table which allows the hardware to recognize logical records when receiving data. You can define a line feed (LF) as an end-of-record (EOR) character in the data stream, and have the hardware return the data when the LF character is detected in the data stream.

The EOR table is specified as a set of paired elements, in which the first element of a pair is the EOR character and the second element specifies the number of characters that follow the EOR character. Up to 8 entries can be specified. A value of 00 indicates that no end-of-record character is defined.

You can enter multiple values for this parameter.

EOR-character

Specify the end-of-record character(s). Valid end-of-record characters are in the range hexadecimal 01 through 7F (if 7 bits-per-character) or 01 through FF (if 8 bits-per-character). End-of-record characters are specified as they appear on the line after any translation by the Asynchronous communications support.

trailing-characters

Specify the number of additional characters received after the end-of-record character is detected. The number of trailing characters is 0 through 4.

Data Set Ready drop timer (DSRDRPTMR)

Specifies the amount of time that the system waits for the modem to exit the Data Set Ready (DSR) state before signaling an error.

drop-timer

Specify a value ranging from 3 through 60 seconds.

Autoanswer type (AUTOANSTYP)

Specifies the method that the system uses to answer incoming calls.

*DTR

The system enters the Data Terminal Ready state, signals the modem to answer calls, and waits for the modem to enter the Data Set Ready (DSR) state.

*CDSTL

The system enters the Connect Data Set to Line (CDSTL) state after monitoring the Ring Indicator to signal the modem to answer the call.

Remote answer timer (RMTANSTMR)

Specifies the amount of time that system waits for the modem to enter the Data Set Ready (DSR) state after dialing before signaling an error.

answer-timer

Specify a value ranging from 30 through 120 seconds in 5-second intervals.

Text 'description' (TEXT)

Specifies text that briefly describes the line description.

*BLANK

Text is not specified.

character-value

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

Attached nonswitched ctls (CTL)

Specifies, for nonswitched lines, the names of one or more controllers to which this line is attached. The controller descriptions must already exist.

Switched controller list (SWTCTLLST)

Specifies the names of up to 64 switched controllers that can establish a connection with this switched line. The controller descriptions must already exist. This parameter is valid only if the line is switched or the nonswitched line has the switched network backup (SNBU) feature.

You can enter multiple values for this parameter.

switched-controller-list

Specify the switched controller names. Up to 64 switched controllers can be specified.

Modem data rate select (MODEMRATE)

Specifies the speed at which the line operates if the modem has the data rate select feature.

*FULL

The line operates at the full rate of the modem.

*HALF

The line operates at half the full rate of the modem.

Error threshold level (THRESHOLD)

Specifies the temporary error threshold level being monitored by the system. A permanent error is reported only if the errors occurred consecutively and exceeded the retry limit.

Note: Specifying the THRESHOLD parameter affects all threshold errors. They cannot be specified individually.

*OFF

No threshold errors are reported.

*MIN

The threshold for errors is set to a minimum monitoring level.

*MED

The threshold for errors is set to a medium monitoring level.

*MAX

The threshold for errors is set to a maximum monitoring level.

Idle timer (IDLTMR)

Specifies the time (in 0.5 second intervals) that the system waits between characters before the adapter forwards the receive buffer to the system.

idle-timer

Specify a value from 1 to 254 in 0.5 second intervals, or specify 0 which represents no timer.

Note: Idle timer is also referred to as inter-character timer.

Clear To Send timer (CTSTMR)

Specifies the amount of time the system waits for the modem to enter or exit the Clear to Send (CTS) state before signaling an error.

*NOMAX

The system waits indefinitely.

cts-timer

Specify a value ranging from 10 through 120 seconds.

Recovery limits (CMNRCYLMT)

Specifies the second-level communications recovery limits to be used for this line description.

The possible count-limit values are:

2

Two recovery attempts are made within the specified time interval.

*SYSVAL

The value in the QCMNRCYLMT system value is used.

count-limit

Specify the number of recovery attempts to be performed by the system. Valid values range from 0 through 99.

The possible time-interval values are:

5

The specified number of recovery attempts are made within a 5-minute interval.

time-interval

Specify the number of minutes within which recovery attempts are made. Valid values range from 0 through 120 in 1-minute intervals.

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

Example 1: Create an Asynchronous Line Description

CRTLINASC   LIND(ITF)  RSRCNAME(LIN031)

This command creates an asynchronous line description named ITF with a resource name of LIN031.

Example 2: Create an Asynchronous Line Description Using an Ethernet Device Server

CRTLINASC LIND(ASCEDSVR) RSRCNAME(*ETHDEVSVR)
          RMTINTNETA('192.168.1.7') RMTPORT(6025)

This command creates an asynchronous line description named ASCEDSVR which uses an Ethernet device server. The IP address of the Ethernet device server is 192.168.1.7, and the port for the connection to the server is 6025.

Error messages

*ESCAPE Messages

CPF2718

Line description &1 not created due to errors.