CRTCTLHOST (Create Controller Description (SNA Host)) Command Description

CRTCTLHOST Command syntax diagram

 

Purpose

The Create Controller Description (SNA Host) (CRTCTLHOST) command creates a controller description for an SNA host system. More information about using this command is in the Communications Configuration book.

 

Required Parameters

CTLD

Specifies the name of the controller description being created.

LINKTYPE

Specifies the type of line to which this controller is attached.

*DLUR: This controller is used for Dependent LU Requestor (DLUR) functions and has no line attached.

*FR: This controller is attached to a frame relay line.

*IDLC: This controller is attached to an ISDN data link control (IDLC) line.

*LAN: This controller is attached to a DDI, Ethernet, or token-ring local area network (LAN) line.

*SDLC: This controller is attached to a synchronous data link control (SDLC) line.

*X25: This controller is attached to an X.25 line.

 

Optional Parameters

ONLINE

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

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

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

SWITCHED

Specifies whether this controller is attached to a switched line, an X.25 switched virtual circuit (SVC), or a TRLAN line. *NO must be specified for APPC controllers attached to a TDLC line.

*NO: This controller is attached to a nonswitched line or an X.25 permanent virtual circuit (PVC).

*YES: This controller is attached to a switched line or an X.25 switched virtual circuit (SVC).

SHM

Specifies whether this controller is for X.21 short-hold mode. If *YES is specified on this parameter, LINKTYPE(*SDLC) and SWITCHED(*YES) must also be specified.

*NO: This controller is not used for X.21 short-hold mode.

*YES: This controller is used for X.21 short-hold mode.

SNBU

Specifies, for controllers supporting the switched network backup (SNBU) feature, whether the SNBU feature is activated or deactivated. Both the local and remote modems must support the SNBU feature to perform a valid activation.

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

*YES: The remote modem has the SNBU feature.

APPN

Specifies whether the local system uses advanced peer-to-peer networking (APPN) functions when communicating with this controller. If APPN functions are used, the user must specify a remote control point name and a remote network identifier.

*YES: The local system uses APPN functions.

*NO: The local system does not use APPN functions.

LINE

Specifies the name of the nonswitched lines to which this controller is attached. The line description must already exist.

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.

DEV

Specifies the names of the devices attached to this controller. Use this parameter only when the associated device descriptions have already been created. The maximum number of devices that can attach to this controller is 254.

CODE

Specifies the character code used. The code can be either extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII).

*EBCDIC: The extended binary-coded decimal interchange code (EBCDIC) character set code is used.

*ASCII: The ASCII character set code is used.

MAXFRAME

Specifies the maximum frame (path information unit (PIU)) size that the controller can send or receive. This value is used to calculate 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:

    *SDLC-521     *LAN-16393    *FR-1590
    *IDLC-2048    *X25-1024

maximum-frame: Specify the maximum 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 link type are shown below.

Link Type

Frame Size (in bytes)

 

 

*FR

265 - 8182

*LAN

265 - 16393 (265 - 4444 for DDI LANs)

*IDLC

265 - 8196

*SDLC

265,521,1033,2057

*X25

256,265,512,521,1024,1033,2048,4096

RMTNETID

Specifies the name of the remote network.

*NETATR: The RMTNETID 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-ID: Specify the remote network identifier.

RMTCPNAME

Specifies the name of the remote control point.

*ANY: The system determines the name of the remote control point to use.

remote-control-point-name: Specify the remote control point name.

ADJLNKSTN

Specifies the name of the adjacent link station. This name is used by the system to identify which switched controller description on the iSeries 400 is used to establish a link to a host S/370 system. The adjacent link station name for the iSeries 400 must match the name provided by the host system during link activation.

*NONE: No adjacent link station name is specified.

*ANY: The system determines which adjacent link station is used.

adjacent-link-station-name: Specify the adjacent link station name.

LCLEXCHID

Specifies the number used to identify the local system to the remote system.

Note:

This parameter is necessary only if parallel connections are required between an iSeries 400 and an SNA host system.

*LIND: The iSeries 400 system uses the exchange identifier specified in the line description on the EXCHID parameter associated with this controller description.

local-exchange-identifier: Specify a local exchange identifier. The first three digits of this 8-digit hexadecimal number identify the block number and the remaining five digits identify the system.

SSCPID

Specifies the system service control point (SSCP) of the host system.

Note:

