home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / cobol / library / sc_des / usrguide.sd < prev   
Encoding:
Text File  |  1992-02-17  |  67.7 KB  |  1,553 lines

  1.                             SCREEN DESIGNER FOR COBOL
  2.  
  3.  
  4.     ***************************************************************************
  5.     *   FEEL FREE TO COPY THIS DISK AND GIVE IT TO ASSOCIATES AND FRIENDS.    *
  6.     * ------------------------------------------------------------------------*
  7.     * A MAXIMUM CHARGE OF $10.00 MAY BE CHARGED AS A DISTRIBUTION FEE FOR     *
  8.     * THIS SOFTWARE .                                                         *
  9.     ***************************************************************************
  10.  
  11.     ***************************************************************************
  12.     *  THE USER CAN ONLY USE THE SCREEN DESIGNER SOFTWARE FOR SEVEN DAYS FOR  *
  13.     *  EVALUATION PURPOSES BEFORE PURCHASING.                                 *
  14.     ***************************************************************************
  15.  
  16.  
  17.                                ****************
  18.                                * TO PURCHASE  *
  19.                                ****************
  20.  
  21.  
  22.     SEND CHECK TO
  23.  
  24.     DAN CHOPPING
  25.     3516 PARTRIDGE LANE
  26.     CASPER, WY 82604
  27.  
  28.     (307) 234-8760 AFTER 5:00 PM MST
  29.  
  30. ********************************************************************
  31. *   COST $ 25.00 FOR 1ST COPY, $ 20.00 FOR EACH ADDITIONAL COPY.   *
  32. ********************************************************************
  33.  
  34. **************************************************************************
  35. *  THE USER CAN ONLY USE THE SCREEN DESIGNER SOFTWARE FOR SEVEN DAYS FOR *
  36. *  EVALUATION PURPOSES BEFORE PURCHASING.                                *
  37. **************************************************************************
  38.  
  39.  
  40. COPY REGISTER.FRM TO PRINTER FOR REGISTRATION. [COPY REGISTER.FRM PRN]
  41.  
  42.  
  43. MULTIPLE COPIES DISCOUNTS AND SOURCE CODE ARE AVAILABLE.
  44.  
  45. NP
  46.                        *********************************
  47.                        * SCREEN DESIGN SYSTEM OVERVIEW *
  48.                        *********************************
  49.  
  50. THE SCREEN DESIGN SOFTWARE PACKAGE CONTAINS FIVE PROGRAMS CREATED TO MINIMIZE
  51. THE TIME REQUIRED TO DEVELOP AND MAINTAIN SCREEN LAYOUTS FOR ONLINE
  52. APPLICATIONS. THE AUTHOR HAS BEEN A SYSTEMS ANALYST FOR OVER TEN YEARS AND HAS
  53. BEEN FRUSTRATED BY THE AMOUNT OF TIME REQUIRED TO DESIGN AND MAINTAIN SCREEN
  54. LAYOUTS MANUALLY. THE AUTHOR HAS DONE PROGRAMMING FOR PCS AND A NCR VRX
  55. MAINFRAME. THIS PACKAGE DOES NOT INCLUDE LOTS OF BELLS AND WHISTLES, BUT THE
  56. AUTHOR BELIEVES IT GETS THE JOB DONE. 
  57.  
  58. THERE ARE MANY PC SCREEN HANDLING SOFTWARE PACKAGES ON THE MARKET TODAY, BUT
  59. THEY OFTEN REQUIRE SPECIAL SOFTWARE TO WORK. THE AUTHOR WORKS FOR A SCHOOL
  60. DISTRICT WITH OVER 40 IBM PC COMPATIBLES. THIS MAKES EXISTING PC SCREEN HANDING
  61. PROGRAMS VERY EXPENSIVE WHEN LICENCED ON A PER MACHINE BASIS. MAINFRAME SCREEN
  62. HANDLING PROGRAMS ALSO ARE AVAILABLE BY GENERALLY ARE EXPENSIVE AND/OR TAKE A
  63. DEGREE OF PROCESSOR TIME TO WORK. THIS SCREEN DESIGN PACKAGE CREATES GENERIC
  64. COBOL WORKING-STORAGE SCREEN DEFINITIONS WHICH DO NOT NEED SPECIAL SOFTWARE TO
  65. OPERATE. THIS GENERIC SCREEN DEFINITION CAN BE USED ON MAINFRAMES,
  66. MINICOMPUTERS AND PCS.
  67.  
  68. NP
  69.  
  70. THE FOLLOWING TABLE SHOWS SCREEN DESIGN PROGRAMS AND AND THEIR FUNCTIONS.
  71.  
  72. PROGRAM        DESCRIPTION
  73. -----------------------------------------------------------
  74. SDMENU        MENU PROGRAM FOR SCREEN DESIGN
  75.  
  76. SDEDIT        CREATES AND MODIFY SCREEN PROGRAM
  77.  
  78. SDCOBOL        GENERATES COBOL WORKING STORAGE SCREEN 
  79.         DEFINITIONS CREATED IN SDEDIT
  80.  
  81. SDCOM        NCR 796-101 TERMINAL EMULATION PROGRAM AND 
  82.         COBOL SCREEN DEFINITION UPLOAD PROGRAM
  83.  
  84. SDCONFIG    SCREEN DESIGN CONFIGURATION PROGRAM
  85. -----------------------------------------------------------
  86.  
  87. ALL USER ENTERED KEYSTROKES ARE ENCLOSED WITH <>.
  88.  
  89. NP
  90.                    *****************************************
  91.                    * LET'S BE REASONABLE LICENSE AGREEMENT *
  92.                    *****************************************
  93.  
  94. BY USING, OR COPYING THE SCREEN DESIGN SOFTWARE DISK OR MANUAL THE USER IS
  95. BOUND BY THIS LICENCE AGREEMENT AND WARRANTY.
  96.  
  97. THE USER CAN ONLY USE THE SCREEN DESIGNER SOFTWARE FOR SEVEN DAYS FOR
  98. EVALUATION PURPOSES BEFORE PURCHASING.
  99.  
  100. DAN CHOPPING GRANTS THE PURCHASER A NON-EXCLUSIVE AND NON-TRANSFERABLE LICENSE
  101. TO USE THIS SOFTWARE. 
  102.  
  103. BACKUP COPIES OF THIS SOFTWARE AND MANUAL MAY BE MADE FOR USER'S BACKUP
  104. PURPOSES ONLY. THE PURCHASER AGREES NOT TO SELL COPIES OF THIS SOFTWARE
  105. WITHOUT THE EXPRESSED WRITTEN CONSENT OF DAN CHOPPING.
  106.  
  107. THIS SOFTWARE MAY BE USED BY ANY NUMBER OF PEOPLE AND MOVED FROM ONE COMPUTER
  108. TO ANOTHER SO LONG AS THERE IS NO POSSIBILITY OF IT BEING USED ON MORE THAN ONE
  109. COMPUTER AT THE SAME TIME.
  110.  
  111. THE PURCHASE CAN HAVE THIS SOFTWARE INSTALLED ON A HOME PC AND A WORK PC
  112. AT THE SAME TIME SO HE CAN TAKE HIS WORK HOME.
  113.  
  114. THE PURCHASER ALSO AGREES NOT TO DISASSEMBLE OR DECODE THE SCREEN DESIGN
  115. PROGRAMS, OR DUPLICATE THE LOOK AND FEEL OF THIS SOFTWARE.
  116.  
  117. THE PURCHASER AGREES THAT DAN CHOPPING CAN TRANSFER THE COPYRIGHT OF THE
  118. SOFTWARE TO ANYONE AT ANY TIME.
  119.  
  120. DAN CHOPPING RESERVES THE RIGHT TO MAKE CHANGES TO THIS SCREEN DESIGN SOFTWARE
  121. AND MANUAL WITHOUT OBLIGATION TO NOTIFY ANY PERSONS OR ORGANIZATIONS OF SUCH
  122. CHANGES.
  123.  
  124. MULTIPLE COPIES DISCOUNTS AND SOURCE CODE ARE AVAILABLE.
  125.  
  126. NP
  127.                                 ************
  128.                                 * WARRANTY *
  129.                                 ************
  130.  
  131.  
  132. DISCLAIMER OF ALL WARRANTIES
  133. ----------------------------
  134. THIS SOFTWARE IS SOLD "AS-IS" WITH NO OTHER WARRANTIES EXPRESSED OR IMPLIED.
  135.  
  136. THERE IS NO WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  137.  
  138. BECAUSE OF THE DIVERSITY OF HARDWARE AND SOFTWARE THE USER IS ADVISED TO TEST
  139. THIS SOFTWARE THOROUGHLY BEFORE RELYING ON IT. 
  140.  
  141. THE USER MUST ASSUME THE ENTIRE RISK OF USING THIS SOFTWARE. 
  142.  
  143. THE PURCHASER AGREES THAT DAN CHOPPING AND/OR SELLER IS NOT RESPONSIBLE FOR ANY
  144. HARDWARE OR SOFTWARE DAMAGE CAUSED BY THIS SOFTWARE OR DISTRIBUTION DISKETTES.
  145.  
  146. DAN CHOPPING AND/OR SELLER SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO ANY ONE
  147. IN RESPECT TO LIABILITY, LOSS OR DAMAGE DIRECTLY OR INDIRECTLY ARISING OUT OF
  148. THE USE OF THE DISTRIBUTION DISKETTE OR SOFTWARE. THIS INCLUDES, BUT IS NOT
  149. LIMITED TO, ANY LOSS OF BUSINESS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES.
  150.  
  151. TRADEMARKS
  152. ----------
  153. IBM, IBM-PC, IBM-XT, IBM-AT AND IBM-PROPRINTER ARE REGISTER TRADEMARKS OF 
  154. INTERNATIONAL BUSINESS MACHINES CORPORATION.
  155.  
  156. NCR, VRX, NCR VRX, I SYSTEM, AND OLPD ARE TRADEMARKS OF NATIONAL CASH REGISTER
  157. CORPORATION.
  158.  
  159. MS-DOS IS A TRADEMARK OF MICROSOFT CORPORATION.
  160.  
  161. TURBO BASIC IS A TRADEMARK OF BORLAND INTERNATIONAL INCORPORATED.
  162.  
  163. COBOL AND BASIC ARE INDUSTRY LANGUAGES AND ARE NOT PROPERTY OF ANY ONE COMPANY.
  164.  
  165. EPSON IS A TRADEMARK OF EPSON CORPORATION.
  166.  
  167. ANZIO IS A TRADE MARK OF RASMUSSEN AND ASSOCIATES.
  168.  
  169. APOLOGIZE FOR ANY UNINTENTIONAL MISTAKES OR OMISSIONS.
  170.  
  171. NP
  172.                            **********************
  173.                            * THE SDMENU PROGRAM *
  174.                            **********************
  175.  
  176. SDMENU ALLOWS THE USER TO SWITCH QUICKLY AND EASILY BETWEEN THE DIFFERENT
  177. SCREEN DESIGN PROGRAMS. WHEN SDMENU CALLS THE OTHER PROGRAMS IN THE SCREEN
  178. DESIGN SOFTWARE PACKAGE, IT PASSES THE COMMAND LINE INFORMATION REQUIRED FOR
  179. THE OTHER PROGRAMS TO FIND THE SCREEN DESIGN CONFIGURATION FILE.
  180.  
  181. LOADING SDMENU
  182. --------------
  183. THE SDMENU PROGRAM IS CALLED FROM THE DOS PROMPT. WHEN SDMENU IS CALLED, THE
  184. DOS COMMAND LINE MUST CONTAIN THE SUBDIRECTORY INFORMATION REQUIRED FOR THE
  185. PROGRAMS TO FIND THE SCREEN DESIGN CONFIGURATION FILE. THIS COMMAND LINE PATH
  186. INFORMATION IS THEN PASSED TO ALL OTHER SCREEN DESIGN PROGRAMS. THE USER IS NOT
  187. REQUIRED TO USE SDMENU TO CALL UP ANY OTHER SCREEN DESIGN PROGRAMS. 
  188.  
  189. EXAMPLES:
  190.        SDMENU C:\SD 
  191.    OR
  192.        SDEDIT C:\SD   
  193.  
  194. IF THE SCREEN DESIGN CONFIGURATION FILE IS IN THE DEFAULT DIRECTORY, NO COMMAND
  195. LINE INFORMATION IS ENTERED.
  196.  
  197. EXAMPLES:
  198.      SDMENU
  199. OR
  200.      SDMENU C:\SD
  201.  
  202. THE AUTHOR RECOMMENDS THE USER CREATE A BAT FILE AND PUT IT INTO A DIRECTORY
  203. THAT HAS BEEN DESIGNATED BY THE PATH DOS COMMAND. THE USER THEN ONLY NEEDS TO
  204. ENTER THE BAT FILE NAME TO LOAD THE SCREEN DESIGN SOFTWARE FROM ANY DISK AND
  205. SUBDIRECTORY.  FOR EXAMPLE THE USER COULD CREATE A SDM.BAT FILE TO INSTRUCT DOS
  206. TO ACCESS C:\SD SUBDIRECTORY. 
  207. THE PROCEDURE IS AS FOLLOWS:
  208.  
  209. 1. INSERT SCREEN DESIGN FLEX DISK IN THE A FLEX DRIVE.
  210. 2. ENTER <C:> TO ACCESS THE HARD DISK.
  211. 3. ENTER <MKDIR SD> TO CREATE A SCREEN DESIGN SUBDIRECTORY.
  212. 4. ENTER <CD SD> TO ENTER THE SCREEN DESIGN SUBDIRECTORY.
  213. 5. ENTER <COPY A:*.* /V> TO COPY SCREEN DESIGN SOFTWARE 
  214.    INTO SUBDIRECTORY.
  215. 6. ENTER <CD ..> TO EXIT SUBDIRECTORY.
  216. 7. ENTER <CD DOS> TO GO INTO DOS SUBDIRECTORY.
  217. 8. CREATE SDM.BAT FILE BY ENTERING <EDLIN SDM.BAT>
  218. 9. ENTER <#I> TO ENTER EDLIN'S ADD MODE.
  219. 10. ENTER <C:\SD\SDMENU.COM C:\SD\> TO CREATE COMMAND LINE.
  220. 11. ENTER <CTRL Z> TO EXIT EDLIN'S ADD MODE.
  221. 12. ENTER <E> TO EXIT EDLIN.
  222. 13. ENTER <CD ..> TO EXIT DOS SUBDIRECTORY.
  223. 14. ENTER <SDM> TO CALL UP SCREEN DESIGN SOFTWARE.
  224.  
  225. NP
  226.                            **********************
  227.                            * THE SDEDIT PROGRAM *
  228.                            **********************
  229.  
  230. THE SDEDIT PROGRAM IS USED TO CREATE, EDIT AND PRINT SCREEN LAYOUTS. USE SDEDIT
  231. TO DEVELOP YOUR SCREEN LAYOUTS. SDCOBOL  HAS VERY LIMITED SCREEN EDITOR
  232. FUNCTIONS.
  233.  
  234. LOADING SDEDIT
  235. --------------
  236. THE SDEDIT PROGRAM CAN BE CALLED FROM THE SDMENU PROGRAM OR FROM THE DOS
  237. PROMPT. WHEN SDEDIT IS CALLED FROM THE DOS PROMPT, THE DOS COMMAND LINE MUST
  238. CONTAIN THE SUBDIRECTORY INFORMATION REQUIRED FOR SDEDIT TO FIND THE SCREEN
  239. DESIGN CONFIGURATION FILE. 
  240.  
  241. EXAMPLE: SDEDIT C:\SD
  242.  
  243. IF THE SCREEN DESIGN CONFIGURATION FILE IS IN THE DEFAULT DIRECTORY, NO COMMAND
  244. LINE INFORMATION IS ENTERED. IF SDEDIT IS UNABLE TO FIND THE SCREEN DESIGN
  245. CONFIGURATION FILE THE USER WILL BE ASKED TO CONTINUE THE EDIT SESSION. 
  246. ENTERING <N> WILL CAUSE THE  SDEDIT PROGRAM TO TERMINATE. ENTERING <Y> WILL
  247. CAUSE THE SDEDIT TO USE DEFAULT VALUES.
  248.  
  249. THE SDEDIT EDITOR
  250. -----------------
  251. SDEDIT'S EDITOR IS DESIGNED TO CREATE SCREEN LAYOUTS. IF YOU ARE FAMILIAR WITH
  252. TEXT PROCESSING EDITORS, YOU CAN EASY LEARN HOW TO USE SDEDIT. SDEDIT USES LINE
  253. 25 AS ITS STATUS LINE. LINE 25 IS ALSO USED FOR DIALOG BETWEEN THE USER AND THE
  254. PROGRAM WHEN FUNCTION KEY OPERATIONS ARE BEING PERFORMED. LINES 1 TO 24 SHOW
  255. THE SCREEN LAYOUT BEING EDITED. 
  256.  
  257. NP
  258. CURSOR MOVEMENT KEYS
  259. --------------------
  260. THE FOLLOWING TABLE SHOWS THE LIST OF CURSOR MOVEMENT KEYS AVAILABLE IN THE
  261. SDEDIT PROGRAM.
  262.  
  263. EDITOR COMMANDS
  264. -----------------------------------------------------------
  265. LEFT ARROW        MOVE CURSOR LEFT 1 CHARACTER
  266. CTRL LEFT ARROW        MOVE TO COLUMN 1 OF CURRENT LINE
  267. RIGHT ARROW        MOVE CURSOR RIGHT 1 CHARACTER
  268. CTRL RIGHT ARROW    MOVE CURSOR TO COLUMN 80 OF CURRENT 
  269.             LINE
  270. UP ARROW        MOVE CURSOR UP 1 LINE
  271. DOWN ARROW        MOVE CURSOR DOWN 1 LINE
  272. ENTER KEY        MOVE CURSOR TO COLUMN 1 OF NEXT 
  273.             LINE
  274. HOME KEY        MOVE CURSOR TO LINE 1 CURRENT 
  275.             COLUMN
  276. END KEY            MOVE CURSOR TO LINE 24 CURRENT 
  277.             COLUMN
  278. BACKSPACE KEY         DELETE CURRENT CHARACTER AND 
  279.                         MOVE CURSOR LEFT 1 CHARACTER
  280. DELETE KEY        DELETE THE CURRENT CHARACTER
  281. FORWARD TAB             MOVE CURSOR TO 1ST SPACE
  282.                         CHARACTER AFTER THE NEXT CHARACTER STRING
  283. REVERSE TAB             MOVE CURSOR TO 1ST SPACE BEFORE CHARACTER OF
  284.                         PREVIOUS CHARACTER (SHIFT TAB)
  285. -----------------------------------------------------------
  286.  
  287. LINE 25 STATUS LINE
  288. -------------------
  289.  
  290. L XX C XX
  291. ---------
  292. LINE 25 COLUMNS 2 THRU 10 DISPLAYS THE CURSOR'S LINE AND COLUMN POSITION. 
  293.  
  294. INS / OVR
  295. ----------
  296. DISPLAYS IN COLUMNS 12 THRU 14 OF LINE 25 WHETHER THE EDITOR IS IN INSERT OR
  297. OVERSTRIKE MODE. PRESSING THE <INS> KEY WILL SWITCH THE EDITOR BETWEEN THE
  298. INSERT AND OVERSTRIKE MODE.
  299.  
  300. INSERT MODE ALLOWS YOU TO TYPE CHARACTERS IN ANYWHERE, WITHOUT LOSING ANY
  301. CHARACTERS TO THE RIGHT OF THE CURSOR.
  302. WHEN THE EXISTING TEXT IS PUSHED INTO COLUMN 80 OF THE CURSOR LINE THE EDITOR
  303. WILL SOUND THE BELL.
  304.  
  305. CHARACTERS TYPED IN OVERSTRIKE MODE WILL REPLACE THE CHARACTER UNDER THE
  306. CURSOR. 
  307.  
  308. NP
  309. B XX XX XX
  310. ----------
  311. LINE 25 COLUMNS 16 THRU 24 DISPLAYS THE LINE NUMBER, AND BEGINNING AND ENDING
  312. COLUMN NUMBERS OF THE MARKED BLOCK.
  313. THE MARKED BLOCK WILL NOT BE HIGHLIGHTED UNTIL A BLOCK OPERATION IS PERFORMED.
  314.  
  315. 1MB THRU 10EXIT
  316. ---------------
  317. LINE 25 COLUMNS 25 THRU 66 DISPLAYS THE HELP MENU FOR FUNCTION KEY OPERATION
  318. EXPLAINED BELOW.
  319.  
  320. FUNCTION KEY TABLE
  321. -----------------------------------------------------------
  322. F1           MARK BLOCK BEGIN
  323. F2           MARK BLOCK END
  324. F3           COPY MARKED BLOCK
  325. F4           SWAP MARKED BLOCK
  326. F5           INSERT LINE (LEFT/RIGHT/LINE)
  327. F6           DELETE LINE (LEFT/RIGHT/LINE)
  328. F7           ZAP SCREEN DATA (LEFT/RIGHT/LINE/ABOVE/BELOW)
  329. F8           JUSTIFY LINE (LEFT/RIGHT/CENTER)
  330. F9           PRINT OR MAP SCREEN
  331. F10          SAVE SCREEN AND/OR EXIT PROGRAM
  332. SHIFT F1     CREATE "x" TYPE FIELD
  333. SHIFT F2     DISPLAY FIELD SIZE
  334.              IF CURSOR IS ON A SPACE " "
  335.                  HOW MANY CHARACTERS TO NEXT FIELD OR END OF SCREEN
  336.              IF CURSOR IS ON A NON SPACE CHARATER
  337.                  HOW MANY CHARACTERS IN THE FIELD
  338. -----------------------------------------------------------
  339.  
  340. XXXXXXXX.XXX
  341. ------------
  342. LINE 25 COLUMN 68 THRU 79 DISPLAYS THE FILE NAME FOR THE SCREEN BEING EDITED.
  343.  
  344.  
  345.                                BLOCK COMMANDS
  346.                                --------------
  347.  
  348. F1 MARK BLOCK BEGIN
  349. -------------------
  350. MARKS THE BEGINNING OF A BLOCK. THE END OF THE MARKED BLOCK IS DEFAULTED TO
  351. COLUMN 80 UNLESS THE F2 MARK BLOCK END KEY IS USED. ONLY 1 LINE OF TEXT CAN BE
  352. MARKED AT TIME. THE LINE AND COLUMNS OF THE MARKED BLOCK ARE DISPLAYED ON LINE
  353. 25 COLUMNS 16 THRU 24. COLUMNS 17 AND 18 SHOWS THE MARKED LINE NUMBER. COLUMNS
  354. 20 AND 21 DISPLAYS THE BEGINNING COLUMN OF THE MARKED BLOCK. COLUMNS 23 AND 24
  355. DISPLAYS THE ENDING COLUMN NUMBER OF THE MARKED BLOCK.
  356.  
  357. F2 MARK BLOCK END
  358. -----------------
  359. MARKS THE ENDING OF A BLOCK. ONLY TEXT ON 1 LINE CAN MARKED AT A TIME. THE END
  360. OF A MARKED BLOCK MUST BE ON THE SAME LINE AS THE MARK BLOCK BEGIN AND BE TO
  361. THE RIGHT OF THE BLOCK BEGIN COLUMN ELSE A BEEP WILL SOUND. 
  362.  
  363. F3 COPY MARKED BLOCK
  364. --------------------
  365. COPIES THE MARKED BLOCK DATA TO THE CURSOR'S LINE AND COLUMN. THE LENGTH OF THE
  366. COPY IS THE SHORTER OF THE LENGTHS; THE MARKED BLOCK, OR 80 MINUS THE CURRENT
  367. CURSOR POSITION. THE SCREEN DISPLAYS HOW THE SCREEN WILL APPEAR IF THE COPY
  368. OPERATION IS PERFORMED. BOTH THE COPY FROM BLOCK AND THE COPY TO AREA OF THE
  369. SCREEN ARE HIGHLIGHTED. TO COMPLETE THE COPY OPERATION ENTER <Y> TO THE COPY
  370. BLOCK MESSAGE. TO ABORT THE COPY OPERATION ENTER <N>.
  371.  
  372. F4 SWAP MARKED BLOCK
  373. --------------------
  374. SWAPS THE MARKED BLOCK DATA WITH THE DATA STARTING AT THE CURSOR'S LINE AND
  375. COLUMN. THE LENGTH OF THE SWAP IS THE SHORTER OF THE LENGTHS; THE MARKED BLOCK,
  376. OR 80 MINUS THE CURRENT CURSOR'S POSITION. THE SCREEN DISPLAYS HOW THE SCREEN
  377. WILL APPEAR IF THE SWAP OPERATION IS PERFORMED. BOTH THE SWAP FROM BLOCK AND
  378. THE SWAP TO AREA OF THE SCREEN ARE HIGHLIGHTED. TO COMPLETE THE SWAP OPERATION
  379. ENTER <Y> TO THE SWAP MESSAGE. TO ABORT THE SWAP OPERATION ENTER <N>.
  380.  
  381. LINE SWAP FEATURE  
  382. -----------------
  383. ALLOWS THE USER TO SWAP THE TEXT TO THE LEFT OF THE CURSOR'S POSITION WITH THE
  384. TEXT TO THE RIGHT OF THE CURSOR ON THE SAME LINE. TO USE THIS LINE SWAP FEATURE
  385. POSITION THE CURSOR AT COLUMN 1 OF THE LINE TO SWAP AND PRESS <F1>. MOVE THE
  386. CURSOR TO THE LAST COLUMN OF THE LINE TO BE SWAPPED AND PRESS <F2>. MOVE THE
  387. CURSOR RIGHT 1 COLUMN BY PRESSING THE <RIGHT ARROW> KEY. PRESS <F4> TO PERFORM
  388. THE SWAP. ENTER <Y> TO THE SWAP MESSAGE.
  389.  
  390. TO SWAP COLUMNS 1 THRU 20 OF LINE 3 WITH COLUMNS 21 THRU 80 OF LINE 3 DO THE
  391. FOLLOWING: 
  392. 1. MOVE CURSOR TO LINE 3 COLUMN 1. PRESS <F1> TO MARK THE   
  393.    BLOCK. 
  394. 2. MOVE CURSOR TO LINE 3 COLUMN 20 AND PRESS <F2> MARKING 
  395.    THE END OF THE BLOCK. 
  396. 3. MOVE THE CURSOR TO LINE 3 COLUMN 21 BY PRESSING THE 
  397.    <RIGHT ARROW> KEY. 
  398. 4. PRESS <F4> TO PERFORM THE LINE SWAP. 
  399. 5. ENTER <Y> TO THE SWAP HIGHLIGHTED BLOCKS. 
  400.  
  401. THE DATA FROM COLUMNS 21 THRU 80 WILL BE MOVED TO COLUMNS 1 THRU 60, AND THE
  402. TEXT FROM COLUMNS 1 THRU 20 WILL BE MOVED TO COLUMNS 61 THRU 80.
  403.  
  404. F5 INSERT LINE
  405. --------------
  406. ALLOWS THE USER TO INSERT A BLANK LINE TO THE LEFT OF THE CURSOR, RIGHT OF THE
  407. CURSOR, OR A COMPLETE BLANK LINE ABOVE THE CURSOR'S LINE. IF THE CURSOR IS AT
  408. COLUMN 1 OR COLUMN 80, ONLY A COMPLETE LINE INSERT IS ALLOWED.  IF THE CURSOR
  409. IS NOT AT COLUMN 1 OR COLUMN 80 THE EDITOR ALLOWS THE USER TO PERFORM A LINE
  410. SPLIT INSERT. ENTERING <L> TO THE INSERT LINE MESSAGE MOVES THE LINE LEFT OF
  411. THE CURSOR POSITION INCLUSIVE DOWN 1 LINE AND A PARTIAL BLANK LINE IS INSERTED.
  412. ENTERING <R> TO THE INSERT LINE MESSAGE MOVES THE LINE RIGHT OF THE CURSOR
  413. POSITION INCLUSIVE DOWN 1 LINE AND A PARTIAL BLANK LINE IS INSERTED. ENTERING
  414. <Y> TO THE INSERT LINE MESSAGE INSERTS A COMPLETE BLANK LINE ABOVE THE CURSOR'S
  415. LINE REGARDLESS OF THE CURSOR'S COLUMN POSITION.
  416.  
  417. NP
  418. WHEN A LINE IS INSERTED AND THE EDITOR PUSHES LINE 24 OFF OF THE SCREEN, IT
  419. REMAINS IN A BUFFER AND WILL REAPPEAR A IF LINE DELETION IS MADE. A MAXIMUM OF
  420. 6 LINES ARE SAVED IN THE BUFFER.
  421.  
  422. F6 DELETE LINE
  423. --------------
  424. THE F6 FUNCTION KEY ALLOWS THE USER TO DELETE THE LINE TO THE LEFT OF THE
  425. CURSOR, RIGHT OF THE CURSOR, OR THE COMPLETE CURSOR LINE. IF THE CURSOR IS AT
  426. COLUMN 1 OR COLUMN 80, ONLY THE COMPLETE LINE DELETE IS ALLOWED.  IF THE CURSOR
  427. IS NOT AT COLUMN 1 OR COLUMN 80 THE EDITOR ALLOWS THE USER TO DO A SPLIT LINE
  428. DELETION. ENTERING <L> TO THE DELETE LINE MESSAGE DELETES THE LINE LEFT OF THE
  429. CURSOR POSITION INCLUSIVE AND ALL TEXT BELOW IS MOVED UP ONE LINE. ENTERING <R>
  430. DELETES ALL TEXT RIGHT OF THE CURSOR POSITION INCLUSIVE AND MOVES ALL TEXT
  431. BELOW THE CURSOR UP 1 LINE. ENTERING <Y> TO THE DELETE LINE MESSAGE DELETES A
  432. COMPLETE LINE REGARDLESS OF THE CURSOR'S COLUMN POSITION. 
  433.  
  434. WHEN A LINE IS DELETED AND THE EDITOR MOVES LINE 24 UP A LINE, THE LAST LINE
  435. PUSHED INTO THE BUFFER WILL REAPPEAR.
  436.  
  437. F7 ZAP
  438. -------
  439. ALLOWS THE USER TO ERASE ALL TEXT ABOVE, BELOW, LEFT OF CURSOR, RIGHT OF
  440. CURSOR, OR ERASE THE CURSOR LINE. THE ZAP FUNCTION DOES NOT DELETE OR INSERT
  441. LINES, IT JUST RESETS THEM TO SPACES. ENTERING <A> WILL ERASE ALL LINES ABOVE,
  442. AND ALL TEXT TO THE LEFT OF THE CURSOR. ENTERING <L> WILL ERASE ALL TEXT TO THE
  443. LEFT OF THE CURSOR INCLUSIVE ON CURSOR LINE ONLY. ENTERING <B> ERASES ALL LINES
  444. BELOW THE CURSOR AND ALL TEXT TO THE RIGHT OF THE CURSOR INCLUSIVE. ENTERING
  445. <Y> WILL ERASE ALL TEXT ON THE CURSOR'S LINE.
  446.  
  447. F8 JUSTIFY TEXT
  448. ---------------
  449. ALLOWS THE USER TO LEFT JUSTIFY, RIGHT JUSTIFY, OR CENTER THE CURSOR'S LINE.
  450. THIS ALLOWS THE USER TO CENTER HEADINGS. PRESS THE <F8> FUNCTION KEY AND ENTER
  451. THE DESIRED OPTION. ENTERING <L> WILL PLACE THE FIRST NONSPACE CHARACTER OF THE
  452. LINE IN COLUMN 1. ENTERING <R> WILL PLACE THE LAST NONSPACE CHARACTER IN COLUMN
  453. 80. ENTERING <C> WILL CENTER THE TEXT.
  454.  
  455. F9 PRINT OR MAP SCREEN
  456. ----------------------
  457. ALLOWS THE USER TO PRINT OR MAP THE SCREEN. THE SCREEN CAN BE PRINTED OR MAPPED
  458. TO THE PRINTER OR A DISK FILE. THE DISK FILE OPTIONS PERMITS THE USER TO USE A
  459. SIDEWAYS PRINT PROGRAM, OR LOAD THE SCREEN INTO A WORD PROCESSOR DOCUMENT.
  460.  
  461. THE <P> PRINT SCREEN OPTION PRINTS THE SCREEN WITH DATE AND TIME AND BORDERS
  462. ABOVE AND BELOW ONLY. THIS ALLOWS THE USER TO PRINT THE SCREEN IN PICA MODE ON
  463. A NARROW CARRIAGE PRINTER. 
  464.  
  465. THE <B> PRINT OPTION PRINTS A COMPLETE BORDER AROUND THE SCREEN. NARROW
  466. CARRIAGE PRINTERS MUST BE IN ELITE OR COMPRESS PRINT MODE. WIDE CARRIAGE
  467. PRINTERS CAN PRINT THE SCREEN IN PICA. A BOARDER PRINT CONTAINS 82 CHARACTERS.
  468.  
  469. THE <M> PRINT OPTION OUTPUTS THE SCREEN WITH EACH CHARACTER PRINTED INSIDE A
  470. BOX. THE MAP IS SIMILAR TO CREATING A SCREEN LAYOUT ON A COBOL CODING FORM. TO
  471. PRINT DIRECTLY TO A PRINTER THE PRINTER MUST BE A WIDE CARRIAGE.
  472.  
  473. IF PRINTING IS SENT TO A DISK FILE, AND A SIDEWAYS PROGRAM IS DESIGNATED IN THE
  474. SCREEN DESIGN CONFIGURATION FILE, SDEDIT ASKS IF THE SIDEWAYS PROGRAM IS TO BE
  475. CALLED AFTER THE SDEDIT PRINT PROCESS IS COMPLETE.
  476.  
  477. F10 SAVE AND/OR EXIT
  478. --------------------
  479. THE F10 FUNCTION KEYS ALLOWS THE USER TO SAVE THE SCREEN TO DISK AND/OR EXIT
  480. THE PROGRAM. PRESSING ONLY THE <ENTER> KEY AT THE SAVE/EXIT MESSAGE WILL RETURN
  481. THE USER TO THE EDIT SESSION. PRESSING THE <S> KEY INSTRUCTS SDEDIT TO SAVE THE
  482. SCREEN TO DISK AND RETURN TO THE EDIT PROCESS. PRESSING THE <X> KEY INSTRUCTS
  483. SDEDIT TO SAVE THE SCREEN TO DISK AND TO EXIT THE PROGRAM. PRESSING <C> WILL
  484. CAUSE THE PROGRAM TO SAVE THE SCREEN UNDER ANOTHER NAME AND EXIT THE EDIT
  485. SESSION. ENTERING <Q> WILL CAUSE THE PROGRAM TO TERMINATE WITHOUT SAVING THE
  486. SCREEN.
  487.  
  488. SHIFT F1 "x" FIELD
  489. -------------------
  490. THE SHIFT F1 FUNCTION KEY COMBINATION PERMITS THE USER TO CREATE A FIELD
  491. OF SMALL "x"s. THE SMALL "x" IS USED IN SDCOBOL TO DEFINE A COBOL
  492. ALPHA-NUMERIC FIELD AS COMPARED TO A SCREEN LITERAL. SDEDIT DETERMINES
  493. THE MAXIMUM FIELD SIZE AVAILABLE. PRESSING THE <ENTER> KEY WITHOUT
  494. ENTERING A FIELD SIZE WILL ABORT THE "x" FIELD PROCESS. THE OPERATOR
  495. ALSO HAS A OPTION TO REJECT THE "x" DEFINITION AFTER IT IS DISPLAYED
  496. ON THE SCREEN.
  497.  
  498. SHIFT F2 FIELD SIZE
  499. --------------------
  500. THE SHIFT F2 FUNCTION KEY IS USED TO DETERMINE THE SIZE OF A FIELD OR
  501. A CHARACTER STRING OF SPACES. THIS FUNCTION IS USED TO MAKE SURE THAT
  502. DEFINED SCREEN FIELDS ARE THE PROPER SIZE. THE FIELD SIZE FUNCTION CAN
  503. ALSO BE USED TO DETERMINE STRING LENGTHS FOR NON COBOL SCREEN DEFINITION.
  504. NP
  505. DEFINING FIELDS FOR SDCOBOL
  506. ---------------------------
  507. THE SDCOBOL PROGRAM GENERATES WORKING-STORAGE SCREEN DEFINITIONS FROM A SCREEN
  508. CREATED BY THE SDEDIT PROGRAM. MOST HIGH SPEED MAINFRAME PRINTERS CAN ONLY
  509. PRINT CAPITAL LETTERS THEREFORE, SDCOBOL LOOKS FOR LOWER CASE CHARACTERS FOR
  510. FIELD DEFINITIONS AND CONVERTS THEM AT COBOL SCREEN GENERATION TIME. 
  511.  
  512. COBOL "X" TYPE ALPHA-NUMERIC FIELDS ARE DEFINED IN THE SCREEN DESIGN PROGRAMS
  513. AS A LOWER CASE "x".
  514.  
  515. COBOL NUMERIC FIELD ALSO USE LOWER CASE LETTERS AS PART OF THEIR FIELD
  516. DEFINITIONS. BECAUSE THERE IS NO LOWER CASE EQUIVALENT OF THE "9" CHARACTER THE
  517. "#" IS SUBSTITUTED. ALL NUMERIC FIELDS MUST BEGIN WITH ONE THE FOLLOWING
  518. CHARACTERS; "z", "#", OR "$". THE TABLE BELOW SHOWS CHARACTERS ALLOWED IN A
  519. COBOL NUMERIC FIELD.
  520.  
  521. SYMBOL        DESCRIPTION
  522. ----------------------------------------------------------
  523. "#"        NOT ZERO SUPPRESSED NUMERIC CHARACTER
  524. "z"        SUPPRESS LEADING ZERO NUMERIC CHARACTER
  525. "$"        FLOATING DOLLAR SIGN
  526. "."        DECIMAL POINT            
  527. ","        COMMA INSERTION CHARACTER
  528. "cr"        CREDIT AMOUNT
  529. "db"        DEBIT AMOUNT        
  530. "+"        POSITIVE AMOUNT
  531. "-"        NEGATIVE AMOUNT
  532. "/"        DATE INSERTION CHARACTER
  533. ----------------------------------------------------------
  534.  
  535.  
  536. SDCOBOL FIELD DESCRIPTION EXAMPLES
  537. -----------------------------------------------------------
  538. xxxxxxxxxx    TEN CHARACTER ALPHA/NUMERIC FIELD
  539. #####        FIVE CHARACTER NUMERIC FIELD
  540. zzzz#        ZERO SUPPRESSED NUMERIC FIELD
  541. zzz,zz#.##    ZERO SUPPRESSED NUMERIC FIELD WITH DECIMALS
  542. $$$,$$#.##    DOLLAR AMOUNT NUMERIC FIELD
  543. $$$,$$#.##cr    CREDIT DOLLAR AMOUNT
  544. $$$,$$#.##db    DEBIT DOLLAR AMOUNT
  545. zzzzz        BLANK WHEN ZERO NUMERIC FIELD
  546. ##/##/##    DATE FIELD
  547. -----------------------------------------------------------
  548.  
  549. FIELDS NOT FOLLOWING THE ABOVE RESTRICTIONS CAN BE EASY CONVERTED TO COBOL
  550. FIELDS BY USING THE F1 FUNCTION KEY IN SDCOBOL.
  551. NP
  552.                            ***********************
  553.                            * THE SDCOBOL PROGRAM *
  554.                            ***********************
  555.  
  556. THE SDCOBOL PROGRAM IS USED TO GENERATE COBOL WORKING-STORAGE SECTION SCREEN
  557. LAYOUTS. THE OUTPUT FILE FROM THIS SCREEN GENERATOR CAN BE COPIED INTO A PC
  558. COBOL PROGRAM OR UPLOADED TO A MAINFRAME BY USING A MAINFRAME COMMUNICATION
  559. PROGRAM. SDCOBOL HAS VERY LIMITED SCREEN EDITOR FUNCTIONS.
  560.  
  561.          SDCOBOL CAN TURN THIS SCREEN INTO THE FOLLOWING COBOL CODE.
  562. --------------------------------------------------------------------------------
  563. PAYID                      PAYROLL EMPLOYEE ID SCREEN                  SCREEN ID
  564.  
  565. LAST NAME (1) xxxxxxxxxxxxxxxxxxxxxxxx            ASSIGNED SCHOOL (17) zzz#
  566. FIRST NAME (2) xxxxxxxxxxxxxxxxxx                 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  567. SSN (3) ###-##-####                               PAYCHECK DEST    (18) x xxxx
  568. SEX (4) x                                         xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  569. DATE OF BIRTH (5) ##-##-#### AGE zz#              NEXT PAYCHECK DEST (19) x xxxx
  570. RACE (6) xx xxxxx                            (21) xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  571.                                              (22) xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  572. MAILING (7) xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   (23) xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  573. ADDRESS (8) xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   (24) xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  574.         (9) xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx   (25) xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  575.        (10) xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  576. STATE  (11) xx ZIP CODE (12) #####-####
  577. HOME PHONE (13) (###) ###-####
  578. EMERGENCY PHONE (14) (###) ###-#### EXT ####
  579. CONTACT NAME (15) xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  580. COMPANY (16) xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  581.  
  582.  
  583.  
  584. ENTER SCREEN ID, FIELD NO TO CHANGE, S TO SELECT, OR X TO EXIT xx
  585.  
  586.  
  587. --------------------------------------------------------------------------------
  588.  
  589. 000100* * * * * * * * * * * * * * * * * *
  590. 000110 01  PAYID-SCREEN.
  591. 000120* * * * * * * * * * * * * * * * * *
  592. 000130*
  593. 000140     05  PAYID-SCREEN-LINE-1.
  594. 000150         10  FILLER PIC X(20) VALUE "PAYID               ".
  595. 000160         10  FILLER PIC X(7) VALUE SPACES.
  596. 000170         10  FILLER PIC X(20) VALUE "PAYROLL EMPLOYEE ID ".
  597. 000180         10  FILLER PIC X(20) VALUE "SCREEN              ".
  598. 000190         10  FILLER PIC X(13) VALUE "    SCREEN ID".
  599. 000200*
  600. 000210     05  PAYID-SCREEN-LINE-2.
  601. 000220         10  FILLER PIC X(80) VALUE SPACES.
  602. 000230*
  603. 000240     05  PAYID-SCREEN-LINE-3.
  604. 000250         10  FILLER PIC X(14) VALUE "LAST NAME (1) ".
  605. 000260         10  LINE-3-COLUMN-15.
  606. 000270             15  CRT-LAST-NAME PIC X(24) VALUE SPACES.
  607. 000280         10  FILLER PIC X(12) VALUE SPACES.
  608. 000290         10  FILLER PIC X(20) VALUE "ASSIGNED SCHOOL (17)".
  609. 000300         10  FILLER PIC X(1) VALUE SPACES.
  610. 000310         10  LINE-3-COLUMN-72.
  611. 000320             15  CRT-ASSIGNED-SCHOOL-CODE PIC ZZZ9 VALUE ZEROS.
  612. 000330         10  FILLER PIC X(5) VALUE SPACES.
  613. 000340*
  614. 000350     05  PAYID-SCREEN-LINE-4.
  615. 000360         10  FILLER PIC X(15) VALUE "FIRST NAME (2) ".
  616. 000370         10  LINE-4-COLUMN-16.
  617. 000380             15  CRT-FIRST-NAME PIC X(18) VALUE SPACES.
  618. 000390         10  FILLER PIC X(17) VALUE SPACES.
  619. 000400         10  LINE-4-COLUMN-51.
  620. 000410             15  CRT-ASSIGNED-SCHOOL-NAME PIC X(30) VALUE SPACES.
  621. 000420*
  622. 000430     05  PAYID-SCREEN-LINE-5.
  623. 000440         10  FILLER PIC X(8) VALUE "SSN (3) ".
  624. 000450         10  LINE-5-COLUMN-9.
  625. 000460             15  CRT-SSN-1 PIC 999 VALUE ZEROS.
  626. 000470         10  FILLER PIC X(1) VALUE "-".
  627. 000480         10  LINE-5-COLUMN-13.
  628. 000490             15  CRT-SSN-2 PIC 99 VALUE ZEROS.
  629. 000500         10  FILLER PIC X(1) VALUE "-".
  630. 000510         10  LINE-5-COLUMN-16.
  631. 000520             15  CRT-SSN-3 PIC 9999 VALUE ZEROS.
  632. 000530         10  FILLER PIC X(31) VALUE SPACES.
  633. 000540         10  FILLER PIC X(20) VALUE "PAYCHECK DEST    (18".
  634. 000550         10  FILLER PIC X(2) VALUE ") ".
  635. 000560         10  LINE-5-COLUMN-73.
  636. 000570             15  CRT-PAYCHECK-DESTINATION-CODE PIC X(1) 
  637. 000580                     VALUE SPACES.
  638. 000590         10  FILLER PIC X(1) VALUE SPACES.
  639. 000600         10  LINE-5-COLUMN-75.
  640. 000610             15  CRT-PAYCHECK-DEST-DESC PIC X(4) VALUE SPACES.
  641. 000620         10  FILLER PIC X(2) VALUE SPACES.
  642. 000630*
  643. 000640     05  PAYID-SCREEN-LINE-6.
  644. 000650         10  FILLER PIC X(8) VALUE "SEX (4) ".
  645. 000660         10  LINE-6-COLUMN-9.
  646. 000670             15  CRT-SEX PIC X(1) VALUE SPACES.
  647. 000680         10  FILLER PIC X(41) VALUE SPACES.
  648. 000690         10  LINE-6-COLUMN-51.
  649. 000700             15  CRT-PAYCHECK-DESTN-NAME PIC X(30) VALUE SPACES.
  650. 000710*
  651. 000720     05  PAYID-SCREEN-LINE-7.
  652. 000730         10  FILLER PIC X(18) VALUE "DATE OF BIRTH (5) ".
  653. 000740         10  LINE-7-COLUMN-19.
  654. 000750             15  CRT-DATE-OF-BIRTH-MONTH PIC 99 VALUE ZEROS.
  655. 000760         10  FILLER PIC X(1) VALUE "-".
  656. 000770         10  LINE-7-COLUMN-22.
  657. 000780             15  CRT-DATE-OF-BIRTH-DAY PIC 99 VALUE ZEROS.
  658. 000790         10  FILLER PIC X(1) VALUE "-".
  659. 000800         10  LINE-7-COLUMN-25.
  660. 000810             15  CRT-DATE-OF-BIRTH-YEAR PIC 9999 VALUE ZEROS.
  661. 000820         10  FILLER PIC X(5) VALUE " AGE ".
  662. 000830         10  LINE-7-COLUMN-34.
  663. 000840             15  CRT-AGE PIC ZZ9 VALUE ZEROS.
  664. 000850         10  FILLER PIC X(14) VALUE SPACES.
  665. 000860         10  FILLER PIC X(20) VALUE "NEXT PAYCHECK DEST (".
  666. 000870         10  FILLER PIC X(4) VALUE "19) ".
  667. 000880         10  LINE-7-COLUMN-75.
  668. 000890             15  CRT-NEXT-PAYCHECK-DEST-CODE PIC X(1) 
  669. 000900                     VALUE SPACES.
  670. 000910         10  FILLER PIC X(1) VALUE SPACES.
  671. 000920         10  LINE-7-COLUMN-77.
  672. 000930             15  CRT-NEXT-PAYCHECK-DEST-DESC PIC X(4) 
  673. 000940                     VALUE SPACES.
  674. 000950*
  675. 000960     05  PAYID-SCREEN-LINE-8.
  676. 000970         10  FILLER PIC X(9) VALUE "RACE (6) ".
  677. 000980         10  LINE-8-COLUMN-10.
  678. 000990             15  CRT-RACE PIC X(2) VALUE SPACES.
  679. 001000         10  FILLER PIC X(1) VALUE SPACES.
  680. 001010         10  LINE-8-COLUMN-13.
  681. 001020             15  CRT-RACE-DESC PIC X(5) VALUE SPACES.
  682. 001030         10  FILLER PIC X(28) VALUE SPACES.
  683. 001040         10  FILLER PIC X(5) VALUE "(21) ".
  684. 001050         10  LINE-8-COLUMN-51.
  685. 001060             15  CRT-NEXT-PAYCHECK-DEST-LINE-1 PIC X(30) 
  686. 001070                     VALUE SPACES.
  687. 001080*
  688. 001090     05  PAYID-SCREEN-LINE-9.
  689. 001100         10  FILLER PIC X(45) VALUE SPACES.
  690. 001110         10  FILLER PIC X(5) VALUE "(22) ".
  691. 001120         10  LINE-9-COLUMN-51.
  692. 001130             15  CRT-NEXT-PAYCHECK-DEST-LINE-2 PIC X(30) 
  693. 001140                     VALUE SPACES.
  694. 001150*
  695. 001160     05  PAYID-SCREEN-LINE-10.
  696. 001170         10  FILLER PIC X(12) VALUE "MAILING (7) ".
  697. 001180         10  LINE-10-COLUMN-13.
  698. 001190             15  CRT-MAILING-ADDRESS-1 PIC X(30) VALUE SPACES.
  699. 001200         10  FILLER PIC X(8) VALUE "   (23) ".
  700. 001210         10  LINE-10-COLUMN-51.
  701. 001220             15  CRT-NEXT-PAYCHECK-DESTN-LINE-3 PIC X(30) 
  702. 001230                     VALUE SPACES.
  703. 001240*
  704. 001250     05  PAYID-SCREEN-LINE-11.
  705. 001260         10  FILLER PIC X(12) VALUE "ADDRESS (8) ".
  706. 001270         10  LINE-11-COLUMN-13.
  707. 001280             15  CRT-ADDRESS-LINE-1 PIC X(30) VALUE SPACES.
  708. 001290         10  FILLER PIC X(8) VALUE "   (24) ".
  709. 001300         10  LINE-11-COLUMN-51.
  710. 001310             15  CRT-NEXT-PAYCHECK-DEST-LINE-4 PIC X(30) 
  711. 001320                     VALUE SPACES.
  712. 001330*
  713. 001340     05  PAYID-SCREEN-LINE-12.
  714. 001350         10  FILLER PIC X(8) VALUE SPACES.
  715. 001360         10  FILLER PIC X(4) VALUE "(9) ".
  716. 001370         10  LINE-12-COLUMN-13.
  717. 001380             15  CRT-ADDRESS-LINE-2 PIC X(30) VALUE SPACES.
  718. 001390         10  FILLER PIC X(8) VALUE "   (25) ".
  719. 001400         10  LINE-12-COLUMN-51.
  720. 001410             15  CRT-NEXT-PAYCHECK-DEST-LINE-5 PIC X(30) 
  721. 001420                     VALUE SPACES.
  722. 001430*
  723. 001440     05  PAYID-SCREEN-LINE-13.
  724. 001450         10  FILLER PIC X(7) VALUE SPACES.
  725. 001460         10  FILLER PIC X(5) VALUE "(10) ".
  726. 001470         10  LINE-13-COLUMN-13.
  727. 001480             15  CRT-ADDRESS-LINE-3 PIC X(30) VALUE SPACES.
  728. 001490         10  FILLER PIC X(38) VALUE SPACES.
  729. 001500*
  730. 001510     05  PAYID-SCREEN-LINE-14.
  731. 001520         10  FILLER PIC X(12) VALUE "STATE  (11) ".
  732. 001530         10  LINE-14-COLUMN-13.
  733. 001540             15  CRT-ADDRESS-STATE-CODE PIC X(2) VALUE SPACES.
  734. 001550         10  FILLER PIC X(15) VALUE " ZIP CODE (12) ".
  735. 001560         10  LINE-14-COLUMN-30.
  736. 001570             15  CRT-ADDRESS-ZIP-CODE-1 PIC 99999 VALUE ZEROS.
  737. 001580         10  FILLER PIC X(1) VALUE "-".
  738. 001590         10  LINE-14-COLUMN-36.
  739. 001600             15  CRT-ADDRESS-ZIP-CODE-2 PIC 9999 VALUE ZEROS.
  740. 001610         10  FILLER PIC X(41) VALUE SPACES.
  741. 001620*
  742. 001630     05  PAYID-SCREEN-LINE-15.
  743. 001640         10  FILLER PIC X(17) VALUE "HOME PHONE (13) (".
  744. 001650         10  LINE-15-COLUMN-18.
  745. 001660             15  CRT-HOME-PHONE-AREA-CODE PIC 999 VALUE ZEROS.
  746. 001670         10  FILLER PIC X(2) VALUE ") ".
  747. 001680         10  LINE-15-COLUMN-23.
  748. 001690             15  CRT-HOME-PHONE-1 PIC 999 VALUE ZEROS.
  749. 001700         10  FILLER PIC X(1) VALUE "-".
  750. 001710         10  LINE-15-COLUMN-27.
  751. 001720             15  CRT-HOME-PHONE-2 PIC 9999 VALUE ZEROS.
  752. 001730         10  FILLER PIC X(50) VALUE SPACES.
  753. 001740*
  754. 001750     05  PAYID-SCREEN-LINE-16.
  755. 001760         10  FILLER PIC X(20) VALUE "EMERGENCY PHONE (14)".
  756. 001770         10  FILLER PIC X(2) VALUE " (".
  757. 001780         10  LINE-16-COLUMN-23.
  758. 001790             15  CRT-EMERGENCY-PHONE-AREA-CODE
  759. 001800                 PIC 999 VALUE ZEROS.
  760. 001810         10  FILLER PIC X(2) VALUE ") ".
  761. 001820         10  LINE-16-COLUMN-28.
  762. 001830             15  CRT-EMERGENCY-PHONE-1 PIC 999 VALUE ZEROS.
  763. 001840         10  FILLER PIC X(1) VALUE "-".
  764. 001850         10  LINE-16-COLUMN-32.
  765. 001860             15  CRT-EMERGENCY-PHONE-2 PIC 9999 VALUE ZEROS.
  766. 001870         10  FILLER PIC X(5) VALUE " EXT ".
  767. 001880         10  LINE-16-COLUMN-41.
  768. 001890             15  CRT-EMERGENCY-EXTENTION PIC 9999 VALUE ZEROS.
  769. 001900         10  FILLER PIC X(36) VALUE SPACES.
  770. 001910*
  771. 001920     05  PAYID-SCREEN-LINE-17.
  772. 001930         10  FILLER PIC X(18) VALUE "CONTACT NAME (15) ".
  773. 001940         10  LINE-17-COLUMN-19.
  774. 001950             15  CRT-EMERGENCY-CONTACT-NAME PIC X(30) 
  775. 001960                     VALUE SPACES.
  776. 001970         10  FILLER PIC X(32) VALUE SPACES.
  777. 001980*
  778. 001990     05  PAYID-SCREEN-LINE-18.
  779. 002000         10  FILLER PIC X(13) VALUE "COMPANY (16) ".
  780. 002010         10  LINE-18-COLUMN-14.
  781. 002020             15  CRT-EMERGENCY-CONTACT-COMPANY PIC X(30) 
  782. 002030                     VALUE SPACES.
  783. 002040         10  FILLER PIC X(37) VALUE SPACES.
  784. 002050*
  785. 002060     05  PAYID-SCREEN-LINE-19.
  786. 002070         10  FILLER PIC X(80) VALUE SPACES.
  787. 002080*
  788. 002090     05  PAYID-SCREEN-LINE-20.
  789. 002100         10  FILLER PIC X(80) VALUE SPACES.
  790. 002110*
  791. 002120     05  PAYID-SCREEN-LINE-21.
  792. 002130         10  FILLER PIC X(80) VALUE SPACES.
  793. 002140*
  794. 002150     05  PAYID-SCREEN-LINE-22.
  795. 002160         10  FILLER PIC X(20) VALUE "ENTER SCREEN ID, FIE".
  796. 002170         10  FILLER PIC X(20) VALUE "LD NO TO CHANGE, S T".
  797. 002180         10  FILLER PIC X(20) VALUE "O SELECT, OR X TO EX".
  798. 002190         10  FILLER PIC X(3) VALUE "IT ".
  799. 002200         10  LINE-22-COLUMN-64.
  800. 002210             15  CRT-SCREEN-ID-OR-FIELD-CODE PIC X(2) 
  801. 002220                     VALUE SPACES.
  802. 002230         10  FILLER PIC X(15) VALUE SPACES.
  803. 002240*
  804. 002250     05  PAYID-SCREEN-LINE-23.
  805. 002260         10  FILLER PIC X(80) VALUE SPACES.
  806. 002270*
  807. 002280     05  PAYID-SCREEN-LINE-24.
  808. 002290         10  FILLER PIC X(80) VALUE SPACES.
  809.  
  810. -------------------------------------------------------------------------------
  811.  
  812. LOADING SDCOBOL
  813. ---------------
  814. THE SDCOBOL PROGRAM CAN BE CALLED FROM THE SDMENU PROGRAM OR FROM THE DOS
  815. PROMPT. WHEN SDCOBOL IS CALLED FROM THE DOS PROMPT, THE DOS COMMAND LINE MUST
  816. CONTAIN THE SUBDIRECTORY INFORMATION REQUIRED FOR SDCOBOL TO FIND THE SCREEN
  817. DESIGN CONFIGURATION FILE. 
  818.  
  819. EXAMPLES:
  820.  
  821.      SDCOBOL C:\SD
  822.   OR
  823.      SDCOBOL
  824.  
  825. NP
  826. IF THE SCREEN DESIGN CONFIGURATION FILE IS IN THE DEFAULT DIRECTORY, NO COMMAND
  827. LINE INFORMATION IS ENTERED. IF SDCOBOL IS UNABLE TO FIND THE SCREEN DESIGN
  828. CONFIGURATION FILE THE USER WILL BE ASKED TO CONTINUE THE EDIT SESSION. 
  829. ENTERING <N> WILL CAUSE THE  SDCOBOL PROGRAM TO TERMINATE,  <Y> WILL CAUSE THE
  830. SDCOBOL TO USE DEFAULT VALUES.
  831.  
  832. THE SDCOBOL EDITOR
  833. ------------------
  834. SDCOBOL'S EDITOR IS VERY LIMITED, IT IS DESIGNED TO MAKE ONLY MINOR CHANGES.
  835. USE SDEDIT TO CREATE AND EDIT YOUR SCREENS. SDCOBOL USES LINE 25 AS IT'S STATUS
  836. LINE. LINE 25 IS ALSO USED FOR DIALOG BETWEEN THE USER AND THE PROGRAM WHEN
  837. FUNCTION KEY OPERATIONS ARE BEING PERFORMED. LINES 1 TO 24 SHOW THE SCREEN
  838. BEING EDITED. 
  839.  
  840. CURSOR MOVEMENT KEYS
  841. --------------------
  842. THE FOLLOWING TABLE SHOWS THE LIST OF CURSOR MOVEMENT KEYS FOUND IN THE SDCOBOL
  843. PROGRAM:
  844.  
  845. EDITOR COMMANDS
  846. -----------------------------------------------------------
  847. LEFT ARROW        MOVE CURSOR LEFT 1 CHARACTER
  848. CTRL LEFT ARROW        MOVE CURSOR TO COLUMN 1 OF CURRENT 
  849.             LINE
  850. RIGHT ARROW        MOVE CURSOR RIGHT 1 CHARACTER
  851. CTRL RIGHT ARROW    MOVE CURSOR TO COLUMN 80 OF CURRENT 
  852.             LINE
  853. UP ARROW        MOVE CURSOR UP 1 LINE
  854. DOWN ARROW        MOVE CURSOR DOWN 1 LINE
  855. ENTER KEY        MOVE CURSOR TO COLUMN 1 OF NEXT 
  856.             LINE
  857. HOME KEY        MOVE CURSOR TO LINE 1, CURRENT 
  858.              COLUMN
  859. END KEY            MOVE CURSOR TO LINE 24, CURRENT 
  860.             COLUMN
  861. BACKSPACE KEY         DELETE CURRENT CHARACTER AND 
  862.                         MOVE CURSOR LEFT 1 CHARACTER
  863. DELETE KEY        DELETE THE CURRENT CHARACTER
  864. FORWARD TAB             MOVE CURSOR TO 1ST CHARACTER
  865.                         OF THE NEXT WORD
  866. REVERSE TAB             MOVE CURSOR TO 1ST CHARACTER
  867.                         OF THE PREVIOUS WORD (SHIFT TAB)
  868. -----------------------------------------------------------
  869.  
  870.  
  871. LINE 25 STATUS LINE
  872.  
  873. L XX C XX
  874. ---------
  875. LINE 25 COLUMNS 2 THRU 10 DISPLAYS THE CURSOR'S LINE AND COLUMN POSITION. 
  876.  
  877. OVR
  878. ---
  879. SDCOBOL ONLY HAS THE OVERSTRIKE OPTION AVAILABLE. 
  880.  
  881. 1CBLFLD THRU 10EXIT
  882. -------------------
  883. LINE 25 COLUMNS 16 THRU 65 DISPLAYS THE HELP MENU FOR FUNCTION KEY PROCESSES EXPLAINED BELOW.
  884.  
  885. FUNCTION KEY TABLE
  886. ----------------------------------------------------------
  887. F1    CONVERT CHARATER-STRING STARTING AT CURSOR POSITION TO A COBOL FIELD
  888. F2    CONVERT COBOL FIELD STARTING AT CURSOR POSITION TO A SCREEN 
  889.     LITERAL
  890. F3    CHANGE COBOL FIELD NAME OF TEXT AT CURSOR POSITION 
  891. F4    CHANGE COBOL 01 RECORD LEVEL SCREEN NAME
  892. F5    CLEAR COBOL SCREEN AND ALL FIELD NAMES
  893. F6    GENERATE COBOL SCREEN DEFINITION
  894. F7    CALL UPLOAD COMMUNICATION PROGRAM
  895. F10    SAVE SCREEN / EXIT PROGRAM
  896.  
  897.  
  898. XXXXXXXX.XXX
  899. ------------
  900. LINE 25 COLUMN 67 THRU 79 DISPLAYS THE FILE NAME FOR THE SCREEN BEING EDITED.
  901.  
  902.                                 FUNCTION KEYS
  903.                                 -------------
  904.  
  905. F1 CONVERT TEXT TO COBOL FIELD
  906. ------------------------------
  907. CONVERTS THE CHARACTER-STRING STARTING AT THE CURRENT CURSOR POSITION TO A
  908. COBOL FIELD. SDCOBOL CONVERSION STOPS AT THE END OF THE LINE OR WHEN A
  909. NONCONVERTIBLE CHARACTER IS ENCOUNTERED. THE FOLLOWING TABLE LISTS SDCOBOL
  910. FIELD CHARACTERS AND CONVERSION. ALL COBOL FIELD CHARACTER-STRINGS ARE
  911. HIGHLIGHTED ON COLOR MONITORS AND UNDERLINED ON MONOCHROME MONITORS.
  912.  
  913. COBOL "X" TYPE ALPHANUMERIC FIELDS ARE DEFINED IN THE SCREEN DESIGN PROGRAMS AS
  914. A LOWER CASE "x".
  915.  
  916. COBOL NUMERIC FIELDS ALSO USE LOWER CASE LETTERS AS PART OF THEIR FIELD
  917. DEFINITIONS. BECAUSE THERE IS NO LOWER CASE EQUIVALENT OF THE "9" CHARACTER THE
  918. "#" IS SUBSTITUTED. ALL NUMERIC FIELDS MUST BEGIN WITH ONE THE FOLLOWING
  919. CHARACTERS; "z", "#", OR "$". 
  920.  
  921. THE REASON LOWER CASE CHARACTERS AND THE "#" ARE USED TO DEFINE COBOL FIELDS IS
  922. TO MAKE THE SCREENS DESIGNED BY THIS SOFTWARE AS GENERIC AS POSSIBLE. IF THERE
  923. WERE CONTROL CODES IMBEDDED IN THE SCREEN LAYOUT DISK FILES THEY COULD PRODUCE
  924. UNEXPECTED RESULTS WHEN LOADED INTO WORD PROCESSORS OR PRINTED.
  925.  
  926. NP
  927. THE TABLE BELOW SHOWS CHARACTERS ALLOWED IN A COBOL NUMERIC FIELD.
  928.  
  929. SCREEN    COBOL
  930. TEXT      FIELD    DESCRIPTION
  931. ----------------------------------------------------------
  932. "X"      "x"      ALPHANUMERIC FIELD
  933. "9"      "#"      NOT ZERO SUPPRESSED NUMERIC CHARACTER
  934. "Z"      "z"      SUPPRESS LEADING ZERO NUMERIC CHARACTER
  935. "$"      "$"      FLOATING DOLLAR SIGN
  936. "."      "."      DECIMAL POINT            
  937. ","      ","      FLOATING COMMA
  938. "CR"      "cr"      CREDIT AMOUNT
  939. "DB"      "db"      DEBIT AMOUNT        
  940. "+"      "+"      POSITIVE AMOUNT
  941. "-"      "-"      NEGATIVE AMOUNT
  942. "/"      "/"      DATE SEPARATION CHARACTER
  943. -----------------------------------------------------------
  944.  
  945.  
  946. SDCOBOL FIELD DESCRIPTION EXAMPLES
  947. -----------------------------------------------------------
  948. xxxxxxxxxx    TEN CHARACTER ALPHA/NUMERIC FIELD
  949. #####        FIVE CHARACTER NUMERIC FIELD
  950. zzzz#        ZERO SUPPRESSED NUMERIC FIELD
  951. zzz,zz#.##    ZERO SUPPRESSED NUMERIC FIELD WITH DECIMALS
  952. $$$,$$#.##    DOLLAR AMOUNT NUMERIC FIELD
  953. $$$,$$#.##-     CREDIT DOLLAR AMOUNTS
  954. $$$,$$#.##cr    
  955. $$$,$$#.##+     DEBIT DOLLAR AMOUNTS
  956. $$$,$$#.##db    
  957. zzzzz        BLANK WHEN ZERO NUMERIC FIELD
  958. ##/##/##    DATE FIELD
  959. -----------------------------------------------------------
  960.  
  961. F2 CONVERT COBOL FIELD TO SCREEN TEXT
  962. -------------------------------------
  963. CONVERTS COBOL FIELD CHARACTERS STARTING AT THE CURRENT CURSOR POSITION TO A
  964. SCREEN CHARACTER-STRING. SDCOBOL CONVERSION STOPS AT THE END OF THE LINE OR
  965. WHEN A NONCONVERTIBLE CHARACTER IS ENCOUNTERED. THE TABLE ABOVE LISTS SDCOBOL
  966. FIELD CHARACTERS AND CONVERSIONS. SCREEN CHARACTER-STRINGS ARE DISPLAYED IN
  967. NORMAL VIDEO.
  968.  
  969.  
  970. F3 CHANGE COBOL FIELD NAME
  971. --------------------------
  972. CHANGES THE COBOL FIELD NAME FOR THE CHARACTER STRING AT THE CURRENT CURSOR
  973. POSITION. TO REMOVE AN EXISTING COBOL FIELD NAME, TYPE IN THE WORD <CLEAR>.
  974. SDCOBOL WILL KEEP THE EXISTING FIELD NAME IF THE <ENTER> KEY IS PRESSED WITHOUT
  975. ENTERING A NEW FIELD NAME OR THE WORD <CLEAR>. COBOL FIELD NAMES ARE CHECKED
  976. FOR VALID SYNTAX. IT IS NOT NECESSARY FOR FIELD NAMES TO BE ENTERED BEFORE THE
  977. F6 SCREEN GENERATION IS PERFORMED. SDCOBOL WILL PROMPT FOR EACH FIELD NAME
  978. DURING THE SCREEN GENERATION PROCESS.
  979.  
  980. NP
  981. F4 CHANGE COBOL SCREEN NAME
  982. ---------------------------
  983. CHANGES THE COBOL 01 RECORD LEVEL NAME FOR THE SCREEN. TO REMOVE THE EXISTING
  984. SCREEN NAME, TYPE THE WORD <CLEAR>. SDCOBOL WILL KEEP THE EXISTING SCREEN NAME
  985. IF THE <ENTER> KEY IS PRESSED WITHOUT ENTERING A NEW SCREEN NAME OR THE WORD
  986. <CLEAR>. SCREEN FIELD NAME IS CHECKED FOR VALID SYNTAX. MAXIMUM LENGTH OF
  987. SCREEN NAME IS 23 CHARACTERS. SDCOBOL APPENDS THE CHARACTER-STRING "-SCREEN" TO
  988. THE SCREEN NAME. EACH LINE WITHIN THE 01 RECORD LEVEL HAS THE SCREEN NAME  AND
  989. "-LINE-XX" WITH "XX" BEING THE SCREEN LINE NUMBER. THIS ALLOWS THE PROGRAMMER
  990. TO EASILY DISPLAY ONE LINE AT A TIME IF MULTIPLE SCREENS ARE USED WITHIN ONE
  991. PROGRAM. THE SCREEN NAME IS NOT REQUIRED BEFORE THE F6 SCREEN GENERATION IS
  992. PERFORMED.
  993.  
  994. F5 CLEARS COBOL SCREEN NAME AND FIELD NAMES.
  995. --------------------------------------------
  996. CLEARS ALL COBOL FIELD NAMES AND THE COBOL 01 RECORD LEVEL SCREEN NAME.
  997.  
  998. F6 GENERATE COBOL SCREEN DEFINITION
  999. -----------------------------------
  1000. THIS IS THE BREAD AND BUTTER FUNCTION OF THE SDCOBOL PROGRAM. AFTER PROMPTING
  1001. FOR THE OUTPUT FILE NAME, SDCOBOL GENERATES THE COBOL WORKING-STORAGE 01 SCREEN
  1002. DEFINITION. THE OUTPUT FILE FROM THIS SCREEN GENERATOR CAN BE COPIED INTO A PC
  1003. COBOL PROGRAM OR UPLOADED TO A MAINFRAME BY USING A MAINFRAME COMMUNICATION
  1004. PROGRAM.
  1005.  
  1006. DURING THE COBOL SCREEN GENERATION PROCESS THE USER IS SHOWN THE PREVIOUS ENTRY
  1007. FOR THE OUTPUT FILENAME, SCREEN NAME, AND ALL COBOL FIELD NAMES. BY PRESSING
  1008. ONLY THE <ENTER> KEY THE PROGRAM WILL USE THESE PREVIOUSLY ENTERED VALUES. THIS
  1009. FEATURE ALLOWS A USER TO QUICKLY REGEN A SCREEN IF AN ERROR HAS BEEN MADE. THE
  1010. USER CAN HALT THE SCREEN GENERATION PROCESS BY ENTERING <ABORT> TO THE SCREEN
  1011. NAME OR FIELD NAME PROMPT.
  1012.  
  1013. THE USER CAN SPECIFY A FILE NAME OF "PRN" IF PRINTER OUTPUT IS DESIRED FOR
  1014. MANUAL ENTRY INTO A PROGRAM.
  1015.  
  1016. THE SCREEN NAME AND COBOL FIELD NAMES ARE VALIDATED FOR CORRECT COBOL SYNTAX
  1017. WHEN ENTERED. THE COBOL FIELD CHARACTER-STRING IS HIGHLIGHTED WHEN SDCOBOL
  1018. REQUESTS THE COBOL FIELD NAME. 
  1019.  
  1020. SCREEN CONTROL CODES CAN BE GENERATED FOR THE ANSI.SYS SCREEN DRIVER OR FOR THE
  1021. NCR 796-101 TTY TERMINAL. SEE SDCONFIG INSTRUCTIONS FOR IMPLEMENTATION OF THIS
  1022. FEATURE.
  1023.  
  1024. F7 CALL COMMUNICATION PROGRAM
  1025. -----------------------------
  1026. BY PRESSING THE <F7> FUNCTION KEY THE USER CAN UPLOAD THE SCREEN DEFINITION
  1027. SAVED ON DISK DURING A SDCOBOL SESSION. THE USER CAN ENTER THE UPLOAD PROGRAM
  1028. TO CALL IN THE SDCONFIG PROGRAM. ALTHOUGH THERE IS A NCR 796-101 COMMUNICATION
  1029. PROGRAM INCLUDED IN THE SCREEN DESIGN SOFTWARE PACKAGE, THE USER CAN USE OTHER
  1030. UPLOAD SOFTWARE.
  1031.  
  1032. NP
  1033. F10 SAVE AND/OR EXIT
  1034. --------------------
  1035. THE F10 FUNCTION KEYS ALLOWS THE USER TO SAVE THE SCREEN TO DISK AND/OR EXIT
  1036. THE PROGRAM. PRESSING ONLY THE <ENTER> KEY AT THE SAVE/EXIT MESSAGE WILL RETURN
  1037. THE USER TO THE EDIT SESSION. PRESSING THE <S> KEY INSTRUCTS SDCOBOL TO SAVE
  1038. THE SCREEN TO DISK AND RETURN TO THE EDIT PROCESS. PRESSING THE <X> KEY
  1039. INSTRUCTS SDCOBOL TO SAVE THE SCREEN TO DISK AND TO EXIT THE PROGRAM. PRESSING
  1040. <C> WILL CAUSE THE PROGRAM TO SAVE THE SCREEN UNDER ANOTHER NAME AND EXIT THE
  1041. EDIT SESSION. ENTERING <Q> WILL CAUSE THE PROGRAM TO EXIT WITHOUT SAVING THE
  1042. SCREEN.
  1043.  
  1044. BECAUSE SDCOBOL GENERATES CLEAN COBOL SCREEN DEFINITIONS SDCOBOL WILL NOT SAVE
  1045. THE COBOL SCREEN NAME OR FIELD NAMES.
  1046.  
  1047. NP
  1048.                           ************************
  1049.                           * THE SDCONFIG PROGRAM *
  1050.                           ************************
  1051.  
  1052. THE SDCONFIG PROGRAM IS USED TO CONFIGURE THE OPTIONS WITHIN THE SCREEN DESIGN
  1053. PROGRAMS. ALL SCREEN DESIGN PROGRAMS USE DEFAULT SETTINGS IF THE CONFIGURATION
  1054. FILE IS NOT CREATED.
  1055.  
  1056. THE SDCONFIG PROGRAM CREATES "SDCOLOR.CFG" FOR COLORED MONITORS OR "SDMONO.CFG"
  1057. FOR MONOCHROME MONITORS. HAVING A SEPARATE FILE FOR EACH TYPE OF MONITOR ALLOWS
  1058. USERS WITH A MONOCHROME MONITOR RUNNING COLOR SOFTWARE TO CHANGE THE SCREEN
  1059. COLORS FOR CORRECT SHADING. THE NAME OF THE CONFIGURATION FILE BEING CREATED OR
  1060. EDITED APPEARS IN THE UPPER RIGHT HAND CORNER OF THE SCREEN.
  1061.  
  1062. THE SDCONFIG PROGRAM CAN BE CALLED FROM THE SDMENU PROGRAM OR FROM THE DOS
  1063. PROMPT. WHEN SDCONFIG IS CALLED FROM THE DOS PROMPT, THE DOS COMMAND LINE MUST
  1064. CONTAIN THE SUBDIRECTORY INFORMATION REQUIRED FOR SDCONFIG TO FIND THE SCREEN
  1065. DESIGN CONFIGURATION FILE. 
  1066.  
  1067. EXAMPLES:
  1068.  
  1069.      SDCONFIG C:\SD
  1070.   OR
  1071.      SDCONFIG
  1072.  
  1073. IF THE SCREEN DESIGN CONFIGURATION FILE IS IN THE DEFAULT DIRECTORY, NO COMMAND
  1074. LINE INFORMATION IS ENTERED. IF SDCONFIG IS UNABLE TO FIND THE SCREEN DESIGN
  1075. CONFIGURATION FILE THE USER WILL BE ASKED TO CONTINUE THE CONFIGURATION
  1076. SESSION.  ENTERING <N> WILL CAUSE THE  SDCONFIG PROGRAM TO TERMINATE,  <Y> WILL
  1077. CAUSE THE SDCONFIG TO USE DEFAULT VALUES.
  1078.  
  1079. IF THE CONFIGURATION FILE IS NOT FOUND IN THE DEFAULT SUBDIRECTORY THE USER
  1080. MUST INCLUDE THE PATH FOR THE CONFIGURATION FILE IN THE COMMAND LINE WHEN
  1081. EXECUTING ANY SCREEN DESIGN PROGRAM, EXCEPT SDCONFIG.
  1082.  
  1083. ALL BUT THREE ENTRIES IN THE CONFIGURATION FILE ARE TOGGLED TO THEIR DIFFERENT
  1084. SETTINGS BY PRESSING THE CORRESPONDING FUNCTION KEY. THE THREE ENTRIES WHICH
  1085. REQUIRE MANUAL ENTRIES ARE; SIDEWAYS PRINT PROGRAM TO USE F9, COMMUNICATION
  1086. UPLOAD PROGRAM TO CALL CTRL F5, AND CHARACTER DELAY COUNTER ALT F4.
  1087.  
  1088. SCREEN COLORS
  1089. -------------
  1090. THE <F1> THRU <F7> KEYS AND <SHIFT F1> THRU <SHIFT F7> ALLOW THE USER TO CHANGE
  1091. THE COLORS FOR THE DIFFERENT PROCEDURES. WHEN USED ON A MONOCHROME MONITOR THE
  1092. <SHIFT F1> THRU <SHIFT F7> KEYS ARE DISABLED BECAUSE OF THE LIMITED NUMBER OF
  1093. SCREEN ATTRIBUTE OPTIONS AVAILABLE. 
  1094.  
  1095. PRINTER TYPE F8
  1096. ---------------
  1097. ALLOWS THE USER TO ALTERNATE BETWEEN THE THREE SUPPORTED PRINTER TYPES. "NCR"
  1098. CONFIGURES THE SCREEN DESIGN PROGRAMS TO SUPPORT A NCR 6411 OR C.ITOH 8510B
  1099. PRINTERS. "EPSON" CONFIGURES THE PROGRAMS FOR EPSON COMPATIBLE PRINTERS. "IBM"
  1100. CONFIGURES THE PROGRAMS FOR IBM PROPRINTER COMPATIBLE PRINTERS. 
  1101.  
  1102. SIDEWAYS PROGRAM F9
  1103. -------------------
  1104. THE F9 FUNCTION KEY ALLOWS THE USER TO ENTER A SIDEWAYS PRINT PROGRAM TO CALL
  1105. FROM SDEDIT AFTER CREATING A DISK FILE. THE PC MUST HAVE ENOUGH RAM MEMORY FOR
  1106. BOTH THE SDEDIT PROGRAM AND THE SIDEWAYS PRINT PROGRAM TO USE THIS FEATURE.
  1107. THIS FEATURE ALLOWS NARROW CARRIAGE PRINTERS TO PRINT SCREEN MAPS SIDEWAYS. 
  1108.  
  1109. SCREEN CONTROL CODES CTRL F1
  1110. ----------------------------
  1111. HOLDING DOWN THE CTRL KEY TO THE LEFT OF THE "A" KEY  AND PRESSING THE <F1>
  1112. WILL TOGGLE THE DIFFERENT SCREEN CONTROL CODES OPTIONS AVAILABLE IN SDCOBOL. 
  1113.  
  1114. IF "NONE" IS USED NO CONTROL CODES WILL BE GENERATED DURING A COBOL WORKING-
  1115. STORAGE SCREEN GENERATION PROCESS. MANY COBOL COMPILERS DISPLAY COMMANDS ALLOW
  1116. THE USER TO CONTROL LINE AND COLUMN OF DATA BEING DISPLAYED IN ADDITION TO
  1117. ERASING THE SCREEN. THESE COMPILERS DO NOT NEED CONTROL CODES INSERTED INTO THE
  1118. WORKING-STORAGE SCREEN DEFINITIONS.
  1119.  
  1120. SOME COBOL COMPILERS REQUIRE "ANSI.SYS" CONTROL CODES TO BE INSERTED INTO THE
  1121. WORKING-STORAGE SCREEN DEFINITIONS. THE SDCOBOL  "ANSI.SYS" OPTION WILL GENER
  1122. ATE THESE CONTROL CODES. 
  1123.  
  1124. THE "NCR 796-101" OPTION WILL CREATE SCREEN CONTROL CODES FOR THE SCREEN IN
  1125. SDCOBOL. SINCE THE SEND AND RECEIVE INSTRUCTIONS IN NCR VRX COBOL HAS NO BUILT
  1126. IN CURSOR CONTROL FUNCTIONS, THIS FEATURE IS VERY USEFUL.
  1127.  
  1128. SDCOBOL ONLY GENERATES ERASE SCREEN AND BEGINNING OF LINE CONTROL CODES. THE
  1129. AUTHOR HAS WRITTEN MANY ONLINE PROGRAMS AND HAS FOUND THAT DISPLAYING/SENDING
  1130. EITHER THE COMPLETE SCREEN OR A LINE AT A TIME WORKS WELL.
  1131.  
  1132. SOURCE CODE RECORD SIZE CTRL F2
  1133. -------------------------------
  1134. HOLDING DOWN THE CTRL KEY AND PRESSING THE <F2> WILL TOGGLE THE COBOL SOURCE
  1135. CODE RECORD SIZE 80 OPTION OFF AND ON. IF SOURCE COBOL RECORD SIZE EQUALS 80 IS
  1136. "YES" THEN SDCOBOL WILL ADD TRAILING SPACES TO EACH SOURCE CODE LINE SO THE 
  1137. RECORD SIZE IS ALWAYS 80 CHARACTERS. IF SOURCE CODE RECORD SIZE 80 OPTION IS
  1138. "NO " THEN EACH RECORD WILL NOT HAVE ANY TRAILING SPACES ADDED, AND THE RECORD
  1139. SIZE WILL ALWAYS BE LESS THAN 73 CHARACTERS.
  1140.  
  1141. IF "SDCOM" PROGRAM IS BEING USED TO UPLOAD THE COBOL SOURCE CODE INTO A
  1142. MAINFRAME, AND THE RECORDS PER SDCOM UPLOAD BLOCK IS GREATER THAN 1 THEN SDCOM
  1143. WILL ADD TRAILING SPACES TO EACH RECORD AT UPLOAD TIME SO EACH RECORD IS ALWAYS
  1144. 80 CHARACTERS. SEE RECORDS PER SDCOM UPLOAD BLOCK DESCRIPTION BELOW.
  1145.  
  1146. COMMUNICATION UPLOAD PROGRAM TO CALL CTRL F3
  1147. --------------------------------------------
  1148. THE <CTRL F3> FUNCTION KEY ALLOWS THE USER TO ENTER A PC COMMUNICATION PROGRAM
  1149. TO CALL FROM THE SDCOBOL PROGRAM. THIS ALLOWS THE USER TO IMMEDIATELY UPLOAD
  1150. COBOL SCREEN DEFINITIONS DURING A SDCOBOL SESSION. THE PC MUST HAVE ENOUGH RAM
  1151. MEMORY FOR BOTH THE SDCOBOL PROGRAM AND THE COMMUNICATION PROGRAM TO USE THIS
  1152. FEATURE. 
  1153.  
  1154. NP
  1155. THE SDCOM PROGRAM INCLUDED IN THIS SCREEN DESIGN SOFTWARE CAN BE REPLACED BY
  1156. MANY EXCELLENT COMMUNICATION PROGRAMS.  SDCOM WAS DESIGNED TO UPLOAD COBOL
  1157. SOURCE CODE TO A MAINFRAME USING THE STANDARD SOURCE CODE EDITORS SUCH AS VRX'S
  1158. OLPD. IF THE USER IS GOING TO DO NUMEROUS FILE TRANSFERS BETWEEN THE MAINFRAME
  1159. AND A PC THE AUTHOR RECOMMENDS THE SOFTWARE PACKAGE "ANZIO" FROM RASMUSSEN AND
  1160. ASSOCIATES, 4838 SW HAMILTON CT., PORTLAND, OREGON 97221, PHONE 503-244-8516.
  1161.  
  1162.                                     SDCOM
  1163.                                     =====
  1164.  
  1165. THE FOLLOWING ENTRIES CONFIGURE SDCOM PROGRAM ONLY. IF YOU ARE NOT USING SDCOM
  1166. PROGRAM TO COMMUNICATE WITH A MAINFRAME, THEN ALL FIELDS DEFINED BELOW WILL NOT
  1167. BE USED.
  1168.  
  1169. RECORDS PER SDCOM UPLOAD BLOCK CTRL F4
  1170. --------------------------------------
  1171. SDCOM ALLOWS THE USER TO UPLOAD UP TO 100 EIGHTY CHARACTER SOURCE CODE LINES AT
  1172. A TIME. THIS FEATURE WAS DESIGNED FOR NCR'S VRX OPERATING SYSTEM. NCR'S VRX
  1173. COBOL RECEIVE ALLOWS THE PC TO SEND UP TO 9999 BYTES IN ONE TRANSMISSION.
  1174. TRANSMITTING MORE THAN 1 RECORD AT A TIME REQUIRES A SPECIAL PROGRAM ON THE
  1175. MAINFRAME TO SEPARATE THE RECORDS AND WRITE THEM TO DISK.
  1176.  
  1177. TO UPLOAD SOURCE CODE INTO A SOURCE CODE EDITOR LIKE NCR'S OLPD THE USER SHOULD
  1178. CONFIGURE SDCOBOL FOR "SOURCE CODE RECORD SIZE = 80" TO "NO", <CTRL F2>, AND
  1179. "RECORDS PER SDCOM UPLOAD BLOCK" TO "1".
  1180.  
  1181. AUTO LINE FEED AFTER CARRIAGE RETURN IN SDCOM CTRL F5
  1182. -----------------------------------------------------
  1183. ALLOWS THE USER TO CONFIGURE SDCOM TO MOVE THE CURSOR DOWN TO THE BEGINNING OF
  1184. THE NEXT LINE WHEN A CARRIAGE RETURN IS RECEIVED FROM THE KEYBOARD. IF THIS
  1185. OPTION IS SET TO "NO", WHEN A CARRIAGE RETURN IS ENTERED FROM THE KEYBOARD THE
  1186. CURSOR IS MOVED TO COLUMN 1 OF THE SAME LINE.
  1187.  
  1188. IF THE SCREEN TEXT IS BEING DOUBLE SPACED WHEN USING SDCOM, THIS FEATURE SHOULD
  1189. BE SET TO "NO ". IF TEXT IS BEING WRITTEN OVER THE TOP OF THE PREVIOUS LINE'S
  1190. DATA, THIS FEATURE NEEDS TO BE SET TO "YES".
  1191.  
  1192. WAIT TO SEND AFTER CARRIAGE RETURN IN SDCOM CTRL F6
  1193. ---------------------------------------------------
  1194. THIS FEATURE FORCES SDCOM TO WAIT FOR A CLEAR TO SEND CHARACTER FROM THE
  1195. MAINFRAME AFTER A CARRIAGE RETURN IS ENTERED FROM THE KEYBOARD OR A BLOCK OF
  1196. DATA SENT. 
  1197.  
  1198. MOST OF NCR'S "I SYSTEMS" USE KEYBOARD LOCK / UNLOCK  PROTOCOL FOR TERMINAL
  1199. COMMUNICATIONS. BY USING THE <ALT F10> DEFINED BELOW THE USER CAN SPECIFY WHICH
  1200. CONTROL CODE FROM THE MAINFRAME CLEARS THE WAIT TO SEND STATUS. THE WAIT TO
  1201. SEND STATUS WILL ALWAYS BE CLEARED IF A "BEL" CHARACTER (HEX 07) IS RECEIVED
  1202. FROM THE MAINFRAME. PRESSING THE <F4> FUNCTION KEY IN THE SDCOM PROGRAM WILL
  1203. ALSO CLEAR THE WAIT TO SEND STATUS.
  1204.  
  1205. NCR'S "VRX SYSTEMS" DO NOT USE KEYBOARD LOCKING SO THE WAIT TO SEND STATUS
  1206. AFTER CARRIAGE RETURN SHOULD NOT BE USED.
  1207.  
  1208. NP
  1209. BAUD RATE CTRL F7
  1210. -----------------
  1211. DETERMINES TRANSMISSION SPEED BETWEEN THE MAINFRAME AND THE SDCOM PROGRAM. THE
  1212. BAUD RATE CAN BE FROM 1200 BAUD TO 19200 BAUD. DIVIDING THE BAUD RATE BY TEN
  1213. GIVES AN ESTIMATE OF HOW MANY CHARACTERS ARE TRANSFERRED PER SECOND. 
  1214.  
  1215. IF YOU ARE USING AN IBM-XT COMPATIBLE RUNNING AT 4.77 MHZ SDCOM MAY NOT BE ABLE
  1216. TO KEEP UP WHEN RECEIVING DATA FROM THE MAINFRAME. THERE ARE SEVERAL OPTIONS
  1217. AVAILABLE TO CORRECT THIS PROBLEM. THE FIRST, IS TO REDUCE THE BAUD RATE AT
  1218. WHICH THE PC AND MAINFRAME ARE COMMUNICATING. THE SECOND, IS TO PUT A FASTER
  1219. PROCESSOR IN THE PC, SUCH AS INSTALLING A 80286 PROCESSOR CARD INTO THE PC OR
  1220. REPLACING THE 8088 PROCESSOR CHIP WITH A NEC V20 PROCESSOR CHIP. THE V20 CHIP
  1221. CAN BE PURCHASED FOR LESS THAN $ 15.00. THE THIRD IS TO PURCHASE A DIFFERENT
  1222. COMMUNICATION PROGRAM SUCH AS "ANZIO".
  1223.  
  1224. PARITY CTRL F8, DATA BITS CTRL F9 AND STOP BITS F10
  1225. ---------------------------------------------------
  1226. THESE FIELDS DETERMINE THE FORMAT OF DATA BEING TRANSFERRED BETWEEN THE
  1227. MAINFRAME AND THE PC. IF YOU ARE UNSURE OF HOW TO USE THESE PARAMETERS, REFER
  1228. TO THE NCR 7900 INFORMATION MANUAL OR CONTACT YOUR NCR FE.
  1229.  
  1230. THE 2 MOST COMMONLY FOUND SETUPS ARE:
  1231.  
  1232.       8 DATA BITS, NO PARITY, AND 1 STOP BIT,
  1233.    OR
  1234.       7 DATA BITS, EVEN PARITY, AND 1 STOP BIT.
  1235.  
  1236. COM PORT ID ALT F1
  1237. ------------------
  1238. IBM PC COMPATIBLES WERE DESIGNED TO SUPPORT A RS-232 COM PORT 1 THRU COM PORT
  1239. 4. GENERALLY THE COM PORT 1 IS USED UNLESS A RS-232 PRINTER OR PLOTTER IS USED.
  1240. PRESSING THE <ALT F1> WILL TOGGLE SDCONFIG BETWEEN THESE TWO PORTS.
  1241.  
  1242. KEYBOARD ECHO ALT F2
  1243. --------------------
  1244. CONTROLS WHETHER THE CHARACTERS TYPED ON THE KEYBOARD DISPLAY IMMEDIATELY ON
  1245. THE SCREEN OR IF SDCOM WAITS FOR THE MAINFRAME TO ECHO THE CHARACTER BACK TO
  1246. THE PC TO DISPLAY. NCR 7900 TERMINALS DISPLAY ON THE STATUS LINE 25 WHETHER
  1247. THEY ARE IN "FULL" OR "HALF DUPLEX". 
  1248.  
  1249. FULL DUPLEX WAITS FOR THE MAINFRAME TO SEND THE CHARACTER BACK TO THE PC BEFORE
  1250. IT IS DISPLAYED ON THE SCREEN. HALF DUPLEX DISPLAYS THE TYPED IN CHARACTERS
  1251. BEFORE THEY ARE SENT TO THE MAINFRAME, AND THE MAINFRAME DOES NOT ECHO THE
  1252. CHARACTER BACK TO THE PC.
  1253.  
  1254. WHEN ENTERING TEXT IN SDCOM, IF EACH CHARACTER APPEARS TWICE ON THE SCREEN IT
  1255. MEANS THAT FULL DUPLEX IS BEING USED, AND KEYBOARD ECHO SHOULD BE SET "NO". IF
  1256. NO CHARACTERS APPEAR ON THE SCREEN WHEN ENTERING TEXT THE KEYBOARD ECHO SHOULD
  1257. BE SET TO "YES".
  1258.  
  1259. FILE UPLOADS ARE MUCH FASTER IF THE ECHO KEYBOARD CHARACTER OPTION IS SET TO
  1260. "YES", BECAUSE SDCOM DOES NOT WAIT FOR THE CHARACTER TO BE ECHOED BACK TO THE
  1261. PC BEFORE THE NEXT CHARACTER IS SENT TO THE MAINFRAME.
  1262.  
  1263.  
  1264. LINE DELAY F3
  1265. -------------
  1266. THE LINE DELAY IS USED TO INCREASE THE TIME BETWEEN FILE UPLOAD TRANSMISSIONS.
  1267. THE LINE DELAY TIME CAN BE SET FROM 1  TO 9 SECONDS. THE LINE DELAY ALLOWS TIME
  1268. FOR THE MAINFRAME TO SWITCH FROM SEND MODE TO RECEIVE MODE. IT WILL ALSO ALLOW
  1269. THE MAINFRAME TIME TO PROCESS DATA FROM THE PC'S LAST TRANSMISSION IF NO
  1270. COMMUNICATION PROTOCOL IS BEING USED TO CONTROL FILE UPLOAD.
  1271.  
  1272. NCR'S OLPD DOES NOT USE ANY PROTOCOLS TO CONTROL DATA TRANSMISSION. A LINE
  1273. DELAY SHOULD BE ENTERED TO ALLOW OLPD TO PROCESS THE PREVIOUS TRANSMISSION. IF
  1274. CHARACTERS ARE MISSING FROM THE BEGINNING OF UPLOADED LINE THEN THE LINE DELAY
  1275. TIME NEEDS TO BE INCREASED. 
  1276.  
  1277. CHARACTER DELAY ALT F4
  1278. ----------------------
  1279. CONTROLS THE TIME BETWEEN TRANSFER OF CHARACTERS; THIS TIME DELAY VARIES
  1280. DEPENDING ON THE SPEED OF THE PC'S PROCESSOR. IT GIVES THE MAINFRAME TIME TO
  1281. PROCESS THE PREVIOUS CHARACTER. OLDER CLC/MLA ADAPTERS ON NCR 8500 PROCESSORS
  1282. COULD NOT RECEIVE A FILE TRANSFER BLOCK OF DATA AT 9600 BAUD. IT ALSO ALLOWS
  1283. THE PC TIME TO PROCESS A ECHOED CHARACTER IF USING FULL DUPLEX COMMUNICATION
  1284. PROTOCOL.
  1285.  
  1286. BACKSPACE ALT F5
  1287. ----------------
  1288. DETERMINES IF THE CODE SENT TO THE MAINFRAME BY SDCOM IS A HEXADECIMAL 08 (BS)
  1289. OR A HEXADECIMAL 21 (NAK). NCR 796-101 TERMINALS USE THE HEXADECIMAL CHARACTER
  1290. 21 (NAK). MODEMS REQUIRE THE BACKSPACE CHARACTER TO BE A HEXADECIMAL 08 (BS) TO
  1291. WORK CORRECTLY.
  1292.  
  1293. PRINTER ON ALT F6 AND PRINTER OFF ALT F7
  1294. ----------------------------------------
  1295. THE PRINTER ON AND PRINTER OFF CONTROL CODES DETERMINE IF THE DATA BEING
  1296. RECEIVED FROM THE MAINFRAME IS SENT TO THE PC PRINTER "PRN" DEVICE. IF THERE IS
  1297. A PRINTER ON CODE THEN THERE MUST ALSO BE A PRINTER OFF CODE. DATA RECEIVED
  1298. AFTER THE PRINTER ON CONTROL CODE IS SENT TO THE PRINTER UNTIL THE PRINTER OFF
  1299. CONTROL CODE IS RECEIVED. THE PRINTER ON AND PRINTER OFF CONTROL CODES ARE NOT
  1300. DISPLAYED OR SENT TO THE PRINTER.
  1301.  
  1302. THE NCR 796-101 AND 7900 TERMINALS USE THE HEXADECIMAL CHARACTER 12 (DC2) FOR
  1303. PRINTER ON AND HEXADECIMAL CHARACTER 14 (DC4) FOR PRINTER OFF. UP TO 32,000
  1304. BYTES MAY BE SENT BETWEEN THE PRINTER ON AND PRINTER OFF CONTROL CODES. THE
  1305. PRINTER ON AND PRINTER OFF CONTROL CODES CAN BE THE SAME CODE. THE FIRST CODE
  1306. WOULD TURN THE PRINTER ON AND THE SECOND CODE TURNS THE PRINTER OFF.
  1307.  
  1308. PRINTER DONE ALT F8
  1309. -------------------
  1310. THIS CODE IS SENT TO THE MAINFRAME AFTER THE PC HAS SENT THE LAST CHARACTER TO
  1311. BE PRINTED TO THE PRINTER. THE PRINTER DONE CHARACTER IS NOT REQUIRED IF THE
  1312. PRINTER ON/OFF FEATURE IS BEING USED. IF A PRINTER DONE CHARACTER IS DEFINED,
  1313. THE PC WILL WAIT FOR THE LINE DELAY TIME PERIOD (ALT F3) BEFORE SENDING THE
  1314. MAINFRAME PRINTER DONE CONTROL CODE SO THAT THE MAINFRAME HAS TIME TO SWITCH
  1315. IT'S RS-232 ADAPTER INTO RECEIVE MODE. THIS TIME DELAY MAY BE REQUIRED WHEN
  1316. USING PRINTERS WITH LARGE BUFFERS.
  1317.  
  1318. UNDER NCR'S VRX OPERATING SYSTEM, THE MAINFRAME ONLY RECOGNIZES THE  CARRIAGE
  1319. RETURN CHARACTER (HEXADECIMAL 0D), END OF TRANSMISSION CHARACTER (HEXADECIMAL
  1320. 04), AND BEL CHARACTER (HEXADECIMAL 07) AS TRANSMISSION TERMINATORS. VRX WILL
  1321. NOT RELEASE DATA RECEIVED TO THE MAINFRAME PROGRAM UNTIL ONE OF THESE CODES IS
  1322. RECEIVED. IF THE PRINTER DONE CODE IS NOT ONE OF THESE CHARACTERS, SDCOM WILL
  1323. TRANSMIT A CARRIAGE RETURN TO THE MAINFRAME AFTER THE PRINTER DONE CODE IS
  1324. SENT. THE PROGRAM RUNNING ON THE MAINFRAME CAN BE PROGRAMED TO WAIT UNTIL IT
  1325. RECEIVES THE PRINTER DONE CHARACTER. BY USING THIS SOFTWARE PROTOCOL, THE
  1326. MAINFRAME CAN WAIT FOR THE PC PRINTER TO FINISH BEFORE SENDING MORE DATA TO THE
  1327. PC OR PRINTER. IF THE PRINTER RUNS OUT OF PAPER OR IS NOT READY WHEN DATA IS
  1328. SENT TO IT BY THE MAINFRAME, NO DATA WILL BE LOST.
  1329.  
  1330. WAIT TO SEND ALT F9 AND CLEAR TO SEND ALT F10
  1331. ----------------------------------------------
  1332. THESE TWO CODES CONTROL WHEN THE MAINFRAME IS READY TO RECEIVE DATA FROM THE
  1333. PC. THE PC DOES NOT SEND ANY DATA TO THE MAINFRAME AFTER THE WAIT TO SEND
  1334. CHARACTER HAS BEEN RECEIVED UNTIL THE CLEAR TO SEND CHARACTER IS RECEIVED. 
  1335.  
  1336. THE PC WILL GO INTO THE WAIT TO SEND STATUS WITHOUT RECEIVING A WAIT TO SEND
  1337. CHARACTER, IF THE "ENTER WAIT TO SEND STATUS AFTER CARRIAGE RETURN" OPTION IS
  1338. "YES". 
  1339.  
  1340. THE WAIT TO SEND AND CLEAR TO SEND CHARACTERS CAN BE CONFIGURED TO MATCH MANY
  1341. DIFFERENT SOFTWARE HAND SHAKING PROTOCOLS. SINCE SDCOM HAS AN INTERRUPT DRIVEN
  1342. 32,000 BYTE BUFFER, THE "WAIT TO SEND/CLEAR TO SEND" IS USED TO DETERMINE WHEN
  1343. THE MAINFRAME IS READY TO RECEIVE DATA.
  1344.  
  1345. XON/XOFF
  1346. --------
  1347. BY SETTING THE CLEAR TO SEND CODE TO HEXADECIMAL 19 (DC3) AND WAIT TO SEND CODE
  1348. TO HEXADECIMAL 17 (DC1) THE PC WILL USE THE XON/XOFF PROTOCOL TO DETERMINE WHEN
  1349. IT CAN TRANSMIT TO THE MAINFRAME. 
  1350.  
  1351. ETX/ACK
  1352. -------
  1353. BY SETTING THE CLEAR TO SEND CODE TO HEXADECIMAL 06 (ACK) AND THE WAIT TO SEND
  1354. CODE TO HEXADECIMAL 03 (ETX) THE PC WILL WORK CORRECTLY. SETTING THE "ENTER
  1355. WAIT TO SEND STATUS AFTER CARRIAGE RETURN" TO "YES" AND SETTING THE CLEAR TO
  1356. SEND CODE TO HEXADECIMAL 06 (ACK) THE PC WILL WAIT FOR THE HEXADECIMAL
  1357. CHARACTER 06 BEFORE SENDING DATA.
  1358.  
  1359. NCR "I SYSTEMS"
  1360. ---------------
  1361. SETTING THE CLEAR TO SEND CODE TO HEXADECIMAL 02 (STX) AND WAIT TO SEND CODE TO
  1362. HEXADECIMAL 04 (EOT) THE PC WILL WORK CORRECTLY WITH THE NCR "I SYSTEMS".
  1363.  
  1364. LF/CR
  1365. -----
  1366. SDCOM CAN BE CONFIGURED TO USE EITHER THE LINE FEED CONTROL CODE, HEXADECIMAL
  1367. 10, OR CARRIAGE RETURN, HEXADECIMAL 0D, AS THE CLEAR TO SEND CONTROL CODE. THIS
  1368. ALLOWS A SOFTWARE PROTOCOL TO BE USED WHEN THE MAINFRAME IS SENDING A LINE FEED
  1369. OR CARRIAGE RETURN AFTER RECEIVING A LINE OF TEXT FROM THE PC. THE CLEAR TO
  1370. SEND CONTROL CODE SHOULD NOT BE SET TO A CARRIAGE RETURN SDCOM IS IN FULL
  1371. DUPLEX MODE.
  1372.  
  1373. F10 EXIT SDCONFIG
  1374. -----------------
  1375. PRESSING THE <F10> FUNCTION KEY WILL TERMINATE THE SDCONFIG PROGRAM. THE USER
  1376. THEN HAS THE OPTION TO SAVE THE CHANGES MADE DURING THE SCREEN DESIGN
  1377. CONFIGURATION SESSION OR NOT. 
  1378. NP
  1379.                             *********************
  1380.                             * THE SDCOM PROGRAM *
  1381.                             *********************
  1382.  
  1383. THE SDCOM PROGRAM IS A COMMUNICATION PROGRAM DESIGNED TO TRANSFER COBOL SOURCE
  1384. CODE GENERATED FROM THE SDCOBOL PROGRAM TO ANOTHER COMPUTER. SDCOM EMULATES AN
  1385. NCR 796-101 TERMINAL BUT IT'S PERFORMANCE IS POOR COMPARED TO OTHER
  1386. COMMUNICATION PACKAGES COMMERCIALLY AVAILABLE, SUCH AS "ANZIO". 
  1387.  
  1388. SDCOM CAN BE USED AS A STANDARD TTY TYPE TERMINAL. THE FOLLOWING TABLE SHOWS
  1389. NCR 796-101 FUNCTIONS PERFORMED BY THE DIFFERENT CONTROL CODES RECEIVED FROM
  1390. THE MAINFRAME. 
  1391.  
  1392.  
  1393. ASCII    DECIMAL        FUNCTION
  1394. -----------------------------------------------------------
  1395. BEL       7        SOUND BELL / UNLOCK KEYBOARD
  1396. LF      10        LINE FEED / MOVE DOWN 1 LINE
  1397. CR      13        CARRIAGE RETURN / MOVE TO COLUMN 1
  1398. FF      12        FORM FEED / ERASE SCREEN
  1399. BS      08        BACKSPACE CURSOR 1 CHARACTER
  1400. VT      11        MOVE CURSOR TO SPECIFIC LINE
  1401. DLE      16        MOVE CURSOR TO SPECIFIC COLUMN
  1402. NAK      21        BACKSPACE CURSOR 1 CHARACTER
  1403. -----------------------------------------------------------
  1404.  
  1405. SDCOM CONFIGURATION IS DEFINED BY EXECUTING THE SDCONFIG PROGRAM. THE FOLLOWING
  1406. TABLE SHOWS HOW SDCOM CAN BE CONFIGURED THRU SDCONFIG FOR SPECIFIC NCR 796-101
  1407. FUNCTIONS. REFER TO THE SDCONFIG PROGRAM DESCRIPTION ABOVE. 
  1408.  
  1409. ASCII    DECIMAL        FUNCTION
  1410. -----------------------------------------------------------
  1411. STX       2        UNLOCK KEYBOARD
  1412. EOT       4        LOCK KEYBOARD
  1413. DC2      18        TURN ON PRINTER
  1414. DC4      20        TURN OFF PRINTER
  1415. -----------------------------------------------------------
  1416.  
  1417. LINE 25 STATUS LINE
  1418.  
  1419. LINE 25 COLUMN 1
  1420. -----------------
  1421. DISPLAYS "1" IF COM PORT 1 IS BEING USED OR "2" IF COM PORT 2 IS USED. SDCOM
  1422. ONLY SUPPORTS COM PORT 1 THRU 4. THE COM PORT USED IS CONFIGURED IN SDCONFIG
  1423. PROGRAM. COM PORT 1 IS THE DEFAULT.
  1424.  
  1425. LINE 25 COLUMNS 3 THRU 6
  1426. ------------------------
  1427. DISPLAYS THE BAUD RATE USED BY SDCOM, AND IS CHANGED IN SDCONFIG PROGRAM. 9600
  1428. BAUD IS THE DEFAULT.
  1429. NP
  1430. LINE 25 COLUMN 8
  1431. -----------------
  1432. DISPLAYS THE PARITY OPTION USED. CHANGED IN SDCONFIG, EVEN PARITY IS THE
  1433. DEFAULT. THE TABLE BELOW SHOWS THE DIFFERENT PARITY OPTIONS AVAILABLE.
  1434.  
  1435. CODE    OPTION
  1436. ---------------------------------------------------------
  1437. E    EVEN PARITY
  1438. O    ODD PARITY
  1439. N    NO PARITY (USED WITH 8 DATA BIT WORD LENGTH)
  1440. M    MARK PARITY
  1441. S    SPACE PARITY
  1442. -----------------------------------------------------------
  1443.  
  1444. LINE 25 COLUMN 10
  1445. -----------------
  1446. DISPLAYS HOW MANY BITS PER TRANSMITTED BYTE. CHANGED IN SDCONFIG PROGRAM. MOST
  1447. DATA COMMUNICATION USES EITHER 7 DATA BITS AND EVEN PARITY OR 8 DATA BITS WITH
  1448. NO PARITY.
  1449.  
  1450. LINE 25 COLUMN 12
  1451. -----------------
  1452. DISPLAYS HOW MANY STOP BITS PER TRANSMITTED BYTE. CHANGED IN SDCONFIG PROGRAM.
  1453. MOST APPLICATIONS USE 1 STOP BIT.
  1454.  
  1455. LINE 25 COLUMNS 14 THRU 20
  1456. --------------------------
  1457. DISPLAYS WHETHER THE KEYBOARD ECHO OPTION IS ON OR OFF. IF ALL CHARACTERS TYPED
  1458. INTO SDCOM APPEAR TWICE, THE OPTION SHOULD BE SET TO "NO ECHO" IN SDCONFIG. IF
  1459. TYPED IN CHARACTERS DO NOT APPEAR ON THE SCREEN THIS OPTION SHOULD BE SET TO
  1460. "ECHO ON". "ECHO ON" IS THE DEFAULT OPTION AND IS CHANGED IN SDCONFIG. SDCOM
  1461. WILL RUN MUCH FASTER IF THE "ECHO ON" OPTION IS USED BECAUSE SDCOM DOES NOT
  1462. HAVE TO WAIT FOR THE MAINFRAME TO ECHO THE CHARACTERS BACK TO THE PC.
  1463.  
  1464. LINE 25 COLUMNS 22 THRU 23
  1465. --------------------------
  1466. DISPLAY WHETHER THE LINE FEED ON CARRIAGE RETURN OPTION IS ON. IF THE COLUMNS
  1467. ARE BLANK THEN THE LINE FEED OPTION IS OFF. IF "LF" IS DISPLAYED, SDCOM WILL
  1468. MOVE DOWN TO THE NEXT LINE WHEN A CARRIAGE RETURN IS RECEIVED FROM THE
  1469. MAINFRAME OR KEYBOARD. IF THE TEXT ON THE SCREEN APPEARS DOUBLE SPACED THEN
  1470. THIS OPTION NEEDS TO BE OFF. IF SCREEN TEXT ON THE SCREEN IS WRITING OVER THE
  1471. PREVIOUS LINE THIS OPTION NEEDS TO BE ON.
  1472.  
  1473. 1 UPLOAD THRU 10 EXIT
  1474. ---------------------
  1475. LINE 25 COLUMNS 25 THRU 80 DISPLAYS THE HELP MENU FOR FUNCTION KEY PROCESSES
  1476. EXPLAINED BELOW.
  1477. NP
  1478. 1 UPLOAD
  1479. --------
  1480. BY PRESSING THE <F1> FUNCTION KEY, THE USER STARTS THE FILE UPLOAD / TRANSFER
  1481. PROCESS. THE MAINFRAME COMPUTER SHOULD BE SET TO RECEIVE THE FILE AT THIS
  1482. POINT. THE USER WILL BE PROMPTED FOR THE INFORMATION REQUIRED BY SDCOM TO
  1483. PERFORM THE FILE TRANSFER. THE FIRST TRANSMISSION OF DATA RECEIVED BY THE
  1484. MAINFRAME AFTER THE USER HAS ANSWERED ALL SDCOM'S PROMPTS IS THE FIRST LINE OF
  1485. THE FILE TO UPLOAD.
  1486.  
  1487. AFTER THE USER PRESSES THE <F1> FUNCTION KEY, THE USER WILL ASKED IF HE WANTS
  1488. TO START THE UPLOAD PROCESS. IF THE USER RESPONSES WITH "N" THE FILE TRANSFER
  1489. WILL NOT BE PERFORMED. ANSWERING "Y" WILL START THE UPLOAD PROCESS. THE USER
  1490. WILL BE PROMPTED FOR THE PC FILE NAME TO UPLOAD AFTER ANSWERING "Y" TO THE
  1491. START UPLOAD PROCESS PROMPT. 
  1492.  
  1493. IF SDCOM IS NOT CONFIGURED FOR RECORD LENGTH 80, AND RECORDS PER BLOCK IS 1,
  1494. THE USER WILL BE ASKED IF THE LINE NUMBERS FROM THE UPLOAD FILE ARE TO BE
  1495. DROPPED. IF THE USER RESPONSES WITH <Y>, SDCOM WILL REMOVE THE FIRST 6
  1496. CHARACTERS OF EACH UPLOAD LINE. THIS OPTION IS USED IF THE MAINFRAME EDITOR IS
  1497. ASSIGNING THE PAGE LINE NUMBER OF THE COBOL TEXT LINES BEING TRANSFERRED FROM
  1498. THE PC. SDCOM WILL NOT REMOVE THE FIRST 6 CHARACTERS OF EACH LINE IF THE
  1499. RESPONSE IS "N".
  1500.  
  1501. AFTER THE UPLOAD QUESTIONS, SDCOM WILL BEGIN THE FILE TRANSFER PROCESS. DURING
  1502. THE FILE TRANSFER PROCESS, LINE 25 IS CHANGED TO THE UPLOAD HELP LINE. THE LEFT
  1503. PORTION OF LINE 25 DISPLAYS PC FILE NAME BEING UPLOADED. PRESSING THE <F1>
  1504. FUNCTION KEY DURING THE FILE UPLOAD WILL CAUSE SDCOM TO ASK IF THE UPLOAD
  1505. PROCESS IS TO BE ABORTED.
  1506.  
  1507. LINE 25 COLUMNS 61 THRU 72 DISPLAYS THE CURRENT SDCOM UPLOAD STATUS. WHILE DATA
  1508. IS BEING TRANSFERRED THIS STATUS BLOCK WILL DISPLAY "UPLOADING". AFTER THE
  1509. TRANSFER OF A BLOCK OF DATA IS COMPLETED, COLUMNS 61 THRU 72 WILL DISPLAY WHY
  1510. SDCOM IS WAITING BEFORE SENDING THE NEXT BLOCK OF DATA TO THE MAINFRAME. THE
  1511. FOLLOWING TABLE LISTS THE DIFFERENT WAIT OPTIONS AVAILABLE IN SDCOM. 
  1512.  
  1513. WAIT MESSAGE    DESCRIPTION
  1514. -----------------------------------------------------------
  1515. WAIT CR        SDCOM HAS BEEN CONFIGURED TO WAIT FOR A 
  1516.         CLEAR TO SEND CONTROL CODE FROM THE 
  1517.         MAINFRAME.
  1518.  
  1519. LINE DELAY X    SDCOM IS WAITING X SECONDS BEFORE SENDING 
  1520.         THE NEXT BLOCK OF DATA, ALLOWING TIME FOR 
  1521.         THE MAINFRAME TO PROCESS THE LAST BLOCK OF 
  1522.         DATA.
  1523.  
  1524. WAIT XXX    SDCOM HAS RECEIVED A WAIT TO SEND CONTROL 
  1525.         CODE FROM THE MAINFRAME WITH XXX BEING 
  1526.         THE CONTROL CODE.
  1527. -----------------------------------------------------------
  1528.  
  1529. PRESSING THE <F4> FUNCTION KEY CLEARS SDCOM WAIT STATE SO THE NEXT BLOCK OF
  1530. DATA CAN BE SENT. THE UPLOAD STATUS WILL BE CHANGED TO "CLEAR KEY" WHEN THE
  1531. <F4> KEY IS PRESSED.
  1532.  
  1533. 2 FF
  1534. ----
  1535. ALLOWS THE USER TO SEND A FORM FEED, HEXADECIMAL 0C, TO THE PRINTER. HANDY WHEN
  1536. USING THE PRINT SCREEN FUNCTION.
  1537.  
  1538. 3 SAVE SCREEN
  1539. -------------
  1540. ALLOWS THE USER TO SAVE LINES 1 THRU 24 OF A SCREEN TO A PC DISK FILE. THIS
  1541. DISK FILE CAN BE MODIFIED BY THE SDEDIT, OR LOADED INTO A WORD PROCESSOR FOR
  1542. SOFTWARE MANUALS.
  1543.  
  1544. 4 RESET
  1545. --------
  1546. CLEARS THE WAIT STATUS DISPLAYED IN COLUMNS 61 THRU 72. 
  1547.  
  1548. 10 EXIT
  1549. -------
  1550. ALLOWS THE USER TO TERMINATE THE SDCOM PROGRAM.
  1551.  
  1552.  
  1553.