RSC/MP 7.2 Programming Manual

API Function Descriptions

HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004

10-34

RscTime [RSCTIM]

The RscTime function retrieves the current time recorded on the host and places it in

the structure referenced by psTimeStruct. The integers in the structure are corrected to

match the internal representation of integers for the specific platform; therefore,

COBOL programs must declare these fields as COMP-5.

ulConnectionHandle

An existing connection handle created through the RscConnect function call.

psTimeStruct

A pointer to the RSC/MP structure RSC_TIME that receives the time. The

RSC_TIME structure has the form:

typedef struct

{

SHORT nHour;

SHORT nMinute;

SHORT nSecond;

SHORT nMillisecond;

SHORT nYear;

SHORT nMonth;

SHORT nDay;

} RSC_TIME;

Return Value

The return value is zero if the function is successful; otherwise, the function returns

one of these result values:

USHORT RscTime

(ULONG ulConnectionHandle /* in */

,RSC_TIME *psTimeStruct /* out */

);

RSC_INVALID_CONNECTION_HANDLE 6

RSC_PC_HEAP_EXHAUSTED 22