The system service control point identifier (SSCPID) is a 12-digit hexadecimal value; the first 2 digits are hexadecimal 05. This parameter is required for SDLC switched and SNBU if APPN(*YES) and NODETYPE(*LENNODE) are specified, or if APPN(*NO) is specified but RMTCPNAME is not specified. This parameter must be specified if SHM(*YES) is also specified.

INLCNN

Specifies the method used to establish a connection with this controller.

*DIAL: The connection is made by a call initiated from the iSeries 400.

For X.25 connection, 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.

*ANS: The connection is made by the local system answering an incoming call from this controller.

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 immediately upon vary on of the controller description. For all other link types, the default is to delay the dial.

*IMMED: The dial connection is initiated immediately upon vary on of the controller description.

*DELAY: The dial connection is delayed until a job is initiated that requests the use of the remote controller resources.

CNNNBR

Specifies the telephone number to dial to connect to this controller.

*DC: For X.21 circuit switched connections, a direct call is used to connect to the controller.

*ANY: Calls are accepted from any network address.

connection-number: Specify the connection number used to call this controller. This could be a telephone number, an X.25 network address, or an X.21 connection number, depending on the type of controller and the type of line to which it is attached.

ANSNBR

Specifies the X.25 network address from which to accept calls.

*CNNNBR: Calls from the X.25 network address specified by the connection number (CNNNBR) parameter are accepted.

*ANY: Calls are accepted from any X.25 network address.

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.

CNNLSTOUTE

Specifies the entry name from the connection list that is used to make a call to the ISDN. The connection list must be specified on the CNNLSTOUT parameter.

IDLCWDWSIZ

Specifies the window size for transmission to and reception from the remote controllers.

*LIND: The window size specified in the line description is used.

window-size: Specify the window size. Valid values range from 1 through 31.

IDLCFRMRTY

Specifies the maximum number of attempts to transmit before an error is reported.

*LIND: The number of attempts specified in the line description is used.

IDLC-frame-retry: Specify the number of attempts. Valid values range from 0 through 100.

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 to wait before retransmitting an unacknowledged frame of data. Valid values range from 10 through 100 tenths of a second. For example, 10 seconds equals 100 tenths of a second.

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: There is no disconnect limit.

IDLC-connect-retry: Specify the number of attempts. Valid values range from 1 through 100.

PREDIALDLY

Specifies how long to wait (in 0.5 second intervals) before dialing.

6: The value of 6 provides a 3-second delay.

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

REDIALDLY

Specifies how long 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 ranging from 1 through 254 in 0.5-second intervals, or specify 0 to indicate no delay.

DIALRTY

Specifies the number of re-dial attempts made by the system before considering the dialing unsuccessful.

2: The LZ algorithm with the 12-bit code for repeated substrings in the data stream is used. These codes refer to entries in a common dictionary, created as the data flows between the sender and receiver. The LZ algorithms require storage and extra processing time. The LZ12 requires the most storage and processing time of the LZ algorithms; however, it compresses the data stream the most.

dial-retry: Specify a value ranging from 0 through 254 for the number of dial attempts.

SWTDSC

Specifies whether the switched connection to this controller is disconnected when the last device in the host controller description becomes inactive.

*NO: Specify *NO to keep this connection active even if the above conditions were met, or if the host system is configured to bring down the switched connection.

*YES: The switched connection is disconnected when the last device is varied off.

DSCTMR

Specifies options for controlling the time (in seconds) before an inactive connection is dropped (Element 1), or the amount of time to delay the automatic disconnection (Element 2).

Note:

The DISCNT parameter of the GROUP macro instruction in the NCP/VTAM definition can be used if the host system is to determine the disconnect characteristics.

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 terminated. Valid values range from 0 through 65535 seconds.

Note:

For objects migrated from V2R1M1 or previous systems, the disconnect delay timer has a value of zero. This value is interpreted by the system as 30 seconds.

STNADR

Specifies the station address used when communicating with the controller.

Note:

This is the station address of the local system. Valid values range from 01 through FE.

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.

DSAP

Specifies the logical address of the SNA destination service access point (DSAP) to which this system sends data when it communicates with the remote controller. This address allows the controller and the system to route the data that comes from this system. The value must match the value specified on the source service access point (SSAP) parameter in the remote controller's configuration record.

04: The destination service access point is 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.

SSAP

Specifies the source service access point. This is the logical address this system uses when it sends data to the remote controller. This address allows the remote controller and the system to route the data that comes from this system. It must match the value assigned to the destination service access point (DSAP) prompt in the remote controller's configuration record.

04: The source service access point is 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.

LANFRMRTY

