Before configuring a connection, you must configure the server and link service that the connection will use. For more information, see "Task Order" earlier in this chapter.
- /server:servername
- Specifies the server to which to assign or move the connection. When /add is used, this option is required. The server name should be in the format machine_name or \\machine_name\snaservr (for specifying the primary node on the machine) and \\machine_name\snasrv02 (or snasrv03, snasrv04, etc.) for specifying the secondary nodes on the machine.
- /conntype: { 802.2 | sdlc | x25 | dft }
- Specifies the connection type. When /add is used, this option is required.
- /comment:"text"
- Adds an optional comment for the specified connection. The comment can contain as many as 25 characters; enclose the comment in quotes.
- /linkservice:linkname
- Specifies the name of the link service to be used by connectionname. The link service type must match the connection type (802.2, SDLC, X.25, or DFT), or the snacfg command will not run.
In order for the link service to function correctly, it must be installed with SNA Server Manager. Link services can also be installed with snacfg link; however, SNA Server Manager is the recommended interface for installing link services, because it helps ensure that the resulting configuration is functional.
- /activation: { onserverstartup | ondemand | byadministrator }
- For outgoing calls on connectionname, tells how the connection will be activated: on server startup, on demand, or by the administrator. (For incoming calls, activation is irrelevant, because the connection always begins listening for calls on server startup.)
If no value has been specified for /activation, the default for 802.2 (token ring or Ethernet) and DFT connections is onserverstartup. For all other connections, the default is on demand.
- /localblockno:hexdigits
- Specifies the local block number, a three-digit hexadecimal number. The local block number forms the first part of the Local Node ID, an eight-digit hexadecimal number that identifies the local system.
Do not use 000 or FFF for the local block number. These values are reserved.
For connections to host systems, the local block number should match IDBLK in VTAM.
- /localnodeno:hexdigits
- Specifies the local node number, a five-digit hexadecimal number. The local node number forms the last part of the Local Node ID, an eight-digit hexadecimal number that identifies the local system.
For connections to host systems, the local node number should match IDNUM in VTAM.
- /cpname:"text"
- Specifies the control point name of the remote node, as it is represented in Format 3 XIDs. The name can be from one through eight characters long, and can contain alphanumeric characters and the special characters $, #, and @.
The control point name of the remote node works together with netname. If either of these parameters is supplied, the other should also be supplied.
When connecting to a host system and using a remote control point name, the name should match the SSCPNAME parameter in the VTAM Start command for the remote SSCP (the VTAM system).
- /netname:"text"
- Specifies the name of the network for the remote node, as it is represented in Format 3 XIDs. The name can be from one through eight characters long, and can contain alphanumeric characters and the special characters $, #, and @.
The netname parameter works together with the control point name of the remote node. If either of these parameters is supplied, the other should also be supplied.
- /remoteblockno:hexdigits
- Specifies the remote block number, a three-digit hexadecimal number. The remote block number forms the first part of the Remote Node ID, an eight-digit hexadecimal number that identifies the remote system.
Do not use 000 or FFF for the remote block number. These values are reserved.
- /remoteend: { host | peer | downstream | pupassthrough }
- Specifies whether the connection is to be a host, peer, or passthrough connection.
- /remotenodeno:hexdigits
- Specifies the remote node number, a five-digit hexadecimal number. The remote node number forms the last part of the Remote Node ID, an eight-digit hexadecimal number that identifies the remote system.
- /xidtype: { format0 | format3 }
- Specifies the XID type, the type of identifying information for SNA Server to send. The choices are format0 (Format 0) and format3 (Format 3). Format 0 sends only the Node ID. Format 3 sends up to 100 bytes of identifying information, including the local node ID and control point name. For a DFT connection, the xidtype option is ignored by SNA Server.
If no XID type has been specified, the default is format3.
- /calldirection: { Incoming | Outgoing | Both }
- This option specifies the call direction.
- /channeladdress:hex string
- Specifies the channel sub address for channel attach connections. hex string is a two-digit hexadecimal number, valid range 00..FF.
- /localsap:hexnum
- Specifies the local System Access Point (SAP). Enter a hexadecimal number between 04 and EC that is a multiple of 4. For example, snacfg connection thisconn /localsap:7C.
- /localcpname:"text"
- The Local Control Point Name works with the Network Name to identify a system. The maximum length is eight characters.
- /localnetname:"text"
- The Local Network Name works with the Local Control Point Name to identify a system. The maximum length is eight characters.
- /compression: { none | RLE | LZ9 }
- These options offer progressively better compression, but at a progressively higher CPU usage cost.
- /passthruconn:"text"
- Specifies the name of the PU Passthrough connection.
- /peerdlcrole: {primary | secondary | negotiable}
- Specifies the role used in peer-to-peer communications.
- /remotenetaddr:hexdigits
- Specifies the 12-digit hexadecimal network address of the remote host to which this connection provides access.
If no remote network address has been specified, the default is 400000000000.
- /remotesapaddr:hexdigits
- Specifies the remote SAP address, which is a two-digit hexadecimal number, a multiple of 4, between 04 and EC. A value of 04 is recommended for most installations.
If no remote SAP address has been specified, the default is 04.
- /maxbtulen:value
- Specifies the maximum length for the BTU, which is the number of bytes that can be transmitted in a single data-link control frame.
The range is from 265 through 16393. If no maximum BTU length has been specified, the default is 1929.
-
- /receiveackthresh:value
- Specifies the receive ACK threshold, the maximum number of frames that the local system can receive from the remote system before sending a response.
The range is from 1 through 127. If no receive ACK threshold has been specified, the default is 2.
- /naksendlimit:value
- Specifies the unacknowledged send limit, the maximum number of frames that the local system can send without receiving a response from the remote system.
The range is from 1 through 127. If no unacknowledged send limit has been specified, the default is 1.
- /retrylimit:value
- Specifies the retry limit, the number of times that the local system should retransmit a frame if no response is received from the remote system.
The range is from 0 through 255. A value of 0 means the system uses its internal default retry limit. If no retry limit has been specified, the default is 10.
- /xidretries:value
- Specifies the XID retries, the number of times that the local system should retransmit an XID (an identifying message) if no response is received from the remote system.
The range is from 0 through 30. If no XID retries value has been specified, the default is 3.
- /t1timeout: { Default | 200ms | 400ms | 600ms | 800ms | 1s | 2s | 3s | 5s}
- Specifies the amount of time that the local system should wait for the remote system to respond to a transmission before the local system tries again.
The values used for Default for t1timeout are 400 milliseconds for a local ring and 2 seconds for a remote ring.
- /t2timeout: { Default | 40ms | 80ms | 120ms | 160ms | 200ms | 400ms | 800ms
| 1200ms | 1600ms | 2000ms }
- Select the maximum amount of time that should be allowed before the local system sends an acknowledgment of a received transmission.
The values used for Default for t2timeout are 80 milliseconds for a local ring and 800 milliseconds for a remote ring.
- /titimeout: { Default | 1s | 2s | 3s | 4s | 5s | 10s | 15s | 20s | 25s }
- Select the amount of time that the link can be inactive before the local system treats it as nonfunctioning and shuts it down.
The values used for Default for titimeout are 5 seconds for a local ring and 25 seconds for a remote ring.
- /activatedelay: { Default | 5s | 10s | 15s | 20s | 25s | 30s | 35s | 40s | 45s | 50s | 55s | 60s | 65s | 70s | 75s | 80s | 85s | 90s | 95s | 100s | 105s | 110s | 115s | 120s | 125s | 130s | 135s | 140s | 145s | 150s | 155s | 160s | 165s | 170s | 175s | 180s | 185s | 190s | 195s | 200s | 205s | 210s | 215s | 220s | 225s | 230s | 235s | 240s | 245s | 250s | 255s }
- This value specifies the delay between successive attempts to activate an SNA Server connection.
- /activateretrylimit: { None | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50 | 55 | 60 | 65 | 70 | 75 | 80 | 85 | 90 | 95 | 100 | 105 | 110 | 115 | 120 | 125 | 130 | 135 | 140 | 145 | 150 | 155 | 160 | 165 | 170 | 175 | 180 | 185 | 190 | 195 | 200 | 205 | 210 | 215 | 220 | 225 | 230 | 235 | 240 | 245 | 250 | 255 }
- This option specifies the number of times the server will try to activate a connection.
- /dialdata:value
- Specifies the phone number stored for this connection. For a modem that accepts a phone number from SNA Server — that is, a modem attached to an SDLC adapter with a built-in serial (COM) port — the dial data specifies the telephone number for SNA Server to send to the modem. In this case, the number should be in the format expected by the modem. For manually dialed modems, the dial data is displayed in a pop-up message when the connection is started, and can be in any format.
- /encoding: { NRZI | NRZ }
- Specifies the encoding scheme to be used by the modem. The choices are NRZI, nonreturn to zero inverted, and NRZ, nonreturn to zero.
The modem must use the same encoding scheme as the modem at the remote computer. For connections to host systems, the encoding scheme must match the value in the LINE/GROUP definition in VTAM.
If no encoding scheme has been specified, the default is NRZI.
- /duplex: { half | full }
- Specifies the modem duplex setting. The choices are half, for a half-duplex modem, and full, for a full-duplex modem. If you want to use the full-duplex setting, one or more of your adapters must have the constant carrier option set. The constant carrier option is set in SNA Server Manager. The constant carrier option can also be set with snacfg link; however, SNA Server Manager is the recommended interface for setting the constant carrier option and other link service options.
Most SNA Server computers will use the default for duplex, half.
- /datarate: { high | low }
- Specifies the data rate for transmissions between the SNA Server communications adapter and the modem. This rate can only be set for certain kinds of modems and adapters; for specific information, see the adapter and modem documentation.
A data rate of high gives faster transmissions; low gives more reliable transmissions and prevents the transmission errors sometimes caused by poor-quality lines at the high rate.
If no data rate has been specified, the default is high.
- /polladdress:hexdigits
- Specifies the poll address, a two-digit hexadecimal number. For connections to a host, the local poll address should match the VTAM PU definition for the ADDR= parameter.
Do not use 00 or FF for the poll address; these values are reserved. If no poll address has been specified, the default is C1.
- /idletimeout:value
- Specifies, in tenths of a second, the idle time-out. The idle time-out is the length of time that the local system should wait for the host to respond to a transmission, before the local system tries again. Too small a time-out can cause connection problems.
The range is from 1 (one-tenth of a second) through 300 (30 seconds). If no idle time-out has been specified, the default is 300 (30 seconds).
- /idleretrylimit:value
- Specifies the idle retry limit, the number of times the local system should try to poll or send data to the host if there is no response.
The range is from 1 through 255. If no idle retry limit has been specified, the default is 10.
- /contacttimeout:value
- Specifies the contact time-out: the length of time, in tenths of a second, that the local system should wait between attempts to make a connection with a remote system.
The range is from 5 (five-tenths of a second) through 300 (30 seconds). If no contact time-out has been specified, the default is 300 (30 seconds).
- /contactretrylimit:value
- Specifies contact retry limit, the maximum number of times the local system should attempt to make a given connection.
The range is from 1 through 20. If no contact retry limit has been specified, the default is 10.
- /switchedconntimeout:value
- Specifies the switched connection establishment time-out; used for switched SDLC lines (standard telephone lines) only. The switched connection establishment time-out is the number of seconds that will be allowed for the user or modem to dial the remote computer’s number.
This parameter is ignored by incoming calls.
The range is from 10 through 500 seconds. If no switched connection establishment time-out has been specified, the default is 300.
- /multidropprimconn: { yes | no }
- Specifies whether this connection will be a multidrop primary connection.
A multidrop connection is one in which a primary node communicates with multiple secondary nodes concurrently over the same physical transmission medium.
- /selectstandby: { yes | no }
- Specifies whether the modem’s standby line is set to "on." Standby can only be set for certain kinds of modems; for specific information, see the modem documentation.
If no setting has been specified for standby, the default setting is no.
- /sdlcmaxbtu:value
- Specifies the maximum length for the BTU, which is the number of bytes that can be transmitted in a single data-link information frame.
The range is from 265 through 16393. If no maximum BTU length for SDLC has been specified, the default is 265.
- /activatedelay: { Default | 5s | 10s | 15s | 20s | 25s | 30s | 35s | 40s | 45s | 50s | 55s | 60s | 65s | 70s | 75s | 80s | 85s | 90s | 95s | 100s | 105s | 110s | 115s | 120s | 125s | 130s | 135s | 140s | 145s | 150s | 155s | 160s | 165s | 170s | 175s | 180s | 185s | 190s | 195s | 200s | 205s | 210s | 215s | 220s | 225s | 230s | 235s | 240s | 245s | 250s | 255s }
- This value specifies the delay between successive attempts to activate an SNA Server connection.
- /activateretrylimit: { None | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50 | 55 | 60 | 65 | 70 | 75 | 80 | 85 | 90 | 95 | 100 | 105 | 110 | 115 | 120 | 125 | 130 | 135 | 140 | 145 | 150 | 155 | 160 | 165 | 170 | 175 | 180 | 185 | 190 | 195 | 200 | 205 | 210 | 215 | 220 | 225 | 230 | 235 | 240 | 245 | 250 | 255 }
- This option specifies the number of times the server will try to activate a connection.
- /remotex25addr:hexdigits
- Specifies the remote X.25 address, which identifies the remote system on an X.25 network. The address usually consists of 12 hexadecimal digits, but can contain up to 15 hexadecimal digits.
- /x25maxbtu:value
- Specifies the maximum length for the BTU, which is the number of bytes that can be transmitted in a single data-link information frame.
The range is from 265 through 16393. If no maximum BTU length for X.25 has been specified, the default (for host connections) is 265.
- /virtualcircuit: { perm | switched }
- Specifies the type of virtual circuit used by the connection. The choices are perm and switched. A perm circuit is constantly active and uses a preset destination address. A switched circuit is called and cleared dynamically, and uses a destination address that is supplied when the circuit is called.
If no virtual circuit type has been specified, the default is switched.
- /pvcalias:value(for PVC only)
- Specifies the PVC alias, the number that identifies the PVC channel: 1 for the first channel, 2 for the second, and so on. Used for PVCs only.
The range is from 1 through the number of configured PVC channels. If no PVC alias has been specified, the default is 1.
- /packetsize:value(for PVC only)
- Specifies packet size, the maximum number of data bytes (not header bytes) to be sent in a frame on this X.25 network. Used for PVCs only.
The possible values are 64, 128, 256, 512, and 1024. If no packet size has been specified, the default is 128.
- /windowsize:value(for PVC only)
- Specifies window size, the maximum number of frames that the local system can send without receiving a response from the remote system, on this X.25 network. Used for PVCs only.
The range is from 1 through 7. If no window size has been specified, the default is 2.
- /facilitydata:text(for SVC only)
- Specifies the codes for any facility data required by the network provider or by the administrator of the remote system. Used for SVCs only. Facility data can include as many as 126 hexadecimal characters (63 hexadecimal bytes).
Facility data is a coded string of information often used to request nondefault functions from the X.25 network for a particular SVC connection.
- /userdata:text(for SVC only)
- Specifies the codes for any user data required by the network provider. Used for SVCs only. The user data must be an even number of hexadecimal characters, up to the maximum of 32 characters.
User data is a coded string of information, specifying items such as the communications protocol used by the X.25 network (for SNA, this protocol must be QLLC, specified by C3).
The default for user data is C3; this specifies the QLLC protocol.
- /activatedelay: { Default | 5s | 10s | 15s | 20s | 25s | 30s | 35s | 40s | 45s | 50s | 55s | 60s | 65s | 70s | 75s | 80s | 85s | 90s | 95s | 100s | 105s | 110s | 115s | 120s | 125s | 130s | 135s | 140s | 145s | 150s | 155s | 160s | 165s | 170s | 175s | 180s | 185s | 190s | 195s | 200s | 205s | 210s | 215s | 220s | 225s | 230s | 235s | 240s | 245s | 250s | 255s }
- This value specifies the delay between successive attempts to activate an SNA Server connection.
- /activateretrylimit: { None | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50 | 55 | 60 | 65 | 70 | 75 | 80 | 85 | 90 | 95 | 100 | 105 | 110 | 115 | 120 | 125 | 130 | 135 | 140 | 145 | 150 | 155 | 160 | 165 | 170 | 175 | 180 | 185 | 190 | 195 | 200 | 205 | 210 | 215 | 220 | 225 | 230 | 235 | 240 | 245 | 250 | 255 }
- This option specifies the number of times the server will try to activate a connection.