: : : : : : ======================================== : | | : | DISPLAY MANAGER | : | | : | Version 1.0 | : | for | : | CP/M-86 Operating Systems Family | : | | : | READ.ME File Notes | : | | : | July 1983 | : | | : | | : | Digital Research | : | Pacific Grove, California : : :______________________________________: : : : : : : Information and changes documented in this file : supercede existing documentation. : : : : : : : : .---------------------------------------------------. : | The notes in this file are organized so that when | : | printed on paper that is 11-inches long at six | : | lines per inch, they can be trimmed on the indi- | : | cates lines and placed in your product documenta- | : | tion binder. | : |___________________________________________________| : : : : : : ------------------------------------------------------------------ READ.ME File Notes : : : TABLE OF CONTENTS : ================================================== : : PUTF FUNCTION NOTE . . . . . . . . . . . . . . 1 : LEFT/RIGHT JUSTIFICATION NOTE . . . . . . . . . 1 : SPECIAL PASCAL/MT+86 FUNCTIONS . . . . . . . . 1 : BCDVAL and BCDSTR : COMPILING/LINKING PASCAL/MT+86 SAMPLE PROGRAM . 1 : C PROGRAMMING EXAMPLE . . . . . . . . . . . . . 2 : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : Display Manager (CP/M-86) Page i : : ------------------------------------------------------------------ READ.ME File Notes : : : : PUTF FUNCTION NOTE : =================================================== : : The PUTF function displays string characters in a : display field even when the Format code in the : field's status window is N (specifying numeric data). : : : LEFT/RIGHT JUSTIFICATION NOTE : =================================================== : : When a field's Format code is L or R (signifying : Left or Right justification, respectively) and : truncation is necessary, information is always : truncated from the right side of the data field. : : : SPECIAL PASCAL/MT+86 FUNCTIONS : =================================================== : : If you encounter problems using the special Display : Manager functions BCDVAL and BCDSTR, request an : updated version of the Pascal/MT+ library : BCDREALS.L86 from Digital Research. : : : COMPILING/LINKING THE PASCAL/MT+86 SAMPLE PROGRAM : =================================================== : : The sample Pascal/MT+86 program must be compiled : and linked for use with BCD numbers, as follows: : : MT86 SAMPAS $B : LINKMT SAMPAS,DMPAS/S,BCDREALS,FULLHEAP,PASLIB/S/X:100 : : : : : : : : : Display Manager (CP/M-86) Page 1 : : ------------------------------------------------------------------ READ.ME File Notes : : *** C PROGRAMMING EXAMPLE *** : : #include : : int i,l; : int fd; : char TERMS[255]; : char dispname[] = "ORDERS.DIS"; : FILE *tf=NULL; : : #include /* display manager function declrs */ : : main () : : { : : EXTERN FILE *tf; /* get control code from a file */ : BYTE *trname = "CURRENT.TRM"; : : if !(tf = fopen(trname,"r")) /* open code file */ : { : printf("Unable to open terminal file"); : exit(0); : } : : i = 0; /* string position counter */ : l = 255; /* String no larger than 255 */ : while (l-- > 0 && (c=getc(tf)) != '\n') : TERMS[i++] = c; /* copy codes into string */ : TERMS[i] = '\0'; /* end of string marker */ : : if (i=INITDM(TERMS))/* initialize display manager */ : { : printf("Unable to initialize DM, code = %6d",i); : exit(0); : } : : if OPNDIS(dispname) /* Open display file */ : { : printf("No such display %s \n", dispname); : exit(0); : } : : : Display Manager (CP/M-86) Page 2 : : ------------------------------------------------------------------ READ.ME File Notes : : : : /*******************************************************/ : /* Your 'C' Program using Display Manager starts here */ : /*******************************************************/ : : if CLSDIS /* Close display file */ : { : printf("Close failure, display %s \n",dispname); : exit(0); : } : : } : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : Display Manager (CP/M-86) Page 3 : : -----------------------------------------------------------------: