HP OpenVMS System Services Reference Manual


Previous Contents Index


$ICC_TRANSMITW

Sends a single message over a connection.

The $ICC_TRANSMITW service completes synchronously; that is, it returns to the caller when the underlying transport layer has released use of the Transmit buffer. This does not mean that the data has been received by the partner application.

For asynchronous completion, use the $ICC_TRANSMIT service. The $ICC_TRANSMIT service returns to the caller as soon as the transmission request has been queued to the transport layer, without waiting for notification that the transport layer has released control of the data buffer.

On Alpha and Integrity server systems, this service accepts 64-bit addresses.


Format

SYS$ICC_TRANSMITW conn_handle ,ios_icc ,[astadr] ,[astprm] ,send_buf ,send_len


C Prototype

sys$icc_transmitw (unsigned int conn_handle, struct _ios_icc *ios_icc, void (*astadr)(__unknown_params), __int64 astprm, char *send_buf, unsigned int send_len);


$IDTOASC

Translates the specified identifier value to its identifier name.

On Alpha and Integrity server systems, this service accepts 64-bit addresses.


Format

SYS$IDTOASC id ,[namlen] ,[nambuf] ,[resid] ,[attrib] ,[contxt]


C Prototype

int sys$idtoasc (unsigned int id, unsigned short int *namlen, void *nambuf, unsigned int *resid, unsigned int *attrib, unsigned int *contxt);


Arguments

id


OpenVMS usage: rights_id
type: longword (unsigned)
access: read only
mechanism: by value

Binary identifier value translated by $IDTOASC. The id argument is a longword containing the binary value of the identifier. To determine the identifier names of all identifiers in the rights database, you specify id as --1 and call $IDTOASC repeatedly until it returns the status code SS$_NOSUCHID. The identifiers are returned in alphabetical order.

namlen


OpenVMS usage: word_unsigned
type: word (unsigned)
access: write only
mechanism: by 32- or 64-bit reference (Alpha and Integrity servers)

Number of characters in the identifier name translated by $IDTOASC. The namlen argument is the 32- or 64-bit address (on Alpha and Integrity server systems) of a word containing the length of the identifier name written to nambuf.

nambuf


OpenVMS usage: char_string
type: character-coded text string
access: write only
mechanism: by 32- or 64-bit descriptor--fixed-length string descriptor (Alpha and Integrity servers)

Identifier name text string returned when $IDTOASC completes the translation. The nambuf argument is the 32- or 64-bit address (on Alpha and Integrity server systems) of a descriptor pointing to the buffer in which the identifier name is written.

resid


OpenVMS usage: rights_id
type: longword (unsigned)
access: write only
mechanism: by 32- or 64-bit reference (Alpha and Integrity servers)

Identifier value of the identifier name returned in nambuf. The resid argument is the 32- or 64-bit address (on Alpha and Integrity server systems) of a longword containing the 32-bit code of the identifier.

attrib


OpenVMS usage: mask_longword
type: longword (unsigned)
access: write only
mechanism: by by 32- or 64-bit reference (Alpha and Integrity servers)

Mask of attributes associated with the identifier returned in resid. The attrib argument is the 32- or 64-bit address (on Alpha and Integrity server systems) of a longword containing the attribute mask.

Symbol values are offsets to the bits within the longword. You can also obtain the values as masks with the appropriate bit set using the prefix KGB$M rather than KGB$V. The following symbols for each bit position are defined in the system macro library ($KGBDEF):
Bit Position Meaning When Set
KGB$V_DYNAMIC Allows holders of the identifier to remove it from or add it to the process rights list using the DCL command SET RIGHTS_LIST.
KGB$V_NAME_HIDDEN Allows holders of an identifier to have it translated, either from binary to ASCII or vice versa, but prevents unauthorized users from translating the identifier.
KGB$V_NOACCESS Makes any access rights of the identifier null and void. This attribute is intended as a modifier for a resource identifier or the Subsystem attribute.
KGB$V_RESOURCE Allows holders of an identifier to charge disk space to the identifier. It is used only for file objects.
KGB$V_SUBSYSTEM Allows holders of the identifier to create and maintain protected subsystems by assigning the Subsystem ACE to the application images in the subsystem.

contxt


OpenVMS usage: context
type: longword (unsigned)
access: modify
mechanism: by 32- or 64-bit reference (Alpha and Integrity servers)

Context value used when repeatedly calling $IDTOASC. The contxt argument is the 32- or 64-bit address (on Alpha and Integrity server systems) of a longword used while $IDTOASC searches for all identifiers. The context value must be initialized to the value 0, and the resulting context of each call to $IDTOASC must be presented to each subsequent call. After contxt is passed to $IDTOASC, you must not modify its value.

Description

The Translate Identifier to Identifier Name service translates the specified binary identifier value to an identifier name. While the primary purpose of this service is to translate the specified identifier to its name, you can also use it to find all identifiers in the rights database. Owner or read access to the rights database is required. To determine all the identifiers, call $IDTOASC repeatedly until it returns the status code SS$_NOSUCHID. When SS$_NOSUCHID is returned, $IDTOASC has returned all the identifiers, cleared the context value, and deallocated the record stream.

