HP OpenVMS Systems Documentation

Table 9-17 summarizes the use of the set mode parameters for theEthernet, 802, and 802 extended (802E) packet formats.

DEF---Default. If not specified, this is the default parameter for thispacket format.
REQ---Required. This parameter must be specified for this packetformat.
OPT---Optional. This parameter is optional for this packet format; itmay be specified.
E---Error. This parameter cannot be specified for this packet format.If the parameter is specified, it generates an SS$_BADPARAM error.

When starting a LAN port, the LAN driver checks that the mode of thenew port is compatible with the mode of the LAN ports already started.There are two sets of compatibility checks: one for ports running inshared mode and one for all ports.

The following parameters must match for all ports on the samecontroller:

NMA$C_PCLI_CON
NMA$C_PCLI_CRC
NMA$C_PCLI_EKO
NMA$C_PCLI_ILP
NMA$C_PCLI_PHA (need only match for CSMA/CD controllers)

On VAX systems, the following parameters must match for allshared-default and shared-with-destination users of the same protocoltype:

NMA$C_PCLI_BFN
NMA$C_PCLI_BUS
NMA$C_PCLI_CCA
NMA$C_PCLI_MLT
NMA$C_PCLI_PAD
NMA$C_PCLI_PTY
NMA$C_PCLI_RAC
NMA$C_PCLI_RES
NMA$C_PCLI_RFC
NMA$C_PCLI_XAC
NMA$C_PCLI_XFC

Once a port is started, only the following parameters can be changed:

NMA$C_PCLI_GSP
NMA$C_PCLI_MCA

The shutdown controller function shuts down the LAN port. On completionof a shutdown request all outstanding I/O requests are completed. Thisport cannot be used again until another startup request has been issued(see Section 9.16.3.1).

The following function code is used to shut down a port:

IO$_SETMODE!IO$M_CTRL!IO$M_SHUTDOWN---Shut down port

The shutdown controller function takes no device- or function-dependentarguments.

9.16.3.5 Enable Attention AST

This function requests that an attention AST be delivered to therequesting process when a status change occurs on the assigned port. AnAST is queued when a message is available and there is no waiting readrequest. The enable attention AST function is legal at any time,regardless of the condition of the unit status bits.

The following function code and modifier is used to enable an attentionAST:

• IO$_SETMODE!IO$M_ATTNAST---Enable attention AST

This function takes the following device- or function-dependentarguments:

• P1---The address of an AST service routine or 0 for disable
• P2---Ignored
• P3---Access mode to deliver AST

The enable attention AST function enables an attention AST to bedelivered to the requesting process once only. After the AST occurs, itmust be explicitly reenabled by the function before the AST can occuragain. The function is subject to AST quotas.

The AST service routine is called with an argument list. The firstargument is the current value of the second longword of the I/O statusblock (see Section 9.17).

9.16.3.6 IO$M_SET_MAC Functional Modifier to IO$M_SETMODE

The IO$M_SET_MAC qualifier, when used with IO$_SETMODE, is used to setmedium specific parmeters. The Token Ring parameters require PHY_IOprivilege to set. Table 9-18 shows the parameters that may be setfor Ethernet. Table 9-19 shows the parameters that may be set forFDDI. Table 9-20 shows the parameters that may be set for TokenRing, and Table 9-21 shows the parameters that may be set for ATM.

Using Token Ring only, the IO$M_UPDATE_MAP qualifier, when used withIO$_SETMODE, manipulates the adapter's functional address mappingtable. Figure 9-24 shows the format of the P2 buffer for thisoperation. This QIO requires PHY_IO privilege.

Figure 9-24 Format of IO$M_UPDATE_MAP Setmode P2 Buffer (AlphaOnly)

The subfunction is one of the following:

• NMA$C_MAP_CHANGE---This function adds or changes a mapping in the functional address table. If the specified multicast entry does not exist, an entry is created with the specified functional address mask. If the specified multicast entry does exist, the corresponding functional address mask is changed to the specified mask. All users who currently have the multicast enabled when the functional mask is changed will automatically update the functional address table as part of this operation.
  Possible errors returned include the following:

  SS$_DEVICEFULL---This error indicates that there is insufficient space in the mapping table to complete the request. The multicast to functional address mapping table has 200 entries.

• NMA$C_MAP_DELETE---This function deletes the specified MC address in the table. For this function, the functional address mask is not required to pass the P2 buffer. If the functional address mask is passed, its contents are ignored.
  Possible errors returned includes the following:

  SS$_BADPARAM --- This error indicates that the specified multicast address cannot be found in the table.

