CRTLINASC (Create Line Description (Async))

CRTLINASC Command syntax diagram

 

Purpose

The Create Line Description (Async) (CRTLINASC) command creates a line description for an asynchronous line. More information about using this command is in the Communications Configuration book.

 

Required Parameters

LIND
Specifies the name of the line description being created.

RSRCNAME
Specifies the resource name that describes the automatic call unit port.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. The resource name consists of the input/output adapter (IOA) resource name and the port number on the IOA. For example, if the resource name of the IOA is LIN01 and the port on the IOA is two, then the resource name would be LIN012.

 

Optional Parameters

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

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

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

INTERFACE
Specifies the type of physical interface on the input/ output adapter (IOA) port. The valid interface types are:

*RS232V24: The RS232/V.24 interface is used.

*INTMODEM: The integrated modem is used.

CNN
Specifies the type of line connection used.

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

Note: *NONSWTCAL and *NONSWTANS valid only when INTERFACE(*INTMODEM) is specified.

SNBU
Specifies, for controllers attached to nonswitched lines only, whether the switched network backup (SNBU) feature is activated or deactivated. This feature lets the user bypass a broken nonswitched connection by establishing a switched connection. This parameter applies only if SWITCHED(*NO) and SNBU(*YES) are specified when the controller description is created.

Note: The Change Line Description (Async) (CHGLINASC) and Change Controller Description (Async) (CHGCTLASC) commands must be used to activate the switched backup feature. Switched network backup (SNBU) is valid only if the local modem and remote modem both support the SNBU feature.

*NO: The remote modem does not have the switched network backup (SNBU) feature.

*YES: The modem has the SNBU feature.

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

*NOWAIT: The system does not wait for the vary on to complete. 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
Specifies, for SNBU, whether the line has an associated autocall unit which performs automatic calling to the remote system.

*NO: This switched line does not have an autocall unit.

*YES: This switched line has an autocall unit.

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

Note: The controller description must already exist. Do not use this parameter when following the normal procedure of creating descriptions for lines first, controllers second, and devices last. Use this parameter only when the associated controller descriptions have been created before this line description.

SWTCTLLST
Specifies the names of up to 64 controllers that can establish a connection with the switched line. The controller descriptions must already exist.

Note: Do not use this parameter when following the normal procedure of creating descriptions for lines first, controllers second, and devices last. Use this parameter only when the associated controller descriptions have been created before this line description.

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

8: The default value is eight data bits per character.

7: The format of this tape is FMT3570E. The data format is written on the tape volume with a 3570E device.

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 type of parity specified by the PARITY parameter.

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

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. The remote system must use the same number of stop bits as specified by the STOPBITS parameter for the local system.

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

1: The default value adds one stop bit to each character.

2: The page width is 132 printed characters per line.

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

*FULL: Request-to-send (RTS) is permanently turned on (for full-duplex modems).

*HALF: RTS is turned on only when transmission is required (for half-duplex modems).

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

*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 EOR characters are echoed to the remote system.

Note: Specify *ALL or *CNTL when communicating with a remote system that requires echo. If *ALL or *CNTL are specified for the echo prompt, *FULL must also be specified for the duplex prompt.

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

1200: The default value is 1200 bps.

line-speed: Specify the line speed (bps). Valid lines speeds are: 50, 75, 110, 150, 300, 600, 1200, 2400, 4800, 7200, 9600, 14400, 19200, 28800, 38400, 57600, 76800, and 115200 bps.

MODEM
Specifies the type of modem supported on the communications line. Refer to the modem documentation to determine the appropriate value.

*NORMAL: No attempt is made to run diagnostic tests on the modem.

*V54: A certain type of diagnostic test (as defined by the CCITT recommendations) is run to the modem. The iSeries 400 supports CCITT V.54 loop 3 (local loop back) and loop 2 (remote loop back).

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

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

Note: The user is responsible for ensuring that the line speed corresponds to the actual modem rate.

*FULL: The line operates at the full rate of the modem.

*HALF: The line operates at one-half the full rate, or at the alternate rate, of the modem.

SWTCNN
Specifies, for the switched line and the SNBU line, whether the line is used for incoming calls, outgoing calls, or both incoming and outgoing calls.

*BOTH: The line is used for both incoming and outgoing calls.

*ANS: The line is used for incoming calls only.

*DIAL: The local system starts the call.

AUTOANS
Specifies, for switched or switched network backup (SNBU) lines, whether the system automatically answers a call from a remote system to establish the connection or whether the user must manually answer the call and place the modem in data mode.

*YES: The system automatically answers incoming calls.

*NO: The system operator must manually answer incoming calls.

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

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

*NO: The iSeries 400 does not automatically call a remote system.

*YES: The iSeries 400 automatically calls a remote system.

Note: *YES is valid only if the system is using an autocall unit or if the modem being used is capable of calling though a command interface.

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

*NONE: No dial command type is specified. An automatic call unit establishes the connection.

*V25BIS: The use of one physical interface for call establishment and data transmission is allowed. It is sometimes referred to as a serial automatic call interface because the digits are presented serially on the link from the system (DTE) to the modem (DCE).

*OTHER: The IBM command set is one example of another command type that is used by asynchronous protocols.

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, enter the command string appropriate for that modem to set it to ASYNC mode.

command-string: Specifies up to 40 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:

