1 08/02/84  gcos_syspunch, gspn
 2 
 3 Syntax as a command:  gspn path
 4 
 5 
 6 Function:  The gcos_syspunch command converts a GCOS standard system
 7 format file containing BCD and binary card images to a format suitable
 8 for punching using the Multics dpunch command with the -raw argument.
 9 This command is called automatically by the GCOS environment simulator
10 to convert any punch files produced by the job, unless the -hold
11 argument is given on the gcos command line.  It can also be called by
12 the user to convert any GCOS card image file for dpunching.
13 
14 
15 Arguments:
16 path
17    is the pathname of the card image file to be converted.
18 
19 
20 Notes:  The output is written into a segment in the working directory
21 whose entryname consists of the entryname portion of path plus the
22 suffix raw.  If this segment already exists, it will be overwritten
23 with no warning.
24 
25 The star convention is not implemented in this command.
26 
27 The conversion produces a 960-bit string for each input card image.
28 Each 12-bit string represents one of the 80 card columns, with a 1-bit
29 indicating that a hole should be punched in the corresponding row and
30 column.  This conversion is such that, when the output file is punched
31 using the dpunch -raw command, the result is valid GCOS BCD or binary
32 cards containing the same information that was in the records of the
33 input file.