The following example maps multicast address AB-01-01-01-02-03 to thefunctional address 03-00-00-01-00-00 for device ICA0:.

LANCP>SET DEVICE/MAP= -_LANCP>(MULTICAST=AB-01-01-01-02-03, -_LANCP>FUNCTIONAL=00-01-00-00) ICA0:

The following example deletes the mapping of the multicast address ofAB-01-01-01-02-03 for the device ICA0:.

LANCP>SET DEVICE/NOMAP=(MULTICAST=AB-01-01-01-02-03) ICA0:

On Alpha systems using Token Ring only, the IO$M_ROUTE qualifier, whenused with IO$_SETMODE, manipulates the source routing cache table. Thiscommand is successful only when source routing is enabled. Sourcerouting is enabled with the set mac qualified set mode QIO.Figure 9-25 shows the format of the P2 buffer. This QIO requirePHY_IO privilege.

Figure 9-25 Format of the IO$M_ROUTE P2 Buffer (AlphaOnly)

The subfunction is one of the following:

• NMA$C_SR_ADD---This function adds or changes a source routing cache entry. It enters the LAN address into the table with the enclosed routing information. The routing information string format is documented in Section 9.12.6. If RI_size is passed as 0, the entry is created (or modified) to be in the EXPLORING state (this is useful for users who are doing their own source routing). If the RC 'Lth' field is zero, the LAN address is entered in the table as being in the local state.
  Possible errors returned include:

  SS$_INSFMEM---The source routing cache is full.
  SS$_BADPARAM---An invalid RI string was passed or invalid sizes were passed.
  SS$_IVMODE---Source routing is not enabled.

• NMA$C_SR_DELETE---This function deletes a source routing cache entry. The RI_size and the routing information string are not required for this QIO. If one or both of the fields are passed for this operation, they are ignored. The result of this command is to put the entry into the deleted state. When the entry goes into the deleted state, it is deleted within 10 minutes.
  Possible errors returned includes the following:

  SS$_BADPARAM---The requested entry could not be found.

The sense mode function returns the port attributes in the specifiedbuffers. These attributes include the device characteristics describedin Section 9.15 and, with the exceptions noted below, the attributeslisted in Table 9-16.

The following combinations of function code and modifier are provided:

• IO$_SENSEMODE!IO$M_CTRL---Read characteristics
• IO$_SENSECHAR!IO$M_CTRL---Read characteristics
• IO$_SENSEMODE!IO$M_SENSE_MAC---Medium specific characteristics

On Alpha systems, the following combinations of function code andmodifier for Token Ring are provided:

• IO$_SENSEMODE!IO$M_SHOW_MAP---Returns current functional address to multicast address mapping
• IO$_SENSEMODE!IO$M_SHOW_ROUTE---Returns current source routing cache table

These functions take the following device- or function-dependentarguments:

• P1---The address of a two-longword buffer where the device characteristics are stored. (Figure 9-26 shows the format for, and Section 9.15 describes the contents of, the P1 buffer.) The P1 argument is optional.
• P2---The address of a quadword descriptor where the attributes buffer is stored. The first longword of the descriptor is the buffer length; the second longword is the address of the buffer. The P2 argument is optional.
  The P2 buffer is not read by the LAN driver. The driver stores the port's attributes in the buffer, which contains multiple entries. The format of each entry depends on whether a longword or a counted string is returned, as shown in Figure 9-27. Each parameter ID contains a string indicator bit (bit 12) that describes whether the data item is a string or a longword.

Except for the following differences, P2 returns the same attributes asthose listed in Table 9-16:

• All parameters that are valid for the enabled packet format are returned (see Table 9-17).
• The sense-mode P2 buffer does not return the modifier word for the NMA$C_PCLI_PHA, NMA$C_PCLI_MCA, and NMA$C_PCLI_DES parameter IDs.
• The NMA$C_PCLI_DES parameter is only returned on Ethernet ports whose access mode is set to "shared with destination."
• In addition to the parameter IDs listed in Table 9-16, the sense-mode P2 buffer contains the following parameter IDs:

Figure 9-26 Sense Mode P1 Characteristics Buffer

It is suggested that a size of 250 bytes be used for the P2 buffer.This will allow space for additional parameters that may be returned infuture releases of OpenVMS.

All attributes that fit into the buffer specified by P2 are returned.However, if all the attributes cannot be stored in the buffer, the I/Ostatus block returns the status SS$_BUFFEROVF. Thesecond word of the I/O status block contains the number of bytes usedin the P2 buffer (see Section 9.17).

Figure 9-27 Sense Mode Attribute Buffer