1 :Info: map355:
 2 2022-10-29 map355
 3 
 4 Syntax as a command:  map355 pathname {-control_args}
 5 
 6 
 7 Function:  is used to assemble a program written in the FNP assembler
 8 language, map355.  The command does not assemble the program directly.
 9 Instead, it prepares a GCOS job deck to perform the assembly and calls
10 the GCOS Environment Simulator to do the work.
11 
12 
13 Arguments:
14 pathname
15    is the pathname of the source program to be assembled.  The suffix
16    of map355 need not be given by the user; it is assumed.
17 
18 
19 Control arguments:
20 -argument list, -ag list
21    specifies a list of arguments to be passed to the GCOS Environment
22    Simulator.
23 -check
24    specifies that the compiler only perform a syntax check of the
25    source.  No object segment is created.
26 -comdk
27    creates a GCOS comdk segment.  This segment contains a BCD version
28    of the source program.  It is created in the working directory with
29    a suffix of comdk.
30 -gcos_list, -gcls
31    creates a GCOS listing segment in the working directory.  This is a
32    BCD version of the listing segment.  It has a suffix of glist.
33 
34 
35 -list, -ls
36    creates a listing segment that documents the compilation.  The
37    listing is created in the working directory, and has a suffix of
38    list.
39 -macro_file path
40    specifies the pathname of the macro file to be used for the
41    assembly.  If omitted, >ldd>mcs>info>355_macros is used.
42 -noconvert
43    specifies that the input segment is a GCOS comdk, rather than an
44    ASCII segment.  If this control argument is used, the source segment
45    must have a suffix of comdk.
46 
47 
48 Notes:  This command creates a series of segments for use by the GCOS
49 simulator.  Some are created in the working directory, some are created
50 in the process directory, and some through links in the working
51 directory to the process directory.  These segments and links are
52 normally deleted when the command terminates, leaving just the object
53 segment, which has a suffix of objdk.
54 
55 Refer to the GCOS Environment Simulator manual, Order No.  AN05, for
56 more information on the use of the GCOS Environment Simulator.
57 
58 
59 The map355 command creates links in the working directory to segments
60 to be placed in the process directory.  If the process terminates in
61 the middle of a compilation (new_proc or a crash), these links will
62 remain.  This means that the next time the command is invoked, it will
63 fail because the links point to a nonexistent directory.  Even though
64 the command fails, the bad links will be unlinked and subsequent
65 invocations will work correctly.
66 
67 
68 List of severity values:  The map355 command sets the following
69 severity values to be returned by the severity active function when the
70 "map355" keyword is used:
71 
72       Value     Meaning
73 
74         0       No error (or command not yet used)
75         1       The assembly produced warning flags
76         2       The objdk segment could not be create
77 
78 
79 :hcom:
80 /****^  HISTORY COMMENTS:
81   1) change(2022-10-29,Swenson), approve(2022-10-29,MCR10124f),
82      audit(2022-10-29,None), install(2022-10-29,MR12.8-1045):
83      Fixed pathname to 355_macros segment.
84                                                    END HISTORY COMMENTS */
85