Specifies the number of times a frame is transmitted if there is no acknowledgement from the remote controller in the time period specified on the LANRSPTMR parameter. This value is used only after a successful connection has been made.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

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.

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 calculates the value based on the type of line that is linked to the controller.

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.

LANRSPTMR

Specifies the length of time the system waits before an inoperative condition occurs on a link after a connection is made.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-response-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.

LANCNNTMR

Specifies the length of time the system waits before an inoperative condition occurs on a link at connection time.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

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.

LANACKTMR

Specifies the length of time the system waits before sending an acknowledgement for received frames.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-acknowledgement-timer: Specify a value ranging from 1 through 254 in 0.1-second intervals, or specify 0 to indicate no delay. If 0 is specified for this parameter, 0 must also be specified for the LANACKFRQ parameter; if a non zero value is specified for this parameter, a non zero value must also be specified for the LANACKFRQ parameter.

LANINACTMR

Specifies the length of time in which to determine an inactive condition for the controller.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

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.

LANACKFRQ

Specifies the maximum number of frames that are received before an acknowledgement is sent to the controller.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-acknowledgement-frequency: Specify a value ranging from 0 through 127 for the number of frames received. If 0 is specified for this parameter, 0 must also be specified for the LANACKTMR parameter; if a non zero value is specified for this parameter, a non zero value must also be specified for the LANACKTMR parameter.

LANMAXOUT

Specifies the maximum number of frames that can be sent before an acknowledgement is received from the remote system.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

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.

LANACCPTY

Specifies the priority granted to the sending system for sending frames. The larger the number, the higher the priority.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-access-priority: Specify a value ranging from 0 through 3 to indicate how soon a frame can be sent on a local area network (LAN).

LANWDWSTP

Specifies whether to reduce the number of outstanding frames that can be sent before an acknowledgement is received from the remote system during network congestion. This parameter (LAN Window Step) also indicates the number of frames that must be successfully received before the number of outstanding frames can be incremented to the maximum allowable value.

*NONE: The number of outstanding frames is not reduced during network congestion.

LAN-number-of-frames: Specify the number of outstanding frames to be reduced before an acknowledgement is received from the remote system.

NETLVL

Specifies the level of the X.25 network used to reach this controller. The level is specified by giving the year of the standard used by the X.25 network.

1980: The 1980 standard is used.

1984: The 1984 standard is used.

1988: The 1988 standard is used.

LINKPCL

Specifies the link level protocol used on the X.25 network to communicate with this controller.

*QLLC: The QLLC protocol is used.

*ELLC: The ELLC protocol is used.

LGLCHLID

Specifies the logical channel ID used for the X.25 PVC to this controller. Specify the logical channel ID. The valid entry is xyy. Where:

x =  the logical group number derived
      from user network subscription
yy = the logical channel number,
      derived from user subscription

CNNPWD

Specifies, for X.25 switched virtual circuit (SVC) controllers, the password used when connecting to this controller.

SWTLINSLCT

Specifies the method that is used to select lines from an X.25 switched line list.

*FIRST: The lines are selected in the order in which they are specified.

*CALC: The system determines the value to use.

DFTPKTSIZE

Specifies the default packet size used by the X.25 network.

Element 1: Transmit Packet Size

*LIND: The value specified in the line description is used as the default packet size.

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 used as the default packet size.

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

DFTWDWSIZE

Specifies the default window size used by the X.25 network.

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. Valid values range from 1 through 7 for networks that use modulus 8 packet numbering. Valid values range from 1 through 15 for networks that use 128 packet numbering.

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. Valid values range from 1 through 7 for networks that use modulus 8 packet numbering. Valid values range from 1 through 15 for networks that use 128 packet numbering.

USRGRPID

Specifies the closed user-group ID for contacting this X.25 switched virtual circuit (SVC) controller. Specify a value ranging from 0 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.

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.

X25FRMRTY

Specifies the maximum number of times that a link protocol data unit (LPDU) is sent after the response timer ends when connected to this controller.

7: Rotation of the text is done 270 degrees clockwise from the 0 degree writing position.

X.25-frame-retry: Specify a value ranging from 0 through 21 for the number of times a frame is sent.

X25RSPTMR

Specifies the time allowed to return an acknowledgement when a link protocol data unit (LPDU) is sent while connected to this controller.

300: The time allowed for acknowledgement is 30 seconds.

X.25-response-timer: Specify a value ranging from 1 through 2550 in 0.1-second intervals.

X25ACKTMR

Specifies the time period to delay sending acknowledgements for received LPDU.

