HOW TO ACCESS RASM
       		         J. R. Lemen, 19-sep-92
			 S. L. Freeland, 17-May-93 ( change "/ydb" to "$ydb")
                         ($ys/gen/doc/krasm.doc)
     The SSOC Tobans should access RASM two or three times per week to
copy the final and preliminary DSN pass schedules.  RASM stands for "Remote
Access Schedule Mailbox" and can only be accessed by modem.  Access to RASM
is briefly explained by the following set of events:
     (i) Call the RASM number and log on to the RASM PC (Initial login)
    (ii) The RASM PC instructs the RASM Vax to call you back using the
         B-tou outside telephone number.
   (iii) The RASM Vax calls back and you are prompted to log on (2nd login)
For the Yohkoh project the Initial and 2nd logins both have the same account
name, which is Yohkoh.  The passwords, however, are currently different.
The VAX will probably require us to change the password every so often (maybe
90 days).  The passwords are written on a page in the back of the SSOC Toban
Manual.  Please log any changes to the password there.  Do not remove the
page from the manual and please do not copy it to any other notebooks or
documents.
----------------------------------------------
1. WHEN TO ACCESS RASM
----------------------------------------------
     On the RASM VAX there are two directories which contain Yohkoh schedule
files.  The directories and the file names are as follows:
                    (RASM Option) Directory     Yohkoh File
   Final Schedule        (1) 7-Day Schedule     SOLASS.W__
   Preliminary Schedule  (2) 7-Day Forecast     SOLASF.W__
where the W__ refers to the week number (e.g., W37 or W38, etc.).  There
may be other SOLA* files on these directories, but they are not the ones that
we need to transfer to our workstation.
     In my experience it is wise to access RASM at least three times a week:
     Thursday:  The preliminary schedule should be available for the next week.
     Friday:    The final schedule should be available.
     Monday:    Check to see if any changes to the final or preliminary
                schedules have occurred.
     The final schedule will continue to be updated during the week, but
the modification usually only reflects passes that are deleted from the file
day by day.
     Remember that the file name convention is:
     		 SS = Schedule (or Final)
                 SF = Forecast (or Preliminary)

----------------------------------------------
2. HOW TO ACCESS RASM USING KERMIT ON FLARE11
----------------------------------------------
A. You must access RASM by logging onto flare11.
   (For the moment you must log onto the flare11 at the monitor -- that is,
    you cannot do an rlogin from flare1 because the way the J-side has set
    up idl on the flare machines.  This situtation could easily be improved
    if the J-side so desired.  The yslogin setup could be used to properly
    prepare idl for running on either the Mips or Sun workstations.)
B. You can log on using any account.  If you log on as SXT, then the .kermrc
   file in the sxt home directory will be executed by when kermit is started.
   Otherwise, one additional command will need to be executed.
C. Next, run the krasm (stands for Kermit Rasm) script.  krasm will do the
   following for you (somewhat) automatically:
        (i) Change your working direct to $DIR_GEN_ORBIT_RAW
       (ii) Start kermit
   At this point, dial the RASM number (this should work automatically, but
   there is some problem that I haven't figured out with the flare11 version
   of kermit).  Then you will log on to RASM and wait for the call back.
   After transferring files (if any), krasm will:
      (iii) Run an IDL job to reformat the file for op_first_guess
       (iv) Print the transferred files to the flare1 printer
        (v) Change your working directory back to where you started from.
C. Hints
o About kermit, to get back to the kermit prompt (after connecting to the
  modem) type a control-\ C sequence (abbreviated below as ^\ C).
o Login to RASM PC:  First Time
  The log in to RASM the first time will ask you the following two
  questions:
HELLO, PLEASE ENTER USER NAME:				{Yohkoh - not echoed}
PASSWORD:						{password - not echoed}
YOU WILL BE CALLED BACK, GOOD BYE
u7							{noise}
NO CARRIER						{logoff is automatic}
  - Note that your answers will not be echoed to your screen.
  - The username and password can be either upper or lower case.
  - If you make any mistakes, the system will hang up - so be careful!

o Login to RASM VAX: 2nd time
  When the Vax calls you back, you will see prompts such as the following:
CONNECT 2400
					{Noise}
HOST ACCESS PERMITTED					{After this, enter }
<cr> <cr>						{2 carriage returns}
Username: YOHKOH					{Login - 2nd time  }
Password:			{username and password are case insensitive}
  - AFTER you see the "HOST ACCESS PERMITTED" message, enter carriage
    return <cr> twice.
  - The username and password can be either upper or lower case.
  - The VAX will give you up to three chances to get the username and
    password typed correctly.

----------------------------------------------
3. SAMPLE KRASM SESSION
----------------------------------------------
A journal file that I made is given below.  I have annotated it in places
with comments enclosed in braces {like this}. In this example there is no
.kermrc file in the user's home directory.
- - - - - - - - - - - -Beginning of Sample krasm session - - - - - - - -
flare11:1% krasm				{type this to get started}
      ***** krasm V1.0  21-Sep-92  *****