If you complete your calls to $IDTOASC before SS$_NOSUCHID is returned, use $FINISH_RDB to clear the context value and deallocate the record stream.

When you use wildcards with this service, the records are returned in identifier name order.

Required Access or Privileges

None, unless the id argument is NAME_HIDDEN, in which case you must hold the identifier or have read access to the rights list.

Required Quota

None

Related Services

$ADD_HOLDER, $ADD_IDENT, $ASCTOID, $CHECK_ACCESS, $CHKPRO, $CREATE_RDB, $ERAPAT, $FIND_HELD, $FIND_HOLDER, $FINISH_RDB, $FORMAT_ACL, $FORMAT_AUDIT, $GET_SECURITY, $GRANTID, $HASH_PASSWORD, $MOD_HOLDER, $MOD_IDENT, $MTACCESS, $PARSE_ACL, $REM_HOLDER, $REM_IDENT, $REVOKID, $SET_SECURITY


Condition Values Returned

SS$_NORMAL The service completed successfully.
SS$_ACCVIO The namlen, nambuf, resid, attrib, or contxt argument cannot be written by the caller.
SS$_INSFMEM The process dynamic memory is insufficient for opening the rights database.
SS$_IVCHAN The contents of the context longword are not valid.
SS$_IVIDENT The specified identifier is of invalid format.
SS$_NOIOCHAN No more rights database context streams are available.
SS$_NORIGHTSDB The rights database does not exist.
SS$_NOSUCHID The specified identifier name does not exist in the rights database, or the entire rights database has been searched if the ID is --1.

Because the rights database is an indexed file that you access with OpenVMS RMS, this service can also return RMS status codes associated with operations on indexed files. For descriptions of these status codes, refer to the OpenVMS Record Management Services Reference Manual.


$IEEE_SET_FP_CONTROL (Alpha and Integrity servers)

On Alpha and Integrity server systems, modifies IEEE floating-point state and, optionally, returns the previous value.

The service provides the mechanism to set the specified state bits, to clear the specified state bits, and to swap one set of state bits for another.


Format

SYS$IEEE_SET_FP_CONTROL [clrmsk] ,[setmsk] ,[prvmsk]


C Prototype

int sys$ieee_set_fp_control (struct _ieee *clrmsk, struct _ieee *setmsk, struct _ieee *prvmsk);


Arguments

clrmsk


OpenVMS usage: mask_quadword
type: quadword (unsigned)
access: read only
mechanism: by reference

Address of a quadword bit mask to be cleared in the IEEE floating-point control register.

The $IEEEDEF macro defines symbols for the floating-point control register. Table SYS-46 shows the symbols, their corresponding masks, and their meaning:

Table SYS-46 Format of the IEEE Floating-Point Control Register (Alpha and Integrity servers)
Symbol Mask Meaning
IEEE$M_TRAP_ENABLE_INV 2 Enable invalid operation exception
IEEE$M_TRAP_ENABLE_DZE 4 Enable divide by 0 exception
IEEE$M_TRAP_ENABLE_OVF 8 Enable overflow exception
IEEE$M_TRAP_ENABLE_UNF 10 Enable underflow exception
IEEE$M_TRAP_ENABLE_INE 20 Enable inexact exception
IEEE$M_TRAP_ENABLE_DNOE 40 Enable denormal operand exception
IEEE$M_MAP_DNZ 2000 Denormal operands are mapped to 0.0
IEEE$M_MAP_UMZ 4000 Underflow results are mapped to 0.0
IEEE$M_INHERIT 8000 Inherit FP state on thread create
IEEE$M_STATUS_INV 20000 Invalid operation
IEEE$M_STATUS_DZE 40000 Divide by 0
IEEE$M_STATUS_OVF 80000 Overflow
IEEE$M_STATUS_UNF 100000 Underflow
IEEE$M_STATUS_INE 200000 Inexact
IEEE$M_STATUS_DNO 400000 Denormal operand

setmsk


OpenVMS usage: mask_quadword
type: quadword (unsigned)
access: read only
mechanism: by reference

Address of a quadword bit mask to be set in the IEEE floating-point control register.

Table SYS-46 shows the format of the IEEE floating-point control register.

prvmsk


OpenVMS usage: mask_quadword
type: quadword (unsigned)
access: write only
mechanism: by reference

Address of a quadword to receive the previous value of the IEEE floating-point control register.

Description

The Set IEEE Floating-Point Control Register service updates the IEEE floating-point control register, maintained by the operating system, with the values supplied by the calling program.

The following steps are used to update the register:

  1. If the prvmsk argument is specified, $IEEE_SET_FP_CONTROL first reads the previous value of the IEEE floating-point control register.
  2. If the clrmsk argument is specified, $IEEE_SET_FP_CONTROL then clears the specified bit masks in the clrmsk argument.
  3. If the setmsk argument is specified, $IEEE_SET_FP_CONTROL then sets the specified bit masks in the setmsk argument.

