[OpenVMS documentation]
[Site home] [Send comments] [Help with this site] [How to order documentation] [OpenVMS site] [Compaq site]
Updated: 11 December 1998

OpenVMS I/O User's Reference Manual


Previous Contents Index

5.4.3.3 Set Modem Function Modifier

The set modem function modifier is used in maintenance operations to allow a process to activate and deactivate modem control signals. Both set mode and set characteristics functions can take the set modem function modifier. The following combinations of function code and modifier are provided:

Note

For LAT devices, the set modem field for maintenance operations of the IO$M_SET_MODEM!IO$M_MAINT function modifier is unsupported and may return unpredictable results.

These function code modifier pairs take the following device- or function-dependent argument:

Figure 5-9 shows the format of this block.

Figure 5-9 Set Mode P1 Block


The modem on and modem off fields, in combination or separately, can specify one or more of the following values:

The $TTDEF macro defines the values for these values. These values can only be specified if the terminal characteristic TT$M_MODEM is not set. Otherwise, an error (SS$_ABORT) will result.

Notes

The set modem function is not supported for remote terminals. The status SS$_DEVREQERR is returned in the I/O status block.

Because the DMF32 does not provide the secondary transmitted data signal (Sec Txd), the driver sets the secondary request to send the signal. Users should connect a jumper cable between pins 14 and 19 on the DMF32.

5.4.3.4 Loopback Function Modifier

The loopback function modifier is used in maintenance operations to place the terminal line in a hardware loopback mode. Data transmitted to a line in this mode is returned as receive data. If the controller does not support loopback mode or the terminal line has the TT$M_MODEM characteristic set, an error status (SS$_ABORT) is returned. Both set mode functions can take the loopback function modifier.

Note

The loopback function is not supported for remote terminals. The status SS$_DEVREQERR is returned in the I/O status block.

The following combinations of function code and modifier are provided:

Data transmitted in the loopback mode should only be written in records less than or equal to the size of the type-ahead buffer (see Section 5.2.1.5). Programs that use the loopback function modifier should incorporate a 1-second delay to allow the controller to enable the loopback mode after the request is posted. Write requests should also include the IO$M_NOFORMAT function modifier to prevent terminal driver from formatting input or output data.

Note

The serial line interfaces for the VAX 8200 processor implement an internal loopback bus that is common to all four serial lines. The hardware allows all serial lines operating in loopback mode to transmit data to the bus at the same time. If more than one serial line writes data to the bus, all of the transmitted data is combined and made available to the receiving end of those same serial lines. Therefore, the received data may be different from the transmitted data if more than one serial line is operating in loopback mode at the same time. To prevent receiving such spurious data, you must not operate multiple serial lines in loopback mode.

The operating system provides another function modifier to reset a terminal line previously placed in loopback mode. The following combinations of function code and modifier are provided:

Programs that use the unloop function modifier should incorporate a 1-second delay to allow the controller to reset the loopback mode after the request is posted.

Note

IO$M_LOOP and IO$M_UNLOOP are not supported for LAT devices.

5.4.3.5 Enable Out-of-Band AST Function Modifier

The enable out-of-band AST function modifier requests that the terminal driver queue an AST for the requesting process when you enter any one of 32 control characters. The following combinations of function code and modifier are provided:

These function code modifier pairs take the following device- or function-dependent arguments:

The IO$_SETMODE!IO$M_OUTBAND function can optionally take the following function modifiers:

If an out-of-band AST is in effect, pressing any control character specified in the P2 mask gains the attention of the enabling process. Figure 5-8 shows the relationship of the out-of-band function with some of the control characters.

You can have only one out-of-band AST enabled per channel.

Out-of-band ASTs are repeating ASTs; they continue to be delivered until specifically disabled. Out-of-band AST enables are flushed by the Cancel I/O on Channel ($CANCEL) system service.

5.4.3.6 Broadcast Function Modifier

The broadcast function modifier allows you to turn on or turn off selected broadcast requester identifiers (IDs). The following combination of function code and modifier is provided:

This function code modifier pair takes the following device- or function-dependent arguments:

The first longword of P1 is reserved for use by Compaq facilities, as shown in Table 5-12. The symbols are defined in the system macro library ($BRKDEF). The second longword is for customer use to specify selected bits. If any bit is set in the P1 buffer, that particular requester ID is turned off for broadcast.