20: Two seconds are allowed for acknowledgement.

X.25-acknowledgement-timer: Specify a value ranging from 1 through 2550 in 0.1-second intervals, or specify 0 to indicate no delay.

X25INACTMR

Specifies the time period in which to determine an inactive condition for the controller.

1050: An inactive condition is detected after 105 seconds.

X.25-inactivity-timer: Specify a value ranging from 1 through 2550 in 0.1-second intervals.

USRFCL

Specifies a string of hexadecimal digits sent to the X.25 network to request additional services. The iSeries 400 allows up to 218 hexadecimal characters.

CPSSN

Specifies whether this controller supports control-point to control-point (CP to CP) sessions.

*YES: This controller supports CP to CP sessions.

*NO: This controller does not support CP to CP sessions.

NODETYPE

Specifies the type of APPN node 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 value to use.

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.

HPR

Specifies whether the local system can use APPN high-performance routing (HPR) when communicating with this controller. The controller description must specify APPN(*YES) to enable HPR. If HPR(*YES) is specified, the value of the MAXFRAME parameter of the line specified by the switched line list must be greater than or equal to 768, otherwise HPR will not be enabled over this connection. See the APPC, APPN, and HPR topic in the Information Center for more information.

*YES: The local system can use HPR, and HPR flows can proceed over the link defined by this controller.

*NO: The local system cannot use HPR, and HPR flows cannot proceed over the link defined by this controller.

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 APPC, APPN, and HPR topic in the Information Center 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.

TMSGRPNBR

Specifies the APPN transmission group number for this controller.

1: The transmission group number is one.

*CALC: The system determines the value to use.

APPN-transmission-group-number: Specify a value ranging from 1 through 20 for the transmission group number.

MINSWTSTS

Specifies, for the switched connection, the minimum status that APPN requires for a controller to be considered available for routing.

*VRYONPND: APPN considers the controller available for routing if the status is vary on pending, varied on, or active.

*VRYON: Indicates that APPN considers the controller available for routing only if the status is varied on or active.

AUTOCRTDEV

Specifies which devices are automatically created.

*ALL: All devices that can be automatically created for this controller, except APPC devices are automatically created.

*DEVINIT: Only session printer and display devices started by the SNA host controller (device-initiated) are automatically created.

*NONE: No devices are automatically created.

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.

1440: The system will automatically vary off and delete the automatically-configured idle device descriptions after 1440 minutes (24 hours).

*NO: The system will not automatically vary off and delete the automatically-configured idle device descriptions.

wait-time: Specify the number of minutes to wait before deleting the automatically-configured idle device descriptions for this controller. Valid values range from 1 to 10000.

USRDFN1

Specifies the first of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.

*LIND: The user-defined value specified in the line description is used.

user-defined-1: Specify a value ranging from 0 through 255.

USRDFN2

Specifies the second of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.

*LIND: The user-defined value specified in the line description is used.

user-defined-2: Specify a value ranging from 0 through 255.

USRDFN3

Specifies the third of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.

*LIND: The user-defined value specified in the line description is used.

user-defined-3: Specify a value ranging from 0 through 255.

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 Value

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

PRIDLUS

Specifies the primary Dependent LU Server (DLUS) name and network ID.

The name is in the format of XXXXXXXX YYYYYYYY the prefix being the CP name and the suffix being the Network ID of the APPN network (subnet) that the remote DLUS resides in. The end user can define only the CP name of a DLUS residing in the same network as the iSeries 400. The default is the local network ID specified in the network attributes.

The network qualified CP name of the remote DLUS system services control point (SSCP) that the iSeries 400 DLUR host controller prefers to communicate with. If this parameter is filled in and the iSeries 400 DLUR controller is configured as Initial Connection *dial, the iSeries 400 sends an activation request to this DLUS first.

The default is *NONE, but if Initial Connection is *DIAL INLCNN(*DIAL), then this parameter becomes a required parameter.

*NONE: There is no primary dependent LU server.

Element 1: Primary DLUS name

primary-DLUS-name: Specify the name of the primary dependent LU server.

Element 2: Network ID

*NETATR: The network ID from the local network attributes is used.

network-ID: Specify the network ID of the dependent LU server.

BKUDLUS

Specifies the backup Dependent LU Server (DLUS) name and network ID.

The name should be in the format of XXXXXXXX YYYYYYYY the prefix being the CP name and the suffix being the Network ID of the APPN network (subnet) that the remote DLUS resides in. The end user can define only the CP name of a DLUS residing in the same network as the iSeries 400. The default is the local network ID specified in the network attributes.

