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.
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:
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.
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.
Specifies, for switched or switched network backup lines (Async, BSC, SDLC, or X.25 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.
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.
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).
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.
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.
Specifies whether the switched (Async, BSC, SDLC, or IDLC) line or switched network backup (Async, BSC, or SDLC) line is used for incoming calls, outgoing calls, or both.
*BOTH
The line is used for both incoming and outgoing calls.
Specifies, for switched or switched network backup lines (Async, BSC, SDLC, or X.25 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.
Specifies, for switched 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 line connection is made by manually dialing the X.25 network.
*YES
The line connection is made by the system automatically dialing the X.25 network.
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.
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:
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'.
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.
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.
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:
If *YES or *HARDWARE is specified, DUPLEX(*FULL) must be specified.
Hardware flow control is performed using the Request To Send (RTS) and Clear To Send (CTS) flow control signals.
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).
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).
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.
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.
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.
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.