Table 5-12 Broadcast Requester IDs
Bit Meaning
BRK$C_DCL Disables broadcasts by Ctrl/T
BRK$C_GENERAL Disables broadcasts by the DCL command REPLY and the SYS$BRDCST system service
BRK$C_MAIL Disables broadcasts by the Mail utility
BRK$C_PHONE Disables broadcasts by the Phone utility
BRC$C_QUEUE Disables broadcasts about batch and print queues
BRK$C_SHUTDOWN Disables broadcasts about system shutdown
BRK$C_URGENT Disables broadcasts labeled URGENT by the REPLY command
BRK$C_USER n Disables broadcasts by images associated with the specified value; n can be any decimal integer between 1 and 16

5.4.4 LAT Port Driver QIO Interface

The LAT port driver (LTDRIVER) accommodates I/O requests from application programs for connections to remote devices on one or more terminal servers; for connections to remote services; and for configuring LTDRIVER and retrieving configuration information about LTDRIVER. A remote device, such as a printer, can be shared in a LAT configuration. Before an application program can access a remote device, the system manager must create logical devices and map them to physical devices connected to terminal servers. Creating and mapping these logical devices can be done either with the LAT Control Program (LATCP) utility or with a $QIO request from a program that has OPER privilege. Once mapped, application programs can establish and terminate connections to these remote devices.

This section describes the capabilities of the QIO interface to the LAT port driver (LTDRIVER). The QIO interface allows application programs to access and modify information contained in the LTDRIVER data structures and to initiate events and obtain status information. You must use these QIO functions to establish a connection to a remote device or service from an application program. Compaq does not support any other methods of connection.

The LTDRIVER responds to TEST SERVICE commands issued at terminal servers that support the TEST SERVICE command, such as the DECserver 200 and DECserver 500 servers.

LAT devices can use all read and write function modifiers listed for the terminal driver function codes except those modifiers that apply to modems (see Sections 5.4.1 and 5.4.2).

The operating system does not support the following set mode or set characteristics function code modifiers for LAT devices:

With LAT devices, the terminal server, rather than the host, handles flow control to the physical device. A separate flow control mechanism exists between the server and the host.

5.4.4.1 LAT Port Types

QIO functions can be used to create the following LAT port types:

5.4.4.2 LAT Port Driver Functions

The operating system provides the following combinations of function code and modifier:

5.4.4.3 Creating and Configuring LAT Entities

The LAT SETMODE $QIO function (IO$_TTY_PORT!IO$M_LT_SETMODE) is used to create, delete, and modify LAT nodes, services, ports, and links.

Creation, deletion, or modification of any entity requires the OPER privilege.

The LAT SETMODE $QIO function accepts four arguments: P1, P2, P3, and P4. P1 is the address of an item list; P2 is the length of this item list.

P3 specifies the type of entity to which the SETMODE operation applies. The entity type can be one of five types:

The value for the entity type occupies the low-order 16 bits (bits 0--15) of the P3 parameter. For all four entity types, bits 16--19 are used as a status field to indicate the expected current status of the entity. These bits are used to decide whether the entity needs to be created before its characteristics are set. The possible values for this field are:

P4 may contain the address of an entity name string descriptor. If this parameter is omitted (contains a 0 or the address of a descriptor that points to an empty buffer), a default may be used in some cases. The defaults for each entity type are as follows:

SETMODE can return the following status codes:

SETMODE Item Codes

Each item in the itemlist consists of a one-word (16-bit) item code, followed by a value associated with the item.

Item codes in which the bit named LAT$V_STRING is zero take a longword value. The associated value is contained in the longword immediately following the item code in the itemlist. Item codes in which this bit is 1 take a counted string for their value. The byte immediately following the item code contains a byte count, which describes the length of the string that immediately follows it.

If you set bit LAT$V_CLEAR in the item code to 1, the current value associated with the item code is cleared or set to its default value. In this case, the actual value specified in the itemlist is ignored, although the byte count field skips to the next item in the itemlist.

Figure 5-10 shows an example of a SETMODE itemlist.

Figure 5-10 Example SETMODE Itemlist


This SETMODE itemlist is the P1 parameter for a $QIO SETMODE function on the local node. P4 is omitted, and P3 is #LAT$C_ENT_NODE!<LAT$C_ENTS_OLD@16>. P2 is the length of the itemlist (52). A $QIO SETMODE function for this itemlist would perform the following operations:

  1. Set the state of the node to on.
  2. Set the LAT keepalive timer to 40 seconds.
  3. Set the node identification to LTC CLUSTER.
  4. Set the LAT circuit timer to 160 milliseconds.
  5. Enable LAT outbound connections.
  6. Turn on user groups 2, 8, 10, 11, 12, 16, and 19. LAT$_ITM_USER_GROUPS is represented by a bit field.
  7. Set the outgoing session limit to five sessions.

For each entity type, only a subset of item codes may be set. Table 5-13 lists the item codes that may be set for the LAT$C_ENT_NODE entity type.