The network qualified CP name of the remote DLUS (SSCP) the iSeries 400 Dependent LU Requestor (DLUR) host controller will communicate with in the absence of the primary DLUS node. If this parameter is filled in and the iSeries 400 DLUR controller is configured as INLCNN(*DIAL), the iSeries 400 sends an activation request to this DLUS only after trying the primary DLUS first.

*NONE: There is no backup dependent LU server.

Element 1: Backup DLUS name

backup-DLUS-name: Specify the name of the backup dependent LU server.

Element 2: Network ID

*NETATR: The network ID from the local network attributes is used.

network-ID: Specify the network ID of the backup dependent LU server.

DEPPUNAME

Specifies the dependent location name used for DLUR, providing additional security for the connection.

If this name is filled in, an activation request (SNA ACTPU) from a DLUS node must reference this name or it will be rejected.

When the iSeries 400 DLUR node initiates a session with the remote DLUS node (INLCNN(*DIAL)), the PU name will be sent to the DLUS and it will return that name on ACTPU.

If the remote DLUS node initiates a session to the iSeries 400 DLUR host controller via activation of pre-defined definitions on the DLUS node, there will have to be close coordination of the PU Name definitions on both systems.

If this parameter is not filled in, then checking is done on the local exchange ID and remote CP name parameters of the controller.

*NONE: No location name is defined.

'dependent-location-name': Specify the dependent location name used for DLUR applications.

ACTTMR

This timer is used when the iSeries 400 attempts to activate a session to the remote DLUS node (initial connection *dial). It is the amount of time the system will wait for an answer from the remote DLUS.

This parameter is used in conjunction with recovery limits count and timer interval. For each count, an activation request (timed by the activation timer) is requested. Between attempts, the system waits for the timer interval before a new activation is attempted (assuming the system times out before hearing back or receiving a Retry error message).

The three parameters on the attempts to the primary DLUS are used and, once the count limit is exceeded, the system resets and tries the same retry limit count to the backup DLUS (if configured). Once the retry limit count is exhausted to all configured DLUS nodes, an error message is issued to the QSYSOPR message log with options to retry the whole activation sequence again.

170: The activate time of 170 seconds is used.

activation-timer: Specify, in seconds, a value ranging from 30 through 2550.

RECNNTMR

This timer is used when a session outage occurs to the remote DLUS node. It is the amount of time the iSeries 400 DLUR support waits for the DLUS node to send an activation request back to the iSeries 400. Once the timer expires, the iSeries 400 does the following:

If the iSeries 400 DLUR host controller is configured to INLCNN(*DIAL):

1. The DLUR support makes a one time attempt to activate a session to the DLUS node the system was connected to at the time of session outage.
2. If that attempt fails, an error message is displayed in the QSYSOPR message log with retry option. If retry is taken, then the activation request is sent through the configured primary/backup DLUS again.

If the iSeries 400 DLUR host controller is configured to INLCNN(*ANS):

1. The DLUR controller waits for an activation attempt from any DLUS node.

170: The default value of 170 is used.

reconnect-timer: Specify, in seconds, a value ranging from 1 through 2550.

AUT

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

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

*EXCLUDE: The user cannot access the controller description.

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

RECONTACT

Specifies whether to send a re-contact request to a remote system when the system is varied off.

Note:

This parameter is valid only for X.25 and SDLC leased lines (if *X25 or *SDLC is specified on the LINKTYPE parameter and *NO is specified on the SWITCHED parameter).

*YES: A request for re-contact with the remote system is sent. When this value is specified, a status of pending is shown for the remote system.

*NO: A request for re-contact with the remote system is not sent. When this value is specified, a status of inactive is shown for the remote system.

MSGQ

Specifies the qualified name of the message queue to which messages are sent. More information about using this parameter is in the Communications Management book.

Single Values

*SYSVAL: Messages are sent to the message queue defined in the system value QCFGMSGQ.

*SYSOPR: Messages are sent to the system operator message queue (QSYS/QSYSOPR).

library-name/message-queue-name: Specify the library-qualified name of the message queue to which operational messages are sent.

TEXT

Specifies the text that briefly describes the program and its function. 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 CRTCTLHOST

CRTCTLHOST   CTLD(HOST1)  LINKTYPE(*LAN)
  SWTLINLST(LAN1)  RMTCPNAME(CPX)
  ADPTADR(056000000011)

This command creates a host controller on a local area network.

Error messages for CRTCTLHOST

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