Create Ctl Desc (APPC) (CRTCTLAPPC)
Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Controller Description (APPC) (CRTCTLAPPC) command creates a controller description for an advanced program-to-program communications (APPC) controller. For more information about this command, see the Communications Configuration book, SC41-5401.
Notes:
- Parameters no longer supported as of V5R3M0: CNNLSTOUT, CNNLSTOUTE, IDLCCNNRTY, IDLCFRMRTY, IDLCRSPTMR, IDLCWDWSIZ
- Parameters no longer supported as of V7R4M0: ADPTADR, APPN, ANSNBR, CNNCPNAME, CNNNBR, CNNNETID, CNNPOLLRTY, CNNPWD, DFTPKTSIZE, DFTWDWSIZE, DIALRTY, HPR, LANACCPTY, LANACKFRQ, LANACKTMR, LANCNNRTY, LANCNNTMR, LANFRMRTY, LANINACTMR, LANMAXOUT, LANRSPTMR, LANWDWSTP, LGLCHLID, LINE, LINKPCL, MDLCTL, NDMPOLLTMR, NETLVL, OUTLMT, POLLLMT, POLLPTY, PREDIALDLY, REDIALDLY, RVSCRG, SHM, SHMDSCLMT, SHMDSCTMR, SNBU, STNADR, SWTLINLST, SWTLINSLCT, TYPE, USRFCL, USRGRPID, X25ACKTMR, X25CNNRTY, X25CNNTMR, X25DLYTMR, X25FRMRTY, X25INACTMR, X25RSPTMR
- Link type (LINKTYPE) values no longer supported as of V7R4M0: *ANYNW, *FAX, *FR, *ILAN, *LAN, *SDLC, *TDLC, *X25
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, Key, Positional 1 |
LINKTYPE | Link type | *HPRIP, *LOCAL, *OPC, *VRTAPPN | Required, Key, Positional 2 |
ONLINE | Online at IPL | *YES, *NO | Optional |
SWITCHED | Switched connection | *NO, *YES | Optional |
RMTINTNETA | Remote internet address | Character value | Optional |
LCLINTNETA | Local internet address | Character value, *SYS | Optional |
LDLCTMR | LDLC timers | Element list | Optional |
Element 1: LDLC retry count | 0-255, 3 | ||
Element 2: LDLC retry timer | 0-65535, 15 | ||
Element 3: LDLC liveness timer | 0-65535, 10 | ||
LDLCLNKSPD | LDLC link speed | 1200-603979776000, *CAMPUS, *WAN, 4M, 10M, 16M, 100M, *MIN, *MAX | Optional |
LDLCTMSGRP | LDLC transmission group | Element list | Optional |
Element 1: Cost/connect time | 0-255, 0 | ||
Element 2: Cost/byte | 0-255, 0 | ||
Element 3: Security | *NONSECURE, *PKTSWTNET, *UNDGRDCBL, *SECURECND, *GUARDCND, *ENCRYPTED, *MAX | ||
Element 4: Propagation delay | *LAN, *MIN, *TELEPHONE, *PKTSWTNET, *SATELLITE, *MAX | ||
MAXFRAME | Maximum frame size | 265-16393, 256, 265, 512, 521, 1024, 1033, 1496, 1994, 2048, 2057, 4060, 4096, 8156, 16393, *LINKTYPE | Optional |
RMTNETID | Remote network identifier | Communications name, *NETATR, *NONE, *ANY | Optional |
RMTCPNAME | Remote control point | Communications name, *ANY | Optional |
RMTSYSNAME | Remote system name | Character value | Optional |
EXCHID | Exchange identifier | 00000000-FFFFFFFF | Optional |
INLCNN | Initial connection | *DIAL, *ANS | Optional |
DIALINIT | Dial initiation | *LINKTYPE, *IMMED, *DELAY | Optional |
ROLE | Data link role | *NEG, *PRI, *SEC | 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 |
CPSSN | APPN CP session support | *YES, *NO | Optional |
NODETYPE | Remote APPN node type | *ENDNODE, *LENNODE, *NETNODE, *CALC | Optional |
BEXROLE | Branch extender role | *NETNODE, *ENDNODE | Optional |
HPRPTHSWT | HPR path switching | *NO, *YES | Optional |
TMSGRPNBR | APPN transmission group number | 1-20, 1, *CALC | Optional |
MINSWTSTS | APPN minimum switched status | *VRYONPND, *VRYON | Optional |
AUTOCRTDEV | Autocreate device | *ALL, *NONE | Optional |
AUTODLTDEV | Autodelete device | 1-31680, 31680, *NO | Optional |
USRDFN1 | User-defined 1 | 0-255, *LIND | Optional |
USRDFN2 | User-defined 2 | 0-255, *LIND | Optional |
USRDFN3 | User-defined 3 | 0-255, *LIND | Optional |
TEXT | Text 'description' | Character value, *BLANK | Optional |
DEV | Attached devices | Values (up to 254 repetitions): Name | Optional |
CODE | Character code | *EBCDIC, *ASCII | Optional |
SSCPID | SSCP identifier | 000000000001-FFFFFFFFFFFF | Optional |
SWTDSC | Switched disconnect | *YES, *NO | Optional |
DSCTMR | Disconnect timer | Element list | Optional |
Element 1: Minimum connect timer | 0-65535, 170 | ||
Element 2: Disconnection delay timer | 0-65535, 30 | ||
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 |
Link type (LINKTYPE)
Specifies the type of line to which this controller is attached.
This is a required parameter.
- *HPRIP
This controller will allow HPR (High Performance Routing) to use the Internet as a link layer, allowing HPR data to be transported over Internet networks.
Note: If *HPRIP is specified, a value must be specified for the RMTINTNETA parameter.
- *LOCAL
This controller uses no communication lines since all communications are local. If *LOCAL is specified, the following criteria must be met:
- SWITCHED must remain unspecified or be *NO
- The MAXFRAME, RMTNETID, RMTCPNAME, EXCHID, CPSSN, NODETYPE, TMSGRPNBR, SSCPID, and ROLE parameters must not be specified
- *OPC
This controller is attached to the optical bus (OptiConnect).
- *VRTAPPN
This controller is used for APPN communications. It is not attached to any specific communications line. If *VRTAPPN is specified, the following criteria must be met:
- SWITCHED must remain unspecified or be *NO
- The MAXFRAME, RMTNETID, RMTCPNAME, EXCHID, CPSSN, NODETYPE, TMSGRPNBR, SSCPID, and ROLE parameters must not be specified
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.
- *NO
This controller is attached to a nonswitched line.
- *YES
This controller is attached to a switched line.
Top |
Remote internet address (RMTINTNETA)
Specifies the TCP/IP host name or internet address to which the controller will respond.
Note: This parameter is valid only when *HPRIP is specified for the Link type (LINKTYPE) parameter.
- host-name
-
This is a valid host name or a domain qualified host name associated with an internet address. A name must be between 1 and 255 characters in length.
- host-internet-address
The internet address can be specified in either IPv4, IPv6 or IPv4 mapped to IPv6 form.
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 IPv4 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.
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 IPv4-mapped IPv6 address is specified in the form ::FFFF:nnn.nnn.nnn.nnn, where nnn is decimal number ranging from 0 through 255.
If the internet address is entered from the command line, the address must be enclosed in apostrophes.
Top |
Local internet address (LCLINTNETA)
Specifies the TCP/IP interface to be used to communicate with the remote system.
Note: This parameter is valid only when *HPRIP is specified for the Link type (LINKTYPE) parameter.
- *SYS
The system will select the local internet address to use.
- internet-address
The internet address can be specified in either IPv4, IPv6 or IPv4 mapped to IPv6 form.
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 IPv4 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.
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 IPv4-mapped IPv6 address is specified in the form ::FFFF:nnn.nnn.nnn.nnn, where nnn is decimal number ranging from 0 through 255.
If the internet address is entered from the command line, the address must be enclosed in apostrophes.
- Alias-name
The alias name is the same value that is specified on the ADDTCPIFC and CHGTCPIFC commands Alias name (ALIASNAME) parameter.
Top |
LDLC timers (LDLCTMR)
Specifies LDLC (Logical Data Link Control) timers and retry count. The LDLC retry count and LDLC retry timer are used in conjunction. The LDLC retry count and LDLC retry timer are initialized when a command or request is first transmitted over the link. If the LDLC retry timer expires before a response is received, the command or request is retransmitted, the LDLC retry count is decremented and the LDLC retry timer is restarted. If the timer expires with the LDLC retry count at zero, the link is assumed to be inoperative. The LDLC liveness timer is used to make sure that both the other endpoint of an RTP (rapid transport protocol) connection and the path between the endpoints are still operational after a period of inactivity.
See High Performance Routing Architecture Reference (SV40-1018) for more information.
http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/D50H6003/CCONTENTS
Note: This parameter is valid only when *HPRIP is specified for the Link type (LINKTYPE) parameter.
Element 1: LDLC retry count
- 3
- The LDLC retry count is 3.
- retry-count
- Specify the LDLC retry counter. Valid values range from 0 to 255.
Element 2: LDLC retry timer
- 15
- The LDLC retry timer is set to 15 seconds.
- retry-timer
- Specify the LDLC retry timer interval. Valid values range from 0 to 65535 seconds.
Element 3: LDLC liveness timer
- 10
- The LDLC liveness timer is set to 10.
- liveness-timer
- Specify the LDLC liveness timer. Valid values range from 0 to 65535 seconds.
Top |
LDLC link speed (LDLCLNKSPD)
Specifies the LDLC (Logical Data Link Control) link speed in bits per second.
See High Performance Routing Architecture Reference (SV40-1018) for more information.
http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/D50H6003/CCONTENTS
Note: This parameter is valid only when *HPRIP is specified for the Link type (LINKTYPE) parameter.
- *CAMPUS
Specifies a set of default APPN link characteristics for a campus environment be used.
- *WAN
Specifies a set of default APPN link characteristics for a wide-area network environment be used.
- 4M
The link speed is 4 million bits per second.
- 10M
The link speed is 10 million bits per second.
- 16M
The link speed is 16 million bits per second.
- 100M
The link speed is 100 million bits per second.
- *MIN
A link speed of less than 1200 bits per second is used.
- *MAX
A link speed greater than 100 million bits per second is used.
- LDLC-link-speed
Specify the LDLC link speed.
Valid values range from 1200 to 603979776000.
Top |
LDLC transmission group (LDLCTMSGRP)
Specifies the LDLC (Logical Data Link Control) transmission group characteristics of Cost/connect time, Cost/byte, Security and Propagation delay.
See High Performance Routing Architecture Reference (SV40-1018) for more information.
http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/D50H6003/CCONTENTS
Note: This parameter is valid only when *HPRIP is specified for the Link type (LINKTYPE) parameter.
Element 1: Cost/connect time
Cost per connect time specifies the relative cost of being connected over the link.
- 0
- Cost per connect time is zero.
- cost-connection-time
- Specify the cost per connect time. Valid values range from 0 to 255.
Element 2: Cost/byte
Cost per byte specifies the relative cost of sending and receiving data over the link.
- 0
- Cost per byte is zero.
- cost-byte
- Specify the cost per byte. Valid values range from 0 to 255.
Element 3: Security
Security specifies the security over the link.
- *NONSECURE
- There is no security over the link.
- *PKTSWTNET
- This is a packet-switched network, so the link is secure in the sense that the data does not always use the same path through the network.
- *UNDGRDCBL
- This is an underground cable secure conduit.
- *SECURECND
- This is a secured conduit but not guarded.
- *GUARDCND
- The link is a guarded conduit and protected against physical tapping.
- *ENCRYPTED
- Data flow is to be encrypted.
- *MAX
- This is a guarded conduit, protected against physical and radiation tapping.
Element 4: Propagation delay
Propagation delay specifies the time required for a signal to travel from one end of a link to the other end.
- *LAN
- Specifies a local area network delay (less than 0.48 milliseconds).
- *MIN
- Specifies the minimum delay.
- *TELEPHONE
- Specifies a telephone network with a delay from .48 milliseconds through 49.152 milliseconds.
- *PKTSWTNET
- Specifies a packet-switched network with the delay from 49.152 through 245.76 milliseconds.
- *SATELLITE
- Specifies satellite delay (greater than 245.76 milliseconds).
- *MAX
- Specifies the maximum delay.
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
The following values are used for the various types:
- *HPRIP - 1461
- maximum-frame-size
Specify the frame size for the controller. The frame size that can be used depends on the type of line being used. Valid frame sizes for each line type are:
- For *HPRIP, specify a value equal to or larger than 768.
Note: The numeric values listed for *LINKTYPE are valid only if TYPE(*BLANK) is specified when the controller is created.
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.
- *ANY
The system determines which remote network identifier is used.
- remote-network-identifier
Specify the remote network identifier.
Top |
Remote control point (RMTCPNAME)
Specifies the control point name of the remote system.
- *ANY
The system determines the name of the remote control point used.
- remote-control-point-name
Specify the remote control point NAME.
Top |
Remote system name (RMTSYSNAME)
Specifies the NAME of the remote system to which there is an OptiConnect bus connection. The current system NAME of the remote system can be found by using the DSPNETA command on that system.
Note: This parameter is valid only when LINKTYPE(*OPC) is specified.
Top |
Exchange identifier (EXCHID)
Specifies the remote exchange identifier of this controller. The controller sends (exchanges) its identifier to another location when a connection is established. The 8-digit hexadecimal identifier contains 3 digits for the block number and 5 digits for the identifier of the specific controller.
The block number of the exchange identifier is related to the controller:
- Controller
- Block Number
- 3174, 3274
- 001 to 0FE
- 3601 *
- 016 (* 3601 is configured as 4701)
- 3651, 3684
- 005
- 3694
- 02F
- 4680
- 04D
- 4684
- 005
- 4702, 4702
- 057
- 5251
- 020
- 5294
- 045
- 5394
- 05F
- 5494
- 073
- System i5
- 056
- Displaywriter
- 03A
- System/36
- 03E
- System/38
- 022
For the 5251, 5394, and 5294 controllers, the last five digits must begin with 000. For 5494 controllers, the last five digits are either 000nn where nn is the station address of the 5494 controller, or the last five digits of the 5494 serial number when the serial number starts with XI.
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 i system 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.
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 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 |
Data link role (ROLE)
Specifies the data link role which the remote controller has on this connection. The primary station is the controlling station and the secondary station is the responding station. The primary station controls the data link by sending commands to the secondary station, and the secondary station responds to the commands.
- *NEG
The local system and the remote system negotiate which computer is primary.
- *PRI
The remote system is the primary station on this communications line.
- *SEC
The remote system is a secondary station on this communications line.
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 |
APPN CP session support (CPSSN)
Specifies whether this controller supports sessions between control points.
- *YES
This controller supports sessions between control points.
- *NO
This controller does not support sessions between control points.
Top |
Remote APPN node type (NODETYPE)
Specifies the type of APPN node which this controller represents.
- *ENDNODE
This node is an end node in an APPN network.
- *LENNODE
This node is a low-entry networking node in an APPN network.
- *NETNODE
This node is a network node in an APPN network.
- *CALC
The system determines the type of node this controller represents.
Top |
Branch extender role (BEXROLE)
Specifies the role of the local system in an APPN network for the remote controller being configured. This parameter is only used when the local system has enabled the branch extender function via the NODETYPE parameter in the network attributes being set to *BEXNODE.
- *NETNODE
The local system takes the role of a network node for the remote controller.
- *ENDNODE
The local system takes the role of an end node for the remote controller.
Top |
HPR path switching (HPRPTHSWT)
Specifies whether an attempt is made to switch paths of HPR connections associated with this controller at the time the controller is varied off. If a path switch is not attempted or if there are no other available paths, jobs associated with the HPR connections will be ended.
See the APPN information in the Networking category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for more information.
- *NO
When this controller is varied off path switching will not be done for HPR connections associated with this controller. Jobs associated with HPR connections will be ended.
- *YES
When this controller is varied off an attempt to switch paths of HPR connections associated with this controller will be made.
Top |
APPN transmission group number (TMSGRPNBR)
Specifies the transmission group number for this controller.
- 1
The default transmission group is one.
- *CALC
The system specifies the value for the transmission group number.
- transmission-group-number
Specify a value from 1 to 20 for the transmission group number.
Top |
APPN minimum switched status (MINSWTSTS)
Specifies the minimum status of the switched connection so that APPN will consider it as a controller that is available for routing.
- *VRYONPND
APPN will consider the controller available for routing if the status is vary on pending, varied on, or active.
- *VRYON
APPN will consider the controller available for routing only if the status is varied on or active.
Top |
Autocreate device (AUTOCRTDEV)
Specifies whether device descriptions can be automatically created for this controller description.
Note: This parameter does not apply to the automatic creation of APPC devices. This parameter only applies to dependent devices on this controller.
- *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 |
Autodelete device (AUTODLTDEV)
Specifies the number of minutes an automatically created device can remain in an idle state (when there are no active conversations on that device). When the time expires, the system automatically varies off and deletes the device description.
- 31680
The system will automatically vary off and delete the automatically-configured idle device descriptions after 31680 minutes (22 days).
- *NO
The system will not automatically vary off and delete the automatically-configured idle device descriptions.
- 1-31680
- Specify the number of minutes to wait before deleting the automatically-configured idle device descriptions for this controller. Valid values range from 1 to 31680 minutes (22 days).
Top |
User-defined 1 (USRDFN)
This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.
- *LIND
The user-defined value specified in the line description is used.
- user-defined
Specify a value ranging from 0 through 255.
Top |
User-defined 2 (USRDFN)
This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.
- *LIND
The user-defined value specified in the line description is used.
- user-defined
Specify a value ranging from 0 through 255.
Top |
User-defined 3 (USRDFN)
This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.
- *LIND
The user-defined value specified in the line description is used.
- user-defined
Specify a value ranging from 0 through 255.
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)
Specifies the names of the devices that are attached to this controller. The device descriptions must already exist.
Up to 254 devices can be attached to this controller.
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 |
SSCP identifier (SSCPID)
Specifies the system service control point identifier of the host system.
- system-service-control-point-identifier
Specify the system service control point identifier as a 12-digit hexadecimal value.
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 |
Disconnect timer (DSCTMR)
Specifies options for controlling the time (in seconds) before a connection without activity is dropped, or the amount of time to delay the automatic disconnection. If the user does not want the line to drop, specify *NO for the SWTDSC parameter.
Element 1: Minimum Connect Timer
- 170
A connection is dropped when it has been inactive for 170 seconds.
- disconnect-timer
Specify a time to wait before disconnecting. Valid values range from 0 through 65535 seconds.
Element 2: Disconnect Delay Timer
- 30
The disconnection is delayed for 30 seconds.
- disconnect-delay-timer
Specify a value to delay link take down after the last session on the controller is stopped. Valid values range from 0 through 65535 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
Example: Creating an APPC controller with link type *HRPIP
CRTCTLAPPC CTLD(GRIFFIN) LINKTYPE(*HPRIP) RMTINTNETA('9.5.5.1') RMTCPNAME(CJP)
This command configures an APPC controller description named GRIFFIN with a link type of *HPRIP, a remote internet address of 9.5.5.1 and a remote control point of CJP.
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 |