Table 5-13 LAT$C_ENT_NODE Item Codes
Item Code Meaning
LAT$_ITM_STATE Operating state of the LAT protocol. The following values are allowed:
LAT$C_OFF Turns off LAT protocol processing. No new connections allowed in either direction. Existing connections are terminated immediately. This is the default.
LAT$C_SHUT Disallows new LAT connections in either direction. Existing connections are allowed to remain active.
LAT$C_ON Turns on LAT protocol processing.
LAT$_ITM_CIRCUIT_TIMER Circuit timer value in milliseconds. Valid values are 10 to 1000 milliseconds. The default is 80 milliseconds.
LAT$_ITM_CPU_RATING CPU rating. Valid values are 0 to 100. If this value is 0, then the CPU rating value is not used in the rating calculation. See the OpenVMS System Management Utilities Reference Manual for a complete description of this feature.
LAT$_ITM_DEVICE_SEED Overrides the default lower boundary for new LTA devices. Valid values are 0 to 9999; the default is 0. See the OpenVMS System Management Utilities Reference Manual for more information on this feature.
LAT$_ITM_KEEPALIVE_TIMER Keepalive timer value in seconds. Valid values are 10 to 255 seconds. The default is 20 seconds.
LAT$_ITM_MULTICAST_TIMER Multicast timer value in seconds. Valid values are 10 to 180 seconds. The default is 60 seconds.
LAT$_ITM_NODE_LIMIT Maximum number of nodes in LAT database. The default is 0, where the maximum is determined by system resources.
LAT$_ITM_RETRANSMIT_LIMIT LAT retransmit limit. Valid values are 4 to 120 retransmissions. The default is 8 retransmissions.
LAT$_ITM_SERVER_MODE Controls whether the node allows the use of the MASTER side of the LAT protocol for outbound connections. Valid values are:
LAT$C_DISABLED Server mode disabled (this is the default).
LAT$C_ENABLED Server mode enabled.
LAT$_ITM_SERVICE_RESPONDER Indicates whether the node is to respond to service inquiries originating from a remote system. These inquiries are not necessarily directed at services being offered by the node. See the OpenVMS System Management Utilities Reference Manual for a complete description of this feature. Valid values are:
LAT$C_DISABLED Service responder disabled (this is the default).
LAT$C_ENABLED Service responder enabled.
LAT$_ITM_OUTGOING_SES_LIMIT Maximum number of outgoing LAT sessions. A value of 0, which is the default, indicates that the limit is determined by system resources.
LAT$_ITM_INCOMING_SES_LIMIT Maximum number of interactive LAT sessions. A value of 0, which is the default, indicates that the limit is determined by system resources.
LAT$_ITM_CONNECTIONS Controls whether inbound connections can be accepted. Valid values are:
LAT$C_DISABLED Inbound connections disabled.
LAT$C_ENABLED Inbound connections enabled (this is the default).
LAT$_ITM_NODE_NAME Causes the LAT node name to be set to the given name. This item code may be specified only if the entity status field of the P3 parameter is LAT$C_ENTS_NEW; otherwise, a LAT$_ENTNOTFOU error results.
LAT$_ITM_IDENTIFICATION Node identification string. The default is the translation of SYS$ANNOUNCE.
LAT$_ITM_SERVICE_GROUPS Specifies a default service group code bit mask. This mask is then used when creating new local services. The default is group code 0 enabled and all others disabled when the LAT software is initialized.

Note that the use of the LAT$V_CLEAR bit is an exception for this parameter code. If you clear bit LAT$V_CLEAR, group codes corresponding to the group code mask, as specified in the itemlist, are set. Alternatively, if you set LAT$V_CLEAR, group codes corresponding to the group code mask, as specified in the itemlist, are cleared.

LAT$_ITM_USER_GROUPS LAT group codes to be used when attempting outbound connections using the MASTER side of the LAT protocol. The default is all group codes disabled when the LAT software is initialized.

Note that the use of the LAT$V_CLEAR bit is an exception for this parameter code. If you clear bit LAT$V_CLEAR, group codes corresponding to the group code mask, as specified in the itemlist, are set. Alternatively, if you set LAT$V_CLEAR, group codes corresponding to the group code mask, as specified in the itemlist, are cleared.

