The following parameter block alters a link station's (LS) configuration parameters:
#define DLC_MAX_ROUT 20 /* Maximum Size of Routing Info */
struct dlc_alter_arg { ulong_t gdlc_sap_corr; /* GDLC SAP correlator */ ulong_t gdlc_ls_corr; /* GDLC link station correlator */ ulong_t flags; /* Alter Flags */ ulong_t repoll_time; /* New Repoll Timeout */ ulong_t ack_time; /* New Acknowledge Timeout */ ulong_t inact_time; /* New Inactivity Timeout */ ulong_t force_time; /* New Force Timeout */ ulong_t maxif; /* New Maximum I-Frame Size */ ulong_t xmit_wind; /* New Transmit Value */ ulong_t max_repoll; /* New Max Repoll Value */ ulong_t routing_len; /* Routing Length */ u_char_t routing[DLC_MAX_ROUT]; /* New Routing Data */ ulong_t result_flags; /* Returned flags */ };
The fields of this ioctl operation are:
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: |
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: |
The protocol-dependent area allows additional fields to be provided by a specific protocol type. Corresponding flags may be necessary to support additional fields. This optional data area must directly follow (or append to) the end of the dlc_alter_arg structure.
The DLC_ALTER ioctl operation is selectable through the fp_ioctl kernel service or the ioctl subroutine. It can be called from the process environment only.