.MCALL	.MODULE
.MODULE ICNTXS,VERSION=02,COMMENT=<ICNTXS/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 under FB or XM only. 
;
; INCLUDE FILES:
;
	; SYSMAC.SML		; RT-11 system macro library

	.MCALL	.CNTXSW		; CNTXSW programmed request

; EXTERNAL REFERENCES:
;
     
	.GLOBL	$NXADR		; Entry point to next address routine
	.GLOBL	$SYSLB		; Include system library work area
	.GLOBL	$ARGER		; error code for missing argument
	.GLOBL	$ERRM0		; Error conversion routine
	.SBTTL	ICNTXS - Fortran-callable Routine
;
; ++
; FUNCTIONAL DESCRIPTION:
;
; The ICNTXS function specifies the location to be included in a list
; when transation is made from running one job to running another.
;    
; CALLING SEQUENCE:
;
;       Form: i =  ICNTXS (addr)
;
; INPUT PARAMETERS:
;
;    R5	     -	address of ICNTXS argument block
;
;    0(R5)   -  argument count of ICNTXS call
;    2(R5)   -  address of the list of addresses terminated by a zero word
;
; RETURNED FUNCTION VALUE:
;
; i =   0  - Normal return 
;      -1  - One or more of the limitation  specified for addr was violated
;      -257. - Addr missing
; --

	.PSECT  SYS$I,I

CNTXS::
ICNTXS::
	MOV	(R5)+,R4	;R4(low byte) <- arg count
	CALL	$NXADR		;get addr of a list
	BCS	10$		;addr required arg missing
	MOV	R0,-(SP)	;store addr
	TST	-(SP)		;allocate remaining space
	.CNTXSW	SP
	BIT	(SP)+,(SP)+     ;*C*Align stack
	CALLR	$ERRM0		;get and convert any error (status in R0)

10$:	MOV     #$ARGER,R0      ;Required arg missing
        RETURN

	.END