%ė VAX-11 Librarian V03-00ā ° °"āą °"uÄv5BackupŒClockž Draw_treeÔ Explain_Error†HELPdInsert_WP_Queue šPF đProblem@QDū ResequencešReset_TerminalN RMS_ErrorōStripœ Transform$UDK%ÎVAXNETqėVWQr Word_File­ä°"1 BackupDWhen the BACKUP command is invoked, JNLBACKUP, the journaling backupprocedure will start up.C JNLBACKUP is a VAX command procedure which is used to back up Cfiles to tape and to keep a journal log of the files backed up and Athe tapes used for the backup. Complete documentation on how to Huse JNLBACKUP is found in FE-2521 (see the Fusion Experiments secretary for a copy). = JNLBACKUP can be used to backup any or all files in yourAdirectory(ies) which have been created since a certain date. TheCbackup accuracy is automatically verified. The backed up files areDstored in a VMS BACKUP container file which is automatically given aEunique save-set name. Multiple backups may be done to a given backup>tape. The various times JNLBACKUP is used is logged to a file<(JNLBACKUP.LOG) showing the tape name and number, the dates,Adirectories and the files selected for backing up. This log fileCtogether with the journal file (JNLBACKUP.BJL) containing a list ofFall backed up files, can be used to recover one or more files from thespecific backup set required. ww­`Į-°"1 ClockHAfter all what good is a terminal if it can't be used as an alarm clock?GWell it can. Enter the update interval (anywhere from 10-59 seconds isFfine), and the time you want the alarm to go off. If you want to exitearly, type ^Y.ww­@&&°" 1 Draw_treeFDRAWTREE will draw out a directory tree on VT100 compatible te rminals.EYou will be prompted for the root directory. It must be a top level Hdirectory. For exampel DRA0:[DOWNWARD] or [DOWNWARD] are valid entries.,However, DRA0:[DOWNWARD.COMFILE] is invalid.ww­ Ô0°"1 Explain_ErrorESomehow, something didn't work and all you have in way of explanationGis a strange hexadecimal error code returned in the DCL symbol $STATUS.AWell, feed the error code to Explain_Error, and if it is a systemCerror it will give the english text for the error, and the text keyBunder which more information can be looked for in the System ErrorMessage and Recovery manual. ww­ P°"1 HELP To select a choice use: VT100 VT2xx FunctionA Up Arrow Prev Screen View previous page of choices> Dwn Arrow Next Screen View next page of choicesww­`ü9°"1 Insert_WP_QueueBIWQ provides a method for inserting documents into the WP TransferAQueue. Please note, in general it should not be used. DocumentsEtransfered in this manner do not get transfered with the right formatA(margins, line width, etc.) to the word processing system. this Drequires the secretaries to spend considerable time (which otherwise-need not be spent) reformatting the document.DIWQ will prompt for a document name. Give it one. If the document Bexists, it will be entered. Note, when the document is transferedDto the WP, an attempt will be made to delete it (transfer documents Dare by definitio n SCRATCH). Do not delete the document, or edit, orAchange it until it is transfered as that will only confuse thingsfor the secretaries.ww­ĀĒD°"1 PF (Process_Files)H PF will display the files which a given process currently has open.GToolBox will prompt for the process name you wish to gather informationon and then issue the command; $ PF Process_NameEIf necessary, ToolBox will first define the PF comand by issuing the command $ SET COMMAND SYS$UTI LITY:PF@Note: 1. Only privileged users may inquire as to open files on ) processes other than their own.C 2. No information is given for processes occuping no memory ! (NULL, SWAPPER, etc.) .ww­ YO°"1 Problem ReportingG When a user encounters a problem which might be system related (asCopposed to just not knowing how to use the system), the user should>submit a VAX Problem Report (VPR) to notify the VAX managementAthat a problem exists and to document the conditions necessary toreproduce the problem. D Except for emergencies, this method of submitting a problem forFresolution is far preferable to lining up outside the system manager'sDoffice! First, the problem statement gets written down. This makesFit easier to track the problem down. Second, the answers are saved andEare available for all to see. If a problem has already been answered,Dtime will be saved by not having to research the problem a second or third time. E The VPR (Vax Problem Report) should consist of a short, one-lineCstatement of the problem, followed by a detailed description of theEproblem and the problem's impact on the work-in-progress. It is veryFimportant to go into considerable detail in describing the problem and2the conditions present when the problem occurred. @ Once the VPR has been submitted, management will attempt to@duplicate the problem and will mail back a reply deliniating theFstatus or resolution of the VPR. In the event that the problem can beEeasily solved, a solution or work-around will posted and notificationBthat an answer exists will be mailed back. The VAX Problem Report4procedure then can be used to read the answer.In theDevent that the problem can not be duplicated, the user will be askedCfor additional information. If the problem can be duplicated, theAVPR will either be 1) sent in to DEC as an SPR (if the problem isDcaused by DEC's software) or scheduled (according to its  importance)&for in-house work at some later date. ww­€ 1. No VAX-11 FORTRAN keyword (e.g. DO, IF, READ, etc.) may beA split and continued on the next line. Any part of the statement@ following the keyword may be continued but RESEQUENC may change the continuation break.= 2. Arbitrary limits have been set as to the number of labels@ that may be resequenced at once. See first few lines of source5 for parameters that may be reset to increase limits.; 3. No more than 32767 source code statements may be in any one file RESEQUENCE'd.B 4. Comments nested within continued executable FORTRAN statementsB will produce unpredictable results. Non-executing FORTRAN (e.g.,B FORMAT, DATA, EQUIVALENCE) may be commented without reprecussion.2 Use1To use RESEQUENCE, make the following assignment:) RES*EQUENCE:==$SYS$UTILITY:RESEQUENC.EXE 2 Location- RESEQUENC was taken from [DECUS.VAX83A.BALL]ww­Ā‡˛°"1 Reset_TerminalD The Reset_Terminal command will reset your VT100/VT2xx terminalAto its power up state. It issues the command @SYS$COMFILE:RESET.ww­•ĩ°" 1 RMS_Error; Somehow you got an error message with an RMS error number.;What does it mean? Well give it to RMS_Error and find out.ww­ 6Ŋ°"1 StripG The STRIP option is used to strip off trailing blanks and sequenceFnumbers from a file. A typical situation occurs when bringing over anEIBM file wiich is padded with trailing blanks out to column 72 and aneight digit sequence number.E The strip option takes a valid file name as an input and outputs=a stripped file with the same name but higher version number.ww­ Pð" 1 Transform@ This program will transform the file specified from one type ofB carriage control to another. It will also perform bolding, rightB justification, and top of page margin insertion services as well. Syntax:" TRANSFORM input output: Command Definition: TRANSFORM :== $SYS$UTILITY:TRANSFORMB If the type of carriage control to use for the output file is not) specified it will be assumed to be LIST.2 Carriage_control_types< The types of carriage control files that are supported are:D LIST - This is the type of file EDT creates and a DIRECTORY/FULLD shows as 'carriage control'. There is no explicit carriage F control for each line of the file. Each line is treated as ifF there were a before the line and a following it. ItB is however possible to have additional , , & & characters stored in the file.C FORTRAN - This is the type of file a Fortran program creates byD default. The 1st character of each line is assumed to be a F Fortran carriage c ontrol character. See the Fortran Reference@ manual for details on what each type of character means.D NONE - This is the type of file created by RUNOFF. There is no = assumed carriage control, instead , , & 5 characters are explicitly stored in the file.@ PRINT - This is the type of file created by the PAC II & III@ project management system and a DIRECTORY/FULL shows as ? 'Print file format'. The carriage control information C  is stored in a seperate 2 byte fixed control field for eachC record on disk. This fixed control field is not typically 9 available to most utilities and Fortran programs.D This type of file may ONLY be used as input to the TRANSFORMB program. The output file may be either LIST, FORTRAN, or A NONE. Also, there is no file qualifier for specifing theC input file as a 'print file format' file. The program mustD determine this for its elf by checking the file when it opens it. 2 Parameters2 There are 2 parameters required for this command:B input - this is the name of the file to be transformed. If noD carriage control type is explicitly specified then the input1 file's own carriage control type is used.E output - this is the name of the file where the transformed input> file is to be stored. If no carriage control type is E explicitly specified for the output file, it is assumed to be LIST.2 Command_Qualifiers /ASIS (D)F This qualifier specifies that the file is to be transformed from one ? carriage control type to another without any bolding or right ! justifiction services performed. This is the default./BOLD[=n] (D=1)/NOBOLDD This qualifier specifies that the file is to have bolding services B performed upon it. If /BOLD is specified, then the file will be C bolded. If /NOBOLD is specified, then all bolding currently in a  file will be removed.C 'n' specifies the number of times each line is to be over written.F If 'n' equals 1 it will be over written once, if 'n' equals 2 it will be over written twice, etc...D Typically this value should be 1 or 2 to generate an excellent copyF ready for Xeroxing. If the value is too high it will cut through the- paper and could cause damage to the printer. /RIGHT=n/NORIGHTE 'n' = positive - This qualifier will pad each line on the left withE the specified n umber of blanks. This will allow you to rightE justify a file so that when it is printed the file will beE positioned where you want it on the page (most likely you want toE center it, but this is up to you and the amount of right justification you specify). E 'n' = negative - If the value specified is negative, then theE specified number of leading blanks will be removed from theE beginning of each line. In this case if the line is  shorter thanE the number of blanks to be removed, a blank line will be output. IfE a non-blank character is encountered before the specified number ofE blanks are removed from a line then negative right justification isE stopped for that line and the non-blank character found is the first9 character on the line. Tabs are NOT the same as blanks.? 'n' = zero - no justification performed. This is the default./DOWN=n/NODOWND 'n' = positive - This qualifier will cause TRANSFOR M to output 'n' D blank lines following a form feed character or Fortran top of E page carriage control character (a 1 in column 1). This will allow ? you to supply a larger margin at the top of the page then was C supplied by the original file when printed on the desired printer.B 'n' is less then or equal to zero - no lines are inserted at the) top of each page. This is the default. E Restriction/Limitation - At the current time TRANSFORM only inserts D the blank lines follo!wing an explicit top of page carriage control D in the file. What this means to you is that if your file does not D begin with a top of page carriage control, the first page will not @ have the added top of page margin. In addition, some programs F attempt to only output a top of page carriage control when they must D skip lines at the bottom of the page. If the number of lines they E have to put onto a page is exactly equal to the number of printable E lines on the page, they will let the "printer just naturally skip to > the top of the next page instead of outputting a top of page C carriage control. Pages of this nature will also not receive the " your desired top of page margins.2 File_qualifiers/LISTD Input - When placed on the input file this qualifier specifies that? the type of carriage control the file actually has is to be/ ignored and LIST carriage control assumed. F Output - When placed on the output file this qualifier specifies thatA the inpu #t file is to be transformed to LIST carriage control 7 format and written to a LIST carriage control file./FORTRAND Input - When placed on the input file this qualifier specifies that? the type of carriage control the file actually has is to be2 ignored and FORTRAN carriage control assumed. F Output - When placed on the output file this qualifier specifies thatD the input file is to be transformed to FORTRAN carriage control : format and written to a FORTRAN carriage con$trol file./NONED Input - When placed on the input file this qualifier specifies that? the type of carriage control the file actually has is to be/ ignored and NONE carriage control assumed. F Output - When placed on the output file this qualifier specifies thatA the input file is to be transformed to NONE carriage control 7 format and written to a NONE carriage control file.2 Source_location?TRANSFORM is taken from [VAX84A.LN.TRANSFORM]. Sources are on DUA0:[SYSU %TL.TRANSFORM]ww­ĀE°"1 UDKEUDK stands for User Defined Key. A VT2xx terminal may be loaded withFup to 255 characters of text for use with User Defined Keys. When theFShift key and one of the keys F6-F20, HELP, or DO is pressed, the textIstored for that UDK is sent to the system. To load the terminal's UDK's,Ifirst a UDK load module is created which is an ASCII text file containingLthe text to load (in HEX) and designating the key to which it is associated.FThe UDK &generator allows one to simply generate a UDK load module. ToKload the UDK at some later date, simply requires TYPING the UDK load moduleGto the terminal (eg $TYPE F6.UDK). The UDK generator will load the UDKHyou define into the terminal and optionally create a UDK load module forFuse at a later date. If one wants to enter a Carriage Return into theBUDK (so a command is sent automatically to DCL, for example) use a~ to designate .ww­ ˛O°"1 VAXNET!/! VAXNET.HLP by 'Robin Miller on April 12, 1984.!G VAXNET is a program which allows communcations between two computersG using an asynchronous terminal port. The systems can be connectedG either directly using a null modem cable or via a dialup modem.G Communications with the remote system is accomplished using a second port on the local system.G After the initial dialogue, you simply login to the remote system asG an interactive user. If a log file was specified, all output from (theG remote system is written to the log file. Thus, if you want to copyG a file from the remote system to the local system, simply display theG file at the terminal using the TYPE command. If you want to send aG file to the remote system, open a file using the CREATE command, then< use the VAXNET DUMP command to send the file to the remote.G An alternate method of transferring files requires a program calledG SNDRCV on the remote system. This program allows transmissi )on ofG ASCII files with error checking. A program called MISH can be used toG convert any type of file into printable ASCII for file transmission.G Refer to the MISH and SNDRCV help sections for details on using these programs. 2 AUTO_LOGINC This command is used to automatically login to the remote systemC when you are using an auto-dial modem. To use this command,C several DCL symbols described below must be defined to describe the login sequence:= $ LOGIN_START *:== "^M" ! To start VMS login.A "HEL^M" ! To start RSX-11M login.= "^C" ! To start MIT login.B This symbol defines the character(s) to send the remote to getB the login started. All characters preceeded by the up-arrow areB converted to control characters. Thus, the ^M above is convertedB to a carriage return. These character(s) are sent in one secondB intervals until the remote system responds. For + systems whichB display its' login prompt automatically, this symbol doesn't need to be defined (i.e., EASYLINK).= $ LOGIN_PROMPT :== "Username:" ! Prompt for VAX/VMS.= "Account or name:" ! Prompt for RSX-11M.? "U#" ! Prompt for Crossfile.> "ID?" ! Prompt for EASYLINK.B This symbol defines the characters the remote system sends forB its' login prompt. The login command will not be sent un,til this$ prompt is received from the remote. $ LOGIN_CMD :== "ROBIN/NOCOM"B This symbol defines the characters to send in response to the login prompt. $ PASS_PROMPT :== "Password:"B This symbol defines the password prompt displayed by the remoteB system. If specified, VAXNET waits for this string before sending the password string. $ PASSWORD :== "your_password"B This symbol defines the characters to send in response to theB password prompt. For systems- which specify the password on the7 login command line, this symbol should not be defined.0 $ LOGIN_ERROR :== "User authorization failure"C This symbol defines the login error displayed by the remote systemC if the login is invalid. If this message is detected, the login) is retried up to three times by default.B The following symbols can be defined for a secondary login. They4 perform the same function as those described above.. $ LOGIN_PROMPT2 :== "secondary login prompt"/ . $ LOGIN_CMD2 :== "secondary login command"1 $ PASS_PROMPT2 :== "secondary password prompt"* $ PASSWORD2 :== "secondary password"5 $ LOGIN_ERROR2 :== "secondary login error message" 2 BAUD_RATEC This command is used specify the baud rate of the remote computer.D VAXNET automatically sets the remote port to the speed you specify.C If you are communicating with the remote system using a dialup6 modem, the baud rate will be either 300 or 1200 baud. The valid baud ra/tes are:4 50, 75, 110, 134, 150, 300, 600, 1200, 1800,5 2000, 2400, 3600, 4800, 7200, 9600, or 19200.2 CABLEC A null modem cable is required to communicate directly between twoC computers without using modems. A straight through cable isB normally used with modems. This cable is constructed as follows:. WIRING DIAGRAM FOR NULL MODEM CABLE1 TD 2 ..................... 3 RD1 RD 3 ..................... 2 TD2 0 GND 7 ..................... 7 GND2 DSR 6 ..................... 20 DTR2 DTR 20 .................... 6 DSR2 COMMAND_FILEC A command file can be specified at the Vaxnet command prompt toC allow you change many parameters or to execute many commands. IfC you don't specify an extension, it defaults to .COM. If any errorsC occur while executing these commands, the command file is closedC immediatly. The symbol VAXNET_CMD can be defined w1ith the name ofC the command file to automatically change parameters at startupC time. The command lines can be in either upper or lowercase sinceA the command line is converted to all uppercase after being read. Command format: Vaxnet> @VCMD Contents of file VCMD.COM: protocol xmodem file_type binary status 2 CROSSFILEC This command is used with the GE Crossfile System. After the modemC is online, the character "H" is sent in one second in 2tervals untilC the login prompt "U#:" is received. This command is automatically< executed at startup time when the system type is CROSSFILE.2 DCLC There are two commands used to execute a DCL command. If you typeC "$ dcl_command", the command is executed without copying the DCLC symbols and logical names. If you type "SPAWN dcl_command", theC DCL symbols and logical names are copied. With either command, if: a DCL command is not specified, a new process is created.' For e3xample, to get a directory, type: Vaxnet> $ DIRECTORY2 DEBUGC This command is used to display addition information in fileC transfer mode (GET or SEND). It also displays several additionalC lines in the STATUS report. To disable debug mode, use the NODEBUG command.2 DECHOC This command is used to enable or disable the display of the echoC from the remote system when dumping a file. By default the echoC is enabled. If local echo is enabled, VAXNET simulates t 4he remoteC echo by displaying the last line dumped to the remote. Use the* command NODECHO to disable the dump echo.2 DIALC This command is used to specify the phone number for the auto-dialC modem to dial. The modem is automatically hungup before attempting to dial the new phone number. 2 DISPLAYC This command is used to enable or disable the display used duringC file transmissions. If the local terminal is a scope, a one lineC status report is displayed every 25 reco5rds (by default) to letC you know its working. If your terminal is a hardcopy or if runningC in batch, this display is disabled. The DCL symbol DISPLAY_RECORDC can be defined to change the frequency of the record display. IfC you specify zero, the display is disabled. The status report canC be obtained at any time during the transmission by typing the escape key. Command format:# Vaxnet> DISPLAY [n] or NODISPLAY DCL symbol: $ DISPLAY_RECORD :== 100 2 DUMP 6_FILEC This command is used to dump a file to the remote system. It isC usually used if the remote system doesn't have the SNDRCV program.C When using this command, there must be a program running on theC remote system to accept the characters being dumped to it. UsingC the "CREATE file_name" command works very nice. When the end ofC file is detected, you can optionally have a dump terminator sentC by specifying the symbol DUMP_TERM. The default dump read timeout@ is thre7e seconds if the remote echoes, zero if it doesn't echo. Command format:' Vaxnet> DUMP file1, file2, ... filen DCL symbols:? $ DUMP_TIMEOUT :== 1 ! The dump read timeout in seconds.@ $ DUMP_DELAY :== "00.25" ! Delay between dumping each record.= $ DUMP_ECHO :== N ! Disable echo of dumped records.9 $ DUMP_TERM :== "^Z" ! Send CTRL/Z at end of file. 2 EASYLINKC Western Union's EASYLINK service is an advanced electronic mailC service offering a b 8road range of value-added communicationC features designed to meet today's business needs. EASYLINK canC satisfy user's needs for simple, convenient, quick and low-cost message communications.C A subscriber to EASYLINK can send and receive messages between andC among other EASYLINK subscribers. A subscriber can also sendC messages to destinations served by TELEX I, TELEX II (TWX),C INTERNATIONAL TELEX, INFOCOM, and as MAILGRAMS, TELEGRAMS, and INTERNATION 9AL CABLEGRAMS.C Subscribers can prepare and send messages using most existing dataC terminals, word processors and personal computers equipped withC dial telephone communications capability. Subscribers can chooseC between two message delivery methods. One choice is to have theC messages delivered directly to any of the above devices equippedC with automatic answer capability. The other choice is to haveC messages delivered to and held in an electronic mailbox, for later :. retrieval by a subscriber at his convenience.9 The rest of the EASLINK documentation was removed9 since it is quit lengthy. It can be recreated by9 using a VAXNET logfile and typing /HELP commands, to EASYLINK after getting logged in.2 ECHOC This command is used to enable or disable local echo. For systemsC which don't echo characters sent to it, VAXNET does a local echo.C This command isn't normally used since VAXNET automaticallyC enables ; or disables echoing based on the remote system type. The. command NOECHO is used to disable local echo.2 EXITC This command is used to exit from VAXNET. You can also exit byC typing a CTRL/Z. The log file (if open) is closed, and the modemC is automatically hungup if you were using a modem. If a log fileC is being closed, the command "REF log_file_name" is executed when0 exiting to automatically reformat the log file. 2 FILE_TYPEC This command sets up the type of file <to be tranferred when usingC the KERMIT or XMODEM protocol (VAXNET protocol is ASCII only). The default file type is ASCII. Command format:$ Vaxnet> FILE_TYPE ASCII or BINARY 2 GET_FILEC This command is used to GET (receive) a file from a remote system.C The remote system MUST be running the SNDRCV program beforeC issuing this command. If you don't specify the file names on theC command line, you are prompted for the names. If you type theC RETURN key for the = VAX file name, the REMOTE file name is used.C At the present time, only one file at a time can be tranferredC from the remote system (no wildcards). While the file transmissionC is in progress, you can type the ESCAPE key to get a one line# status report of the current file. Command format:# Vaxnet> GET remote_file vax_file 3 REMOTE_FILEC The REMOTE file name must be a legal file specification for theC system you are talking to. At the current time, only one fi>le at time can be transferred. 3 VAX_FILEC The VAX file name can be any VAX file specification. If you typeD the return key, the remote file name is used on the VAX. The C remote file name is taken exactly as is. This includes theC directory name (i.e., [1,24] or [ROBIN]). If you don't have theC specified directory on the VAX, you will have to specify the VAX file name.2 HANGUPC This command is used to hangup the modem. The modem is hungupC automatic ?ally when you exit VAXNET and also before an auto-dialC is attempted. If you are using a modem, insure the remote port is+ setup as modem with the following command:! $ SET TERMINAL TTcn:/MODEM/PERMC If the remote port is not setup as modem, all auto-dial questionsC (and/or symbols) are bypassed, and the modem is not hungup whenC VAXNET exits. If you don't want the modem hungup when you exit,- issue the "NOHANGUP" command before exiting.2 HELP7 Help can be obtained @on a particular topic by typing :* HELP topic subtopic subsubtopic ...* A topic can have the following format :D 1) an alphanumeric string (e.g. a command name, option, etc...) 2) the match-all symbol "*"@ 3) any of the above followed by "..." (on first topic only) Examples: HELP GET HELP SEND...7 Abbreviations result in all matches being displayed. 2 INTERRUPTC This command is used to specify the interrupt character. TheC interrupt A character is the character you type to get to commandC level (the Vaxnet> prompt). Any character except for carriageC return, escape, question mark, or exclaimation point can be used.C All characters except the interrupt character are sent to the# remote system in interactive mode.2 INTROC VAXNET is a program which allows communcations between twoC computers using an asynchronous terminal port. The systems can beC connected either directly using a null modem Bcable or via a dialupC modem. Communications with the remote system is accomplished) using a second port on the local system.C When VAXNET is prompting you for a question, you have the following options:; o typing the escape key or typing "?" will give you help,B o typing an exclaimation point (!) followed by the return key& backs up to the previous question.B o typing the return key selects the default answer if there is? one. Default answers are show Cn in parenthesis; i.e., (DEC)* o typing a CTRL/Z will exit from VAXNET.C If you are communicating with the remote system, and you want toC exit, you must first type the interrupt character to get to4 command level, and then type either CTRL/Z or EXIT. 2 LOG_FILEC This command allows you to specify the name of a log file to writeC the output from the remote system. If you don't specify a fileC extension, .LOG is appended automatically. The output from theC remote s Dystem and questions asked by VAXNET (unless disabled) areC written to both the log file and the terminal. Use the NOLOG_FILE' command to close the current log file. 3 REFORMATC After exiting from VAXNET, the log file must be reformatted. TheD log file is created with 512 byte records with no carriage control.D A program called "REF" is used to reformat the log file to generateC an file with implied carriage control. After reformatting, the; file is in a format which can then be eEdited (if desired).C If a log file is being closed when VAXNET exits, then command lineC "REF log_file_name" is automatically executed to reformat the logC file. You must have a symbol setup to start the reformat program.D Additional help is available from within REF by typing "REF /HELP". For example: $ REF :== $SYS$SYSTEM:REF 4 REF_HELPC REFormat is a program used to convert input files into variableC length output files with implied carriage control. During thisFC conversion, the control characters NULL, XON, XOFF, and DELETE areC stripped. The program will also optionally do ASCII to EBCDIC andC EBCDIC to ASCII conversions. This program is generally used to( reformat the RSXNET & VAXNET log files. Command line format:. input_file/switches output_file/switches Where switches are:8 /ASCII - Convert input file from ASCII to EBCDIC.8 /EBCDIC - Convert input file from EBCDIC to ASCII.; /VFU - Input file contain Gs line printer VFC bytes.C /TOTAL - Display number of records and bytes in output file.< /BACK (D) - Remove delete sequences from the input file.E /ESC (D) - Break output records on cursor positioning sequences.? /NAME (D) - Output the name of the reformatted output file.D Switches can be negated by prefixing the switch with a '-' or 'NO'.3 OPEN_LOG_FILEC If a log file is already open, you have the option of either usingC the current log file, or you can close the H current log file and specify a new log file name.2 LOCALC This command is used to enable or disable writing local output toC the log file. Local output includes questions and all statusC reports output by the program. If you only want remote output/ in the log file, answer "No" to this question. 2 MISHC MISH is a program used to compress and convert input files intoC printable ASCII files. These files can be submitted on HASPC reader streams and cIan be transmitted using VAXNET/RSXNET. AfterC the file is received at the remote system, MISH is then used toC decompress the files back into their original file format. AllC file attributes are restored using the header record from the compressed file.  Command line format: - input_file/switches output_file/switches  Where switches are: H /ANALYZE - Used to analyze the header record and/or data of a fileD which has been compressed. J Additional sub-switches@ that can be used are /DATA, /OCTAL, & /REVERSE.C /COMPRESS - Used to compress files. This is the default mode.J /DECOMPRESS - Used to decompress files into their original file format. 2 MODEM_TYPE9 VAXNET supports the following types of auto-dial modems:@ DF03 - for the DEC DF03 auto-dial modem. The DF03 only works1 with rotary (pulse) dialing telephones. @ RIXON - for the RIXON R212A auto-dial modem. The R212A works@ K with both rotary (pulse) and tone dialing telephones.C If you are not using an auto-dial modem, typing the RETURN key2 bypasses the remaining auto-dial modem questions.C If the remote port is not setup as /MODEM, all auto-dial questionsC (and/or symbols) are bypassed, and the modem is not hungup when VAXNET exits. 2 MODEM_USAGEC Once the port being used is patched in properly (see "HELPC REMOTE_PORT"), the modem connection can be established. The phoneC L call to the remote system MUST be made from the phone being usedC for the modem. You CAN NOT transfer the call to the modem as you: can with synchronous modems; you'll loose the connection.? Use the following procedure to manually orginate a phone call:@ o the voice/data switch must be in the voice position to placeC the call. Make sure the Data Terminal Ready (TR) lamp is lite.B o After you establish the connection with the remote system, youC will hear the carrier signMal (high pitch), place the voice/data switch in the data position.@ o Once in the data position, you should see to following LEDs:E VADIC: Data Set Ready (DSR), Clear To Send (CTS), Carrier (CXR), and High Speed (HS).< RIXON: Data Set Ready (MR), Carrier (MC lamp goes out), and High Speed (HS).E DF03: Data Set Ready (DSR), Carrier (CAR), and High Speed (HS).@ Note: The High Speed (HS) LED is only lite if at 1200 baud.2 NEW_FEATURESC Thi Ns section describes problems fixed and new features available with VAXNET Version 7.0:; o VAXNET no longer gets hung in an MWAIT/HIBERNATE state.3 o Running in batch mode is now detected properly.C o Terminal generated XOFF/XON is now handled properly. The VT100C can now be used in smooth scroll and the NO SCROLL key now works properly.C o The help module previously written in BLISS has been rewitten9 in FORTRAN. All of VAXNET is now written in FORTRANO.@ o Additional DCL symbols used in dump file. See DUMP section.D o The logical name VAXNET$PORT can be defined for the remote port.D o The DISPLAY command is used to enable/disable or alter how often? the record statistics are output during file transmissions.D o The REF command is used to enable/disable automatic reformatting of the log file.: o The PAUSE command will pause VAXNET if it was spawned.C o The SPAWN and "$" commands are used to spawn DCL commands. Th PeD SPAWN command copied DCL symbols and logical names while the "$"B command does not (for speed). If no DCL command is specified, a new process is created.C o The TYPEAHEAD command specifies the limit the remote typeaheadB buffer is allowed to reach before reading the characters. TheD value is currently set at 32 to allow XOFF/XON to work properly.C o The WATCH command is used to enable/disable watching file names% being copied (same as COPY /LOG).> o The Qretry limit is now enforced during file transmissoins.4 o Current settings are now displayed in questions.C o The log file name now has the default extension .LOG appended& if you don't specify an extension.C o Wildcards, command files, and multiple files are now supported, for the DUMP, SCRIPT, and SEND commands.C o An out-of-band AST is enabled during file transmissions whichC allows you to type the ESCAPE key to get a one line statusC report of the cuur Rent file. This was added mainly for hardcopy: terminals and for when the record display is disabled.C o The command line "REF logfile_name" is now spawned to reformatC the log file instead of "MCR REF ...". This means a DCL symbol1 must be setup to active the reformat program.$ New features in VAXNET Version 8.0:C o Multiple protocols are now supported. The PROTOCOL command is8 used to select either the VAXNET or XMODEM protocol.C o The number of data bits can S be changed. The 7BIT/8BIT commandsD specify the number of data bits to use with the XMODEM protocol.C o The type of file to be used with XMODEM can be specified. The? FILE_TYPE command is used to select either ASCII or BINARY.? o Command files can be specified at the Vaxnet command level.C o The TIMEOUT command can be used to change the timeout count used by the protocol.C o The RETRY_LIMIT command can be used to change the number of" retrys on transmTission errors.D o The SHOW command is used to display all or selective parameters.2 PAUSEC If VAXNET was started via the DCL SPAWN command, you can use thisC to pause VAXNET. Pausing VAXNET returns you to DCL level and putsC VAXNET into a hibernate state. You can then continue VAXNET by2 using the ATTACH "process_name" command from DCL.2 PHONE_NUMBER: The format of phone numbers for the auto-dial modems are:A DF03 - The DF03 does not allow spaces and/or dashs in the phonUe1 number. It must consist of all numbers. i.e.: 1234567A RIXON - The RIXON R212A allows spaces and/or dashs in the phoneA number to make it easier to read. The character "&" is@ tells the modem to wait for an intermediate dial tone. i.e.: 9&123-4567 2 PROTOCOLB This command is used to specify the type of protocol to use. TheB default protocol is VAXNET. Currently, only the VAXNET and XMODEM protocols are supported. CommandV format:( Vaxnet> PROTOCOL KERMIT/VAXNET/XMODEM2 REDIALC This command is used with auto-dial modems to redial a previouslyC entered phone number. This command is useful when the modem hasC been hungup for some reason (i.e., invalid login, etc.) or if you= want to redial the remote hoping to get a better phone line.2 REFC This command is used to enable or disable the reformatting of theC of the log file. By default, the log file is reformatted. YouC can also disab Wle waiting for reformat to complete. If waiting isC disabled, the reformat program is spawned without waiting for itC to complete so another log file can be openned immediatly. Use the2 command NOREF to disable reformatting altogether. Command format:% Vaxnet> REF [WAIT/NOWAIT] or NOREF 2 REMOTE_PORTC The remote port is the terminal line used to communicate with theC remote computer (system). This line can be either connectedC directly to a in-house system usin Xg a null modem cable, orC connected using a modem (see "HELP MODEM" for getting modemC connection established). The logical name VAXNET$PORT can be+ defined to specify the remote port to use.B The remote port should be setup as follows by the system manager:= $ SET TERM TTcn:/NOTYPEAHEAD/PERM ! Disable typeahead toC $ SET TERM TTcn:/ALTYPEAHEAD/PERM ! enable alternate typeahead@ $ SET TERM TTcn:/TYPEAHEAD/PERM ! buffer which is larger.A $ SET TERM TTcn Y:/MODEM/PERM ! If connected to a modem.E $ SET TERM TTcn:/NOBROADCAST ! Disables broadcast messages.C All other terminal characteristics are automatically setup byC VAXNET. The above characteristics should be done in the site? specific startup command file because they require privileges. 2 RETRY_LIMITD This command is used to set the retry limit for file transmissions.C This is the number of times a record/block is retransmitted. The default is 10 retZrys. Command format: Vaxnet> RETRY_LIMIT n2 RETURNC After typing the interrupt character to enter the VAXNET command; level, type the RETURN key to return to the remote system. Command format: Vaxnet> 2 SCRIPTC A script file is used to drive an interactive terminal session atC the remote system. It is normally used in conjunction with theC auto-login feature to drive the remote session from batch. TheC script file contains commands just as yo[u would type them in fromC a terminal. Normally each command line is sent to the remote withC a carriage return appended to it. There are two exceptions. IfC the first character of a command line is an up arrow (^), then theC all ^char's on the line are converted to control charatcers andC sent to the remote without a carruage return. The second exceptionC is if the line begins with the script command .WAIT. This commandC is used to define a string to wait for (such as a promp\t) beforeC sending the next command. Refer to the example script file# "SCRIPT.MAI" for more information. Command format:) Vaxnet> SCRIPT file1, file2, ... filen 2 SEND_FILEC This command is used to send (transmit) a file to the remoteC system. The remote system MUST be running the SNDRCV programC prior to issuing this command. If you don't specify the fileC names on the command line you are prompted for them. The VAX fileC name can contain wil ]dcards (%, *, and ...) or you can specify aC command file. If you specify wildcards or a command file, you areC prompted for the remote directory to put the files in. While theC file transmission is in progress, you can type the ESCAPE key to2 get a one line status report of the current file. Command format:$ Vaxnet> SEND vax_file remote_file 3 VAX_FILEC The VAX file name can be any file specification including wildcardC characters. You can also specify a command file via ^ "@cmd_file".C If you don't specify an extension for the command file, .COM isC the default. The command file must have one file specificationB per line (wildcards are permitted). Trailing spaces are ignored. 3 REMOTE_FILEC The REMOTE file name must be a valid file specification for theC system you are talking to. If wildcards or command file input is? not active, then typing the RETURN key uses the VAX file name.C If wildcards or command file input is active, you must _specify theC remote directory. BEWARE of files with multiple version numbersC since the file version number is not sent as part of the remote file name. Your options are:. or * - Send the file name only.C [*], [*...], [*,*] - Send the [directory] and file name. AnythingB before the [*] is appended to the file name.? [directory...] - Replace top VAX directory with specified.G device:[directory] - Else append the file name to specified direc`tory.2 SHOW5 This command is used to show a particular parameter. Command format: Vaxnet> SHOW parameter Where parameter is:, * or ALL - Show all parameters.5 BITS - Show the number of data bits.: DEBUG - Show debug flag/debug information.2 DECHO - Show the dump echo status.4 DISPLAY - Show the display parameters.1 ECHO - Show the local echo flag.+ FILE_TYPE - Show the fil ae type.5 INTERRUPT - Show the interrupt character.* LOG_FILE - Show the log file., MODEM_TYPE - Show the modem type.2 PROTOCOL - Show the type of protocol.3 REFORMAT - Show the reformat settings.- REMOTE_PORT - Show the remote port.- RETRY_LIMIT - Show the retry limit.- SYSTEM_TYPE - Show the system type.. SPEED - Show the remote speed./ TIMEOUT - Show the timeout count.1 b TYPEAHEAD - Show the typeahead limit.2 WATCH - Show the watch files flag.2 SNDRCVC SNDRCV is the program run on the remote system to communicateC with VAXNET during file transmission (either GET or SEND). SNDRCV- is started by one of the following commands:B o if you are communicating with another VAX system, SNDRCV is/ started by typing the command "MCR SNDRCV".B o if you are communicating with an RSX-11M system, then SNDRCV3 is started c by typing the command "RUN $SNDRCV".E In either case, the following message is displayed after SNDRCV is started.C SNDRCV Version 2.1 started ... Type CTRL/X and RETURN to abort.C At this point you should type CTRL/Y to get the VAXNET commandC prompt. Be careful not to type any other characters since theyC will be accepted by SNDRCV and interpreted as commands fromC VAXNET. After you get the VAXNET command prompt, you should typeC either GET or SE dND and the file name questions associated withC each command. After the questions are answered, the file transmission begins.C The status report on the terminal is updated after each recordC transmitted. If the status report stops updating momentarily, beC patient, there may have been a transmission failure. After aC timeout period (currently 10 seconds), transmission shouldC continue. If the transmission doesn't continue, you should type a) single CT eRL/C to abort the transmission.C To abort the SNDRCV program, you must type CTRL/X followed by theC return key. If SNDRCV doesn't abort after the first attempt, try6 several times; the second try usually does it for me.2 SPAWNC There are two commands used to execute a DCL command. If you typeC "$ dcl_command", the command is executed without copying the DCLC symbols and logical names. If you type "SPAWN dcl_command", theC DCL symbols and logical names are copied. With eitfher command, if: a DCL command is not specified, a new process is created.' For example, to get a directory, type: Vaxnet> SPAWN DIRECTORY 2 STARTUPC Before establishing the connection with the remote system either5 in-house or over a modem, you MUST do the following.B o after you are logged into the VAX, allocate the port to beB used for VAXNET. This is done so the operating system doesn'tB think someone is attempting to login to the system. AlthoughB VAXNgET allocates the port internally, this is only stays inB effect while you are running VAXNET. When you exit fromB VAXNET, the port is automatically deallocated. Failure toB allocate the system could result in both systems getting hungB up looping character back and forth (initiating LOGIN) andB WILL prevent VAXNET from attaching the remote port since it isB already allocated. On RSX-11M, this will result in all the8 system buffers being used up and t hhe system hanging.B o the second step is to start VAXNET and answer all theB questions. This is not really neccessary if the remote is aB DEC operating system (no timeout period) but is needed for anB IBM system. IBM (especially the GE Crossfile) has a limitedB amount of time to login to their system. If you aren't loggedB in within that period of time (how much time ???), IBM (TSO)B will hangup the modem on their end. You will still have to beB veryi fast for IBM if you're terminal is on a differnt floor than the modem.2 STATUSC This command is used to get a status report of how VAXNET isC currently setup. If DCL symbols are used to answer the questionsC at startup time, this command is executed automatically to displayC the current parameters. The modem type and phone number are only. displayed if you are using an autodial modem. Example: Vaxnet> STATUS Log file name: VAXNET.LOG Local loggijng: Enabled Remote port: _TTA4: Interrupt char: ^A System type: DEC Local echo: Disabled Remote speed: 1200 Modem type: RIXON Phone number: 705 2 SUMMARYC The following is a summary of the commands which can be issued atC the Vaxnet command level. Most commands can be shortened to 3B characters unless you are negating the command then 5 are needed.F AUTO_LOGIN BAUD_RATE CROSSFILE $ cmd [NO]DEBUGE [NO]DECHO k DIAL [NO]DISPLAY DUMP_FILE [NO]ECHOA EXIT GET_FILE FILE_TYPE [NO]HANGUP HELPB INTERRUPT LOCAL [NO]LOG_FILE MODEM_TYPE PAUSEH PROTOCOL REDIAL [NO]REF REMOTE_PORT RETRY_LIMITC SCRIPT SEND_FILE SHOW SPAWN STATUSD SYSTEM_TYPE TIMEOUT TYPEAHEAD [NO]WATCH [NO]XON 7BIT 8BIT 2 SYMBOLSC DCL symbols can be defined to automatically answer the lvarious$ VAXNET questions. The symbols are:6 $ VAXNET_INTRO :== "N" ! VAXNET Introduction.C $ VAXNET_LOG :== "Y" ! Output from remote to a log file.B $ LOG_LOCAL :== "N" ! Enable local output to log file.4 $ LOG_FILE :== "ROBIN.LOG" ! The log file name.5 $ REMOTE_PORT :== "TTA4:" ! Remote port to use.A $ REMOTE_SPEED :== "1200" ! Baud rate of the remote system.8 $ SYSTEM_TYPE :== "DEC" ! Type of remote system.A $ INTERRUPT_CHAR :== "^ mA" ! Character to get Vaxnet prompt.: $ MODEM_TYPE :== "RIXON" ! Type of auto-dial modem.7 $ PHONE_NUMBER :== "number" ! Phone number to dial.B $ VAXNET_CMD :== "SCRIPT TEST.COM" ! VAXNET command to execute.B For the interrupt character, the "^A" gets converted to a CTRL/A.> Also see AUTO_LOGIN for addition symbols for automatic login. 2 SYSTEM_TYPEC This command is used to specify the type of remote system you areC communicating with. This sets up various flags withinn VAXNET toC determine how to talk to the remote. For example, if you specifyC IBM, a local echo will be performed since IBM (TSO) doesn't echo4 characters sent to it. The valid system types are:@ APPLE, CROSSFILE, DATAIO, DEC, EASYLINK, IBM, UNIX, and XXDP. 2 TIMEOUTC This commands is used to set the timeout count in seconds for file+ transmissions. The default is 10 seconds. Command format: Vaxnet> TIMEOUT n 2 TYPEAHEADC This command is used to specify the liomit the typeahead buffer isC allowed to fill to before the characters are read. It also limitsC the maximum number of characters which are read at one time. TheC default typeahead limit is set to 32. This small limit is requiredC to allow terminal generated XOFF/XON to work properly. This limit6 also appears to work with the VT100 in smooth scroll. Command format: Vaxnet> TYPEAHEAD n DCL symbol: $ TYPEAHEAD_LIMIT :== 322 WATCHC This command is used to enable o pr disable the display of the file? name at end of file. By default the file names are displayed. Command format: Vaxnet> WATCH or NOWATCH2 XONC This command informs VAXNET that the remote system responds to theC XON/XOFF protocol to control output to the terminal. If enabled,C VAXNET allows the typeahead buffer to fill to some limit beforeC reading the characters to reduce system overhead. The terminalC driver sends an XOFF when the typeahead buffer is nearly qfull.C This command isn't normally used since the system type question< sets up internal flags for the remote system you are using.C If disabled with the NOXON command, VAXNET doesn't wait for theC typeahead buffer to fill. Instead, it will read the number ofD characters in the typehead buffer or issue a single character read. Command format: Vaxnet> XON or NOXON2 7BITD This command is used to set the number of data bits used. This is% the default for the VAXNErT protocol. Command format: Vaxnet> 7BIT2 8BITD This command is used to set the number of data bits used. This is0 the default for the KERMIT and XMODEM protocol. Command format: Vaxnet> 8BITww­ āâ°"1 VWQ> The VNQ command is used to view the NBI document transfer@queue. When given you are asked if you want to see the queue for@all users. If not you are prompted for a single user name which1defaults to your user name if return is pressed. sww­ /õ°" 1 Word_FileAThe VAX Document Preparation System uses the Dennison University CSpelling checker to check the user's documents for spelling errors.BEach user is allowed to have a private dictionary of words omittedAin the public dictionary but which the user does not want to haveBflaged as an error. This private dictionary is called a Word FileBand consists of words, one word per line, in upper case. The fileBis terminated in a "[". Anything following a "[" in t the word file@is considered an illegal entry and not used. A word file may be?edited using the VAX editor exactly the same way you would edit<any other text file as long as you remember to keep only oneword per line.AThe Word File option allows uses to create for the first time (if@they bdo not have one yet) a private copy of the system default Dword file and to add additional words to it. When invoked, the Word@File option prompts the user for a word to add to the word file.DIf the useur types Control-Z to any input, the process is aborted andCno changes are made to the user's default word file. Each word theCuser enters will be echoed only in upper case. When the user types?a return, the tempory file the user has been creating is merged?into the user's private dictionary DEFAULT.WRD and the previous?dictionary (if any is purged). The word file merging program, @ENGL$:USERWORD, displays statistics as to the number of words in<the user's private dictionary. When the process is complete:a message is displayed to that effect and the user is told<to "Press RETURN when ready". When the users presses RETURN*the user is returned to the previous menu.ww