Table 1. Special characters

Character Description
. 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

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

Note: Valid only when INTERFACE(*INTMODEM) 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:

Table 2. Special characters

Character Description
. 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 mark
@ At sign
^ Circumflex
% Percent
[ Left square bracket
] Right square bracket
\ Back slash
$ Dollar sign

Note: The first two characters of the modem initialization command string must begin with 'AT'. These first two characters must be in uppercase.

ACRSRCNAME
Specifies the resource name that describes the automatic call unit port. The resource name consists of the input/output adapter (IOA) resource name and the port number on the IOA. For example, if the resource name of the IOA is LIN02 and the port is 1, the resource name is LIN021.

CALLNBR
Specifies the local telephone number of the line used for the V.25 bis call request with identification (CRI) dial command. This parameter is used when the CRI function is needed for V.25 bis. When V.25 bis CRI dialing is used, the system takes the called (connection) number from the CNNNBR parameter of the controller description, adds a separator character (;), and concatenates the calling number at the end. Specify the calling number only if the modem and the network both support the CRI dial command.

*NONE: The Call Request Normal (CRN) dial command is used by the V.25 bis line.

calling-number: Specify up to 32 characters that represent the local telephone number for V.25 bis CRI auto-dialing.

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

300: The default value is 30 seconds.

*NOMAX: There is no disconnect limit.

inactivity-timer: Specify a value ranging from 150 through 4200 in 0.1-second intervals.

MAXBUFFER
Specifies the maximum size (number of characters) of inbound and outbound data buffers.

896: The default value is 896 characters.

buffer-size: Specify a value ranging from 128 through 4096 characters.

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 monitoring of errors occurs.

*MIN: The error threshold is set at a minimum monitoring level.

*MED: Error thresholding is set to a medium monitoring level.

*MAX: The error threshold is set at a maximum monitoring level.

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. The system uses the RTS/CTS signals to control the data flow. 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 able to receive characters again, 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 capable of receiving characters. When the hardware is able to receive characters again, it raises the RTS signal to the modem. Also, the hardware monitors the CTS and RTS signals 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.


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.

11: The default value is hexadecimal 11.

XON-character: Specify the XON-character, which can be any value ranging from hexadecimal 01 through FF; however, choose a character that does not appear in the normal data stream, such as hexadecimal 20 (ASCII blank).

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.

13: The default value is hexadecimal 13.

XOFF-character: The XOFF-character can be any value ranging from hexadecimal 01 through FF; however, choose a character that does not appear in the normal data stream, such as hexadecimal 20 (ASCII blank).

EORTBL
Specifies the EOR table which allows the system to recognize logical records when receiving data. Define a line feed (LF) as an 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 pairs. The first element of a pair is the EOR character and the second element specifies the number of characters that follow the EOR character.

Element 1: EOR Character

00: The default is 00.

EOR-character: Valid EOR characters are in the range hexadecimal 01 through 7F (if 7 bits-per-character) or hexadecimal 01 through FF (if 8 bits-per-character). EOR characters are specified as they appear on the line after any translation by the asynchronous communications support.

Element 2: Trailing Characters

0: The default is 0.

trailing-character-count: Specify the number of additional characters received after the EOR character is detected. The number of trailing characters can range from 0 through 4.

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.

1: The default value is 0.5 seconds.

idle-timer: Specify a value ranging from 1 through 254 in 0.5-second intervals, or specify 0 to indicate no timer.

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

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

6: Character density is 16.7 characters per inch.

DSR-drop-timer: Specify a value ranging from 3 through 60 seconds.

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

*DTR: The system enters the Data Terminal Ready (DTR) state, signals the modem to answer calls, and waits for the modem to enter the 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.

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.

25: The system waits up to 25 seconds for the CTS state to begin or end.

CTS-timer: Specify a value ranging from 10 through 120 seconds.>

RMTANSTMR
Specifies the amount of time the system waits for the modem to enter the DSR state after dialing before signaling an error.

60: The system waits 60 seconds before signaling an error.

answer-timer: Specify a value ranging from 30 through 120 seconds.

CMNRCYLMT
Specifies the number of recovery attempts made by the system before an inquiry message is sent to the system operator. Also specifies the time (in minutes) that must elapse before the system sends an inquiry message to the system operator indicating that the recovery attempt count limit is reached.

Element 1: Maximum Recovery Limit

2: Two recovery attempts are made within the interval specified.

count-limit: Specify the number of second-level recovery attempts to be made. Valid values range from 0 through 99.

Element 2: Recovery Time Interval

5: A 15-second time-out period is used.

time-interval: Specify the time interval (in minutes) at which the specified number of second-level recoveries are attempted. Valid values range from 0 through 120. If the value specified for count-limit is not 0, the value 0 specifies infinite recovery.

Other Single Values:

*SYSVAL: The recovery limits specified in the QCMNRCYLMT system value are used.

AUT
Specifies the authority given to users who do not have specific authority to the line description, who are not on an authorization list, and whose user group has no specific authority to the line 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 line description.

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

*EXCLUDE: The user cannot access the line description.

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

TEXT
Specifies the text that briefly describes the line description. 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 CRTLINASC 

CRTLINASC   LIND(ITF)  RSCRNAME(LIN031)

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

Error messages for CRTLINASC

*ESCAPE Messages

CPF2718
Line description &1 not created due to errors.