 |
» |
|
|
|
DEFINE_DLC defines a new DLC. It can also be used to modify
the DLC-specific parameters of an existing DLC, if the DLC is not
currently active, but other parameters cannot be modified. VCB
Structure | |
typedef struct define_dlc
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char dlc_name[8]; /* name of DLC */
DLC_DEF_DATA def_data; /* DLC defined data */
} DEFINE_DLC;
|
typedef struct dlc_def_data
{
unsigned char description[32]; /* resource description */
unsigned char initially_active; /* is the DLC initially active? */
unsigned char reserv1[15]; /* reserved */
unsigned char dlc_type; /* DLC type */
unsigned char neg_ls_supp; /* negotiable link station support */
unsigned char port_types; /* port types supported by DLC type */
unsigned char reserv3[11]; /* reserved */
AP_UINT16 dlc_spec_data_len; /* Length of DLC specific data */
} DLC_DEF_DATA;
|
DLC-specific data for SDLC: typedef struct sdl_spec_data
{
V0_MUX_INFO mux_info; /* Streams config info */
AP_UINT16 mu_credit; /* amount of credit to allow PC to send*/
unsigned char stats_support; /* activate statistics gathering? */
unsigned char reserve1; /* reserved */
AP_UINT16 sdh_parms_len; /* Length of HMOD stub create_parms */
SDH_CREATE_PARMS sdh_parms; /* HMOD stub create_parms structure */
} SDL_SPEC_DATA;
typedef struct sdh_create_parms
{
AP_UINT16 length; /* Length of HMOD stub create_parms */
AP_UINT16 num_ports; /* max number of ports DLC can support */
AP_UINT32 creators_pid; /* process ID of DLC */
V0_MUX_INFO mux_info; /* reserved */
} SDH_CREATE_PARMS;
|
DLC-specific data for QLLC: typedef struct vql_dlc_spec_data
{
V0_MUX_INFO mux_info; /* streams config info */
} VQL_DLC_SPEC_DATA;
|
DLC-specific data for Token Ring, Ethernet, FDDI: typedef struct vdl_dlc_cfg
{
V0_MUX_INFO mux_info; /* Streams config info */
} VDL_DLC_CFG;
|
For all DLC types: typedef struct v0_mux_info
{
AP_UINT16 dlc_type; /* DLC implementation type */
unsigned char reserve1; /* reserved */
unsigned char num_mux_ids; /* reserved */
AP_UINT32 card_type; /* type of adapter card */
AP_UINT32 adapter_number; /* DLC adapter number */
AP_UINT32 oem_data_length; /* reserved */
int mux_ids[5]; /* reserved */
} V0_MUX_INFO;
|
Supplied
Parameters | |
The application supplies the following parameters: - opcode
AP_DEFINE_DLC - dlc_name
Name of the DLC. This is an 8-byte ASCII string,
using any locally displayable characters, padded on the right with
spaces if the name is shorter than 8 bytes. - def_data.description
A null-terminated text string (0-31 characters followed by
a null character) describing the DLC. This string is for information
only; it is stored in the node's configuration file and returned
on the QUERY_DLC verb, but SNAplus2 does not make any other use
of it. - def_data.initially_active
Specifies whether this DLC is automatically started when
the node is started. Possible values are: - AP_YES
The DLC is automatically started when the node is
started. - AP_NO
The DLC is automatically started only if a port
or LS that uses it is defined to be initially active; otherwise
it must be started manually.
- def_data.dlc_type
Type of the DLC. Possible values are: - AP_SDLC
SDLC - AP_X25
QLLC - AP_TR
Token Ring - AP_ETHERNET
Ethernet - AP_FDDI
FDDI
- def_data.neg_ls_supp
Specifies whether the DLC supports negotiable link stations.
If dlc_type is set to AP_QLLC, this must
be set to AP_YES. Possible values are: - AP_YES
Link stations using this DLC may be negotiable. - AP_NO
Link stations using this DLC must be defined as
either primary or secondary; negotiable link stations are not supported.
- def_data.port_types
If dlc_type is set to AP_ETHERNET/AP_FDDI,
set this parameter to AP_PORT_SATF. For
all other DLC types, this parameter is reserved. - def_data.dlc_spec_data_len
Length, in bytes, of data specific to the type of
the DLC. The DLC-specific data structures should be included at the
end of the basic VCB structure.
DLC-specific data for SDLC: - sdl_spec_data.mux_info.dlc_type
Type of the DLC. Set this to AP_IMPL_SDLC_SL - sdl_spec_data.mux_info.card_type
Type of the adapter card. Possible values are: - AP_CARD_HP_PSI
Single-port PSI card - AP_CARD_HP_ACC
8-port ACC card - AP_CARD_HP_EICON_PCI_SDLC
2-port Eicon PCI card
- sdl_spec_data.mux_info.adapter_number
Adapter number used by the DLC. If the server contains
more than one SDLC adapter card, specify 0 (zero)
for the first card, 1 for the second card,
and so on. Otherwise, set this parameter to 0 (zero). - sdl_spec_data.mu_credit
Specifies the credit value for sending DLC_MUs to
the link component. Set this parameter to 4. - sdl_spec_data.stats_support
Specifies whether the DLC collects link statistics information.
Possible values are: - AP_YES
The DLC collects link statistics information, which
can be examined using QUERY_STATISTICS. - AP_NO
The DLC does not collect link statistics information.
- sdl_spec_data.sdh_parms_len
Length, in bytes, of the sdh_parms structure. Set this to sizeof(SDH_CREATE_PARMS). - sdl_spec_data.sdh_parms.length
Length, in bytes, of the sdh_parms structure. Set this to sizeof(SDH_CREATE_PARMS). - sdl_spec_data.sdh_parms.num_ports
The maximum number of ports that this DLC will need to
support at a time. - sdl_spec_data.sdh_parms.creators_pid
This parameter is reserved (set it to zero).
DLC-specific data for QLLC: - vql_dlc_spec_data.mux_info.dlc_type
Type of the DLC. Set this to AP_IMPL_NLI_QLLC. - vql_dlc_spec_data.mux_info.card_type
Type of the adapter card. Set this to AP_CARD_QLLC_NLI.
DLC-specific data for Token Ring, Ethernet, FDDI: - vdl_dlc_cfg.mux_info.dlc_type
Type of the DLC. Possible values are: - AP_IMPL_TR_DLPI
Token Ring - AP_IMPL_ETHER_DLPI
Ethernet - AP_IMPL_FDDI_DLPI
FDDI
- vdl_dlc_cfg.mux_info.card_type
Type of the adapter card. Possible values are: - AP_CARD_TOKEN_RING_DLPI
Token Ring - AP_CARD_ETHERNET_DLPI
Ethernet - AP_CARD_FDDI_DLPI
FDDI
- vdl_dlc_cfg.mux_info.adapter_number
Adapter number used by the DLC. If the server contains
more than one adapter card for this DLC type, specify 0 for
the first card, 1 for the second card,
and so on. Otherwise, set this parameter to 0 (zero).
Returned
Parameters: Successful Execution | |
If the verb executes successfully, SNAplus2 returns the following parameters: Returned
Parameters: Parameter Check | |
If the verb does not execute because of a parameter error,
SNAplus2 returns the following parameters: - primary_rc
AP_PARAMETER_CHECK - secondary_rc
Possible values are: - AP_INVALID_DLC_NAME
The supplied dlc_name parameter contained a character that was not valid. - AP_INVALID_DLC_TYPE
The supplied dlc_type parameter was not one of the allowed values.
Appendix A “Common
Return Codes” lists further
secondary return codes associated with AP_PARAMETER_CHECK,
which are common to all NOF verbs. Returned
Parameters: State Check | |
If the verb does not execute because of a state error, SNAplus2
returns the following parameters. - primary_rc
AP_STATE_CHECK - secondary_rc
- AP_DLC_ACTIVE
The specified DLC cannot be modified because it
is currently active.
Appendix A “Common
Return Codes” lists further
secondary return codes associated with AP_STATE_CHECK,
which are common to all NOF verbs. Returned
Parameters: Other Conditions | |
Appendix A “Common
Return Codes” lists further
combinations of primary and secondary return codes that are common
to all NOF verbs. |
Printable version
