Ricoh InfoPrint Pro C900AFP InfoPrint Manager - Page 178

Using the sample MVS Download exit program, Customizing the sample exit program

Page 178 highlights

Using the sample MVS Download exit program In the sample mvsdsubm files, the Exit performs these operations using the eight parameters that are passed to it. 1. Issues a pdpr print command to submit the file (parameter #1) to the specified target destination (parameter #3), with the indicated InfoPrint print parameters (parameter #5). 2. If the job prints successfully, the Exit will erase the print job file (parameter #1). 3. If the job does not print, the Exit will log an error in the MVS Download error file and terminate the receiver. Parameters Definition #1 The name of the file that contains data received from the MVS JES spool #2 MVS JES destination control parameters #3 InfoPrint target destination (printer) where the job is submitted #4 MVS Download receiver name #5 InfoPrint print parameters #6 The port number used by this receiver #7 Additional exit parameter specified when the receiver was created #8 Indicator that indicates whether trace is on. A value of zero indicates trace is off. Any other value indicates trace is on. In addition, the Visual Studio exit has support for the multiple data set function in MVS Download and AFP Download Plus. Customizing the sample exit program You can customize the mvsdsubm.c to allow the Exit to perform differently. For example, you might want to modify the Exit so that it ignores the InfoPrint Manager print parameters (parameter #5) and processes only the MVS JES destination control parameters themselves (parameter #2). Or, you could remove the pdpr call and change it to any applicable program or OS command call. For instance, you could have the Exit copy or archive the data file (parameter #1). Note: If you specify a DCF that contains no statements, InfoPrint will pass parameter #5 as a null string. Copying the sample exit: To customize the sample Exit, you should not change the sample itself, because if you ever need to reinstall InfoPrint Manager, all of your changes will be lost. Instead, copy the fileset into a directory outside of the directory that you have InfoPrint Manager installed in and make your changes to that version. Note: You must have access to Microsoft Visual Studio 2005 to customize the Exit. To complete the process: 1. Log on to the system that your InfoPrint Manager server is installed on. 2. Decide which directory you would like to store your new exit in or create a new one for it. 3. Navigate to the \exits\mvsd directory, where is the directory that you installed InfoPrint Manager in, using Windows Explorer or the My Computer icon. 160 InfoPrint Manager for Windows: Procedures

  • 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
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418
  • 419
  • 420
  • 421
  • 422
  • 423
  • 424
  • 425
  • 426

Using the sample MVS Download exit program
In the sample
mvsdsubm
files, the Exit performs these operations using the eight
parameters that are passed to it.
1.
Issues a
pdpr
print command to submit the file (parameter #1) to the specified
target destination (parameter #3), with the indicated InfoPrint print parameters
(parameter #5).
2.
If the job prints successfully, the Exit will erase the print job file (parameter #1).
3.
If the job does not print, the Exit will log an error in the MVS Download error
file and terminate the receiver.
Parameters
Definition
#1
The name of the file that contains data received from the MVS JES spool
#2
MVS JES destination control parameters
#3
InfoPrint target destination (printer) where the job is submitted
#4
MVS Download receiver name
#5
InfoPrint print parameters
#6
The port number used by this receiver
#7
Additional exit parameter specified when the receiver was created
#8
Indicator that indicates whether trace is on. A value of zero indicates trace is
off. Any other value indicates trace is on.
In addition, the Visual Studio exit has support for the multiple data set function in
MVS Download and AFP Download Plus.
Customizing the sample exit program
You can customize the
mvsdsubm.c
to allow the Exit to perform differently. For
example, you might want to modify the Exit so that it ignores the InfoPrint
Manager print parameters (parameter #5) and processes only the MVS JES
destination control parameters themselves (parameter #2). Or, you could remove
the pdpr call and change it to any applicable program or OS command call. For
instance, you could have the Exit copy or archive the data file (parameter #1).
Note:
If you specify a DCF that contains no statements, InfoPrint will pass
parameter #5 as a null string.
Copying the sample exit:
To customize the sample Exit, you should not change the sample itself, because if
you ever need to reinstall InfoPrint Manager, all of your changes will be lost.
Instead, copy the fileset into a directory outside of the directory that you have
InfoPrint Manager installed in and make your changes to that version.
Note:
You must have access to Microsoft Visual Studio 2005 to customize the Exit.
To complete the process:
1.
Log on to the system that your InfoPrint Manager server is installed on.
2.
Decide which directory you would like to store your new exit in or create a
new one for it.
3.
Navigate to the
<install path>\exits\mvsd
directory, where <install path> is
the directory that you installed InfoPrint Manager in, using Windows Explorer
or the
My Computer
icon.
160
InfoPrint Manager for Windows: Procedures