A program can swap the IEEE floating-point control register (that is, save the old value and specify a new value) by specifying the following:

On Integrity server systems, the initial state value and the scope of the modified state values differ depending on the location of the call to this routine, as shown in the following table.
Location of Call State Value Scope of New State Value
Mainline Determined by the compiler switches used when compiling the modules. Change is in effect until this service is called again, with the exception of ASTs (see below).
Condition handler The same as the state in effect when the condition occurs, unless the setting was changed by a previous condition handler. Change is in effect until all remaining condition handlers have been called or this service is called again.
AST routine Determined by the compiler switches used when compiling the modules, regardless of the state value in effect when the AST was triggered. Change is in effect only until the AST completes or this service is called again.

On Alpha systems, calling this routine changes the setting for ASTs as well as the mainline program.

Required Access or Privilege

None

Required Quota

None

Related Services

$IEEE_SET_PRECISION_MODE
$IEEE_SET_ROUNDING_MODE


Condition Values Returned

SS$_NORMAL The service completed successfully.
SS$_ACCVIO The specified argument cannot be read or cannot be written.

$IEEE_SET_PRECISION_MODE (Integrity servers Only)

On Integrity server systems, modifies the IEEE precision mode and, optionally, returns the previous value.

Format

SYS$IEEE_SET_PRECISION_MODE new_value , [*prev_value]


C Prototype

int sys$ieee_set_precision_mode (int new_value, int *prev_value);


Arguments

new_value


OpenVMS usage: IEEE precision mode
type: longword (unsigned)
access: read only
mechanism: by value

The new value can be one of the following:
Symbol Value Meaning
IEEE$C_PM_NO_CHANGE -1 No change. Just get previous value
IEEE$C_PM_SINGLE 0 Single Precision
IEEE$C_PM_DOUBLE 2 Double Precision
IEEE$C_PM_DOUBLE_EXTENDED 3 Double-Extended Precision

prev_value


OpenVMS usage: IEEE precision mode
type: longword (unsigned)
access: write only
mechanism: by reference

The previous value is a pointer to a return value that can be one of the last three items from the table showing new values.

Description

The initial precision mode and the scope of the modified precision mode differ depending on the location of the call to this routine, as shown in the following table.
Location of Call Initial Precision Mode Scope of New Precision Mode
Mainline Determined by the compiler switches used when compiling the modules. Change is in effect until this service is called again with the exception of ASTs (see below).
Condition handler The same as the precision mode in effect when the condition occurs, unless the setting was changed by a previous condition handler. Change is in effect until all remaining condition handlers have been called or this service is called again.
AST routine Determined by the compiler switches used when compiling the modules, regardless of the precision in effect when the AST was triggered. Change is in effect only until the AST completes or this service is called again.

Required Access or Privileges

None

Required Quotas

None

Related Services

$IEEE_SET_FP_CONTROL
$IEEE_SET_ROUNDING_MODE


$IEEE_SET_ROUNDING_MODE (Integrity servers Only)

On Integrity server systems, modifies the IEEE rounding mode and, optionally, returns the previous value.

Format

SYS$IEEE_SET_ROUNDING_MODE new_value , [*prev_value]


C Prototype

int sys$ieee_set_rounding_mode (int new_value, int *prev_value);

,


Arguments

new_value


OpenVMS usage: IEEE rounding mode
type: longword (unsigned)
access: read only
mechanism: by value

The new value can be one of the following:
Symbol Value Meaning
IEEE$C_RM_NO_CHANGE -1 No change. Just get previous value
IEEE$C_RM_NEAREST 0 Nearest (or even)
IEEE$C_RM_DOWN 1 -Infinity (down)
IEEE$C_RM_UP 2 +Infinity (up)
IEEE$C_RM_TRUNCATE 3 Zero (truncate/chop)

prev_value


OpenVMS usage: IEEE rounding mode
type: longword (unsigned)
access: write only
mechanism: by reference

The previous value is a pointer to a return value that can be one of the last four items from the table showing new values.

Description

The initial rounding mode and the scope of the modified rounding mode differ depending on the location of the call to this routine, as shown in the following table.
Location of Call Initial Rounding Mode Scope of New Rounding Mode
Mainline Determined by the compiler switches used when compiling the modules. Change is in effect until this service is called again, with the exception of ASTs (see below).
Condition handler The same as the rounding mode in effect when the condition occurs, unless the setting was changed by a previous condition handler. Change is in effect until all remaining condition handlers have been called or this service is called again.
AST routine Determined by the compiler switches used when compiling the modules, regardless of the rounding in effect when the AST was triggered. Change is in effect only until the AST completes or this service is called again.

Required Access or Privileges

None

Required Quota

None

Related Services

$IEEE_SET_FP_CONTROL
$IEEE_SET_PRECISION_MODE


Previous Next Contents Index