Create Ctl Desc (Remote WS) (CRTCTLRWS)
Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Controller Description (Remote Work Station) (CRTCTLRWS) command creates a controller description for a remote work station controller. For more information about using this command, see the Communications Configuration book, SC41-5401.
Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
Top |
Parameters
Keyword | Description | Choices | Notes |
---|---|---|---|
CTLD | Controller description | Name | Required, Positional 1 |
TYPE | Controller type | 3174, 3274, 5251, 5294, 5394, 5494, 5594 | Required, Positional 2 |
MODEL | Controller model | 0, 1, 0001, 2, 0002, 12, 0012, K01 | Required, Positional 3 |
LINKTYPE | Link type | *LAN, *NONE, *SDLC, *X25 | Required, Positional 4 |
ONLINE | Online at IPL | *YES, *NO | Optional |
SWITCHED | Switched connection | *NO, *YES | Optional |
SHM | Short hold mode | *NO, *YES | Optional |
SNBU | Switched network backup | *NO, *YES | Optional |
LINE | Attached nonswitched line | Name | Optional |
SWTLINLST | Switched line list | Values (up to 64 repetitions): Name | Optional |
MAXFRAME | Maximum frame size | 265-1994, 256, 261, 265, 512, 517, 521, 1033, 1994, *LINKTYPE | Optional |
RMTLOCNAME | Remote location | Communications name | Optional |
LCLLOCNAME | Local location | Communications name, *NETATR | Optional |
RMTNETID | Remote network identifier | Communications name, *NETATR, *NONE | Optional |
EXCHID | Exchange identifier | 00100000-FFFFFFFF | Optional |
INLCNN | Initial connection | *DIAL, *ANS | Optional |
DIALINIT | Dial initiation | *LINKTYPE, *IMMED, *DELAY | Optional |
CNNNBR | Connection number | Character value, *DC, *ANY | Optional |
ANSNBR | Answer number | *CNNNBR, *ANY | Optional |
CNNLSTOUT | Outgoing connection list | Name | Optional |
CNNLSTOUTE | Connection list entry | Name | Optional |
SHMDSCLMT | SHM disconnect limit | 1-254, 10, *NOMAX | Optional |
SHMDSCTMR | SHM disconnect timer | 2-3000, 50 | Optional |
STNADR | Station address | 01-FE | Optional |
ADPTADR | LAN remote adapter address | 000000000001-FFFFFFFFFFFF | Optional |
NETLVL | X.25 network level | 1980, 1984, 1988 | Optional |
LINKPCL | X.25 link level protocol | *QLLC, *ELLC | Optional |
LGLCHLID | X.25 logical channel ID | Character value | Optional |
CNNPWD | X.25 connection password | Character value, X'' | Optional |
AUTOCRTDEV | Autocreate device | *ALL, *NONE | Optional |
SWTDSC | Switched disconnect | *YES, *NO | Optional |
TEXT | Text 'description' | Character value, *BLANK | Optional |
DEV | Attached devices | Values (up to 254 repetitions): Name | Optional |
CODE | Character code | *EBCDIC, *ASCII | Optional |
DEVWAITTMR | Device wait timer | 2-600, 120 | Optional |
SSCPID | SSCP identifier | 000000000001-FFFFFFFFFFFF, 050000000000 | Optional |
IDLCWDWSIZ | IDLC window size | 1-31, *LIND | Optional |
IDLCFRMRTY | IDLC frame retry | 0-100, *LIND | Optional |
IDLCRSPTMR | IDLC response timer | 10-100, *LIND | Optional |
IDLCCNNRTY | IDLC connect retry | 1-100, *LIND, *NOMAX | Optional |
PREDIALDLY | Predial delay | 0-254, 6 | Optional |
REDIALDLY | Redial delay | 0-254, 120 | Optional |
DIALRTY | Dial retry | 0-254, 2 | Optional |
POLLPTY | SDLC poll priority | *NO, *YES | Optional |
POLLLMT | SDLC poll limit | 0-4, 0 | Optional |
OUTLMT | SDLC out limit | *POLLLMT, 0, 1, 2, 3, 4 | Optional |
CNNPOLLRTY | SDLC connect poll retry | 0-65534, *CALC, *NOMAX | Optional |
NDMPOLLTMR | SDLC NDM poll timer | 0-3000, *CALC | Optional |
DSAP | LAN DSAP | 04, 08, 0C, 10, 14, 18, 1C, 20, 24, 28, 2C, 30, 34, 38, 3C, 40, 44, 48, 4C, 50, 54, 58, 5C, 60, 64, 68, 6C, 70, 74, 78, 7C, 80, 84, 88, 8C, 90, 94, 98, 9C | Optional |
SSAP | LAN SSAP | 04, 08, 0C, 10, 14, 18, 1C, 20, 24, 28, 2C, 30, 34, 38, 3C, 40, 44, 48, 4C, 50, 54, 58, 5C, 60, 64, 68, 6C, 70, 74, 78, 7C, 80, 84, 88, 8C, 90, 94, 98, 9C | Optional |
LANFRMRTY | LAN frame retry | 0-254, *CALC | Optional |
LANCNNRTY | LAN connection retry | 0-254, *CALC | Optional |
LANRSPTMR | LAN response timer | 0-254, *CALC | Optional |
LANCNNTMR | LAN connection timer | 0-254, *CALC | Optional |
LANACKTMR | LAN acknowledgement timer | 0-254, *CALC | Optional |
LANINACTMR | LAN inactivity timer | 0-255, *CALC | Optional |
LANACKFRQ | LAN acknowledgement frequency | 0-127, *CALC | Optional |
LANMAXOUT | LAN max outstanding frames | 1-127, *CALC | Optional |
LANACCPTY | LAN access priority | 0-3, *CALC | Optional |
LANWDWSTP | LAN window step | 1-127, *NONE | Optional |
SWTLINSLCT | X.25 switched line selection | *FIRST, *CALC | Optional |
DFTPKTSIZE | X.25 default packet size | Element list | Optional |
Element 1: Transmit value | *LIND, 64, 128, 256, 512, 1024, 2048, 4096 | ||
Element 2: Receive value | *LIND, *TRANSMIT, 64, 128, 256, 512, 1024, 2048, 4096 | ||
DFTWDWSIZE | X.25 default window size | Element list | Optional |
Element 1: Transmit value | 1-15, *LIND | ||
Element 2: Receive value | 1-15, *LIND, *TRANSMIT | ||
USRGRPID | X.25 user group identifier | Character value | Optional |
RVSCRG | X.25 reverse charging | *NONE, *REQUEST, *ACCEPT, *BOTH | Optional |
X25FRMRTY | X.25 frame retry | 0-21, 7 | Optional |
X25CNNRTY | X.25 connection retry | 0-21, 7 | Optional |
X25RSPTMR | X.25 response timer | 1-2550, 100 | Optional |
X25CNNTMR | X.25 connection timer | 1-2550, 100 | Optional |
X25DLYTMR | X.25 delayed connection timer | 1-32767, *CALC | Optional |
X25ACKTMR | X.25 acknowledgement timer | 0-2550, 20 | Optional |
X25INACTMR | X.25 inactivity timer | 1-2550, 350 | Optional |
USRFCL | User facilities | Character value | Optional |
ALCRTYTMR | Allocation retry timer | 1-9999, 180 | Optional |
CMNRCYLMT | Recovery limits | Single values: *SYSVAL Other values: Element list |
Optional |
Element 1: Count limit | 0-99, 2 | ||
Element 2: Time interval | 0-120, 5 | ||
MSGQ | Message queue | Single values: *SYSVAL, *SYSOPR Other values: Qualified object name |
Optional |
Qualifier 1: Message queue | Name | ||
Qualifier 2: Library | Name | ||
AUT | Authority | Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT | Optional |
Top |
Controller description (CTLD)
This is a required parameter.
Specifies the name of the controller description.
Top |
Controller type (TYPE)
This is a required parameter.
Specifies the type of controller for this description.
- 3174
This description represents a 3174 controller.
- 3274
This description represents a 3274 controller.
- 5251
This description represents a 5251 controller.
- 5294
This description represents a 5294 controller.
- 5394
This description represents a 5394 controller.
- 5494
This description represents a 5494 controller.
Top |
Controller model (MODEL)
This is a required parameter.
Specifies the model number of the controller that is described. This number tells the system which features the controller has.
- 0
The model number for a 3174 or 3274 controller.
- 1
The model number for a 5294, 5394, or 5494 Model 1 controller.
- 2
The model number for a 5394 or 5494 Model 2 controller.
- 12
The model number for a 5251 Model 12 controller.
- K01
The model number for a 5294 Model K01 controller.
Top |
Link type (LINKTYPE)
Specifies the type of line to which this controller is attached.
This is a required parameter.
- *LAN
This controller is attached to a Local Area Network (LAN).
- *NONE
This controller description is not attached to a line.
- *SDLC
This controller is attached to a synchronous data link control (SDLC) line.
- *X25
This controller is attached to an X.25 line.
Top |
Online at IPL (ONLINE)
Specifies whether this object is automatically varied on at initial program load (IPL).
- *YES
The controller is automatically varied on at IPL.
- *NO
The controller is not automatically varied on at IPL.
Top |
Switched connection (SWITCHED)
Specifies whether this controller is attached to a switched line, a token-ring network, Ethernet LAN, or an X.25 switched virtual circuit (SVC). *NO must be specified for APPC controllers attached to a TDLC line.
- *NO
This controller is attached to a nonswitched line. Specify this value for controllers attaching to an X.25 permanent virtual circuit (PVC).
- *YES
This controller is attached to a switched line. Specify this value for controllers attached to an X.25 switched virtual circuit (SVC). Also specify this value for controllers attached to a local area network.
Note: If LINKTYPE is *LAN, the SWITCHED parameter value must be *YES or must not be specified.
Top |
Short hold mode (SHM)
Specifies whether this controller is to be used for X.21 short hold mode. To specify *YES, you must also specify *SDLC for the Link type (LINKTYPE) parameter, and *YES for the Switched connection (SWITCHED) parameter.
- *NO
This controller is not used for X.21 short hold mode.
- *YES
This controller is used for X.21 short hold mode.
Top |
Switched network backup (SNBU)
Specifies whether the remote system modem has the switched network backup (SNBU) feature. The backup feature is used to bypass a broken nonswitched (leased line) connection by establishing a switched connection. To activate SNBU, you must change the controller description of the modem from nonswitched to switched by specifying *YES for the Activate swt network backup (ACTSNBU) parameter.
Note: If the modem model you are using is an IBM 386x, 586x, or 786x, you should not change the controller description. Instead, manually switch the modem to the unswitched mode, and manually dial the connection.
Both the local and remote modems must support the SNBU feature to perform a valid activation.
- *NO
- The remote system modem does not have the SNBU feature.
- *YES
The remote system modem has the SNBU feature.
Top |
Attached nonswitched line (LINE)
Specifies the name of the nonswitched line to which this controller is attached. The line description must already exist.
Note: The associated line must be varied off before this command is entered. Specify this parameter for controllers attaching to an X.25 permanent virtual circuit (PVC).
Top |
Switched line list (SWTLINLST)
Specifies the names of the switched lines to which this controller attaches. The line descriptions must already exist. Up to 64 switched line names can be specified.
- switched-line-name
Specify the names of up to 64 lines that are connected to this controller. The same line name can be used more than once. For each line name specified, a line description by that name must already exist.
Top |
Maximum frame size (MAXFRAME)
Specifies the maximum frame (path information unit (PIU)) size the controller can send or receive. This value is used to calculate the request unit (RU) sizes. Since the maximum PIU size that the controller can send or receive is negotiated at exchange identifier time, the maximum PIU size used at run time may be different. This value matches the corresponding value on the host system.
- *LINKTYPE
For a 3174 controller with a link type of *ISDN, a value of 521 is used. For a 3174 controller with a link type of *LAN, a value of 1994 is used. For a 3174 controller with a link type of *SDLC, a value of 265 is used. For a 3174 controller with a link type of *X25, a value of 256 is used. For a 5394 controller with a link type of *X25, a value of 512 is used. For a 5394 controller with a link type of *SDLC, a value of 517 is used.
- maximum-frame-size
- For a 3174 controller with a link type of *SDLC or *X25, specify the value 265.
- For a 5394 controller with a link type of *X25 line, specify 265 or 521.
- For a 5394 controller with a link type of *SDLC, specify 261 or 517.
Top |
Remote location (RMTLOCNAME)
Specifies the NAME of the remote location associated with the remote system.
Top |
Local location (LCLLOCNAME)
Specifies the local location name.
- *NETATR
The LCLNETID value specified in the system network attributes is used.
- local-location-name
Specify the name (8 characters maximum) by which the local system is known to the remote system.
Top |
Remote network identifier (RMTNETID)
Specifies the NAME of the remote network in which the adjacent control point resides.
- *NETATR
The LCLNETID value specified in the system network attributes is used.
- *NONE
- No remote network identifier (ID) is used.
- remote-network-identifier
Specify the remote network identifier.
Top |
Exchange identifier (EXCHID)
Specifies the exchange identifier of the controller. The controller sends (exchanges) its identifier to another location when a connection is made. The 8-digit hexadecimal identifier contains 3 digits for the block number and 5 digits for the identifier of the specific controller.
Top |
Initial connection (INLCNN)
Specifies the method used to establish a connection with this controller.
- *DIAL
The system initiates outgoing calls and answers incoming calls.
- *ANS
The connection is made by the IBM System i5 when it answers an incoming call from this controller. If a call is received from the remote controller and all necessary conditions are met, the incoming call is answered by the system.
For X.25 connections, the line attached to the controller requires switched virtual circuits (SVCs) configured on the LGLCHLE parameter of type OUT or BOTH(*SVCOUT or *SVCBOTH) for the connection to succeed.
The line can be changed using the Change Line Description (X.25) (CHGLINX25) command.
Top |
Dial initiation (DIALINIT)
Specifies the method used to make the initial dial on a switched line between the system and the remote controller.
- *LINKTYPE
The type of dial connection initiated is specified on the LINKTYPE parameter. For LAN or SDLC short-hold mode connections, the default is to dial the connection as soon as the controller description is varied on. For all other link types, the default is to delay dialing.
- *IMMED
The dial connection is initiated as soon as the controller description is varied on.
- *DELAY
The dial connection is delayed until a job is initiated that requests the use of the remote controller resources.
Top |
Connection number (CNNNBR)
Specifies the telephone number to dial to connect to this controller.
- *DC
Direct call is being used in an X.21 circuit switched network.
- *ANY
- The system accepts calls from any network address.
- connection-number
Specify the connection number.
Top |
Answer number (ANSNBR)
Specifies the X.25 network address from which calls are accepted.
- *CNNNBR
Calls from the X.25 network address specified on the CNNNBR parameter are accepted.
- *ANY
Calls are accepted from any X.25 network address.
Top |
Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.
Outgoing connection list (CNNLSTOUT)
Specifies, for ISDN switched connections, the name of a connection list object that contains the ISDN assigned numbers for a dial out operation to the ISDN.
- list-object
Specify the name of a connection list object.
Top |
Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.
Connection list entry (CNNLSTOUTE)
Specifies, for ISDN switched connections, the entry name from the connection list that is used to make a call to the ISDN. The connection list must have been identified on the Outgoing connection list (CNNLSTOUT) parameter.
- entry-name
Specify an entry name.
Top |
SHM disconnect limit (SHMDSCLMT)
Specifies the number of consecutive nonproductive responses that are required from the remote station before the connection can be suspended for this X.21 short hold mode connection. This parameter is used only if *YES is specified for the Short hold mode (SHM) parameter, and *NEG or *SEC is specified for the Data link role (ROLE) parameter.
- 10
10 consecutive nonproductive responses must be received before the connection can be suspended.
- *NOMAX
There is no disconnect limit.
- SHM-disconnect-limit
Specify a number from 1 to 254, indicating the number of consecutive nonproductive responses that must be received before the connection can be suspended.
Top |
SHM disconnect timer (SHMDSCTMR)
Specifies, in tenths of a second, the minimum length of time that the primary system maintains the connection to the remote system for this X.21 short hold mode controller. This parameter is valid only if *YES is specified for the Short hold mode (SHM) parameter, and *NEG or *SEC is specified for the Data link role (ROLE) parameter.
- 50
The primary maintains the connection to the remote system for a minimum of 5 seconds.
- SHM-disconnect-timer
Specify a value from 2 to 3000 in 0.1 second intervals.
Top |
Station address (STNADR)
Specifies the station address used when communicating with the controller.
Valid values range from 00 to FE.
Note: 00 can be specified only for APPC controllers when *TDLC is specified for the Link type (LINKTYPE) parameter.
Note: If *SEC is specified on the ROLE parameter, this is the station address of the remote controller. If *PRI or *NEG is specified on the ROLE parameter, this is the local station address.
Top |
LAN remote adapter address (ADPTADR)
Specifies the 12-character adapter address of the remote controller. This is the address to which the system sends data when it communicates with the remote controller. This value can be obtained from the remote controller's configuration record. Valid values range from hex 000000000001 through hex FFFFFFFFFFFF.
- adapter-address
Specify the adapter address of the remote controller.
Top |
X.25 network level (NETLVL)
Specifies the level of the X.25 network used to access this controller. The level is specified by giving the year of the standard used by the X.25 network.
Note: Use of the lower value of the remote DTE or the network level is suggested; for example, if the remote DTE is using the CCITT standard of 1980 and the network 1984, specify 1980 for this parameter.
- 1980
The 1980 Standard is used.
- 1984
The 1984 Standard is used.
- 1988
The 1988 Standard is used.
Top |
X.25 link level protocol (LINKPCL)
Specifies the link level protocol used on the X.25 network to communicate with this controller.
- *QLLC
The Qualified Logical Link Control (QLLC) protocol is used.
- *ELLC
The Enhanced Logical Link Control (ELLC) protocol is used.
Top |
X.25 logical channel ID (LGLCHLID)
Specifies the logical channel identifier used for the X.25 permanent virtual circuit (PVC) to this controller. The valid entry is xyy. Where:
- x = the logical group number, derived from your network subscription.
- yy = the logical channel number, derived from your subscription. The logical channel identifier must be one of the PVC logical channel identifiers that was defined in the X.25 line description. There is no default for this parameter.
Top |
X.25 connection password (CNNPWD)
Specifies the X.25 network password used for password exchange with the X.24 Call Request and Incoming Call packets (Call User Data field). This parameter is not valid for permanent virtual circuit (PVC) connections.
If you want to use a connection password that consists of characters whose hexadecimal value is less than 40, you must specify the password as a hexadecimal value. When less than 8 bytes are specified, the end of the password field is padded with blanks. A password of all blank is valid. All incoming call requests must match this password to establish a connection.
To specify a hexadecimal password, the digits must be specified in multiples of two, be no more than 16 digits long, be enclosed in apostrophes, and be preceded by an X. For example, X'0102030405' is a valid hexadecimal password.
Note: This connection password is highly recommended for controllers that operate with the Enhanced Logical Link Control (ELLC) protocol LINKPCL(*ELLC) on switched virtual circuit (SVC) connections. This enhanced protocol supports reconnection of virtual circuits after network errors which disconnect the line with a clear signal; however, this reconnection is not allowed to proceed without the password validation procedure being used as a unique identifier for the controller.
- X.25-connection-password
Specify the connection password. The password for each controller can consist of any alphanumeric characters represented by the hexadecimal values ranging from 40 through FF.
Top |
Autocreate device (AUTOCRTDEV)
Specifies whether device descriptions can be automatically created for this controller description.
- *ALL
All dependent devices than can be automatically created for this controller, except APPC devices, are automatically created.
- *NONE
Dependent devices on this controller are not automatically created.
Top |
Switched disconnect (SWTDSC)
Specifies whether the switched connection to this controller is dropped when the last device is varied off.
- *NO
The switched connection is not dropped when the last device is varied off.
- *YES
The switched connection is varied off when the last device is varied off.
Top |
Text 'description' (TEXT)
Specifies the text that briefly describes the object.
- *BLANK
No text is specified.
- character-value
Specify no more than 50 characters of text, enclosed in apostrophes.
Top |
Attached devices (DEV)
Attached devices (DEV)
Specifies the names of the devices that are attached to this controller. The device descriptions must already exist.
The maximum number of devices that can be specified is 64, but varies for some types of controllers:
- Controller
- Maximum number of devices
- 5251
- 9
- 5294
- 8
- 5494
- 56
Top |
Character code (CODE)
Specifies whether the extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII) character code is used on the line.
- *EBCDIC
The extended binary-coded decimal interchange code (EBCDIC) character code is used.
- *ASCII
- The ASCII character code is used.
Top |
Device wait timer (DEVWAITTMR)
Specifies the device wait timeout value. This is used to limit the amount of time that a subsystem takes for the work station input/output to complete. The timeout value that is used for each device is obtained from the controller that it is attached to at vary on time. A change in this parameter value takes effect for attached devices when they are next varied on.
- 120
The default amount of time is 120 seconds.
- device-wait-timer
Specify a value ranging from 2 through 600 that specifies the maximum number of seconds that the subsystem waits for work station input/output to complete for all work stations attached to this controller.
When selecting a value for this parameter, the types of devices attached to the controller should be taken into account. Locally attached work stations should have a low value for this parameter (10 seconds or less).
Top |
SSCP identifier (SSCPID)
Specifies the system service control point identifier of the host system.
- 050000000000
The default value for the system service control point identifier.
- system-service-control-point-identifier
Specify the system service control point identifier as a 12-digit hexadecimal value.
Top |
Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.
IDLC window size (IDLCWDWSIZ)
Specifies the window size for transmission to and reception controllers attached to the IDLC line.
- *LIND
The value specified in the line description is used as the default window size.
- window-size
Specify the window size. Valid values range from 1 through 31.
Top |
Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.
IDLC frame retry (IDLCFRMRTY)
Specifies the maximum number of attempts to transmit a frame before reporting an error.
- *LIND
The number of attempts specified in the line description is used.
- IDLC-frame-retry
Specify a number of attempts. Valid values range from 0 through 100.
Top |
Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.
IDLC response timer (IDLCRSPTMR)
Specifies the amount of time, in tenths of a second, to wait before retransmitting a frame if acknowledgement has not been received.
- *LIND
The time specified in the line description is used.
- IDLC-response-timer
Specify an amount of time. Valid values range from 10 through 100 tenths of a second. For example, 100 tenths of a second equals 10 seconds.
Top |
Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.
IDLC connect retry (IDLCCNNRTY)
Specifies the number of times to attempt retransmission at connection time.
- *LIND
The number of attempts specified in the line description is used.
- *NOMAX
- Indicates to continue until a successful transmission has been made.
- connect-retry
Specify a number of attempts. Valid values range from 1 through 100.
Top |
Predial delay (PREDIALDLY)
Specifies the time interval to wait (in 0.5 second intervals) before dialing a number.
- 6
The default value of 6 provides a 3-second delay.
- predial-delay
- Specify a value ranging from 0 to 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.
Top |
Redial delay (REDIALDLY)
Specifies the time interval to wait (in 0.5 second intervals) before re-dialing when the call attempt is unsuccessful.
- 120
- The default value of 120 provides a 60-second delay.
- redial-delay
- Specify a value from 0 to 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.
Top |
Dial retry (DIALRTY)
Specifies the number of re-dial attempts made by the system before considering the dialing unsuccessful.
- 2
- The default number of retries is 2.
- dial-retry
- Specify a value from 0 to 254 in 0.5-second intervals, for the number of times the dialing will be tried.
Top |
SDLC poll priority (POLLPTY)
Specifies whether this controller has priority when polled. This parameter can be specified only if SHM is *NO.
- *NO
This controller does not have polling priority.
- *YES
This controller does have polling priority.
Top |
SDLC poll limit (POLLLMT)
Specifies, for an SDLC secondary or negotiable controller, the number of consecutive polls issued to the same controller when the poll results in receiving frames. This parameter can be specified only if SHM is *NO.
- 0
The default number of polls is zero.
- poll limit
Specify a number of polls. Valid values range from 0 through 4.
Top |
SDLC out limit (OUTLMT)
Specifies the number of consecutive times SDLC allows the transmission of the maximum number of frames to a station, before allowing transmission to another station.
- *POLLLMT
The value is the same as the one specified for the SDLC poll limit (POLLLMT) parameter.
- out-limit
Specify a value ranging from 0 through 4.
Top |
SDLC connect poll retry (CNNPOLLRTY)
Specifies the number of times to retry connecting to a controller before reporting an error.
- *CALC
The number of retries is 7 if the controller is switched, and *NOMAX if the controller is nonswitched.
- *NOMAX
The system will retry indefinitely.
- connect-poll-retry
Specify a value ranging from 0 to 65534 for the number of retries.
Top |
SDLC NDM poll timer (NDMPOLLTMR)
Specifies the minimum interval at which a secondary station should be polled if a poll from the primary to the secondary (which is in normal disconnect mode (NDM)) does not result in receiving the appropriate response.
This parameter is valid only if the link type is *SDLC and the controller role is secondary or negotiable and *NO is specified on the SHM parameter.
- *CALC
The poll interval is calculated by the system.
- NDM-poll-timer
Specify a value ranging from 1 to 3000 units. Each unit represents 0.1 second. To indicate no timer, specify 0.
Top |
LAN DSAP (DSAP)
Specifies the destination service access point (DSAP). This is the logical address this system will send to when it communicates with the remote controller. This address allows the controller to properly route the data that comes from this system. The default value for the destination service access point is 04.
The value must match the value specified on the source service access point (SSAP) parameter in the remote controller's configuration record.
Note: The *OPC controller uses the value above for this field. The combination of RMTSYSNAME and DSAP defines a unique controller. This allows multiple controllers to exist between two systems.
- 04
The destination service access point is the default 04.
- destination-service-access-point
Specify a hexadecimal value ranging from 04 through 9C, in increments of 4 (for example, 04, 08, 0C, 10) to represent the destination service access point.
Top |
LAN SSAP (SSAP)
Specifies the source service access point (SSAP). This is the logical address the local system uses when it sends data to the remote controller. This address allows the controller to properly route the data that comes from the local system. The default value for the source service access point is 04.
It must match the value assigned to the destination service access point (DSAP) in the remote controller's configuration record.
- 04
The system uses the logical address of 04.
- source-service-access-point
Specify a hexadecimal value ranging from 04 through 9C, in increments of 4 (for example, 04, 08, 0C, 10) to represent the source service access point.
Top |
LAN frame retry (LANFRMRTY)
Specifies the number of times to retry a transmission when there is no acknowledgment from the remote controller in the time period specified by the LANRSPTMR parameter. This value is only used after a successful connection has been made.
- *CALC
The system determines the timer value.
- LAN-frame-retry
Specify a value ranging from 0 through 254 for the number of times a frame is transmitted before an acknowledgement is received.
Top |
LAN connection retry (LANCNNRTY)
Specifies the number of times a transmission is attempted before an acknowledgement is received. This value is used at connection time (unlike LANFRMRTY which is used after a connection has been made).
- *CALC
The system determines the timer value.
- LAN-connection-retry
Specify a value ranging from 0 through 254 for the number of times the transmission is attempted before an acknowledgement is received.
Top |
LAN response timer (LANRSPTMR)
Specifies the time period used to determine an inoperative condition on the link when connected.
- *CALC
The system determines the timer value.
- LAN-response-timer
Specify a value from 1 to 254 units. Each unit represents 0.1 second. To indicate no timer, specify 0.
Top |
LAN connection timer (LANCNNTMR)
Specifies the time period used to determine an inoperative condition on the link at connection time.
- *CALC
The system determines the timer value.
- LAN-connection-timer
Specify a value ranging from 1 through 254 in 0.1-second intervals for the amount of time the system waits before an inoperative condition occurs. To indicate no timer, specify 0.
Top |
LAN acknowledgement timer (LANACKTMR)
Specifies the time interval to delay sending acknowledgements for received frames.
- *CALC
The system determines the timer value.
- LAN-acknowledgement-timer
Specify a value ranging from 1 to 254 units. Each unit represents 0.1 second. To indicate no timer, specify 0. If 0 is specified for the LAN acknowledgement frequency (LANACKFRQ) parameter, 0 must also be specified for this parameter. If a non-zero number is specified for the LANACKFRQ parameter, a non-zero number must also be specified for this parameter.
Top |
LAN inactivity timer (LANINACTMR)
Specifies the time period used to determine an inactive condition for the controller.
- *CALC
The system determines the timer value.
- LAN-inactivity-timer
Specify a value ranging from 1 through 255 in 0.1-second intervals for the length of time used to determine an inactive condition for the controller. To indicate no timer, specify 0.
Top |
LAN acknowledgement frequency (LANACKFRQ)
Specifies the maximum number of frames received before sending an acknowledgement to the controller.
- *CALC
The system determines the LAN acknowledgement frequency value.
- LAN-acknowledge-frequency
Specify a value from 0 to 127 for the number of frames received. If 0 is specified for the LAN acknowledgement timer (LANACKTMR) parameter, 0 must also be specified for this parameter. If a non-zero number is specified for the LANACKTMR parameter, a non-zero number must also be specified for this parameter.
Top |
LAN max outstanding frames (LANMAXOUT)
Specifies the maximum number of frames that can be sent before an acknowledgement is received from the remote system.
- *CALC
The system determines the LAN maximum outstanding frames value.
- LAN-maximum-outstanding-frames
Specify a value ranging from 1 through 127 for the number of frames that can be sent before an acknowledgement is received.
Top |
LAN access priority (LANACCPTY)
Specifies the priority used for accessing the remote controller. The larger the number the higher the priority for this controller. This parameter is only used when the controller attaches to TRLAN.
- *CALC
The system determines the LAN access priority value.
- LAN-access-priority
Specify a value from 0 to 3 for the access priority for this controller on a local area network (LAN).
Top |
LAN window step (LANWDWSTP)
Specifies whether to reduce to 1 the maximum number of frames outstanding to the remote system during network congestion. This parameter (LAN Window Step) indicates the number of frames that must be successfully received by the remote system before the number of maximum outstanding frames can be increased by 1. The increase continues this way until the maximum number of outstanding frames reaches the value specified by the LAN maximum outstanding frames (LANMAXOUT) parameter.
- *NONE
The number of outstanding frames is not reduced during network congestion.
- LAN-window-step
Specify a value from 1 to 127 for the number of frames that must be successfully received by the remote system before the maximum number of outstanding frames can be increased by 1.
Top |
X.25 switched line selection (SWTLINSLCT)
Specifies the method that is used to select lines from an X.25 switched line list.
- *FIRST
Lines are selected beginning with the first line in the switched line list.
- *CALC
The system determines which line in the switched line list will be selected.
Top |
X.25 default packet size (DFTPKTSIZE)
Specifies the default packet size used by the X.25 network for transmission and reception.
Element 1: Transmit Packet Size
- *LIND
The value specified in the line description is the default value.
- transmit-packet-size
Specify a default packet size for transmission. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.
Element 2: Receive Packet Size
- *LIND
The value specified in the line description is the default value.
- *TRANSMIT
The value specified as the default packet size for transmission is used as the default for reception.
- receive-packet-size
Specify a default packet size for reception. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.
Top |
X.25 default window size (DFTWDWSIZE)
Specifies the default window size for transmission and reception.
Element 1: Transmit Window Size
- *LIND
The value specified in the line description is used as the default window size.
- transmit-window-size
Specify the appropriate default window size. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15. For switched virtual circuit (SVC) incoming calls, the system accepts the window size indicated in the Incoming Call packet facilities field.
Element 2: Receive Window Size
- *LIND
The value specified in the line description is used as the default window size.
- *TRANSMIT
The value specified as the default window size for transmission is used as the default for reception.
- receive-window-size
Specify the appropriate default window size. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15.
Top |
X.25 user group identifier (USRGRPID)
Specifies the closed user-group ID for contacting this switched virtual circuit (SVC) controller on the X.25 network.
Specify the 2-digit decimal value, from 00 through 99, as provided by the network subscription. This parameter is not valid for permanent virtual circuit (PVC) connections. It is valid only for SVC circuit outgoing call operations and is ignored for SVC incoming call connections.
Top |
X.25 reverse charging (RVSCRG)
Specifies whether reverse charges are accepted or requested when contacting this controller.
- *NONE
No reverse charging for network tariff billing is accepted.
- *REQUEST
Charges are requested on outgoing call request packets.
- *ACCEPT
Reverse charging for network tariff billing is accepted on incoming requests.
- *BOTH
Both incoming and outgoing requests are accepted.
Top |
X.25 frame retry (X25FRMRTY)
Specifies the maximum number of times a frame is sent after the response timer ends when connected to this controller. The value for this parameter depends on the quality of service provided by the network and the connection to that network; that is, the frequency of lost link protocol data units.
- 7
The default for the maximum number of transmissions is 7.
- X.25 frame retry
Specify a value ranging from 0 through 21 for the number of times a frame is sent.
Top |
X.25 connection retry (X25CNNRTY)
Specifies the maximum number of times that a logical link control (LLC) protocol data unit is sent after the connect response timer expires when connecting to this controller.
- 7
The default for the maximum number of transmissions is 7.
- X.25 connection retry
Specify a value ranging from 0 through 21 for the number times a frame is sent.
Top |
X.25 response timer (X25RSPTMR)
Specifies the time period allowed to return an acknowledgement when an LLC protocol data unit is sent while connected to this controller.
- 300
The time allowed to return an acknowledgment is 30 seconds.
- X.25 response-timer
Specify an amount of time in tenths of a second. Valid values range from 1 through 2550 in 0.1-second intervals.
Top |
X.25 connection timer (X25CNNTMR)
Specifies the time period allowed to return an acknowledgement when an LLC protocol data unit is sent while connecting to this controller.
- 100
The default amount of time is 10 seconds.
- connection-timer
Specify an amount of time in tenths of a second. Valid values range from 1 through 2550 in 0.1 second intervals.
Top |
X.25 delayed connection timer (X25DLYTMR)
Specifies the time interval between attempts to establish a connection to the controller.
- *CALC
Use the values specified for the X.25 connection timer (X25CNNTMR) parameter and the X.25 connection retry (X25CNNRTY) parameter to determine how often and how many times to try establishing the connection.
- X.25-delay-timer
Specify a value ranging from 1 to 32767 units. Each unit represents 0.1 second. Connection attempts are repeated indefinitely at this time interval.
Top |
X.25 acknowledgement timer (X25ACKTMR)
Specifies the amount of time to delay sending acknowledgements for received frames.
- 20
The time allowed to delay sending an acknowledgment is 2 seconds.
- X.25-acknowledgment-timer
Valid values range from 1 to 2550 in 0.1 second intervals, or 0 to indicate no delay.
Top |
X.25 inactivity timer (X25INACTMR)
Specifies the time period used to determine an inactive condition for the controller. Valid values range from 1 to 2550 in 0.1 second intervals.
- 350
The time period used to determine an inactive condition for the controller is 3.5 seconds.
Top |
User facilities (USRFCL)
Specifies a string of hexadecimal characters sent to the X.25 network to request additional services. The system allows up to 218 hexadecimal characters.
Top |
Allocation retry timer (ALCRTYTMR)
Specifies the length of time, in seconds, the system waits between attempts to establish an LU6.2 session.
- 180
The system waits 180 seconds between attempts.
- 1-9999
Specify a length of time ranging from 1 through 9999 seconds.
Top |
Recovery limits (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.
- *SYSVAL
- The value in the QCMNRCYLMT system value is used.
- 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
The specified number of recovery attempts is made within a 5-minute interval.
- 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.
More information on communication recovery is in the Communcations Management book, SC41-5406.
Top |
Message queue (MSGQ)
Specifies the message queue to which operational messages are sent.
- *SYSVAL
- Messages are sent to the message queue defined in the QCFGMSGQ system value.
- *SYSOPR
- Messages are sent to the system operator message queue (QSYS/QSYSOPR).
Qualifier 1: Message queue
- name
- Specify the name of the message queue to which operational messages are sent.
Qualifier 2: Library
- name
- Specify the name of the library where the message queue is located.
For more information about using this command, see the Communcations Management book, SC41-5406.
Top |
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.
Top |
Examples
CRTCTLRWS CTLD(CTL005) TYPE(5294) MODEL(1) LINKTYPE(*SDLC) SWITCHED(*YES) EXCHID(04500003) INLCNN(*ANS) STNADR(03) CNNNBR(5551234) TEXT('Chicago branch')
This command creates a 5294 Model 1 remote controller description called CTL005. The controller is on a SDLC switched line at telephone number 555-1234. Connection to the controller is initiated by an incoming call to the IBM System i.
Top |
Error messages
*ESCAPE Messages
- CPF26BB
- Extended wireless controller member not changed.
- CPF26BC
- Extended wireless controller member not displayed.
- CPF26BD
- Entry for barcode group not removed from extended wireless controller member.
- CPF26BE
- Entry for PTC group not removed from extended wireless controller member.
- CPF26BF
- Program QZXCINZ terminated abnormally. See previous messages.
- CPF26B3
- Extended wireless line member not added.
- CPF26B4
- Extended wireless line member not changed.
- CPF26B5
- Extended wireless line member not displayed.
- CPF26B8
- Extended wireless controller member not added.
- CPF2716
- Controller description &1 not created.
Top |