|
gdlc_sap_corr |
Indicates the generic data link control (GDLC) service access point
(SAP) correlator of the target LS. |
|
gdlc_ls_corr |
Indicates the GDLC LS correlator to be altered. |
|
flags |
Specifies alter flags. The following flags are supported:
- DLC_ALT_RTO
- Alter repoll timeout:
0 = Do not alter repoll timeout.
1 = Alter configuration with value specified.
Alters the length of
time the LS waits for a response before repolling the remote station. When
specified, the repoll timeout value specified in the LS configuration is overridden
by the value supplied in the repoll timeout field of the Alter command. This new value remains in effect until another value is
specified or the LS is halted.
- DLC_ALT_AKT
- Alter acknowledgment timeout:
0 = Do not alter the acknowledgment
timeout.
1 = Alter configuration with value specified.
Alters
the length of time the LS delays the transmission of an acknowledgment for
a received I-frame. When specified, the acknowledgment timeout value specified
in the LS configuration is overridden by the value supplied in the acknowledgment
timeout field of the Alter command. This new value remains
in effect until another value is specified or the LS is halted.
- DLC_ALT_ITO
- Alter inactivity timeout:
0 = Do not alter inactivity timeout.
1 = Alter configuration with value specified.
Alters the maximum
length of time allowed without receive link activity from the remote station.
When specified, the inactivity timeout value specified in the LS configuration
is overridden by the value supplied in the inactivity timeout field of the Alter command. This new value remains in effect until another
value is specified or the LS is halted.
- DLC_ALT_FHT
- Alter force halt timeout:
0 = Do not alter force halt timeout.
1 = Alter configuration with value specified.
Alters the period
to wait for a normal disconnection before forcing the halt LS to occur. When
specified, the force halt timeout value specified in the LS configuration
is overridden by the value supplied in the force halt timeout field of the Alter command. This new value remains in effect until another
value is specified or the LS is halted.
|
|
- DLC_ALT_MIF
- Maximum I-field length:
0 = Do not alter maximum I-field length.
1 = Alter configuration with value specified.
Sets the value
for the maximum length of transmit or receive data in one I-field. If received
data exceeds this length, a buffer overflow indication set by GDLC in the
receive extension. When specified, the maximum I-field length value specified
in the LS configuration is overridden by the value supplied in the maximum
I-field length specified in the Alter command. This
new value remains in effect until another value is specified or the LS is
halted.
- DLC_ALT_XWIN
- Alter transmit window:
0 = Do not alter transmit window.
1 = Alter configuration with value specified.
Alters the maximum number
of information frames that can be sent in one transmit burst. When specified,
the transmit window count value specified in the LS configuration is overridden
by the value supplied in the transmit window field of the Alter command. This new value remains in effect until another value is
specified or the LS is halted.
- DLC_ALT_MXR
- Alter maximum repoll:
0 = Do not alter maximum repoll.
1 = Alter configuration with value specified.
Alters the maximum number
of retries for an acknowledged command frame, or in the case of an I-frame
timeout, the number of times the nonresponding remote LS will be polled with
a supervisory command frame. When specified, the maximum repoll count value
specified in the LS configuration is overridden by the value supplied in the
maximum repoll count field of the Alter command. This
new value remains in effect until another value is specified or the LS is
halted.
- DLC_ALT_RTE
- Alter routing:
0 = Do not alter routing.
1 = Alter configuration
with value specified.
Alters the route that subsequent transmit packets
take when transferring data across a local area network bridge. When specified,
the routing length and routing data values specified in the LS configuration
are overridden by the values supplied in the routing fields of the Alter command. These new values remain in effect until another route
is specified or the LS is halted.
|
|
- DLC_ALT_SM1
- Set primary SDLC Control mode:
0 = Do not alter SDLC Control mode.
1 = Set SDLC Control mode to primary.
Sets the local station
to a primary station in NDM, waiting for a command from PU services to write
an XID or TEST, or a command to contact the secondary for NRM data phase.
This control can only be issued if not already in NRM, and no XID, TEST, or
SNRM is in progress. This flag cannot be set if the DLC_ALT_SM2 flag is set.
- DLC_ALT_SM2
- Set secondary SDLC Control mode:
0 = Do not alter SDLC Control
mode.
1 = Set SDLC Control mode to secondary.
Sets the local
station to a secondary station in NDM, waiting for XID, TEST, or SNRM from
the primary station. This control can only be issued if not already in NRM,
and no XID, TEST, or SNRM is in progress. This flag cannot be set if the DLC_ALT_SM1 flag is set.
- DLC_ALT_IT1
- Set notification for Inactivity Time-Out mode:
0 = Do not alter
Inactivity Time-Out mode.
1 = Set Inactivity Time-Out mode to notification
only.
Inactivity does not cause the LS to be halted, but notifies the
user of inactivity without termination.
- DLC_ALT_IT2
- Set automatic halt for Inactivity Time-Out mode:
0 = Do not alter
Inactivity Time-Out mode.
1 = Set Inactivity Time-Out mode to automatic
halt.
|
|
repoll_time |
Provides a new value to replace the LS repoll time-out value whenever
the DLC_ALT_RTO flag is
set. |
|
ack_time |
Provides a new value to replace the LS acknowledgment time-out value
whenever the DLC_ALT_AKT
flag is set. |
|
inact_time |
Provides a new value to replace the LS inactivity time-out value
whenever the alter DLC_ALT_ITO
flag is set. |
|
force_time |
Provides a new value to replace the LS force halt time-out value
whenever the DLC_ALT_FHT
flag is set. |
|
maxif |
Provides a new value to replace the LS-started result value for the
maximum I-field size whenever the DLC_ALT_MIF flag is set. GDLC does not allow this value to exceed
the capacity of the receive buffer and only increases the internal value to
the allowed maximum. |
|
xmit_wind |
Provides a new value to replace the LS transmit window count value
whenever the DLC_ALT_XWIN
flag is set. |
|
max_repoll |
Provides the new value that is to replace the LS maximum repoll count
value whenever the DLC_ALT_MXR
flag is set. |
|
routing_len |
Provides a new value to replace the LS routing field length whenever
the DLC_ALT_RTE flag is
set. |
|
routing |
Provides a new value to replace the LS routing data whenever the DLC_ALT_RTE flag is set. |
|
result_flags |
Returns the following result indicators at the completion of the
alter operation, depending on the command:
- DLC_MSS_RES
- Indicates mode set secondary. Set to 1, this bit indicates that the
station mode has been set to secondary as a result of the user issuing an Alter (set mode secondary) command.
- DLC_MSSF_RES
- Indicates mode set secondary was unsuccessful. Set to 1, this bit
indicates that the station mode has been not set to secondary as a result
of the user issuing an Alter (set mode secondary) command.
This occurs whenever an SDLC LS is already in data phase or an SDLC primary
command sequence has not yet completed.
- DLC_MSP_RES
- Indicates mode set primary. Set to 1, this bit indicates that the
station mode has been set to primary as a result of the user issuing an Alter (set mode primary) command.
- DLC_MSPF_RES
- Indicates mode set primary was unsuccessful. Set to 1, this bit indicates
that the station mode has not been set to primary as a result of the user
issuing an Alter (set mode primary) command. This occurs
whenever an SDLC LS is already in data phase.
|