.MCALL	.MODULE
.MODULE	TIME,VERSION=04,COMMENT=<TIME/SYSLIB>,IDENT=No,LIB=Yes

; Copyright (c) 1998 by Mentec, Inc., Nashua, NH.
; All rights reserved
;
; This software is furnished under a license for use only on a
; single computer system and  may  be  copied  only  with  the
; inclusion of the above copyright notice.  This software,  or
; any other copies thereof, may not be provided  or  otherwise
; made available to any other person except for  use  on  such
; system and to one who agrees to these license  terms.  Title
; to  and  ownership of the software shall at all times remain
; in Mentec, Inc.
;
; The information in this document is subject to change without
; notice and should not be construed as a commitment by Digital
; Equipment Corporation, or Mentec, Inc.
;
; Digital and Mentec  assume  no  responsibility for the use or
; reliability of its software on equipment which is not supplied
; by Digital  or Mentec,  and listed  in the  Software  Product
; Description.
	.SBTTL	Module Declarations

	.NLIST
	.ENABL	LC
	.DSABL	GBL
	.NLIST	CND
	.LIST
; ++
; FACILITY:
;
;    RT-11 System Subroutine Library
;
; ENVIRONMENT:
;
;    This routine can be used by any job running in a single-job
;    or multi-job environment.
;
; INCLUDE FILES:
;

	; SYSMAC.SML		; RT-11 system macro library.

	.MCALL	.GTIM		; GTIM programmed request.
;
; EXTERNAL REFERENCES:
;

	.GLOBL	$TMSC		; Entry point time to ASCII conversion routine
	.GLOBL	$SYSLB		; Include system library work area
	.SBTTL	TIME - Fortran-callable Routine

; ++
; FUNCTIONAL DESCRIPTION:
;
;    The TIME routine returns the current system time of day as an eight-
;    character ASCII string of the form:
;
;	hh:mm:ss
;
;    where:
;
;	hh  -  two-digit hours
;	mm  -  two-digit minutes
;	ss  -  two-digit seconds
;    
; CALLING SEQUENCE:
;
;    CALL TIME( string )
;
; INPUT PARAMETERS:
;
;    R5	     -	address of TIME's argument block
;    0(R5)   -	argument count of TIME call
;    2(R5)   -	address of eight-byte area to receive ASCII time string
;
; OUTPUT PARAMETERS:
;
;    string  -	converted ASCII time string (time-of-day)
;
; --

	.PSECT	SYS$I

TIME::
	MOV	(R5)+,R4	; R4(low byte) <- contains number of arguments

	CMP	-(SP),-(SP)	; allocate space for area to receive two-word
				; system time
	MOV	SP,R1		; save addr of the area to receive system time
		
	TST	-(SP)		; allocate remaining space for .GTIM

	.GTIM	SP,R1		; Retrieve current system time

	CALL	$TMSC		; and go to convert time to string

	ADD	#6,SP		; Purge stack
	RETURN

	.END