Your current directory is /tmp_dir/home/flare/com/com/lemen
Changing to $ydb/orbit_raw
Make sure the modem is turned ON!!!
Enter <cr> to contine: 				{we use the B-tou   }
						{external phone line}
- - - - - - - - - - - - - - - - - - - - - - - - - - - -
o Starting Kermit now
o There is no .kermrc on your home directory
  At the kermit prompt, enter "take rasm_call"
o If it is necessary to restart the dialing sequence, then
  type the command "take rasm_call" at the kermit prompt.
- - - - - - - - - - - - - - - - - - - - - - - - - - - -
C-Kermit 5A(170) ALPHA, 23 Apr 91, MIPS RISC/OS (System V R3)
Type ? or 'help' for help
C-Kermit>take rasm_call				       	{This sets modem type  }
?Invalid: % Next enter: atdt 001-1-818-354-8400		{and connects to kermit}
Connecting to /dev/tty1, speed 2400.
The escape character is ^\ (ASCII 28).
Type the escape character followed by C to get back,
or followed by ? to see other options.
at							{Check the modem status}
OK
atdt 001-1-818-354-8400					{Dial this number}
CONNECT 2400
HELLO, PLEASE ENTER USER NAME:				{Yohkoh - not echoed}
PASSWORD:						{password - not echoed}
YOU WILL BE CALLED BACK, GOOD BYE
u7
NO CARRIER						{logoff is automatic}
RING							{RASM is calling you}
RING
CONNECT 2400
					{Noise}
HOST ACCESS PERMITTED					{After this, enter }
<cr> <cr>						{2 carriage returns}
Username: YOHKOH					{Login - 2nd time  }
Password:			{username and password are case insensitive}
    *****************************************************************
    *    You are connected to a U.S. Government computer system.    *
    *    Any unauthorized ATTEMPT to gain access to this system,    *
    *    and/or its programs or data, may subject you to a fine     *
    *    and/or imprisonment.                                       *
    *****************************************************************
     Last interactive login on Friday, 18-SEP-1992 05:52
Z>
         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
         +                                                       +
         +                For RASM Problems:                     +
         +                                                       +
         +    Contact the NDP DataChief At JPL (818)393-7974     +
         +                     - Or -                            +
         +             Send VAX Mail to BURGESS                  +
         +                                                       +
         +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Welcome to the Remote Access Schedule Mailbox (RASM) Version 1.1
It is Friday, 18-SEP-1992 at 09:09 UTC.
Enter a question mark (?) at any time for help.
Remote Access Schedule Mailbox Version 1.1
Main Menu
 (1) Transfer Files
 (2) Invoke Mail
 (3) System Utilities
 (4) Exit
* Choose [4]: 1						{1 to transfer files}
Remote Access Schedule Mailbox Version 1.1
Transfer Files
 (1) Transfer To RASM
 (2) Transfer From RASM
 (3) Select Kermit or XModem
 (4) Exit
* Choose [4]: 2						{2 = get files from RASM}
Remote Access Schedule Mailbox Version 1.1
Transfer Files From RASM
 (1) 7-Day Schedule
 (2) 7-Day Forecast
 (3) 7-Day Strawman
 (4) View Periods
 (5) Administrative Message
 (6) Other Text File
 (7) Exit
* Choose [7]: 1						{1 = final schedule}
							{2 = preliminary}
Directory RASM$DISK:[RASMDBS.SCH]
7DAYS.W38;18        7DAYSS.W38;1        7DAYSS.W39;1        DFS3SS.W38;2
DFS3TS.W38;2        GLLOSS.W38;2        GLLOSS.W39;1        GLLOTS.W38;2
GLLOTS.W39;1        GTLSS.W38;3         GTLSS.W39;1         GTLTS.W38;3
GTLTS.W39;1         HIPPSS.W38;3        HIPPTS.W38;3        HSP1SS.W38;3
HSP1TS.W38;3        ICESS.W38;1         ICESS.W39;1         ICETS.W38;1
ICETS.W39;1         LEGOSS.W38;1        LEGOTS.W38;1        MGNSS.W38;4
MGNSS.W38;3         MGNSS.W39;1         MGNTS.W38;4         MGNTS.W38;3
MGNTS.W39;1         MOSS.W38;4          MOTS.W38;4          NIM7SS.W38;9
NIM7SS.W39;1        NIM7TS.W38;9        NIM7TS.W39;1        PN10SS.W38;2
PN10SS.W39;1        PN10TS.W38;2        PN10TS.W39;1        PN11SS.W38;2
PN11SS.W39;1        PN11TS.W38;2        PN11TS.W39;1        PN12SS.W38;5
PN12SS.W38;4        PN12SS.W39;1        PN12TS.W38;5        PN12TS.W38;4
PN12TS.W39;1        ROSTSS.W38;8        ROSTTS.W38;8        SMPXSS.W38;3
SMPXSS.W39;1        SMPXTS.W38;3        SMPXTS.W39;1        SOLASS.W38;9
SOLASS.W38;8        SOLASS.W39;1        SOLATS.W38;9        SOLATS.W38;8
SOLATS.W39;1        SPC10S.W38;19       SPC10S.W38;18       SPC10S.W39;1
STSSS.W38;3         STSTS.W38;3         TOPXSS.W38;4        TOPXSS.W38;3
TOPXTS.W38;4        TOPXTS.W38;3        ULYSSS.W38;7        ULYSSS.W39;1
ULYSTS.W38;7        ULYSTS.W39;1        VGR1SS.W38;3        VGR1SS.W39;1
VGR1TS.W38;3        VGR1TS.W39;1        VGR2SS.W38;3        VGR2SS.W39;1
VGR2TS.W38;3        VGR2TS.W39;1
Total of 82 files.
Select a file to transfer
* File []: solass.w39					{Final schedule}
Do you wish to transfer, or examine, RASM$DISK:[RASMDBS.SCH]SOLASS.W39;1?
* T[ransfer]/E[xamine], or <cr> to reject []: t		{transfer}
Copying RASM$DISK:[RASMDBS.SCH]SOLASS.W39;1 to your OUT basket.
Preparing to transfer file RASM$DUA1:[YOHKOH.RASM_WRK.OUT_BASKET]SOLASS.W39;1.
VMS Kermit-32 version 3.1.066
Default terminal for transfers is: _LTA608:
^\ C							{Type ^\ C to get back}
							{to the kermit prompt }
