VMS Help  —  System Services, $GETRMI
    Returns system performance information about the local system.
    $GETRMI is an asynchronous system service and requires the
    $SYNCH service or another wait-state synchronous mechanism to
    guarantee that the required information is available. There is no
    synchronous wait form for this system service.

    For additional information about system service completion, see
    the Synchronize ($SYNCH) service.

    Format

      SYS$GETRMI  [efn] [,nullarg] [,nullarg] ,itmlst [,iosb]

                  [,astadr] [,astprm]

    C Prototype

      int sys$getrmi  (unsigned int efn, unsigned int nullarg,

                      unsigned int nullarg, void *itmlst, struct

                      _iosb *iosb, void (*astadr)(__unknown_params),

                      int astprm);

1  –  Arguments

 efn

    OpenVMS usage:ef_number
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Number of event flag to be set when the $GETRMI request
    completes. The efn argument is a longword containing this number;
    however, $GETRMI uses only the low order byte.

 nullarg

    OpenVMS usage:null_arg
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Placeholding argument Reserved to VSI.

 nullarg

    OpenVMS usage:null_arg
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Placeholding argument Reserved to VSI.

 itmlst

    OpenVMS usage:item_list_3
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Item list specifying which information is to be returned about
    the local node. The itmlst argument is the address of a list of
    item descriptors, each of which describes an item of information.
    The list of descriptors is terminated by a longword of 0.

    To view the item code diagram and descriptor fields table, see
    the VSI OpenVMS System Services Reference Manual.

 iosb

    OpenVMS usage:io_status_block
    type:         quadword (unsigned)
    access:       write only
    mechanism:    by reference
    I/O status block to receive the final completion status. The iosb
    argument is the address of the quadword I/O status block.

 astadr

    OpenVMS usage:ast_procedure
    type:         procedure value
    access:       call without stack unwinding
    mechanism:    by reference
    AST service routine to be executed when $GETRMI completes. The
    astadr argument is the address of this routine.

 astprm

    OpenVMS usage:user_arg
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    AST parameter to be passed to the AST service routine specified
    by the astadr argument.
Close Help