LAT$_ITM_COUNTERS Node counters block. Allows for zeroing of all node counters. This item code may be specified only if the entity status field of the P3 parameter is LAT$C_ENTS_OLD and the LAT$V_CLEAR bit is set. Violating either of these two rules results in a returned status of SS$_BADPARAM.
LAT$_ITM_MAXIMUM_UNITS Maximum unit number. Sets the highest value for a LTA unit number. Must be between 1 and 9999; defaults to 9999.
++ LAT$_ITM_HI_CIRCUITS Indicates the highest number the resource attained since the host was initialized for LAT connections to node.
++ LAT$_ITM_CUR_CIRCUITS Indicates current count of active connections to node.
++ LAT$_ITM_MAX_CIRCUITS Indicates maximum allowed virtual circuits to node.
++ LAT$_ITM_HI_SESSIONS Indicates highest number the resource attained since the host was initialized for LAT sessions.
++ LAT$_ITM_CUR_SESSIONS Indicates current number of active sessions.
++ LAT$_ITM_MAX_SESSIONS Indicates maximum possible sessions.
++ LAT$_ITM_HI_OUT_QUEUE Indicates highest number the resource attained since the host was initialized of outgoing queued connect requests.
++ LAT$_ITM_CUR_OUT_QUEUE Indicates current count of outgoing queued connect requests.
++ LAT$_ITM_MAX_OUT_QUEUE Indicates maximum number of simultaneous outgoing queued connect requests.
++ LAT$_TIM_HI_IN_QUEUE Indicates highest number the resource attained since the host was initialized of incoming queued requests.
++ LAT$_ITM_CUR_IN_QUEUE Indicates current number of entries in the incoming connect queue.
++ LAT$_ITM_MAX_IN_QUEUE Indicates maximum number of entries allowed on the incoming connect queue.
++ LAT$_ITM_HI_SAMS_QUEUED Indicates highest number the resource attained since the host was initialized of outstanding, unprocessed service announcement messages by LATACP.
++ LAT$_ITM_CUR_SAMS_QUEUED Indicates current number of outstanding, unprocessed service announcement messages on LATACP's queue.
++ LAT$_ITM_MAX_SAMS_QUEUED Indicates maximum number of outstanding, unprocessed service announcement messages allowed on LATACP's queue. If this limit is ever reached, subsequent service announcement messages are not delivered or processed by LATACP.
++ LAT$_ITM_HI_SOL_QUEUED Indicates highest number the resource attained since the host was initialized of outstanding, unprocessed solicit information messages by LATACP.
++ LAT$_ITM_CUR_SOL_QUEUED Indicates current number of outstanding, unprocessed solicit information messages on LATACP's queue.
++ LAT$_ITM_MAX_SOL_QUEUED Indicates maximum number of outstanding, unprocessed solicit information messages allowed on LATACP's queue. If this limit is ever reached, subsequent solicit information messages are not delivered or processed by LATACP.
++ LAT$_ITM_HI_AVAIL_SVCS Indicates highest number the resource attained since the host was initialized of number of available services in LATACP database.
++ LAT$_ITM_CUR_AVAIL_SVCS Indicates count of currently available LAT services in LATACP database.
++ LAT$_ITM_MAX_AVAIL_SVCS Indicates maximum number of available services possible in LATACP database.
++ LAT$_ITM_HI_REACH_NODES Indicates highest number the resource attained since the host was initialized of reachable nodes in LATACP database.
++ LAT$_ITM_CUR_REACH_NODES Indicates current number of reachable nodes in LATACP database.
++ LAT$_ITM_MAX_REACH_NODES Indicates maximum number of nodes allowed in LATACP database.
++ LAT$_ITM_HI_LCL_SVCS Indicates highest number the resource attained since the host was initialized of locally offered services.
++ LAT$_ITM_CUR_LCL_SVCS Indicates current count of locally offered service.
++ LAT$_ITM_MAX_LCL_SVCS Indicates maximum number of locally offered services.
++ LAT$_ITM_DISCARDED_NODES Indicates number of discarded service announcement messages.
++ LAT$_ITM_SERVICE_CLASSES Indicates returned service class bit mask for supported service classes on node. It is returned for both local and remote nodes. If service class 1 is enabled, then bit <1> is set in this mask. When bit setting equals 1, this indicates the corresponding service class for that bit is enabled. That is, when bit <3> equal 1, then service class 3 is enabled.
LAT$_ITM_LARGE_BUFFERS Indicates in Boolean logic whether or not the LAT software is using large packet support by default.
LAT$_ITM_ANNOUNCEMENTS Indicates in Boolean logic whether or not the LAT software is transmitting LAT service advertisement messages.


+VAX specific.
++Alpha specific.


Previous Next Contents Index

[Site home] [Send comments] [Help with this site] [How to order documentation] [OpenVMS site] [Compaq site]
[OpenVMS documentation]

Copyright © Compaq Computer Corporation 1998. All rights reserved.

Legal
6136PRO_020.HTML