[Back at Local System]
C-Kermit>receive					{Next type receive}
SF
SOLASS.W39 => solass.w39
Type escape character (^\) followed by:
X to cancel file,  CR to resend current packet
Z to cancel group, A for status report
E to send Error packet, Ctrl-C to quit immediately: ......................Z
 [OK]
B
C-Kermit>c					{Transfer is done, c to connect}
Connecting to /dev/tty1, speed 2400.
The escape character is ^\ (ASCII 28).
Type the escape character followed by C to get back,
or followed by ? to see other options.
* Discard RASM$DUA1:[YOHKOH.RASM_WRK.OUT_BASKET]SOLASS.W39;1 [Y]? Y	{Yes}
Remote Access Schedule Mailbox Version 1.1
Transfer Files From RASM
 (1) 7-Day Schedule
 (2) 7-Day Forecast
 (3) 7-Day Strawman
 (4) View Periods
 (5) Administrative Message
 (6) Other Text File
 (7) Exit
* Choose [7]: 						{Default = exit}
Remote Access Schedule Mailbox Version 1.1
Transfer Files
 (1) Transfer To RASM
 (2) Transfer From RASM
 (3) Select Kermit or XModem
 (4) Exit
* Choose [4]: 						{Default = exit}
Remote Access Schedule Mailbox Version 1.1
Main Menu
 (1) Transfer Files
 (2) Invoke Mail
 (3) System Utilities
 (4) Exit
* Choose [4]: 						{Default = exit}
* Are You Sure [N]? y
  YOHKOH       logged out at 18-SEP-1992 09:12:01.96
p{
NO CARRIER
^\ C							{Type ^\ C to get back}
							{to the kermit prompt }
[Back at Local System]
C-Kermit>exit					{All finished, exit}
IDL. Version 2.2.1 (RISC/os mipseb).		{IDL job is run automatically}
Copyright 1989-1991, Research Systems, Inc.
All rights reserved.  Unauthorized reproduction prohibited.
Site: 1140.
Licensed for use by: ISAS flare11
% Compiled module: MK_RASM_FILES.
% Compiled module: CONCAT_DIR.
% Compiled module: GET_HOST.
% Compiled module: BREAK_FILE.
Formating solass.w39;  Output = rasmss.w39
% Compiled module: FMT_RASM.
% Compiled module: STR2ARR.
Printing rasmss.w39				{Prints to flare1 printer}
Changing back to your original directory: /tmp_dir/home/flare/com/com/lemen
Make sure the modem is turned OFF!!!
flare11:2% exit					{Back at the unix prompt}
- - - - - - - - - - - -End of Sample krasm session - - - - - - - -

----------------------------------------------------
4. WHERE RASM FILES ARE WRITTEN AND NAME CONVENTIONS
----------------------------------------------------
     The RASM files are written to $DIR_GEN_ORBIT_RAW ($ydb/orbit_raw).  The
raw files from rasm are given the names:
Original RASM files	final:             solass.w__
        	        preliminary:       solasf.w__
where the __ refers to week number.  The krasm script file calls an IDL
routine (fmt_rasm) which strips out the extraneous information and writes
a new file:
Edited RASM files  	final:             rasmss.w__
                   	preliminary:       rasmsf.w__
The idl program op_first_guess reads the rasmss.w__ files to get the first
guess for the DSN time entries.
     If you get the same file more than once, kermit will copy the existing
file to a new name before transferring the new file.  The old files will
have names like solass.w38.~1~ or solasf.w39.~2~ and so on.
     Both the original and edited RASM files have the convention:
     		 ss = Schedule (or Final)
                 sf = Forecast (or Preliminary)
The first "s" is a designation that RASM assigns all their on-line files
containing sorted schedule information (there are other sola* with different
letters containing different kinds of schedule information, but are not used
by us.
Please send comments or questions software@isass0 and/or lemen@isass0.