VMS Help RTL Routines, LIB$, LIB$GETSYI, Arguments *Conan The Librarian (sorry for the slow response - running on an old VAX) |
item-code OpenVMS usage:longword_signed type: longword (signed) access: read only mechanism: by reference Item code specifying the desired item of information. The item- code argument is the address of a signed longword containing this item code. All valid $GETSYI item codes are accepted. resultant-value OpenVMS usage:varying_arg type: unspecified access: write only mechanism: by reference Numeric value returned by LIB$GETSYI. The resultant-value argument is the address of a longword or quadword containing this value. If an item is listed as returning only a string value, this argument is ignored. resultant-string OpenVMS usage:char_string type: character string access: write only mechanism: by descriptor Information returned by LIB$GETSYI. The resultant-string argument is the address of a descriptor pointing to the character string that will receive this information. If resultant-string is not specified and if the returned value has only a string representation, the error status LIB$_INVARG is returned. resultant-length OpenVMS usage:word_unsigned type: word (unsigned) access: write only mechanism: by reference Number of significant characters written to resultant-string, not including blank padding or truncated characters. The resultant- length argument is the address of an unsigned word into which LIB$GETSYI returns this number. cluster-system-id OpenVMS usage:identifier type: longword (unsigned) access: modify mechanism: by reference Cluster system identification (CSID) of the node for which information is to be returned. The cluster-system-id argument is the address of this CSID. If cluster-system-id is specified and is nonzero, node-name is not used. If cluster-system-id is specified as zero, LIB$GETSYI uses node-name and writes into the cluster-system-id argument the CSID corresponding to the node identified by node-name. The cluster-system-id of an OpenVMS node is assigned by the cluster-connection software and may be obtained by the DCL command SHOW CLUSTER. The value of the cluster-system-id for an OpenVMS node is not permanent; a new value is assigned to an OpenVMS node whenever it joins or rejoins the OpenVMS Cluster. If cluster-system-id is specified as -1, LIB$GETSYI assumes a wildcard operation and returns the requested information for each OpenVMS node in the cluster, one node per call. If cluster-system-id is not specified, node-name is used. node-name OpenVMS usage:char_string type: character string access: read only mechanism: by descriptor Name of the node for which information is to be returned. The node-name argument is the address of a descriptor pointing to the node name string. If cluster-system-id is not specified or is specified as zero, node-name is used. If neither node-name nor cluster-system-id is specified, the caller's node is used. See the cluster-system-id argument for more information. The node name string must contain from 1 to 15 characters and must correspond exactly to the OpenVMS node name; no trailing blanks nor abbreviations are permitted.
|