forked from mainframed/rdrprep
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
executable file
·167 lines (130 loc) · 5.09 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
This file, and the remaining contents of the archive containing it
(as detailed below) are Copyright 2001-2002, James M. Morrison.
Rdrprep is released under the QPL.
rdrprep command
Version 00.02 December 2, 2002
Overview
--------
This program prepares a deck for submission to a virtual card reader,
translating (where necessary) from ASCII input to EBCDIC output,
producing an EBCDIC output deck.
It provides a rudimentary "include" facility which can be used to
cause additional decks to be embedded into the resulting (combined)
output deck. Includes are only recognized in ASCII input files, but
included decks may include other decks up to a maximum level
(nested includes) specified by the FILE_DEPTH definition (10).
The main input deck (specified on command line) is assumed to be
encoded in ASCII.
The output deck will be in EBCDIC, fixed length (lrecl) records.
Currently, the only supported lrecl is 80.
Input lines longer than lrecl will be truncated, shorter lines
padded out to lrecl length.
ASCII input files are assumed to be of variable line length,
EBCDIC input files are assumed to be of fixed (lrecl) length.
Sample Help from "rdrprep +help" execution
------------------------------------------
Copyright 2001-2002, James M. Morrison
Version 00.02
This program prepares an ASCII file for submission to a Hercules virtual
card reader. It reads the input file, and provides a mechanism to include
other (ASCII or EBCDIC) files. Files are included by specifying an 'include'
statement (beginning in column 1) whose format is:
::C [path]filename
where:
:: are the include escape characters
C either E (EBCDIC) or A (ASCII) for the included file's
character set. The case of E or A is not significant.
[path]filename specifies the filename and optional path of the file
to be included.
The main input file (specified on the command line) is assumed to be in
ASCII. ASCII files are assumed to be of variable line lengths, EBCDIC
files are assumed to be of fixed length. All input lines are translated
to EBCDIC (if necessary), and blank padded or truncated to 80 characters.
Include statements are only recognized in ASCII input files.
Syntax: rdrprep [options...] input [output]
input input filename
output output filename (default reader.jcl)
Default options on/yes(+) off/no(-) HELP (default: not displayed)
------------------------------------------- ------------------------------
-list echo output (translated to ASCII) -about copyright & version
+trunc truncate long ASCII lines (80) -help general help
-syntax syntax help
Sample execution
----------------
bash-2.04# cat test.jcl
//TEST JOB CLASS=A,MSGLEVEL=(1,1)
//UPDTE EXEC PGM=IEBUPDTE
//SYSPRINT DD SYSOUT=A
//SYSUT1 DD DISP=OLD,DSN=SYS2.LOCAL.ASM
//SYSUT2 DD DISP=OLD,DSN=SYS2.LOCAL.ASM
//SYSIN DD *
./ ADD NAME=JUNK
::a first.include.txt
./ ADD NAME=IEFBR14
::a iefbr14.asm
//LINK EXEC PGM=IEWL,PARM='MAP'
//SYSPRINT DD SYSOUT=*
//SYSLMOD DD DISP=SHR,DSN=SYS2.LOCAL.LINKLIB(IEFBR14)
//SYSUT1 DD UNIT=SYSDA,SPACE=(TRK,(5,5))
//SYSLIN DD *
::e iefbr14.obj
//IEFBR14 EXEC PGM=IEFBR14
//STEPLIB DD DSN=SYS2.LOCAL.LINKLIB,DISP=SHR
//
bash-2.04# rdrprep +list test.jcl
//TEST JOB CLASS=A,MSGLEVEL=(1,1)
//UPDTE EXEC PGM=IEBUPDTE
//SYSPRINT DD SYSOUT=A
//SYSUT1 DD DISP=OLD,DSN=SYS2.LOCAL.ASM
//SYSUT2 DD DISP=OLD,DSN=SYS2.LOCAL.ASM
//SYSIN DD *
./ ADD NAME=JUNK
First Include Text Line 1
First Include Text Line 2
Second Include Text Line 1
Second Include Text Line 2
Second Include Text Final Line
First Include Text Final Line
./ ADD NAME=IEFBR14
IEFBR14 CSECT ,
SLR 15,15
BR 14
END IEFBR14
//LINK EXEC PGM=IEWL,PARM='MAP'
//SYSPRINT DD SYSOUT=*
//SYSLMOD DD DISP=SHR,DSN=SYS2.LOCAL.LINKLIB(IEFBR14)
//SYSUT1 DD UNIT=SYSDA,SPACE=(TRK,(5,5))
//SYSLIN DD *
ESD IEFBR14 00000001
TXT 00000002
END 1X390ASM 210001038 00000003
//IEFBR14 EXEC PGM=IEFBR14
//STEPLIB DD DSN=SYS2.LOCAL.LINKLIB,DISP=SHR
//
Archive contents
----------------
rdrprep-xxxx.zip
first.include.txt
iefbr14.asm
iefbr14.obj
makefile
rdrprep.c
reader.jcl
readme.txt
second.include.txt
test.jcl
Version history
---------------
Version 00.00 February 7, 2001
Base release
Version 00.01 April 7, 2001
Ignores zero length ASCII input records
Version 00.02 December 2, 2002
Incorporate Mike Rayborn's fix for long ASCII lines,
as reported in the Yahoo turnkey-mvs group.
Added trunc option; -trunc will wrap long ASCII lines
(for example HTML files); similar to old behavior.
Default is +trunc (truncate ASCII input at 80 bytes).
Best regards,
Jim
<end>